1. Status change flow#
2. Status define#
Every table below lists the exact values the API returns. The Status name column is the exact string the API returns in status_name / status_display — match on this column when you compare by string.
2.1. Order#
2.1.1 Order status#
| Status ID | Status name | Description |
|---|
| 200 | New | New order generated and waiting approval to process |
| 250 | Awaiting confirmation | |
| 300 | Approved | Waiting to create shipment (DO) |
| 360 | Exception - Ready to Ship | Order direct RTS on sale channel |
| 370 | Cancellation Requested | Order received cancellation request |
| 380 | Label Generation Errors | Label generate issue |
| 400 | Processing | Order in pick & pack process |
| 460 | Ready to ship | Order packed successfully |
| 500 | Shipped | Order dispatched to courier |
| 600 | In-transit | The package is traveling on the main transport network (by air, sea, or land) |
| 650 | Returning | The delivery failed (e.g., incorrect address, customer rejected, or multiple missed delivery attempts), and the courier is shipping it backward through the network. |
| 702 | Cancelled | Final status |
| 800 | Returned | Final status |
| 850 | Courier lost items | Parcel lost by courier. Final status |
| 890 | Partially Completed | |
| 900 | Completed | Final status |
2.1.2 Order type#
| Order type | Order type name | Description |
|---|
| normal | Normal Order | |
| pre_order | Pre-order | |
| dropship | Dropship | |
| pod | POD | |
| sample | Sample | |
2.2 Payment#
2.2.1 Payment status#
| Status ID | Status name | Description |
|---|
| 100 | Unpaid | |
| 110 | Payment processing | |
| 120 | Payment pending | |
| 150 | Partially paid | |
| 200 | Paid | |
| 300 | Refunded | |
| 310 | Partial refunded | |
| 500 | Voided | |
| 550 | Cancelled COD | |
| 600 | Overdue | |
2.2.2 Payment type#
| Payment type ID | Payment type name | Description |
|---|
| 1 | Cash on Delivery | |
| 2 | Bank Transfer | |
| 3 | Visa/Master/Amex | |
| 4 | Cash | |
| 5 | Internet banking | |
| 6 | QR CODE | |
| 7 | Online Banking | |
| 8 | Installment payment | |
| 9 | Store Credit | |
| 10 | Gift Away | |
| 11 | Debt | |
| 12 | eWallet | |
2.3. Shipment Status (delivery order)#
| Status ID | Status name | Description |
|---|
| 100 | New | |
| 101 | Label generated | |
| 102 | Awaiting label | |
| 120 | Courier allocation | |
| 150 | Out of stock | |
| 200 | Awaiting Process | |
| 201 | Failed Pickup | |
| 205 | Unfulfilled | Can not confirm order to process |
| 211 | On-hold at warehouse | |
| 213 | Received at warehouse | |
| 215 | In-processing | |
| 216 | Inspection at warehouse | |
| 220 | Ready to ship | |
| 225 | Assigning a driver | |
| 230 | Assigned driver | |
| 250 | Driver refuse parcel | |
| 260 | Courier refuse pick up | |
| 265 | Failed/Incomplete Pickups | |
| 300 | Shipped | |
| 305 | Original tracking generated | |
| 310 | In-transit | |
| 315 | Failed Delivery Attempt | |
| 317 | Courier lost items | |
| 320 | Awaiting Redelivery | |
| 350 | Out For Delivery | |
| 400 | Cancellation Requested | |
| 500 | Awating to return | |
| 501 | Return accepted | |
| 510 | In-transit for Return | |
| 520 | Failed Return Attempt | |
| 600 | Returned | |
| 700 | Cancelled by seller | |
| 701 | Cancelled by operator | |
| 702 | Cancelled by partner | |
| 703 | Cancelled by system | |
| 704 | Cancelled by warehouse | |
| 708 | Cancelled by lost items 3pf | |
| 777 | Exceptions | |
| 800 | Delivered | |
2.4. Return Order#
2.4.1 Return Order Status#
| Status ID | Status name | Description |
|---|
| 100 | Requested | |
| 110 | Judging | |
| 150 | Accepted | |
| 200 | Seller dispute | |
| 300 | Processing | |
| 700 | Cancelled | |
| 800 | Returned | |
2.4.2 Return Reason Type#
| Reason Type | Value returned in fail_reason_type |
|---|
broken_products | Broken products |
change_mind | Change mind |
damaged_others | Damaged others |
damaged_package | Damaged package |
date_deviation | Date deviation |
different_description | Different description |
expectation_failed | Expectation failed |
expired_product | Expired product |
functional_dmg | Functional DMG |
item_damaged | Item damaged |
item_fake | Item fake |
item_missing | Item missing |
item_not_fit | Item not fit |
look_deviation | Look deviation |
mutual_agree | Mutual agree |
not_receipt | Not receipt |
no_reason | No reason |
other | Other |
physical_dmg | Physical DMG |
scratched | Scratched |
seller_sent_wrong_item | Seller sent wrong item |
size_deviation | Size deviation |
spilled_contents | Spilled contents |
suspicious_parcel | Suspicious parcel |
used | Used |
warranty | Warranty |
wrong_address | Wrong address |
wrong_item | Wrong item |
wrong_order_info | Wrong order info |
2.5. Catalogue Status#
| Status Code | Status name | Description |
|---|
| active | Active | |
| inactive | Inactive | |
| unlisted | Unlisted | |
| suspended | Suspended | |
| deleted | Deleted | |
2.6. Serial number Status#
| Status Code | Status name | Description |
|---|
| stocked | Stocked | |
| sold | Sold | |
2.7. Inbound Status#
Unlike Order / Shipment / Return, inbound statuses are string codes, not numeric
IDs. Status Code is the raw status value; Status name is the exact string
the API returns in status_display.
| Status Code | Status name | Description |
|---|
returning | Returning | Goods are on their way back to the warehouse |
awaiting_to_receive | Awaiting to receive | Inbound created, waiting for the warehouse to receive it. Default on create |
received | Received | Warehouse has taken the parcel in |
checking | Checking | Item-by-item check in progress |
on-hold | On hold | Held, check not continued |
checked | Checked | Check finished — the status that triggers the stock update |
problem | Problems | An issue was found during the check |
cancelled | Cancelled | Inbound cancelled |
2.7.1 Inbound type#
type_inbound is a free-text CharField with no enum and no choices — unlike
every other table in this document, the values below are the ones currently written
by the code, not a closed list.reference_code means a different thing per type: the return order code for
order_return, the shipment tracking code for shipment and order_dropship.
Reading reference_code without checking type_inbound yields the wrong kind of
code, and the value still looks valid.
| Inbound type | reference_code holds | Description |
|---|
shipment | Shipment tracking code (SPVN…) | Return of a shipment. Default value |
order_return | Return order code (RTN… / ORP…) | Return against a return order |
order_dropship | Shipment tracking code | Return of a dropship order |
unknown | — | Source could not be resolved |
