Skip to main content
Skip table of contents

Order Status API v2.2

This version of the Order Status Update API has now been deprecated in favour of version 2.3. This documentation will remain here for information purposes only, while users migrate to the 2.3 API.

Users who haven’t yet implemented the order status API should use version 2.3 and users that are currently using version 2.2 should consider migrating to version 2.3.

KornitX has developed an order status API to allow the order status of each order to be updated.

The following are examples of the API calls required to set the status of orders received from our platform via API:

There are two standard status options supported; dispatch and cancel, depending on whether an order can be fulfilled or not. To dispatch an order using the API, the following call should be executed:

Dispatch:

To indicate that an order is fulfilled, the following call should be executed:

 

curl -X PUT -d '{ "status": 8 }' -H "authorization: basic REFID:APIKEY" -H "content-type: application/json" "https://api-sl-2-2.custom-gateway.net/order/:id/status"

This also supports submitting tracking numbers example belowcurl -X PUT -d '{ "status": 8, "shipping_tracking": "ABC"}' -H "authorization: basic REFID:APIKEY -H "content-type: application/json" "https://api-sl-2-2.custom-gateway.net/order/:id/status",

Cancel:

To cancel an order, where it cannot be fulfilled, the following call should be executed:

 

curl -X PUT -d '{ "status": 128 }' -H "authorization: basic REFID:APIKEY" -H "content-type: application/json" "https://api-sl-2-2.custom-gateway.net/order/:id/status"

 

In each case, :id is our the order ID we will pass when sending orders.

Please note that Sales Channel companies can also Cancel Orders, this was a recent update to the Order Status API.

Other supported order status codes: 

The following status codes are also supported by the API:

Generally your status callback would not need to handle all possible order statuses.

Status Code

Status Name

Description

8

Dispatched

The order has been fully dispatched.

32

QC Query

The order has a QC query against it.

64

Dispatched (Retailer Notified)

Dispatch confirmation has been explicitly pushed to the retailer by Custom Gateway.

128

Cancelled

The order has been cancelled.

256

On Hold

The order is on hold.

512

Sent to Supplier

The order has been routed to an appropriate supplier.

513

Received by Supplier

The order has been confirmed as received by an appropriate supplier.

515

Sent to Shipper

The order details have been sent to a shipment courier (such as UPS or DPD).

516

Received by Shipper

The order details have been confirmed by a shipment courier.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.