Creates a new sales quotation.
curl --request POST \
--url https://api.jtl-cloud.com/erp/v2/sales-quotations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-tenant-id: <x-tenant-id>' \
--data '
{
"companyId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"customerId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"billingAddress": {
"street": "<string>",
"city": "<string>",
"countryIso": "<string>",
"salutation": "<string>",
"title": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"company": "<string>",
"additionalCompanyLine": "<string>",
"additionalAddressLine": "<string>",
"postalCode": "<string>",
"state": "<string>",
"postId": "<string>",
"emailAddress": "<string>",
"phoneNumber": "<string>",
"mobilePhoneNumber": "<string>",
"fax": "<string>"
},
"departureCountry": {
"countryIso": "<string>",
"currencyIso": "<string>",
"currencyFactor": 123,
"state": "<string>",
"stateCode": "<string>"
},
"lineItems": [
{
"itemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"parentSalesQuotationLineItemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"taxClassId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"taxCodeId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"discountPercent": 123,
"fnSku": "<string>",
"name": "<string>",
"note": "<string>",
"purchasePriceNet": 123,
"quantity": 123,
"salesPriceNet": 123,
"salesUnit": "<string>",
"sku": "<string>",
"taxRate": 123,
"variants": [
{
"name": "<string>",
"itemVariantId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"extraWeight": 123,
"surchargeNet": 123,
"value": "<string>",
"itemVariantValueId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}
]
}
],
"paymentDetails": {
"currencyIso": "<string>",
"cashDiscount": 123,
"cashDiscountDays": 123,
"financingCosts": 123,
"paymentDueDateInDays": 123,
"currencyFactor": 123
},
"languageIso": "<string>",
"vatId": "<string>",
"disableAutomaticWorkflows": true,
"useBillingAddressAsShipmentAddress": true,
"cartonItemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"onHoldReasonId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"paymentMethodId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"processColourId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"processStatusId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"externalDetails": {
"externalCreatedDate": "2023-11-07T05:31:56Z",
"externalSalesQuotationNumber": "<string>"
},
"paymentInfo": {
"accountHolder": "<string>",
"bankName": "<string>",
"bIC": "<string>",
"creditorId": "<string>",
"dueDate": "2023-11-07T05:31:56Z",
"endToEndId": "<string>",
"iBAN": "<string>",
"mandateReference": "<string>",
"paymentInfo": "<string>",
"paymentReference": "<string>",
"referenceEmail": "<string>"
},
"shippingDetails": {
"deliveryFromDate": "2023-11-07T05:31:56Z",
"estimatedDeliveryDate": "2023-11-07T05:31:56Z",
"extraWeight": 123,
"maxDeliveryDays": 123,
"shippingDate": "2023-11-07T05:31:56Z",
"shippingPriority": 123
},
"taxDetails": {},
"text": {
"comment": "<string>",
"customerComment": "<string>",
"printText": "<string>",
"processStatus": "<string>"
},
"customerSalesQuotationNumber": "<string>",
"customerVatId": "<string>",
"salesQuotationDate": "2023-11-07T05:31:56Z",
"salesQuotationNumber": "<string>",
"shippingMethodId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}
'import requests
url = "https://api.jtl-cloud.com/erp/v2/sales-quotations"
payload = {
"companyId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"customerId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"billingAddress": {
"street": "<string>",
"city": "<string>",
"countryIso": "<string>",
"salutation": "<string>",
"title": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"company": "<string>",
"additionalCompanyLine": "<string>",
"additionalAddressLine": "<string>",
"postalCode": "<string>",
"state": "<string>",
"postId": "<string>",
"emailAddress": "<string>",
"phoneNumber": "<string>",
"mobilePhoneNumber": "<string>",
"fax": "<string>"
},
"departureCountry": {
"countryIso": "<string>",
"currencyIso": "<string>",
"currencyFactor": 123,
"state": "<string>",
"stateCode": "<string>"
},
"lineItems": [
{
"itemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"parentSalesQuotationLineItemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"taxClassId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"taxCodeId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"discountPercent": 123,
"fnSku": "<string>",
"name": "<string>",
"note": "<string>",
"purchasePriceNet": 123,
"quantity": 123,
"salesPriceNet": 123,
"salesUnit": "<string>",
"sku": "<string>",
"taxRate": 123,
"variants": [
{
"name": "<string>",
"itemVariantId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"extraWeight": 123,
"surchargeNet": 123,
"value": "<string>",
"itemVariantValueId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}
]
}
],
"paymentDetails": {
"currencyIso": "<string>",
"cashDiscount": 123,
"cashDiscountDays": 123,
"financingCosts": 123,
"paymentDueDateInDays": 123,
"currencyFactor": 123
},
"languageIso": "<string>",
"vatId": "<string>",
"disableAutomaticWorkflows": True,
"useBillingAddressAsShipmentAddress": True,
"cartonItemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"onHoldReasonId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"paymentMethodId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"processColourId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"processStatusId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"externalDetails": {
"externalCreatedDate": "2023-11-07T05:31:56Z",
"externalSalesQuotationNumber": "<string>"
},
"paymentInfo": {
"accountHolder": "<string>",
"bankName": "<string>",
"bIC": "<string>",
"creditorId": "<string>",
"dueDate": "2023-11-07T05:31:56Z",
"endToEndId": "<string>",
"iBAN": "<string>",
"mandateReference": "<string>",
"paymentInfo": "<string>",
"paymentReference": "<string>",
"referenceEmail": "<string>"
},
"shippingDetails": {
"deliveryFromDate": "2023-11-07T05:31:56Z",
"estimatedDeliveryDate": "2023-11-07T05:31:56Z",
"extraWeight": 123,
"maxDeliveryDays": 123,
"shippingDate": "2023-11-07T05:31:56Z",
"shippingPriority": 123
},
"taxDetails": {},
"text": {
"comment": "<string>",
"customerComment": "<string>",
"printText": "<string>",
"processStatus": "<string>"
},
"customerSalesQuotationNumber": "<string>",
"customerVatId": "<string>",
"salesQuotationDate": "2023-11-07T05:31:56Z",
"salesQuotationNumber": "<string>",
"shippingMethodId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}
headers = {
"x-tenant-id": "<x-tenant-id>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-tenant-id': '<x-tenant-id>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
companyId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
customerId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
billingAddress: {
street: '<string>',
city: '<string>',
countryIso: '<string>',
salutation: '<string>',
title: '<string>',
firstName: '<string>',
lastName: '<string>',
company: '<string>',
additionalCompanyLine: '<string>',
additionalAddressLine: '<string>',
postalCode: '<string>',
state: '<string>',
postId: '<string>',
emailAddress: '<string>',
phoneNumber: '<string>',
mobilePhoneNumber: '<string>',
fax: '<string>'
},
departureCountry: {
countryIso: '<string>',
currencyIso: '<string>',
currencyFactor: 123,
state: '<string>',
stateCode: '<string>'
},
lineItems: [
{
itemId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
parentSalesQuotationLineItemId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
taxClassId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
taxCodeId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
discountPercent: 123,
fnSku: '<string>',
name: '<string>',
note: '<string>',
purchasePriceNet: 123,
quantity: 123,
salesPriceNet: 123,
salesUnit: '<string>',
sku: '<string>',
taxRate: 123,
variants: [
{
name: '<string>',
itemVariantId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
extraWeight: 123,
surchargeNet: 123,
value: '<string>',
itemVariantValueId: 'b45f6432-2462-4c6f-b00f-1d9d01000000'
}
]
}
],
paymentDetails: {
currencyIso: '<string>',
cashDiscount: 123,
cashDiscountDays: 123,
financingCosts: 123,
paymentDueDateInDays: 123,
currencyFactor: 123
},
languageIso: '<string>',
vatId: '<string>',
disableAutomaticWorkflows: true,
useBillingAddressAsShipmentAddress: true,
cartonItemId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
onHoldReasonId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
paymentMethodId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
processColourId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
processStatusId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
externalDetails: {
externalCreatedDate: '2023-11-07T05:31:56Z',
externalSalesQuotationNumber: '<string>'
},
paymentInfo: {
accountHolder: '<string>',
bankName: '<string>',
bIC: '<string>',
creditorId: '<string>',
dueDate: '2023-11-07T05:31:56Z',
endToEndId: '<string>',
iBAN: '<string>',
mandateReference: '<string>',
paymentInfo: '<string>',
paymentReference: '<string>',
referenceEmail: '<string>'
},
shippingDetails: {
deliveryFromDate: '2023-11-07T05:31:56Z',
estimatedDeliveryDate: '2023-11-07T05:31:56Z',
extraWeight: 123,
maxDeliveryDays: 123,
shippingDate: '2023-11-07T05:31:56Z',
shippingPriority: 123
},
taxDetails: {},
text: {
comment: '<string>',
customerComment: '<string>',
printText: '<string>',
processStatus: '<string>'
},
customerSalesQuotationNumber: '<string>',
customerVatId: '<string>',
salesQuotationDate: '2023-11-07T05:31:56Z',
salesQuotationNumber: '<string>',
shippingMethodId: 'b45f6432-2462-4c6f-b00f-1d9d01000000'
})
};
fetch('https://api.jtl-cloud.com/erp/v2/sales-quotations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.jtl-cloud.com/erp/v2/sales-quotations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'companyId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'customerId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'billingAddress' => [
'street' => '<string>',
'city' => '<string>',
'countryIso' => '<string>',
'salutation' => '<string>',
'title' => '<string>',
'firstName' => '<string>',
'lastName' => '<string>',
'company' => '<string>',
'additionalCompanyLine' => '<string>',
'additionalAddressLine' => '<string>',
'postalCode' => '<string>',
'state' => '<string>',
'postId' => '<string>',
'emailAddress' => '<string>',
'phoneNumber' => '<string>',
'mobilePhoneNumber' => '<string>',
'fax' => '<string>'
],
'departureCountry' => [
'countryIso' => '<string>',
'currencyIso' => '<string>',
'currencyFactor' => 123,
'state' => '<string>',
'stateCode' => '<string>'
],
'lineItems' => [
[
'itemId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'parentSalesQuotationLineItemId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'taxClassId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'taxCodeId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'discountPercent' => 123,
'fnSku' => '<string>',
'name' => '<string>',
'note' => '<string>',
'purchasePriceNet' => 123,
'quantity' => 123,
'salesPriceNet' => 123,
'salesUnit' => '<string>',
'sku' => '<string>',
'taxRate' => 123,
'variants' => [
[
'name' => '<string>',
'itemVariantId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'extraWeight' => 123,
'surchargeNet' => 123,
'value' => '<string>',
'itemVariantValueId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000'
]
]
]
],
'paymentDetails' => [
'currencyIso' => '<string>',
'cashDiscount' => 123,
'cashDiscountDays' => 123,
'financingCosts' => 123,
'paymentDueDateInDays' => 123,
'currencyFactor' => 123
],
'languageIso' => '<string>',
'vatId' => '<string>',
'disableAutomaticWorkflows' => true,
'useBillingAddressAsShipmentAddress' => true,
'cartonItemId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'onHoldReasonId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'paymentMethodId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'processColourId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'processStatusId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'externalDetails' => [
'externalCreatedDate' => '2023-11-07T05:31:56Z',
'externalSalesQuotationNumber' => '<string>'
],
'paymentInfo' => [
'accountHolder' => '<string>',
'bankName' => '<string>',
'bIC' => '<string>',
'creditorId' => '<string>',
'dueDate' => '2023-11-07T05:31:56Z',
'endToEndId' => '<string>',
'iBAN' => '<string>',
'mandateReference' => '<string>',
'paymentInfo' => '<string>',
'paymentReference' => '<string>',
'referenceEmail' => '<string>'
],
'shippingDetails' => [
'deliveryFromDate' => '2023-11-07T05:31:56Z',
'estimatedDeliveryDate' => '2023-11-07T05:31:56Z',
'extraWeight' => 123,
'maxDeliveryDays' => 123,
'shippingDate' => '2023-11-07T05:31:56Z',
'shippingPriority' => 123
],
'taxDetails' => [
],
'text' => [
'comment' => '<string>',
'customerComment' => '<string>',
'printText' => '<string>',
'processStatus' => '<string>'
],
'customerSalesQuotationNumber' => '<string>',
'customerVatId' => '<string>',
'salesQuotationDate' => '2023-11-07T05:31:56Z',
'salesQuotationNumber' => '<string>',
'shippingMethodId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"x-tenant-id: <x-tenant-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.jtl-cloud.com/erp/v2/sales-quotations"
payload := strings.NewReader("{\n \"companyId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"customerId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"billingAddress\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"countryIso\": \"<string>\",\n \"salutation\": \"<string>\",\n \"title\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"company\": \"<string>\",\n \"additionalCompanyLine\": \"<string>\",\n \"additionalAddressLine\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"state\": \"<string>\",\n \"postId\": \"<string>\",\n \"emailAddress\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"mobilePhoneNumber\": \"<string>\",\n \"fax\": \"<string>\"\n },\n \"departureCountry\": {\n \"countryIso\": \"<string>\",\n \"currencyIso\": \"<string>\",\n \"currencyFactor\": 123,\n \"state\": \"<string>\",\n \"stateCode\": \"<string>\"\n },\n \"lineItems\": [\n {\n \"itemId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"parentSalesQuotationLineItemId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"taxClassId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"taxCodeId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"discountPercent\": 123,\n \"fnSku\": \"<string>\",\n \"name\": \"<string>\",\n \"note\": \"<string>\",\n \"purchasePriceNet\": 123,\n \"quantity\": 123,\n \"salesPriceNet\": 123,\n \"salesUnit\": \"<string>\",\n \"sku\": \"<string>\",\n \"taxRate\": 123,\n \"variants\": [\n {\n \"name\": \"<string>\",\n \"itemVariantId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"extraWeight\": 123,\n \"surchargeNet\": 123,\n \"value\": \"<string>\",\n \"itemVariantValueId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n }\n ],\n \"paymentDetails\": {\n \"currencyIso\": \"<string>\",\n \"cashDiscount\": 123,\n \"cashDiscountDays\": 123,\n \"financingCosts\": 123,\n \"paymentDueDateInDays\": 123,\n \"currencyFactor\": 123\n },\n \"languageIso\": \"<string>\",\n \"vatId\": \"<string>\",\n \"disableAutomaticWorkflows\": true,\n \"useBillingAddressAsShipmentAddress\": true,\n \"cartonItemId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"onHoldReasonId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"paymentMethodId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"processColourId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"processStatusId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"externalDetails\": {\n \"externalCreatedDate\": \"2023-11-07T05:31:56Z\",\n \"externalSalesQuotationNumber\": \"<string>\"\n },\n \"paymentInfo\": {\n \"accountHolder\": \"<string>\",\n \"bankName\": \"<string>\",\n \"bIC\": \"<string>\",\n \"creditorId\": \"<string>\",\n \"dueDate\": \"2023-11-07T05:31:56Z\",\n \"endToEndId\": \"<string>\",\n \"iBAN\": \"<string>\",\n \"mandateReference\": \"<string>\",\n \"paymentInfo\": \"<string>\",\n \"paymentReference\": \"<string>\",\n \"referenceEmail\": \"<string>\"\n },\n \"shippingDetails\": {\n \"deliveryFromDate\": \"2023-11-07T05:31:56Z\",\n \"estimatedDeliveryDate\": \"2023-11-07T05:31:56Z\",\n \"extraWeight\": 123,\n \"maxDeliveryDays\": 123,\n \"shippingDate\": \"2023-11-07T05:31:56Z\",\n \"shippingPriority\": 123\n },\n \"taxDetails\": {},\n \"text\": {\n \"comment\": \"<string>\",\n \"customerComment\": \"<string>\",\n \"printText\": \"<string>\",\n \"processStatus\": \"<string>\"\n },\n \"customerSalesQuotationNumber\": \"<string>\",\n \"customerVatId\": \"<string>\",\n \"salesQuotationDate\": \"2023-11-07T05:31:56Z\",\n \"salesQuotationNumber\": \"<string>\",\n \"shippingMethodId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-tenant-id", "<x-tenant-id>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.jtl-cloud.com/erp/v2/sales-quotations")
.header("x-tenant-id", "<x-tenant-id>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"companyId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"customerId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"billingAddress\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"countryIso\": \"<string>\",\n \"salutation\": \"<string>\",\n \"title\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"company\": \"<string>\",\n \"additionalCompanyLine\": \"<string>\",\n \"additionalAddressLine\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"state\": \"<string>\",\n \"postId\": \"<string>\",\n \"emailAddress\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"mobilePhoneNumber\": \"<string>\",\n \"fax\": \"<string>\"\n },\n \"departureCountry\": {\n \"countryIso\": \"<string>\",\n \"currencyIso\": \"<string>\",\n \"currencyFactor\": 123,\n \"state\": \"<string>\",\n \"stateCode\": \"<string>\"\n },\n \"lineItems\": [\n {\n \"itemId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"parentSalesQuotationLineItemId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"taxClassId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"taxCodeId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"discountPercent\": 123,\n \"fnSku\": \"<string>\",\n \"name\": \"<string>\",\n \"note\": \"<string>\",\n \"purchasePriceNet\": 123,\n \"quantity\": 123,\n \"salesPriceNet\": 123,\n \"salesUnit\": \"<string>\",\n \"sku\": \"<string>\",\n \"taxRate\": 123,\n \"variants\": [\n {\n \"name\": \"<string>\",\n \"itemVariantId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"extraWeight\": 123,\n \"surchargeNet\": 123,\n \"value\": \"<string>\",\n \"itemVariantValueId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n }\n ],\n \"paymentDetails\": {\n \"currencyIso\": \"<string>\",\n \"cashDiscount\": 123,\n \"cashDiscountDays\": 123,\n \"financingCosts\": 123,\n \"paymentDueDateInDays\": 123,\n \"currencyFactor\": 123\n },\n \"languageIso\": \"<string>\",\n \"vatId\": \"<string>\",\n \"disableAutomaticWorkflows\": true,\n \"useBillingAddressAsShipmentAddress\": true,\n \"cartonItemId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"onHoldReasonId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"paymentMethodId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"processColourId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"processStatusId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"externalDetails\": {\n \"externalCreatedDate\": \"2023-11-07T05:31:56Z\",\n \"externalSalesQuotationNumber\": \"<string>\"\n },\n \"paymentInfo\": {\n \"accountHolder\": \"<string>\",\n \"bankName\": \"<string>\",\n \"bIC\": \"<string>\",\n \"creditorId\": \"<string>\",\n \"dueDate\": \"2023-11-07T05:31:56Z\",\n \"endToEndId\": \"<string>\",\n \"iBAN\": \"<string>\",\n \"mandateReference\": \"<string>\",\n \"paymentInfo\": \"<string>\",\n \"paymentReference\": \"<string>\",\n \"referenceEmail\": \"<string>\"\n },\n \"shippingDetails\": {\n \"deliveryFromDate\": \"2023-11-07T05:31:56Z\",\n \"estimatedDeliveryDate\": \"2023-11-07T05:31:56Z\",\n \"extraWeight\": 123,\n \"maxDeliveryDays\": 123,\n \"shippingDate\": \"2023-11-07T05:31:56Z\",\n \"shippingPriority\": 123\n },\n \"taxDetails\": {},\n \"text\": {\n \"comment\": \"<string>\",\n \"customerComment\": \"<string>\",\n \"printText\": \"<string>\",\n \"processStatus\": \"<string>\"\n },\n \"customerSalesQuotationNumber\": \"<string>\",\n \"customerVatId\": \"<string>\",\n \"salesQuotationDate\": \"2023-11-07T05:31:56Z\",\n \"salesQuotationNumber\": \"<string>\",\n \"shippingMethodId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.jtl-cloud.com/erp/v2/sales-quotations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-tenant-id"] = '<x-tenant-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"companyId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"customerId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"billingAddress\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"countryIso\": \"<string>\",\n \"salutation\": \"<string>\",\n \"title\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"company\": \"<string>\",\n \"additionalCompanyLine\": \"<string>\",\n \"additionalAddressLine\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"state\": \"<string>\",\n \"postId\": \"<string>\",\n \"emailAddress\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"mobilePhoneNumber\": \"<string>\",\n \"fax\": \"<string>\"\n },\n \"departureCountry\": {\n \"countryIso\": \"<string>\",\n \"currencyIso\": \"<string>\",\n \"currencyFactor\": 123,\n \"state\": \"<string>\",\n \"stateCode\": \"<string>\"\n },\n \"lineItems\": [\n {\n \"itemId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"parentSalesQuotationLineItemId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"taxClassId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"taxCodeId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"discountPercent\": 123,\n \"fnSku\": \"<string>\",\n \"name\": \"<string>\",\n \"note\": \"<string>\",\n \"purchasePriceNet\": 123,\n \"quantity\": 123,\n \"salesPriceNet\": 123,\n \"salesUnit\": \"<string>\",\n \"sku\": \"<string>\",\n \"taxRate\": 123,\n \"variants\": [\n {\n \"name\": \"<string>\",\n \"itemVariantId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"extraWeight\": 123,\n \"surchargeNet\": 123,\n \"value\": \"<string>\",\n \"itemVariantValueId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n }\n ],\n \"paymentDetails\": {\n \"currencyIso\": \"<string>\",\n \"cashDiscount\": 123,\n \"cashDiscountDays\": 123,\n \"financingCosts\": 123,\n \"paymentDueDateInDays\": 123,\n \"currencyFactor\": 123\n },\n \"languageIso\": \"<string>\",\n \"vatId\": \"<string>\",\n \"disableAutomaticWorkflows\": true,\n \"useBillingAddressAsShipmentAddress\": true,\n \"cartonItemId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"onHoldReasonId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"paymentMethodId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"processColourId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"processStatusId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"externalDetails\": {\n \"externalCreatedDate\": \"2023-11-07T05:31:56Z\",\n \"externalSalesQuotationNumber\": \"<string>\"\n },\n \"paymentInfo\": {\n \"accountHolder\": \"<string>\",\n \"bankName\": \"<string>\",\n \"bIC\": \"<string>\",\n \"creditorId\": \"<string>\",\n \"dueDate\": \"2023-11-07T05:31:56Z\",\n \"endToEndId\": \"<string>\",\n \"iBAN\": \"<string>\",\n \"mandateReference\": \"<string>\",\n \"paymentInfo\": \"<string>\",\n \"paymentReference\": \"<string>\",\n \"referenceEmail\": \"<string>\"\n },\n \"shippingDetails\": {\n \"deliveryFromDate\": \"2023-11-07T05:31:56Z\",\n \"estimatedDeliveryDate\": \"2023-11-07T05:31:56Z\",\n \"extraWeight\": 123,\n \"maxDeliveryDays\": 123,\n \"shippingDate\": \"2023-11-07T05:31:56Z\",\n \"shippingPriority\": 123\n },\n \"taxDetails\": {},\n \"text\": {\n \"comment\": \"<string>\",\n \"customerComment\": \"<string>\",\n \"printText\": \"<string>\",\n \"processStatus\": \"<string>\"\n },\n \"customerSalesQuotationNumber\": \"<string>\",\n \"customerVatId\": \"<string>\",\n \"salesQuotationDate\": \"2023-11-07T05:31:56Z\",\n \"salesQuotationNumber\": \"<string>\",\n \"shippingMethodId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n}"
response = http.request(request)
puts response.read_body{
"salesQuotationId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}Sales Quotation
Creates a new sales quotation.
Creates a new sales quotation.
POST
/
v2
/
sales-quotations
Creates a new sales quotation.
curl --request POST \
--url https://api.jtl-cloud.com/erp/v2/sales-quotations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-tenant-id: <x-tenant-id>' \
--data '
{
"companyId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"customerId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"billingAddress": {
"street": "<string>",
"city": "<string>",
"countryIso": "<string>",
"salutation": "<string>",
"title": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"company": "<string>",
"additionalCompanyLine": "<string>",
"additionalAddressLine": "<string>",
"postalCode": "<string>",
"state": "<string>",
"postId": "<string>",
"emailAddress": "<string>",
"phoneNumber": "<string>",
"mobilePhoneNumber": "<string>",
"fax": "<string>"
},
"departureCountry": {
"countryIso": "<string>",
"currencyIso": "<string>",
"currencyFactor": 123,
"state": "<string>",
"stateCode": "<string>"
},
"lineItems": [
{
"itemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"parentSalesQuotationLineItemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"taxClassId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"taxCodeId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"discountPercent": 123,
"fnSku": "<string>",
"name": "<string>",
"note": "<string>",
"purchasePriceNet": 123,
"quantity": 123,
"salesPriceNet": 123,
"salesUnit": "<string>",
"sku": "<string>",
"taxRate": 123,
"variants": [
{
"name": "<string>",
"itemVariantId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"extraWeight": 123,
"surchargeNet": 123,
"value": "<string>",
"itemVariantValueId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}
]
}
],
"paymentDetails": {
"currencyIso": "<string>",
"cashDiscount": 123,
"cashDiscountDays": 123,
"financingCosts": 123,
"paymentDueDateInDays": 123,
"currencyFactor": 123
},
"languageIso": "<string>",
"vatId": "<string>",
"disableAutomaticWorkflows": true,
"useBillingAddressAsShipmentAddress": true,
"cartonItemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"onHoldReasonId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"paymentMethodId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"processColourId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"processStatusId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"externalDetails": {
"externalCreatedDate": "2023-11-07T05:31:56Z",
"externalSalesQuotationNumber": "<string>"
},
"paymentInfo": {
"accountHolder": "<string>",
"bankName": "<string>",
"bIC": "<string>",
"creditorId": "<string>",
"dueDate": "2023-11-07T05:31:56Z",
"endToEndId": "<string>",
"iBAN": "<string>",
"mandateReference": "<string>",
"paymentInfo": "<string>",
"paymentReference": "<string>",
"referenceEmail": "<string>"
},
"shippingDetails": {
"deliveryFromDate": "2023-11-07T05:31:56Z",
"estimatedDeliveryDate": "2023-11-07T05:31:56Z",
"extraWeight": 123,
"maxDeliveryDays": 123,
"shippingDate": "2023-11-07T05:31:56Z",
"shippingPriority": 123
},
"taxDetails": {},
"text": {
"comment": "<string>",
"customerComment": "<string>",
"printText": "<string>",
"processStatus": "<string>"
},
"customerSalesQuotationNumber": "<string>",
"customerVatId": "<string>",
"salesQuotationDate": "2023-11-07T05:31:56Z",
"salesQuotationNumber": "<string>",
"shippingMethodId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}
'import requests
url = "https://api.jtl-cloud.com/erp/v2/sales-quotations"
payload = {
"companyId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"customerId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"billingAddress": {
"street": "<string>",
"city": "<string>",
"countryIso": "<string>",
"salutation": "<string>",
"title": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"company": "<string>",
"additionalCompanyLine": "<string>",
"additionalAddressLine": "<string>",
"postalCode": "<string>",
"state": "<string>",
"postId": "<string>",
"emailAddress": "<string>",
"phoneNumber": "<string>",
"mobilePhoneNumber": "<string>",
"fax": "<string>"
},
"departureCountry": {
"countryIso": "<string>",
"currencyIso": "<string>",
"currencyFactor": 123,
"state": "<string>",
"stateCode": "<string>"
},
"lineItems": [
{
"itemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"parentSalesQuotationLineItemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"taxClassId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"taxCodeId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"discountPercent": 123,
"fnSku": "<string>",
"name": "<string>",
"note": "<string>",
"purchasePriceNet": 123,
"quantity": 123,
"salesPriceNet": 123,
"salesUnit": "<string>",
"sku": "<string>",
"taxRate": 123,
"variants": [
{
"name": "<string>",
"itemVariantId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"extraWeight": 123,
"surchargeNet": 123,
"value": "<string>",
"itemVariantValueId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}
]
}
],
"paymentDetails": {
"currencyIso": "<string>",
"cashDiscount": 123,
"cashDiscountDays": 123,
"financingCosts": 123,
"paymentDueDateInDays": 123,
"currencyFactor": 123
},
"languageIso": "<string>",
"vatId": "<string>",
"disableAutomaticWorkflows": True,
"useBillingAddressAsShipmentAddress": True,
"cartonItemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"onHoldReasonId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"paymentMethodId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"processColourId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"processStatusId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"externalDetails": {
"externalCreatedDate": "2023-11-07T05:31:56Z",
"externalSalesQuotationNumber": "<string>"
},
"paymentInfo": {
"accountHolder": "<string>",
"bankName": "<string>",
"bIC": "<string>",
"creditorId": "<string>",
"dueDate": "2023-11-07T05:31:56Z",
"endToEndId": "<string>",
"iBAN": "<string>",
"mandateReference": "<string>",
"paymentInfo": "<string>",
"paymentReference": "<string>",
"referenceEmail": "<string>"
},
"shippingDetails": {
"deliveryFromDate": "2023-11-07T05:31:56Z",
"estimatedDeliveryDate": "2023-11-07T05:31:56Z",
"extraWeight": 123,
"maxDeliveryDays": 123,
"shippingDate": "2023-11-07T05:31:56Z",
"shippingPriority": 123
},
"taxDetails": {},
"text": {
"comment": "<string>",
"customerComment": "<string>",
"printText": "<string>",
"processStatus": "<string>"
},
"customerSalesQuotationNumber": "<string>",
"customerVatId": "<string>",
"salesQuotationDate": "2023-11-07T05:31:56Z",
"salesQuotationNumber": "<string>",
"shippingMethodId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}
headers = {
"x-tenant-id": "<x-tenant-id>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-tenant-id': '<x-tenant-id>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
companyId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
customerId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
billingAddress: {
street: '<string>',
city: '<string>',
countryIso: '<string>',
salutation: '<string>',
title: '<string>',
firstName: '<string>',
lastName: '<string>',
company: '<string>',
additionalCompanyLine: '<string>',
additionalAddressLine: '<string>',
postalCode: '<string>',
state: '<string>',
postId: '<string>',
emailAddress: '<string>',
phoneNumber: '<string>',
mobilePhoneNumber: '<string>',
fax: '<string>'
},
departureCountry: {
countryIso: '<string>',
currencyIso: '<string>',
currencyFactor: 123,
state: '<string>',
stateCode: '<string>'
},
lineItems: [
{
itemId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
parentSalesQuotationLineItemId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
taxClassId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
taxCodeId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
discountPercent: 123,
fnSku: '<string>',
name: '<string>',
note: '<string>',
purchasePriceNet: 123,
quantity: 123,
salesPriceNet: 123,
salesUnit: '<string>',
sku: '<string>',
taxRate: 123,
variants: [
{
name: '<string>',
itemVariantId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
extraWeight: 123,
surchargeNet: 123,
value: '<string>',
itemVariantValueId: 'b45f6432-2462-4c6f-b00f-1d9d01000000'
}
]
}
],
paymentDetails: {
currencyIso: '<string>',
cashDiscount: 123,
cashDiscountDays: 123,
financingCosts: 123,
paymentDueDateInDays: 123,
currencyFactor: 123
},
languageIso: '<string>',
vatId: '<string>',
disableAutomaticWorkflows: true,
useBillingAddressAsShipmentAddress: true,
cartonItemId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
onHoldReasonId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
paymentMethodId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
processColourId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
processStatusId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
externalDetails: {
externalCreatedDate: '2023-11-07T05:31:56Z',
externalSalesQuotationNumber: '<string>'
},
paymentInfo: {
accountHolder: '<string>',
bankName: '<string>',
bIC: '<string>',
creditorId: '<string>',
dueDate: '2023-11-07T05:31:56Z',
endToEndId: '<string>',
iBAN: '<string>',
mandateReference: '<string>',
paymentInfo: '<string>',
paymentReference: '<string>',
referenceEmail: '<string>'
},
shippingDetails: {
deliveryFromDate: '2023-11-07T05:31:56Z',
estimatedDeliveryDate: '2023-11-07T05:31:56Z',
extraWeight: 123,
maxDeliveryDays: 123,
shippingDate: '2023-11-07T05:31:56Z',
shippingPriority: 123
},
taxDetails: {},
text: {
comment: '<string>',
customerComment: '<string>',
printText: '<string>',
processStatus: '<string>'
},
customerSalesQuotationNumber: '<string>',
customerVatId: '<string>',
salesQuotationDate: '2023-11-07T05:31:56Z',
salesQuotationNumber: '<string>',
shippingMethodId: 'b45f6432-2462-4c6f-b00f-1d9d01000000'
})
};
fetch('https://api.jtl-cloud.com/erp/v2/sales-quotations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.jtl-cloud.com/erp/v2/sales-quotations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'companyId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'customerId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'billingAddress' => [
'street' => '<string>',
'city' => '<string>',
'countryIso' => '<string>',
'salutation' => '<string>',
'title' => '<string>',
'firstName' => '<string>',
'lastName' => '<string>',
'company' => '<string>',
'additionalCompanyLine' => '<string>',
'additionalAddressLine' => '<string>',
'postalCode' => '<string>',
'state' => '<string>',
'postId' => '<string>',
'emailAddress' => '<string>',
'phoneNumber' => '<string>',
'mobilePhoneNumber' => '<string>',
'fax' => '<string>'
],
'departureCountry' => [
'countryIso' => '<string>',
'currencyIso' => '<string>',
'currencyFactor' => 123,
'state' => '<string>',
'stateCode' => '<string>'
],
'lineItems' => [
[
'itemId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'parentSalesQuotationLineItemId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'taxClassId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'taxCodeId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'discountPercent' => 123,
'fnSku' => '<string>',
'name' => '<string>',
'note' => '<string>',
'purchasePriceNet' => 123,
'quantity' => 123,
'salesPriceNet' => 123,
'salesUnit' => '<string>',
'sku' => '<string>',
'taxRate' => 123,
'variants' => [
[
'name' => '<string>',
'itemVariantId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'extraWeight' => 123,
'surchargeNet' => 123,
'value' => '<string>',
'itemVariantValueId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000'
]
]
]
],
'paymentDetails' => [
'currencyIso' => '<string>',
'cashDiscount' => 123,
'cashDiscountDays' => 123,
'financingCosts' => 123,
'paymentDueDateInDays' => 123,
'currencyFactor' => 123
],
'languageIso' => '<string>',
'vatId' => '<string>',
'disableAutomaticWorkflows' => true,
'useBillingAddressAsShipmentAddress' => true,
'cartonItemId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'onHoldReasonId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'paymentMethodId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'processColourId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'processStatusId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'externalDetails' => [
'externalCreatedDate' => '2023-11-07T05:31:56Z',
'externalSalesQuotationNumber' => '<string>'
],
'paymentInfo' => [
'accountHolder' => '<string>',
'bankName' => '<string>',
'bIC' => '<string>',
'creditorId' => '<string>',
'dueDate' => '2023-11-07T05:31:56Z',
'endToEndId' => '<string>',
'iBAN' => '<string>',
'mandateReference' => '<string>',
'paymentInfo' => '<string>',
'paymentReference' => '<string>',
'referenceEmail' => '<string>'
],
'shippingDetails' => [
'deliveryFromDate' => '2023-11-07T05:31:56Z',
'estimatedDeliveryDate' => '2023-11-07T05:31:56Z',
'extraWeight' => 123,
'maxDeliveryDays' => 123,
'shippingDate' => '2023-11-07T05:31:56Z',
'shippingPriority' => 123
],
'taxDetails' => [
],
'text' => [
'comment' => '<string>',
'customerComment' => '<string>',
'printText' => '<string>',
'processStatus' => '<string>'
],
'customerSalesQuotationNumber' => '<string>',
'customerVatId' => '<string>',
'salesQuotationDate' => '2023-11-07T05:31:56Z',
'salesQuotationNumber' => '<string>',
'shippingMethodId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"x-tenant-id: <x-tenant-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.jtl-cloud.com/erp/v2/sales-quotations"
payload := strings.NewReader("{\n \"companyId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"customerId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"billingAddress\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"countryIso\": \"<string>\",\n \"salutation\": \"<string>\",\n \"title\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"company\": \"<string>\",\n \"additionalCompanyLine\": \"<string>\",\n \"additionalAddressLine\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"state\": \"<string>\",\n \"postId\": \"<string>\",\n \"emailAddress\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"mobilePhoneNumber\": \"<string>\",\n \"fax\": \"<string>\"\n },\n \"departureCountry\": {\n \"countryIso\": \"<string>\",\n \"currencyIso\": \"<string>\",\n \"currencyFactor\": 123,\n \"state\": \"<string>\",\n \"stateCode\": \"<string>\"\n },\n \"lineItems\": [\n {\n \"itemId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"parentSalesQuotationLineItemId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"taxClassId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"taxCodeId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"discountPercent\": 123,\n \"fnSku\": \"<string>\",\n \"name\": \"<string>\",\n \"note\": \"<string>\",\n \"purchasePriceNet\": 123,\n \"quantity\": 123,\n \"salesPriceNet\": 123,\n \"salesUnit\": \"<string>\",\n \"sku\": \"<string>\",\n \"taxRate\": 123,\n \"variants\": [\n {\n \"name\": \"<string>\",\n \"itemVariantId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"extraWeight\": 123,\n \"surchargeNet\": 123,\n \"value\": \"<string>\",\n \"itemVariantValueId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n }\n ],\n \"paymentDetails\": {\n \"currencyIso\": \"<string>\",\n \"cashDiscount\": 123,\n \"cashDiscountDays\": 123,\n \"financingCosts\": 123,\n \"paymentDueDateInDays\": 123,\n \"currencyFactor\": 123\n },\n \"languageIso\": \"<string>\",\n \"vatId\": \"<string>\",\n \"disableAutomaticWorkflows\": true,\n \"useBillingAddressAsShipmentAddress\": true,\n \"cartonItemId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"onHoldReasonId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"paymentMethodId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"processColourId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"processStatusId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"externalDetails\": {\n \"externalCreatedDate\": \"2023-11-07T05:31:56Z\",\n \"externalSalesQuotationNumber\": \"<string>\"\n },\n \"paymentInfo\": {\n \"accountHolder\": \"<string>\",\n \"bankName\": \"<string>\",\n \"bIC\": \"<string>\",\n \"creditorId\": \"<string>\",\n \"dueDate\": \"2023-11-07T05:31:56Z\",\n \"endToEndId\": \"<string>\",\n \"iBAN\": \"<string>\",\n \"mandateReference\": \"<string>\",\n \"paymentInfo\": \"<string>\",\n \"paymentReference\": \"<string>\",\n \"referenceEmail\": \"<string>\"\n },\n \"shippingDetails\": {\n \"deliveryFromDate\": \"2023-11-07T05:31:56Z\",\n \"estimatedDeliveryDate\": \"2023-11-07T05:31:56Z\",\n \"extraWeight\": 123,\n \"maxDeliveryDays\": 123,\n \"shippingDate\": \"2023-11-07T05:31:56Z\",\n \"shippingPriority\": 123\n },\n \"taxDetails\": {},\n \"text\": {\n \"comment\": \"<string>\",\n \"customerComment\": \"<string>\",\n \"printText\": \"<string>\",\n \"processStatus\": \"<string>\"\n },\n \"customerSalesQuotationNumber\": \"<string>\",\n \"customerVatId\": \"<string>\",\n \"salesQuotationDate\": \"2023-11-07T05:31:56Z\",\n \"salesQuotationNumber\": \"<string>\",\n \"shippingMethodId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-tenant-id", "<x-tenant-id>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.jtl-cloud.com/erp/v2/sales-quotations")
.header("x-tenant-id", "<x-tenant-id>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"companyId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"customerId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"billingAddress\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"countryIso\": \"<string>\",\n \"salutation\": \"<string>\",\n \"title\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"company\": \"<string>\",\n \"additionalCompanyLine\": \"<string>\",\n \"additionalAddressLine\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"state\": \"<string>\",\n \"postId\": \"<string>\",\n \"emailAddress\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"mobilePhoneNumber\": \"<string>\",\n \"fax\": \"<string>\"\n },\n \"departureCountry\": {\n \"countryIso\": \"<string>\",\n \"currencyIso\": \"<string>\",\n \"currencyFactor\": 123,\n \"state\": \"<string>\",\n \"stateCode\": \"<string>\"\n },\n \"lineItems\": [\n {\n \"itemId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"parentSalesQuotationLineItemId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"taxClassId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"taxCodeId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"discountPercent\": 123,\n \"fnSku\": \"<string>\",\n \"name\": \"<string>\",\n \"note\": \"<string>\",\n \"purchasePriceNet\": 123,\n \"quantity\": 123,\n \"salesPriceNet\": 123,\n \"salesUnit\": \"<string>\",\n \"sku\": \"<string>\",\n \"taxRate\": 123,\n \"variants\": [\n {\n \"name\": \"<string>\",\n \"itemVariantId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"extraWeight\": 123,\n \"surchargeNet\": 123,\n \"value\": \"<string>\",\n \"itemVariantValueId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n }\n ],\n \"paymentDetails\": {\n \"currencyIso\": \"<string>\",\n \"cashDiscount\": 123,\n \"cashDiscountDays\": 123,\n \"financingCosts\": 123,\n \"paymentDueDateInDays\": 123,\n \"currencyFactor\": 123\n },\n \"languageIso\": \"<string>\",\n \"vatId\": \"<string>\",\n \"disableAutomaticWorkflows\": true,\n \"useBillingAddressAsShipmentAddress\": true,\n \"cartonItemId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"onHoldReasonId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"paymentMethodId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"processColourId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"processStatusId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"externalDetails\": {\n \"externalCreatedDate\": \"2023-11-07T05:31:56Z\",\n \"externalSalesQuotationNumber\": \"<string>\"\n },\n \"paymentInfo\": {\n \"accountHolder\": \"<string>\",\n \"bankName\": \"<string>\",\n \"bIC\": \"<string>\",\n \"creditorId\": \"<string>\",\n \"dueDate\": \"2023-11-07T05:31:56Z\",\n \"endToEndId\": \"<string>\",\n \"iBAN\": \"<string>\",\n \"mandateReference\": \"<string>\",\n \"paymentInfo\": \"<string>\",\n \"paymentReference\": \"<string>\",\n \"referenceEmail\": \"<string>\"\n },\n \"shippingDetails\": {\n \"deliveryFromDate\": \"2023-11-07T05:31:56Z\",\n \"estimatedDeliveryDate\": \"2023-11-07T05:31:56Z\",\n \"extraWeight\": 123,\n \"maxDeliveryDays\": 123,\n \"shippingDate\": \"2023-11-07T05:31:56Z\",\n \"shippingPriority\": 123\n },\n \"taxDetails\": {},\n \"text\": {\n \"comment\": \"<string>\",\n \"customerComment\": \"<string>\",\n \"printText\": \"<string>\",\n \"processStatus\": \"<string>\"\n },\n \"customerSalesQuotationNumber\": \"<string>\",\n \"customerVatId\": \"<string>\",\n \"salesQuotationDate\": \"2023-11-07T05:31:56Z\",\n \"salesQuotationNumber\": \"<string>\",\n \"shippingMethodId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.jtl-cloud.com/erp/v2/sales-quotations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-tenant-id"] = '<x-tenant-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"companyId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"customerId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"billingAddress\": {\n \"street\": \"<string>\",\n \"city\": \"<string>\",\n \"countryIso\": \"<string>\",\n \"salutation\": \"<string>\",\n \"title\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"company\": \"<string>\",\n \"additionalCompanyLine\": \"<string>\",\n \"additionalAddressLine\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"state\": \"<string>\",\n \"postId\": \"<string>\",\n \"emailAddress\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"mobilePhoneNumber\": \"<string>\",\n \"fax\": \"<string>\"\n },\n \"departureCountry\": {\n \"countryIso\": \"<string>\",\n \"currencyIso\": \"<string>\",\n \"currencyFactor\": 123,\n \"state\": \"<string>\",\n \"stateCode\": \"<string>\"\n },\n \"lineItems\": [\n {\n \"itemId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"parentSalesQuotationLineItemId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"taxClassId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"taxCodeId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"discountPercent\": 123,\n \"fnSku\": \"<string>\",\n \"name\": \"<string>\",\n \"note\": \"<string>\",\n \"purchasePriceNet\": 123,\n \"quantity\": 123,\n \"salesPriceNet\": 123,\n \"salesUnit\": \"<string>\",\n \"sku\": \"<string>\",\n \"taxRate\": 123,\n \"variants\": [\n {\n \"name\": \"<string>\",\n \"itemVariantId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"extraWeight\": 123,\n \"surchargeNet\": 123,\n \"value\": \"<string>\",\n \"itemVariantValueId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n }\n ],\n \"paymentDetails\": {\n \"currencyIso\": \"<string>\",\n \"cashDiscount\": 123,\n \"cashDiscountDays\": 123,\n \"financingCosts\": 123,\n \"paymentDueDateInDays\": 123,\n \"currencyFactor\": 123\n },\n \"languageIso\": \"<string>\",\n \"vatId\": \"<string>\",\n \"disableAutomaticWorkflows\": true,\n \"useBillingAddressAsShipmentAddress\": true,\n \"cartonItemId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"onHoldReasonId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"paymentMethodId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"processColourId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"processStatusId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"externalDetails\": {\n \"externalCreatedDate\": \"2023-11-07T05:31:56Z\",\n \"externalSalesQuotationNumber\": \"<string>\"\n },\n \"paymentInfo\": {\n \"accountHolder\": \"<string>\",\n \"bankName\": \"<string>\",\n \"bIC\": \"<string>\",\n \"creditorId\": \"<string>\",\n \"dueDate\": \"2023-11-07T05:31:56Z\",\n \"endToEndId\": \"<string>\",\n \"iBAN\": \"<string>\",\n \"mandateReference\": \"<string>\",\n \"paymentInfo\": \"<string>\",\n \"paymentReference\": \"<string>\",\n \"referenceEmail\": \"<string>\"\n },\n \"shippingDetails\": {\n \"deliveryFromDate\": \"2023-11-07T05:31:56Z\",\n \"estimatedDeliveryDate\": \"2023-11-07T05:31:56Z\",\n \"extraWeight\": 123,\n \"maxDeliveryDays\": 123,\n \"shippingDate\": \"2023-11-07T05:31:56Z\",\n \"shippingPriority\": 123\n },\n \"taxDetails\": {},\n \"text\": {\n \"comment\": \"<string>\",\n \"customerComment\": \"<string>\",\n \"printText\": \"<string>\",\n \"processStatus\": \"<string>\"\n },\n \"customerSalesQuotationNumber\": \"<string>\",\n \"customerVatId\": \"<string>\",\n \"salesQuotationDate\": \"2023-11-07T05:31:56Z\",\n \"salesQuotationNumber\": \"<string>\",\n \"shippingMethodId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n}"
response = http.request(request)
puts response.read_body{
"salesQuotationId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}Authorizations
oauth2-authorization-codeoauth2-client-credentials
The access token received from the authorization server in the OAuth 2.0 flow.
Headers
The Company-Id (int or uuid) of the company on whose behalf the request is executed.
The tenant ID for the target ERP instance.
Body
application/json
Request parameters
Creates a new sales quotation. - Request
The SalesQuotation CompanyId
Example:
"b45f6432-2462-4c6f-b00f-1d9d01000000"
The customer ID.
Example:
"b45f6432-2462-4c6f-b00f-1d9d01000000"
SalesQuotationBillingAddress
Show child attributes
Show child attributes
DepartureCountry
Show child attributes
Show child attributes
List of SalesQuotationLineItem
Show child attributes
Show child attributes
PaymentDetails
Show child attributes
Show child attributes
The SalesQuotation LanguageISO
Required string length:
2 - 5The SalesQuotation VATId
Indicates whether automatic workflows should be disabled for this sales quotation.
Indicates whether the billing address should be used as the shipment address. If no shipment address is provided and the flag ist not set, the billing address will also be used as shipment address. If the shipment address is provided, this flag will be ignored.
The SalesQuotation CartonItemId
Example:
"b45f6432-2462-4c6f-b00f-1d9d01000000"
The SalesQuotation OnHoldReasonId
Example:
"b45f6432-2462-4c6f-b00f-1d9d01000000"
The SalesQuotation PaymentMethodId
Example:
"b45f6432-2462-4c6f-b00f-1d9d01000000"
The SalesQuotation ProcessColourId
Example:
"b45f6432-2462-4c6f-b00f-1d9d01000000"
The SalesQuotation ProcessStatusId
Example:
"b45f6432-2462-4c6f-b00f-1d9d01000000"
ExternalDetails
Show child attributes
Show child attributes
SalesQuotationPaymentInfo
Show child attributes
Show child attributes
SalesQuotationShipmentAddress
Show child attributes
Show child attributes
ShippingDetails
Show child attributes
Show child attributes
TaxDetails
Show child attributes
Show child attributes
SalesQuotationText
Show child attributes
Show child attributes
The SalesQuotation CustomerSalesQuotationNumber
The VAT ID of the customer.
The SalesQuotation ItemDescriptionType
Available options:
0, 1, 2 The SalesQuotation ReadOnlyType
Available options:
0, 1, 2 The SalesQuotation Date
The SalesQuotation SalesQuotationNumber
The SalesQuotation ShippingMethodId
Example:
"b45f6432-2462-4c6f-b00f-1d9d01000000"
Response
Sales quotation created successfully
Creates a new sales quotation. - Response
Unique ID of the newly created sales quotation.
Example:
"b45f6432-2462-4c6f-b00f-1d9d01000000"
Was this page helpful?
⌘I