Retrieves a single sales order by its ID.

curl --request GET \
  --url https://api.jtl-cloud.com/erp/v2/sales-orders/{salesOrderId} \
  --header 'Authorization: Bearer <token>' \
  --header 'x-tenant-id: <x-tenant-id>'

import requests

url = "https://api.jtl-cloud.com/erp/v2/sales-orders/{salesOrderId}"

headers = {
    "x-tenant-id": "<x-tenant-id>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-tenant-id': '<x-tenant-id>', Authorization: 'Bearer <token>'}
};

fetch('https://api.jtl-cloud.com/erp/v2/sales-orders/{salesOrderId}', 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-orders/{salesOrderId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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"
	"net/http"
	"io"
)

func main() {

	url := "https://api.jtl-cloud.com/erp/v2/sales-orders/{salesOrderId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-tenant-id", "<x-tenant-id>")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.jtl-cloud.com/erp/v2/sales-orders/{salesOrderId}")
  .header("x-tenant-id", "<x-tenant-id>")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.jtl-cloud.com/erp/v2/sales-orders/{salesOrderId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-tenant-id"] = '<x-tenant-id>'
request["Authorization"] = 'Bearer <token>'

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

{
  "id": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "isCancelled": true,
  "isPending": true,
  "salesOrderStatus": 123,
  "salesOrderNumber": "<string>",
  "departureCountry": {
    "currencyFactor": 123,
    "countryIso": "<string>",
    "currencyIso": "<string>",
    "state": "<string>"
  },
  "externalDetails": {
    "externalCreatedDate": "2023-11-07T05:31:56Z",
    "externalSalesOrderNumber": "<string>"
  },
  "paymentDetails": {
    "cashDiscount": 123,
    "cashDiscountDays": 123,
    "financingCosts": 123,
    "paymentDueDateInDays": 123,
    "currencyFactor": 123,
    "currencyIso": "<string>"
  },
  "shippingDetails": {
    "extraWeight": 123,
    "maxDeliveryDays": 123,
    "shippingPriority": 123,
    "deliveryFromDate": "2023-11-07T05:31:56Z",
    "estimatedDeliveryDate": "2023-11-07T05:31:56Z",
    "shippingDate": "2023-11-07T05:31:56Z"
  },
  "taxDetails": {},
  "customerId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "paymentInfo": {
    "paymentInfoType": 123,
    "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>"
  },
  "text": {
    "comment": "<string>",
    "customerComment": "<string>",
    "printText": "<string>",
    "processStatus": "<string>"
  },
  "salesOrderDate": "2023-11-07T05:31:56Z",
  "processColourId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "onHoldReasonId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "cartonItemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "paymentMethodId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "shippingMethodId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "processStatusId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "languageIso": "<string>",
  "customerSalesOrderNumber": "<string>",
  "vatId": "<string>",
  "companyId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "shipmentAddress": {
    "salesOrderId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
    "customerId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
    "salutation": "<string>",
    "title": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "company": "<string>",
    "additionalCompanyLine": "<string>",
    "street": "<string>",
    "additionalAddressLine": "<string>",
    "city": "<string>",
    "postalCode": "<string>",
    "state": "<string>",
    "countryIso": "<string>",
    "postId": "<string>",
    "emailAddress": "<string>",
    "phoneNumber": "<string>",
    "mobilePhoneNumber": "<string>",
    "fax": "<string>",
    "country": "<string>",
    "customsDocumentsRequired": true,
    "vatId": "<string>"
  },
  "billingAddress": {
    "salesOrderId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
    "customerId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
    "salutation": "<string>",
    "title": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "company": "<string>",
    "additionalCompanyLine": "<string>",
    "street": "<string>",
    "additionalAddressLine": "<string>",
    "city": "<string>",
    "postalCode": "<string>",
    "state": "<string>",
    "countryIso": "<string>",
    "postId": "<string>",
    "emailAddress": "<string>",
    "phoneNumber": "<string>",
    "mobilePhoneNumber": "<string>",
    "fax": "<string>",
    "country": "<string>",
    "customsDocumentsRequired": true,
    "vatId": "<string>"
  },
  "lineItems": [
    {
      "id": "b45f6432-2462-4c6f-b00f-1d9d01000000",
      "salesOrderId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
      "isReserved": true,
      "quantity": 123,
      "salesPriceNet": 123,
      "discountPercent": 123,
      "purchasePriceNet": 123,
      "taxRate": 123,
      "totalSalesPriceNet": 123,
      "totalSalesPriceGross": 123,
      "sortOrder": 123,
      "hasUpload": true,
      "itemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
      "sku": "<string>",
      "name": "<string>",
      "fnSku": "<string>",
      "salesUnit": "<string>",
      "taxClassId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
      "taxCodeId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
      "note": "<string>",
      "standardName": "<string>",
      "parentSalesOrderLineItemId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
    }
  ],
  "keyFigures": {
    "salesOrderId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
    "alreadyPaidAmount": 123,
    "creditsTotalGrossAmount": 123,
    "invoicesTotalGrossAmount": 123,
    "invoicesTotalNetAmount": 123,
    "isCashOnDelivery": true,
    "isFullyReturned": true,
    "isLockedForDelivery": true,
    "packageCount": 123,
    "shippedPackageCount": 123,
    "stillToPay": 123,
    "stillToPayWithoutCancellation": 123,
    "totalGrossAmount": 123,
    "totalNetAmount": 123,
    "dateOfPayment": "2023-11-07T05:31:56Z",
    "emailedDate": "2023-11-07T05:31:56Z",
    "invoiceNumbers": "<string>",
    "lastShippingDate": "2023-11-07T05:31:56Z",
    "paymentMailDate": "2023-11-07T05:31:56Z",
    "printedDate": "2023-11-07T05:31:56Z",
    "shippingMailDate": "2023-11-07T05:31:56Z"
  }
}

GET

sales-orders

{salesOrderId}

Retrieves a single sales order by its ID.

curl --request GET \
  --url https://api.jtl-cloud.com/erp/v2/sales-orders/{salesOrderId} \
  --header 'Authorization: Bearer <token>' \
  --header 'x-tenant-id: <x-tenant-id>'

import requests

url = "https://api.jtl-cloud.com/erp/v2/sales-orders/{salesOrderId}"

headers = {
    "x-tenant-id": "<x-tenant-id>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-tenant-id': '<x-tenant-id>', Authorization: 'Bearer <token>'}
};

fetch('https://api.jtl-cloud.com/erp/v2/sales-orders/{salesOrderId}', 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-orders/{salesOrderId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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"
	"net/http"
	"io"
)

func main() {

	url := "https://api.jtl-cloud.com/erp/v2/sales-orders/{salesOrderId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-tenant-id", "<x-tenant-id>")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.jtl-cloud.com/erp/v2/sales-orders/{salesOrderId}")
  .header("x-tenant-id", "<x-tenant-id>")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.jtl-cloud.com/erp/v2/sales-orders/{salesOrderId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-tenant-id"] = '<x-tenant-id>'
request["Authorization"] = 'Bearer <token>'

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

{
  "id": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "isCancelled": true,
  "isPending": true,
  "salesOrderStatus": 123,
  "salesOrderNumber": "<string>",
  "departureCountry": {
    "currencyFactor": 123,
    "countryIso": "<string>",
    "currencyIso": "<string>",
    "state": "<string>"
  },
  "externalDetails": {
    "externalCreatedDate": "2023-11-07T05:31:56Z",
    "externalSalesOrderNumber": "<string>"
  },
  "paymentDetails": {
    "cashDiscount": 123,
    "cashDiscountDays": 123,
    "financingCosts": 123,
    "paymentDueDateInDays": 123,
    "currencyFactor": 123,
    "currencyIso": "<string>"
  },
  "shippingDetails": {
    "extraWeight": 123,
    "maxDeliveryDays": 123,
    "shippingPriority": 123,
    "deliveryFromDate": "2023-11-07T05:31:56Z",
    "estimatedDeliveryDate": "2023-11-07T05:31:56Z",
    "shippingDate": "2023-11-07T05:31:56Z"
  },
  "taxDetails": {},
  "customerId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "paymentInfo": {
    "paymentInfoType": 123,
    "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>"
  },
  "text": {
    "comment": "<string>",
    "customerComment": "<string>",
    "printText": "<string>",
    "processStatus": "<string>"
  },
  "salesOrderDate": "2023-11-07T05:31:56Z",
  "processColourId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "onHoldReasonId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "cartonItemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "paymentMethodId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "shippingMethodId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "processStatusId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "languageIso": "<string>",
  "customerSalesOrderNumber": "<string>",
  "vatId": "<string>",
  "companyId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "shipmentAddress": {
    "salesOrderId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
    "customerId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
    "salutation": "<string>",
    "title": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "company": "<string>",
    "additionalCompanyLine": "<string>",
    "street": "<string>",
    "additionalAddressLine": "<string>",
    "city": "<string>",
    "postalCode": "<string>",
    "state": "<string>",
    "countryIso": "<string>",
    "postId": "<string>",
    "emailAddress": "<string>",
    "phoneNumber": "<string>",
    "mobilePhoneNumber": "<string>",
    "fax": "<string>",
    "country": "<string>",
    "customsDocumentsRequired": true,
    "vatId": "<string>"
  },
  "billingAddress": {
    "salesOrderId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
    "customerId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
    "salutation": "<string>",
    "title": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "company": "<string>",
    "additionalCompanyLine": "<string>",
    "street": "<string>",
    "additionalAddressLine": "<string>",
    "city": "<string>",
    "postalCode": "<string>",
    "state": "<string>",
    "countryIso": "<string>",
    "postId": "<string>",
    "emailAddress": "<string>",
    "phoneNumber": "<string>",
    "mobilePhoneNumber": "<string>",
    "fax": "<string>",
    "country": "<string>",
    "customsDocumentsRequired": true,
    "vatId": "<string>"
  },
  "lineItems": [
    {
      "id": "b45f6432-2462-4c6f-b00f-1d9d01000000",
      "salesOrderId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
      "isReserved": true,
      "quantity": 123,
      "salesPriceNet": 123,
      "discountPercent": 123,
      "purchasePriceNet": 123,
      "taxRate": 123,
      "totalSalesPriceNet": 123,
      "totalSalesPriceGross": 123,
      "sortOrder": 123,
      "hasUpload": true,
      "itemId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
      "sku": "<string>",
      "name": "<string>",
      "fnSku": "<string>",
      "salesUnit": "<string>",
      "taxClassId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
      "taxCodeId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
      "note": "<string>",
      "standardName": "<string>",
      "parentSalesOrderLineItemId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
    }
  ],
  "keyFigures": {
    "salesOrderId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
    "alreadyPaidAmount": 123,
    "creditsTotalGrossAmount": 123,
    "invoicesTotalGrossAmount": 123,
    "invoicesTotalNetAmount": 123,
    "isCashOnDelivery": true,
    "isFullyReturned": true,
    "isLockedForDelivery": true,
    "packageCount": 123,
    "shippedPackageCount": 123,
    "stillToPay": 123,
    "stillToPayWithoutCancellation": 123,
    "totalGrossAmount": 123,
    "totalNetAmount": 123,
    "dateOfPayment": "2023-11-07T05:31:56Z",
    "emailedDate": "2023-11-07T05:31:56Z",
    "invoiceNumbers": "<string>",
    "lastShippingDate": "2023-11-07T05:31:56Z",
    "paymentMailDate": "2023-11-07T05:31:56Z",
    "printedDate": "2023-11-07T05:31:56Z",
    "shippingMailDate": "2023-11-07T05:31:56Z"
  }
}

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.

Path Parameters

salesOrderId

string<uuid>

required

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

Response

A single sales order.

string<uuid>

required

Unique ID to identify a sales order.

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

isCancelled

boolean

required

Indicates if the order has been cancelled.

isPending

boolean

required

The SalesOrder IsPending

itemDescriptionType

enum<integer>

required

The SalesOrder ItemDescriptionType

Available options:

0,

1,

2

readOnlyType

enum<integer>

required

The SalesOrder ReadOnlyType

Available options:

0,

1,

2

salesOrderStatus

integer<int32>

required

The SalesOrder SalesOrderStatus

salesOrderNumber

string

required

The SalesOrder SalesOrderNumber

departureCountry

object

required

DepartureCountry

Show child attributes

externalDetails

object

required

ExternalDetails

Show child attributes

paymentDetails

object

required

PaymentDetails

Show child attributes

shippingDetails

object

required

ShippingDetails

Show child attributes

taxDetails

object

required

TaxDetails

Show child attributes

customerId

string<uuid>

Customer this SalesOrder belongs to.

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

paymentInfo

object

SalesOrderPaymentInfo

Show child attributes

text

object

SalesOrderText

Show child attributes

salesOrderDate

string<date-time>

The SalesOrder Date

processColourId

string<uuid>

The SalesOrder Process colour id

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

onHoldReasonId

string<uuid>

The SalesOrder OnHold reason id

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

cartonItemId

string<uuid>

The SalesOrder Carton item id

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

paymentMethodId

string<uuid>

The SalesOrder Payment method id

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

shippingMethodId

string<uuid>

The SalesOrder Shipping method id

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

processStatusId

string<uuid>

The SalesOrder Process status id

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

languageIso

string

The SalesOrder Language iso code

customerSalesOrderNumber

string

The SalesOrder Customer sales order number

vatId

string

The SalesOrder Vat Id

companyId

string<uuid>

The SalesOrder Company Id

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

shipmentAddress

object

SalesOrderShipmentAddress

Show child attributes

billingAddress

object

SalesOrderBillingAddress

Show child attributes

lineItems

object[]

List of SalesOrderLineItem

Show child attributes

keyFigures

object

Key figures of the sales order.

Show child attributes

Creates a new sales order.Modifies an existing sales order.

⌘I

Overview

GraphQL

REST API

Retrieves a single sales order by its ID.

Authorizations

Headers

Path Parameters

Response