Pohoda a e-shop: Průvodce automatizací přes XML a mServer

Představte si pondělní ráno po úspěšném marketingovém víkendu. V administraci e-shopu svítí 150 nových objednávek, ale skladník v Pohodě vidí u klíčového produktu stále 20 kusů skladem, přestože reálně už zbývají poslední dva. Než se provede ruční export a import XML souborů, e-shop prodá dalších deset kusů. Následuje kolečko omluvných e-mailů a vratek.

Tento scénář je realitou pro e-shopy, které podcenily technické základy propojení účetního systému s prodejním kanálem. Správně nastavená synchronizace dat není jen o „překlápění“ faktur, ale o ochraně vaší marže. Ať už používáte Shoptet, Upgates nebo vlastní řešení, pochopení mechanismů jako je mServer nebo XML dataPack je pro škálování byznysu nezbytné.

V MirandaMedia se při auditech klientů setkáváme s tím, že e-shopy využívají pouze zlomek možností Pohody. Tento průvodce vás provede technickými detaily i ekonomickou realitou automatizace.

Proč nativní modul často nestačí: Dávky vs. real-time#

Stormware Pohoda obsahuje modul „Internetový obchod“, dostupný od varianty Jazz (Shoptet Podpora, 2024). Tento modul umožňuje definovat cesty k externím skriptům, ale postrádá vestavěné automatické spouštění synchronizace. Operátor musí buď ručně klikat v průvodci, nebo využít externí plánovač úloh Windows.

Dávková synchronizace u tarifů Shoptet Classic probíhá v intervalech minut až hodin. To představuje riziko během špiček, jako je Black Friday. Pokud data neproudí v reálném čase, vzniká prodleva mezi prodejem na webu a odpisem ze skladu v Pohodě. Pro e-shopy s desítkami objednávek denně je toto řešení sice ekonomicky dostupné, ale z provozního hlediska rizikové.

Každé spuštění jedné konfigurace POHODA mServeru rezervuje jednu instanci programu výhradně pro jeho komunikaci (Stormware, 2024). Tato instance je pro manuální práci v účetnictví nedostupná. Pokud chcete v Pohodě účtovat a zároveň mít aktivní automatický můstek, musíte program spustit dvakrát — jednou v režimu mServer a podruhé pro standardní práci.

Technické základy: Jak funguje mServer a XML export#

POHODA mServer je HTTP server využívající HTTP protokol pro přenos XML dat prostřednictvím dvojice požadavek-odpověď. Komunikace probíhá v XML formátu s hlavičkou Content-Type: text/xml. Pro přenos dat do účetní jednotky se používá metoda POST, zatímco metoda GET slouží výhradně pro stahování souborů, jako jsou PDF reporty nebo obrázky (Stormware, 2024).

Bezpečnost a autorizace#

Autentizace probíhá pomocí HTTP hlavičky STW-Authorization. Přihlašovací údaje se spojí do řetězce jméno:heslo, zakódují se pomocí Base64 a odešlou v požadavku. Pokud tato hlavička chybí, mServer vrátí chybu 401 Unauthorized.

V MirandaMedia zdůrazňujeme, že mServer je určen pro komunikaci v rámci lokální sítě. Pokud k němu přistupujete přes veřejný internet, je nezbytné zajistit komunikaci přes HTTPS (TLS 1.2) nebo VPN. Přímý přístup k databázi Pohody přes NetBIOS je považován za závažné bezpečnostní riziko.

Struktura datového balíčku a automatizace skladu#

Logika detekce duplicit spoléhá na atribut id v elementu dataPack a dataPackItem. Pokud je tato funkce zapnuta, Pohoda ověří, zda již dokument s daným ID nebyl importován, a v případě shody import přeskočí (Stormware, 2024). Pro automatizaci skladu je klíčové, aby objednávka z e-shopu okamžitě vytvořila v Pohodě rezervaci, která sníží dostupný stav, a teprve po potvrzení platby se převedla na výdejku.

Nejčastější chybové kódy v synchronizaci#

Při integraci narazíte na specifické chybové zprávy, které mohou zastavit celý tok dat:

• Chyba 113: Verze Pohody je příliš stará a neumí zpracovat novější XML schéma. Vyžaduje instalaci nejnovější aktualizace softwaru (Stormware, 2024).
• Chyba 400: Syntakticky nesprávný požadavek, často způsobený prázdným souborem nebo nepodporovanými filtry.
• Chyba 404: Dokument nenalezen. V kontextu mServeru to znamená, že cesta v URL není přesně /xml.
• Chyba 101: Nedostatečná práva uživatele. Pro zápis dokumentů musí mít uživatel v Pohodě přidělena práva k dané agendě.
• Chyba 627: Varování, že stav zásob klesl pod limitní množství.

Při přenosu velkých objemů dat, například u e-shopu Nejbaby.cz s 20 000 položkami, může dojít k překročení časového limitu. Standardní limit pro odeslání dat bývá 30 sekund; pokud se do této doby nepodaří balíček zpracovat, spojení se ukončí (ByznysWeb, 2024).

Ekonomika integrace: Kolik si připravit?#

Investice do propojení e-shopu s Pohodou se skládá z jednorázových nákladů a pravidelných poplatků. Kompletní obousměrná integrace zahrnující fakturaci a ceníky se pohybuje v rozmezí 50 000 Kč až 120 000 Kč (Proceder, 2024).

U hotových konektorů jsou ceny následující:

• Instalace konektoru: Od 6 000 Kč (balíček Doklady) do 15 000 Kč (balíček Komplet) (ShopSync, 2024).
• Měsíční údržba: Od 250 Kč do 700 Kč podle zvoleného balíčku.
• B2B funkce: Jednorázový příplatek 5 000 Kč pro synchronizaci registrací a ceníků.
• Individuální úpravy: Hodinová sazba za programátorské práce se pohybuje kolem 1 500 Kč.

Vývoj vlastního konektoru na míru vyjde přibližně na 10 000 až 14 000 Kč bez DPH. Provozovatelé více e-shopů na stejné platformě mohou využít slevu 50 % na napojení druhého obchodu. Pro detailnější pohled na to, kdy se taková investice vyplatí, doporučujeme náš článek Propojení e-shopu s ERP: Kdy se investice vrátí.

Strategie pro produktová data a varianty#

Pohoda a Shoptet mají odlišný pohled na strukturu produktů. Zatímco Shoptet vnímá varianty jako podpoložky jednoho produktu, Pohoda přistupuje ke každé variantě jako k samostatné skladové kartě.

Doporučená architektura je hybridní přístup. Pohoda by měla být „zdrojem pravdy“ pro kmenová data: SKU, název pro fakturaci, nákupní a prodejní cena, DPH, EAN a hmotnost. Shoptet by naopak měl spravovat marketingové texty, popisy a obrázky (Proceder, 2024).

Pozor na limity polí v Pohodě:

• Jméno zákazníka: Limit 25 znaků.
• Název produktu: Limit 90 znaků.
• Krátký popis: Limit 240 znaků (Shoptet Podpora, 2024).

Pokud tyto limity ignorujete, může dojít k oříznutí dat při zpětném exportu z Pohody do e-shopu. Proto je bezpečnější marketingové texty z Pohody do e-shopu vůbec nepřenášet.

Závěr a doporučení pro praxi#

Automatizace skladu přes Pohodu vyžaduje precizní nastavení číselných řad a skladových hospodářství. Pokud provozujete e-shop na platformě Shoptet, zvažte přechod na tarif Premium, který díky API a webhookům umožňuje real-time synchronizaci bez čekání na dávkové exporty.

Nezapomínejte, že po přenosu objednávky do Pohody by veškeré další úpravy měly probíhat už jen tam. Editace objednávek v obou systémech současně vede ke konfliktům. Cílem je mít systém, kde lidská ruka zasahuje pouze při balení zboží, nikoliv při přepisování údajů z e-mailu do účetnictví.

Časté otázky#