Nabídka přepravy

Získání nabídek dopravců s cenou a termínem doručení.

Nabídka přepravy

POST

https://test.zaslat.cz/api/v1

/rates/get

x-apikey (header)

Vrátí nabídky dopravců (cena, termín svozu a doručení) na základě zadaných adres, balíků a případných doplňkových služeb.

Nabídka přepravy › Request Body

⚠️ Pole `from`/`to` v této metodě vyžadují pouze `country` — ostatní parametry kontaktu jsou nepovinné.

RatesGetRequest

Contact · required

Kontaktní osoba a adresa pro podání nebo doručení zásilky. Lze uvést buď existující kontakt odkazem na id, nebo plné údaje.

Example: {"id":1001,"firstname":"Jaroslav","surname":"Novotný","company":"Zaslat s.r.o.","street":"Jindřišská 12/1027","city":"Praha 4","zip":"14000","country":"CZ","phone":"+420777152225","email":"novotny@dummymail.com"}

Contact · required

Kontaktní osoba a adresa pro podání nebo doručení zásilky. Lze uvést buď existující kontakt odkazem na id, nebo plné údaje.

Package[] · required

currency

string

Kód měny (ISO 4217) pro ceny v odpovědi.

type

ShipmentType · enum

Typ svozu zásilky.

Enum values:

ONDEMAND

OCCASIONAL

REGULAR

pickup_date

string · date

Požadované datum svozu.

carrier

string · enum

Omezí nabídku na konkrétního dopravce. Povinné, pokud je uveden kód místa v pickup_branch nebo delivery_branch.

Enum values:

PPL

DPD

GLS

TOPTRANS

UPS

GLS_SK

LIFTAGO

FEDEX

Kód podacího místa (ParcelPoint.code), spolu s carrier. Hodnota true znamená podání na libovolné pobočce dopravce — vrátí i nabídky služeb, které jinou variantu podání nenabízejí (např. Balíkovna, Zásilkovna).

delivery_branch

string

Kód výdejního místa, spolu s carrier.

Service[]

Nabídka přepravy › Responses

Seznam nabídek přepravy.

status

integer

message

string

Error[]

Rate[]

POST/rates/get

curl https://test.zaslat.cz/api/v1/rates/get \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'x-apikey: <api-key>' \
  --data '{
  "currency": "CZK",
  "pickup_date": "2026-07-10",
  "from": {
    "country": "CZ"
  },
  "to": {
    "country": "CZ"
  },
  "packages": [
    {
      "weight": 1,
      "width": 10,
      "height": 20,
      "length": 30
    }
  ]
}'

Example Request Body

{
  "currency": "CZK",
  "pickup_date": "2026-07-10",
  "from": {
    "country": "CZ"
  },
  "to": {
    "country": "CZ"
  },
  "packages": [
    {
      "weight": 1,
      "width": 10,
      "height": 20,
      "length": 30
    }
  ]
}

json

application/json

Example Responses

{
  "status": 200,
  "message": "Found 3 offers",
  "rates": [
    {
      "carrier": "GLS",
      "service": "Export SK",
      "service_id": 21,
      "pickup_date": "2026-07-10",
      "pickup_from_time": "08:00:00",
      "pickup_to_time": "18:00:00",
      "delivery_date": "2026-07-13",
      "price": {
        "value": 178.51,
        "currency": "CZK"
      },
      "price_vat": {
        "value": 216,
        "currency": "CZK"
      },
      "insurance_limit": {
        "value": 50000,
        "currency": "CZK"
      },
      "weight_limit": 40,
      "trackable": true,
      "printable": true,
      "shipment_category": "exportEu"
    },
    {
      "carrier": "DPD",
      "service": "Classic SK",
      "service_id": 8,
      "pickup_date": "2026-07-10",
      "pickup_from_time": "08:00:00",
      "pickup_to_time": "17:00:00",
      "delivery_date": "2026-07-13",
      "price": {
        "value": 189.9,
        "currency": "CZK"
      },
      "price_vat": {
        "value": 229.78,
        "currency": "CZK"
      },
      "insurance_limit": {
        "value": 50000,
        "currency": "CZK"
      },
      "weight_limit": 31.5,
      "trackable": true,
      "printable": true,
      "shipment_category": "exportEu"
    },
    {
      "carrier": "PPL",
      "service": "Parcel Connect",
      "service_id": 14,
      "pickup_date": "2026-07-10",
      "pickup_from_time": "09:00:00",
      "pickup_to_time": "18:00:00",
      "delivery_date": "2026-07-14",
      "price": {
        "value": 205,
        "currency": "CZK"
      },
      "price_vat": {
        "value": 248.05,
        "currency": "CZK"
      },
      "insurance_limit": {
        "value": 50000,
        "currency": "CZK"
      },
      "weight_limit": 30,
      "trackable": true,
      "printable": true,
      "shipment_category": "exportEu"
    }
  ]
}

json

application/json

Zásilky

Nabídka přepravy

POST

https://test.zaslat.cz/api/v1

/rates/get

x-apikey (header)

Vrátí nabídky dopravců (cena, termín svozu a doručení) na základě zadaných adres, balíků a případných doplňkových služeb.

Nabídka přepravy › Request Body

⚠️ Pole `from`/`to` v této metodě vyžadují pouze `country` — ostatní parametry kontaktu jsou nepovinné.

RatesGetRequest

Contact · required

Kontaktní osoba a adresa pro podání nebo doručení zásilky. Lze uvést buď existující kontakt odkazem na id, nebo plné údaje.

Contact · required

Kontaktní osoba a adresa pro podání nebo doručení zásilky. Lze uvést buď existující kontakt odkazem na id, nebo plné údaje.

Package[] · required

currency

string

Kód měny (ISO 4217) pro ceny v odpovědi.

type

ShipmentType · enum

Typ svozu zásilky.

Enum values:

ONDEMAND

OCCASIONAL

REGULAR

pickup_date

string · date

Požadované datum svozu.

carrier

string · enum

Omezí nabídku na konkrétního dopravce. Povinné, pokud je uveden kód místa v pickup_branch nebo delivery_branch.

Enum values:

PPL

DPD

GLS

TOPTRANS

UPS

GLS_SK

LIFTAGO

FEDEX

delivery_branch

string

Kód výdejního místa, spolu s carrier.

Service[]

Nabídka přepravy › Responses

Seznam nabídek přepravy.

status

integer

message

string

Error[]

Rate[]