Gdy mowa o \u201ePOHODA API\u201c, zwykle chodzi o interfejs XML. Producent, firma STORMWARE, sam nazywa go API i w\u0142a\u015bnie przez niego do POHODY trafiaj\u0105 zam\u00f3wienia ze sklep\u00f3w internetowych, dokumenty z kas i dane z innych aplikacji. Kto potrzebuje danych tylko do odczytu, ma w liniach POHODA SQL i E1 jeszcze drug\u0105 drog\u0119: prosto z bazy danych. W tym przegl\u0105dzie znajdziesz, jak dzia\u0142aj\u0105 obie drogi, kiedy kt\u00f3rej u\u017cy\u0107 i na co uwa\u017ca\u0107.<\/p>\n
POHODA ma trzy drogi do danych: pliki XML, mServer i bezpo\u015bredni odczyt z bazy.<\/strong> Pliki XML przetwarza si\u0119 wsadowo, na przyk\u0142ad z wiersza polece\u0144. mServer to serwer HTTP wbudowany w POHOD\u0118, kt\u00f3ry przyjmuje ten sam XML przez sie\u0107. Linie POHODA SQL i E1 dzia\u0142aj\u0105 na Microsoft SQL Server, wi\u0119c dane mo\u017cna z nich czyta\u0107 tak\u017ce bezpo\u015brednio. Zapis do POHODY zawsze powinien i\u015b\u0107 przez interfejs XML, nie przez baz\u0119.<\/strong><\/p>\n<\/div>\n Ka\u017cdy plik XML dla POHODY ma t\u0119 sam\u0105 kopert\u0119. Element g\u0142\u00f3wny Na ka\u017cde \u017c\u0105danie dostajesz odpowied\u017a. Przy ka\u017cdym dokumencie znajdziesz w niej informacj\u0119, czy przeszed\u0142, a je\u015bli nie, numer b\u0142\u0119du, opis i \u015bcie\u017ck\u0119 XPath do problematycznego elementu. POHODA potrafi te\u017c pilnowa\u0107 duplikat\u00f3w: po w\u0142\u0105czeniu kontroli ten sam dokument nie zostanie zaimportowany drugi raz na podstawie identyfikator\u00f3w w kopercie.<\/p>\n U\u017cytkownik, na kt\u00f3rego koncie przetwarzasz XML, musi mie\u0107 w POHODZIE uprawnienia. Do importu potrzebuje zapisu w danej agendzie, do eksportu co najmniej odczytu. Brak uprawnie\u0144 to jedna z najcz\u0119stszych przyczyn, dla kt\u00f3rych import \u201enic nie robi\u201c.<\/p>\n Lista jest d\u0142uga. Importowa\u0107 mo\u017cna mi\u0119dzy innymi faktury, zam\u00f3wienia, oferty, zapytania, przyj\u0119cia, wydania, przesuni\u0119cia, paragony, dokumenty kasowe, dokumenty bankowe, zlecenia i produkcj\u0119. Z list: adresy, zapasy, magazyny, serie numeracji, rachunki bankowe i kategorie sklepu internetowego. Eksport obejmuje dodatkowo na przyk\u0142ad saldo, dziennik ksi\u0119gowy, centra koszt\u00f3w, ceny sprzeda\u017cy czy list\u0119 jednostek ksi\u0119gowych. Dok\u0142adny i aktualny przegl\u0105d Stormware prowadzi w li\u015bcie dokument\u00f3w do importu<\/a> i do eksportu<\/a>, razem z przyk\u0142adowymi plikami.<\/p>\n mServer jest cz\u0119\u015bci\u0105 programu POHODA. Nas\u0142uchuje na wybranym porcie i przyjmuje XML metod\u0105 POST z typem Ka\u017cda konfiguracja mServera nale\u017cy do jednej jednostki ksi\u0119gowej, czyli jednej firmy w jednym roku obrotowym. Uruchomiony mServer rezerwuje te\u017c ca\u0142\u0105 instancj\u0119 programu, a producent zaleca uruchamia\u0107 go na systemie serwerowym w sieci wewn\u0119trznej. Eksploatacj\u0119, koszty i praktyczne wskaz\u00f3wki szczeg\u00f3\u0142owo omawia artyku\u0142 mServer w POHODZIE<\/a>.<\/p>\n Linie POHODA SQL i E1 przechowuj\u0105 dane w Microsoft SQL Server. Do odczytu nie potrzebujesz wi\u0119c ani mServera, ani XML. Wystarczy dedykowane konto bazy danych tylko do odczytu i bezpieczny dost\u0119p do serwera. Odczyt odbywa si\u0119 poza programem, a odpowied\u017a przychodzi od razu. Podstawowa linia POHODY u\u017cywa bazy plikowej, wi\u0119c tam ta droga nie dzia\u0142a.<\/p>\n Dok\u0142adnie tak dzia\u0142a nasze POHODA MCP<\/a>: asystent AI czyta dane prosto z bazy SQL i nie potrzebuje mServera ani p\u0142atnych dodatk\u00f3w. Akcje zapisu w wy\u017cszej taryfie id\u0105 natomiast przez interfejs XML, tak jak w ka\u017cdej innej integracji.<\/p>\n Zapis bezpo\u015brednio do tabel omija logik\u0119 programu: serie numeracji, wyliczanie VAT, powi\u0105zania mi\u0119dzy dokumentami i blokady. Skutkiem s\u0105 dokumenty, kt\u00f3re w POHODZIE wygl\u0105daj\u0105 poprawnie, ale nie zgadzaj\u0105 si\u0119 w ksi\u0119gowo\u015bci. Zapis zawsze prowad\u017a przez interfejs XML.<\/p>\n<\/div>\n Do jednorazowego importu albo prostego skryptu interfejs XML wystarczy, a dokumentacja jest przyzwoita. Gdy jednak potrzebujesz niezawodnej synchronizacji w obie strony, pilnowania b\u0142\u0119d\u00f3w i ponawiania, pracy szybko przybywa. Mo\u017cliwo\u015bci dla sklep\u00f3w internetowych por\u00f3wnuje artyku\u0142 Po\u0142\u0105czenie POHODY ze sklepem internetowym<\/a>, narz\u0119dzia automatyzacji omawia Make, Zapier, n8n i POHODA<\/a>. Co potrafi\u0105 poszczeg\u00f3lne warianty przy pod\u0142\u0105czaniu kolejnych system\u00f3w, znajdziesz w opisie POHODA Komplet<\/a>.<\/p>\n Nie w zwyk\u0142ym sensie. Za API producent uwa\u017ca interfejs XML. Przez mServer wywo\u0142ujesz go po HTTP, ale dane s\u0105 zawsze w XML zgodnym ze schematami POHODY, nie w JSON.<\/p>\n<\/details>\n Do bie\u017c\u0105cej komunikacji z innej aplikacji tak. Do przetwarzania wsadowego wystarczy import XML z wiersza polece\u0144. A do odczytu w liniach SQL i E1 nie potrzebujesz \u017cadnego z nich, dane mo\u017cna czyta\u0107 prosto z bazy.<\/p>\n<\/details>\n Wed\u0142ug producenta mServer jest cz\u0119\u015bci\u0105 wszystkich wariant\u00f3w programu POHODA. Niekt\u00f3re funkcje r\u00f3\u017cni\u0105 si\u0119 jednak w zale\u017cno\u015bci od linii, na przyk\u0142ad linia E1 potrafi uruchamia\u0107 komunikacj\u0119 XML automatycznie wprost z programu.<\/p>\n<\/details>\n Na stronie Stormware w sekcji XML. Jest tam kompletny pakiet schemat\u00f3w w wersji 2.x do pobrania, opis ka\u017cdego schematu oraz przyk\u0142adowe \u017c\u0105dania i odpowiedzi dla poszczeg\u00f3lnych agend.<\/p>\n<\/details>\n Technicznie si\u0119 da, ale tego nie polecamy. Omijasz logik\u0119 programu i ryzykujesz dokumenty, kt\u00f3re si\u0119 nie zgadzaj\u0105. Zapis nale\u017cy do interfejsu XML.<\/p>\n<\/details>\n","protected":false},"excerpt":{"rendered":" Co w systemie POHODA oznacza API, jak dzia\u0142a import i eksport XML, do czego s\u0142u\u017cy mServer i kiedy wystarczy czyta\u0107 dane prosto z bazy SQL. Przegl\u0105d dla programist\u00f3w i dla tych, kt\u00f3rzy integracj\u0119 zlecaj\u0105.<\/p>\n","protected":false},"author":0,"featured_media":72170,"template":"","erpedie-topic":[100,104],"class_list":["post-72176","erpedie","type-erpedie","status-publish","has-post-thumbnail","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/symmy.com\/pl\/wp-json\/wp\/v2\/erpedie\/72176","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/symmy.com\/pl\/wp-json\/wp\/v2\/erpedie"}],"about":[{"href":"https:\/\/symmy.com\/pl\/wp-json\/wp\/v2\/types\/erpedie"}],"version-history":[{"count":0,"href":"https:\/\/symmy.com\/pl\/wp-json\/wp\/v2\/erpedie\/72176\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/symmy.com\/pl\/wp-json\/wp\/v2\/media\/72170"}],"wp:attachment":[{"href":"https:\/\/symmy.com\/pl\/wp-json\/wp\/v2\/media?parent=72176"}],"wp:term":[{"taxonomy":"erpedie-topic","embeddable":true,"href":"https:\/\/symmy.com\/pl\/wp-json\/wp\/v2\/erpedie-topic?post=72176"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Trzy drogi do danych<\/h2>\n
\n
Jak wygl\u0105da komunikacja XML<\/h2>\n
dataPack<\/code> zawiera pojedyncze pozycje dataPackItem<\/code>, a w ka\u017cdej jest jeden dokument do importu albo jedno \u017c\u0105danie eksportu. Jeden dataPack<\/code> mo\u017ce \u0142\u0105czy\u0107 import i eksport. Struktur\u0119 opisuj\u0105 schematy XSD: POHODA ma osobny schemat dla ka\u017cdej agendy, a aktualna jest wersja 2.x. Ca\u0142y pakiet schemat\u00f3w wraz z opisem pobierzesz ze strony Stormware<\/a>. Dokumentacj\u0119 dla programist\u00f3w, czyli opis struktury, obs\u0142ugiwane dane, a przy eksporcie tak\u017ce filtrowanie i stronicowanie, producent udost\u0119pnia na portalu api.stormware.cz<\/a>.<\/p>\nKt\u00f3re agendy obs\u0142uguje XML<\/h2>\n
mServer w skr\u00f3cie<\/h2>\n
text\/xml<\/code>. Uwierzytelnia si\u0119 nag\u0142\u00f3wkiem STW-Authorization<\/code> z danymi u\u017cytkownika POHODY i dzia\u0142a przez HTTP i HTTPS. \u017b\u0105dania przetwarza po kolei, w kolejno\u015bci przyj\u0119cia, dlatego du\u017ce wsady warto roz\u0142o\u017cy\u0107. Stan sprawdzisz prostym \u017c\u0105daniem na adres \/status<\/code>.<\/p>\nBezpo\u015bredni odczyt z bazy<\/h2>\n
Nie zapisuj do bazy<\/h2>\n
Na co uwa\u017ca\u0107<\/h2>\n
\n
Budowa\u0107 samemu czy nie?<\/h2>\n
Najcz\u0119stsze pytania<\/h2>\n
Czy POHODA ma REST API?<\/summary>\n
Czy potrzebuj\u0119 mServera?<\/summary>\n
Czy mServer jest te\u017c w ni\u017cszych wariantach POHODY?<\/summary>\n
Gdzie znajd\u0119 schematy XSD i przyk\u0142ady?<\/summary>\n
Czy mog\u0119 zapisywa\u0107 bezpo\u015brednio do bazy SQL?<\/summary>\n