Skip to main content
PUT
/
v1
/
channel
/
order
/
status
Status Update
curl --request PUT \
  --url https://scx-sbx.api.jtl-software.com/v1/channel/order/status \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "orderList": [
    {
      "sellerId": "4711",
      "orderId": "43523-43432-43532",
      "orderStatus": "UNACKED",
      "orderItems": [
        {
          "orderItemId": "5437233",
          "itemStatus": "UNSHIPPED",
          "paymentStatus": "PENDING",
          "shipFromCountry": "DEU"
        }
      ]
    }
  ]
}
'
{
  "errorList": [
    {
      "code": "CHN401",
      "message": "Not all orders could be processed. 9 out of 10 orders were stored successfully",
      "severity": "warning",
      "hint": null
    }
  ]
}

Authorizations

​
Authorization
string
header
required

As a Channel Integrator you will receive a API Refresh Token. With such a Refresh Token you need to request an Access Token with a limited Lifetime (see POST /v1/auth). This Access Token must be provided as a Bearer Token in the Authorization Header with every request.

Body

application/json

List of order status changes (e.g. payment received, shipped) reported by the marketplace.

​
orderList
object[]
required
Required array length: 1 - 1000 elements

Response

Call was overall successful but some items can be faulty

​
errorList
Error · object[] | null
Example:
[
  {
    "code": "GEN700",
    "message": "Seller SELLER_4711 does not exist on channel kaufland.",
    "severity": "error",
    "hint": "i9n-order22"
  }
]