Order Status API

Order Status API

Custom Gateway 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 OMS 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:
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 below
curl -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",

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.

  • † denotes a status that you should handle at a minimum.

Status Code

Status Name




The order has been fully dispatched.


QC Query

The order has a QC query against it.


Dispatched (Retailer Notified)

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



The order has been cancelled.


On Hold

The order is on hold.


Sent to Supplier

The order has been routed to an appropriate supplier.


Received by Supplier

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


Sent to Shipper

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


Received by Shipper

The order details have been confirmed by a shipment courier.

    • Related Articles

    • Production Job Status Overview

      Detailed below is an overview of the production job status options and how they are set   Status  How Set  Filling All jobs are allocated to a batch or routing template which can have a capacity set before they are released to the shop floor. Jobs ...
    • Standard Order Details Export API

      Kornit X have an API which can be called to gather order details from the OMS in JSON format. This function is available to users who have an Order Manager subscription or higher and is not available to OMS lite or free users. To utilise this you ...
    • Order Status' in OMS Reports

      When generating OMS reports, you may come across a column titled "Statuses" This column gives the value associated with a specific status shown on an order in OMS. You can find the corresponding status name and description below:  Status Code Status ...
    • Automated Order Status Notification Reports

      You can set up the following reports to automatically send to a nominated email address for each Company or GUID - to help you keep track of orders These are set up to run automatically in the Companies section of the OMS and can also be run manually ...
    • Order Manager | Returns

      Introduction Returns is a part of the Kornit X Sales module, allowing for customers to request a return which can then be managed and returned to a return bin on individual orders. Once an item has been returned a Return Shipping Label will be ...