Kdy\u017e se \u0159ekne \u201ePohoda API\u201c, v\u011bt\u0161inou se t\u00edm mysl\u00ed XML rozhran\u00ed. V\u00fdrobce, spole\u010dnost STORMWARE, ho s\u00e1m ozna\u010duje jako API a p\u0159es n\u011bj do Pohody chod\u00ed objedn\u00e1vky z e-shop\u016f, doklady z pokladen i data z dal\u0161\u00edch aplikac\u00ed. Kdo pot\u0159ebuje data jen \u010d\u00edst, m\u00e1 u \u0159ad POHODA SQL a E1 je\u0161t\u011b druhou cestu: p\u0159\u00edmo z datab\u00e1ze. V tomhle p\u0159ehledu najdete, jak ob\u011b cesty funguj\u00ed, kdy kterou pou\u017e\u00edt a na co si d\u00e1t pozor.<\/p>\n
Pohoda m\u00e1 t\u0159i cesty k dat\u016fm: XML soubory, mServer a p\u0159\u00edm\u00e9 \u010dten\u00ed z datab\u00e1ze.<\/strong> XML soubory se zpracov\u00e1vaj\u00ed d\u00e1vkov\u011b, nap\u0159\u00edklad p\u0159es p\u0159\u00edkazovou \u0159\u00e1dku. mServer je HTTP server zabudovan\u00fd v Pohod\u011b, kter\u00fd p\u0159ij\u00edm\u00e1 stejn\u00e9 XML p\u0159es s\u00ed\u0165. \u0158ady POHODA SQL a E1 b\u011b\u017e\u00ed na Microsoft SQL Serveru, tak\u017ee data z nich jde \u010d\u00edst i p\u0159\u00edmo. Z\u00e1pis do Pohody v\u017edy pat\u0159\u00ed do XML rozhran\u00ed, ne do datab\u00e1ze.<\/strong><\/p>\n<\/div>\n Ka\u017ed\u00fd XML soubor pro Pohodu m\u00e1 stejnou ob\u00e1lku. Ko\u0159enov\u00fd element Na ka\u017ed\u00fd po\u017eadavek dostanete odpov\u011b\u010f. U ka\u017ed\u00e9ho dokladu v n\u00ed najdete, jestli pro\u0161el, a pokud ne, \u010d\u00edslo chyby, popis a cestu XPath k problematick\u00e9mu elementu. Pohoda um\u00ed hl\u00eddat i duplicity: kdy\u017e zapnete kontrolu, stejn\u00fd doklad se podle identifik\u00e1tor\u016f v ob\u00e1lce podruh\u00e9 neimportuje.<\/p>\n U\u017eivatel, pod kter\u00fdm XML zpracov\u00e1v\u00e1te, mus\u00ed m\u00edt v Pohod\u011b pr\u00e1va. Pro import pot\u0159ebuje z\u00e1pis do p\u0159\u00edslu\u0161n\u00e9 agendy, pro export aspo\u0148 \u010dten\u00ed. Chyb\u011bj\u00edc\u00ed pr\u00e1va jsou jedna z nej\u010dast\u011bj\u0161\u00edch p\u0159\u00ed\u010din, pro\u010d import \u201enic neud\u011bl\u00e1\u201c.<\/p>\n Seznam je \u0161irok\u00fd. Importovat jde mimo jin\u00e9 faktury, objedn\u00e1vky, nab\u00eddky, popt\u00e1vky, p\u0159\u00edjemky, v\u00fddejky, p\u0159evodky, prodejky, pokladn\u00ed doklady, bankovn\u00ed doklady, zak\u00e1zky a v\u00fdrobu. Ze seznam\u016f pak adresy, z\u00e1soby, sklady, \u010d\u00edseln\u00e9 \u0159ady, bankovn\u00ed \u00fa\u010dty a kategorie internetov\u00e9ho obchodu. Export um\u00ed nav\u00edc t\u0159eba saldo, \u00fa\u010detn\u00ed den\u00edk, st\u0159ediska, prodejn\u00ed ceny nebo seznam \u00fa\u010detn\u00edch jednotek. P\u0159esn\u00fd a aktu\u00e1ln\u00ed p\u0159ehled dr\u017e\u00ed Stormware v seznamu doklad\u016f pro import<\/a> a pro export<\/a>, i s uk\u00e1zkov\u00fdmi soubory.<\/p>\n mServer je sou\u010d\u00e1st programu POHODA. Naslouch\u00e1 na zvolen\u00e9m portu a XML p\u0159ij\u00edm\u00e1 metodou POST s typem Ka\u017ed\u00e1 konfigurace mServeru pat\u0159\u00ed k jedn\u00e9 \u00fa\u010detn\u00ed jednotce, tedy k jedn\u00e9 firm\u011b v jednom \u00fa\u010detn\u00edm roce. B\u011b\u017e\u00edc\u00ed mServer si nav\u00edc vyhrad\u00ed celou instanci programu a v\u00fdrobce ho doporu\u010duje provozovat na serverov\u00e9m syst\u00e9mu ve vnit\u0159n\u00ed s\u00edti. Provozu, n\u00e1klad\u016fm a praktick\u00fdm tip\u016fm se podrobn\u011b v\u011bnuje \u010dl\u00e1nek mServer v Pohod\u011b<\/a>.<\/p>\n \u0158ady POHODA SQL a E1 ukl\u00e1daj\u00ed data do Microsoft SQL Serveru. Pro \u010dten\u00ed tak nepot\u0159ebujete ani mServer, ani XML. Sta\u010d\u00ed vyhrazen\u00fd datab\u00e1zov\u00fd \u00fa\u010det s pr\u00e1vy jen pro \u010dten\u00ed a zabezpe\u010den\u00e1 cesta k serveru. \u010cten\u00ed jde mimo program a odpov\u011b\u010f p\u0159ijde hned. Z\u00e1kladn\u00ed \u0159ada Pohody pou\u017e\u00edv\u00e1 souborovou datab\u00e1zi, tak\u017ee tam tahle cesta nejde.<\/p>\n P\u0159esn\u011b tak funguje na\u0161e POHODA MCP<\/a>: AI asistent \u010dte data p\u0159\u00edmo z SQL datab\u00e1ze a mServer ani placen\u00e9 dopl\u0148ky nepot\u0159ebuje. Z\u00e1pisov\u00e9 akce ve vy\u0161\u0161\u00edm tarifu pak jdou p\u0159es XML rozhran\u00ed, stejn\u011b jako u ka\u017ed\u00e9 jin\u00e9 integrace.<\/p>\n Z\u00e1pis p\u0159\u00edmo do tabulek obch\u00e1z\u00ed logiku programu: \u010d\u00edseln\u00e9 \u0159ady, v\u00fdpo\u010det DPH, vazby mezi doklady i z\u00e1mky. V\u00fdsledkem b\u00fdvaj\u00ed doklady, kter\u00e9 v Pohod\u011b vypadaj\u00ed v po\u0159\u00e1dku, ale nesed\u00ed v \u00fa\u010detnictv\u00ed. Z\u00e1pis proto v\u017edy ve\u010fte p\u0159es XML rozhran\u00ed.<\/p>\n<\/div>\n Na jednor\u00e1zov\u00fd import nebo jednoduch\u00fd skript XML rozhran\u00ed sta\u010d\u00ed a dokumentace je slu\u0161n\u00e1. Jakmile ale pot\u0159ebujete spolehliv\u00fd obousm\u011brn\u00fd p\u0159enos, hl\u00edd\u00e1n\u00ed chyb a opakov\u00e1n\u00ed, roste pr\u00e1ce rychle. Mo\u017enosti pro e-shopy srovn\u00e1v\u00e1 \u010dl\u00e1nek Propojen\u00ed Pohody s e-shopem<\/a>, automatiza\u010dn\u00ed n\u00e1stroje rozeb\u00edr\u00e1 Make, Zapier, n8n a Pohoda<\/a>. Co um\u00ed jednotliv\u00e9 varianty pro napojen\u00ed dal\u0161\u00edch syst\u00e9m\u016f, najdete u detailu POHODA Komplet<\/a>.<\/p>\n Ne v obvykl\u00e9m smyslu. Za API v\u00fdrobce pova\u017euje XML rozhran\u00ed. P\u0159es mServer ho vol\u00e1te po HTTP, ale data jsou v\u017edy XML podle sch\u00e9mat Pohody, ne JSON.<\/p>\n<\/details>\n Pro pr\u016fb\u011b\u017enou komunikaci z jin\u00e9 aplikace ano. Pro d\u00e1vkov\u00e9 zpracov\u00e1n\u00ed sta\u010d\u00ed XML import p\u0159es p\u0159\u00edkazovou \u0159\u00e1dku. A pro \u010dten\u00ed u \u0159ad SQL a E1 nepot\u0159ebujete ani jedno, data jdou \u010d\u00edst p\u0159\u00edmo z datab\u00e1ze.<\/p>\n<\/details>\n Podle v\u00fdrobce je mServer sou\u010d\u00e1st\u00ed v\u0161ech variant programu POHODA. N\u011bkter\u00e9 funkce se ale li\u0161\u00ed podle \u0159ady, nap\u0159\u00edklad \u0159ada E1 um\u00ed XML komunikaci spou\u0161t\u011bt automaticky p\u0159\u00edmo z programu.<\/p>\n<\/details>\n Na webu Stormware v sekci XML. Je tam kompletn\u00ed bal\u00edk sch\u00e9mat verze 2.x ke sta\u017een\u00ed, popis ka\u017ed\u00e9ho sch\u00e9matu a uk\u00e1zkov\u00e9 po\u017eadavky i odpov\u011bdi pro jednotliv\u00e9 agendy.<\/p>\n<\/details>\n Technicky to jde, ale nedoporu\u010dujeme to. Obejdete t\u00edm logiku programu a riskujete doklady, kter\u00e9 nesed\u00ed. Z\u00e1pis pat\u0159\u00ed do XML rozhran\u00ed.<\/p>\n<\/details>\n","protected":false},"excerpt":{"rendered":" Co se v Pohod\u011b mysl\u00ed pod slovem API, jak funguje XML import a export, k \u010demu je mServer a kdy sta\u010d\u00ed \u010d\u00edst data p\u0159\u00edmo z SQL datab\u00e1ze. P\u0159ehled pro v\u00fdvoj\u00e1\u0159e i pro ty, kdo integraci zad\u00e1vaj\u00ed.<\/p>\n","protected":false},"author":0,"featured_media":72170,"template":"","erpedie-topic":[100,104],"class_list":["post-72169","erpedie","type-erpedie","status-publish","has-post-thumbnail","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/symmy.com\/cs\/wp-json\/wp\/v2\/erpedie\/72169","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/symmy.com\/cs\/wp-json\/wp\/v2\/erpedie"}],"about":[{"href":"https:\/\/symmy.com\/cs\/wp-json\/wp\/v2\/types\/erpedie"}],"version-history":[{"count":0,"href":"https:\/\/symmy.com\/cs\/wp-json\/wp\/v2\/erpedie\/72169\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/symmy.com\/cs\/wp-json\/wp\/v2\/media\/72170"}],"wp:attachment":[{"href":"https:\/\/symmy.com\/cs\/wp-json\/wp\/v2\/media?parent=72169"}],"wp:term":[{"taxonomy":"erpedie-topic","embeddable":true,"href":"https:\/\/symmy.com\/cs\/wp-json\/wp\/v2\/erpedie-topic?post=72169"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}T\u0159i cesty k dat\u016fm<\/h2>\n
\n
Jak vypad\u00e1 XML komunikace<\/h2>\n
dataPack<\/code> obsahuje jednotliv\u00e9 polo\u017eky dataPackItem<\/code> a v ka\u017ed\u00e9 je jeden doklad k importu nebo jeden po\u017eadavek na export. Jeden dataPack<\/code> m\u016f\u017ee m\u00edchat import i export. Strukturu popisuj\u00ed XSD sch\u00e9mata: Pohoda m\u00e1 pro ka\u017edou agendu vlastn\u00ed sch\u00e9ma a aktu\u00e1ln\u00ed je verze 2.x. Cel\u00fd bal\u00edk sch\u00e9mat i s popisem si st\u00e1hnete na webu Stormware<\/a>. V\u00fdvoj\u00e1\u0159skou dokumentaci, tedy popis struktury, podporovan\u00e1 data a u exportu i filtrov\u00e1n\u00ed a str\u00e1nkov\u00e1n\u00ed, m\u00e1 v\u00fdrobce na port\u00e1lu api.stormware.cz<\/a>.<\/p>\nKter\u00e9 agendy jdou p\u0159es XML<\/h2>\n
mServer v kostce<\/h2>\n
text\/xml<\/code>. P\u0159ihla\u0161uje se hlavi\u010dkou STW-Authorization<\/code> s \u00fadaji u\u017eivatele Pohody a funguje p\u0159es HTTP i HTTPS. Po\u017eadavky zpracov\u00e1v\u00e1 jeden po druh\u00e9m v po\u0159ad\u00ed, jak p\u0159i\u0161ly, tak\u017ee velk\u00e9 d\u00e1vky je dobr\u00e9 rozlo\u017eit. Stav zjist\u00edte jednoduch\u00fdm po\u017eadavkem na adresu \/status<\/code>.<\/p>\nP\u0159\u00edm\u00e9 \u010dten\u00ed z datab\u00e1ze<\/h2>\n
Do datab\u00e1ze nezapisujte<\/h2>\n
Na co si d\u00e1t pozor<\/h2>\n
\n
Postavit to s\u00e1m, nebo ne?<\/h2>\n
\u010cast\u00e9 ot\u00e1zky<\/h2>\n
M\u00e1 Pohoda REST API?<\/summary>\n
Pot\u0159ebuji mServer?<\/summary>\n
Je mServer i v ni\u017e\u0161\u00edch variant\u00e1ch Pohody?<\/summary>\n
Kde najdu XSD sch\u00e9mata a uk\u00e1zky?<\/summary>\n
M\u016f\u017eu zapisovat p\u0159\u00edmo do SQL datab\u00e1ze?<\/summary>\n