Tracking Event Codes
To make integration easier and more scalable, Gluey harmonise all of the carrier's tracking event codes to our own set of codes. Should you wish to customise your application-layer based on specific carrier event codes Gluey does always pass through the original carrier event codes too for you to use.
This section documents all the different codes you can expect to receive from us.
- Outbound - All the different tracking events related to an outbound shipment. This also includes the exception codes that are shared between outbound and returns.
- Returns - All the different tracking events related to a return shipment. This also includes the exception codes that are shared between outbound and returns.
- International - Additional tracking event codes related to international shipments. You will receive this for both outbound and return shipments.
- All events - A comprehensive list of all outbound, return, exception and international events that we have.
Structure of Event Codes
Since Gluey use three levels of event codes you can choose to map only the two first two (milestone + event) which gives ~30 event codes to map whilst the full mapping of all three levels (milestone + event + sub_event) is more than 150 different events. This reason for this categorisation is to give you as a customers maximum freedom and flexibility to decide the level of detail you deem most suitable for your application you build on top of Gluey. The different hierarchies are described below:
- milestone - The top-level of the hierarchy and there exist nine different milestones that can take place during a delivery; start, collection, in_transit, customs, delivery, post_delivery, return_to_sender,exception,admin and return_centre. This is a very broad definition that gives a sense of where in the operational journey a parcel currently is.
- code - The second-level of the hierarchy, and a more granular description of what have happened within a milestone. For example for the milestone delivery two events are attempt and delivered where the first one indicates the shipment / parcel have had an delivery attempt and the second one indicates the shipment / parcel has actually been delivered. It does however not have specificity as to why the attempt did not succeed, neither any detail around the actual delivered event such as if it was handed over to the recipient, or to a neighbour.
- sub_code - The third-level of the hierarchy, and the most granular description and which adds contextual detail and nuance to the 'event' which may or may no be interesting to you as a customer. For example for the milestone delivery, the event is attempt then the sub_event can be recipient_unavailable which indicates that a delivery attempt was made but did not succeed because they could not reach the recipient (e.g. called receiver / used buzzer but nobody answered).
Outbound
Below are all tracking events related to an outbound shipment, arranged according to Gluey's milestone, event and sub_event structure. Should you wish to review the tracking event codes in CSV or JSON format you can also do so by downloading the below files:
start
start
gluey_test
Only in test environement. Event which is created in Gluey's test environment each time a label is printed in order to test webhook connectivity for tracking.
order_created
acknowledged_by_carrier
The carrier has sent a tracking event acknowledging that the shipment / parcel has been successfully created in their system.
shipping_label
A shipping label has been created by the parcel carrier.
locker_pin
A pin code for a parcel locker has been created indicating where a customer can drop off / collect their parcel.
qrcode
A qr code has been generated that the customer can use for a paperless return.
customer_notification
The customer have been notified that the shipment / parcel have been created and is on its way.
order_cancelled
other
The shipment / parcel / label have been cancelled
collection
pick_pack
completed
The 3PL have completed the pick and pack in the warehouse
despatch
carrier_notified
The 3PL have sent despatch advice to a carrier
scheduled
pickup_requested
A pickup has been requested with the carrier and we are awaiting their confirmation to accept the requested date and time. Alternatively should a specific date and time not have been requested then we are awaiting for the date and time to be communicated by the carrier.
with_specific_time
The shipment / parcel is scheduled by the carrier to be picked up on a specific date and time.
without_specific_time
The shipment / parcel is scheduled by the carrier to be picked up - but they have not given a specific date and time (e.g. they might have given a date range / day range like Mon-Wed).
attempt
other
The carrier have sent a tracking event indicating a collection attempt was made for the shipment / parcel.
change
cancelled
The collection has been cancelled
date
The collection date has been changed
vehicle
dispatch
The carrier have dispatched a vehicle to collect the shipment / parcel.
en_route
The dispatched vehicle is enroute to the pickup location.
collected
other
The shipment / parcel has been collected but without sufficient detail to determine what sub_event category it fits.
from_sender
The shipment / parcel has been collected from the sender, e.g. from the retailer or 3PLs warehouse.
in_transit
carrier
other
The carrier have sent a tracking event indicating the shipment / parcel is in transit but without sufficient detail to determine what event category or sub_event category it fits.
arrived_at_carrier_facility
other
The carrier have sent a tracking event indicating the parcel have arrived at one of the carriers facilities but without sufficient detail to determine what sub_event category it fits.
sortation_hub
The shipment / parcel has arrived at one of the carriers sortation hubs / regional distribution centres. This is typically a larger sortation centre where parcels gets sorted to be hauled to a smaller local depot before the final mile.
cross_docking_hub
The shipment / parcel has arrived at a cross-docking hub to be reloaded onto a new vehicle.
local_depot
The shipment / parcel has arrived at a smaller local depot. This is typically a facility without sortation where goods gets loaded onto smaller vehicles for final mile delivery.
processed_at_carrier_facility
other
The carrier have sent a tracking event indicating the parcel have been processed at one of the carriers facilities but without sufficient detail to determine what sub_event category it fits.
sortation_hub
The shipment / parcel have been processed at the facility
cross_docking_hub
The shipment / parcel have been processed at the facility
local_depot
The shipment / parcel have been processed at the facility
departed_carrier_facility
other
The carrier have sent a tracking event indicating the shipment / parcel have departed one of the carriers facilities but without sufficient detail to determine what sub_event category it fits.
sortation_hub
The shipment / parcel have departed from the sortation facility
cross_docking_hub
The shipment / parcel have departed from the cross-docking hub
airport
en_route
The shipment / parcel is enroute to an airport for a domestic flight.
take_off
The shipment / parcel have taken off on a domestic flight.
landing
The shipment / parcel have landed on a domestic airport.
delivery
out_for_delivery
other
The shipment / parcel is out for delivery.
notification
other
The carrier have notified the customer about the delivery.
email
The carrier have emailed the customer with details about the delivery.
text
The carrier have texted the customer with details about the delivery.
voice
The carrier have called the customer with details about the delivery.
letter
The carrier have sent a letter to the customer with details about the delivery.
change
address
The delivery address has been changed by the customer
date
The delivery date has been changed by the customer
service
The delivery service has been changed by the customer (e.g. from standard to express)
attempt
other
The carrier have sent a tracking event indicating a delivery attempt was made for the shipment / parcel but with out sufficient detail to determine what sub_event category it fits.
left_notice
The delivery attempt was made, and a notice was left for the warehouse to arrange re-delivery or pickup.
access_restricted
The delivery attempt was made, but access to the address was restricted (e.g., gated community, locked building).
recipient_no_longer_lives_here
The delivery was attempted but receiver no longer lives at the address
refused_by_recipient
The delivery was attempted but the recipient refused to take the parcel.
recipient_unavailable
The delivery attempt was made, but there was no answer at the address (e.g. called receiver / used buzzer but nobody answered).
no_safe_location
Delivery attempted but there was no safe location to leave the parcel.
incorrect_address
The delivery attempt was made, but the address was incorrect.
due_to_security
Delivery failed because of security issues.
warehouse_closed
The delivery attempt was made, but the warehouse was closed.
access_denied
The delivery attempt was made, but access to the warehouse was denied.
no_receiving_staff
The delivery attempt was made, but no receiving staff was available at the warehouse.
restricted_access_hours
The delivery attempt was made outside the warehouse's receiving hours.
partial_delivery_only
The delivery attempt was made, but only a partial delivery could be made due to space or capacity issues.
paperwork_incomplete
The delivery attempt was made, but the necessary paperwork was incomplete.
security_check_failed
The delivery attempt was made, but the delivery failed due to security check issues at the warehouse.
warehouse_full
The delivery attempt was made, but the warehouse was full and unable to receive more shipments.
unresponsive_contact
The delivery attempt was made, but the contact person at the warehouse was unresponsive.
delivered
other
The carrier have sent a tracking event indicating the shipment / parcel have been delivered but without sufficient detail to determine what sub_event category it fits.
to_depot
The shipment / parcel has been delivered to a local carrier depot where the receiver can collect it from.
with_signature
The shipment / parcel has been delivered and signed for.
left_with_neighbor
The shipment / parcel has been left with a neighbor.
left_in_safe_place
The shipment / parcel has been left in a safe place like your porch.
parcel_locker
The shipment / parcel has been placed in a parcel locker ready for pickup.
pudo_point
The shipment / parcel have been delivered to a pickup / dropoff location.
post_office
The shipment / parcel have been delivered to a local post office.
post_delivery
collected
by_receiver
The shipment / parcel have been collected by the receiver from its final delivery point (e.g. the receiver have collected the parcel from a locker, pudo location or similar).
rating
nps
The receiver have given a NPS (Net Promoter Score) to rate their delivery experience
other
The receiver have given a rating of their delivery experience.
return_to_sender
initiated
other
The parcel could not be delivered and the RTS (Return-to-sender) process have been initiated.
damaged_label
Due to a damaged label the parcel could not be delivered and the RTS process have been initiated.
undeliverable
The carrier attempted to delivery the parcel but failed and the RTS process have been initiated.
not_collected
The parcel was not collected by the recipient from the PUDO points or parcel locker and the RTS process have been initiated.
in_transit
held_waiting_for_instructions
The parcel is being held at the local depot awaiting further instructions.
preparing_for_return
The parcel is being prepared to be returned to the sender.
return_in_transit
The parcel is in transit back to the sender.
customs_clearance
customs_check
The parcel is undergoing customs clearance procedures.
carrier_facility
return_depot
The parcel has arrived at the carrier's return depot.
delivery
returned_to_sender
The parcel has been successfully returned to the sender.
admin
other
other
A general administrative update from the carrier.
exception
delivery
other
The carrier have sent a tracking event indicating the shipment / parcel have had a delivery exception but without sufficient detail to determine what sub_event category it fits.
pudo_unavailable
The shipment / parcel could not be delivered to the PUDO location because it was unavailable.
seized_by_law_enforcement
The shipment / parcel was seized by law enforcement.
shipment_rejected
oversized
The parcel is too large to be delivered with the selected carrier service.
duplicate_label
The shipment / parcel was rejected because the label was a duplicate of another shipment / parcel.
data_error
The shipment / parcel was rejected due to an error in the data we sent them.
bad_packaging
The shipment / parcel was rejected because it was poorly packaged.
hazmat
The shipment / parcel was rejected because it contains hazardous materials.
other
The shipment / parcel delivery was rejected for another unnamed reason.
delay
due_to_weather
The shipment / parcel delivery is delayed because of bad weather.
due_to_sender
The shipment / parcel delivery is delayed because of the sender.
due_to_recipient
The shipment / parcel delivery is delayed because of the recipient.
due_to_misroute
The shipment / parcel was accidentally sent in the wrong direction by the carrier and this cause a delay.
other
The shipment / parcel delivery is delayed for some other reason.
damage_loss
parcel_damaged
The shipment / parcel got damaged while being delivered.
parcel_destroyed
The shipment / parcel was destroyed during delivery.
lost_in_transit
The shipment / parcel got lost during delivery.
carrier_hub
other
An exception occurred at the carrier hub but without sufficient detail to determine what type of exception it is.
held_at_hub
hazmat_not_accepted
The shipment / parcel is held at a hub because it contains hazardous materials that are not accepted by the carrier.
bad_address
The shipment / parcel is held at a hub because the address is incorrect.
missing_information
The shipment / parcel is held at a hub because it is missing some information.
prohibited_items
The shipment / parcel is held because it has something that is not allowed.
other
The shipment / parcel is held at a hub for some other reason.
destroyed
other
The shipment / parcel was destroyed by the carrier for some reason.
Returns
Below are all tracking events related to an return shipment, arranged according to Gluey's milestone, event and sub_event structure. Should you wish to review the tracking event codes in CSV or JSON format you can also do so by downloading the below files:
start
start
gluey_test
Only in test environement. Event which is created in Gluey's test environment each time a label is printed in order to test webhook connectivity for tracking.
order_created
acknowledged_by_carrier
The carrier has sent a tracking event acknowledging that the shipment / parcel has been successfully created in their system.
shipping_label
A shipping label has been created by the parcel carrier.
locker_pin
A pin code for a parcel locker has been created indicating where a customer can drop off / collect their parcel.
qrcode
A qr code has been generated that the customer can use for a paperless return.
customer_notification
The customer have been notified that the shipment / parcel have been created and is on its way.
order_cancelled
other
The shipment / parcel / label have been cancelled
collection
despatch
carrier_notified
The 3PL have sent despatch advice to a carrier
scheduled
pickup_requested
A pickup has been requested with the carrier and we are awaiting their confirmation to accept the requested date and time. Alternatively should a specific date and time not have been requested then we are awaiting for the date and time to be communicated by the carrier.
with_specific_time
The shipment / parcel is scheduled by the carrier to be picked up on a specific date and time.
without_specific_time
The shipment / parcel is scheduled by the carrier to be picked up - but they have not given a specific date and time (e.g. they might have given a date range / day range like Mon-Wed).
attempt
other
The carrier have sent a tracking event indicating a collection attempt was made for the shipment / parcel.
change
cancelled
The collection has been cancelled
date
The collection date has been changed
vehicle
dispatch
The carrier have dispatched a vehicle to collect the shipment / parcel.
en_route
The dispatched vehicle is enroute to the pickup location.
dropped_by_customer
other
The carrier has sent a tracking event acknowledging that the customer have dropped the shipment / parcel with them but without sufficient detail to determine what sub_event category it fits.
at_pudo
The parcel is ready for pickup at a drop-off location, i.e. the parcel have been left by the customer at a PUDO location.
at_parcel_locker
The parcel is ready for pickup at a parcel locker, i.e. the parcel have been left by the customer at a parcel locker.
at_post_office
The parcel is ready for pickup at the post office, i.e. the parcel have been left by the customer at a local post office.
collected
other
The shipment / parcel has been collected but without sufficient detail to determine what sub_event category it fits.
from_sender
The shipment / parcel has been collected from the sender, e.g. from the retailer or 3PLs warehouse.
from_pudo
The shipment / parcel has been picked up from a drop-off location.
from_parcel_locker
The shipment / parcel has been picked up from a parcel locker.
from_post_office
The shipment / parcel has been picked up from a post office.
from_customer
The shipment / parcel has been picked up directly from the customer.
in_transit
carrier
other
The carrier have sent a tracking event indicating the shipment / parcel is in transit but without sufficient detail to determine what event category or sub_event category it fits.
arrived_at_carrier_facility
other
The carrier have sent a tracking event indicating the parcel have arrived at one of the carriers facilities but without sufficient detail to determine what sub_event category it fits.
sortation_hub
The shipment / parcel has arrived at one of the carriers sortation hubs / regional distribution centres. This is typically a larger sortation centre where parcels gets sorted to be hauled to a smaller local depot before the final mile.
cross_docking_hub
The shipment / parcel has arrived at a cross-docking hub to be reloaded onto a new vehicle.
local_depot
The shipment / parcel has arrived at a smaller local depot. This is typically a facility without sortation where goods gets loaded onto smaller vehicles for final mile delivery.
processed_at_carrier_facility
other
The carrier have sent a tracking event indicating the parcel have been processed at one of the carriers facilities but without sufficient detail to determine what sub_event category it fits.
sortation_hub
The shipment / parcel have been processed at the facility
cross_docking_hub
The shipment / parcel have been processed at the facility
local_depot
The shipment / parcel have been processed at the facility
departed_carrier_facility
other
The carrier have sent a tracking event indicating the shipment / parcel have departed one of the carriers facilities but without sufficient detail to determine what sub_event category it fits.
sortation_hub
The shipment / parcel have departed from the sortation facility
cross_docking_hub
The shipment / parcel have departed from the cross-docking hub
airport
en_route
The shipment / parcel is enroute to an airport for a domestic flight.
take_off
The shipment / parcel have taken off on a domestic flight.
landing
The shipment / parcel have landed on a domestic airport.
return_centre
arrived
other
The shipment / parcel have arrived at the returns processing centre
inspection
started
The inspection of the shipment / parcel have started.
approved
The shipment / parcel have been inspected and approved by the return centre.
faulty_items_missing
The shipment / parcel has been inspected and items are missing that should have been included in the parcel.
faulty_items_damaged
The shipment / parcel has been inspected and items included in the parcel are damaged.
faulty_wrong_items
The shipment / parcel has been inspected and the wrong items from the original order were returned, i.e. the customer registered a return for one item but returned another.
faulty_empty
The shipment / parcel has been inspected and there are no items at all in it.
faulty_unknown_objects
The shipment / parcel has been inspected and there are unknown objects included in it.
faulty_other
The shipment / parcel has been inspected and there are some othe faulty with it.
departed
other
The shipment / parcel have departed the returns processing centre
delivery
admin
other
The shipment / parcel has received an administrative update from the carrier.
out_for_delivery
other
The shipment / parcel is out for delivery.
notification
other
The carrier have notified the customer about the delivery.
email
The carrier have emailed the customer with details about the delivery.
text
The carrier have texted the customer with details about the delivery.
voice
The carrier have called the customer with details about the delivery.
letter
The carrier have sent a letter to the customer with details about the delivery.
change
address
The delivery address has been changed by the customer
date
The delivery date has been changed by the customer
service
The delivery service has been changed by the customer (e.g. from standard to express)
attempt
other
A delivery attempt was made.
access_restricted
The delivery attempt was made, but access to the address was restricted (e.g., gated community, locked building).
incorrect_address
The delivery attempt was made, but the address was incorrect.
due_to_security
Delivery failed because of security issues.
warehouse_closed
The delivery attempt was made, but the warehouse was closed.
access_denied
The delivery attempt was made, but access to the warehouse was denied.
no_receiving_staff
The delivery attempt was made, but no receiving staff was available at the warehouse.
restricted_access_hours
The delivery attempt was made outside the warehouse's receiving hours.
partial_delivery_only
The delivery attempt was made, but only a partial delivery could be made due to space or capacity issues.
left_notice
The delivery attempt was made, and a notice was left for the warehouse to arrange re-delivery or pickup.
paperwork_incomplete
The delivery attempt was made, but the necessary paperwork was incomplete.
security_check_failed
The delivery attempt was made, but the delivery failed due to security check issues at the warehouse.
warehouse_full
The delivery attempt was made, but the warehouse was full and unable to receive more shipments.
unresponsive_contact
The delivery attempt was made, but the contact person at the warehouse was unresponsive.
delivered
other
The carrier have sent a tracking event indicating the shipment / parcel have been delivered to the destination.
to_depot
The shipment / parcel has been delivered to a local depot where the receiver can collect it from.
post_delivery
rating
nps
The receiver have given a NPS (Net Promoter Score) to rate their delivery experience
other
The receiver have given a rating of their delivery experience.
admin
other
other
A general administrative update from the carrier.
exception
delivery
other
The carrier have sent a tracking event indicating the shipment / parcel have had a delivery exception but without sufficient detail to determine what sub_event category it fits.
pudo_unavailable
The shipment / parcel could not be delivered to the PUDO location because it was unavailable.
seized_by_law_enforcement
The shipment / parcel was seized by law enforcement.
shipment_rejected
oversized
The parcel is too large to be delivered with the selected carrier service.
duplicate_label
The shipment / parcel was rejected because the label was a duplicate of another shipment / parcel.
data_error
The shipment / parcel was rejected due to an error in the data we sent them.
bad_packaging
The shipment / parcel was rejected because it was poorly packaged.
hazmat
The shipment / parcel was rejected because it contains hazardous materials.
other
The shipment / parcel delivery was rejected for another unnamed reason.
delay
due_to_weather
The shipment / parcel delivery is delayed because of bad weather.
due_to_sender
The shipment / parcel delivery is delayed because of the sender.
due_to_recipient
The shipment / parcel delivery is delayed because of the recipient.
due_to_misroute
The shipment / parcel was accidentally sent in the wrong direction by the carrier and this cause a delay.
other
The shipment / parcel delivery is delayed for some other reason.
damage_loss
parcel_damaged
The shipment / parcel got damaged while being delivered.
parcel_destroyed
The shipment / parcel was destroyed during delivery.
lost_in_transit
The shipment / parcel got lost during delivery.
carrier_hub
other
An exception occurred at the carrier hub but without sufficient detail to determine what type of exception it is.
held_at_hub
hazmat_not_accepted
The shipment / parcel is held at a hub because it contains hazardous materials that are not accepted by the carrier.
bad_address
The shipment / parcel is held at a hub because the address is incorrect.
missing_information
The shipment / parcel is held at a hub because it is missing some information.
prohibited_items
The shipment / parcel is held because it has something that is not allowed.
other
The shipment / parcel is held at a hub for some other reason.
destroyed
other
The shipment / parcel was destroyed by the carrier for some reason.
International
Below are all tracking events related to an international shipment, arranged according to Gluey's milestone, event and sub_event structure. Should you wish to review the tracking event codes in CSV or JSON format you can also do so by downloading the below files:
in_transit
departure_airport
other
The carrier has sent a tracking event acknowledging that the shipment / parcel is at the origin airport but without sufficient detail to determine what sub_event category it fits.
en_route
The shipment / parcel is enroute to the departure (origin) airport for an international flight.
handed_over
The shipment / parcel have been handed over to an airline from where it will depart the origin country. This event is typically triggered from the carrier side to denote they have left the parcel with the airline at the airport.
take_off
The shipment / parcel have departed the airport in the origin country (i.e. the flight itself have taken off).
stopover_airport
other
The carrier has sent a tracking event acknowledging that the shipment / parcel is at a stopover airport but without sufficient detail to determine what sub_event category it fits.
landing
The shipment / parcel have arrived at a stopover airport (i.e. the flight itself have landed).
take_off
The shipment / parcel have departed the stopover airport (i.e. the flight itself have taken off).
destination_airport
other
The carrier has sent a tracking event acknowledging that the shipment / parcel is at the destination airport but without sufficient detail to determine what sub_event category it fits.
landing
The shipment / parcel have arrived at the final airport (i.e. the flight itself have landed).
collected
The shipment / parcel have been collected at the destination airport.
departure_seaport
other
The carrier has sent a tracking event acknowledging that the shipment / parcel is at the origin sea port but without sufficient detail to determine what sub_event category it fits.
en_route
The shipment / parcel is enroute to the departure (origin) sea port for an international voyage.
handed_over
The shipment / parcel have been unloaded at the sea port / handed over to an shipping company from where it will depart the origin country. This event is typically triggered from the carrier side to denote they have left the parcel with the shipping company at the port.
loaded_onto_vessel
The shipment / parcel have been loaded onto a naval vessel and is ready to set sail.
set_sail
The shipment / parcel have departed the sea port in the origin country (i.e. the naval vessel itself have set sail).
stopover_seaport
other
The carrier has sent a tracking event acknowledging that the shipment / parcel is at a stopover sea port but without sufficient detail to determine what sub_event category it fits.
docked
The shipment / parcel have arrived at a stopover sea port.
set_sail
The shipment / parcel have sailed from the stopover sea port.
destination_seaport
other
The carrier has sent a tracking event acknowledging that the shipment / parcel is at the destination sea port but without sufficient detail to determine what sub_event category it fits.
docked
The shipment / parcel have arrived at the destination (final) sea port.
unloaded
The shipment / parcel have been collected at the destination sea port
collected
The shipment / parcel have been collected at the destination sea port
customs
broker
other
The carrier has sent a tracking event acknowledging that the shipment / parcel is with a customs broker but without sufficient detail to determine what sub_event category it fits.
arrived
The shipment / parcel have arrived at the customs broker facility.
departed
The shipment / parcel have departed the customs broker facility.
ready_for_export
The shipment / parcel is ready for export.
in_progress
initiated
Customs clearance process has been initiated.
awaiting_documentation
Customs are waiting for required documents to clear the parcel.
documentation_submitted
The required documents have been submitted to customs.
additional_information_provided
The additional information requested by customs has been provided.
under_inspection
The parcel is being inspected by customs.
valuation_under_review
Customs are reviewing the declared value of the parcel.
valuation_approved
The declared value of the parcel has been approved by customs.
valuation_adjusted
The declared value of the parcel has been adjusted by customs.
duty_taxes_paid
Customs duty and taxes have been paid.
compliance_check
The parcel is undergoing compliance checks.
re_export_pending
The parcel is pending re-export.
re_export_completed
The parcel has been re-exported from the country.
held
other
The parcel is being held by customs for further checks for another reason.
additional_information_requested
Customs have requested additional information to process the parcel.
pending_duty_taxes_payment
Payment of customs duty and taxes is required.
certificate_of_origin
The parcel is held at customs due to missing / invalid certification of origin.
incomplete_documentation
The parcel is held at customs due to incomplete documentation.
missing_documentation
The parcel is held at customs due to missing documents or information.
subject_to_restrictions
The parcel is held at customs due to restrictions on export / import of the item.
prohibited_items
The parcel is held at customs because it contains prohibited items.
incorrect_valuation
The parcel is held due to incorrect valuation declared.
exception
other
Any other unspecified customs issue.
delay
The clearance process is delayed due to customs issues.
release_failed
The parcel failed to clear customs for unknown reasons.
finalising
compliance_approved
The parcel has passed compliance checks.
release_pending
The parcel is awaiting release after successful inspection or documentation verification.
cleared
released
The parcel has been released from customs and is ready for further transit.
special_cases
destroy_pending
The parcel is pending destruction due to non-compliance.
destroy_completed
The parcel has been destroyed due to non-compliance.
All event codes
Below are a summary of all tracking events that you can receive across outbound, return shipments that are both domestic and international shipment. Should you wish to review the tracking event codes in CSV or JSON format you can also do so by downloading the below files:
start
start
gluey_test
Only in test environement. Event which is created in Gluey's test environment each time a label is printed in order to test webhook connectivity for tracking.
order_created
acknowledged_by_carrier
The carrier has sent a tracking event acknowledging that the shipment / parcel has been successfully created in their system.
shipping_label
A shipping label has been created for the parcel by the carrier.
locker_pin
A pin code for a parcel locker has been created indicating where a customer can drop off / collect their parcel.
qrcode
A qr code has been generated that the customer can use for a paperless return.
customer_notification
The customer have been notified that the shipment / parcel have been created and is on its way.
order_cancelled
other
The shipment / parcel / label have been cancelled
collection
pick_pack
completed
The 3PL have completed the pick and pack in the warehouse
despatch
carrier_notified
The 3PL have sent despatch advice to a carrier
scheduled
pickup_requested
A pickup has been requested with the carrier and we are awaiting their confirmation to accept the requested date and time. Alternatively should a specific date and time not have been requested then we are awaiting for the date and time to be communicated by the carrier.
with_specific_time
The shipment / parcel is scheduled by the carrier to be picked up on a specific date and time.
without_specific_time
The shipment / parcel is scheduled by the carrier to be picked up - but they have not given a specific date and time (e.g. they might have given a date range / day range like Mon-Wed).
attempt
other
The carrier have sent a tracking event indicating a collection attempt was made for the shipment / parcel.
change
cancelled
The collection has been cancelled
date
The collection date has been changed
vehicle
dispatch
The carrier have dispatched a vehicle to collect the shipment / parcel.
en_route
The dispatched vehicle is enroute to the pickup location.
dropped_by_customer
other
The carrier has sent a tracking event acknowledging that the customer have dropped the shipment / parcel with them but without sufficient detail to determine what sub_event category it fits.
at_pudo
The parcel is ready for pickup at a drop-off location, i.e. the parcel have been left by the customer at a PUDO location.
at_parcel_locker
The parcel is ready for pickup at a parcel locker, i.e. the parcel have been left by the customer at a parcel locker.
at_post_office
The parcel is ready for pickup at the post office, i.e. the parcel have been left by the customer at a local post office.
collected
other
The shipment / parcel has been collected but without sufficient detail to determine what sub_event category it fits.
from_sender
The shipment / parcel has been collected from the sender, e.g. from the retailer or 3PLs warehouse.
from_pudo
The shipment / parcel has been picked up from a drop-off location.
from_parcel_locker
The shipment / parcel has been picked up from a parcel locker.
from_post_office
The shipment / parcel has been picked up from a post office.
from_customer
The shipment / parcel has been picked up directly from the customer.
in_transit
carrier
other
The carrier have sent a tracking event indicating the shipment / parcel is in transit.
arrived_at_carrier_facility
other
The carrier have sent a tracking event indicating the parcel have arrived at one of the carriers facilities but without sufficient detail to determine what sub_event category it fits.
sortation_hub
The shipment / parcel has arrived at one of the carriers sortation hubs / regional distribution centres. This is typically a larger sortation centre where parcels gets sorted to be hauled to a smaller local depot before the final mile.
cross_docking_hub
The shipment / parcel has arrived at a cross-docking hub to be reloaded onto a new vehicle.
local_depot
The shipment / parcel has arrived at a smaller local depot. This is typically a facility without sortation where goods gets loaded onto smaller vehicles for final mile delivery.
processed_at_carrier_facility
other
The carrier have sent a tracking event indicating the parcel have been processed at one of the carriers facilities but without sufficient detail to determine what sub_event category it fits.
sortation_hub
The shipment / parcel have been processed at the facility
cross_docking_hub
The shipment / parcel have been processed at the facility
local_depot
The shipment / parcel have been processed at the facility
departed_carrier_facility
other
The carrier have sent a tracking event indicating the shipment / parcel have departed one of the carriers facilities but without sufficient detail to determine what sub_event category it fits.
sortation_hub
The shipment / parcel have departed from the sortation facility
cross_docking_hub
The shipment / parcel have departed from the cross-docking hub
airport
en_route
The shipment / parcel is enroute to an airport for a domestic flight.
take_off
The shipment / parcel have taken off on a domestic flight.
landing
The shipment / parcel have landed on a domestic airport.
departure_airport
other
The carrier has sent a tracking event acknowledging that the shipment / parcel is at the origin airport but without sufficient detail to determine what sub_event category it fits.
en_route
The shipment / parcel is enroute to the departure (origin) airport for an international flight.
handed_over
The shipment / parcel have been handed over to an airline from where it will depart the origin country. This event is typically triggered from the carrier side to denote they have left the parcel with the airline at the airport.
take_off
The shipment / parcel have departed the airport in the origin country (i.e. the flight itself have taken off).
stopover_airport
other
The carrier has sent a tracking event acknowledging that the shipment / parcel is at a stopover airport but without sufficient detail to determine what sub_event category it fits.
landing
The shipment / parcel have arrived at a stopover airport (i.e. the flight itself have landed).
take_off
The shipment / parcel have departed the stopover airport (i.e. the flight itself have taken off).
destination_airport
other
The carrier has sent a tracking event acknowledging that the shipment / parcel is at the destination airport but without sufficient detail to determine what sub_event category it fits.
landing
The shipment / parcel have arrived at the final airport (i.e. the flight itself have landed).
collected
The shipment / parcel have been collected at the destination airport.
departure_seaport
other
The carrier has sent a tracking event acknowledging that the shipment / parcel is at the origin sea port but without sufficient detail to determine what sub_event category it fits.
en_route
The shipment / parcel is enroute to the departure (origin) sea port for an international voyage.
handed_over
The shipment / parcel have been unloaded at the sea port / handed over to an shipping company from where it will depart the origin country. This event is typically triggered from the carrier side to denote they have left the parcel with the shipping company at the port.
loaded_onto_vessel
The shipment / parcel have been loaded onto a naval vessel and is ready to set sail.
set_sail
The shipment / parcel have departed the sea port in the origin country (i.e. the naval vessel itself have set sail).
stopover_seaport
other
The carrier has sent a tracking event acknowledging that the shipment / parcel is at a stopover sea port but without sufficient detail to determine what sub_event category it fits.
docked
The shipment / parcel have arrived at a stopover sea port.
set_sail
The shipment / parcel have sailed from the stopover sea port.
destination_seaport
other
The carrier has sent a tracking event acknowledging that the shipment / parcel is at the destination sea port but without sufficient detail to determine what sub_event category it fits.
docked
The shipment / parcel have arrived at the destination (final) sea port.
unloaded
The shipment / parcel have been collected at the destination sea port
collected
The shipment / parcel have been collected at the destination sea port
return_centre
arrived
other
The shipment / parcel have arrived at the returns processing centre
inspection
started
The inspection of the shipment / parcel have started.
approved
The shipment / parcel have been inspected and approved by the return centre.
faulty_items_missing
The shipment / parcel has been inspected and items are missing that should have been included in the parcel.
faulty_items_damaged
The shipment / parcel has been inspected and items included in the parcel are damaged.
faulty_wrong_items
The shipment / parcel has been inspected and the wrong items from the original order were returned, i.e. the customer registered a return for one item but returned another.
faulty_empty
The shipment / parcel has been inspected and there are no items at all in it.
faulty_unknown_objects
The shipment / parcel has been inspected and there are unknown objects included in it.
faulty_other
The shipment / parcel has been inspected and there are some othe faulty with it.
departed
other
The shipment / parcel have departed the returns processing centre
delivery
admin
other
The shipment / parcel has received an administrative update from the carrier.
out_for_delivery
other
The shipment / parcel is out for delivery.
notification
other
The carrier have notified the customer about the delivery.
email
The carrier have emailed the customer with details about the delivery.
text
The carrier have texted the customer with details about the delivery.
voice
The carrier have called the customer with details about the delivery.
letter
The carrier have sent a letter to the customer with details about the delivery.
change
address
The delivery address has been changed by the customer
date
The delivery date has been changed by the customer
service
The delivery service has been changed by the customer (e.g. from standard to express)
attempt
other
The carrier have sent a tracking event indicating a delivery attempt was made for the shipment / parcel but with out sufficient detail to determine what sub_event category it fits.
left_notice
The delivery attempt was made, and a notice was left for the warehouse to arrange re-delivery or pickup.
access_restricted
The delivery attempt was made, but access to the address was restricted (e.g., gated community, locked building).
recipient_no_longer_lives_here
The delivery was attempted but receiver no longer lives at the address
refused_by_recipient
The delivery was attempted but the recipient refused to take the parcel.
recipient_unavailable
The delivery attempt was made, but there was no answer at the address (e.g. called receiver / used buzzer but nobody answered).
no_safe_location
Delivery attempted but there was no safe location to leave the parcel.
incorrect_address
The delivery attempt was made, but the address was incorrect.
due_to_security
Delivery failed because of security issues.
warehouse_closed
The delivery attempt was made, but the warehouse was closed.
access_denied
The delivery attempt was made, but access to the warehouse was denied.
no_receiving_staff
The delivery attempt was made, but no receiving staff was available at the warehouse.
restricted_access_hours
The delivery attempt was made outside the warehouse's receiving hours.
partial_delivery_only
The delivery attempt was made, but only a partial delivery could be made due to space or capacity issues.
paperwork_incomplete
The delivery attempt was made, but the necessary paperwork was incomplete.
security_check_failed
The delivery attempt was made, but the delivery failed due to security check issues at the warehouse.
warehouse_full
The delivery attempt was made, but the warehouse was full and unable to receive more shipments.
unresponsive_contact
The delivery attempt was made, but the contact person at the warehouse was unresponsive.
delivered
other
The carrier have sent a tracking event indicating the shipment / parcel have been delivered but without sufficient detail to determine what sub_event category it fits.
to_depot
The shipment / parcel has been delivered to a local depot where the receiver can collect it from.
with_signature
The shipment / parcel has been delivered and signed for.
left_with_neighbor
The shipment / parcel has been left with a neighbor.
left_in_safe_place
The shipment / parcel has been left in a safe place like your porch.
parcel_locker
The shipment / parcel has been placed in a parcel locker ready for pickup.
pudo_point
The shipment / parcel have been delivered to a pickup / dropoff location.
post_office
The shipment / parcel have been delivered to a local post office.
post_delivery
collected
by_receiver
The shipment / parcel have been collected by the receiver from its final delivery point (e.g. the receiver have collected the parcel from a locker, pudo location or similar).
rating
nps
The receiver have given a NPS (Net Promoter Score) to rate their delivery experience
other
The receiver have given a rating of their delivery experience.
return_to_sender
initiated
other
The parcel could not be delivered and the RTS (Return-to-sender) process have been initiated.
damaged_label
Due to a damaged label the parcel could not be delivered and the RTS process have been initiated.
undeliverable
The carrier attempted to delivery the parcel but failed and the RTS process have been initiated.
not_collected
The parcel was not collected by the recipient from the PUDO points or parcel locker and the RTS process have been initiated.
in_transit
held_waiting_for_instructions
The parcel is being held at the local depot awaiting further instructions.
preparing_for_return
The parcel is being prepared to be returned to the sender.
return_in_transit
The parcel is in transit back to the sender.
customs_clearance
customs_check
The parcel is undergoing customs clearance procedures.
carrier_facility
return_depot
The parcel has arrived at the carrier's return depot.
delivery
returned_to_sender
The parcel has been successfully returned to the sender.
admin
other
other
A general administrative update from the carrier.
exception
delivery
other
The carrier have sent a tracking event indicating the shipment / parcel have had a delivery exception but without sufficient detail to determine what sub_event category it fits.
pudo_unavailable
The shipment / parcel could not be delivered to the PUDO location because it was unavailable.
seized_by_law_enforcement
The shipment / parcel was seized by law enforcement.
shipment_rejected
oversized
The parcel is too large to be delivered with the selected carrier service.
duplicate_label
The shipment / parcel was rejected because the label was a duplicate of another shipment / parcel.
data_error
The shipment / parcel was rejected due to an error in the data we sent them.
bad_packaging
The shipment / parcel was rejected because it was poorly packaged.
hazmat
The shipment / parcel was rejected because it contains hazardous materials.
other
The shipment / parcel delivery was rejected for another unnamed reason.
delay
due_to_weather
The shipment / parcel delivery is delayed because of bad weather.
due_to_sender
The shipment / parcel delivery is delayed because of the sender.
due_to_recipient
The shipment / parcel delivery is delayed because of the recipient.
due_to_misroute
The shipment / parcel was accidentally sent in the wrong direction by the carrier and this cause a delay.
other
The shipment / parcel delivery is delayed for some other reason.
damage_loss
parcel_damaged
The shipment / parcel got damaged while being delivered.
parcel_destroyed
The shipment / parcel was destroyed during delivery.
lost_in_transit
The shipment / parcel got lost during delivery.
carrier_hub
other
An exception occurred at the carrier hub but without sufficient detail to determine what type of exception it is.
held_at_hub
hazmat_not_accepted
The shipment / parcel is held at a hub because it contains hazardous materials that are not accepted by the carrier.
bad_address
The shipment / parcel is held at a hub because the address is incorrect.
missing_information
The shipment / parcel is held at a hub because it is missing some information.
prohibited_items
The shipment / parcel is held because it has something that is not allowed.
other
The shipment / parcel is held at a hub for some other reason.
destroyed
other
The shipment / parcel was destroyed by the carrier for some reason.
customs
broker
other
The carrier has sent a tracking event acknowledging that the shipment / parcel is with a customs broker but without sufficient detail to determine what sub_event category it fits.
arrived
The shipment / parcel have arrived at the customs broker facility.
departed
The shipment / parcel have departed the customs broker facility.
ready_for_export
The shipment / parcel is ready for export.
in_progress
initiated
Customs clearance process has been initiated.
awaiting_documentation
Customs are waiting for required documents to clear the parcel.
documentation_submitted
The required documents have been submitted to customs.
additional_information_provided
The additional information requested by customs has been provided.
under_inspection
The parcel is being inspected by customs.
valuation_under_review
Customs are reviewing the declared value of the parcel.
valuation_approved
The declared value of the parcel has been approved by customs.
valuation_adjusted
The declared value of the parcel has been adjusted by customs.
duty_taxes_paid
Customs duty and taxes have been paid.
compliance_check
The parcel is undergoing compliance checks.
re_export_pending
The parcel is pending re-export.
re_export_completed
The parcel has been re-exported from the country.
held
other
The parcel is being held by customs for further checks for another reason.
additional_information_requested
Customs have requested additional information to process the parcel.
pending_duty_taxes_payment
Payment of customs duty and taxes is required.
certificate_of_origin
The parcel is held at customs due to missing / invalid certification of origin.
incomplete_documentation
The parcel is held at customs due to incomplete documentation.
missing_documentation
The parcel is held at customs due to missing documents or information.
subject_to_restrictions
The parcel is held at customs due to restrictions on export / import of the item.
prohibited_items
The parcel is held at customs because it contains prohibited items.
incorrect_valuation
The parcel is held due to incorrect valuation declared.
exception
other
Any other unspecified customs issue.
delay
The clearance process is delayed due to customs issues.
release_failed
The parcel failed to clear customs for unknown reasons.
finalising
compliance_approved
The parcel has passed compliance checks.
release_pending
The parcel is awaiting release after successful inspection or documentation verification.
cleared
released
The parcel has been released from customs and is ready for further transit.
special_cases
destroy_pending
The parcel is pending destruction due to non-compliance.
destroy_completed
The parcel has been destroyed due to non-compliance.