Shipment Lifecycle
label_created
picked_up
in_transit
out_for_delivery
delivered
Statuses
| Status | Description |
|---|---|
| label_created | Shipping label generated, awaiting pickup |
| picked_up | Carrier has picked up the package |
| in_transit | Package is moving through the carrier network |
| out_for_delivery | Package is on the delivery vehicle |
| delivered | Package has been delivered |
| exception | Delivery issue (address problem, weather delay, etc.) |
| returned | Package is being returned to sender |
| cancelled | Shipment was cancelled before pickup |
Automatic Transitions
Shipment status updates automatically from:
- Carrier tracking events — Polled or pushed via webhooks
- Bridge sync tasks — Scheduled
grab-shipmentspulls from carrier platforms - Webhook events — Real-time updates from carrier bridges
When Status Changes
Status changes trigger:
- The shipment record is updated
- The linked order’s fulfillment status is recalculated
- An activity is logged on the order
- Any configured dispatchers are evaluated