What a quote is built from
Every quote resolves the same five inputs against the courier’s rate card, in this order:1
Base rate
A flat starting price on the rate card for the route’s service level.
2
Weight surcharge
Each card includes an allowance. Weight above it is charged per kilogram, and any weight
bracket the parcel falls into adds its own surcharge on top.
3
Zone multiplier and flat addon
The origin and destination resolve to named zones, and the pair selects a multiplier and a
flat addon. When both ends match a zone the courier has priced explicitly, that entry wins
over a partial match.
4
Service level
A multiplier on the subtotal: economy
0.9, standard 1.0, same day 1.2, overnight
1.3, express 1.5.5
Distance overage
Added for a door delivery outside the courier’s free allowance. Covered in full below.
(base + weight surcharge + zone addon) × zone multiplier × service multiplier + distance overage, plus any special surcharges the request asked for — a fragile or
insurance flag, for instance, each either a fixed amount or a percentage of the running subtotal.
The platform commission is added to that subtotal to produce total_price. The breakdown object
on every quote carries each component separately, so a quote can be reconciled line by line
against the total it claims.
Zone blocks and the distance overage
A courier draws its service areas as polygons on a map — a zone is a named area with a real boundary, not a radius from a depot. A door delivery is priced by how far the destination falls from the boundary of the zone, not from its centre or from the courier’s office. Each zone carries three numbers: a free allowance in metres, a step size in kilometres, and a price per step. Distance up to the allowance costs nothing extra. Beyond it, the overage is billed in whole steps, rounded up:ceil((2400 − 500) ÷ 1000) = 2 steps, so 160. Crossing into a new step is what changes the price,
which means a delivery 1.1 km out and one 1.9 km out cost the same.
Two cases resolve differently. A destination inside a service area is priced against that
area, so it pays nothing beyond the allowance. A destination outside every area is matched to
the nearest zone that will extend delivery there, and charged from that zone’s edge.
The overage applies to door delivery, and only where the courier has drawn its service areas and
priced them. A courier that has not done so quotes no overage, and a shipment routed to a pickup
point is delivered to a fixed location the courier already serves, so none arises there either.
In every case the amount charged is on the quote as
breakdown.distance_overage, including when
it is zero.What a quote commits to
A quote is a firm price with an expiry. Each carries aquote_id, a valid_until timestamp, and
the full breakdown. Creating a shipment consumes the quote, and a quote can be consumed once —
the price that was quoted is the price the shipment is created at, even if the underlying rate
card changes in between.
A quote that has expired or has already been used is refused rather than silently repriced, so a
shipment never costs more than the quote a customer was shown.

