Create Sales Order

Create Sales Order

curl --request POST \
  --url https://api.jtl-cloud.com/erp/salesOrders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-tenant-id: <x-tenant-id>' \
  --data '
{
  "CompanyId": 123,
  "CustomerId": 123,
  "Number": "<string>",
  "ExternalNumber": "<string>",
  "BillingNumber": "<string>",
  "DepartureCountry": {
    "CountryISO": "<string>",
    "State": "<string>",
    "CurrencyIso": "<string>",
    "CurrencyFactor": 123
  },
  "CustomerVatID": "<string>",
  "SalesOrderDate": "2023-11-07T05:31:56Z",
  "SalesOrderPaymentDetails": {
    "PaymentMethodId": 123,
    "CurrencyIso": "<string>",
    "CurrencyFactor": 123,
    "PaymentTarget": 123,
    "CashDiscount": 123,
    "CashDiscountDays": 123
  },
  "SalesOrderShippingDetail": {
    "ShippingMethodId": 123,
    "ShippingPriority": 123,
    "ShippingDate": "2023-11-07T05:31:56Z",
    "EstimatedDeliveryDate": "2023-11-07T05:31:56Z",
    "OnHoldReasonId": 123,
    "ExtraWeight": 123
  },
  "ColorcodeId": 123,
  "Comment": "<string>",
  "CustomerComment": "<string>",
  "LanguageIso": "<string>"
}
'

import requests

url = "https://api.jtl-cloud.com/erp/salesOrders"

payload = {
    "CompanyId": 123,
    "CustomerId": 123,
    "Number": "<string>",
    "ExternalNumber": "<string>",
    "BillingNumber": "<string>",
    "DepartureCountry": {
        "CountryISO": "<string>",
        "State": "<string>",
        "CurrencyIso": "<string>",
        "CurrencyFactor": 123
    },
    "CustomerVatID": "<string>",
    "SalesOrderDate": "2023-11-07T05:31:56Z",
    "SalesOrderPaymentDetails": {
        "PaymentMethodId": 123,
        "CurrencyIso": "<string>",
        "CurrencyFactor": 123,
        "PaymentTarget": 123,
        "CashDiscount": 123,
        "CashDiscountDays": 123
    },
    "SalesOrderShippingDetail": {
        "ShippingMethodId": 123,
        "ShippingPriority": 123,
        "ShippingDate": "2023-11-07T05:31:56Z",
        "EstimatedDeliveryDate": "2023-11-07T05:31:56Z",
        "OnHoldReasonId": 123,
        "ExtraWeight": 123
    },
    "ColorcodeId": 123,
    "Comment": "<string>",
    "CustomerComment": "<string>",
    "LanguageIso": "<string>"
}
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: 123,
    CustomerId: 123,
    Number: '<string>',
    ExternalNumber: '<string>',
    BillingNumber: '<string>',
    DepartureCountry: {
      CountryISO: '<string>',
      State: '<string>',
      CurrencyIso: '<string>',
      CurrencyFactor: 123
    },
    CustomerVatID: '<string>',
    SalesOrderDate: '2023-11-07T05:31:56Z',
    SalesOrderPaymentDetails: {
      PaymentMethodId: 123,
      CurrencyIso: '<string>',
      CurrencyFactor: 123,
      PaymentTarget: 123,
      CashDiscount: 123,
      CashDiscountDays: 123
    },
    SalesOrderShippingDetail: {
      ShippingMethodId: 123,
      ShippingPriority: 123,
      ShippingDate: '2023-11-07T05:31:56Z',
      EstimatedDeliveryDate: '2023-11-07T05:31:56Z',
      OnHoldReasonId: 123,
      ExtraWeight: 123
    },
    ColorcodeId: 123,
    Comment: '<string>',
    CustomerComment: '<string>',
    LanguageIso: '<string>'
  })
};

fetch('https://api.jtl-cloud.com/erp/salesOrders', 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/salesOrders",
  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' => 123,
    'CustomerId' => 123,
    'Number' => '<string>',
    'ExternalNumber' => '<string>',
    'BillingNumber' => '<string>',
    'DepartureCountry' => [
        'CountryISO' => '<string>',
        'State' => '<string>',
        'CurrencyIso' => '<string>',
        'CurrencyFactor' => 123
    ],
    'CustomerVatID' => '<string>',
    'SalesOrderDate' => '2023-11-07T05:31:56Z',
    'SalesOrderPaymentDetails' => [
        'PaymentMethodId' => 123,
        'CurrencyIso' => '<string>',
        'CurrencyFactor' => 123,
        'PaymentTarget' => 123,
        'CashDiscount' => 123,
        'CashDiscountDays' => 123
    ],
    'SalesOrderShippingDetail' => [
        'ShippingMethodId' => 123,
        'ShippingPriority' => 123,
        'ShippingDate' => '2023-11-07T05:31:56Z',
        'EstimatedDeliveryDate' => '2023-11-07T05:31:56Z',
        'OnHoldReasonId' => 123,
        'ExtraWeight' => 123
    ],
    'ColorcodeId' => 123,
    'Comment' => '<string>',
    'CustomerComment' => '<string>',
    'LanguageIso' => '<string>'
  ]),
  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/salesOrders"

	payload := strings.NewReader("{\n  \"CompanyId\": 123,\n  \"CustomerId\": 123,\n  \"Number\": \"<string>\",\n  \"ExternalNumber\": \"<string>\",\n  \"BillingNumber\": \"<string>\",\n  \"DepartureCountry\": {\n    \"CountryISO\": \"<string>\",\n    \"State\": \"<string>\",\n    \"CurrencyIso\": \"<string>\",\n    \"CurrencyFactor\": 123\n  },\n  \"CustomerVatID\": \"<string>\",\n  \"SalesOrderDate\": \"2023-11-07T05:31:56Z\",\n  \"SalesOrderPaymentDetails\": {\n    \"PaymentMethodId\": 123,\n    \"CurrencyIso\": \"<string>\",\n    \"CurrencyFactor\": 123,\n    \"PaymentTarget\": 123,\n    \"CashDiscount\": 123,\n    \"CashDiscountDays\": 123\n  },\n  \"SalesOrderShippingDetail\": {\n    \"ShippingMethodId\": 123,\n    \"ShippingPriority\": 123,\n    \"ShippingDate\": \"2023-11-07T05:31:56Z\",\n    \"EstimatedDeliveryDate\": \"2023-11-07T05:31:56Z\",\n    \"OnHoldReasonId\": 123,\n    \"ExtraWeight\": 123\n  },\n  \"ColorcodeId\": 123,\n  \"Comment\": \"<string>\",\n  \"CustomerComment\": \"<string>\",\n  \"LanguageIso\": \"<string>\"\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/salesOrders")
  .header("x-tenant-id", "<x-tenant-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"CompanyId\": 123,\n  \"CustomerId\": 123,\n  \"Number\": \"<string>\",\n  \"ExternalNumber\": \"<string>\",\n  \"BillingNumber\": \"<string>\",\n  \"DepartureCountry\": {\n    \"CountryISO\": \"<string>\",\n    \"State\": \"<string>\",\n    \"CurrencyIso\": \"<string>\",\n    \"CurrencyFactor\": 123\n  },\n  \"CustomerVatID\": \"<string>\",\n  \"SalesOrderDate\": \"2023-11-07T05:31:56Z\",\n  \"SalesOrderPaymentDetails\": {\n    \"PaymentMethodId\": 123,\n    \"CurrencyIso\": \"<string>\",\n    \"CurrencyFactor\": 123,\n    \"PaymentTarget\": 123,\n    \"CashDiscount\": 123,\n    \"CashDiscountDays\": 123\n  },\n  \"SalesOrderShippingDetail\": {\n    \"ShippingMethodId\": 123,\n    \"ShippingPriority\": 123,\n    \"ShippingDate\": \"2023-11-07T05:31:56Z\",\n    \"EstimatedDeliveryDate\": \"2023-11-07T05:31:56Z\",\n    \"OnHoldReasonId\": 123,\n    \"ExtraWeight\": 123\n  },\n  \"ColorcodeId\": 123,\n  \"Comment\": \"<string>\",\n  \"CustomerComment\": \"<string>\",\n  \"LanguageIso\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.jtl-cloud.com/erp/salesOrders")

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\": 123,\n  \"CustomerId\": 123,\n  \"Number\": \"<string>\",\n  \"ExternalNumber\": \"<string>\",\n  \"BillingNumber\": \"<string>\",\n  \"DepartureCountry\": {\n    \"CountryISO\": \"<string>\",\n    \"State\": \"<string>\",\n    \"CurrencyIso\": \"<string>\",\n    \"CurrencyFactor\": 123\n  },\n  \"CustomerVatID\": \"<string>\",\n  \"SalesOrderDate\": \"2023-11-07T05:31:56Z\",\n  \"SalesOrderPaymentDetails\": {\n    \"PaymentMethodId\": 123,\n    \"CurrencyIso\": \"<string>\",\n    \"CurrencyFactor\": 123,\n    \"PaymentTarget\": 123,\n    \"CashDiscount\": 123,\n    \"CashDiscountDays\": 123\n  },\n  \"SalesOrderShippingDetail\": {\n    \"ShippingMethodId\": 123,\n    \"ShippingPriority\": 123,\n    \"ShippingDate\": \"2023-11-07T05:31:56Z\",\n    \"EstimatedDeliveryDate\": \"2023-11-07T05:31:56Z\",\n    \"OnHoldReasonId\": 123,\n    \"ExtraWeight\": 123\n  },\n  \"ColorcodeId\": 123,\n  \"Comment\": \"<string>\",\n  \"CustomerComment\": \"<string>\",\n  \"LanguageIso\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "Id": 123,
  "Number": "<string>",
  "ExternalNumber": "<string>",
  "BillingNumber": "<string>",
  "CompanyId": 123,
  "DepartureCountry": {
    "CountryISO": "<string>",
    "State": "<string>",
    "CurrencyIso": "<string>",
    "CurrencyFactor": 123
  },
  "CustomerId": 123,
  "CustomerVatID": "<string>",
  "MerchantVatID": "<string>",
  "BillingAddress": {
    "Id": 123,
    "Company": "<string>",
    "Company2": "<string>",
    "FormOfAddress": "<string>",
    "Title": "<string>",
    "FirstName": "<string>",
    "LastName": "<string>",
    "Street": "<string>",
    "Address2": "<string>",
    "PostalCode": "<string>",
    "City": "<string>",
    "State": "<string>",
    "CountryIso": "<string>",
    "VatID": "<string>",
    "PhoneNumber": "<string>",
    "MobilePhoneNumber": "<string>",
    "EmailAddress": "<string>",
    "Fax": "<string>"
  },
  "Shipmentaddress": {
    "Id": 123,
    "Company": "<string>",
    "Company2": "<string>",
    "FormOfAddress": "<string>",
    "Title": "<string>",
    "FirstName": "<string>",
    "LastName": "<string>",
    "Street": "<string>",
    "Address2": "<string>",
    "PostalCode": "<string>",
    "City": "<string>",
    "State": "<string>",
    "CountryIso": "<string>",
    "VatID": "<string>",
    "PhoneNumber": "<string>",
    "MobilePhoneNumber": "<string>",
    "EmailAddress": "<string>",
    "Fax": "<string>"
  },
  "SalesOrderDate": "2023-11-07T05:31:56Z",
  "SalesOrderPaymentDetails": {
    "PaymentMethodId": 123,
    "TotalGrossAmount": 123,
    "CurrencyIso": "<string>",
    "CurrencyFactor": 123,
    "DateOfPayment": "2023-11-07T05:31:56Z",
    "StillToPay": 123,
    "PaymentTarget": 123,
    "CashDiscount": 123,
    "CashDiscountDays": 123
  },
  "SalesOrderShippingDetail": {
    "ShippingMethodId": 123,
    "ShippingPriority": 123,
    "ShippingDate": "2023-11-07T05:31:56Z",
    "EstimatedDeliveryDate": "2023-11-07T05:31:56Z",
    "DeliveredDate": "2023-11-07T05:31:56Z",
    "OnHoldReasonId": 123,
    "ExtraWeight": 123
  },
  "ColorcodeId": 123,
  "IsExternalInvoice": true,
  "Comment": "<string>",
  "CustomerComment": "<string>",
  "IsCancelled": true,
  "LanguageIso": "<string>",
  "CancellationDetails": {
    "CancellationReasonId": 123,
    "CancellationComment": "<string>",
    "Date": "2023-11-07T05:31:56Z"
  },
  "SalesChannelId": "<string>",
  "UserCreatedId": 123,
  "UserId": 123,
  "TransactionStatusId": 123
}

{
  "ErrorCode": "<string>",
  "ValidationErrors": {},
  "Errors": {},
  "ErrorMessage": "<string>",
  "Stacktrace": "<string>"
}

POST

salesOrders

Create Sales Order

curl --request POST \
  --url https://api.jtl-cloud.com/erp/salesOrders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-tenant-id: <x-tenant-id>' \
  --data '
{
  "CompanyId": 123,
  "CustomerId": 123,
  "Number": "<string>",
  "ExternalNumber": "<string>",
  "BillingNumber": "<string>",
  "DepartureCountry": {
    "CountryISO": "<string>",
    "State": "<string>",
    "CurrencyIso": "<string>",
    "CurrencyFactor": 123
  },
  "CustomerVatID": "<string>",
  "SalesOrderDate": "2023-11-07T05:31:56Z",
  "SalesOrderPaymentDetails": {
    "PaymentMethodId": 123,
    "CurrencyIso": "<string>",
    "CurrencyFactor": 123,
    "PaymentTarget": 123,
    "CashDiscount": 123,
    "CashDiscountDays": 123
  },
  "SalesOrderShippingDetail": {
    "ShippingMethodId": 123,
    "ShippingPriority": 123,
    "ShippingDate": "2023-11-07T05:31:56Z",
    "EstimatedDeliveryDate": "2023-11-07T05:31:56Z",
    "OnHoldReasonId": 123,
    "ExtraWeight": 123
  },
  "ColorcodeId": 123,
  "Comment": "<string>",
  "CustomerComment": "<string>",
  "LanguageIso": "<string>"
}
'

import requests

url = "https://api.jtl-cloud.com/erp/salesOrders"

payload = {
    "CompanyId": 123,
    "CustomerId": 123,
    "Number": "<string>",
    "ExternalNumber": "<string>",
    "BillingNumber": "<string>",
    "DepartureCountry": {
        "CountryISO": "<string>",
        "State": "<string>",
        "CurrencyIso": "<string>",
        "CurrencyFactor": 123
    },
    "CustomerVatID": "<string>",
    "SalesOrderDate": "2023-11-07T05:31:56Z",
    "SalesOrderPaymentDetails": {
        "PaymentMethodId": 123,
        "CurrencyIso": "<string>",
        "CurrencyFactor": 123,
        "PaymentTarget": 123,
        "CashDiscount": 123,
        "CashDiscountDays": 123
    },
    "SalesOrderShippingDetail": {
        "ShippingMethodId": 123,
        "ShippingPriority": 123,
        "ShippingDate": "2023-11-07T05:31:56Z",
        "EstimatedDeliveryDate": "2023-11-07T05:31:56Z",
        "OnHoldReasonId": 123,
        "ExtraWeight": 123
    },
    "ColorcodeId": 123,
    "Comment": "<string>",
    "CustomerComment": "<string>",
    "LanguageIso": "<string>"
}
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: 123,
    CustomerId: 123,
    Number: '<string>',
    ExternalNumber: '<string>',
    BillingNumber: '<string>',
    DepartureCountry: {
      CountryISO: '<string>',
      State: '<string>',
      CurrencyIso: '<string>',
      CurrencyFactor: 123
    },
    CustomerVatID: '<string>',
    SalesOrderDate: '2023-11-07T05:31:56Z',
    SalesOrderPaymentDetails: {
      PaymentMethodId: 123,
      CurrencyIso: '<string>',
      CurrencyFactor: 123,
      PaymentTarget: 123,
      CashDiscount: 123,
      CashDiscountDays: 123
    },
    SalesOrderShippingDetail: {
      ShippingMethodId: 123,
      ShippingPriority: 123,
      ShippingDate: '2023-11-07T05:31:56Z',
      EstimatedDeliveryDate: '2023-11-07T05:31:56Z',
      OnHoldReasonId: 123,
      ExtraWeight: 123
    },
    ColorcodeId: 123,
    Comment: '<string>',
    CustomerComment: '<string>',
    LanguageIso: '<string>'
  })
};

fetch('https://api.jtl-cloud.com/erp/salesOrders', 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/salesOrders",
  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' => 123,
    'CustomerId' => 123,
    'Number' => '<string>',
    'ExternalNumber' => '<string>',
    'BillingNumber' => '<string>',
    'DepartureCountry' => [
        'CountryISO' => '<string>',
        'State' => '<string>',
        'CurrencyIso' => '<string>',
        'CurrencyFactor' => 123
    ],
    'CustomerVatID' => '<string>',
    'SalesOrderDate' => '2023-11-07T05:31:56Z',
    'SalesOrderPaymentDetails' => [
        'PaymentMethodId' => 123,
        'CurrencyIso' => '<string>',
        'CurrencyFactor' => 123,
        'PaymentTarget' => 123,
        'CashDiscount' => 123,
        'CashDiscountDays' => 123
    ],
    'SalesOrderShippingDetail' => [
        'ShippingMethodId' => 123,
        'ShippingPriority' => 123,
        'ShippingDate' => '2023-11-07T05:31:56Z',
        'EstimatedDeliveryDate' => '2023-11-07T05:31:56Z',
        'OnHoldReasonId' => 123,
        'ExtraWeight' => 123
    ],
    'ColorcodeId' => 123,
    'Comment' => '<string>',
    'CustomerComment' => '<string>',
    'LanguageIso' => '<string>'
  ]),
  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/salesOrders"

	payload := strings.NewReader("{\n  \"CompanyId\": 123,\n  \"CustomerId\": 123,\n  \"Number\": \"<string>\",\n  \"ExternalNumber\": \"<string>\",\n  \"BillingNumber\": \"<string>\",\n  \"DepartureCountry\": {\n    \"CountryISO\": \"<string>\",\n    \"State\": \"<string>\",\n    \"CurrencyIso\": \"<string>\",\n    \"CurrencyFactor\": 123\n  },\n  \"CustomerVatID\": \"<string>\",\n  \"SalesOrderDate\": \"2023-11-07T05:31:56Z\",\n  \"SalesOrderPaymentDetails\": {\n    \"PaymentMethodId\": 123,\n    \"CurrencyIso\": \"<string>\",\n    \"CurrencyFactor\": 123,\n    \"PaymentTarget\": 123,\n    \"CashDiscount\": 123,\n    \"CashDiscountDays\": 123\n  },\n  \"SalesOrderShippingDetail\": {\n    \"ShippingMethodId\": 123,\n    \"ShippingPriority\": 123,\n    \"ShippingDate\": \"2023-11-07T05:31:56Z\",\n    \"EstimatedDeliveryDate\": \"2023-11-07T05:31:56Z\",\n    \"OnHoldReasonId\": 123,\n    \"ExtraWeight\": 123\n  },\n  \"ColorcodeId\": 123,\n  \"Comment\": \"<string>\",\n  \"CustomerComment\": \"<string>\",\n  \"LanguageIso\": \"<string>\"\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/salesOrders")
  .header("x-tenant-id", "<x-tenant-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"CompanyId\": 123,\n  \"CustomerId\": 123,\n  \"Number\": \"<string>\",\n  \"ExternalNumber\": \"<string>\",\n  \"BillingNumber\": \"<string>\",\n  \"DepartureCountry\": {\n    \"CountryISO\": \"<string>\",\n    \"State\": \"<string>\",\n    \"CurrencyIso\": \"<string>\",\n    \"CurrencyFactor\": 123\n  },\n  \"CustomerVatID\": \"<string>\",\n  \"SalesOrderDate\": \"2023-11-07T05:31:56Z\",\n  \"SalesOrderPaymentDetails\": {\n    \"PaymentMethodId\": 123,\n    \"CurrencyIso\": \"<string>\",\n    \"CurrencyFactor\": 123,\n    \"PaymentTarget\": 123,\n    \"CashDiscount\": 123,\n    \"CashDiscountDays\": 123\n  },\n  \"SalesOrderShippingDetail\": {\n    \"ShippingMethodId\": 123,\n    \"ShippingPriority\": 123,\n    \"ShippingDate\": \"2023-11-07T05:31:56Z\",\n    \"EstimatedDeliveryDate\": \"2023-11-07T05:31:56Z\",\n    \"OnHoldReasonId\": 123,\n    \"ExtraWeight\": 123\n  },\n  \"ColorcodeId\": 123,\n  \"Comment\": \"<string>\",\n  \"CustomerComment\": \"<string>\",\n  \"LanguageIso\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.jtl-cloud.com/erp/salesOrders")

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\": 123,\n  \"CustomerId\": 123,\n  \"Number\": \"<string>\",\n  \"ExternalNumber\": \"<string>\",\n  \"BillingNumber\": \"<string>\",\n  \"DepartureCountry\": {\n    \"CountryISO\": \"<string>\",\n    \"State\": \"<string>\",\n    \"CurrencyIso\": \"<string>\",\n    \"CurrencyFactor\": 123\n  },\n  \"CustomerVatID\": \"<string>\",\n  \"SalesOrderDate\": \"2023-11-07T05:31:56Z\",\n  \"SalesOrderPaymentDetails\": {\n    \"PaymentMethodId\": 123,\n    \"CurrencyIso\": \"<string>\",\n    \"CurrencyFactor\": 123,\n    \"PaymentTarget\": 123,\n    \"CashDiscount\": 123,\n    \"CashDiscountDays\": 123\n  },\n  \"SalesOrderShippingDetail\": {\n    \"ShippingMethodId\": 123,\n    \"ShippingPriority\": 123,\n    \"ShippingDate\": \"2023-11-07T05:31:56Z\",\n    \"EstimatedDeliveryDate\": \"2023-11-07T05:31:56Z\",\n    \"OnHoldReasonId\": 123,\n    \"ExtraWeight\": 123\n  },\n  \"ColorcodeId\": 123,\n  \"Comment\": \"<string>\",\n  \"CustomerComment\": \"<string>\",\n  \"LanguageIso\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "Id": 123,
  "Number": "<string>",
  "ExternalNumber": "<string>",
  "BillingNumber": "<string>",
  "CompanyId": 123,
  "DepartureCountry": {
    "CountryISO": "<string>",
    "State": "<string>",
    "CurrencyIso": "<string>",
    "CurrencyFactor": 123
  },
  "CustomerId": 123,
  "CustomerVatID": "<string>",
  "MerchantVatID": "<string>",
  "BillingAddress": {
    "Id": 123,
    "Company": "<string>",
    "Company2": "<string>",
    "FormOfAddress": "<string>",
    "Title": "<string>",
    "FirstName": "<string>",
    "LastName": "<string>",
    "Street": "<string>",
    "Address2": "<string>",
    "PostalCode": "<string>",
    "City": "<string>",
    "State": "<string>",
    "CountryIso": "<string>",
    "VatID": "<string>",
    "PhoneNumber": "<string>",
    "MobilePhoneNumber": "<string>",
    "EmailAddress": "<string>",
    "Fax": "<string>"
  },
  "Shipmentaddress": {
    "Id": 123,
    "Company": "<string>",
    "Company2": "<string>",
    "FormOfAddress": "<string>",
    "Title": "<string>",
    "FirstName": "<string>",
    "LastName": "<string>",
    "Street": "<string>",
    "Address2": "<string>",
    "PostalCode": "<string>",
    "City": "<string>",
    "State": "<string>",
    "CountryIso": "<string>",
    "VatID": "<string>",
    "PhoneNumber": "<string>",
    "MobilePhoneNumber": "<string>",
    "EmailAddress": "<string>",
    "Fax": "<string>"
  },
  "SalesOrderDate": "2023-11-07T05:31:56Z",
  "SalesOrderPaymentDetails": {
    "PaymentMethodId": 123,
    "TotalGrossAmount": 123,
    "CurrencyIso": "<string>",
    "CurrencyFactor": 123,
    "DateOfPayment": "2023-11-07T05:31:56Z",
    "StillToPay": 123,
    "PaymentTarget": 123,
    "CashDiscount": 123,
    "CashDiscountDays": 123
  },
  "SalesOrderShippingDetail": {
    "ShippingMethodId": 123,
    "ShippingPriority": 123,
    "ShippingDate": "2023-11-07T05:31:56Z",
    "EstimatedDeliveryDate": "2023-11-07T05:31:56Z",
    "DeliveredDate": "2023-11-07T05:31:56Z",
    "OnHoldReasonId": 123,
    "ExtraWeight": 123
  },
  "ColorcodeId": 123,
  "IsExternalInvoice": true,
  "Comment": "<string>",
  "CustomerComment": "<string>",
  "IsCancelled": true,
  "LanguageIso": "<string>",
  "CancellationDetails": {
    "CancellationReasonId": 123,
    "CancellationComment": "<string>",
    "Date": "2023-11-07T05:31:56Z"
  },
  "SalesChannelId": "<string>",
  "UserCreatedId": 123,
  "UserId": 123,
  "TransactionStatusId": 123
}

{
  "ErrorCode": "<string>",
  "ValidationErrors": {},
  "Errors": {},
  "ErrorMessage": "<string>",
  "Stacktrace": "<string>"
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

x-companyid

string

The Company-Id (int or uuid) of the company on whose behalf the request is executed.

x-tenant-id

string<uuid>

required

The tenant ID for the target ERP instance.

Query Parameters

renameSalesOrderNumberWhenAlreadyExists

boolean

If true, the sales order number will be renamed if it already exists.

disableAutomaticWorkflows

boolean

If true, the workflows do not trigger automatic.

Body

application/json

The sales order to create.

Model Class: CreateSalesOrder

CompanyId

integer<int32>

required

The company of the sales order.

CustomerId

integer<int32>

required

The customer ID.

Number

string

The number of the sales order.

ExternalNumber

string

The external number of the sales order.

BillingNumber

string

The number of the invoice.

DepartureCountry

object

The departure country information of the sales order. If none is indicated, it will be determined from the company's information.

Show child attributes

CustomerVatID

string

The VAT ID of the customer.

BillingAddress

object

The billing address of the sales order.

Show child attributes

Shipmentaddress

object

The shipping address of the sales order.

Show child attributes

SalesOrderDate

string<date-time>

The date when the order was created.

SalesOrderPaymentDetails

object

Payment specific information of the sales order.

Show child attributes

SalesOrderShippingDetail

object

Shipping specific information of the sales order.

Show child attributes

ColorcodeId

integer<int32>

The colour code of the sales order.

Comment

string

A comment on the sales order.

CustomerComment

string

A customer comment on the sales order.

LanguageIso

string

The language of the order.

Response

The created sales order.

Model Class: SalesOrder

integer<int32>

required

Unique ID to identify a sales order file.

Number

string

required

The number of the sales order.

ExternalNumber

string

required

The external number of the sales order.

BillingNumber

string

required

The number of the invoice.

CompanyId

integer<int32>

required

The company of the sales order.

DepartureCountry

object

required

The departure country information of the sales order. If none is indicated, it will be determined from the company's information.

Show child attributes

CustomerId

integer<int32>

required

The customer ID.

CustomerVatID

string

required

The VAT ID of the customer.

MerchantVatID

string

required

The VAT ID of the merchant.

BillingAddress

object

required

The billing address of the sales order.

Show child attributes

Shipmentaddress

object

required

The shipping address of the sales order.

Show child attributes

SalesOrderDate

string<date-time>

required

The date when the order was created.

SalesOrderPaymentDetails

object

required

Payment specific information of the sales order.

Show child attributes

SalesOrderShippingDetail

object

required

Shipping specific information of the sales order.

Show child attributes

ColorcodeId

integer<int32>

required

The colour code of the sales order.

IsExternalInvoice

boolean

required

Indicates if the invoice of the order was created in an external system, like Amazon VCS.

Comment

string

required

A comment on the sales order.

CustomerComment

string

required

A customer comment on the sales order.

IsCancelled

boolean

required

Indicates if the order has been cancelled. There is a special endpoint for cancelling sales orders.

LanguageIso

string

required

The language of the order.

CancellationDetails

object

required

The cancellation details in case the sales order has been cancelled.

Show child attributes

SalesChannelId

string

required

The sales channel of the sales order.

UserCreatedId

integer<int32>

required

The user who created the sales order.

UserId

integer<int32>

required

The user who is responsible for the sales order.

TransactionStatusId

integer<int32>

required

Unique ID to identify a transaction's status.

Query Sales Orders Get Sales Order

⌘I

Overview

REST API

Authorizations

Headers

Query Parameters

Body

Response