CPL API
Useful links
  • Developer
  • Sandbox
Useful links
  • Developer
  • Sandbox
Přepni do češtiny
  1. Examples
  • Introduction
  • General
  • Creation of orders and shipments
  • Changelog
  • Authentication
    • Getting Bearer token
  • API Methods
  • Examples
    • Response - pick up labels (PDF A4)
    • Response - pickup label (ZPL)
    • Response - pick up label (JPG)
    • Shipment - shipment set items
    • International Shipment with or without COD – Parcels in a Set
    • Multiple shipments in one request
  • FAQ
  • Postman Collection
  1. Examples

International Shipment with or without COD – Parcels in a Set

Without COD#

If you create labels for international shipments without Cash on Delivery and you have multiple parcels in a set, each parcel is treated as a separate shipment and will not wait for a complete set of parcels for the same recipient. On the label, in the section indicating the number of parcels in the set, each parcel will be marked with the number 1/1, as shown in the following image:
image.png
An exception is made for shipments sent abroad using the Parcel connect plus product. These can be sent in a set, just like Czech shipments. On the label, you will then see the individual parcel positions in the set.
Example with three parcels labeled as 1/3, 2/3, 3/3
image.png

With COD#

If you want to create labels for international shipments with Cash on Delivery and have multiple parcels in a set, you will get the following error:
{
  "type": "https://asp.net/core",
  "title": "BadRequest",
  "status": 400,
  "detail": "Please refer to the errors property for additional details.",
  "instance": "/shipment/batch",
  "errors": {
    "Shipments[0].ShipmentSet": [
      "Cash on delivery service is not allowed for export bundled shipments"
    ]
  }
}
This error message indicates that it is not possible to send a multi-parcel COD shipment. In this case, you need to split the COD amount among separate parcels. DHL does not recognize or use consolidated delivery and treats each parcel as a separate shipment (i.e., there are no sets for COD). So, if you need to create a COD label for international shipping that has multiple packages, you must create multiple shipments in one request with a separate price for each shipment.
Previous
Shipment - shipment set items
Next
Multiple shipments in one request
Built with