Zaslat API v1

Doručení na výdejní místo

Rozšířená specifikace

Jedná se o rozšířenou specifikaci API dokumentace pro endpointy rates/get a shipments/create — parametry pickup_branch, delivery_branch, pickup_branch_location a delivery_branch_location.

Zásilku lze podat nebo doručit na podací/výdejní místo dopravce (parcel shop, výdejní box, pobočka). Místo lze určit dvěma způsoby:

Kódem místa konkrétního dopravce — parametry pickup_branch / delivery_branch.
ID lokality (jedna adresa sdílená více dopravci) — parametry pickup_branch_location / delivery_branch_location.

Kde získám kód nebo ID místa

Endpoint GET /parcelpoints/list — číselník míst; kód místa je v poli code, ID lokality v poli pickup_branch_location_id.
Mapový widget — interaktivní výběr místa přímo na vašem webu; vrací objekt ParcelPoint se stejnými poli.

Určení místa kódem dopravce

Parametr	Typ	Popis	Povinný
`pickup_branch`	string \| `true`	kód podacího místa (ParcelPoint.`code`), nebo `true` pro libovolnou pobočku	ne
`delivery_branch`	string	kód výdejního místa	ne
`carrier`	string(20)	kód dopravce — povinný spolu s kódem místa	ano*

* Kód místa je unikátní pouze v rámci dopravce, proto je při použití pickup_branch nebo delivery_branch nutné uvést i carrier. Podací i výdejní místo musí patřit stejnému dopravci.

Podání na libovolné pobočce

Speciální hodnota pickup_branch: true (přijímá se i 1 nebo "1") znamená podání na libovolné pobočce dopravce — použije se, pokud odesílatel odnese zásilku na pobočku sám a nechcete určovat konkrétní místo. V odpovědi shipments/detail se tato volba vrací jako "pickup_branch": "1" a "pickup_branch_location": 1 — nejde o konkrétní místo s kódem 1, ale o interní zápis téže volby.

Varianta podání musí odpovídat nabídce

Cenová nabídka z rates/get platí jen pro variantu podání, na kterou byla vrácena. Některé služby (typicky Balíkovna a Zásilkovna) nabízejí pouze podání na pobočce — rates/get je vrátí jen na dotaz s pickup_branch: true a stejný příznak je nutné poslat i v shipments/create. Bez něj požadavek skončí chybou 400 (pro zásilku nebyla nalezena žádná cenová nabídka).

Určení místa ID lokality

Parametr	Typ	Popis	Povinný
`pickup_branch_location`	int	ID lokality pro podání	ne
`delivery_branch_location`	int	ID lokality pro doručení	ne

Lokalita sdružuje místa více dopravců na stejné adrese — konkrétní místo se dohledá podle zvolené přepravní služby (service_id). Lokalita musí zvolenému dopravci sloužit, jinak požadavek skončí validační chybou.

Na co si dát pozor

Rozměry balíku se při vytvoření zásilky kontrolují proti limitům konkrétního místa (např. velikost schránky boxu). Překročení limitu vrátí chybu Package size is too big for this pickup branch.
Některé přepravní služby doručení na výdejní místo vyžadují (delivery_branch_required v nabídce Rate), jiné ho nepodporují vůbec — dostupnost ověříte přes rates/get.
U dobírky na výdejní místo platí omezení dopravců.

Příklad dotazu

Příklad těla požadavku POST /shipments/create s doručením na výdejní místo Zásilkovny:

Code
{
    "currency": "CZK",
    "payment_type": "CREDIT",
    "shipments": [
        {
            "carrier": "ZASILKOVNA",
            "pickup_date": "2026-07-10",
            "delivery_branch": "12345",
            "from": {
                "id": 1001
            },
            "to": {
                "firstname": "Karel",
                "surname": "Dvořák",
                "country": "CZ",
                "phone": "+420602111222",
                "email": "karel.dvorak@example.com"
            },
            "packages": [
                {
                    "weight": 2,
                    "width": 20,
                    "height": 15,
                    "length": 30
                }
            ]
        }
    ]
}

Stejné parametry přijímá i rates/get — před objednávkou tak ověříte cenu a dostupnost doručení na zvolené místo.

Last modified on September 8, 2026

Dobírka (COD)Bezštítková zásilka PPL (SmartPIN)