CPL API
Užitečné odkazy
  • Developer
  • Sandbox
Užitečné odkazy
  • Developer
  • Sandbox
Switch to english
  1. Příklady požadavků a odpovědí
  • Úvod
  • Obecné
  • Tvorba zásilek a objednávek
  • Historie verzí
  • Autentizace
    • Získání Bearer tokenu
  • API Metody
  • Příklady požadavků a odpovědí
    • Vícekusá zásilka
    • Více zásilek v jednom požadavku
    • Zásilka do zahraničí s dobírkou i bez - balíky v sadě
    • Odpověď – vyzvednutí etiket (PDF A4) z GET shipment/batch/{batchId}/label
    • Odpověď – vyzvednutí etiket (ZPL)
    • Odpověď – vyzvednutí etiket (JPG)
  • Často kladené otázky
  • Postman kolekce
  1. Příklady požadavků a odpovědí

Více zásilek v jednom požadavku

Pokud máte v úmyslu posílat v jednom požadavku více zásilek může body požadavku vypadat nasledovně
body POST shipment/batch na vytvoření více zásilek v jednom požadavku
{
"returnChannel": {
  "type": "Email",
  "address": "gggg@ppl.cz"
},
"labelSettings": {
  "format": "Pdf",
  "dpi": 300,
  "completeLabelSettings": {
    "isCompleteLabelRequested": true,
    "pageSize": "default",
    "position": 2
  }
},
"shipments": [
  {
    "referenceId": "123456",
    "productType": "BUSS",
    "note": "poznamka",
    "depot": "07",
    "shipmentSet": {
      "numberOfShipments": 2
    },
    "sender": {
      "name": "Sender Name 1",
      "street": "Vysni Lhoty 222",
      "city": "Dobrá",
      "zipCode": "73951",
      "country": "CZ",
      "phone": "5465489",
      "email": "pavel@xdhdgf.cz"
    },
    "recipient": {
      "name": "Recip name 1",
      "street": "Nové Dvory-Podhůří 3844",
      "city": "Frýdek-Místek",
      "zipCode": "73801",
      "country": "CZ",
      "phone": "564654654",
      "email": "pavel@ghfd.cz"
    }
  },
  {
    "referenceId": "654321",
    "productType": "BUSS",
    "note": "poznamka",
    "depot": "07",
    "shipmentSet": {
      "numberOfShipments": 2
    },
    "sender": {
      "name": "Sender name 2",
      "street": "Vysni Lhoty 222",
      "city": "Dobrá",
      "zipCode": "73951",
      "country": "CZ",
      "phone": "321654987",
      "email": "pavel@cccccc.cz"
    },
    "recipient": {
      "name": "Recip name 2",
      "street": "Nové Dvory-Podhůří 3844",
      "city": "Frýdek-Místek",
      "zipCode": "73801",
      "country": "CZ",
      "phone": "123654789",
      "email": "pavel@cccccc.cz"
    }
  }
]
}
Po vytvoření takovéto zásilky dostanete v metodě GET shipment/batch/{batchId} následující odpověď. V items je vidět že každá zásilka je rozdělena a má svůj nosný balík.
odpověď z GET shipment/batch/{batchId}
{
  "completeLabel": {
      "labelUrls": [
          "https://api-dev.dhl.com/ecs/ppl/myapi2/shipment/batch/e4e989ee-a724-4b6c-a21a-9dd63804e14a/label?pageSize=Default&position=2&limit=200&offset=0"
      ]
  },
  "items": [
      {
          "referenceId": "123456",
          "shipmentNumber": "80050527937",
          "labelUrl": "https://api-dev.dhl.com/ecs/ppl/myapi2/data/2043c2c7-395b-494d-dc5a-08dd6c0ea4b5",
          "importState": "Complete",
          "relatedItems": [
              {
                  "shipmentNumber": "80050527938",
                  "labelUrl": "https://api-dev.dhl.com/ecs/ppl/myapi2/data/014215a9-7b60-440b-dc5b-08dd6c0ea4b5",
                  "importState": "Complete",
                  "relationType": "ShipmentSet"
              }
          ]
      },
      {
          "referenceId": "654321",
          "shipmentNumber": "80050527939",
          "labelUrl": "https://api-dev.dhl.com/ecs/ppl/myapi2/data/55ebe8cd-aa00-49d5-9a45-08dd6c0ea4ba",
          "importState": "Complete",
          "relatedItems": [
              {
                  "shipmentNumber": "80050527940",
                  "labelUrl": "https://api-dev.dhl.com/ecs/ppl/myapi2/data/9405c51f-d8b9-497e-9a46-08dd6c0ea4ba",
                  "importState": "Complete",
                  "relationType": "ShipmentSet"
              }
          ]
      }
  ]
}
Pokud jste nastavili "isCompleteLabelRequested":true zobrazí se vám v objektu completeLabel url obsahující všechny etikety.
image.png
image.png
Modified at 2025-04-05 04:04:20
Previous
Vícekusá zásilka
Next
Zásilka do zahraničí s dobírkou i bez - balíky v sadě
Built with