Keď sa povie „Pohoda API“, väčšinou sa tým myslí XML rozhranie. Výrobca, spoločnosť STORMWARE, ho sám označuje ako API a cez neho do Pohody chodia objednávky z e-shopov, doklady z pokladníc aj dáta z ďalších aplikácií. Kto potrebuje dáta len čítať, má pri radoch POHODA SQL a E1 ešte druhú cestu: priamo z databázy. V tomto prehľade nájdete, ako obe cesty fungujú, kedy ktorú použiť a na čo si dať pozor.
Krátka odpoveď
Pohoda má tri cesty k dátam: XML súbory, mServer a priame čítanie z databázy. XML súbory sa spracúvajú dávkovo, napríklad cez príkazový riadok. mServer je HTTP server zabudovaný v Pohode, ktorý prijíma rovnaké XML cez sieť. Rady POHODA SQL a E1 bežia na Microsoft SQL Serveri, takže dáta z nich sa dajú čítať aj priamo. Zápis do Pohody vždy patrí do XML rozhrania, nie do databázy.
Tri cesty k dátam
- XML import a exportPripravíte XML súbor podľa schémy a Pohoda ho spracuje. Spustiť to môžete ručne v programe alebo automaticky cez príkazový riadok. Hodí sa na dávky, napríklad nočný prenos dokladov.
- POHODA mServerRovnaké XML, len posielané cez HTTP alebo HTTPS. Vaša aplikácia pošle požiadavku a hneď dostane odpoveď. Na tom stojí väčšina e-shopových konektorov.
- Priame čítanie z SQLLen pri radoch POHODA SQL a E1. Dáta čítate vyhradeným účtom s právami len na čítanie, bez frontu a bez záťaže programu. Na prehľady a reporty ideálne, na zápis nie.
Ako vyzerá XML komunikácia
Každý XML súbor pre Pohodu má rovnakú obálku. Koreňový element dataPack obsahuje jednotlivé položky dataPackItem a v každej je jeden doklad na import alebo jedna požiadavka na export. Jeden dataPack môže miešať import aj export. Štruktúru opisujú XSD schémy: Pohoda má pre každú agendu vlastnú schému a aktuálna je verzia 2.x. Celý balík schém aj s popisom si stiahnete na webe Stormware. Vývojársku dokumentáciu, teda popis štruktúry, podporované dáta a pri exporte aj filtrovanie a stránkovanie, má výrobca na portáli api.stormware.cz.
Na každú požiadavku dostanete odpoveď. Pri každom doklade v nej nájdete, či prešiel, a ak nie, číslo chyby, popis a cestu XPath k problematickému elementu. Pohoda vie strážiť aj duplicity: keď zapnete kontrolu, rovnaký doklad sa podľa identifikátorov v obálke druhýkrát neimportuje.
Používateľ, pod ktorým XML spracúvate, musí mať v Pohode práva. Na import potrebuje zápis do príslušnej agendy, na export aspoň čítanie. Chýbajúce práva sú jednou z najčastejších príčin, prečo import „nič neurobí“.
Ktoré agendy idú cez XML
Zoznam je široký. Importovať sa dajú okrem iného faktúry, objednávky, ponuky, dopyty, príjemky, výdajky, prevodky, predajky, pokladničné doklady, bankové doklady, zákazky a výroba. Zo zoznamov potom adresy, zásoby, sklady, číselné rady, bankové účty a kategórie internetového obchodu. Export vie navyše napríklad saldo, účtovný denník, strediská, predajné ceny alebo zoznam účtovných jednotiek. Presný a aktuálny prehľad drží Stormware v zozname dokladov na import a na export, aj s ukážkovými súbormi.
mServer v kocke
mServer je súčasť programu POHODA. Počúva na zvolenom porte a XML prijíma metódou POST s typom text/xml. Prihlasuje sa hlavičkou STW-Authorization s údajmi používateľa Pohody a funguje cez HTTP aj HTTPS. Požiadavky spracúva jednu po druhej v poradí, ako prišli, takže veľké dávky je dobré rozložiť. Stav zistíte jednoduchou požiadavkou na adresu /status.
Každá konfigurácia mServera patrí k jednej účtovnej jednotke, teda k jednej firme v jednom účtovnom roku. Bežiaci mServer si navyše vyhradí celú inštanciu programu a výrobca ho odporúča prevádzkovať na serverovom systéme vo vnútornej sieti. Prevádzke, nákladom a praktickým tipom sa podrobne venuje článok mServer v Pohode.
Priame čítanie z databázy
Rady POHODA SQL a E1 ukladajú dáta do Microsoft SQL Servera. Na čítanie tak nepotrebujete ani mServer, ani XML. Stačí vyhradený databázový účet s právami len na čítanie a zabezpečená cesta k serveru. Čítanie ide mimo program a odpoveď príde hneď. Základný rad Pohody používa súborovú databázu, takže tam táto cesta nejde.
Presne tak funguje naša POHODA MCP: AI asistent číta dáta priamo z SQL databázy a mServer ani platené doplnky nepotrebuje. Zápisové akcie vo vyššom tarife potom idú cez XML rozhranie, rovnako ako pri každej inej integrácii.
Do databázy nezapisujte
Zápis priamo do tabuliek obchádza logiku programu: číselné rady, výpočet DPH, väzby medzi dokladmi aj zámky. Výsledkom bývajú doklady, ktoré v Pohode vyzerajú v poriadku, ale nesedia v účtovníctve. Zápis preto vždy veďte cez XML rozhranie.
Na čo si dať pozor
- Nový účtovný rok je nová účtovná jednotka. Konfiguráciu mServera aj XML importu treba na začiatku roka prepnúť na novú jednotku, inak integrácia ďalej pracuje so starým rokom.
- Aktualizácie Pohody. Po aktualizácii je niekedy nutné previesť účtovnú jednotku do novej verzie. Kým sa to nestane, XML spracovanie skončí chybou. Po každej aktualizácii preto overte, že komunikácia znovu beží.
- Zálohy a údržba databázy. Bežiaci mServer drží spojenie s databázou a blokuje niektoré operácie, napríklad zálohovanie. Výrobca neodporúča nechať ho bežať nepretržite ani ho spúšťať ako službu Windows. Spúšťanie a vypínanie sa plánuje cez plánovač úloh.
- Front požiadaviek. mServer spracúva požiadavky postupne. Keď e-shop pošle stovky objednávok naraz, čakajú v rade. Počítajte s tým pri návrhu synchronizácie.
- Verzie schém. Stormware schémy priebežne rozširuje. Validujte XML proti aktuálnemu balíku a sledujte plánované zmeny v kompatibilite.
Postaviť to sám, alebo nie?
Na jednorazový import alebo jednoduchý skript XML rozhranie stačí a dokumentácia je slušná. Hneď ako však potrebujete spoľahlivý obojsmerný prenos, stráženie chýb a opakovanie, práca rýchlo rastie. Možnosti pre e-shopy porovnáva článok Prepojenie Pohody s e-shopom, automatizačné nástroje rozoberá Make, Zapier, n8n a Pohoda. Čo vedia jednotlivé varianty na napojenie ďalších systémov, nájdete pri detaile POHODA Komplet.
Časté otázky
Má Pohoda REST API?
Nie v obvyklom zmysle. Za API výrobca považuje XML rozhranie. Cez mServer ho voláte po HTTP, ale dáta sú vždy XML podľa schém Pohody, nie JSON.
Potrebujem mServer?
Na priebežnú komunikáciu z inej aplikácie áno. Na dávkové spracovanie stačí XML import cez príkazový riadok. A na čítanie pri radoch SQL a E1 nepotrebujete ani jedno, dáta sa dajú čítať priamo z databázy.
Je mServer aj v nižších variantoch Pohody?
Podľa výrobcu je mServer súčasťou všetkých variantov programu POHODA. Niektoré funkcie sa však líšia podľa radu, napríklad rad E1 vie XML komunikáciu spúšťať automaticky priamo z programu.
Kde nájdem XSD schémy a ukážky?
Na webe Stormware v sekcii XML. Je tam kompletný balík schém verzie 2.x na stiahnutie, popis každej schémy a ukážkové požiadavky aj odpovede pre jednotlivé agendy.
Môžem zapisovať priamo do SQL databázy?
Technicky to ide, ale neodporúčame to. Obídete tým logiku programu a riskujete doklady, ktoré nesedia. Zápis patrí do XML rozhrania.
Bol pre vás článok užitočný?
Vďaka za spätnú väzbu!