Track events and milestones

Tracking all events refers to the setting that enables the monitoring and logging of every possible event related to a shipment throughout its lifecycle, for example, shipment announced, shipment departed depot, delivered to safe place, and other. On the contrary, milestones refer to significant stages within the shipment process that are essential for monitoring process, such as order created, label printed, out for delivery, and so on.

In SAPIENT, while configuring the tracking webhook, You can choose to receive all tracking events or tracking milestones only.

  • If you select to receive milestones only, the system only pushes the tracking when a new milestone is triggered.
  • If you select to receive full tracking events, then the system pushes the tracking every time it receives a new tracking event from the carrier, regardless of whether the tracking event triggers a new milestone or not.

Milestones

Milestones refer to significant stages within the shipment process that are essential for monitoring process, such as order created, label printed, out for delivery, and so on.

If you choose to receive tracking milestones, bear in mind that each milestone only gets triggered once. To understand each milestone and its expected order of occurrence, refer to the information explained in the following table:

MilestoneDescription
IT'S ON IT'S WAYThe shipment was handed over or is on its way to the carrier.
IN TRANSITThe shipment is travelling through the carrier's network.
TRANSIT DELAYThe shipment processing through the carrier's network is delayed.
IN CUSTOMSThe shipment is undergoing customs inspections.

Note: this is applicable to international shipments only.
OUT FOR DELIVERYThe shipment is on the way to the recipient.
DELIVERY ATTEMPT FAILEDThe delivery was attempted, but failed.
READY FOR COLLECTIONThe shipment was left at a chosen location for the recipient to collect.
DELIVEREDThe shipment was successfully delivered to the recipient (or another person/place chosen by the recipient).
COLLECTEDThe shipment was successfully collected from the collection point.
PART DELIVEREDThe part of a consignment shipment was delivered successfully.
UNDELIVERABLEThe delivery of the shipment was not possible.

Final events

Final events are the stages of a shipment lifecycle where no further tracking statuses are sent after the event/milestone was hit.

The following events are considered as the final events.

  • All delivered events
  • Recipient collected
  • Shipment lost/destroyed
  • Undeliverable - destroyed.

List of tracking milestones and tracking events

The following table displays a comprehensive structure of the milestones, event codes, and events that occur throughout the shipping journey of a shipment.