Objednávky, zákazníci a stavy skladu se mezi Shoptetem a Pohodou přenášet umí. Obrázky, parametry produktů, záruky a opravy už odeslaných objednávek ne. A přístup k API nedostane majitel e-shopu, ale schválený doplněk, což je detail, který mění celé zadání.
Tenhle článek není návod na instalaci. Je to seznam toho, co se v nabídkách na integraci obvykle nepíše, a otázky, kterými si to ověříte dřív, než podepíšete.
Klíč k API nedostanete vy, ale doplněk z marketplace
Shoptet má REST API, které pracuje v JSON a slouží ke čtení a úpravám dat e-shopu. Přístup k němu ale není volný. Dokumentace to říká přímo: „The API is not freely accessible, it is currently available for developers of so-called addons, which are published at the marketplace" (developers.shoptet.com, staženo 31. 8. 2026).
Prakticky to znamená tři cesty a ani jedna nevypadá jako „dejte nám klíč":
- nainstalujete hotový doplněk z marketplace a napojení řeší jeho autor,
- necháte si doplněk vyvinout, což vyžaduje schválení a smlouvu se Shoptetem,
- jste na Shoptet Premium, který nabízí privátní přístup k datům přes API nad objednávkami, zákazníky, produkty i zásobami.
Autorizace běží přes OAuth2. Doplněk dostane při instalaci trvalý token a z něj si obstarává krátkodobé přístupové tokeny s platností 30 minut. Sám Shoptet zároveň upozorňuje, že API není určené k úpravám frontendu e-shopu.
Limity API poznáte až u velkého katalogu, ne při testu
Rate limiter je popsaný číselně, takže se s ním dá počítat dopředu. Každá aplikace má kbelík o kapacitě 200 kapek a každou sekundu se z něj odebere 10 kapek; složitější volání spotřebuje víc. Když je kbelík plný, přijde HTTP 429 a musí se čekat.
K tomu jsou limity souběhu: 50 spojení z jedné IP adresy a 3 spojení na jeden API token. Zámky proti duplicitnímu zápisu u metod POST, PUT, PATCH a DELETE vracejí 423 a drží nejvýš 5 sekund. Každá dvojice doplněk a projekt má vlastní kbelík, takže si dva doplňky navzájem limit neuberou (developers.shoptet.com, staženo 31. 8. 2026).
Proč to má vědět majitel e-shopu, ne jen programátor: tahle čísla určují, jestli se dvacet tisíc položek přepíše za minutu, nebo za noc. U katalogu do několika set produktů limity nepocítíte vůbec.
Mezi Shoptetem a Pohodou jde jen část dat, a každým směrem jiná
Napojení na Pohodu řeší doplněk. Oficiální „Pohoda" v marketplace umí podle popisu obousměrný přenos produktů, zásob, objednávek, zákazníků, daňových dokladů, zálohových faktur i dobropisů. Na straně Pohody je potřeba funkce Internetové obchodování, kterou má varianta Jazz a vyšší, a doporučená verze 12008.7 (podpora.shoptet.cz, staženo 31. 8. 2026).
| Směr | Co se přenáší |
|---|---|
| Pohoda → Shoptet | stavy skladu, změna objednávky na Vyřízena |
| Pohoda → Shoptet | zákazníci, u kterých je vyplněný e-mail |
| Shoptet → Pohoda | nové objednávky včetně položek |
| Shoptet → Pohoda | zákazníci z adresáře, doprava a platba |
| Shoptet → Pohoda | popis, ceny, EAN, PLU, hmotnost, příznaky |
Pro přenos skladových zásob musí být aktivní doplněk Skladové hospodářství. Ten stojí 200 Kč měsíčně a v tarifu Business a vyšším je zdarma (doplnky.shoptet.cz, staženo 31. 8. 2026).
Co se nepřenáší, i když to od integrace čekáte
Tohle je jádro celého článku a v nabídkách to bývá vynechané, protože se to špatně prodává. Podle dokumentace Shoptetu se nepřenášejí:
- obrázky produktů a soubory,
- parametry produktů a záruky,
- související a alternativní produkty,
- varianty jako varianty; z Pohody přijdou jako samostatné karty,
- změny už jednou přenesené objednávky, Pohoda aktualizace nepřijímá,
- smazání kategorie, kategorie se jen zakládají.
K tomu čtyři technické pasti, na kterých integrace tiše přeskočí položku: synchronizují se jen zásoby typu Karta, PLU delší než 6 znaků neprojde, EAN má strop 14 znaků, název adresy v Pohodě 25 znaků a IČO musí na obou stranách sedět přesně (podpora.shoptet.cz, staženo 31. 8. 2026).
Nejdražší je předposlední bod seznamu. Objednávku, která už v Pohodě je, integrace neopraví. Změna po přenosu se řeší storno dokladem a novým zápisem, tedy ručně a s rizikem dvou číselných řad.
Pohoda běží na počítači, a to určuje, jak často se data potkají
Pohoda není cloudová služba. Komunikace se vede přes POHODA mServer, který přijímá XML přes HTTP metodou POST; GET podporovaný není a XML komunikaci je nutné povolit v právech uživatele (stormware.cz, staženo 31. 8. 2026).
Z toho plyne provozní podmínka, kterou si při zadání málokdo uvědomí: někde musí běžet stroj s Pohodou a být dostupný ve chvíli, kdy si e-shop řekne o data. Vypnutý firemní počítač v pátek večer znamená, že se sobotní objednávky do účetnictví dostanou v pondělí.
Druhý důsledek je návrhový. Sklad má jednoho pána a je jím obvykle Pohoda. E-shop se pak chová jako výkladní skříň, ne jako databáze, a rozhodnutí o tom, kdo má pravdu při rozporu, se dělá na začátku, ne při reklamaci. Tuhle část řešíme na stránce o napojení na ERP a CRM.
Než začnete platit práci, spočítejte měsíční poplatky za doplňky
Integrace má dvě ceny a ta menší je vidět hned. Doplněk Pohoda stojí 200 Kč měsíčně a v tarifu Profi a vyšším je zdarma; Skladové hospodářství dalších 200 Kč měsíčně, zdarma od tarifu Business (doplnky.shoptet.cz, staženo 31. 8. 2026). K tomu tarif samotný: Shoptet Business vyjde na 1 490 Kč měsíčně bez DPH, Profi na 2 490 Kč (shoptet.cz/cenik, staženo 31. 8. 2026).
V marketplace jsou vedle oficiálního doplňku i řešení třetích stran, mimo jiné Pohoda by ShopSync a Pohoda by Dominik Prajzler. Liší se rozsahem mapování a mírou úprav na míru, ne principem: pořád jde o doplněk, který má přístup k API, a o mServer na druhé straně.
Rozpad celého měsíčního účtu za e-shop, tedy tarif, provize, dopravu a aplikace, rozebíráme zvlášť v článku o měsíčních nákladech e-shopu.
Co zůstane ručně skoro vždycky
Ne proto, že by to nešlo naprogramovat, ale proto, že to nikdo za vás nerozhodne. Tohle jsou práce, které po zapnutí integrace zůstávají lidem:
- Katalog. Obrázky, parametry a popisy se udržují v e-shopu.
- Opravy objednávek. Po přenosu se řeší dokladem, ne editací.
- Rozpory skladu. Někdo musí týdně projít položky, kde se čísla rozešla.
- Nové kategorie a mapování. Vzniká ručně, protože je to obchodní rozhodnutí, ne technický převod.
U daňových dokladů buďte obzvlášť opatrní. Popis doplňku jejich přenos uvádí, ale v recenzích v marketplace se objevuje výtka, že se doklady nepárují a část práce se dělá exportem a importem XML. Než to podepíšete, chtějte to vidět na vašich datech, ne na demu.
Pět otázek, po kterých poznáte, jestli to dodavatel opravdu dělal
Fungují na kohokoli včetně nás. Odpovědi si vyžádejte písemně.
- Které doplňky musím mít aktivní a kolik za ně platím měsíčně?
- Co přesně jde kterým směrem a co se nepřenáší vůbec?
- Co se stane s objednávkou, kterou zákazník po přenosu změní?
- Kdo má pravdu o stavu skladu, když se obě strany rozejdou?
- Kde poběží mServer a co se stane, když ten stroj bude vypnutý?
Integrace se nekupuje podle toho, co umí přenést. Kupuje se podle toho, co se s daty stane, když se obě strany rozejdou. Dodavatel, který na to odpoví jednou větou, to zatím nezažil.
Řekneme dopředu, co se bude synchronizovat a co ne
Automatizované napojení e-shopu na účetnictví, sklad a dodavatelské feedy je naše běžná práce a najdete ji na stránce automatizace a integrace. Napište nám, v jaké variantě Pohody účtujete a kolik máte položek, a dostanete rozdělení na tři sloupce: obousměrně, jednosměrně, ručně.
Když z toho vyjde, že vám stačí hotový doplněk z marketplace, řekneme vám to a nabídku psát nebudeme. Kompletní přehled toho, co automatizujeme, je na téže stránce.
Napište na info@lamapixel.com nebo volejte +420 775 599 009.
