POHODA
Skladové množstvá, účtovné záznamy, prijaté objednávky a zaužívaný pracovný postup účtovníka.
Prípadová štúdia · API integrácia / E-commerce
Produkčne nasadená integrácia POHODA WooCommerce postavená na reálnych účtovných procesoch
Web25 prepojil e-shop Mirael3D na WooCommerce s programom POHODA prostredníctvom vlastného pluginu pre WordPress. Skladové zásoby sa synchronizujú smerom do e-shopu a kompletné objednávky putujú späť do účtovníctva cez validované XML import/export toky.
Vlastný plugin pre WordPress
WooCommerce
POHODA XML
Obojsmerný tok údajov
Dokumentácia POHODA ↗
English version ↗
Export · skladové zásoby
ZdrojPOHODA · Zásoby
CieľWooCommerce · spárované SKU
✓ 129 produktov spárovaných✓ Predajná zásoba vypočítaná✓ Nesúvisiace záznamy bezpečne preskočené
Import · prijaté objednávky
ZdrojWooCommerce · nové objednávky
CieľPOHODA · Prijaté objednávky
✓ Údaje zákazníka a adresy✓ Položky objednávky a súčty s DPH✓ Historické duplicity zablokované
XML log · odpoveď prijatá
schema.validate() PASSnamespace.resolve() PASSstock.audit() 129 / 129rozdiely 0
✓ Obojsmerná výmena dokončená✓ Produkčné poistky aktívne
POHODA XML ↔ Mirael Connector
Mirael3D · SlovenskoWooCommerce ↔ POHODA
129spárovaných produktov overených jednotlivo
0rozdielov v zásobách pri úplnom audite
Obojsmernávýmena údajov o zásobách a objednávkach
1 deňpred dohodnutým termínom spustenia
Obchodný problém
Jeden sklad, nepripojené systémy a žiadny priestor na odhady
Mirael3D predáva filamenty technickej kvality pre 3D tlač cez WooCommerce. POHODA zostáva účtovným a skladovým systémom, v ktorom sú vedené smerodajné údaje firmy.
Pred integráciou viedli web a POHODA každý vlastnú verziu zásob, zákazníkov a objednávok a tím ich musel zosúlaďovať ručne. Oneskorená aktualizácia zásob mohla spôsobiť, že vypredaný produkt zostal v e-shope dostupný, a každú webovú objednávku bolo treba do účtovníctva prepisovať ručne.
S rastom firmy by bol tento problém čoraz drahší. Mirael3D a dva plánované sesterské e-shopy majú využívať ten istý sklad spravovaný v programe POHODA. Integrácia preto musela vyriešiť dnešný proces a nestať sa slepou uličkou pre jediný obchod.
POHODA v kontexte
Účtovný systém, ktorý vie vymieňať údaje s internetovými obchodmi cez XML
STORMWARE opisuje POHODA ako ekonomický a informačný systém, ktorý podporuje externú dátovú komunikáciu. Všeobecné prepojenie s internetovým obchodom využíva webové služby, protokol HTTP a formáty XML programu POHODA na výmenu adries, objednávok, skladových zásob, kategórií a súvisiacich údajov.
Oficiálna dokumentácia produktuAko POHODA rieši dátovú komunikáciu
Konektor bol vytvorený podľa oficiálnej dokumentácie spoločnosti STORMWARE, stiahnuteľných ukážok XML a zverejnených schém XSD a následne overený na správaní ostrej slovenskej inštalácie klienta.
Architektúra integrácie
Jeden konektor, dva smery údajov a jeden zdroj pravdy
Mirael POHODA Connector sprístupňuje jediný autentifikovaný REST endpoint vo WordPresse. Rozpozná prichádzajúci XML dokument z programu POHODA, pošle požiadavku do správneho procesu a vráti presnú obálku odpovede, akú POHODA očakáva.
Zásoby → WooCommerce
Mirael POHODA Connector
Smerovanie REST požiadaviek, spracovanie XML, tvorba odpovedí, párovanie podľa SKU, pravidlá zásob, export objednávok a prevádzkové poistky.
POHODA ← Objednávky
WooCommerce
Dostupnosť produktov, údaje o zákazníkoch a adresy, položky objednávok, súčty s DPH, stav objednávky a kontrola konceptov produktov.
Čo konektor robí
Integrácia s programom POHODA sleduje prácu, ktorú firma už tak musí vykonať
Zásoby POHODA → WooCommerce
POHODA zostáva zdrojom pravdy pre skladové zásoby. Konektor vypočíta predajné množstvo a aktualizuje iba presne spárované SKU vo WooCommerce.
Objednávky WooCommerce → POHODA
Nové objednávky putujú do programu POHODA s údajmi o zákazníkovi, fakturačnou a dodacou adresou, položkami, cenami, daňou a súčtami. Účtovník už nemusí každú webovú objednávku prepisovať.
Spracovanie stornovaných objednávok
Stornované objednávky z webu sa rozpoznajú, aby v programe POHODA nezostali ako fiktívne záväzky. Nevratný krok je zámerne riadený prepínačom: vypnuté, iba log alebo ostro.
Kontrola nespárovaných produktov
Položku z programu POHODA, ktorá patrí do e-shopu, ale nemá na webe zhodu, možno poslať do osobitnej fronty konceptov produktov. Nikdy sa potichu nezverejní na predaj.
Nástroje na ručné opätovné odoslanie
Administrátori môžu zámerne znova odoslať zriedkavú objednávku, ktorá potrebuje ďalší pokus, bez zásahu do bežného toku importu a exportu.
Konfigurácia pre viac obchodov
Pravidlá špecifické pre jednotlivý obchod sú v samostatnej konfiguračnej vrstve, čo pripravuje rovnakú architektúru konektora pre budúce rakúske a české sesterské e-shopy.
Priebeh realizácie
Od izolovaného vývoja po ostré účtovné údaje v kontrolovaných etapách
Vývoj konektora v izolácii
20. – 21. augusta 2026: plugin, endpoint, XML služby a základné obchodné pravidlá vznikli bez zásahu do ostrého e-shopu či účtovnej databázy.
Nasadenie v režime dry-run
25. augusta: ostré pripojenie bolo zavedené s vypnutým zápisom. Odhalil a vyriešil sa konflikt autentifikácie vo WordPresse, ktorý sa prejavil iba v prostredí HTTPS.
Testovanie na reálnej komunikácii s programom POHODA
27. – 28. augusta: živé pripojenie fungovalo, no chyby v tvare protokolu odhalili rozdiely medzi zjednodušenými testovacími vzorkami, formálnou dokumentáciou a XML, ktoré slovenská inštalácia skutočne posielala.
Prechod na lokálnu validáciu podľa schém
28. augusta: generované dokumenty sa pred nasadením validovali voči zverejneným súborom XSD od spoločnosti STORMWARE. Offline sa počas jedného sedenia podarilo zachytiť ďalšie tri chyby.
Overenie oboch smerov
29. augusta: export zásob z programu POHODA aj import objednávok z WooCommerce sa úspešne dokončili na reálnych údajoch.
Ostrá prevádzka po kontrole človekom
30. augusta: posledný záznam z režimu dry-run sa pred zapnutím ostrého režimu skontroloval riadok po riadku. Všetkých 129 spárovaných produktov sa zhodovalo s programom POHODA.
Dolaďovanie reálnych prevádzkových prípadov
31. augusta – 6. septembra: význam predajnej zásoby, zaokrúhľovanie dane a spracovanie stornovaných objednávok sa upravili podľa reálnej konfigurácie klienta a jeho každodenného účtovného procesu.
Protokolový inžiniering
Špecifikácia bola východiskom. Prácu dokončilo reálne správanie.
Najťažšie nebolo odoslať XML dokument. Bolo treba dosiahnuť, aby sa každý menný priestor, obálka, stav a číslo správali presne tak, ako vyžaduje desktopový klient programu POHODA.
Reálne dokumenty z programu POHODA označujú prvky viacerými mennými priestormi (namespace). Spracovanie sa sústredilo do jednej spoločnej služby a testovacie vzorky sa prepísali tak, aby zodpovedali reálnej komunikácii.
Päť zlyhaní v ostrej prevádzke odhalilo neplatné atribúty, prázdne tvary dokumentov a menný priestor odpovede, ktorý sa nedal bezpečne odvodiť kopírovaním z požiadavky.
POHODA očakáva stav protokolu priamo v XML odpovedi. Vrátenie HTTP 400 pri jedinom chybnom zázname spôsobilo, že desktopový klient zahodil diagnostické telo pre celú dávku.
Slovenská inštalácia programu POHODA u klienta posielala URI menných priestorov s `.cz`, hoci dokumentácia uvádza príklady s `.sk`. Konektor teraz bezpečne vráti ktorúkoľvek z povolených domén uvedených v požiadavke.
Generovaný výstup sa pred nasadením lokálne validuje podľa schém XSD od spoločnosti STORMWARE. Pomalé cykly nasadzovania a hádania nahradila okamžitá, opakovateľná spätná väzba.
Výpočty od sumy bez dane občas dávali rozdiel jedného centa. Integrácia teraz posiela celkovú sumu s DPH a preberá spôsob výpočtu od ceny s daňou, ktorý účtovník akceptuje.
Poučenie o zásobách
„Dostupné“ neznamenalo dostupné na predaj
POHODA zobrazuje pri každej zásobe niekoľko súvisiacich množstiev. Prvá implementácia dôverovala poľu, ktoré vyzeralo ako dostupné množstvo. V konfigurácii klienta však neodpočítavalo všetky prijaté, ale ešte nespracované objednávky, ako sa očakávalo.
Tento predpoklad spôsobil skutočný prípad predaja nad rámec zásob: web predal posledný kus a následné odoslanie zásob z programu POHODA vrátilo pôvodné množstvo skôr, než POHODA objednávku naimportovala.
Trvalé riešenie predpoklad odstránilo. Konektor teraz počíta predajnú zásobu z fyzického množstva na sklade mínus množstvo viazané v objednávkach, výsledok ohraničí nulou a zabráni nechceným objednávkam pri nulovej zásobe (backorder). Výsledok tak nezávisí od názvu poľa ani od nastavenia rezervácií v programe POHODA, ktoré konektor nemôže ovplyvniť.
Dôkazy z ostrej prevádzky
Skutočná konfigurácia programu POHODA za obojsmerným prepojením
Tieto snímky obrazovky z testovania u klienta zobrazujú všeobecný záznam internetového obchodu a samostatné trasy exportu a importu použité pri ostrom nastavení. Obrazovky s autentifikáciou a lokálnou konfiguráciou počítača sú zámerne vynechané.
Integrita údajov
Poistky boli súčasťou produktu, nie dodatkom v deň spustenia
Dry-run ako predvolený režim
Nové prostredia zapisujú do logu presné zamýšľané zmeny bez ich vykonania. Ostrý režim vyžaduje výslovné potvrdenie s uvedením zodpovednej osoby po kontrole.
Párovanie iba podľa SKU
Katalóg v programe POHODA neobsahoval očakávané údaje EAN. Konektor používa jediný spoľahlivý spoločný identifikátor a nejasné prípady radšej preskočí, než by hádal.
Produkty sa dopĺňajú, nie prepisujú
Konektor aktualizuje množstvo zásob. Neprepisuje ceny, popisy produktov, médiá ani SEO polia spravované vo WooCommerce.
842 nesúvisiacich záznamov ignorovaných
Prvý export z programu POHODA obsahoval 971 záznamov. Pravidlá podľa kategórií určili 129 webových produktov a správne ignorovali záznamy patriace k inej obchodnej činnosti.
Hranica historických objednávok
Konektor si zaznamená vlastný začiatok ostrej prevádzky, aby prvé stiahnutie objednávok nezaplavilo POHODA starými objednávkami, ktoré už boli zadané ručne.
Izolácia chýb na úrovni záznamu
Jeden chybný záznam sa stane upozornením iba pre tento záznam. Neznehodnotí dávku stoviek záznamov ani neukryje užitočnú diagnostiku pred účtovníkom.
Výsledok
Zásoby, objednávky a účtovníctvo teraz prechádzajú jedným kontrolovaným procesom
Integrácia nahradila opakované zadávanie údajov a neisté zásoby dohľadateľnou výmenou navrhnutou pre ľudí, ktorí firmu prevádzkujú.
129 / 129spárovaných webových produktov potvrdených voči programu POHODA
0rozdielov v zásobách v poslednom úplnom audite produkt po produkte
Automatickyprenos nových objednávok s údajmi o zákazníkovi, adrese, položkách a DPH
3 e-shopyarchitektúra pripravená pre súčasný obchod a dva plánované sesterské e-shopy
V ostrej prevádzke od 30. augusta 2026
„Objednávky sa dostanú do programu POHODA automaticky a údaje o zásobách sú správne. Web25 to dodal rýchlejšie, než sme čakali.“
Zámerné hranice rozsahu
Čo táto fáza zámerne neautomatizovala
Dva pôvodné nápady zostávajú k dispozícii na neskoršiu fázu. Ani jeden nebol potrebný na to, aby bol proces objednávok a zásob v ostrej prevádzke presný.
Ceny WooCommerce → POHODA
Každá exportovaná objednávka už obsahuje správnu jednotkovú cenu, súčty a DPH. Presnosť účtovníctva nezávisí od samostatnej synchronizácie cien z katalógu.
Katalóg WooCommerce → POHODA
Súčasný katalóg je v programe POHODA už zavedený. Architektúra konektora umožňuje tento smer doplniť neskôr bez prestavby fungujúceho toku zásob a objednávok.
Integračný stack
Účelné komponenty okolo validovanej výmeny údajov
WordPressWooCommerceVlastný PHP pluginREST APIPOHODA XMLValidácia XSDPárovanie podľa SKUPráca s DPHLogovanie dry-runAdministrácia WordPress
Backend a API integrácie
Potrebujete, aby si dva firemné systémy vymieňali údaje bez rizika pre prevádzku?
Web25 vytvára vlastné API, middleware a integrácie platforiem podľa reálnych pravidiel, krajných prípadov a schvaľovacích bodov vášho podnikania.
Pozrite si backendové a API integrácie