Tour, Shipment & Order Status

Orbit supplies a current status for tours, shipments and orders. Statuses are updated in lockstep:

Tour StatusShipment StatusOrder StatusDescription
requestedOrder is requested, no shipment and no tour created yet.
UnroutedconfirmedOrder is confirmed, shipment is created but not routed on a tour yet.
UnassignedRoutedconfirmedTour is created from shipment, not assigned to a carrier yet.
AssignedRoutedconfirmedTour is assigned to a carrier.
RunningEnroutePickupconfirmedTour is started. More detailed tour status can be obtained from "substatus" property. Shipment status is updated.
RunningEnrouteDropoffconfirmedShipment pickup stop is reached on tour, shipment status is updated.
WaitingForReviewWaitingForReviewWaitingForReviewTour is finished and waiting for review. Shipment and Order status are updated to “WaitingForReview”.
CompletedDeliveredcompletedTour is reviewed. No effects on shipment and order status.

Cancellation & Deletion

Tour Cancellation

TriggerTour StatusShipment StatusOrder StatusDescription
Tour cancelledCancelledUnroutedconfirmedTour is cancelled. Shipment is unrouted and can be re-planned on a new tour. Order remains confirmed.

Tour Reset

TriggerTour StatusShipment StatusOrder StatusDescription
Tour resetAssignedRoutedconfirmedTour is reset to “Assigned” status. Shipment remains “Routed” on the tour. Logged times and substatus are cleared.

Tour Deletion

TriggerTour StatusShipment StatusOrder StatusDescription
Tour deleted(deleted)UnroutedconfirmedTour is deleted. All shipments on the tour are unrouted and can be re-planned. Order remains confirmed.

Shipment Cancellation

TriggerShipment StatusTour StatusOrder StatusDescription
Shipment cancelledCancelled(unchanged)confirmedShipment is cancelled. If shipment is on a tour, it is removed from the tour and the tour is rebuilt without it. Order remains confirmed.

Order Cancellation

TriggerOrder StatusShipment StatusTour StatusDescription
Order cancelledcancelledCancelled(rebuilt or deleted)Order is cancelled. All shipments are cancelled. Shipments are removed from their tours. Tours are rebuilt without cancelled shipments or deleted if no shipments remain.

Multi-Entity Cases

Multiple Shipments on One Tour

Scenario 1: Tour Cancellation

TriggerTour StatusAll Shipments StatusOrder StatusDescription
Tour cancelledCancelledUnroutedconfirmedAll shipments on the tour are unrouted and can be re-planned. Orders remain confirmed.

Scenario 2: One Shipment Cancelled

TriggerTour StatusCancelled ShipmentOther ShipmentsDescription
1 Shipment cancelled(rebuilt)Cancelled (removed from tour)Routed (remain on tour)Tour is rebuilt without the cancelled shipment. Other shipments remain on the tour.

Multiple Shipments on One Order

Scenario: Order Cancellation

TriggerOrder StatusAll Shipments StatusTours StatusDescription
Order cancelledcancelledCancelled (removed from tours)(rebuilt or deleted)All shipments are cancelled and removed from their tours. Tours are rebuilt or deleted.