Shipment Status Codes

Carriyo provides various shipment status codes that indicate the current stage of a shipment within the delivery process.

Key Highlights

Pre-Shipping Statuses : These statuses track the shipment from creation to the point it is handed over to the carrier. It includes stages like draft , pending , and booked , and also includes failure scenarios like error or cancelled_by_carrier .
Post-Shipping Statuses : Once the shipment is with the carrier, its journey is monitored through statuses like in_transit , out_for_delivery , and delivered . There are also provisions for handling exceptions such as suspended , missing , and return processes like ready_for_return and returned .
Final Statuses : Some statuses mark the final point in the shipment lifecycle, including delivered , returned , delivery_confirmed , and return_confirmed .

Full List of Status Codes

Below is a detailed list of all status codes and their descriptions.

Status Code	Description	Pre or Post Shipping
`draft`	The shipment has been created as a draft. It is not confirmed and will not be communicated to the carrier.	Pre Shipping
`pending`	The shipment has been confirmed by the merchant and is pending carrier acceptance and tracking number.	Pre Shipping
`booked`	The shipment has been successfully accepted by the carrier, and a tracking number (AWB) is generated.	Pre Shipping
`error`	There was an error in communicating the shipment to the carrier, requiring troubleshooting or manual edits.	Pre Shipping
`ready-to_ship`	Confirmation that the shipment is ready for carrier pick-up, applicable to carriers requiring this status.	Pre Shipping
`failed_collection_attempt`	The carrier attempted but failed to collect the shipment from the pickup location. Applies to reverse shipments.	Pre Shipping
`cancelled_by_carrier`	The carrier canceled the shipment after acceptance, possibly due to capacity issues or coverage limitations.	Pre Shipping
`cancelled`	The shipment was manually canceled by a user in Carriyo. This is a final status.	Pre Shipping
`shipped`	The shipment has been handed over to the carrier and is now in transit.	Post Shipping
`in_transit`	The shipment has been collected, processed, and is en route to the destination.	Post Shipping
`out_for_delivery`	The shipment is in the final delivery phase and is on its way to the customer.	Post Shipping
`awaiting_customer_collection`	The shipment is ready for collection by the customer at a collection point. Applicable for collection orders.	Post Shipping
`delivered`	The shipment has been successfully delivered to the recipient. This is a final status.	Post Shipping
`suspended`	Delivery has been suspended due to issues such as an invalid address or customs clearance problems.	Post Shipping
`delayed`	Delivery of the shipment is delayed due to operational reasons.	Post Shipping
`missing`	The shipment has been lost or misplaced by the carrier.	Post Shipping
`failed_delivery_attempt`	The carrier attempted but failed to deliver the shipment. A reattempt may occur depending on carrier policy.	Post Shipping
`ready_for_return`	After failed delivery attempts, the shipment is now being processed for return to the sender.	Post Shipping
`return_in_transit`	The shipment is on its way back to the sender after failed delivery attempts.	Post Shipping
`returned`	The shipment has been successfully returned to the sender. This is a final status.	Post Shipping
`delivery_confirmed`	(Optional final state) The shipment has been delivered and confirmed by the recipient.	Post Shipping
`return_confirmed`	(Optional final state) The shipment has been returned and confirmed by the origin location.	Post Shipping

By keeping track of these status codes, merchants and customers can stay informed at every stage of the shipment process, ensuring smooth handling of logistics and potential exceptions.