Shipment Reason Codes

In addition to the status code, Carriyo may also assign a reason code to provide additional details about the shipment's status, especially for exceptional situations such as:

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

Key Insights:

  • Custom Reason Codes : While Carriyo provides a robust set of default reason codes, merchants have the flexibility to create custom codes for specific business needs.
  • Exceptional Statuses : These reason codes primarily apply to situations where the shipment process faces issues or exceptions, helping to provide clear communication and actionable insights.
  • Operational Transparency : By tracking both status and reason codes, Carriyo ensures full visibility into why certain shipments may face delays or cancellations, leading to quicker resolutions.

Full List of Reason Codes

Below is a comprehensive list of the standard reason codes and their descriptions.

Reason Code Description
address_changed_by_customer Address changed by the customer
address_not_served_by_carrier Carrier does not serve the provided address
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
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_clearance_issue Issue with customs clearance
duplicate_shipment Shipment is a duplicate
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