Order Lifecycle
Orders in Orderly follow a standard lifecycle. The status reflects where the order is in the fulfillment process.
Status Flow
pending
processing
partially_shipped
shipped
delivered
cancelled
Statuses
| Status | Description |
|---|---|
| pending | Order received but not yet being processed |
| processing | Order is being picked, packed, or prepared |
| partially_shipped | Some line items have shipped, others haven’t |
| shipped | All items shipped, awaiting delivery |
| delivered | All items delivered to the customer |
| cancelled | Order was cancelled |
| returned | Order was returned by the customer |
| on_hold | Order is paused (payment issue, fraud review, etc.) |
Status Transitions
Orders typically flow forward through statuses, but some transitions go backward:
pending→processing— When fulfillment beginsprocessing→shipped— When all items have trackingprocessing→partially_shipped— When some items ship firstpartially_shipped→shipped— When remaining items shipshipped→delivered— When carrier confirms delivery- Any status →
cancelled— When the order is cancelled - Any status →
on_hold— When the order needs review on_hold→ previous status — When the hold is released
Automatic Status Updates
Orderly updates order status automatically when:
- A shipment is created for order line items
- Tracking events indicate delivery
- A bridge webhook reports a status change
- A fulfillment is pushed back to the source platform
Manual Status Changes
You can manually update order status:
- From the portal order detail page
- Via the API (
PATCH /api/orders/:id) - Through operations (bulk status update)
- Via the AI agent