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. |