API Dokumentace V2 (přepnout na V1)

switch to english

Aktuální "TOKEN" najdete ve Vaší administraci. Ukázky requestů naleznete v POSTMAN kolekci.


Katalog

Správu katalogu přes API použijte pouze po konzultaci se zástupcem Fulfillment CZ. Ve většíně případů je řešeno XML souborem.
Popis:

seznam produktů

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/products?limit=100&offset=0

JSON požadavek:

GET https://client.api.fulfillment.cz/v2/fulfillment/products?limit=30&offset=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string Ne ID produktu (pro zobrazení pouze konkrétního produktu)
active int Ne Aktivnost variant (0/1)
code string Ne DS kód varianty
ext_code string Ne Kód dodavatele varianty
limit int Ne Počet požadovaných záznamů. Defaultní hodnota = 100. Maximální hodnota = 100.
offset int Ne Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
sort string Ne Řazení záznámů. Směr řazení se určuje znakem "-" před názvem proměnné ("sort=name" = "name ASC"; "sort=-name" = "name DESC"). Defaultní řazení je "name ASC".
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": "",
    "totalCount": 1,
    "data": [
        {
            "id": 1,
            "category_id": 1,
            "name": "Horké kameny",
            "variants": [
                {
                    "id": 1,
                    "size_id": A4,
                    "name": "červené",
                    "code": "DS12345678",
                    "ext_code": "xyz",
                    "ean": "...",
                    "price_purchase": null,
                    "price_wholesale": 43.21,
                    "price_retail": 81.81,
                    "preview_image": "https://cdn.fulfillment.cz/images/3/3/c/3/3/9/2/3/c/2/ad49b23bd4e7ef694a131b.png",
                    "tracking": {
                        "expiration": false,
                        "batch_number": false,
                        "lot_id": false,
                        "serial_number": true,
                    }
                },
                {
                    "id": 2,
                    "size_id": A4,
                    "name": "černé",
                    "code": "DS12345679",
                    "ext_code": "xzy",
                    "ean": "...",
                    "price_purchase": null,
                    "price_wholesale": 43.21,
                    "price_retail": 81.81,
                    "preview_image": "https://cdn.fulfillment.cz/images/3/3/c/3/3/9/2/3/c/2/ad49b23bd4e7ef694a131c.png"
                    "tracking": {
                        "expiration": false,
                        "batch_number": false,
                        "lot_id": false,
                        "serial_number": true,
                    }
                }
            ]
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id int ID produktu
category_id int|NULL ID kategorie (pokud je produkt do kategorie zařazen).
name string Název produktu
variants.id int ID varianty
variants.size_id string|NULL Velikost manipulační jednotky
variants.name string Název varianty
variants.code string DS kód varianty
variants.ext_code string Váš kód varianty
variants.ean string EAN varianty
variants.price_purchase float|NULL Nákupní cena varianty bez DPH
variants.price_wholesale float|NULL Velkoobchodní cena varianty bez DPH
variants.price_retail float|NULL Doporučená maloobchodní cena varianty bez DPH
variants.preview_image string Obrázek varianty
variants.tracking object Nastavení trackovacích parametrů
variants.tracking.expiration bool Tracking expirace
variants.tracking.batch_number bool Tracking šarže
variants.tracking.lot_id bool Tracking LOTu
variants.tracking.serial_number bool Tracking seriových čísel
Popis:

vytváření produktů

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/products

JSON požadavek:

POST https://client.api.fulfillment.cz/v2/fulfillment/products HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "category_id": 1,
    "name": "Horké kameny",
    "variant_name": "červené",
    "ext_code": "xyz",
    "ean": "...",
    "price_purchase": null,
    "price_wholesale": 43.21,
    "price_retail": 99.21,
    "preview_image": "https://upload.wikimedia.org/wikipedia/commons/f/f0/Wikitext-wiki_markup-wikipedia.png",
    "tracking": {
        "expiration": false,
        "batch_number": false,
        "lot_id": false,
        "serial_number": true,
    }
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
category_id int|NULL Ano Id kategorie
name string Ano Název produktu
variant_name string Ano Název varianty (pokud se jedná o produkt bez variant, pošlete prázdný řetězec)
ext_code string Ano Kód produktu/varianty z vašeho systému
ean string Ano EAN produktu/varianty
price_purchase float|NULL Ne Nákupní cena varianty bez DPH
price_wholesale float|NULL Ne Velkoobchodní cena varianty bez DPH
price_retail float|NULL Ne Doporučená maloobchodní cena varianty bez DPH
preview_image string|NULL Ne URL adresa fotografie produktu NEBO jako base64 encoded string (JVBERi0xLjMNCiXi48/TDQoNCjE...).
tracking object|NULL Ne Nastavení trackovacích parametrů. Funguje pouze pro zapnutí trackingu parametru. V případě potřeby vypnutí trackingu kontaktujte naši technickou podporu.
tracking.expiration bool Ne Tracking expirace
tracking.batch_number bool Ne Tracking šarže
tracking.lot_id bool Ne Tracking LOTu
tracking.serial_number bool Ne Tracking seriových čísel
JSON odpověď:

HTTP/1.1 201
Content-type: application/json; 

{
    "code": 201,
    "message": "",
    "data": {
        "id": 1,
        "variant_id": 1
        "variant_code": "DS12345678"
    }
}
Popis polí odpovědi:
Klíč Typ Komentář
id int Id produktu v systému fulfillment.cz
variant_id int Id varianty v systému fulfillment.cz
variant_code string Kód varianty v systému fulfillment.cz
Popis:

editace produktu

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/products/<id>

JSON požadavek:

PUT https://client.api.fulfillment.cz/v2/fulfillment/products/<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "category_id": 1,
    "name": "Horké kameny"
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
category_id int|NULL Ano Id kategorie
name string Ano Název produktu
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": ""
}

Správu katalogu přes API použijte pouze po konzultaci se zástupcem Fulfillment CZ. Ve většíně případů je řešeno XML souborem.
Popis:

seznam variant konkrétního produktu

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/products/<productId>/variants?limit=100&offset=0

JSON požadavek:

GET https://client.api.fulfillment.cz/v2/fulfillment/products<productId>/variants?limit=30&offset=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string Ne ID produktu (pro zobrazení pouze konkrétní varianty)
active int Ne Aktivnost variant (0/1)
code string Ne DS kód varianty
ext_code string Ne Kód dodavatele varianty
limit int Ne Počet požadovaných záznamů. Defaultní hodnota = 100. Maximální hodnota = 100.
offset int Ne Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
sort string Ne Řazení záznámů. Směr řazení se určuje znakem "-" před názvem proměnné ("sort=name" = "name ASC"; "sort=-name" = "name DESC"). Defaultní řazení je "name ASC".
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": "",
    "totalCount": 2,
    "data": [
        {
            "id": 1,
            "size_id": A4,
            "name": "červené",
            "code": "DS12345678",
            "ext_code": "xyz",
            "ean": "...",
            "price_purchase": null,
            "price_wholesale": 43.21,
            "price_retail": 81.81,
            "preview_image": "https://cdn.fulfillment.cz/images/3/3/c/3/3/9/2/3/c/2/ad49b23bd4e7ef694a131b.png",
            "tracking": {
                "expiration": false,
                "batch_number": false,
                "lot_id": false,
                "serial_number": true,
            }
        },
        {
            "id": 2,
            "size_id": A4,
            "name": "černé",
            "code": "DS12345679",
            "ext_code": "xzy",
            "ean": "...",
            "price_purchase": null,
            "price_wholesale": 43.21,
            "price_retail": 81.81,
            "preview_image": "https://cdn.fulfillment.cz/images/3/3/c/3/3/9/2/3/c/2/ad49b23bd4e7ef694a131c.png",
            "tracking": {
                "expiration": false,
                "batch_number": false,
                "lot_id": false,
                "serial_number": true,
            }
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id int ID varianty
size_id string|NULL Velikost manipulační jednotky
name string Název varianty
code string DS kód varianty
ext_code string Váš kód varianty
ean string EAN varianty
price_purchase float|NULL Nákupní cena varianty bez DPH
price_wholesale float|NULL Velkoobchodní cena varianty bez DPH
price_retail float|NULL Doporučená maloobchodní cena varianty bez DPH
preview_image string Obrázek varianty
tracking object Nastavení trackovacích parametrů
tracking.expiration bool Tracking expirace
tracking.batch_number bool Tracking šarže
tracking.lot_id bool Tracking LOTu
tracking.serial_number bool Tracking seriových čísel
Popis:

vytváření variant konkrétního produktu

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/products/<productId>/variants

JSON požadavek:

POST https://client.api.fulfillment.cz/v2/fulfillment/products/<productId>/variants HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "name": "černé",
    "ext_code": "yzx",
    "ean": "...",
    "price_purchase": null,
    "price_wholesale": 43.21,
    "price_retail": 99.0,
    "vat": 21,
    "preview_image": "https://upload.wikimedia.org/wikipedia/commons/f/f0/Wikitext-wiki_markup-wikipedia.png",
    "tracking": {
        "expiration": false,
        "batch_number": false,
        "lot_id": false,
        "serial_number": true,
    }
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
name string Ano Název varianty
ext_code string Ano Kód produktu/varianty z vašeho systému
ean string Ano EAN produktu/varianty
price_purchase float|NULL Ne Nákupní cena varianty bez DPH
price_wholesale float|NULL Ne Velkoobchodní cena varianty bez DPH
price_retail float|NULL Ne Doporučená maloobchodní cena varianty bez DPH
preview_image string|NULL Ne URL adresa fotografie varianty NEBO jako base64 encoded string (JVBERi0xLjMNCiXi48/TDQoNCjE...).
tracking object|NULL Ne Nastavení trackovacích parametrů. Funguje pouze pro zapnutí trackingu parametru. V případě potřeby vypnutí trackingu kontaktujte naši technickou podporu.
tracking.expiration bool Ne Tracking expirace
tracking.batch_number bool Ne Tracking šarže
tracking.lot_id bool Ne Tracking LOTu
tracking.serial_number bool Ne Tracking seriových čísel
JSON odpověď:

HTTP/1.1 201
Content-type: application/json; 

{
    "code": 201,
    "message": "",
    "data": {
        "id": 1,
        "code": "DS90033407"
    }
}
Popis polí odpovědi:
Klíč Typ Komentář
id int Id varianty v systému fulfillment.cz
code string Kód varianty v systému fulfillment.cz
Popis:

editace varianty

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/products/<productId>/variants/<id> (alias: https://client.api.fulfillment.cz/v2/fulfillment/variants/<id>)

JSON požadavek:

PUT https://client.api.fulfillment.cz/v2/fulfillment/products/<productId>/variants/<id> (alias: https://client.api.fulfillment.cz/v2/fulfillment/variants/<id>) HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "name": "černé",
    "ext_code": "yzx",
    "ean": "...",
    "price_purchase": null,
    "price_wholesale": 43.21,
    "price_retail": 99.31,
    "preview_image": "https://upload.wikimedia.org/wikipedia/commons/f/f0/Wikitext-wiki_markup-wikipedia.png"
    "tracking": {
        "expiration": false,
        "batch_number": false,
        "lot_id": false,
        "serial_number": true,
    }
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
name string Ano Název varianty
ext_code string Ano Kód produktu/varianty z vašeho systému
ean string Ano EAN produktu/varianty
price_purchase float|NULL Ne Nákupní cena varianty bez DPH
price_wholesale float|NULL Ne Velkoobchodní cena varianty bez DPH
price_retail float|NULL Ne Doporučená maloobchodní cena varianty s DPH
preview_image string|NULL Ne URL adresa fotografie varianty NEBO jako base64 encoded string (JVBERi0xLjMNCiXi48/TDQoNCjE...).
tracking object|NULL Ne Nastavení trackovacích parametrů. Funguje pouze pro zapnutí trackingu parametru. V případě potřeby vypnutí trackingu kontaktujte naši technickou podporu.
tracking.expiration bool Ne Tracking expirace
tracking.batch_number bool Ne Tracking šarže
tracking.lot_id bool Ne Tracking LOTu
tracking.serial_number bool Ne Tracking seriových čísel
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": ""
}

Správu katalogu přes API použijte pouze po konzultaci se zástupcem Fulfillment CZ. Ve většíně případů je řešeno XML souborem.
Popis:

seznam produktových kategorií

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/product-categories?limit=100&offset=0

JSON požadavek:

GET https://client.api.fulfillment.cz/v2/fulfillment/product-categories?limit=30&offset=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string Ne ID kategorie (pro zobrazení pouze konkrétní kategorie)
limit int Ne Počet požadovaných záznamů. Defaultní hodnota = 100. Maximální hodnota = 1000.
offset int Ne Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
sort string Ne Řazení záznámů. Směr řazení se určuje znakem "-" před názvem proměnné ("sort=name" = "name ASC"; "sort=-name" = "name DESC"). Defaultní řazení je "name ASC".
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": "",
    "totalCount": 10,
    "data": [
        {
            "id": 1,
            "parent": 0,
            "name": "Pro muže"
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id int Id kategorie
parent int ID nadřazené kategorie. Nejvyšší stupeň kategorií je zapsán jako parent = 0.
name string Název kategorie
Popis:

vytváření kategorií

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/product-categories

JSON požadavek:

POST https://client.api.fulfillment.cz/v2/fulfillment/product-categories HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "name": "Pro muže",
    "parent": 0
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
name string Ano Název kategorie
parent int Ano ID nadřazené kategorie. Nejvyšší stupeň kategorií je zapsán jako parent = 0.
JSON odpověď:

HTTP/1.1 201
Content-type: application/json; 

{
    "code": 201,
    "message": "",
    "data": {
        "id": 1
    }
}
Popis polí odpovědi:
Klíč Typ Komentář
id int Id kategorie v systému fulfillment.cz
Popis:

editace kategorie

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/product-categories/<id>

JSON požadavek:

PUT https://client.api.fulfillment.cz/v2/fulfillment/product-categories/<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "name": "Pro muže",
    "parent": 0
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
name string Ano Název kategorie
parent int Ano ID nadřazené kategorie. Nejvyšší stupeň kategorií je zapsán jako parent = 0.
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": ""
}
Popis:

smazání kategorie

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/product-categories/<id>

JSON požadavek:

DELETE https://client.api.fulfillment.cz/v2/fulfillment/product-categories/<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)


JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": ""
}

Popis:

seznam dodavatelů

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/suppliers?limit=100&offset=0

JSON požadavek:

GET https://client.api.fulfillment.cz/v2/fulfillment/suppliers?limit=30&offset=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string Ne ID dodavatele (UUID) — pro zobrazení pouze konkrétního dodavatele
remote_id string Ne Externí ID/číslo dodavatele — pro zobrazení pouze konkrétního dodavatele
limit int Ne Počet požadovaných záznamů. Defaultní hodnota = 100. Maximální hodnota = 1000.
offset int Ne Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": "",
    "totalCount": 10,
    "data": [
        {
            "id": "3f9a1e2c-5b7d-4e1a-9b2c-1f8a3d4b5c6e",
            "name": "ACME s.r.o.",
            "remote_id": "DOD-001",
            "cin": "12345678",
            "tin": "CZ12345678",
            "created": "2025-03-04 12:12:13"
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id string ID dodavatele (UUID)
name string Název dodavatele
remote_id string|null Externí ID/číslo dodavatele
cin string IČ
tin string DIČ
created string Datum vytvoření
Popis:

vytváření dodavatelů

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/suppliers

JSON požadavek:

POST https://client.api.fulfillment.cz/v2/fulfillment/suppliers HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "name": "ACME s.r.o.",
    "remote_id": "DOD-001",
    "cin": "12345678",
    "tin": "CZ12345678"
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
name string Ano Název dodavatele
remote_id string|null Ne Externí ID/číslo dodavatele
cin string Ne IČ
tin string Ne DIČ
JSON odpověď:

HTTP/1.1 201
Content-type: application/json; 

{
    "code": 201,
    "message": "",
    "data": {
        "id": "3f9a1e2c-5b7d-4e1a-9b2c-1f8a3d4b5c6e"
    }
}
Popis polí odpovědi:
Klíč Typ Komentář
id string ID dodavatele (UUID) v systému fulfillment.cz
Popis:

editace dodavatele

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/suppliers?id=<id>

JSON požadavek:

PUT https://client.api.fulfillment.cz/v2/fulfillment/suppliers?id=<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

Dodavatele lze identifikovat parametrem id (UUID) nebo remote_id (externí ID). Alespoň jeden z nich je povinný.

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string Ne2 ID dodavatele (UUID)
remote_id string Ne2 Externí ID/číslo dodavatele

2 povinný je alespoň jeden z parametrů id nebo remote_id

{
    "name": "ACME s.r.o.",
    "remote_id": "DOD-001",
    "cin": "12345678",
    "tin": "CZ12345678"
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
name string Ano Název dodavatele
remote_id string|null Ne Externí ID/číslo dodavatele
cin string Ne IČ
tin string Ne DIČ
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": ""
}
Popis:

smazání dodavatele

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/suppliers?id=<id>

JSON požadavek:

DELETE https://client.api.fulfillment.cz/v2/fulfillment/suppliers?id=<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

Dodavatele lze identifikovat parametrem id (UUID) nebo remote_id (externí ID). Alespoň jeden z nich je povinný.

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string Ne2 ID dodavatele (UUID)
remote_id string Ne2 Externí ID/číslo dodavatele

2 povinný je alespoň jeden z parametrů id nebo remote_id


JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": ""
}

Popis:

seznam prodejních kanálů

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/channels?limit=100&offset=0

JSON požadavek:

GET https://client.api.fulfillment.cz/v2/fulfillment/channels?limit=30&offset=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string Ne ID prodejního kanálu (UUID) — pro zobrazení pouze konkrétního kanálu
ext_id string Ne Externí ID prodejního kanálu — pro zobrazení pouze konkrétního kanálu
limit int Ne Počet požadovaných záznamů. Defaultní hodnota = 100. Maximální hodnota = 1000.
offset int Ne Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": "",
    "totalCount": 2,
    "data": [
        {
            "id": "9c2f3a4b-1d2e-4f5a-8b9c-0d1e2f3a4b5c",
            "ext_id": "shop_42",
            "name": "uzasne-darky.cz"
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id string ID prodejního kanálu (UUID)
ext_id string|null Externí ID prodejního kanálu
name string Název prodejního kanálu
Popis:

vytváření prodejních kanálů

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/channels

JSON požadavek:

POST https://client.api.fulfillment.cz/v2/fulfillment/channels HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "ext_id": "shop_42",
    "name": "uzasne-darky.cz"
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
ext_id string|null Ne Externí ID prodejního kanálu z Vašeho systému. Musí být unikátní v rámci Vašeho účtu.
name string Ano Název prodejního kanálu. Musí být unikátní v rámci Vašeho účtu.
JSON odpověď:

HTTP/1.1 201
Content-type: application/json; 

{
    "code": 201,
    "message": "",
    "data": {
        "id": "9c2f3a4b-1d2e-4f5a-8b9c-0d1e2f3a4b5c"
    }
}
Popis polí odpovědi:
Klíč Typ Komentář
id string ID prodejního kanálu (UUID) v systému fulfillment.cz
Popis:

editace prodejního kanálu

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/channels?id=<id>

JSON požadavek:

PUT https://client.api.fulfillment.cz/v2/fulfillment/channels?id=<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

Prodejní kanál lze identifikovat parametrem id (UUID) nebo ext_id (externí ID). Alespoň jeden z nich je povinný.

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string Ne2 ID prodejního kanálu (UUID)
ext_id string Ne2 Externí ID prodejního kanálu

2 povinný je alespoň jeden z parametrů id nebo ext_id

{
    "ext_id": "shop_42",
    "name": "uzasne-darky.cz"
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
ext_id string|null Ne Externí ID prodejního kanálu. Pokud klíč v požadavku neuvedete, stávající hodnota zůstane zachována.
name string Ano Název prodejního kanálu
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": ""
}
Popis:

smazání prodejního kanálu

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/channels?id=<id>

JSON požadavek:

DELETE https://client.api.fulfillment.cz/v2/fulfillment/channels?id=<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

Prodejní kanál lze identifikovat parametrem id (UUID) nebo ext_id (externí ID). Alespoň jeden z nich je povinný.

Kanál navázaný na existující objednávky nelze smazat (odpověď 409).

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string Ne2 ID prodejního kanálu (UUID)
ext_id string Ne2 Externí ID prodejního kanálu

2 povinný je alespoň jeden z parametrů id nebo ext_id


JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": ""
}


Příjem

Popis:

seznam předskladnění

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/warehouse-preloads?limit=100&offset=0

JSON požadavek:

GET https://client.api.fulfillment.cz/v2/fulfillment/warehouse-preloads?limit=30&offset=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string Ne ID předskladnění
ids array Ne ID množiny předskladnění
uuid string Ne UUID4 předskladnění
uuids array Ne UUID4 množiny předskladnění
ext_id string Ne Externí identifikátor předskladnění
ext_ids array Ne Externí identifikátory množiny předskladnění. Lze opakovat: ?ext_ids[]=ERP000123&ext_ids[]=ERP000124.
ext_code string Ne Externí kód předskladnění
ext_codes array Ne Externí kódy množiny předskladnění. Lze opakovat: ?ext_codes[]=123456&ext_codes[]=123457.
type string Ne Typ předskladnění
created_from string Ne Datum vytvoření OD ve formátu "Y-m-d"
created_to string Ne Datum vytvoření DO ve formátu "Y-m-d"
limit int Ne Počet požadovaných záznamů. Defaultní hodnota = 100. Maximální hodnota = 1000.
offset int Ne Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": "",
    "totalCount": 1,
    "data": [
        {
            "id": 1,
            "uuid": "7b73a4a1-ef89-4574-9321-d4134414ced5",
            "type": "default",
            "fulfillment_order_id": "5c55ccac-3f88-4c71-a897-0f114d6cbd5f",
            "fulfillment_order_number": "FF2305302419",
            "fulfillment_order_remote_id": null,
            "fulfillment_order_remote_number": "ERP000123",
            "ext_id": "38582ff4-b6ce-4a1e-acfb-5085b73fdbf1",
            "ext_code": "123456",
            "closed": true,
            "extra_cost": 0,
            "note": "Poznámka pro sklad",
            "client_note": "Vaše interní poznámka",
            "receiving_note": "poznámka k naskladnění",
            "date_of_delivery": "2026-12-31",
            "items": [
                {
                    "variant_id": 1,
                    "code": "DS12345678",
                    "ext_code": "123",
                    "price_per_unit": 99.99,
                    "quantity": 3,
                    "received_quantity": 2,
                    "damaged_quantity": 1,
                    "received_damaged_quantity": 2,
                    "photos": ["https://cdn.fulfillment.cz/images/9/3/4/f/a/a/e/a/1/0/b31ea2df5b933d6cf9b661.png"]
                }
            ],
            "stock_items": [
                {
                    "variant_id": 1,
                    "code": "DS12345678",
                    "ext_code": "123",
                    "inventory_id": "d52f6096-e0c0-4d86-9075-85a3147c815c",
                    "quality": 1,
                    "expiration": "2030-12-31",
                    "batch_number": null,
                    "lot_id": null,
                    "received_quantity": 1,
                    "serial_numbers": ["SN1"]
                },
                {
                    "variant_id": 1,
                    "code": "DS12345678",
                    "ext_code": "123",
                    "inventory_id": "d52f6096-e0c0-4d86-9075-85a3147c815c",
                    "quality": 1,
                    "expiration": "2028-12-31",
                    "batch_number": null,
                    "lot_id": null,
                    "received_quantity": 1,
                    "serial_numbers": ["SN2"]
                },
                {
                    "variant_id": 1,
                    "code": "DS12345678",
                    "ext_code": "123",
                    "inventory_id": "d52f6096-e0c0-4d86-9075-85a3147c815c",
                    "quality": 0,
                    "expiration": "2028-12-31",
                    "batch_number": null,
                    "lot_id": null,
                    "received_quantity": 1,
                    "serial_numbers": []
                }
            ],
            "packages": [
                {
                    "barcode": "123456789"
                }
            ],
            "delivery_units": [
                {
                    "id": "d323b5e9-bab6-4d67-9550-0b93b63c8265",
                    "size_id": "L1",
                    "closed": false,
                }
            ],
            "notes": [
                {
                    "text": "Text poznamky"
                    "created": "2022-01-31 08:01:01"
                }
            ],
            "received_at": "2022-03-04"
            "created_at": "2025-03-04 12:12:13"
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id int ID předskladnění
uuid string UUID4 předskladnění
type string Typ předskladnění
  • default => klasické/plánované předskladnění
  • carrierReturn => vráceno dopravcem
  • customerWithdrawal => vráceno zákazníkem
  • warrantyClaim => reklamace
fulfillment_order_id string|NULL ID FF objednávky
fulfillment_order_number string|NULL Číslo FF objednávky
fulfillment_order_remote_id string|NULL ID externí objednávky
fulfillment_order_remote_number string|NULL Číslo externí objednávky
ext_id string|NULL Externí identifikátor předskladnění (např. číslo Příjemky z ERP)
ext_code string|NULL Externí číslo předskladnění (např. číslo Příjemky z ERP)
closed bool Je předskladnění uzavřeno?
extra_cost float Náklady naskladnění bez DPH
note string Poznámka pro sklad
client_note string Vaše interní poznámka
receiving_note string Poznámka k naskladnění. Depricated - pro poznámky k naskladnění viz notes[]
date_of_delivery string Předpokládaný datum dodání
items[].variantId int Id produktu ze systému fulfillment.cz
items[].code string Kód produktu ze systému fulfillment.cz
items[].ext_code string Kód produktu dodavatele
items[].price_per_unit float Cena za kus bez DPH
items[].quantity int Počet kusů
items[].received_quantity int|NULL Počet nepoškozených kusů, které byly reálně naskladněny. Pokud je hodnota NULL, k naskladnění zatím nedošlo
items[].damaged_quantity int|NULL Počet kusů, které jsou poškozeny. Pokud je hodnota NULL, zatím nedošlo k naskladnění
items[].received_damaged_quantity int|NULL Počet poškozených kusů, které byly reálně naskladněny. Pokud je hodnota NULL, k naskladnění zatím nedošlo
items[].photos array Foto dokumentace, z pravidla v případě přijetí poškozených kusů
stock_items[].variantId int Id produktu ze systému fulfillment.cz
stock_items[].code string Kód produktu ze systému fulfillment.cz
stock_items[].ext_code string Kód produktu dodavatele
stock_items[].inventory_id int Inventář produktu
stock_items[].quality int Kvalita produktu (0 = poškozený, 1 = nepoškozený)
stock_items[].expiration string|NULL Datum expirace produktu (Y-m-d). Pokud je hodnota NULL, expirace není nastavena.
stock_items[].batch_number string|NULL Číslo šarže produktu. Pokud je hodnota NULL, šarže není nastavena.
stock_items[].lot_id string|NULL Lot ID produktu. Pokud je hodnota NULL, Lot ID není nastaveno.
stock_items[].received_quantity int Počet kusů, které byly reálně naskladněny.
packages[].barcode string Sledovací číslo balíku
delivery_units array Seznam naskladněných balíku
delivery_units[].id string UUID4 balíku
delivery_units[].size_id string|NULL Velikost balíku
delivery_units[].closed bool Bylo naskladnění balíku definitivně uzavřeno?
notes[].text string Text poznámky
notes[].created string Datum a čas vytvoření poznámky (Y-m-d H:i:s)
received_at string|NULL Datum posledního naskladnění (Y-m-d)
created_at string|NULL Datum vytvoření (Y-m-d H:i:s)
Popis:

vytváření předskladnění

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/warehouse-preloads

JSON požadavek:

POST https://client.api.fulfillment.cz/v2/fulfillment/warehouse-preloads HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "ext_id": "ba73abe4-a101-4c9c-9f05-592d0761bb83",
    "ext_code": "OS123456789",
    "type": "default",
    "supplier_id": null,
    "supplier_remote_id": "123",
    "fulfillment_order_id": null,
    "fulfillment_order_remote_id": null,
    "fulfillment_order_remote_number": null,
    "extra_cost": 0,
    "note": "Poznámka pro sklad",
    "client_note": "Vaše interní poznámka",
    "date_of_delivery": "2026-12-31",
    "items": [
        {
            "code": "DS12345678",
            "ext_code": null,
            "price_per_unit": 99.99,
            "quantity": 3,
            "damaged_quantity": 1,
            "expiration": "2026-12-31",
            "batch_number": "B-2026-001",
            "lot_id": null,
            "damaged_quality": null
        }
    ],
    "packages": [
        {
            "barcode": "123456789"
        }
    ]
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
ext_id string|NULL Ne Externí identifikátor předskladnění (např. ID Příjemky z ERP)
ext_code string|NULL Ne Externí kód předskladnění (např. číslo Příjemky z ERP)
type string|NULL Ne Typ předskladnění
  • default => klasické/plánované předskladnění
  • carrierReturn => vráceno dopravcem
  • customerWithdrawal => vráceno zákazníkem
  • warrantyClaim => reklamace
supplier_id string|NULL Ne FF ID dodavatele
supplier_remote_id string|NULL Ne Externí ID dodavatele
fulfillment_order_id string|NULL Ne ID FF objednávky (pro párování objednávky použijte jeden ze tří identifikátorů.)
fulfillment_order_remote_id string|NULL Ne ID externí objednávky (pro párování objednávky použijte jeden ze tří identifikátorů.)
fulfillment_order_remote_number string|NULL Ne Číslo externí objednávky (pro párování objednávky použijte jeden ze tří identifikátorů.)
extra_cost float Ano Náklady naskladnění bez DPH
note string Ne Poznámka pro sklad
client_note string Ne Vaše interní poznámka
date_of_delivery string Ano Předpokládaný datum dodání
items[].code string Podm. Kód produktu ze systému fulfillment.cz. Nepovinné, pokud je uvedeno ext_code produktu
items[].ext_code string Podm. Kód produktu dodavatele. Nepovinné, pokud je uvedeno code produktu
items[].price_per_unit float Ano Cena za kus bez DPH
items[].quantity int Ano Počet kusů
items[].damaged_quantity int Ano Počet kusů poškozeno
items[].expiration string|NULL Ne Datum expirace šarže ve formátu YYYY-MM-DD. Lze zadat pouze u variant, které mají povolené sledování expirace.
items[].batch_number string|NULL Ne Číslo šarže. Lze zadat pouze u variant, které mají povolené sledování čísla šarže.
items[].lot_id string|NULL Ne LOT ID. Lze zadat pouze u variant, které mají povolené sledování LOT ID.
items[].damaged_quality int|NULL Ne Stupeň kvality poškozených kusů — číselný kód z číselníku kvalit klienta (0 = zničeno, 2-n individuální).
packages[].barcode string Ne Sledovací číslo balíků
JSON odpověď:

HTTP/1.1 201
Content-type: application/json; 

{
    "code": 201,
    "message": "",
    "data": {
        "id": 1,
        "uuid": "fd8e4a3c-4892-4da9-958c-5cbbc1ffca07"
    }
}
Popis polí odpovědi:
Klíč Typ Komentář
id int Id předskladnění v systému fulfillment.cz
uuid int UUID4 předskladnění
Popis:

editace předskladnění

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/warehouse-preloads/<id>

JSON požadavek:

PUT https://client.api.fulfillment.cz/v2/fulfillment/warehouse-preloads/<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "ext_id": "ba73abe4-a101-4c9c-9f05-592d0761bb83",
    "ext_code": "OS123456789",
    "type": "default",
    "supplier_id": null,
    "supplier_remote_id": "123",
    "fulfillment_order_id": null,
    "fulfillment_order_remote_id": null,
    "fulfillment_order_remote_number": null,
    "extra_cost": 0,
    "note": "Poznámka pro sklad",
    "client_note": "Vaše interní poznámka",
    "date_of_delivery": "2026-12-31",
    "items": [
        {
            "code": "DS12345678",
            "ext_code": null,
            "price_per_unit": 99.99,
            "quantity": 3,
            "damaged_quantity": 1,
            "expiration": "2026-12-31",
            "batch_number": "B-2026-001",
            "lot_id": null,
            "damaged_quality": null
        }
    ],
    "packages": [
        {
            "barcode": "123456789"
        }
    ]
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
ext_id string|NULL Ne Externí identifikátor předskladnění (např. číslo Příjemky z ERP)
ext_code string|NULL Ne Externí kód předskladnění (např. číslo Příjemky z ERP)
type string|NULL Ne Typ předskladnění
  • default => klasické/plánované předskladnění
  • carrierReturn => vráceno dopravcem
  • customerWithdrawal => vráceno zákazníkem
  • warrantyClaim => reklamace
supplier_id string|NULL Ne FF ID dodavatele
supplier_remote_id string|NULL Ne Externí ID dodavatele
fulfillment_order_id string|NULL Ne ID FF objednávky (pro párování objednávky použijte jeden ze tří identifikátorů.)
fulfillment_order_remote_id string|NULL Ne ID externí objednávky (pro párování objednávky použijte jeden ze tří identifikátorů.)
fulfillment_order_remote_number string|NULL Ne Číslo externí objednávky (pro párování objednávky použijte jeden ze tří identifikátorů.)
extra_cost float Ano Náklady naskladnění bez DPH
note string Ne Poznámka pro sklad
client_note string Ne Vaše interní poznámka
date_of_delivery string Ano Předpokládaný datum dodání
items[].code string Podm. Kód produktu ze systému fulfillment.cz. Nepovinné, pokud je uvedeno ext_code produktu
items[].ext_code string Podm. Kód produktu dodavatele. Nepovinné, pokud je uvedeno code produktu
items[].price_per_unit float Ano Cena za kus bez DPH
items[].quantity int Ano Počet kusů
items[].damaged_quantity int Ano Počet kusů poškozeno
items[].expiration string|NULL Ne Datum expirace šarže ve formátu YYYY-MM-DD. Lze zadat pouze u variant, které mají povolené sledování expirace.
items[].batch_number string|NULL Ne Číslo šarže. Lze zadat pouze u variant, které mají povolené sledování čísla šarže.
items[].lot_id string|NULL Ne LOT ID. Lze zadat pouze u variant, které mají povolené sledování LOT ID.
items[].damaged_quality int|NULL Ne Stupeň kvality poškozených kusů — číselný kód z číselníku kvalit klienta (0 = zničeno, 2-n individuální).
packages[].barcode string Ne Sledovací číslo balíků
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": ""
}
Popis:

úprava statických dat

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/warehouse-preloads/<id>

JSON požadavek:

PATCH https://client.api.fulfillment.cz/v2/fulfillment/warehouse-preloads/<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json 

{
    "client_note": "Vaše interní poznámka",
}
Popis polí požadavku:
client_note string Ano Vaše interní poznámka
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": ""
}
Popis:

smazání předskladnění

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/warehouse-preloads/<id>

JSON požadavek:

DELETE https://client.api.fulfillment.cz/v2/fulfillment/warehouse-preloads/<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)


JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": ""
}

Popis:

seznam událostí předskladnění.

Endpoint vrací maximálně 1000 událostí na jedno volání. Pokud odpověď obsahuje 1000 záznamů, je pravděpodobné, že existují další — opakujte volání s lastSeenId = poslední internal_id z předchozí odpovědi, dokud nedostanete méně než 1000.

Pozn.: Pole internal_id není souvislá řada — mezery v číslování jsou normální. Spoléhejte pouze na vzestupné řazení a stránkujte podle posledního vráceného internal_id.

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/warehouse-preload-event-store?lastSeenId=0

JSON požadavek:

GET https://client.api.fulfillment.cz/v2/fulfillment/warehouse-preload-event-store?lastSeenId=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
lastSeenId int Ano Kurzor — vrací se pouze události s internal_id > lastSeenId, řazené vzestupně. Pro první volání použijte 0. Pro stránkování použijte poslední internal_id z předchozí odpovědi.
eventTypes[] array Ne Filtr na typy událostí. Bez filtru se vrací všechny typy. Lze opakovat: ?eventTypes[]=PreloadClosed&eventTypes[]=DeliveryUnitReceived. Přehled povolených hodnot viz záložky PreloadClosed a DeliveryUnitReceived.
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": "",
    "data": [
        {
            "internal_id": 12,
            "event_type": "PreloadClosed",
            "data": {
                "id": 12345,
                "uuid": "38582ff4-b6ce-4a1e-acfb-5085b73fdbf1",
                "ext_id": "ERP000123",
                "ext_code": "123456"
            },
            "created": "2026-05-18 14:54:25"
        },
        {
            "internal_id": 17,
            "event_type": "DeliveryUnitReceived",
            "data": {
                "id": 12345,
                "uuid": "38582ff4-b6ce-4a1e-acfb-5085b73fdbf1",
                "ext_id": "ERP000123",
                "ext_code": "123456",
                "delivery_unit_id": "7cad37e9-2624-480d-8c5f-68985522e7d0"
            },
            "created": "2026-05-18 14:57:22"
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
internal_id int Interní pořadové ID události. Slouží jako kurzor pro stránkování přes lastSeenId.
event_type string Typ události. Přehled povolených hodnot a význam viz záložky PreloadClosed a DeliveryUnitReceived.
data object Payload události. Struktura se liší podle event_type — viz odpovídající záložka.
created string Datum a čas vzniku události (Y-m-d H:i:s).
Popis:

předskladnění bylo ukončeno (uzavřeno)

Ukázka payloadu: 
{
    "internal_id": 12,
    "event_type": "PreloadClosed",
    "data": {
        "id": 12345,
        "uuid": "38582ff4-b6ce-4a1e-acfb-5085b73fdbf1",
        "ext_id": "ERP000123",
        "ext_code": "123456"
    },
    "created": "2026-05-18 14:54:25"
}
Popis polí payloadu:
Klíč Typ Komentář
data.id int Interní ID předskladnění (shoduje se s polem id v /warehouse-preloads).
data.uuid string UUID4 předskladnění (shoduje se s uuid v /warehouse-preloads).
data.ext_id string|null Externí identifikátor předskladnění (shoduje se s polem ext_id v /warehouse-preloads).
data.ext_code string|null Externí kód předskladnění (shoduje se s polem ext_code v /warehouse-preloads).
Popis:

v rámci předskladnění byl přijat jeden balík (delivery unit)

Ukázka payloadu: 
{
    "internal_id": 17,
    "event_type": "DeliveryUnitReceived",
    "data": {
        "id": 12345,
        "uuid": "38582ff4-b6ce-4a1e-acfb-5085b73fdbf1",
        "ext_id": "ERP000123",
        "ext_code": "123456",
        "delivery_unit_id": "7cad37e9-2624-480d-8c5f-68985522e7d0"
    },
    "created": "2026-05-18 14:57:22"
}
Popis polí payloadu:
Klíč Typ Komentář
data.id int Interní ID předskladnění (shoduje se s polem id v /warehouse-preloads).
data.uuid string UUID4 předskladnění (shoduje se s uuid v /warehouse-preloads).
data.ext_id string|null Externí identifikátor předskladnění (shoduje se s polem ext_id v /warehouse-preloads).
data.ext_code string|null Externí kód předskladnění (shoduje se s polem ext_code v /warehouse-preloads).
data.delivery_unit_id string UUID4 přijatého balíku v rámci předskladnění.

Transformace

Popis:

seznam transformací

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/warehouse-reloads?limit=100&offset=0

JSON požadavek:

GET https://client.api.fulfillment.cz/v2/fulfillment/warehouse-reloads?limit=30&offset=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string Ne ID transformace
ids array Ne ID množiny transformací
uuid string Ne UUID4 transformace
uuids array Ne UUID4 množiny transformací
ext_id string Ne Externí identifikátor transformace
created_from string Ne Datum vytvoření OD ve formátu "Y-m-d"
created_to string Ne Datum vytvoření DO ve formátu "Y-m-d"
limit int Ne Počet požadovaných záznamů. Defaultní hodnota = 100. Maximální hodnota = 1000.
offset int Ne Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": "",
    "totalCount": 1,
    "data": [
        {
            "id": 1,
            "uuid": "7b73a4a1-ef89-4574-9321-d4134414ced5",
            "ext_id": "38582ff4-b6ce-4a1e-acfb-5085b73fdbf1",
            "ext_code": "TR2026001",
            "status": "created",
            "outbound_items": [
                {
                    "variant_id": 1,
                    "code": "DS12345678",
                    "ext_code": "123",
                    "quantity": 3,
                    "damaged_quantity": 1
                }
            ],
            "outbound_stock_items": [
                {
                    "variant_id": 1,
                    "code": "DS12345678",
                    "ext_code": "123",
                    "quantity": 3,
                    "inventory_id": "d52f6096-e0c0-4d86-9075-85a3147c815c",
                    "quality": 1,
                    "expiration": "2030-12-31",
                    "batch_number": null,
                    "lot_id": null,
                    "serial_numbers": ["SN1", "SN2", "SN3"]
                },
                {
                    "variant_id": 1,
                    "code": "DS12345678",
                    "ext_code": "123",
                    "quantity": 1,
                    "inventory_id": "d52f6096-e0c0-4d86-9075-85a3147c815c",
                    "quality": 2,
                    "expiration": "2030-12-31",
                    "batch_number": null,
                    "lot_id": null,
                    "serial_numbers": []
                }
            ],
            "inbound_items": [
                {
                    "variant_id": 2,
                    "code": "DS87654321",
                    "ext_code": "321",
                    "price_per_unit": 99.99,
                    "quantity": 3,
                    "damaged_quantity": 1,
                    "damaged_quality": 2,
                    "expiration": "2030-12-31",
                    "batch_number": "B-2026-001",
                    "lot_id": null,
                    "serial_numbers": []
                }
            ],
            "inbound_stock_items": [
                {
                    "variant_id": 2,
                    "code": "DS87654321",
                    "ext_code": "321",
                    "price_per_unit": 99.99,
                    "quantity": 3,
                    "inventory_id": "d52f6096-e0c0-4d86-9075-85a3147c815c",
                    "quality": 1,
                    "expiration": "2030-12-31",
                    "batch_number": "B-2026-001",
                    "lot_id": null,
                    "serial_numbers": ["SN10", "SN11", "SN12"]
                }
            ],
            "created_at": "2026-03-04 12:12:13"
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id int ID transformace
uuid string UUID4 transformace
ext_id string|NULL Externí identifikátor transformace (např. ID z ERP)
ext_code string|NULL Externí číslo transformace (např. číslo dokladu z ERP)
status string Stav transformace
  • created => vytvořeno, čeká na zpracování
  • processing => v procesu (sklad začal zpracovávat)
  • finished => dokončeno
  • canceled => zrušeno
outbound_items[].variant_id int ID varianty, která jde ze skladu ven (vstup transformace)
outbound_items[].code string Kód varianty ze systému fulfillment.cz
outbound_items[].ext_code string|NULL Externí kód varianty
outbound_items[].quantity int Souhrnný počet nepoškozených kusů agregovaný napříč všemi outbound_stock_items (quality = 1)
outbound_items[].damaged_quantity int Souhrnný počet poškozených kusů agregovaný napříč všemi outbound_stock_items (quality ≠ 1)
outbound_stock_items[].variant_id int ID varianty
outbound_stock_items[].code string Kód varianty
outbound_stock_items[].ext_code string|NULL Externí kód varianty
outbound_stock_items[].quantity int Počet kusů ze skladového záznamu, které jdou ven
outbound_stock_items[].inventory_id string UUID4 inventáře skladového záznamu
outbound_stock_items[].quality int Kvalita kusů (1 = nepoškozené, 0 = zničeno, 2-n = individuální stupeň poškození klienta)
outbound_stock_items[].expiration string|NULL Expirace skladového záznamu ve formátu Y-m-d
outbound_stock_items[].batch_number string|NULL Číslo šarže skladového záznamu
outbound_stock_items[].lot_id string|NULL LOT ID skladového záznamu
outbound_stock_items[].serial_numbers array Pole sériových čísel kusů, které byly fyzicky vydány. Naplní se až ve stavu processing/finished, jinak prázdné.
inbound_items[].variant_id int ID varianty, která jde do skladu (výstup transformace)
inbound_items[].code string Kód varianty
inbound_items[].ext_code string|NULL Externí kód varianty
inbound_items[].price_per_unit float Cena za kus bez DPH (plánovaná hodnota při zadání transformace)
inbound_items[].quantity int Plánovaný počet nepoškozených kusů
inbound_items[].damaged_quantity int Plánovaný počet poškozených kusů
inbound_items[].damaged_quality int|NULL Stupeň kvality poškozených kusů (0 = zničeno, 2-n = individuální). NULL = nezadáno.
inbound_items[].expiration string|NULL Plánovaná expirace ve formátu Y-m-d
inbound_items[].batch_number string|NULL Plánované číslo šarže
inbound_items[].lot_id string|NULL Plánované LOT ID
inbound_items[].serial_numbers array Vždy prázdné pole. Pro skutečně přijatá sériová čísla viz inbound_stock_items[].serial_numbers (naplní se po dokončení).
inbound_stock_items[].variant_id int ID varianty
inbound_stock_items[].code string Kód varianty
inbound_stock_items[].ext_code string|NULL Externí kód varianty
inbound_stock_items[].price_per_unit float Skutečná cena za kus skladového záznamu po naskladnění
inbound_stock_items[].quantity int Počet kusů, které byly skutečně přijaty pro tento skladový záznam
inbound_stock_items[].inventory_id string UUID4 inventáře skladového záznamu
inbound_stock_items[].quality int Kvalita kusů (1 = nepoškozené, 0 = zničeno, 2-n = individuální stupeň poškození klienta)
inbound_stock_items[].expiration string|NULL Skutečná expirace přijatých kusů ve formátu Y-m-d
inbound_stock_items[].batch_number string|NULL Skutečné číslo šarže přijatých kusů
inbound_stock_items[].lot_id string|NULL Skutečné LOT ID přijatých kusů
inbound_stock_items[].serial_numbers array Pole sériových čísel kusů, které byly fyzicky přijaty. Pole je prázdné, dokud transformace není ve stavu processing/finished.
created_at string Datum a čas vytvoření transformace (Y-m-d H:i:s)

* Pole inbound_stock_items je naplněno až ve chvíli, kdy sklad začne transformaci skutečně zpracovávat. Pro nově vytvořené transformace (status = created) bude prázdné.

Popis:

vytvoření transformace (přeměna vstupních variant ze skladu na výstupní varianty)

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/warehouse-reloads

JSON požadavek:

POST https://client.api.fulfillment.cz/v2/fulfillment/warehouse-reloads HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "ext_id": "ba73abe4-a101-4c9c-9f05-592d0761bb83",
    "ext_code": "TR2026001",
    "outboundItems": [
        {
            "code": "DS12345678",
            "ext_code": null,
            "quantity": 3,
            "damaged_quantity": 1,
            "damaged_quality": 2,
            "inventoryId": "d52f6096-e0c0-4d86-9075-85a3147c815c",
            "expiration": "2026-12-31",
            "batch_number": null,
            "lot_id": null
        }
    ],
    "inboundItems": [
        {
            "code": "DS87654321",
            "ext_code": null,
            "price_per_unit": 99.99,
            "quantity": 3,
            "damaged_quantity": 1,
            "damaged_quality": 2,
            "inventoryId": "d52f6096-e0c0-4d86-9075-85a3147c815c",
            "expiration": "2026-12-31",
            "batch_number": "B-2026-001",
            "lot_id": null,
            "fifo": null,
            "serial_number": null
        }
    ]
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
ext_id string|NULL Ne Externí identifikátor transformace (např. ID dokladu z ERP). Musí být unikátní.
ext_code string|NULL Ne Externí kód transformace (např. číslo dokladu z ERP)
outboundItems — vstupy transformace (co se odebere ze skladu)
outboundItems[].variantId int Podm. FF ID varianty. Nepovinné, pokud je uvedeno code nebo ext_code.
outboundItems[].code string Podm. FF kód varianty. Nepovinné, pokud je uvedeno variantId nebo ext_code.
outboundItems[].ext_code string Podm. Externí kód varianty. Nepovinné, pokud je uvedeno variantId nebo code.
outboundItems[].quantity int Ano Počet nepoškozených kusů (sklad vybere stocky s quality = 1)
outboundItems[].damaged_quantity int Ne Počet poškozených kusů (sklad vybere stocky s quality = damaged_quality)
outboundItems[].damaged_quality int|NULL Ne Stupeň kvality poškozených kusů. Povolené hodnoty: 0 (zničeno) nebo 2-n (individuální stupeň z číselníku klienta). Hodnota 1 je rezervovaná pro nepoškozené a není povolena. Default 0 (zničeno) pokud chybí nebo NULL.
outboundItems[].inventoryId string|NULL Ne UUID4 inventáře, ze kterého se má vybírat. Defaultní inventář pokud chybí.
outboundItems[].expiration string|NULL Ne Cílová expirace ve formátu Y-m-d (pro výběr konkrétních stocků). Lze zadat pouze u variant, které mají povolené sledování expirace.
outboundItems[].batch_number string|NULL Ne Cílové číslo šarže. Lze zadat pouze u variant, které mají povolené sledování čísla šarže.
outboundItems[].lot_id string|NULL Ne Cílové LOT ID. Lze zadat pouze u variant, které mají povolené sledování LOT ID.
inboundItems — výstupy transformace (co se naskladní)
inboundItems[].variantId int Podm. FF ID varianty. Nepovinné, pokud je uvedeno code nebo ext_code.
inboundItems[].code string Podm. FF kód varianty. Nepovinné, pokud je uvedeno variantId nebo ext_code.
inboundItems[].ext_code string Podm. Externí kód varianty. Nepovinné, pokud je uvedeno variantId nebo code.
inboundItems[].price_per_unit float Ne Cena za kus bez DPH (nákladová cena vstupující do skladu). Default 0.1 pokud chybí.
inboundItems[].quantity int Ano Počet nepoškozených kusů, které mají vzniknout
inboundItems[].damaged_quantity int Ne Počet poškozených kusů, které mají vzniknout
inboundItems[].damaged_quality int|NULL Ne Stupeň kvality poškozených kusů. Povolené hodnoty: 0 (zničeno) nebo 2-n (individuální stupeň z číselníku klienta). Hodnota 1 je rezervovaná pro nepoškozené a není povolena.
inboundItems[].inventoryId string|NULL Ne UUID4 cílového inventáře. Defaultní inventář pokud chybí. Všechny inboundItems musí mít stejný inventář.
inboundItems[].expiration string|NULL Ne Expirace nově vzniklých kusů ve formátu Y-m-d. Lze zadat pouze u variant, které mají povolené sledování expirace.
inboundItems[].batch_number string|NULL Ne Číslo šarže nově vzniklých kusů. Lze zadat pouze u variant, které mají povolené sledování čísla šarže.
inboundItems[].lot_id string|NULL Ne LOT ID nově vzniklých kusů. Lze zadat pouze u variant, které mají povolené sledování LOT ID.
inboundItems[].fifo string|NULL Ne FIFO datum ve formátu Y-m-d
inboundItems[].serial_number string|NULL Ne Sériové číslo (pouze pro varianty se sledováním sériových čísel)
JSON odpověď:

HTTP/1.1 201
Content-type: application/json; 

{
    "code": 201,
    "message": "",
    "data": {
        "id": 1,
        "uuid": "fd8e4a3c-4892-4da9-958c-5cbbc1ffca07"
    }
}
Popis polí odpovědi:
Klíč Typ Komentář
id int ID transformace v systému fulfillment.cz
uuid string UUID4 transformace
Popis:

editace transformace. Lze editovat pouze transformace ve stavu "created" (před zahájením zpracování skladem).

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/warehouse-reloads/<id>

JSON požadavek:

PUT https://client.api.fulfillment.cz/v2/fulfillment/warehouse-reloads/<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "ext_id": "ba73abe4-a101-4c9c-9f05-592d0761bb83",
    "ext_code": "TR2026001",
    "outboundItems": [
        {
            "code": "DS12345678",
            "ext_code": null,
            "quantity": 3,
            "damaged_quantity": 1,
            "damaged_quality": 2,
            "inventoryId": "d52f6096-e0c0-4d86-9075-85a3147c815c",
            "expiration": "2026-12-31",
            "batch_number": null,
            "lot_id": null
        }
    ],
    "inboundItems": [
        {
            "code": "DS87654321",
            "ext_code": null,
            "price_per_unit": 99.99,
            "quantity": 3,
            "damaged_quantity": 1,
            "damaged_quality": 2,
            "inventoryId": "d52f6096-e0c0-4d86-9075-85a3147c815c",
            "expiration": "2026-12-31",
            "batch_number": "B-2026-001",
            "lot_id": null,
            "fifo": null,
            "serial_number": null
        }
    ]
}
Popis polí požadavku:

Pole jsou identická s POST requestem — viz vytvoření transformace. Při editaci se kompletně přepíše stav outboundItems a inboundItems.

JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": ""
}
Popis:

zrušení transformace. Zruší lze pouze transformace ve stavu "created", které ještě nemají žádné skladové pohyby. Transformace nejde fyzicky smazat — pouze přejde do stavu "canceled".

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/warehouse-reloads/<id>

JSON požadavek:

DELETE https://client.api.fulfillment.cz/v2/fulfillment/warehouse-reloads/<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "reason": "Důvod zrušení transformace"
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
reason string Ne Důvod zrušení (uloží se k transformaci jako poznámka)

JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": ""
}

Popis:

seznam automatických transformací

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/transformation-replenishment

JSON požadavek:

GET https://client.api.fulfillment.cz/v2/fulfillment/transformation-replenishment HTTP/1.1
Authorization: TOKEN
Accept: application/json

JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": "",
    "totalCount": 2,
    "data": [
        {
            "variant_ext_code": "EXTCODE",
            "variant_limit_quantity": 10,
            "mastercase_code": "MASTERCASEEXTCODE",
            "mastercase_quantity": 2,
        },
        {
            "variant_ext_code": "EXTCODE2",
            "variant_limit_quantity": 3,
            "mastercase_code": "MASTERCASEEXTCODE2",
            "mastercase_quantity": 1,
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
variant_ext_code string Extérní kód varianty
variant_limit_quantity int Limitní počet kusů
mastercase_code string Kód mastercase varianty
mastercase_quantity int Počet kusů mastercasu.
Popis:

vytváření automatických transformací

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/transformation-replenishment

JSON požadavek:

POST https://client.api.fulfillment.cz/v2/fulfillment/transformation-replenishment HTTP/1.1
Authorization: TOKEN
Accept: application/json 

[
    {
        "variant_ext_code": "nontrackingsku",
        "variant_limit_quantity": 3,
        "mastercase_code": "dfgdfgfg",
        "mastercase_quantity": 33
    },
    {
        "variant_ext_code": "sdfsdt gsdf_c333",
        "variant_limit_quantity": 4,
        "mastercase_code": "123321123321123",
        "mastercase_quantity": 44
    }
]
Popis polí požadavku:
Klíč Typ Komentář
variant_ext_code string Extérní kód varianty
variant_limit_quantity int Limitní počet kusů
mastercase_code string Kód mastercase varianty
mastercase_quantity int Počet kusů mastercasu. Pro odstranění automatické transformace uveďte mastercase_quantity=0.
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": ""
}


Výdej

Popis:

seznam vašich objednávek

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/orders?limit=10&offset=0&sort=-created

JSON požadavek:

GET https://client.api.fulfillment.cz/v2/fulfillment/orders?limit=30&offset=0&sort=-created HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string Ne ID objednávky (pro zobrazení konkrétní objednávky)
ids array Ne ID objednávek (pro zobrazení konkrétních objednávek)
remote_number string Ne Číslo objednávky ze systému klienta
remote_numbers array Ne Čísla objednávek ze systému klienta (pro zobrazení konkrétních objednávek)
status string Ne Stav objednávky
created_from string Ne Datum vytvoření objednávky OD ve formátu "Y-m-d"
created_to string Ne Datum vytvoření objednávky DO ve formátu "Y-m-d"
limit int Ne Počet požadovaných záznamů. Defaultní hodnota = 30. Maximální hodnota = 100.
offset int Ne Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
sort string Ne Řazení záznámů. Směr řazení se určuje znakem "-" před názvem proměnné ("sort=created" = "created ASC"; "sort=-created" = "created DESC"). Defaultní řazení je "created ASC".
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": "",
    "totalCount": 10,
    "data": [
        {
            "id": "da8bfbcb-5916-4416-b310-ce8ce6c0c63f",
            "number": "FF2996255084",
            "remote_number": "123456789",
            "currency_id": "CZK",
            "channel": {
                "id": "9c2f3a4b-1d2e-4f5a-8b9c-0d1e2f3a4b5c",
                "ext_id": null,
                "name": "uzasne-darky.cz"
            },
            "on_hold": true,
            "sscc": false,
            "status": "problem_in_expedition",
            "status_note": "",
            "expedition": {
                "status": "problem",
                "problem": {
                    "source": "packing",
                    "description": "Produkt není k nalezení.",
                    "solution": NULL,
                    "postponed": true,
                    "photos": [],
                },
            },
            "recipient": {
                "email": "zakaznik@gmail.com",
                "phone": "777666555",
                "firstname": "Jan",
                "surname": "Novák",
                "street": "Korunní 21",
                "city": "Praha 2",
                "zipcode": "12800",
                "company": ""
            },
            "delivery": {
                "id": 25,
                "value": 999.0,
                "name": "DPD",
                "tracking_number": "xyz",
                "status": "inTransit"
            },
            "payment": {
                "cod": true,
                "variable_symbol": "1234567890",
                "price": 1001
            },
            "products": [
                {
                    "name": "Horké kameny",
                    "image": "https://cdn.fulfillment.cz/images/d/e/a/b/0/8/0/c/8/9/7c65758192e4f827ecxyz.png",
                    "code": "DS12345678",
                    "ext_code": 123,
                    "damaged_quantity": 1,
                    "non_damaged_quantity": 2,
                    "quantity": 3,
                    "reserved_quantity": 2,
                    "requested_quantity": 1
                }
            ],
            "stock_items": [
                {
                    "variant_id": 1,
                    "code": "DS12345678",
                    "ext_code": "123",
                    "inventory_id": "d52f6096-e0c0-4d86-9075-85a3147c815c",
                    "quality": 1,
                    "expiration": "2030-12-31",
                    "batch_number": null,
                    "lot_id": null,
                    "quantity": 3,
                    "reserved_quantity": 2,
                    "requested_quantity": 1,
                    "serial_numbers": ["SN1", "SN2", "SN3"]
                }
            ],
            "packages": [
                {
                    "id": "edae9cfa-c07f-4e28-ba9b-d6ba3fc90749",
                    "sscc": "",
                    "items": [
                        {
                            "variant_id": 123,
                            "code": "DS12345678",
                            "ext_code": "XYZ",
                            "quantity": 3
                        }
                    ],
                    "stock_items": [
                        {
                            "variant_id": 1,
                            "code": "DS12345678",
                            "ext_code": "123",
                            "inventory_id": "d52f6096-e0c0-4d86-9075-85a3147c815c",
                            "quality": 1,
                            "expiration": "2030-12-31",
                            "batch_number": null,
                            "lot_id": null,
                            "quantity": 3,
                            "serial_numbers": ["SN1", "SN2", "SN3"]
                        }
                    ],
                }
            ],
            "invoice": "JVBERi0xLjMNCiXi48/TDQoNCjE...",
            "damaged": false,
            "note": "Poznámka",
            "tickets": [
                {
                    "barcode": "DR0705127648C",
                    "data": "^XA..."
                }
            ],
            "dispatch_date": "2026-12-21"
            "created": "2019-03-17 14:26:45"
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
channel object|NULL Prodejní kanál objednávky.
channel.id string UUID prodejního kanálu v systému fulfillment.cz.
channel.ext_id string|NULL Externí ID prodejního kanálu z Vašeho systému.
channel.name string Název prodejního kanálu.
status string Stav objednávky
  • created => vytvořeno
  • waiting_for_storage => čeká na uskladnění
  • in_expedition => v expedici
  • packed => zabaleno
  • canceled => stornováno
  • problem_in_expedition => problém v expedici
  • not_sent => neodesláno
  • sent => odesláno
  • delivered => doručeno
  • returned => vráceno
delivery.status string|NULL Stav zásilky
  • inTransit => předáno dopravci
  • delivered => doručeno
  • returned => vráceno
expedition.status string Stav v expedici
  • waiting => Objednávka čeká na picking. V případě potřeby můžete objednávku v expedici zrušit.
  • picking => Objednávka je v procesu pickingu.
  • waitingForPacking => Objednávka byla čeka na kompletaci.
  • packing => Objednávka je v procesu kompletace.
  • packed => Objednávka byla zkompletována a čeká na zabalení.
  • problem => Objednávka byla označena jako problémová a čeka na vyřešení.
  • problemSolved => Objednávka byla v expedici zrušena a v případě potřeby můžete její stav změnit.
  • finished => Objednávka byla zabalena a čeká na předání kurýrovi.
  • picked => Objednávka byla čeka na kompletaci.
  • packaging => Objednávka je v procesu balení.
  • packaged => Objednávka je zabalena.
status_note Poznámka ke stavu objednávky
expedition.problem.source Zdroj problému
  • order => objednávka
  • picking => picking
  • packing => kompletace
  • packaging => balení
expedition.problem.description Popis problému
expedition.problem.solution Rešení problému
expedition.problem.postponed Expedice objednávky byla pouze krátkodobě odložena.
expedition.problem.photos Fotografie (pole URL)
stock_items[].variantId int Id produktu ze systému fulfillment.cz
stock_items[].code string Kód produktu ze systému fulfillment.cz
stock_items[].ext_code string Kód produktu dodavatele
stock_items[].inventory_id int Inventář produktu
stock_items[].quality int Kvalita produktu (0 = poškozený, 1 = nepoškozený)
stock_items[].expiration string|NULL Datum expirace produktu (Y-m-d). Pokud je hodnota NULL, expirace není nastavena.
stock_items[].batch_number string|NULL Číslo šarže produktu. Pokud je hodnota NULL, šarže není nastavena.
stock_items[].lot_id string|NULL Lot ID produktu. Pokud je hodnota NULL, Lot ID není nastaveno.
stock_items[].quantity int Počet kusů
stock_items[].reserved_quantity int Počet rezervovaných kusů celkem.
stock_items[].requested_quantity int Počet požadovaných kusů celkem.
Popis:

vkládání objednávek

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/orders

JSON požadavek:

POST https://client.api.fulfillment.cz/v2/fulfillment/orders HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "idempotency_key": "381e62f7-d11e-4291-97d4-be8a4851d4c2",
    "recipient": {
        "email": "zakaznik@gmail.com",
        "phone": "777666555",
        "firstname": "Jan",
        "surname": "Novák",
        "street": "Korunní 21",
        "street_number": "",
        "city": "Praha 2",
        "zipcode": "12800",
        "company": ""
    },
    "delivery": {
        "id": 25,
        "value": 999.0,
        "place_id": null,
        "place_ext_id": null
    },
    "payment": {
        "cod": true,
        "variable_symbol": "1234567890",
        "price": 1001
    },
    "products": [
        {
            "code": "DS12345678",
            "ext_code": null,
            "quantity": 3
        }
    ],
    "sets": [
        {
            "code": "123456",
            "quantity": 3
        }
    ],
    "eshop": "https://www.uzasne-darky.cz",
    "channel": {
        "id": null,
        "ext_id": null,
        "name": "uzasne-darky.cz"
    },
    "currency_id": "EUR",
    "on_hold": true,
    "instant_reservation": true,
    "sscc": false,
    "remote_number": "123456789",
    "invoice": "JVBERi0xLjMNCiXi48/TDQoNCjE...",
    "damaged": false,
    "note": "Poznámka",
    "box_recommendation": "",
    "tickets": [
        {
            "barcode": "DR0705127648C",
            "data": "^XA..."
        }
    ],
    "dispatch_date": "2026-12-21"
}

Popis polí požadavku:
Klíč Typ Povinné Komentář
idempotency_key string Ne Unikátní identifikátor objednávky z externího systému. Ochrana proti duplicitním zápisům.
recipient.email string Ano E-mail zákazníka
recipient.phone string Ano Telefon zákazníka
recipient.firstname string Ano Jméno zákazníka
recipient.surname string Ano Příjmení zákazníka
recipient.street string Ano Ulice zákazníka
recipient.street_number string Ne Číslo popisné. Pouze v případě, že neuvádíte číslo jako součást ulice (recipient.street).
recipient.city string Ano Město zákazníka
recipient.zipcode string Ano PSČ zákazníka
recipient.company string Ne Společnost zákazníka
delivery.id int|NULL Podm. ID doručovací metody.
delivery.value float Ano Hodnota zboží v objednávce v měně objednávky
delivery.place_id1 int|NULL Ne ID odběrného místa (ze systému fulfillment.cz). Viz Doručovací metody - odběrná místa
delivery.place_ext_id1 string|NULL Ne ID odběrného místa (z externí služby, například zasilkovna.cz).
payment.cod bool Ano Je objednávka na dobírku?
payment.variable_symbol string|NULL Podm. Variabilní symbol. Povinné v případě, že je objednávka na dobírku.
payment.price float Ano Částka k zaplacení v měně objednávky. V případě, že je objednávka zaplacena předem pošlete 0.
products[].code string|NULL Podm. Kód produktu ze systému fulfillment.cz. Nepovinné, pokud je uvedeno ext_code produktu
products[].ext_code string|NULL Podm. Kód produktu dodavatele. Nepovinné, pokud je uvedeno code produktu
products[].quantity int Ano Počet kusů produktu
sets[] array Ne Produktové sety
sets[].code string Ano Kód produktového setu
sets[].quantity int Ano Počet kusů produktového setu
eshop string Ne URL adresa eshopu (včetně http(s))
channel object|NULL Ne Prodejní kanál objednávky. Použijte právě jeden z klíčů níže (priorita id > ext_id > name). Pokud channel neuvedete, kanál se odvodí z URL eshopu.
channel.id string|NULL Ne UUID prodejního kanálu v systému fulfillment.cz. Kanál musí patřit Vašemu účtu. Má přednost před ext_id i name.
channel.ext_id string|NULL Ne Externí ID prodejního kanálu z Vašeho systému. Kanál s tímto ext_id musí již existovat. Má přednost před name.
channel.name string|NULL Ne Název prodejního kanálu. Pokud kanál s tímto názvem zatím neexistuje, bude automaticky vytvořen.
currency_id string Ne Měna objednávky, defaultně bude nastaveno na CZK. Měna objednávky musí souhlasit s měnou země, do které je objednávka odeslána.
on_hold bool Ne Vyžaduje objednávka manuální poslání do expedice? Použijte u objednávek, které čekají na zaplacení a nesmí být poslány do expedice automaticky.
instant_reservation bool Ne Vytvoření rezervací skladových zásob ihned při vytvoření objednácky. (default = false)
sscc bool Ne Objednávka vyžaduje tisk SSCC štítků.
remote_number string Ano Číslo objednávky z Vašeho systému
invoice string|NULL Ne PDF faktura jako base64 encode string.
damaged bool Ne Jedná se o zásilku s poškozeným zbožím?
note string Ne Poznámka
box_recommendation string Ne Doporučený obalový materiál
tickets[] array Ne Odeslání zásilky přes vlastního dopravce. Vlastní štítky (ve formátu ZPL) používejte pouze na základě předchozí dohody s technickou podporou fulfillment.cz.
tickets[].barcode string Ano Sledovací číslo balíku. Musí se shodovat s čárovým kódem na štítku.
tickets[].data string Ano ZPL kód balíku, nebo base64 encoded PDF contents (JVBERi0xLjMNCiXi48/TDQoNCjE...).
dispatch_date string|NULL Ne Vyplňte v případě, pokud chcete expedici objednávky odložit na konkrétní datum ve formátu "Y-m-d".

1 pro vložení odběrného místa můžete použít buď ID z naší databáze, nebo ID z databáze poskytovatele služby. Objednávka bude přijata i v případě, že žádná ID nepošlete, i když to konkrétní způsob dopravy vyžaduje. V tomto případě ale nebude objednávka předána dále dodavateli a klient bude vyzván k doplnění tohoto místa v administraci.


JSON odpověď:

HTTP/1.1 201
Content-type: application/json; 

{
    "code": 201,
    "message": "",
    "data": {
        "id": 1
    }
}
Popis polí odpovědi:
Klíč Typ Komentář
id string UUID objednávky v systému fulfillment.cz
Popis:

editace objednávek

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/orders/<orderId>

JSON požadavek:

PUT https://client.api.fulfillment.cz/v2/fulfillment/orders/<orderId> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "recipient": {
        "email": "zakaznik@gmail.com",
        "phone": "777666555",
        "firstname": "Jan",
        "surname": "Novák",
        "street": "Korunní 21",
        "street_number": "",
        "city": "Praha 2",
        "zipcode": "12800",
        "company": ""
    },
    "delivery": {
        "id": 25,
        "value": 999.0,
        "place_id": null,
        "place_ext_id": null
    },
    "payment": {
        "cod": true,
        "variable_symbol": "1234567890",
        "price": 1001
    },
    "products": [
        {
            "code": "DS12345678",
            "ext_code": null,
            "quantity": 3
        }
    ],
    "sets": [
        {
            "code": "123456",
            "quantity": 3
        }
    ],
    "eshop": "https://www.uzasne-darky.cz",
    "channel": {
        "id": null,
        "ext_id": null,
        "name": "uzasne-darky.cz"
    },
    "currency_id": "EUR",
    "on_hold": true,
    "instant_reservation": true,
    "sscc": true,
    "remote_number": "123456789",
    "invoice": "JVBERi0xLjMNCiXi48/TDQoNCjE...",
    "damaged": false,
    "note": "Poznámka",
    "box_recommendation": "",
    "tickets": [
        {
            "barcode": "DR0705127648C",
            "data": "^XA..."
        }
    ],
    "dispatch_date": "2026-12-21"
}

Popis polí požadavku:
Klíč Typ Povinné Komentář
recipient.email string Ano E-mail zákazníka
recipient.phone string Ano Telefon zákazníka
recipient.firstname string Ano Jméno zákazníka
recipient.surname string Ano Příjmení zákazníka
recipient.street string Ano Ulice zákazníka
recipient.street_number string Ne Číslo popisné. Pouze v případě, že neuvádíte číslo jako součást ulice (recipient.street).
recipient.city string Ano Město zákazníka
recipient.zipcode string Ano PSČ zákazníka
recipient.company string Ne Společnost zákazníka
delivery.id int|NULL Podm. ID doručovací metody.
delivery.value float Ano Hodnota zboží v objednávce v měně objednávky
delivery.place_id1 int|NULL Ne ID odběrného místa (ze systému fulfillment.cz). Viz Doručovací metody - odběrná místa
delivery.place_ext_id1 string|NULL Ne ID odběrného místa (z externí služby, například zasilkovna.cz).
payment.cod bool Ano Je objednávka na dobírku?
payment.variable_symbol string|NULL Podm. Variabilní symbol. Povinné v případě, že je objednávka na dobírku.
payment.price float Ano Částka k zaplacení v měně objednávky. V případě, že je objednávka zaplacena předem pošlete 0.
products[].code string|NULL Podm. Kód produktu ze systému fulfillment.cz. Nepovinné, pokud je uvedeno ext_code produktu
products[].ext_code string|NULL Podm. Kód produktu dodavatele. Nepovinné, pokud je uvedeno code produktu
products[].quantity int Ano Počet kusů produktu
sets[] array Ne Produktové sety
sets[].code string Ano Kód produktového setu
sets[].quantity int Ano Počet kusů produktového setu
eshop string Ne URL adresa eshopu (včetně http(s))
channel object|NULL Ne Prodejní kanál objednávky. Použijte právě jeden z klíčů níže (priorita id > ext_id > name). Pokud channel neuvedete, kanál se odvodí z URL eshopu.
channel.id string|NULL Ne UUID prodejního kanálu v systému fulfillment.cz. Kanál musí patřit Vašemu účtu. Má přednost před ext_id i name.
channel.ext_id string|NULL Ne Externí ID prodejního kanálu z Vašeho systému. Kanál s tímto ext_id musí již existovat. Má přednost před name.
channel.name string|NULL Ne Název prodejního kanálu. Pokud kanál s tímto názvem zatím neexistuje, bude automaticky vytvořen.
currency_id string Ne Měna objednávky, defaultně bude nastaveno na CZK. Měna objednávky musí souhlasit s měnou země, do které je objednávka odeslána.
on_hold bool Ne Vyžaduje objednávka manuální poslání do expedice? Použijte u objednávek, které čekají na zaplacení a nesmí být poslány do expedice automaticky.
instant_reservation bool Ne Vytvoření rezervací skladových zásob ihned při vytvoření objednácky. (default = false)
sscc bool Ne Objednávka vyžaduje tisk SSCC štítků.
remote_number string Ano Číslo objednávky z Vašeho systému
invoice string|NULL Ne PDF faktura jako base64 encode string.
damaged bool Ne Jedná se o zásilku s poškozeným zbožím?
note string Ne Poznámka
box_recommendation string Ne Doporučený obalový materiál
tickets[] array Ne Odeslání zásilky přes vlastního dopravce. Vlastní štítky (ve formátu ZPL) používejte pouze na základě předchozí dohody s technickou podporou fulfillment.cz.
tickets[].barcode string Ano Sledovací číslo balíku. Musí se shodovat s čárovým kódem na štítku.
tickets[].data string Ano ZPL kód balíku, nebo base64 encoded PDF contents (JVBERi0xLjMNCiXi48/TDQoNCjE...).
dispatch_date string|NULL Ne Vyplňte v případě, pokud chcete expedici objednávky odložit na konkrétní datum ve formátu "Y-m-d".

1 pro vložení odběrného místa můžete použít buď ID z naší databáze, nebo ID z databáze poskytovatele služby. Objednávka bude přijata i v případě, že žádná ID nepošlete, i když to konkrétní způsob dopravy vyžaduje. V tomto případě ale nebude objednávka předána dále dodavateli a klient bude vyzván k doplnění tohoto místa v administraci.


JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": ""
}
Popis:

odeslání objednávky k expedici

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/orders/<orderId>

JSON požadavek:

PATCH https://client.api.fulfillment.cz/v2/fulfillment/orders/<orderId> HTTP/1.1
Authorization: TOKEN
Accept: application/json

JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": ""
}
Popis:

zrušení objednávky (změna stavu na "zrušeno")

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/orders/<orderId>

JSON požadavek:

DELETE https://client.api.fulfillment.cz/v2/fulfillment/orders/<orderId> HTTP/1.1
Authorization: TOKEN
Accept: application/json

JSON odpověď 1:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": ""
}
JSON odpověď 2:

HTTP/1.1 202
Content-type: application/json; 

{
    "code": 202,
    "message": ""
}

V případě, kdy je objednávka v procesu expedice dojde pouze k žádosti o zastavení expedice.


Popis:

seznam událostí objednávek.

Endpoint vrací maximálně 1000 událostí na jedno volání. Pokud odpověď obsahuje 1000 záznamů, je pravděpodobné, že existují další — opakujte volání s lastSeenId = poslední internal_id z předchozí odpovědi, dokud nedostanete méně než 1000.

Pozn.: Pole internal_id není souvislá řada — mezery v číslování jsou normální. Spoléhejte pouze na vzestupné řazení a stránkujte podle posledního vráceného internal_id.

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/order-event-store?lastSeenId=0

JSON požadavek:

GET https://client.api.fulfillment.cz/v2/fulfillment/order-event-store?lastSeenId=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
lastSeenId int Ano Kurzor — vrací se pouze události s internal_id > lastSeenId, řazené vzestupně. Pro první volání použijte 0. Pro stránkování použijte poslední internal_id z předchozí odpovědi.
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": "",
    "data": [
        {
            "internal_id": 3,
            "event_id": "3754fe54-ade5-4c88-bff2-f775c5d94ee8",
            "event_type": "OrderPushedToExpedition",
            "data": {
                "id": "880fcdc2-6c02-4f15-a8a4-b1e872020cc5",
                "remote_id": null,
                "remote_number": "123"
            },
            "created": "2026-05-18 14:54:25"
        },
        {
            "internal_id": 5,
            "event_id": "f5f961e1-1300-419d-ac5a-ecf271c980d8",
            "event_type": "OrderPacked",
            "data": {
                "id": "443eca2b-3bb4-4c48-919c-9d2fadca85ca",
                "remote_id": null,
                "remote_number": "123",
                "delivery": {
                    "id": 2,
                    "value": 999.0,
                    "name": "DPD",
                    "tracking_number": "xyz",
                    "status": "inTransit"
                }
            },
            "created": "2026-05-18 14:57:22"
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
internal_id int Interní pořadové ID události. Slouží jako kurzor pro stránkování přes lastSeenId.
event_id string UUID4 události (shoduje se s event_id doručeným webhookem).
event_type string Typ události. Přehled povolených hodnot a význam viz sekce Webhooks → Objednávky.
data object Payload události. Struktura se liší podle event_type a je identická s payloadem doručeným webhookem — viz sekce Webhooks → Objednávky.
created string Datum a čas vzniku události (Y-m-d H:i:s).

Popis:

seznam aktivních doručovacích metod

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/deliveries

JSON požadavek:

GET https://client.api.fulfillment.cz/v2/fulfillment/deliveries HTTP/1.1
Authorization: TOKEN
Accept: application/json

JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": "",
    "data": [
        {
            "id": 1,
            "name": "Česká pošta",
            "has_place": 1
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id int ID doručovací metody
name string Název
has_place int Údaj o tom, jestli konkrétní způsob dopravy vyžaduje zaslání odběrného místa (0 = NE; 1 = ANO). Viz také "Doručovací metody - odběrná místa"

Skladové hospodářství

Popis:

seznam variant na skladě

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/warehouse-variants?limit=100&offset=0

JSON požadavek:

GET https://client.api.fulfillment.cz/v2/fulfillment/warehouse-variants?limit=30&offset=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
variant_id string Ne ID varianty (pro zobrazení pouze konkrétní varianty)
variant_ids array Ne ID variant (pole)
quantity_from int Ne Počet nepoškozených kusů skladem >= quantity_from.
damaged_quantity_from int Ne Počet poškozených kusů skladem >= damaged_quantity_from.
total_quantity_from int Ne Počet poškozených nebo nepoškozených kusů skladem >= total_quantity_from.
limit int Ne Počet požadovaných záznamů. Defaultní hodnota = 100. Maximální hodnota = 1000.
offset int Ne Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": "",
    "totalCount": 1,
    "data": [
        {
            "variant_id": 1887274,
            "code": "DS62202039",
            "ext_code": "123",
            "quantity": 3,
            "available_quantity": 2,
            "damaged_quantity": 0,
            "reserved_quantity": 1,
            "requested_quantity": 0,
            "mastercase_quantity": 303,
            "mastercase_available_quantity": 302,
            "mastercase_reserved_quantity": 1,
            "mastercase_requested_quantity": 0,
            "price_per_unit": 99,
            "stock_items": [
                {
                    "inventory_id": "d52f6096-e0c0-4d86-9075-85a3147c815c",
                    "quality": 1,
                    "expiration": "2030-12-31",
                    "batch_number": null,
                    "lot_id": null,
                    "serial_numbers": ["SN1", "SN2", "SN3"]
                    "quantity": 3,
                    "available_quantity": 2,
                    "reserved_quantity": 1,
                    "requested_quantity": 0
                }
            ]
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
variant_id int Id varianty ze systému fulfillment.cz
code string Kód varianty ze systému fulfillment.cz
code string Váš kód varianty
quantity int Počet kusů skladem nepoškozeno celkem (pro dostupný počet kusů nezapomeňte odečíst "reserved_quantity")
available_quantity int Dostupný počet volných kusů skladem nepoškozeno celkem. Počet kusů po odečtení rezervací a žádostí (může nabývat záporných hodnot).
damaged_quantity int Počet poškozených kusů skladem celkem
reserved_quantity int Počet rezervovaných kusů pro nevyřízené objednávky
requested_quantity int Počet žádostí (ks) o variantu pro nevyřízené objednávky
mastercase_quantity int Počet kusů skladem nepoškozeno celkem příjmutých v kartonech či na paletách (nezahrnuje počet kusového SKU).
mastercase_available_quantity int Dostupný počet volných kusů skladem nepoškozeno celkem příjmutých v kartonech či na paletách (nezahrnuje počet kusového SKU).
mastercase_reserved_quantity int Počet rezervovaných kusů pro nevyřízené objednávky příjmutých v kartonech či na paletách (nezahrnuje počet kusového SKU).
mastercase_requested_quantity int Počet žádostí (ks) o variantu pro nevyřízené objednávky příjmutých v kartonech či na paletách (nezahrnuje počet kusového SKU).
price_per_unit float|NULL Průměrná cena za kus
stock_items array Rozpad unikátních zásob varianty
stock_items[].inventory_id string Inventář produktu
stock_items[].quality int Kvalita produktu ([0, 2 - N] = poškozený, 1 = nepoškozený)
stock_items[].expiration string|NULL Datum expirace produktu (Y-m-d). Pokud je hodnota NULL, expirace není nastavena.
stock_items[].batch_number string|NULL Číslo šarže produktu. Pokud je hodnota NULL, šarže není nastavena.
stock_items[].lot_id string|NULL Lot ID produktu. Pokud je hodnota NULL, Lot ID není nastaveno.
stock_items[].serial_number array Sériové čísla varianty skladem
stock_items[].quantity int Počet kusů skladem
stock_items[].available_quantity int Počet kusů k dispozici
stock_items[].reserved_quantity int Počet kusů v rezervaci
stock_items[].reserved_quantity int Počet kusů čekajících na naskldění

Popis:

seznam žádostí

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/warehouse-requests?limit=100&offset=0

JSON požadavek:

GET https://client.api.fulfillment.cz/v2/fulfillment/warehouse-requests?limit=30&offset=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string Ne ID žádosti
limit int Ne Počet požadovaných záznamů. Defaultní hodnota = 100. Maximální hodnota = 1000.
offset int Ne Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": "",
    "totalCount": 1,
    "data": [
        {
            "id": 1,
            "variant_id": 1,
            "variant_code": "DS12471440",
            "variant_ext_code": "xyz",
            "quantity": 3,
            "created": "2026-12-31 12:12:12",
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id int ID žádosti
variant_id int Id produktu ze systému fulfillment.cz
variant_code string Kód produktu ze systému fulfillment.cz
variant_ext_code string Kód produktu dodavatele
quantity int Počet kusů
created string Datum a čas vytvoření žádosti

Popis:

seznam pohybů

Úplná adresa:

https://client.api.fulfillment.cz/v2/fulfillment/warehouse-movements?limit=100&offset=0

JSON požadavek:

GET https://client.api.fulfillment.cz/v2/fulfillment/warehouse-movements?limit=30&offset=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id int Ne ID pohybu
idFrom int Ne ID pohybu od (ID je stoupajicí celé čislo...).
limit int Ne Počet požadovaných záznamů. Defaultní hodnota = 100. Maximální hodnota = 1000.
offset int Ne Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
dateFrom string Ne Datum od ve formátu Y-m-d (např. 2020-01-31).
dateTo string Ne Datum do ve formátu Y-m-d (např. 2020-01-31).

Záznamy jsou vždy řazeny od nejnovějšího po nejstarší.

JSON odpověď:

HTTP/1.1 200
Content-type: application/json; 

{
    "code": 200,
    "message": "",
    "totalCount": 1,
    "data": [
        {
            "id": 1,
            "variant_id": 1,
            "movement": "in",
            "fulfillment_order_id": null,
            "preload_id": 1751,
            "reload_id": null,
            "price_per_unit": 99.99,
            "extra_cost_per_unit": 0.0,
            "quantity": 3,
            "damaged_quantity": 0,
            "created": "2026-12-31 12:12:12",
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id int ID pohybu
variant_id int Id varianty ze systému fulfillment.cz
movement string Směr pohybu ("in"|"out")
fulfillment_order_id string|NULL Id fulfillmentové objednávky ve formátu UUID4 (IN = naskladnění vratky; OUT = vyskladnění objednávky)
preload_id int|NULL ID předskladnění
reload_id int|NULL ID transformace
price_per_unit float|NULL Cena/kus za kterou byla položka naskladněna
extra_cost_per_unit float|NULL Náklady/kus za kterou byla položka naskladněna
quantity int Počet kusů
damaged_quantity int Počet poškozených kusů
created string Datum a čas vytvoření ve formátu "Y-m-d H:i:s"


WEBHOOKs

Popis:

vytvoření objednávky

Požadavek webhooku:

POST $endpoint1 HTTP/1.1
Authorization: $token2
Content-Type: application/json

1 URL endpoint, nastavený u Vašeho obchodu, na který je objednávka vytvořena

2 Váš autorizační API token ze systému fulfillment.cz

Parametry webhooku:
Klíč Typ Komentář
event_id string Unikátní identifikátor eventu ve formátu UUID4
event_type string Typ eventu
data array Data eventu
created string Datum a čas vytvoření eventu ve formátu "Y-m-d H:i:s"
Ukázka: 
{
    "event_id": "c7f0963e-0f72-46bf-bdd1-fe6eec625960",
    "event_type": "OrderCreated",
    "data": {
        "id": "7cad37e9-2624-480d-8c5f-68985522e7d0",
        "warehouse_id": "677bb033-e50e-4ddf-8a5c-97817314e650",
        "number": "FF701392",
        "remote_id": null,
        "remote_number": "1",
        "currency_id": "CZK",
        "on_hold": false,
        "recipient": {
            "email": "zakaznik@gmail.com",
            "phone": "777666555",
            "firstname": "Jan",
            "surname": "Novák",
            "street": "Korunní 21",
            "city": "Praha 2",
            "zipcode": "12800",
            "company": ""
        },
        "delivery": {
            "id": 25,
            "value": 999.0,
            "name": "DPD",
            "tracking_number": "xyz",
            "status": "inTransit"
        },
        "payment": {
            "cod": true,
            "variable_symbol": "1234567890",
            "price": 1001
        },
        "products": [
            {
                "name": "Horké kameny",
                "image": "https://cdn.fulfillment.cz/images/d/e/a/b/0/8/0/c/8/9/7c65758192e4f827ecxyz.png",
                "code": "DS12345678",
                "ext_code": null,
                "quantity": 3
            }
        ],
        "note": "",
        "tickets": [
            {
                "barcode": "DR0705127648C",
            }
        ],
        "created": "2020-10-28 06:45:23"
    },
    "created": "2020-10-28 06:45:23",
}
Parametry eventu:

Pro detailní popis parametrů v sekci REST API - Objednávky

Očekávaná odpověď:

HTTP/1.1 200
Content-type: application/json; 

	

	

Popis:

změna udajů objednávky




	POST $endpoint1 HTTP/1.1
	

	Authorization: $token2
	

	Content-Type: application/json




1 URL endpoint, nastavený u Vašeho obchodu, na který je objednávka vytvořena


2 Váš autorizační API token ze systému fulfillment.cz


Parametry webhooku:


	

		Klíč
		Typ
		Komentář
	

	

		event_id
		string
		Unikátní identifikátor eventu ve formátu UUID4
	

	

		event_type
		string
		Typ eventu
	

	

		data
		array
		Data eventu
	

	

		created
		string
		Datum a čas vytvoření eventu ve formátu "Y-m-d H:i:s"
	



Ukázka:

{
    "event_id": "c7f0963e-0f72-46bf-bdd1-fe6eec625960",
    "event_type": "OrderUpdated",
    "data": {
        "id": "7cad37e9-2624-480d-8c5f-68985522e7d0",
        "number": "FF701392",
        "remote_id": null,
        "remote_number": "1",
        "currency_id": "CZK",
        "on_hold": false,
        "recipient": {
            "email": "zakaznik@gmail.com",
            "phone": "777666555",
            "firstname": "Jan",
            "surname": "Novák",
            "street": "Korunní 21",
            "city": "Praha 2",
            "zipcode": "12800",
            "company": ""
        },
        "delivery": {
            "id": 25,
            "value": 999.0,
            "name": "DPD",
            "tracking_number": "xyz",
            "status": "inTransit"
        },
        "payment": {
            "cod": true,
            "variable_symbol": "1234567890",
            "price": 1001
        },
        "products": [
            {
                "name": "Horké kameny",
                "image": "https://cdn.fulfillment.cz/images/d/e/a/b/0/8/0/c/8/9/7c65758192e4f827ecxyz.png",
                "code": "DS12345678",
                "ext_code": null,
                "quantity": 3
            }
        ],
        "note": "",
        "tickets": [
            {
                "barcode": "DR0705127648C",
            }
        ],
        "created": "2020-10-28 06:45:23"
    },
    "created": "2020-10-28 06:45:23",
}




Parametry eventu:

Pro detailní popis parametrů v sekci REST API - Objednávky


Očekávaná odpověď:


	HTTP/1.1 200
	

	Content-type: application/json;



	

	

Popis:

zrušení objednávky


Požadavek webhooku:



	POST $endpoint1 HTTP/1.1
	

	Authorization: $token2
	

	Content-Type: application/json




1 URL endpoint, nastavený u Vašeho obchodu, na který je objednávka vytvořena


2 Váš autorizační API token ze systému fulfillment.cz


Parametry webhooku:


	

		Klíč
		Typ
		Komentář
	

	

		event_id
		string
		Unikátní identifikátor eventu ve formátu UUID4
	

	

		event_type
		string
		Typ eventu
	

	

		data
		array
		Data eventu
	

	

		created
		string
		Datum a čas vytvoření eventu ve formátu "Y-m-d H:i:s"
	



Ukázka:

{
    "event_id": "c7f0963e-0f72-46bf-bdd1-fe6eec625960",
    "event_type": "OrderCanceled",
    "data": {
        "id": "7cad37e9-2624-480d-8c5f-68985522e7d0",
        "remote_id": null,
        "remote_number": "1",
    },
    "created": "2020-10-28 06:45:23",
}



Parametry eventu:

Pro detailní popis parametrů v sekci REST API - Objednávky


Očekávaná odpověď:


	HTTP/1.1 200
	

	Content-type: application/json;



	

	

Popis:

změna stavu zásilky


Požadavek webhooku:



	POST $endpoint1 HTTP/1.1
	

	Authorization: $token2
	

	Content-Type: application/json




1 URL endpoint, nastavený u Vašeho obchodu, na který je objednávka vytvořena


2 Váš autorizační API token ze systému fulfillment.cz


Parametry webhooku:


	

		Klíč
		Typ
		Komentář
	

	

		event_id
		string
		Unikátní identifikátor eventu ve formátu UUID4
	

	

		event_type
		string
		Typ eventu
	

	

		data
		array
		Data eventu
	

	

		created
		string
		Datum a čas vytvoření eventu ve formátu "Y-m-d H:i:s"
	



Ukázka:

{
    "event_id": "c7f0963e-0f72-46bf-bdd1-fe6eec625960",
    "event_type": "OrderDeliveryChanged",
    "data": {
        "id": "7cad37e9-2624-480d-8c5f-68985522e7d0",
        "remote_id": null,
        "remote_number": "1",
        "delivery": {
            "id": 25,
            "value": 999.0,
            "name": "DPD",
            "tracking_number": "xyz",
            "status": "inTransit"
        },
    },
    "created": "2020-10-28 06:45:23",
}



Parametry eventu:

Pro detailní popis parametrů v sekci REST API - Objednávky


Očekávaná odpověď:


	HTTP/1.1 200
	

	Content-type: application/json;



	

	

Popis:

předání objednávky na sklad k expedici


Požadavek webhooku:



	POST $endpoint1 HTTP/1.1
	

	Authorization: $token2
	

	Content-Type: application/json




1 URL endpoint, nastavený u Vašeho obchodu, na který je objednávka vytvořena


2 Váš autorizační API token ze systému fulfillment.cz


Parametry webhooku:


	

		Klíč
		Typ
		Komentář
	

	

		event_id
		string
		Unikátní identifikátor eventu ve formátu UUID4
	

	

		event_type
		string
		Typ eventu
	

	

		data
		array
		Data eventu
	

	

		created
		string
		Datum a čas vytvoření eventu ve formátu "Y-m-d H:i:s"
	



Ukázka:

{
    "event_id": "c7f0963e-0f72-46bf-bdd1-fe6eec625960",
    "event_type": "OrderPushedToExpedition",
    "data": {
        "id": "7cad37e9-2624-480d-8c5f-68985522e7d0",
        "remote_id": null,
        "remote_number": "1",
    },
    "created": "2020-10-28 06:45:23",
}



Parametry eventu:

Pro detailní popis parametrů v sekci REST API - Objednávky


Očekávaná odpověď:


	HTTP/1.1 200
	

	Content-type: application/json;



	

	

Popis:

objednávka byla zabalena a čeká převzetí dopravcem


Požadavek webhooku:



	POST $endpoint1 HTTP/1.1
	

	Authorization: $token2
	

	Content-Type: application/json




1 URL endpoint, nastavený u Vašeho obchodu, na který je objednávka vytvořena


2 Váš autorizační API token ze systému fulfillment.cz


Parametry webhooku:


	

		Klíč
		Typ
		Komentář
	

	

		event_id
		string
		Unikátní identifikátor eventu ve formátu UUID4
	

	

		event_type
		string
		Typ eventu
	

	

		data
		array
		Data eventu
	

	

		created
		string
		Datum a čas vytvoření eventu ve formátu "Y-m-d H:i:s"
	



Ukázka:

{
    "event_id": "c7f0963e-0f72-46bf-bdd1-fe6eec625960",
    "event_type": "OrderPacked",
    "data": {
        "id": "7cad37e9-2624-480d-8c5f-68985522e7d0",
        "remote_id": null,
        "remote_number": "1",
        "delivery": {
            "id": 25,
            "value": 999.0,
            "name": "DPD",
            "tracking_number": "xyz",
            "status": "inTransit"
        },
    },
    "created": "2020-10-28 06:45:23",
}



Parametry eventu:

Pro detailní popis parametrů v sekci REST API - Objednávky


Očekávaná odpověď:


	HTTP/1.1 200
	

	Content-type: application/json;



	

	

Popis:

nahlášení problému k objednávce (např. požadavek na změnu dopravce, doručovací adresy apod.)


Požadavek webhooku:



	POST $endpoint1 HTTP/1.1
	

	Authorization: $token2
	

	Content-Type: application/json




1 URL endpoint, nastavený u Vašeho obchodu, na který je objednávka vytvořena


2 Váš autorizační API token ze systému fulfillment.cz


Parametry webhooku:


	

		Klíč
		Typ
		Komentář
	

	

		event_id
		string
		Unikátní identifikátor eventu ve formátu UUID4
	

	

		event_type
		string
		Typ eventu
	

	

		data
		array
		Data eventu
	

	

		created
		string
		Datum a čas vytvoření eventu ve formátu "Y-m-d H:i:s"
	



Ukázka:

{
    "event_id": "c7f0963e-0f72-46bf-bdd1-fe6eec625960",
    "event_type": "OrderProblemCreated",
    "data": {
        "id": "6d9cea72-9ea5-4f3d-aead-416f68d1b10a",
        "remote_id": "114058",
        "remote_number": "0001042762",
        "problem": "Prosím o změně dopravce na DPD "
    },
    "created": "2026-03-04 12:12:13",
}



Parametry eventu:


	

		Klíč
		Typ
		Komentář
	

	

		id
		string
		UUID4 objednávky
	

	

		remote_id
		string|NULL
		Externí ID objednávky
	

	

		remote_number
		string|NULL
		Externí číslo objednávky
	

	

		problem
		string
		Text nahlášeného problému
	




Očekávaná odpověď:


	HTTP/1.1 200
	

	Content-type: application/json;




	

	

Popis:

objednávka se vrátila zpět na sklad


Požadavek webhooku:



	POST $endpoint1 HTTP/1.1
	

	Authorization: $token2
	

	Content-Type: application/json




1 URL endpoint, nastavený u Vašeho obchodu, na který je objednávka vytvořena


2 Váš autorizační API token ze systému fulfillment.cz


Parametry webhooku:


	

		Klíč
		Typ
		Komentář
	

	

		event_id
		string
		Unikátní identifikátor eventu ve formátu UUID4
	

	

		event_type
		string
		Typ eventu
	

	

		data
		array
		Data eventu
	

	

		created
		string
		Datum a čas vytvoření eventu ve formátu "Y-m-d H:i:s"
	



Ukázka:

{
    "event_id": "c7f0963e-0f72-46bf-bdd1-fe6eec625960",
    "event_type": "OrderReturned",
    "data": {
        "id": "7cad37e9-2624-480d-8c5f-68985522e7d0",
        "remote_id": null,
        "remote_number": "1",
    },
    "created": "2020-10-28 06:45:23",
}



Parametry eventu:

Pro detailní popis parametrů v sekci REST API - Objednávky


Očekávaná odpověď:


	HTTP/1.1 200
	

	Content-type: application/json;



	

	

Popis:

objednávka byla odeslána


Požadavek webhooku:



	POST $endpoint1 HTTP/1.1
	

	Authorization: $token2
	

	Content-Type: application/json




1 URL endpoint, nastavený u Vašeho obchodu, na který je objednávka vytvořena


2 Váš autorizační API token ze systému fulfillment.cz


Parametry webhooku:


	

		Klíč
		Typ
		Komentář
	

	

		event_id
		string
		Unikátní identifikátor eventu ve formátu UUID4
	

	

		event_type
		string
		Typ eventu
	

	

		data
		array
		Data eventu
	

	

		created
		string
		Datum a čas vytvoření eventu ve formátu "Y-m-d H:i:s"
	



Ukázka:

{
    "event_id": "c7f0963e-0f72-46bf-bdd1-fe6eec625960",
    "event_type": "OrderSent",
    "data": {
        "id": "7cad37e9-2624-480d-8c5f-68985522e7d0",
        "remote_id": null,
        "remote_number": "1",
    },
    "created": "2020-10-28 06:45:23",
}



Parametry eventu:

Pro detailní popis parametrů v sekci REST API - Objednávky


Očekávaná odpověď:


	HTTP/1.1 200
	

	Content-type: application/json;



	

	

Popis:

objednávka byla doručena


Požadavek webhooku:



	POST $endpoint1 HTTP/1.1
	

	Authorization: $token2
	

	Content-Type: application/json




1 URL endpoint, nastavený u Vašeho obchodu, na který je objednávka vytvořena


2 Váš autorizační API token ze systému fulfillment.cz


Parametry webhooku:


	

		Klíč
		Typ
		Komentář
	

	

		event_id
		string
		Unikátní identifikátor eventu ve formátu UUID4
	

	

		event_type
		string
		Typ eventu
	

	

		data
		array
		Data eventu
	

	

		created
		string
		Datum a čas vytvoření eventu ve formátu "Y-m-d H:i:s"
	



Ukázka:

{
    "event_id": "c7f0963e-0f72-46bf-bdd1-fe6eec625960",
    "event_type": "OrderDelivered",
    "data": {
        "id": "7cad37e9-2624-480d-8c5f-68985522e7d0",
        "remote_id": null,
        "remote_number": "1",
    },
    "created": "2020-10-28 06:45:23",
}



Parametry eventu:

Pro detailní popis parametrů v sekci REST API - Objednávky


Očekávaná odpověď:


	HTTP/1.1 200
	

	Content-type: application/json;



	

	

Popis:

objednávka byla přepnuta do stavu čeká na uskladnění


Požadavek webhooku:



	POST $endpoint1 HTTP/1.1
	

	Authorization: $token2
	

	Content-Type: application/json




1 URL endpoint, nastavený u Vašeho obchodu, na který je objednávka vytvořena


2 Váš autorizační API token ze systému fulfillment.cz


Parametry webhooku:


	

		Klíč
		Typ
		Komentář
	

	

		event_id
		string
		Unikátní identifikátor eventu ve formátu UUID4
	

	

		event_type
		string
		Typ eventu
	

	

		data
		array
		Data eventu
	

	

		created
		string
		Datum a čas vytvoření eventu ve formátu "Y-m-d H:i:s"
	



Ukázka:

{
    "event_id": "c7f0963e-0f72-46bf-bdd1-fe6eec625960",
    "event_type": "OrderStatusChangedToWaitingForStorage",
    "data": {
        "id": "7cad37e9-2624-480d-8c5f-68985522e7d0",
        "remote_id": null,
        "remote_number": "1",
    },
    "created": "2020-10-28 06:45:23",
}



Parametry eventu:

Pro detailní popis parametrů v sekci REST API - Objednávky


Očekávaná odpověď:


	HTTP/1.1 200
	

	Content-type: application/json;



	

	

Popis:

objednávka byla přepnuta do vytvořeno. Z pravidla při nutnosti upravit objednávku na základě problému v expedici.


Požadavek webhooku:



	POST $endpoint1 HTTP/1.1
	

	Authorization: $token2
	

	Content-Type: application/json




1 URL endpoint, nastavený u Vašeho obchodu, na který je objednávka vytvořena


2 Váš autorizační API token ze systému fulfillment.cz


Parametry webhooku:


	

		Klíč
		Typ
		Komentář
	

	

		event_id
		string
		Unikátní identifikátor eventu ve formátu UUID4
	

	

		event_type
		string
		Typ eventu
	

	

		data
		array
		Data eventu
	

	

		created
		string
		Datum a čas vytvoření eventu ve formátu "Y-m-d H:i:s"
	



Ukázka:

{
    "event_id": "c7f0963e-0f72-46bf-bdd1-fe6eec625960",
    "event_type": "OrderStatusChangedToCreated",
    "data": {
        "id": "7cad37e9-2624-480d-8c5f-68985522e7d0",
        "remote_id": null,
        "remote_number": "1",
    },
    "created": "2020-10-28 06:45:23",
}



Parametry eventu:

Pro detailní popis parametrů v sekci REST API - Objednávky


Očekávaná odpověď:


	HTTP/1.1 200
	

	Content-type: application/json;