# deliveries (/product/modules/deliveries)



`deliveries` is the post-order dispatch record: a shipment from one location carrying its line items, with status, carrier, method, tracking and the dispatched and delivered dates. It sits after the order, so no buyer flow touches it.

## Owns

`deliveries`. Checkout is the only creator: one row per distinct ship-from location among the order's lines, born `pending`. A Shopify-backend tenant's fulfilment lives in Shopify, so a mirrored order creates none.

## The lifecycle

`/deliveries` is the worklist of pending rows. Dispatching one resolves the tenant's active shipping provider, builds the parcel from the stored lines, creates the shipment with the carrier and stamps the result back: external id, tracking number and URL, carrier, cost, label. From there the carrier's tracking webhook advances the status, matching on the external id and ignoring a repeated event.

Both writes are privileged functions; the table carries only a read policy for signed-in users, and the webhook is anonymous.

## Routes

`/deliveries`, and the deliveries section of an order's detail.

## Settings scope

`deliveries`.

## Permissions

`orders.manage` gates the worklist. Reads scope through the parent order's own policy.

## Switched off

The worklist leaves the sidebar and the dashboard drops its deliveries tile and chart. Orders still record; nothing dispatches.