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)
    • Spojování zásilek
  • Často kladené otázky
  • Postman kolekce
  • Postman flows
  1. Příklady požadavků a odpovědí

Spojování zásilek

Předpokladem pro úspěšné spojení zásilek je úvést při zakládání zásilky příznak additionallyAdded a externí číslo ESPN viz Zásilka 1.
Zásilka 1
  "returnChannel": {
      "type": "Email",
      "address": "jakub@test.cz"
  },
  "labelSettings": {
      "format": "Pdf",
      "dpi": 300,
      "completeLabelSettings": {
          "isCompleteLabelRequested": false
      }
  },
  "shipments": [
      {
          "referenceId": "123456",
          "productType": "BUSS",
          "note": "poznamka",
          "depot": "07",
          "shipmentSet": {
              "numberOfShipments": 1,
              "additionallyAdded": true
          },
          "sender": {
              "name": "Mirek test",
              "street": "Testovaci 222",
              "city": "Trutnov",
              "zipCode": "11000",
              "country": "CZ",
              "phone": "123456789",
              "email": "kuba@test.cz"
          },
          "recipient": {
              "name": "Test recipient",
              "street": "HLinska 2",
              "city": "České Budějovice",
              "zipCode": "37001",
              "country": "CZ",
              "phone": "1236547895",
              "email": "krab@test.cz"
          },
          "externalNumbers": [
              {
                  "externalNumber": "123",
                  "Code": "ESPN"
              }
          ]
      }
  ]
}
Štítek takovéto zásilky bude mít následující podobu číslování.
image.png
Později jakmile se nashromáždí více zásilek připravených ke spojení bude vypadat body požadavku POST shipment/batch/connectSet pro spojování zásilek takto:
request body
  "customerId": <vaše customerId>,
  "externalSetNumber": "123",
  "shipmentNumbers": [
   "80050531022",
   "80050531023"
      
  ]
}
Pokud budou zásilky splňovat všechny předpoklady pro úspěšné spojení, response body bude mít následující podobu.
response body
  "masterShipmentNumber": "80050531022",
  "shipmentNumbers": [
      "80050531022",
      "80050531023"
  ]
}
v masterShipmentNumber je uvedena nosná zásilka a celý seznam zásilek je potom uveden v shipmentNumbers.
Modified at 2025-09-11 12:33:44
Previous
Odpověď – vyzvednutí etiket (JPG)
Next
Často kladené otázky