Tracking event codes

Every carrier has their own set of tracking event codes. Each integration in Viya maps these to a standard set of tracking event codes. We provide both the carrier-specific codes and the standard codes so you can choose to use our experience or customize to fit your specific process.

This document provides an overview of the standard tracking event codes used by Viya.

If you are in need of a specific event code that is not listed here, please contact us.

Revision history

  • 13-Dec-2024: Initial version based on Express & Road experience while comparing Edifact/GS1/Peppol standards
  • 18-Dec-2024: Rephraze to use 1 standardized code instead of event Type and event Reason
  • 07-Mar-2025: Changed list to include more processes within the transport journey

Why standardize tracking events?

Tracking events can be categorized in many ways, how they are categorized depends on the carrier and the challenges you need to solve. In Viya, we have standardized the tracking events to help you with the following questions:

When is the expected delivery?

For most receivers this is the most important question so they can plan their attendance, receiving activities, production schedule etc.. Throughout the journey, the expected delivery date can change due to various reasons. Some examples include:

  • The recipient requires a delivery appointment to be made
  • Exceptions occurr, causing a delay in the delivery: eg: equipment failure, incorrect labelling, wrong routing, temperature exceeded, bank holidays, industrial disputes, etc..
  • Customs requires additional information, goods are held at customs area
  • Network issues like missed connections, lack of transport capacity, etc..

Although the exact delivery moment might not be known if an event happens: knowing that the originally anticipated delivery date is not going to be met is important for the recipient to plan accordingly.

Who should take action?

In general the carrier is expected to take action when the transportation journey begins but.. exceptions can happen where either the shipper or recipient has to take action. Some examples include:

  • The shipper has to provide additional information to customs
  • The recipient has to provide a delivery window
  • The recipient has to provide additional information to the carrier
  • Goods are damaged, will they still be accepted by the recipient?

How is my shipping performance?

Agreements between shipper and carrier should include performance indicators. We typically see a delivery performance, but they can be broken down to a ‘pickup performance’, ‘deliver performance’ and ‘data availability’.

By using the tracking events, it is possible to indicate if an event puts the ownership of a delay in the hands of the carrier, the shipper or the recipient. Also valuable insights in customer behavior (refusals/out of home) and shipper accuracy (information completeness/labeling/data quality) can be derived.

When should I invoice my customer?

Some examples include:

  • For returns you can settle already upon reporting the return, or only when the return is handed over to the carrier, after receiving the goods or after a final inspection.
  • For outbound shipments you can invoice for example: upon booking, upon pickup, upon delivery, or upon confirmation of delivery.

How do I get proof of export?

To apply for a reduced VAT rate or to claim back VAT, you need to prove that the goods have left the country or European Union. Typically delivery events outside the country are used as input for a proof of export.

Event code breakdown

Carriers often clarify event types with an event reason. This means that when an application is configured to act on a specific event type, also the reason has to be taken into account. With the questions we have outlined above we crafted a list of codes that combine:

  • process phase: Which part of a transport journey is the event related to? Eg booking, customs, transit, delivery, etc.
  • state: what is the state for the process phase? eg requested, planned, completed, etc.
  • state detail: often the reason why the state is set. Here the state & event reason are combined.
  • responsibility: if a pickup or delivery is delayed: who is considered responsible for the delay?

The result is a standardized single event code that combines all these factors. This way, you can configure your application to act on a single event code instead of a combination.

Standard tracking event codes

Booking

The booking phase where initial data is shared between shipper and carrier to initiate the transport process

Event CodeDescription
bookingRequestedOrdering / Booking / Despatch advice data has been received by the carrier
bookingAcceptedShipment order is accepted by the carrier through explicit confirmation
bookingRefusedShipment order is refused by the carrier through explicit confirmation
bookingFailedShipment booking failed
bookingCancelledNoActivityShipment booking is cancelled because there was no operational activity executed for the requested shipment
bookingCancelledIncorrectInformationShipment booking is cancelled because information in the booking was incorrect or incomplete
bookingCancelledOtherShipment booking is cancelled, other or no reason specified

Booking change

When a booking was initially made but changes are requested by the shipper or carrier

Event CodeDescription
bookingChangeRequestedAddressChangeA request is made to change the shipment after it was originally booked
bookingChangeRequestedServiceLeveLChangeA request is made to change services related to the shipment
bookingChangeRequestedIncotermChangeA request is made to change the incoterm of the shipment
bookingChangeRequestedWeightOrDimensionChangeA request is made to update the weights or dimensions of the shipment
bookingChangeRequestedOtherA request is made to update the shipment with other or no reason specified.
bookingChangeAcceptedThe requested change to the shipment is accepted by the carrier, the change still has to be completed
bookingChangeRefusedCannotChangeAnymoreBooking change is refused as the shipment has passed its point-of-no-return
bookingChangeRefusedOtherBooking change is refused with other or no reason specified
bookingChangeFailedThe requested change to the shipment failed
bookingChangeCompletedChanges to the booking where completed succesfully
bookingChangeCancelledThe request to change the shpiment is cancelled

Cash on delivery

Getting more rare but.. in case cash on delivery is desired it should be measurable:

Event CodeDescription
cashOnDeliveryRequestedCash on delivery amount is due / requested for the shipment
cashOnDeliveryFundsCollectedThe funds required for cash on delivery have been collected/obtained from the recipient
cashOnDeliveryFailedCash on delivery collection failed
cashOnDeliveryFundsTransferredThe cash on delivery amount collected from the recipient is transferred to the shipper

Claim

For those carriers who report claims progress through their tracking events. The process of claiming is started when there is a dispute on the service provided by the carrier.

Event CodeDescription
claimRequestedShipper or recipient filed a claim with carrier on service of shipment
claimPlannedcarrier planned research for claim
claimStartedcarrier started claim procedure
claimDelayedclaim procedure is delayed
claimDelayedAdditionalInformationRequiredFromShipperadditional information is required from the shipper to continue with the claim procedure
claimDelayedAdditionalInformationRequiredFromRecipientadditional information is required from the shipper to continue with the claim procedure
claimRejectedclaim is rejected by the carrier
claimAcceptedclaim is accepted by the carrier
claimCancelledByShipperclaim is cancelled by shipper
claimCancelledByCarrierclaim is cancelled by carrier
claimCancelledByRecipientclaim is cancelled by recipient
claimReembursedFunds related to the claim are reembursed by the carrier to the shipper

Customs

When a shipment passes a customs border, export & import processes can affect the throughput of the shipment.

Event CodeDescription
customsAvailableGoods are available for customs processing
customsInProgressCustoms processing is in progress
customsDelayedIncorrectOrMissingInformationCustoms procedures are delayed as information about the shipment is missing/incomplete or incorrect
customsDelayedIncompleteCustoms procedures are delayed as not all goods are available for processing
customsDelayedPendingDutiesTaxesPaymentRecipientRecipient need to pay duties and/or taxes before shipment can be released
customsDelayedPendingDutiesTaxesPaymentShipperShipper need to pay duties and/or taxes before shipment can be released
customsDelayedCarrierDelayedCarrier delayed in providing request/information/goods for customs clearance
customsDelayedAdditionalInformationRequiredRecipientCustoms procedures are delayed as recipient nees to provide additional information for clearance purposes
customsDelayedOtherCustoms procedures are delayed
customsFailedCustoms processing failed, no customs approval available
customsFailedDestroyedByRegulationGoods failed customs inspection and where destroyed as per government agency instructions
customsReleasedReleased from customs, goods can continue journey

Delivery

The most commonly used phase in the tracking process. Here the deliveryCompleted is the key event to indicate the goods are delivered.

Event CodeDescription
deliveryPlannedRescheduledOnRequestOfRecipientDelivery moment of the shipment is rescheduled on request of recipient
deliveryPlannedRescheduledOnRequestOfShipperDelivery moment of the shipment is rescheduled on request of shipper
deliveryPlannedRescheduledOnRequestOfCarrierDelivery moment of the shipment is rescheduled on request of shipper
deliveryPlannedRescheduledDelivery moment of the shipment is rescheduled, no specific indication if carrier/recipient or shipper initiated it
deliveryPlannedArrivalNoticeProvidedDelivery moment is communicated to recipient in form of an arrival notice (ASN)
deliveryPlannedOtherDelivery planned, no specific information provided
deliveryEtaUpdateExpected date/time of delivery updated, includes new timewindow. Eg Tomorrow between 8:00-12:00, For carrier performance this is not applicable as the reason for etaUpdate should be from another event that happened.
deliveryInProgressOutForDeliveryGoods are in their last vehicle towards the receiver. This can have an update eg 10:12-11:12
deliveryInProgressShortDistanceGoods are in their last vehicle towards the receiver, it is a very short distance to the receiver
deliveryInProgressArrivedDelivery is in progress, goods arrived at destination but are not available for the recipient
deliveryInProgressUnloadedDelivery is in progress, goods haven been unloaded but are not available to the receipient
deliveryInProgress
deliveryCompletedPartlyDelivery completed partly, no specific reason provided why not all goods where delivered
deliveryCompletedPartlyMissingDelivered party, as not all goods where accounted for at delivery
deliveryCompletedPartlyDamagedRecipient refused part of the delivery as that part was damaged, rest was delivered.
deliveryCompletedPartlyCustomerPickupRecipient reported part of the goods where delivered for a shipment where the pickup was arranged by the recipient
deliveryCompletedDelivered, no details provided
deliveryCompletedAtNeighbourDelivered at neighbour
deliveryCompletedAtReceiverDelivered at recipient
deliveryCompletedAtCommercialLocationDelivered in a commercial location (store/office etc..)
deliveryCompletedAtPlaceUnattendedDelivered at a place where it was left unattended, no signature received. Eg on frontPorch, garage, side of house etc..
deliveryCompletedWithPermissionToLeaveGoodsDelivered, left on a location without obtaining signature as this was indicated in the order
deliveryCompletedManuallyRegisteredDelivered, registered the delivery event manually
deliveryCompletedOtherDelivered, other detail provided
deliveryCompletedConsgineeIndicatesSurplusDelivered goods according to request, but recipient indicates too many items have been delivered
deliveryCompletedConsigneeIndicatesMissingDelivered goods according to request, but recipient indicates items missing from what has been deliverd
deliveryCompletedDelayedShipment delivered with a delay
deliveryFailedLocationUnavailableThe delivery location could not be reached (eg roadworks, parade etc..)
deliveryFailedContactCarrierdelivery failed, contact the carrier for more information
deliveryFailedAbsentRecipientThere was no recipient available at the time of the delivery attempt
deliveryFailedRecipientClosedThe recipients location was closed/business closed at the time of the delivery attempt
deliveryFailedNoValidRecipientThe delivery failed as there was nobody allowed to receive the goods, eg adult signature required or named delivery only
deliveryFailedAccessCodeMissingTo complete delivery, an access code was required. The driver did not have access/knew the correct access code
deliveryFailedOtherDelivery failed, a no/other specific information about the delivery failure was provided
deliveryFailedAdditionalEquipmentRequiredDelivery failed as additional equipment was required to complete the delivery
deliveryFailedRefusedByRecipientRequestedOtherDeliveryDateDelivery failed as the recipient requested a different delivery date
deliveryFailedRefusedByRecipientDelivery failed as recipient refused to receive the goods
deliveryFailedRefusedByRecipientIncorrectContactDetailsDelivery failed as recipient refused the delivery due to incorrect contact details provided
deliveryFailedDamagedDelivery failed as goods where damaged
deliveryFailedRefusedByRecipientDamagedRecipient refused complete shipment as it was damaged
deliveryFailedRefusedByRecipientNotOrderedReceipient refused shipment as the goods where not ordered
deliveryFailedRefusedByRecipientMissingDocumentsRecipient refused shipment as the expected documentation was missing
deliveryFailedRefusedByRecipientInventoryRecipient refused shipment as they are doing inventory count
deliveryFailedRefusedByRecipientLateDeliveryRecipient refused shipment as it missed its requested delivery window
deliveryFailedRefusedByRecipientShipmentIncompleteRecipient refused shipment as it was not delivered complete
deliveryFailedRefusedByRecipientIncompleteDueToMissingRecipient refused shipment as it was not delivered complete, shipment was incomplete because parts are missing
deliveryFailedRefusedByRecipientCancelledRecipient refused shipment as the shipment was cancelled
deliveryFailedWaitingTimeExceededDelivery failed as driver waiting time exceeded
deliveryFailedRecipientMovedDelivery failed as recipient is no longer available on the requested delivery location, they moved.

Delivery appointment

A contact moment between the carrier and receiver to agree on the delivery window

Event CodeDescription
deliveryAppointmentRequestedAppointment for delivery is requested
deliveryAppointmentPlannedAppointment for delivery is planned/agreed with the recipient, this should include the agreed appointment timewindow
deliveryAppointmentFailedCreating an appointment failed, no specific reason provided
deliveryAppointmentFailedMissingContactDetailsCreating an appointment failed due to missing contact details
deliveryAppointmentFailedNoResponseFromRecipientCreating an appointment failed as recipient did not respond/could not be reached
deliveryAppointmentRescheduledAppointment for delivery is rescheduled, this should include the agreed appointment timewindow
deliveryAppointmentRescheduledOnRequestOfCarrierAppointment for delivery is rescheduled on request of carrier
deliveryAppointmentRescheduledOnRequestOfRecipientAppointment for delivery is rescheduled on request of recipient
deliveryAppointmentCancelledDelivery appointment is cancelled
deliveryAppointmentCancelledOnRequestOfCarrierDelivery appointment is cancelled on request of the carrier
deliveryAppointmentCancelledOnRequestOfRecipientDelivery appointment is cancelled on request of the recipient

Delivery locker

With recipients not always available at home, delivery lockers are a good alternative to deliver the goods.

Event CodeDescription
deliveryLockerPlannedDelivery is planned to a locker, incl planned to arrive
deliveryLockerArrivalFailedNoEmptyLockerAvailableDelivery into locker failed as there is no empty locker available
deliveryLockerArrivalFailedDoesNotFitInLockerDelivery into locker failed as the goods did not fit in an available locker
deliveryLockerArrivalFailedOtherDelivery into locker failed, other reason
deliveryLockerAvailableForCollectionGoods are available for collection by recipient at delivery locker
deliveryLockerAvailableForCollectionReminderReminder that goods are available for collection at delivery locker
deliveryLockerCollectedGoods collected by recipient at delivery locker
deliveryLockerReturnedToSenderGoods returned to sender after it was stored in a delivery locker

Delivery parcelshops

An equivalent to delivery lockers, parcelshops are a good alternative to deliver the goods. Where lockers are unmanned and often availabe 24-7, the parcelshops provide a manned location where the recipient can collect the goods within given opening hours.

Event CodeDescription
deliveryParcelShopPlannedGoods are planned to be sent to a parcelshop, incl planned to arrive
deliveryParcelShopArrivedGoods have arrived at the parcelshop
deliveryParcelShopArrivalFailedParcelShopClosedGoods did not arrive at parcelshop as it was closed
deliveryParcelShopArrivalFailedCannotBeReachedGoods did not arrive at parcelshop as it could not be reached, eg festival/roadblocks
deliveryParcelShopArrivalFailedOtherGoods did not arrive at parcelshop, other reason
deliveryParcelShopAvailableForCollectionGoods are available for collection by recipient at parcelshop
deliveryParcelShopAvailableForCollectionReminderReminder that goods are available for collection at parcelshop
deliveryParcelShopCollectedGoods collected by recipient at parcelshop
deliveryParcelShopReturnedToSenderNotCollectedGoods are returned from parcelshop to sender as the goods where not collected within the agreed timeframe
deliveryParcelShopReturnedToSenderNoSpaceAvailableGoods are returned from parcelshop to sender as there is no space to store the goods in parcelshop

Exception

If there is a delay in the delivery the exception is the most comon way to indicate a delay is imminent.

Event CodeDescription
exceptionMissingException, (part of) shipment is missing
exceptionMissingAtUnloadingIntermediateHub(part of) shipment is discovered missing while unloading at one of the hubs
exceptionMissingUnderInvestigationCarrier(part of) shipment is missing and under investigation by the carrier
exceptionMissingUnderInvestigationShipper(part of) shipment is missing and under investigation by the shipper
exceptionMissingUnderInvestigationRecipient(part of) shipment is missing and under investigation by the recipient
exceptionMissingLost(part of) shipment is missing  is agreed to be lost
exceptionDamagedUnderInvestigation(part of) shipment is damaged, rootcause and corrective actions is under investigation, no party indicated
exceptionDamagedUnderInvestigationCarrier(part of) shipment is damaged, rootcause and corrective actions is under investigation by the carrier
exceptionDamagedRequiresInputShipper(part of) shipment is damaged, input of the shipper is required to dermine next action
exceptionDamagedRequiresInputReceiver(part of) shipment is damaged, input of the recipient is required to dermine next action
exceptionDamagedReturnToSender(part of) shipment is damaged, shipment goes return to sender
exceptionDamagedDestroyedGoods where destroyed
exceptionDamagedDestroyedOnRequestOfShipperGoods where destroyed on instruction of the shipper
exceptionDamagedDestroyedByRegulationGoods where destroyed on instruction of govenment agency
exceptionDamagedDeliveredDamaged shipment was still deliverd at recipient
exceptionDelayedBankHolidayDelivery of shipment is delayed due to a bank holiday
exceptionDelayedAdministrativeRectivicationDelivery delayed as adminstrative rectivications had to be made
exceptionDelayedAdditionalEquipmentRequiredShipment was delayed because for pickup or delivery additional equipment was required
exceptionDelayedDeliveryAppointmentRequiredDelivery is delayed because an appointment for delivery is required
exceptionDelayedEquipmentFailureDelay caused by transport equipment failure
exceptionDelayedForceMajeureDelivery is delayed due to unconrolled events
exceptionDelayedIncorrectLabellingDelivery is delayed to incorrect labelling
exceptionDelayedIncorrectAddressDelivery is delayed to incorrect address information
exceptionDelayedIncorrectShipmentInformationInformation in the shipment is incorrect and causing a potential delay. Eg invalid service (options) or incorrect dimensions
exceptionDelayedIndustrialDisputeAn industrial dispute causes a delivery delay
exceptionDelayedLackOfTransportCapacityShipment is delayed due to a lack of transport capacity
exceptionDelayedLackOfUnloadingSpaceShipment is delayed as it could not be unloaded due to limited space at the unloading area
exceptionDelayedMissingDocumentsShipment is delayed due to missing documents
exceptionDelayedMissingDocumentsFromShipperShipment is delayed due to miss documents that should have been provided by the shipper
exceptionDelayedMissingDocumentsFromCarrierShipment is delayed due to miss documents that should have been provided by the carrier
exceptionDelayedNotLoadedAsBondedGoodsGoods appear to be bonded but where not loaded as such
exceptionDelayedNotLoadedAsDangerousGoodsGoods appear be Dangerous Goods but where not booked and loaded as such
exceptionDelayedOversizeOverweightShipment is delayed as it is has large dimensions or high weight, requiring different handling as planned
exceptionDelayedWrongRoutingShipment is delayed due to an operational error at carrier side. Eg it has been routed incorrect within the network.
exceptionDelayedTemperatureExceededShipment is delayed because the allowed temperature limits where exceeded
exceptionDelayedWaitingForEdiShipment is being delayed because electronic information about the delivery is not provided yet
exceptionDelayedMissedConnectionShipment delayed due to missed connection
exceptionDelayedGeneralTimeConstraintShipment is delayed to do various reasons within the carrier network causing a time pressure
exceptionDelayedUnknownShipment dealyed due to an unknown reason
exceptionDelayedOtherShipment delayed due to a specific other reason, carrier should provide details in description
exceptionDelayedAccidentShipment delayed due to an accident
exceptionDelayedContactCarrierMissingInformationShipment is delayed, contact with the carrier is required to provide missing information
exceptionDelayedContactCarrierByShipperShipment is delayed, it is waiting for contact with the shipper
exceptionDelayedContactCarrierByRecipientShipment is delayed, it is waiting for contact with the recipient
exceptionDelayedMissingShipment delayed as it cannot be found
exceptionDelayedMissingUnderInvestigationMissing shipment is being investigated
exceptionDelayedWeatherConditionsGood where delayed due to sever weather conditions disrupting the carriers operation
exceptionDelayedSecurityChecksGoods where delayed due to security checks performed
exceptionDelayedDestroyedHeavilyDamagedGoods where damaged to a degree that they had to be destroyed
exceptionDelayedDestroyedOnRequestOfShipperGoods where destroyed on request/confirmation of the shipper
exceptionReturnToSenderUncollectedFromPickupPointGoods returned to sender from pickup point, after not being collected within period
exceptionReturnToSenderRefusedAtDeliveryGoods returned to sender as recipient refused to accept the goods
exceptionReturnToSenderUnknownAddressGoods returned to sender as carrier could not find indicated address
exceptionReturnToSenderPartiallyPart of the goods are returned to sender, rest is kept by receipient
exceptionReturnToSenderOtherGoods returned to sender, no specific or other indication why
exceptionReturnToSenderDamagedGoods are returned to sender because they are damaged
exceptionReturnToSenderIncidentGoods are returned to sender because they were involved in an incident
exceptionReturnToSenderCancelledByShipperGoods are return to sender because the shipper cancelled the shipment
exceptionReturnToSenderCustomsInspectionResultGoods are returned to sender as something was missing/incorrect during customs inspection
exceptionOtherAnother exception that did fit to one of the other categories

Pickup

The phase that contains all activity related to the collection of the goods

Event CodeDescription
pickupRequesteddefault pickup if none of the other pickup phases apply.
pickupRequestedCommercialPickup at a commercial location, can be a store, warehouse, office etc..
pickupRequestedCustomerPickupOnly used when carrier indicates this is a specific pickup organized by the recipient/customer (so not the shipper)
pickupRequestedCustomerPickupDamagedCustomer pickup is requested, where parts of the goods are already known to be damaged
pickupRequestedCustomerPickupIncompleteCustomer pickup is requested, where parts of the goods are already known to be missing
pickupRequestedResidentialPickupOnly used when carrier specifically indicates this is a residential pickup
pickupPlannedScheduledPickup has been planned
pickupPlannedRescheduledOnRequestOfRecipientPickup has been rescheduled on request of the recipient
pickupPlannedRescheduledOnRequestOfShipperPickup has been rescheduled on request of the shipper
pickupPlannedRescheduledOnRequestOfCarrierPickup has been rescheduled on request of the carrier
pickupPlannedRescheduledPickup has been rescheduled
pickupPlannedOtherPickup has been planned
pickupArrivedPickup started, carrier has arrived onsite, loading started
pickupCompletedPickup completed
pickupCompletedIncompletePickup completed, not all adviced goods where loaded
pickupCompletedDamagedPickup completed, (parts of) the goods are damaged
pickupCompletedCustomerPickupCustomer pickup completed
pickupFailedLocationClosedPickup failed as the pickup location was closed
pickupFailedLocationCannotBeReachedPickup failed as the pickup location could not be reached
pickupFailedGoodsNotReadyPickup failed as the goods where not ready for pickup
pickupFailedGoodsLostPickup failed as the goods where lost
pickupFailedIncompleteInformationPickup failed due to implete information provided by the shipper.
pickupFailedMissedPickupWindowPickup failed as the carrier was not able to make the agreed pickup window
pickupFailedOtherPickup failed
pickupDelayedPickup delayed
pickupDelayedBookedAfterPickupWindowPickup delayed as it was booked outside a viable pickup time window.
pickupDelayedTrafficPickup delayed due to unexpected traffic
pickupDelayedWaitingForConsignmentPickup delayed: carrier is waiting for consignment to be provided
pickupDelayedWaitingToBeCompletedPickup delayed: carrier is waiting for the shipment to be completed and made ready for shipping
pickupCancelledByShipperPickup cancelled by shipper
pickupCancelledByCarrierPickup cancelled by carrier
pickupCancelledByRecipientPickup cancelled by recipient, typically used in combination with a customer pickup
pickupCancelledNoPartyIndicatedPickup cancelled

Pickup parcelshop

A variant on the pickup where the shipper (or returnee) brings the goods to a parcelshop and the carrier picks it up from there.

Event CodeDescription
pickupParcelShopRequestedOnly used when carrier indicates the pickup is meant to go through a parcelshop/pickup point
pickupParcelShopCancelledA requested parcelshop pickup has been cancelled
pickupParcelShopArrivedThe goods have been delivered at the parcelShop by the shipper and are ready to be collected by the carrier
pickupParcelShopCollectedThe goods have been collected at the parcelshop by the carrier

Return

Returns have combinations with the processes pickup/return parcelshop and `delivery, plus a set of its own events. The return phase is the phase where the goods are being returned to the shipper.

Event CodeDescription
returnRequestedGoods being returned to the seller of the goods. Eg  a defective phone is returned to Apple.
returnCollectedReturn is collected by carrier
returnCancelledReturn is cancelled, no indication who cancelled
returnCancelledByCustomerReturn is cancelled by the customer, no need to execute the return anymore
returnCancelledByShipperReturn is cancelled by the shipper/account holder
returnOthereg return link expiring soon

Transit phase

The phase that contains activity of the movement of goods between pickup and delivery location.

Event CodeDescription
transitTransportTransport activity
transitEtaUpdateUpdate on expected time of arrival
transitHubActivityActivity inside a transportation hub
transitHubActivityArrivedGoods have arrived in the hub
transitHubActivityDepartedGoods have departed the hub
transitHubActivityDepartedDamagedGoods left the hub in a damaged state
transitHubActivityDepartedPartiallyMissingPart of the goods left the hub, other part of the goods are missing
transitAtDestinationHubArrived in destination hub
transitHandoverToOtherCarrierHanded over to other carrier

Other

If events are received that cannot be classified in any of the other categories, they are classified as other.

Event CodeDescription
otherAnother event for which no process was specified for yet

Example flows

Outbound shipment

A shipment departs from a warehouse that has a daily pickup scheduled. Example events could be:

  • transitTransport
  • transitHubActivity
  • deliveryOutForDelivery
  • deliveryCompleted

Return shipment through a parcel shop

A shipment departs from a warehouse that has a daily pickup scheduled. Example events could be:

  • returnRequested
  • pickupParcelShopArrived
  • pickupParcelShopCollected
  • transitTransport
  • deliveryCompleted

Outbound shipment returned by recipient

A shipment departs from a warehouse but contact information is incorrect, so the recipient refuses the shipment. The refused shipment is returned to the sender.

Events could be:

  • pickupCompleted
  • refusedByRecipientIncorrectContactDetails
  • exceptionReturnToSenderRefusedAtDelivery
  • deliveryCompleted