Reason codes

Alongside the status code, Carriyo may assign a reason code with additional detail. Reason codes apply to exceptional situations such as:

• cancelled
• cancelled_by_carrier
• failed_collection_attempt
• failed_delivery_attempt
• suspended
• delayed

Highlights

• Custom reason codes: while Carriyo provides a robust set of default reason codes, merchants can create custom codes for specific business needs.
• Exceptional statuses: these reason codes apply when the shipment process faces issues, providing clear communication and actionable insights.
• Operational transparency: by tracking both status and reason codes, you get full visibility into why shipments may face delays or cancellations.

Default reason codes

Reason code	Description
address_changed_by_customer	Address changed by the customer
address_corrected_by_carrier	Address was corrected by the carrier during processing
address_not_served_by_carrier	Carrier does not serve the provided address
arrived_destination_country	Shipment has arrived in the destination country
awaiting_customer_confirmation	Awaiting confirmation from the customer
awaiting_merchant_confirmation	Awaiting confirmation from the merchant
bad_weather_conditions	Delay caused by bad weather conditions
booking_confirmation_pending	Carrier booking confirmation is still pending
cancelled_by_customer	Shipment was cancelled by the customer
carrier_operational_issue	Issue due to carrier's operational problems
collection_attempts_exhausted	All collection attempts have been exhausted
customer_not_available	Customer was not available for the delivery
customer_not_contactable	Unable to contact the customer
customs_cleared	Shipment has cleared customs at the border
customs_clearance_issue	Issue with customs clearance
customs_pending	Awaiting customs clearance
departed_origin_country	Shipment has departed the origin country
duplicate_shipment	Shipment is a duplicate
handed_over_to_partner	Carrier has handed the shipment to a delivery partner
incorrect_address_details	Provided address details are incorrect
incorrect_contact_details	Provided contact details are incorrect
incorrect_customer_documentation	Incorrect documentation from the customer
incorrect_merchant_documentation	Incorrect documentation from the merchant
item_not_acceptable_by_carrier	Item is not acceptable by the carrier
on_hold_by_merchant	Shipment is on hold by the merchant
refused_by_customer	Customer refused to accept the shipment
rescheduled_by_customer	Shipment was rescheduled by the customer
shipment_misrouted	Shipment was misrouted
shipment_damaged	Shipment was damaged during transit