Modul Univerzální import/export slouží pro výměnu dat mezi klientskou aplikací a internetovým obchodem. Komunikace probíhá výměnou XML souborů jak pro import (soubory jsou nahrávány do FTP adresáře), tak i pro export dat.
Import
Importní XSD schémata a příklady struktury XML naleznete v našem dalším manuálu.
Vkládání dat pomocí speciální sestavy
Importní soubory lze také sdružit do jednoho souboru a to tak, že obsahy jednotlivých dílčích importů budou vloženy do root elementu (<data></data>) hlavního importního souboru. V tomto případě již nezáleží na pořadí jednotlivých dílčích importů v hlavním importním souboru.
Postup importu dat na internetový obchod
Příprava:
Pro import dat na internetový obchod byl na FTP serveru vyhrazen adresář „files/universalTransport/import/“. Pokud adresář neexistuje, je nutné zajistit jeho vytvoření.
Nahrání importních souborů na FTP server:
Před nahráním importovaných souborů do vyhrazeného adresáře je potřeba smazat veškerý jeho obsah, aby nedošlo k importu zastaralých XML souborů. Poté je možné nahrát importní soubory do importního adresáře na FTP serveru.
Zavolání importní URL adresy pro zpracování dat:
URL adresa je unikátní v rámci internetového obchodu. O tuto adresu si můžete zažádat u podpory internetového obchodu.
Příklad URL adresy: http://mojedomena.cz/customdatafeed/5A6001D2-0872-46F4-9B14-173263BC590B?*
* Parametry
- task=runImport -> Aplikace zajistí import všech XML souborů v importním adresáři. Stránka vrací výsledek ID logu daného importu.
- task=importStatus&logBatchId={ID log záznamu} -> Aplikace zjistí, v jakém stavu je import pro dané ID logu. Výsledkem je XML se stavem importu.
Vysvětlivky:
LogBatch/@DateStart: atribut obsahuje datum a čas startu importu
LogBatch/@DateEnd: atribut obsahuje datum a čas ukončení importu
LogBatch/@State: atribut obsahuje stav importu (3 – ok, 2 – varování, 1 – chyba)
LogBatch/SubLogBatch: element obsahuje dílčí operace importu
LogBatch/Logs: element obsahuje podrobnější popisy operací importu včetně chyb
LogBatch/Logs/Log: element obsahuje detailní popis dané operace
LogBatch/Logs/Log/@State: atribut obsahuje stav importu (3 – ok, 2 – varování, 3 – chyba)
LogBatch/Logs/Log/@Code: atribut obsahuje kód dané operace
LogBatch/Logs/Log/@CategoryCode: atribut obsahuje kód kategorie operace
LogBatch/Logs/Log/@Message: atribut obsahuje textovou zprávu o stavu dané operace
LogBatch/Logs/Log/LogDetail: element obsahuje XML s přehledem o událostech importu
Export
Exportovat lze tyto entity:
Zavolání exportní URL pro export objednávek z internetového obchodu:
URL adresa je unikátní v rámci internetového obchodu. O tuto adresu si můžete zažádat u podpory internetového obchodu.
Příklad URL adresy: http://mojedomena.cz/customdatafeed/5A6001D2-0872-46F4-9B14-173263BC590B?*
* Parametry jsou odděleny oddělovačem "&":