Shipments API v2

POST {{merchantAPIEndpoint}}/shipments/{orderId}

{
    "numberOfPackages": 1, // number_of_packages={X} int default 1
    "packageComment": "Test"
}

{
    "voucher": {
         "carrierName": "Courier Center",
         "deliveryKey":"courier_center_clever_point",
         "deliveryName": "Courier Center Clever Points",
         "trackingNumber": "013670308212",
         "deliveryToCourierEstimationDate": "1701958406"
    }
}

{
    "error": {
        "errorCode": "10352",
        "message": "Voucher already exists for this shipment."
    }
}

{
    "error": {
        "errorCode": "10350",
        "message": "The sale order could not be found."
    }
}

DELETE {{merchantAPIEndpoint}}/shipments/{orderId}

{
    "error": {
        "errorCode": "10353",
        "message": "There is no voucher for this sale order."
    }
}

GET {{merchantAPIEndpoint}}/shipments/{orderId}/print

GET {{merchantAPIEndpoint}}/shipments/{orderId}/print?labelFormat=pdf

{
    "shipments": [
        {
            "orderId": "GR--82--MER1243",
            "carrierName": "Courier Center",
            "deliveryName": "Box Now",
            "deliveryKey": "courier_center_box_now",
            "trackingNumber": "21456678909876",
            "voucherContent": "frregerthwhrhreher",
            "voucherFormat": "pdf",
            "deliveryToCourierEstimationDate": "1701958406",
            "error": null
        }
    ]
}

GET {{merchantAPIEndpoint}}/shipments/{orderId1},{orderId2}/print

{
  "shipments": [
    {
      "orderId": "GR--81--MER1243",        // Order reference associated with the shipment
      "carrierName": "Courier Center",     // Courier company name
      "deliveryName": "Box Now",           // Delivery service name
      "deliveryKey": "courier_center_box_now", // Internal delivery method identifier
      "trackingNumber": "",                // Tracking number (empty if not yet available)
      "voucherContent": "",                // Encoded voucher content (empty if voucher not generated)
      "voucherFormat": "pdf",              // Voucher file format (e.g. pdf)
      "deliveryToCourierEstimationDate": "1701958406", // Estimated pickup date by courier (Unix timestamp)
      "error": {
        "errorMessage": "There is no voucher for this sale order.", // Human-readable error description
        "errorCode": "10353"              // Internal error code
      }
    },
    {
      "orderId": "GR--82--MER1243",        // Order reference associated with the shipment
      "carrierName": "Courier Center",     // Courier company name
      "deliveryName": null,                // Delivery service name (null if not specified)
      "deliveryKey": null,                 // Delivery method key (null if not specified)
      "trackingNumber": "21456678909876",  // Shipment tracking number
      "voucherContent": "frregerthwhrhreher", // Encoded voucher content
      "voucherFormat": "pdf",              // Voucher file format
      "deliveryToCourierEstimationDate": "1701958406", // Estimated pickup date by courier (Unix timestamp)
      "error": null                        // No error occurred for this shipment
    }
 
    // Additional shipment entries may be listed here...
  ]
}

POST {{merchantAPIEndpoint}}/shipments/{orderId}/manifest

{
    "manifestContent": null,
    "error": {
        "errorMessage": "The manifest could not be created due to the absence of sales orders",
        "errorCode": 10400
    }
}