CPL API
Užitečné odkazy
  • Developer
  • Sandbox
Užitečné odkazy
  • Developer
  • Sandbox
Switch to english
  1. ShipmentBatch
  • Back to home
  • API Metody
  • AccessPoint
    • Seznam výdejních míst
  • AddressWhisper
    • Našeptávač adres
  • Codelist
    • Číselník pro službu kontroly věku příjemce
    • Číselník produktů
    • Číselník typů externích čísel
    • Číselník zemí + povolení COD
    • Číselník povolených měn
    • Metoda pro získání poskytovaných služeb k zásilkám.
    • Metoda pro získání minimálních a maximálních hodnot u služeb
    • Fáze zásilky
    • Statusy zásilky /shipment
    • Chybové hlášení
    • Typy osobních dokladů
  • Customer
    • Informace k zákazníkovi – povolené měny
    • Zákazníkovy adresy
  • Data
    • data
  • Info
    • info
  • Order
    • Získání informace o objednávce přepravy
  • OrderBatch
    • Slouží k vytvoření objednávky. Odpověď je v header (Location)
    • Získaní stavu objednávky
  • OrderEvent
    • Zrušení objednání svozu nebo balíku z libovolné adresy
  • Shipment
    • Slouží k získání informací (trackingu) k zásilce
  • ShipmentBatch
    • Slouží ke spojení sad zásilek
      POST
    • Vytvoření zásilky
      POST
    • Slouží k úpravě výstupního formátu štítku
      PUT
    • Získání stavu importu zásilky
      GET
    • Získání etikety
      GET
  • ShipmentEvent
    • storno zásilky
    • úprava kontaktu
  • VersionInformation
    • informace o novinkách
  • Routing
    • Slouží k získání směrovacích informací pro štítek
  1. ShipmentBatch

Slouží ke spojení sad zásilek

POST
/shipment/batch/connectSet
Maintainer:Not configured
Tato metoda slouží ke spojování zásilek do sady.
K tomu, aby bylo možné slučovat zásilky do sady je nutné abyste při zakládání zásilky, kterou budete chtít později sloučit do sady, uvedli v POST shipment/batch request body příznak "additionallyAdded": true a do externích čísel uvedli externí číslo ESPN. Takto vytvořenou zásilku bude možné slučovat pomocí této metody do sady s dalšími stejně založenými zásilkami.
Podmínky pro slučování
lze slučovat zásilky pouze stejného productType
lze slučovat i zásilky, které už byli založeny v sadě
nelze slučovat zásilky s dobírkou
zásilky lze slučovat pouze do doby dokud nejsou převedeny do fyzického stavu (oskenování při naložení)
nelze slučovat zásilky typu Smart2Box
lze slučovat pouze zásilky posílané v rámci Česke republiky (v budoucnu budeme tuto metodu rozšiřovat i pro zahraniční zásilky)
Výše uvedené podmínky musí splňovat všechny spojované zásilky. Pokud ne, neproběhne ani částečné spojení a metoda se vyhodnotí jako chybná.
Pro lepší představu procesu spojování nahlédněte do příkladů, kde je detailně popsáno spojení zásilek.

Request

Authorization
or
Header Params

Body Params application/json-patch+json

Example
{
    "customerId": 1,
    "externalSetNumber": "string",
    "shipmentNumbers": [
        "string",
        "string"
    ]
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/shipment/batch/connectSet' \
--header 'Accept-Language;' \
--header 'X-Correlation-ID;' \
--header 'X-LogLevel;' \
--header 'Content-Type: application/json-patch+json' \
--data-raw '{
    "customerId": 1,
    "externalSetNumber": "string",
    "shipmentNumbers": [
        "string",
        "string"
    ]
}'

Responses

🟢200OK
application/json
Success
Headers

Body

Example
{
    "masterShipmentNumber": "string",
    "shipmentNumbers": [
        "string"
    ]
}
🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠409409
🔴500Server Error
🔴503Service Unavailable
Modified at 2025-10-16 08:52:49
Previous
ShipmentBatch
Next
Vytvoření zásilky