Order Lifecycle

Current status enum

The current public Order status enum contains Created, Requested, OnHold, Cancelled, Fulfilled, Processing, Picked, Packed, LabelCreated, Returned, Error, and Draft. Enum membership does not by itself define a status meaning, initial state, reachability, or caller-settable target.

Verified update transitions

Use Update Order Status for the following currently verified Order-status update transitions.

From	To
Requested	Created
Created	Processing
Created	Picked
Created	Packed
Processing	Picked
Processing	Packed
Picked	Packed
Packed	LabelCreated
LabelCreated	Fulfilled
Fulfilled	Returned
Created	OnHold
Processing	OnHold
Picked	OnHold
Requested	Cancelled
Created	Cancelled
Processing	Cancelled
Picked	Cancelled
Packed	Cancelled
LabelCreated	Cancelled
OnHold	Cancelled

Resuming an Order from OnHold uses Mailhub’s stored pre-hold status; the caller does not select the resume target.

Update outcomes

The documented 409 response indicates that a status transition is not allowed. Inspect the returned response before continuing a workflow.