Shipments — Statuses

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

Normalised shipment statuses

Common statuses include:

• Label created
• Pending pickup
• In transit
• Out for delivery
• Delivered
• Delivery attempted
• Exception
• Returned
• Cancelled

How shipment status updates

Automatic tracking polling

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

• are not in a final status yet, and
• have not been checked recently, and
• have enough information to track (usually a tracking number).

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.
• 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.

How shipment status affects orders

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

• Shipment In transit → Order In transit
• Shipment Out for delivery → Order Out for delivery
• Shipment Delivered → Order Complete

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