Order Lifecycle

An exchange order consists of two independent orders with their own status lifecycles. Both are created atomically but progress independently after creation.

Forward Leg (New Item → Customer)

The forward leg of an exchange is a standard forward order — same states, same transitions. See Forward Logistics Order Lifecycle for the full diagram.

Reverse Leg (Old Item ← Customer)

Code
┌──────────────────┐
│ Order Placed     │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│ Assigned for     │
│ Pickup           │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│ Picked           │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│ Received at Hub  │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│ Returned to      │
│ Seller           │
└──────────────────┘

State Reference

Forward leg states and delivery-failure handling are identical to a standard forward order — see Forward Logistics Order Lifecycle for the full state table.

Reverse Leg

Webhooks

Shadowfax sends separate callbacks for each leg. Both callbacks include the awb_number so you can match them to the correct order. Configure your webhook URL in the SFX 360 Partner Portal.