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:

Milestone	Description
IT'S ON IT'S WAY	The shipment was handed over or is on its way to the carrier.
IN TRANSIT	The shipment is traveling through the carrier's network.
TRANSIT DELAY	The shipment processing is delayed through the carrier's network.
IN CUSTOMS	The shipment is undergoing customs inspections. `Note`: this is applicable to international shipments only.
OUT FOR DELIVERY	The shipment is on the way to the recipient.
DELIVERY ATTEMPT FAILED	The delivery was attempted, but failed.
READY FOR COLLECTION	The shipment was left at a chosen location for the recipient to collect it.
DELIVERED	The shipment was successfully delivered to the recipient (or another person/place chosen by the recipient).
COLLECTED	The shipment was successfully collected from the collection point.
PART DELIVERED	The part of a consignment shipment was delivered successfully.
UNDELIVERABLE	The 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

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