Shipments — Statuses

Shipments store a tracking status which is normalised across shipping carriers.

Normalised shipment statuses

Common statuses include:

Shipment tracking is polled automatically by a scheduled job (every ~15 minutes) for shipments that:

Notes:

Status changes are recorded in tracking history.
The system avoids accidental downgrades (for example, it won’t overwrite delivered with in transit if a carrier API lags).
Final statuses stop further polling.
The default automatic polling age limit is 90 days. Older shipments are skipped by the scheduler, but supported operators can still run a deliberate manual refresh.
In the default Shipments list, delivered and returned shipments are hidden from the live operational view unless you enable closed shipments. The stored shipment status is not changed.

Use Delivery attempt failed when the transport attempt has finished unsuccessfully and should now be treated as terminal.

Key behavior:

it is a final tracking status, so polling stops
it does not project the order to delivered or complete
it is different from Delivery attempted and Exception, which remain non-final states
if you create a retry shipment after this status, Parcel Pilot preserves the failed attempt in history and defaults the retry flow to avoid a second inventory deduction

When a shipment status progresses, Parcel Pilot can update the linked order(s):

If the order is part of a merge group, the same update can apply across the group.