Basic Entities
Orders, Shipments and Tours are the three objects at the heart of Orbit: the commercial booking, the individual cargo move, and the plan that drives it. Almost everything you do in Orbit MissionControl builds on these three.
Orbit keeps two sides of every job separate — the commercial side (what a customer booked and pays) and the operational side (who drives it and how) — and joins them through a single cargo move. Three objects carry that structure: the Order, the Shipment and the Tour. This article is a short introduction to each; follow the links for the full picture.
Order
An Order is the commercial record of a customer's booking. It groups one or more Shipments and carries the customer-side details — who booked, who is billed, the line items and the price. Its status updates on its own as its shipments progress; you confirm and cancel orders, but never set the status by hand.
Read more in the Orders article.
Shipment
A Shipment is a single cargo move: one pickup and one dropoff for a defined load. It is the link between the commercial Order and the operational Tour — you route a shipment onto a tour to get it planned, and the carrier attaches to that tour. A shipment waiting to be planned is Unrouted, which is perfectly normal.
Read more in the Shipments article.
Tour
A Tour is the operational plan: an ordered list of stops, driven by one carrier with a driver and vehicle, carrying one or more shipments. It is the only thing a carrier attaches to, and you review a finished tour to complete it. Cancelling a tour never deletes it — its shipments simply become available to plan again.
Read more in the Tours article.
How they fit together
An Order groups Shipments; each Shipment is routed onto a Tour; and there is no direct link from an order to a tour — the shipment is the bridge between them. As a tour is driven, its shipments progress automatically, and each shipment's Order keeps up on its own.
Where to go next
Orders — the commercial booking, its statuses and the actions you take.
Shipments — the cargo move, routing it onto a tour, and its statuses.
Tours — the operational plan, running it and reviewing it to complete.
Understanding the Order, Shipment & Tour relationship — how the two sides join through the shipment.
Order, Shipment & Tour Statuses — how statuses update as you work.
Frequently asked questions
Which object holds the price the customer pays?
The Order. The carrier's own rate lives on the Tour; the two are kept separate.
Does every booking end up as a tour straight away?
Not necessarily. An Order can hold shipments that are still Unrouted — waiting to be planned — before any Tour is created for them. See the Shipments article.