Delivery orders created in or synced into Shippit will have different statuses on their journey towards delivery.
Here's a reference to the most popular order delivery status:
| STEP |
POSSIBLE VALUES |
API ATTRIBUTE |
WEB UI TERMINOLOGY |
WEB UI TAB |
DEFINITION |
| 0 | processing | Processing | Any | the order is being moved from one tab to the next; this status can be an indicator that the order is stuck in between the two tabs | |
| 1 | order_placed | Order Placed | New Orders | the order is created in the Shippit New Orders tab; packaging size and courier assignment is yet to be confirmed | |
| 2 | despatch_in_progress | Packing Order | Ready to Ship | the order is in the Shippit Ready to Ship tab; packaging size and courier assignment is already confirmed | |
| 3 | a | ready_for_pickup | Booked for Delivery | Track | the order is on the Shippit Track tab; order details are sent to the selected courier for pickup and the merchant is already charged for booking |
| b | pickup_failed | Pickup Failed | Track | the order status for futile pickup or no-goods-to-go (NGTG); this means the courier driver went to pick up the package from the merchant but it is not ready yet | |
| c | invalidated | Not applicable | only for priority/same-day delivery orders; an order that was booked but cannot be picked-up because of driver inavailability | ||
| d | cancelled | Cancelled | Track | an order that was previously booked but has not been picked-up was cancelled from the Track tab | |
| 4 | a | in_transit | In Transit | Track | the order is already collected by the courier driver from the merchant; this can mean (a) the order is on its way to the depot or (b) is currently travelling in between depots |
| untrackable | Untrackable | Track | the order was placed only to generate a plain label so no tracking events can be recorded; applicable for click-and-collect orders | ||
| 5 | a | with_customs | With customs | Track / Tracking page | only for international orders; an order that has arrived at the destination country but is yet to cleared by customs |
| b | customs_awaiting_paym |
Customs awaiting payment |
only for international orders; an order that has arrived at the destination country but requires duties and taxes to be paid by recipient | ||
| c | customs_failed | Customs failed | Tracking page / Track | only for international orders; an order that has arrived at the destination country but was not cleared by customs | |
| d | customs_on_hold | Customs on Hold Held by customs | only for international orders; an order that has arrived at the destination country but is undergoing review by customs for any sort of reason not stated to Shippit by courier | ||
| 6 | a | with_driver | With Driver | Track | the order is onboard for delivery to the customer; this means it's delivery day and the item is already on the courier driver's van |
| b | delivery_attempted | Delivery Attempted | Track | the courier driver attempted to deliver to the recipient address but no one is present to receive the order; a card is left at the delivery address so the recipient can arrange a redelivery. | |
| c | delivery_failed | Delivery failed | Track | the courier driver attempted to deliver to the recipient address but the recipient no longer resides/works in the destination | |
| d | insufficient_address | Insufficient Address | Track | the courier driver cannot locate the destination based on the indicated order delivery address; this could mean the address is incorrect or insufficient; the merchant can validate the address in Google Maps and supply the correct/complete address | |
| e1 | awaiting_collection | Awaiting Collection | Track | the courier driver delivered the item to a collection point for the customer to collect; this means that redelivery can no longer be arranged | |
| 7 | a | completed | Completed | Track | the package is successfully delivered |
| b | partially_completed | Check in staging - no live examples | Track | a component of a multi-parcel order is delivered but other parcels within the same order are not yet delivered | |
| c | parcel_completed | Check in staging - no live examples | Track | delivery of a multi-parcel order is completed | |
| d | lost | Lost | Track | the package is lost; if the order is covered by Shippit Transit Cover, a claim may be submitted | |
| e | damaged |
Damaged |
Track | the package is damaged; if the order is covered by Shippit Transit Cover, a claim may be submitted | |
| f | returned_to_sender | Returned to Sender | Track | the package was returned back to the merchant; this is possibly due to customer refusal to accept, customer failure to pick up from the designated collection point, redelivery attempts exceeded, incorrect address, or damaged package. | |
| 8 | a | return_requested | Return Requested | Track | the merchant booked a return of the order from the customer; this means the return label is now created |
| b | awaiting_drop_off | Awaiting drop off | Track / | only for users of the Shippit Returns portal; a customer chooses to drop off at the courier office instead of booking the delivery for pick-up from his/her address | |
| c | return_booked | No live examples, check staging | only for users of the Shippit Returns portal; a customer books the delivery for pick-up from his/her address instead of choosing to drop off at the courier office | ||
| d | return_booking_failed | only for users of the Shippit Returns portal; a customer who booked the delivery for pick-up from his/her address but is unable to ship out the item |
