Cart

Download schema

Create a draft shipment in the shipment cart.

POST

https://test.zaslat.cz

/api/v2/public/cart/create

x-apikey (header)

Create a draft shipment in the shipment cart. › Request Body

CreateShipmentRequest

object

Sender address. Omitted → filled from the account default sender.

object

Recipient address

array | null

Packages. Omitted → filled from the account default package.

pickupBranch

string | null

Code of the pickup branch (parcel point where the sender drops off the shipment), or "1" to use the account default pickup branch. Requires carrierCode.

Example: CZ10037

deliveryBranch

string | null

Code of the delivery branch (parcel point where the recipient collects the shipment). Requires carrierCode.

Example: CZ10046

autoDeliveryBranch

boolean | null

Automatically pick the nearest delivery point to the recipient address

serviceId

integer | null

Service (tariff) ID. Omitted → cheapest selectable service is chosen automatically.

referenceNumber

string | null

Reference number / variable symbol

Example: OBJ-2026-0001

currency

string | null

Currency

Example: CZK

carrierCode

string | null

Carrier code

Example: DPD

type

string | null · enum

Pickup type

Enum values:

ONDEMAND

REGULAR

OCCASIONAL

Example: ONDEMAND

pickupDate

string | null · Y-m-d

Pickup date (Y-m-d), must not be in the past

Example: 2030-06-22

fromTime

string | null · H:i

Earliest pickup time (H:i)

Example: 10:00

array | null

Shipment-level additional services

object

Customs declaration (for international shipments)

Create a draft shipment in the shipment cart. › Responses

Ok.

CreateShipmentResponse

id

integer · required

ID of the created draft shipment

Example: 42

source

string · required

Shipment source

Example: API

referenceNumber

string | null · required

Reference number / variable symbol, echoed back

Example: OBJ-2026-0001

errors

required

Business validation messages; null when the draft is valid

rates

required

Computed price offers; null until the async quote job finishes

modified

string · required

Last modification timestamp (Y-m-d H:i:s)

Example: 2026-06-18 10:30:00

POST/api/v2/public/cart/create

curl https://test.zaslat.cz/api/v2/public/cart/create \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'x-apikey: <api-key>' \
  --data '{
  "to": {
    "firstname": "Jan",
    "surname": "Novák",
    "street": "Sukova 4",
    "city": "Brno",
    "zip": "60200",
    "country": "CZ",
    "phone": "+420777777777",
    "email": "jan.novak@example.com"
  }
}'

Example Request Body

{
  "to": {
    "firstname": "Jan",
    "surname": "Novák",
    "street": "Sukova 4",
    "city": "Brno",
    "zip": "60200",
    "country": "CZ",
    "phone": "+420777777777",
    "email": "jan.novak@example.com"
  }
}

json

application/json

Example Responses

{
  "id": 421337,
  "source": "API",
  "referenceNumber": "OBJ-2026-0001",
  "errors": null,
  "rates": null,
  "modified": "2026-07-16 10:30:00"
}

json

application/json

Collection Request