Create Shipment

Carriyo will use the create shipment endpoint to book a new shipment with the carrier, by providing all the essential information such as:

  • Merchant's Order and Shipment reference
  • Pickup details - name, contact information and address
  • Dropoff details - name, contact information and address
  • Item details
  • Parcel details
  • Any custom information needed by the carrier, such as account number, service type etc

The carrier will respond with a unique tracking number and optionally provide the PDF and ZPL labels in the response, either encoded as hexadecimal or as download URLs.

While both binary and URL options are supported, we recommend sending the labels directly in the response as binary hexadecimal data for optimal integration.

Securityapi-key or OAuth2
Request
Request Body schema: application/json
required
entity_type
string
Default: "FORWARD"
Enum: "FORWARD" "REVERSE"
merchant
string

Merchant ID

tenant
string

Tenant ID

required
object (References Request)

References for a shipment, provided by the merchant.

The partner_order_reference is mandatory but not required to be unique. It is usually the customer facing order number.

The partner_shipment_reference must be unique for every shipment. It is mandatory, but is copied from partner_order_reference if it is not provided.

If a single order has multiple shipments, then they will share the partner_order_reference but have unique partner_shipment_reference.

required
object (Payment Request)

Payment details including the total value of the shipment and any pending Cash on Delivery amount.

object (Collection Request)

Provide the scheduled_from and scheduled_to to choose the scheduled date along with start and end time.

Example: "collection": { "scheduled_from": "2022-01-01'T'10:00:00.000Z", "scheduled_to": "2022-01-01'T'12:00:00.000Z" }

object (Delivery)

The delivery options chosen for the shipment, including the delivery type and schedule.

Provide the scheduled_from and scheduled_to to choose the scheduled date along with start and end time.

Example: "collection": { "scheduled_from": "2022-01-01'T'10:00:00.000Z", "scheduled_to": "2022-01-01'T'12:00:00.000Z" }

required
Location Object (object)

A free-form address for pickup.

required
Location Object (object)

A free-form address for dropoff.

required
Array of objects (Item)
Array of objects (Parcel Request)

List of parcels in a B2C shipment.

object

List of packages of type pallet or carton in a B2B shipment.

carrier_custom_attributes
object (Carrier Custom Attributes)

Custom attributes in the form of a map:

{"attribute1" : "value1", "attribute2" : "value2"}
order_date
string <date-time>

Date in ISO 8601 format. Example: 2020-09-03T17:07:05.000Z

Responses
200

OK

400

Error

post/shipments
Request samples
application/json
{
  • "entity_type": "FORWARD",
  • "tenant": "CARRIYO-TENANT-ID",
  • "merchant": "CARRIYO-MERCHANT-ID",
  • "references": {
    },
  • "payment": {
    },
  • "collection": {
    },
  • "delivery": {
    },
  • "pickup": {
    },
  • "dropoff": {
    },
  • "items": [
    ],
  • "parcels": [
    ],
  • "carrier_custom_attributes": {
    },
  • "order_date": "2021-01-01T10:00:00.999Z"
}
Response samples
application/json
{
  • "tracking_number": 1234567890,
  • "pdf_label_encoded": "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ZHNbMSAwIFIgNyAwIFJdL1R5cGUvUGFnZXMvQ291bnQgMi9JVFhUKDIuMS43KT4+CmVuZG9iagoxNCAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgNiAwIFI+PgplbmRvYmoKMTUgMCBvYmoKPDwvTW9kRGF0ZShEOjIwMjMwNTA4MDk1MTE4WikvQ3JlYXRpb25EYXRlKEQ6MjAyMzA1MDgwOTUxMThaKS9Qcm9kdWNlcihpVGV4dCAyLjEuNyBieSAxVDNYVCk+PgplbmRvYmoKeHJlZgowIDE2CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwNDkyMCAwMDAwMCBuIAowMDAwMDAwMDE1IDAwMDAwIG4gCjAwMDAwMDAzMTMgMDAwMDAgbiAKMDAwMDAwMDEzMiAwMDAwMCBuIAowMDAwMDAwMjI1IDAwMDAwIG4gCjAwMDAwMTM0ODcgMDAwMDAgbiAKMDAwMDAxMzMyNSAwMDAwMCBuIAowMDAwMDA1MDgyIDAwMDAwIG4gCjAwMDAwMDk5MDggMDAwMDAgbiAKMDAwMDAwNTE5OSAwMDAwMCBuIAowMDAwMDA1MjkzIDAwMDAwIG4gCjAwMDAwMDY1MzYgMDAwMDAgbiAKMDAwMDAwNTM4MiAwMDAwMCBuIAowMDAwMDEzNTU2IDAwMDAwIG4gCjAwMDAwMTM2MDIgMDAwMDAgbiAKdHJhaWxlcgo8PC9JbmZvIDE1IDAgUi9JRCBbPDY3MzgwMjMxM2ViZTFmN2YzNjc0MDcxOWE1MjVlMTNiPjwxNmUzMzg2YWQyMGU1YTAyNDZhN2Y2ZWE5ODJjZTllMD5dL1Jvb3QgMTQgMCBSL1NpemUgMTY+PgpzdGFydHhyZWYKMTM3MTMKJSVFT0YK",
}