POHODA mServer: jak propojit cenotvorbu s Pohodou

POHODA mServer umožňuje přijímat XML požadavky a odpovídat na ně přímo z účetního systému POHODA. Pricing Fox umí připravit XML s cenami produktů pro Pohodu a při nastaveném mServeru jej odesílat automaticky. V tomto návodu zjistíte, jak obě části propojit, co zkontrolovat při prvním přenosu a jak číst nejčastější chyby.

Co je POHODA mServer a jak funguje?

POHODA mServer je součást systému POHODA od STORMWARE. Naslouchá na nastavené adrese a portu, přijímá požadavky přes HTTP nebo HTTPS a vyměňuje si XML data metodou požadavek–odpověď. Pro import XML se používá požadavek POST na cestu /xml. Provoz a konfiguraci mServeru popisuje oficiální dokumentace STORMWARE.

V našem scénáři Pricing Fox připraví ceny produktů jako XML kompatibilní s Pohodou. mServer přijme odeslaný soubor a předá jej ke zpracování příslušné účetní jednotce. Zda se jednotlivé položky skutečně zapsaly, je potřeba ověřit v odpovědi mServeru; samotný HTTP stav 200 OK nestačí.

XML výstup, nebo automatický přenos přes mServer?

• XML výstup bez mServeru: Pricing Fox vygeneruje soubor na stálé URL. Jeho načtení a import do Pohody zajistíte vlastním postupem.
• XML s mServerem: po nastavení adresy a autorizace může Pricing Fox odesílat vygenerované XML přímo do Pohody. Přegenerování a odeslání lze spustit ručně; automaticky probíhá každé čtyři hodiny.

V obou případech si zvolíte, zda zahrnout všechny produkty nebo pouze přeceněné, jak je spárovat se skladovými kartami a zda posílat cenu s DPH či bez DPH. mServer tedy nemění obsah XML, ale způsob jeho předání a zpracování.

Jak nastavit propojení Pricing Foxu s Pohodou

1. V Pricing Foxu otevřete Napojení a mezi výstupními konektory vyberte Pohoda XML.

2. Vyberte rozsah a účetní jednotku. Nastavte všechny nebo pouze přeceněné produkty. IČO zadejte přesně podle účetní jednotky v Pohodě.
3. Nastavte párování a cenu. Pro identifikaci skladových položek můžete použít ID, CODE, EXTID, EAN, PLU nebo jejich kombinace. Vyberte odpovídající cenu s DPH či bez DPH.

4. Pro automatický přenos doplňte mServer. Zadejte jeho adresu a port a autorizační hlavičku STW-Authorization. Přístup k mServeru a bezpečné síťové propojení nastavte se správcem sítě; STORMWARE doporučuje provoz ve vnitřní síti a pro přenos přes internet popisuje HTTPS či VPN.
5. Uložte napojení a proveďte zkušební přenos. Pricing Fox vytvoří XML a zobrazí jeho URL. Při vyplněné adrese mServeru jej odešle také do Pohody. Následné přegenerování můžete spustit ručně v přehledu Napojení.

Potřebujete jinou četnost generování? Napište na podpora@pricing-fox.cz.

Jak ověřit, že se ceny v Pohodě aktualizovaly

V konfiguraci mServeru vyberte správnou účetní jednotku a port a instanci spusťte. Na záložce Monitoring můžete zapnout logování. Podle dokumentace STORMWARE se instance spravují v Pohodě přes Databáze → POHODA mServer v agendě Účetní jednotky; při aktivaci HTTPS je třeba odpovídajícím způsobem upravit také URL konektoru.

Po ručním přegenerování napojení sledujte záznam komunikace v mServeru. Otevřete request data a response data, porovnejte IČO, párovací identifikátory a zprávy k jednotlivým položkám. Úspěšný přenos a úspěšné zpracování všech produktů jsou dvě různé věci: odpověď může obsahovat upozornění i při 200 OK.

Nejčastější problémy při propojení

V mServeru není žádný záznam

Ověřte, že instance běží, že adresa, protokol a port v Pricing Foxu odpovídají konfiguraci a že mezi systémy funguje síťové spojení. mServer podle STORMWARE není vhodné bez rozmyslu vystavovat přímo na veřejnou IP; bezpečnou dostupnost řešte se správcem sítě.

401 Unauthorized

Zkontrolujte hlavičku STW-Authorization a přístupové údaje k Pohodě. STORMWARE používá Basic Authentication: uživatelské jméno a heslo ve tvaru jméno:heslo se zakódují do Base64. Neposílejte heslo do podpory ani jej nevkládejte do veřejných snímků obrazovky. Technický formát ověřte v dokumentaci pro vývojáře.

404 Not Found

Prověřte cestu /xml a adresu mServeru. Import XML používá právě tuto cestu; samotná kořenová adresa nebo chybný port nestačí.

„Tento balíček není určen pro tuto jednotku“

Porovnejte IČO v nastavení konektoru s IČO účetní jednotky, kterou obsluhuje spuštěná instance mServeru. Podrobnost hledejte v odpovědi XML.

200 OK, ale některé produkty se nezměnily

Otevřete response data a zkontrolujte upozornění k jednotlivým položkám, jejich párovací identifikátory a hodnoty cen. HTTP 200 OK potvrzuje zpracování požadavku serverem, nikoli bezchybnou aktualizaci každé skladové karty.

V XML chybí produkty nebo ceny

Při volbě Přeceněné produkty se nepřeceněné položky do souboru vůbec nedostanou. Element Nová cena má hodnotu jen u produktů, které Pricing Fox přecenil. Chcete-li posílat cenu každého produktu, zvolte Všechny produkty a element Výstupní cena nebo Výstupní cena s DPH.