Jak držet stav skladu v e-shopu podle Pohody

Nejdražší objednávka je ta, kterou nemůžete splnit. Když e-shop ukazuje zboží „skladem“, ale v Pohodě už je vyprodané, čeká vás omluvný e-mail, storno a nespokojený zákazník. Opačný problém je tišší, ale taky stojí peníze: zboží na skladě máte, jen ho e-shop pořád ukazuje jako nedostupné.

Řešením je, aby e-shop bral stavy a ceny přímo z Pohody. apios k tomu má odlehčený endpoint, který vrací přesně to, co e-shop potřebuje.

Jedno volání, celý ceník

curl "https://api.apios.cz/api/v1/eshop/stock?limit=1000" \
  -H "X-AUTH-TOKEN: VAS_API_TOKEN"

{
  "data": [
    {
      "id": 130,
      "code": "Z100",
      "ean": "8594012345678",
      "plu": null,
      "name": "Židle Z100",
      "unit": "ks",
      "on_hand": 16,
      "reserved": 2,
      "available": 14,
      "selling_price": 1200,
      "is_sales": true,
      "price_levels": []
    }
  ],
  "count": 1,
  "limit": 1000,
  "has_more": false,
  "next_offset_id": null
}

Totéž volání najdete v dokumentaci se všemi parametry a můžete si ho tam rovnou vyzkoušet:

Endpoint vrací jen zásoby, které mají v Pohodě zaškrtnutý příznak Internet — tedy jen to, co opravdu chcete prodávat online. Pro každou zásobu dostanete:

• on_hand — kolik kusů je fyzicky na skladě,
• reserved — kolik je rezervováno pro jiné objednávky,
• available — kolik můžete skutečně prodat (on_hand − reserved). Tohle číslo zobrazujte v e-shopu.
• selling_price a price_levels — prodejní cena a ceny pro cenové hladiny (velkoobchod, VIP zákazníci).

Zásoby se v e-shopu párují podle code (kód zásoby v Pohodě) nebo ean.

Jen to, co se změnilo

Stahovat celý sklad každých pět minut je zbytečné. Parametr changed_since vrátí jen zásoby změněné od zadaného okamžiku:

curl "https://api.apios.cz/api/v1/eshop/stock?changed_since=2026-10-19T08:00:00" \
  -H "X-AUTH-TOKEN: VAS_API_TOKEN"

Osvědčený postup:

1. Jednou denně v noci stáhněte celý seznam. Opraví se tím případné nesrovnalosti.
2. Každých 5–15 minut stahujte jen změny. Jako changed_since použijte čas začátku předchozího běhu — ne konce, ať vám neuteče změna, která proběhla během stahování.

Stránkování

Při větším sortimentu vrací endpoint data po stránkách (výchozí limit je 1000, maximum 10 000). Dokud odpověď obsahuje "has_more": true, načítejte další stránky s parametrem offset_id podle next_offset_id:

curl "https://api.apios.cz/api/v1/eshop/stock?limit=1000&offset_id=1131" \
  -H "X-AUTH-TOKEN: VAS_API_TOKEN"

Víc skladů

Máte v Pohodě víc skladů (třeba prodejnu a centrální sklad) a e-shop má prodávat jen z jednoho? Omezte export parametrem store_id s ID skladu. Seznam skladů vrátí GET /api/v1/store.

Celá skladová karta

/eshop/stock je záměrně odlehčený. Pokud potřebujete další údaje ze skladové karty (popis, hmotnost, obrázky, parametry), použijte plný export GET /api/v1/stock, případně GET /api/v1/stock/updated?from=… pro změny. Pro synchronizaci dostupnosti a cen ale /eshop/stock stačí a jeho odpovědi jsou mnohem menší.

Co dál

Stav skladu máte v e-shopu. Druhá polovina propojení je posílat objednávky zpátky do Pohody — viz Jak do Pohody naimportovat objednávku z e-shopu.