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.

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.