The 7 States of a Parcel: Understanding Custody Lifecycle

Why states matter more than status labels

Most ship agents track cargo with simple labels: “received,” “in warehouse,” “delivered.” These labels describe where something is, but they do not enforce the rules governing how it gets there. A parcel cannot be delivered without first being staged for loading. A bonded item cannot leave the warehouse without customs release. These are business rules, and they need to be encoded in the system — not left to operator memory.

A state machine approach treats each parcel's journey as a sequence of defined transitions. The parcel can only move from one state to the next through an explicit action performed by an authorized operator. Each transition is recorded with a timestamp, the operator's identity, and any relevant metadata. The result is a custody chain that is not just descriptive but verifiable.

The seven states explained

1. Expected

The parcel has been announced but has not physically arrived. This state is created through pre-alerts — advance notifications from suppliers, forwarders, or vessel operators. Expected parcels appear on the operations dashboard, giving warehouse teams advance visibility for zone allocation and staffing. Not every parcel passes through this state; walk-in deliveries skip directly to Received.

2. Received

The parcel has physically arrived at the agent's facility and been logged by a receiving operator. This is the first point of physical custody, and it is critical. The receiving record captures the condition of the goods, the quantity, the identity of the person who delivered them, and any discrepancies from the pre-alert. From this moment forward, the ship agent is accountable for the parcel.

3. In Warehouse

The parcel has been moved from the receiving area to its designated warehouse location. This state tracks where the parcel is stored — which zone, which shelf, which temperature-controlled area. For agencies managing hundreds of parcels across multiple vessels, warehouse location tracking prevents the common problem of lost or misplaced cargo that surfaces only when the vessel is ready to load.

4. Staged

The parcel has been pulled from warehouse storage and moved to the staging area for delivery to the vessel. Staging is the preparation step before the parcel leaves the agent's facility. For bonded goods, this transition is blocked until the associated customs manifest has reached “Released” status — a compliance guard that prevents unauthorized movement of customs-regulated cargo.

5. Delivered

The parcel has been physically transported to the vessel. The delivery record captures when it left the warehouse, who transported it, and when it arrived at the ship. For inbound cargo, this means the goods are on board. For outbound cargo, this means the goods have left the vessel and arrived at the agent's facility or onward transport.

6. Confirmed

The vessel's captain or designated officer has confirmed receipt of the delivered cargo. This is the critical handover point where custody responsibility transfers from the ship agent to the vessel. Captain confirmation is the anchor of the entire custody chain — it is the moment that matters most in any subsequent dispute or insurance claim.

7. Closed

The parcel record is finalized. All documentation is complete, the Goods Delivery Note has been generated, and the custody chain is sealed. For bonded goods, closure includes verification that customs deadlines have been met or extensions granted. Closed parcels form the permanent compliance record for the port call.

Special states: On Hold and Cancelled

Not every parcel follows the happy path. Two additional states handle exceptions. A parcel can be placed “On Hold” from either the In Warehouse or Staged states when an issue requires investigation — a customs query, a damage concern, or a disputed ownership claim. On Hold parcels can return to In Warehouse with a documented explanation, or be cancelled entirely.

Cancelled is a terminal state for parcels that will not complete the delivery cycle. The cancellation reason is recorded, and the audit trail preserves the full history of the parcel up to the point of cancellation. Nothing is deleted — the record remains for compliance purposes.

Why direction matters

The same seven states apply to all three parcel directions — inbound (to the vessel), outbound (from the vessel), and bonded (customs-regulated) — but the business rules differ. Outbound parcels use “Dispatched” instead of “Delivered” to reflect the different physical movement. Bonded parcels carry additional guards: staging requires customs release, and closure requires deadline compliance.

This unified-but-differentiated approach means operators learn one workflow that adapts to the cargo type, rather than three separate processes that diverge in confusing ways.

The custody chain as a legal record

Each state transition creates a timestamped, operator-attributed event that becomes part of the parcel's permanent custody chain. When a P&I club investigates a damage claim, when a customs authority audits bonded goods handling, or when a vessel operator disputes a delivery quantity, the custody chain provides the definitive record. Every question — who received it, when it was stored, where it was staged, who delivered it, who confirmed it — has a documented answer.

This is the fundamental advantage of a state machine approach over ad-hoc status tracking. The system does not just record where things are. It enforces how they get there, ensuring the record is complete, consistent, and defensible.