Zaslat dokumentace
Zaslat API v1

Dobírka (COD)

Rozšířená specifikace

Jedná se o rozšířenou specifikaci API dokumentace pro doplňkovou službu COD u endpointů rates/get a shipments/create.

Dobírku objednáte přidáním služby s kódem COD do pole services zásilky. Objekt data služby odpovídá schématu ServiceCOD.

Parametry služby

ParametrTypPopisPovinný
valueMoneydobírková částka a měnaano
bank_accountstring(64)číslo účtu pro výplatu dobírkyano*
bank_codestring(4)čtyřmístný kód bankyano**
bank_variablestring(10)variabilní symbol — pouze číslicene
bank_currencystring(3)měna bankovního účtu (ISO 4217)ne
include_shipping_costsbooleanpřipočíst k dobírce cenu přepravyne

* Povinné při vytvoření zásilky (shipments/create). Při poptávce ceny (rates/get) účet uvádět nemusíte. Pokud máte číslo účtu uloženo v nastavení účtu, předvyplní se automaticky.

** Povinné u účtu v českém formátu. Pokud je v bank_account uveden IBAN, bank_code se neuvádí.

Formát bankovního účtu

Účet lze zadat dvěma způsoby:

  • Český formát — číslo nebo předčíslí-číslo (např. 12-34567890), vždy společně se čtyřmístným kódem banky v bank_code. Číslo účtu podléhá kontrole podle standardu ČNB (modulo 11).
  • IBAN — mezinárodní formát včetně kontrolních číslic (např. CZ6508000000192000145399). V tom případě nechte bank_code prázdný.

Povolené směry a měny

SměrMěny dobírky
CZ → CZCZK
CZ → SKCZK, EUR

Limity částky

  • Minimální dobírková částka je 30 CZK, resp. 1 EUR.
  • Částka v CZK musí být celé číslo — desetinná místa nejsou povolena.
  • Maximální částka se liší podle konkrétní přepravní služby dopravce.

Omezení dopravců

U vícekusových zásilek (více balíků v jedné zásilce) není dobírka dostupná v těchto případech:

DopravceOmezení
Balíkovnadobírka pouze pro jednokusové zásilky
DPDpouze jednokusové, pokud je použito podací nebo výdejní místo
PPLpouze jednokusové ve směru CZ → SK

Příklad dotazu

Příklad těla požadavku POST /shipments/create se zásilkou na dobírku:

JSONCode
{
    "currency": "CZK",
    "payment_type": "CREDIT",
    "shipments": [
        {
            "carrier": "GLS",
            "pickup_date": "2026-07-10",
            "from": {
                "id": 1001
            },
            "to": {
                "firstname": "Karel",
                "surname": "Dvořák",
                "street": "Jánská 42",
                "city": "Brno",
                "zip": "60200",
                "country": "CZ",
                "phone": "+420602111222",
                "email": "karel.dvorak@example.com"
            },
            "services": [
                {
                    "code": "COD",
                    "data": {
                        "value": {
                            "value": 1500,
                            "currency": "CZK"
                        },
                        "bank_account": "12-34567890",
                        "bank_code": "0100",
                        "bank_variable": "20260001"
                    }
                }
            ],
            "packages": [
                {
                    "weight": 1,
                    "width": 10,
                    "height": 20,
                    "length": 30
                }
            ]
        }
    ]
}

Stejný objekt služby použijete i v rates/get, pokud chcete cenu přepravy včetně příplatku za dobírku — tam stačí uvést pouze value.

Last modified on
Objednávka celní zásilkyDoručení na výdejní místo