Delivery status - Grasshopper Labs API
Reference

Delivery status

The four scheduling states inside order.delivery.status. Tracks how far along the delivery scheduling process is.

IDStateDescription
0InitializedThe order exists but no delivery scheduling has happened yet.
1Pre-ConfirmedAn initial delivery date is proposed but not yet confirmed with the customer.
2Schedule ConfirmedThe customer has confirmed the delivery date. Time window still TBD.
3Window ConfirmedBoth the date and the time window are locked in. Customer notifications go out.

Typical lifecycle

  1. Order created → delivery.status = 0
  2. Routing assigns a date → delivery.status = 1
  3. Customer confirms date (via SMS, email, or your portal) → delivery.status = 2
  4. Dispatch finalizes the route and locks the time window → delivery.status = 3

Subscribe to delivery_changed and delivery_confirmed to track these transitions in real time.