The shape of the system
Two ways a delivery is fulfilled
A shipment is carried either by a courier company, which assigns one of its own riders, or by the on-demand pool, where independent drivers are offered the job and the first to accept it takes it. The two share a shipment lifecycle and a tracking surface, and differ in how a carrier is chosen and how the fare is computed.Pricing & Rate Quotes
Weight brackets, zone blocks, and the distance overage on a door delivery.
Geography & Distance
The distance formula, how the nearest pickup point is found, and hex-cell dispatch.
Request Lifecycle
A quote, a shipment, and a tracking read, step by step.
Dispatch & Fulfilment
Assignment, the on-demand offer round, and the shipment status ladder.
Caching & Resilience
What is cached, revalidation, rate limits, and idempotent retries.
Returns & Reverse Logistics
The return lifecycle, liability, and the reverse shipment.

