The Shipment Object
The Shipment Object is the backbone of the Shipping API. It represents a grouping of items that are transported together from a starting point to a final destination. This can include one or multiple parcels.
The type of shipment can be classified as either FORWARD or REVERSE. A FORWARD shipment indicates the movement of items from a merchant to a customer, while a REVERSE shipment is the opposite, representing the return of items from a customer to a merchant.
Each shipment is given two distinct identification codes, one generated by Carriyo called theShipment ID and the other, a Partner Shipment Reference which is provided by the merchant themselves.| shipment_id | string Unique identifier for the shipment |
| entity_type | string The type of the shipment is either FORWARD or REVERSE |
| merchant | string ID of the merchant that created this shipment |
object (References Object) | |
object (Carrier Account Object) | |
object (Payment Object) Payment details including the total value of the shipment and any pending Cash on Delivery amount. | |
object (Collection Object) The collection schedule chosen for the shipment. | |
object (Delivery Object) The delivery options chosen for the shipment, including the delivery type and schedule. | |
object (Location Object) | |
object (Location Object) | |
Array of objects (Item Object) | |
Array of objects (Parcel Object) | |
object (Post Shipping Info) | |
| custom_attributes | object |
| order_date | string <date-time> The date the customer order was received by the merchant |
| order_type | string The type of the order. The possible values can be one of the order types pre-defined by the merchant. |
| creation_date | string <date-time> The date the shipment was created in Carriyo |
| update_date | string <date-time> The date the shipment was last updated in Carriyo |
| confirmation_date | string <date-time> The date the shipment was confirmed for booking |
| estimated_process_date | string <date-time> The date the shipment is expected to be processed in ISO 8601 format. Example: 2022-03-01T17:07:05.000Z |
| promised_delivery_date | string <date-time> The promised delivery date for the shipment in ISO 8601 format. Example: 2022-03-01T17:07:05.000Z |
| original_promised_delivery_date | string <date-time> The original promised delivery date for the shipment in ISO 8601 format (if the promise is updated). Example: 2022-03-01T17:07:05.000Z |
| language | string Two letter ISO 639-1 code. Example: en |
| rma_id | string ID of the Return request that initiated the reverse shipment |