Delivery statuses

Status	Meaning	Set by
new	accepted, not planned yet	API / import / web app
planned	in a draft plan	planning
assigned	plan approved, order assigned to a vehicle and driver	plan approval
in_transit	the driver has started the route	driver app*
delivered	delivered	driver* / dispatcher
failed	not delivered (reason from the driver)	driver* / dispatcher
cancelled	cancelled	your system (bulk) / dispatcher

* Orda Driver app: “Start shift” → in_transit, “Delivered” / “Not delivered” → delivered / failed (events route.started, pod.created).

Typical path: new → planned → assigned → in_transit → delivered. After in_transit the API refuses changes (ORDER_LOCKED).

Events

• order.status_changed — every status change except draft new ↔ planned (use route.planned for drafts): orderId, externalId, number, previousStatus, status.
• order.delivered, order.failed — the key outcomes as separate events.
• plan.approved — the plan’s orders became assigned.

See Webhooks for signatures and retries.