Pro vývojáře

Export dat z programu Pohoda na Internetový obchod

Standardní výstupní data z programu POHODA pro Obecný Internetový obchod jsou ve formátu XML. Jedná se o XML formát programu POHODA. Popis a struktura XML je uvedena na adrese WWW.STORMWARE.CZ/XML. XML data jsou v kódování Windows-1250. Potřebujete-li výstupní data z programu POHODA upravit na jiný datový typ, je nutné použít XSLT transformaci. XSLT šablona převede standardní výstupní formát XML POHODA na vámi požadovaný datový soubor. Na webovou službu bude posléze odeslán pouze váš upravený datový soubor.

Po spojení s webovou službou a následném předání výstupních dat z programu POHODA, očekává program POHODA odpověď z webové služby. Na základě této odpovědi vyhodnotí stav komunikace POHODA - Obecný internetový obchod. Aktuální verze komunikace POHODA umožní vyhodnotit pouze dva stavy: (OK, Error).

Program POHODA nemá přesně definovanou datovou strukturu odpovědi z webové služby, pouze je nutné dodržet základní podmínky:

• odpověď webové služby = obecný XML dokument
• XML dokument obsahuje element <rsp:responsePack> s atributem @state
• atribut @state nese hodnotu pro vyhodnocení stavu komunikace (OK,Error)

Příklad XML odpovědi webové služby na export dat z programu POHODA stáhnout.

Import dat do programu POHODA z internetového obchodu

Program POHODA vytvoří požadavek na stažení dat z Obecného internetového obchodu, který předá webové službě. Webová služba požadavek zpracuje a následně předá odpověď zpět programu POHODA. Standardní požadavek z programu POHODA na stažení dat z Obecného internetového obchodu je ve formátu XML. Jedná se o XML souboru programu POHODA.

Popis a struktura dat XML požadavku je uvedena na adrese WWW.STORMWARE.CZ/XML.XML data jsou v kódování Windows-1250. Potřebujete-li požadavek na data z Obecného internetového obchodu upravit na vlastní datový typ, je nutné použít XSLT transformaci. XSLT šablona vám umožní převést standardní požadavek XML z programu POHODA na vámi nadefinovaný soubor. Na webovou službu bude odeslán pouze upravený datový soubor. Program POHODA se spojí s webovou službou,které předá požadavek na stažení dat z Internetového obchodu. Webová služba požadavek převezme, vyhodnotí, zpracuje a vytvoří odpověď, kterou předá zpět programu POHODA.

Příklady XML požadavků na stažení dat z Internetového obchodu do programu POHODA

• neobsahuje informace o stavu komunikace.
• obsahuje pouze data, která jsou určena pro import do programu POHODA.
• v elementu <dataPack> definujeme atribut "ICO" který vybírá účetní jednotka v programu POHODA do které se budou data načítat.

Program POHODA má v tomto případě přesně definovanou strukturu odpovědi webové služby.

Odpověď webové služby musí dodržet základní podmínky:

• jedná se o XML soubor typu POHODA.
• XML musí být validní dle XSD schéma pro danou agendu.

Definice XML souboru naleznete na adrese WWW.STORMWARE.CZ/XML.

Pokud odpověď webové služby:

• není datového typu XML programu POHODA

Pak je nutné použít XSLT transformaci, pro úpravou odpovědi Obecného Internetového obchodu na požadovaný datový typ a strukturu.

Příklad odpovědi webové služby, import dat z Obecný Internetový obchod do POHODA:

Sledování historie komunikace POHODA - Obecný Internetový obchod

Výchozí nastavení komunikace POHODA - Obecný internetový obchod využívá pro ukládání dat komunikace TEMPorary složky operačního systému Windows. V tomto případě není komunikace uchována. Pokud budete chtít sledovat průběh komunikace a její historii, je nutné zapnout v programu Pohoda volbu Sledování komunikace (historie) v agendě Nastavení obecného internetového obchodu.
Dle typu komunikace bude vytvořena podsložka EXPORT/IMPORT, do které budou uloženy datové soubory komunikace (požadavek a odpověd) POHODA - Obecný internetový obchod.
Průběh komunikace je zaznamenán do "Log" souboru, který je uložen v datovém adresáři programu POHODA podadresář LOG. Název souboru je: IOobchod.log
XML dokumenty uložené při sledování historie komunikace jsou uloženy v jiném kódování než soubory, které jsou předány webové službě. XML dokumenty uložené v historii jsou v kódování  "windows-1250".

Struktura Log souboru komunikace POHODA - Obecný Internetový obchod: stáhnout
Vzorový příklad Log souboru komunikace POHODA - Obecný Internetový obchod: stáhnout

Autentizace webové služby

Program POHODA používá jednoduchou autentizaci při přístupu k webové službě.Jedná se tedy o Basic access authentication.

Kontrola duplicity importu dat do programu POHODA

Kontrola duplicity je založena na kontrole importovaných bloků <dataPack> a <dataPackItem>  vstupního XML dokumentu. Tyto bloky obsahují atribut ID, který jednoznačně identifukuje importovaná data.
Při zapnuté kontrole duplicity je zkontrolováno ID bloku <dataPack> a <dataPackItem> oproti seznamu již importovaných XML dokumentů do programu POHODA. Tyto záznamy se nachází v agendě XML log. Pokud je nalezena duplicita, import dat bude ukončen.
Kontrola duplicity nekontroluje duplicitu v účetních datech (Např. číslo dokladu, IČO adresa , atd...). Agenda XML log je ve výchozím nastavení programu POHODA nastavená pro plnou editaci, proto je možné záznamy smazat. Pokud budete chtít zakzát smazání  záznamů v této agendě, je nutné upravit nastavení přístupových práv této agendy v programu POHODA.

Doplňující kontroly importovaných dat:

Doklad objednávka

kontrola importovaného dokladu dle čísla dokladu.

V tomto případě je nutné ve vstupním XML dokumentu uvést element <ord:number> a podelement <typ:numberRequested>. Definice elementu je popsána ve schéma Order.xsd a Type.xsd.Při importu XML dokumentu. který obsahuje tento element bude navíc provedena kontrola na číslo dokladu. Pokud doklad ze stejným číslem v programu POHODA existuje, import bude ukončen.

Doklad Adresa

kontrola importované adresy dle zadaných paramatrů(filtru).

V tomto případě je nutné uvést ve vstupním XML dokumentu element <duplicityFields>,ve kterém budeme definovat parametry pro kontrolu duplicity adresy.
Defincie elementu je popsána ve schéma Addressbook.xsd. Při importu XML dokumentu, který obsahuje tento element bude navíc provedena kontrola na duplicity adresy. Pokud tato adresa již v programu POHODA existuje, import bude ukončen.