Popis XML struktury a XML souboru Verze XML 1.2
1. Soubor XML základní požadavky Pro import do systému Gate Biosuntec, je nutné, aby soubor XML obsahoval hlavičku souboru XML a zároveň počáteční tag XML ve formátu minimálně <?xml version="1.0"?> Dále je do tohoto tagu volitelně možné uvádět kódování ve formátu ISO <?xml version="1.0" encoding="windows-1250"?> 2. Povinné položky XML souboru XML soubor musí nutně obsahovat následující tagy ID_SUBJECT ID subjektu, který zboží importuje/exportuje TIME_STAMP časové razítko vygenerování exportu PRODUCTS obalovací tag pro produkty bez těchto tagů nebude XML vůbec parsováno a tudíž ho nebude možné použít k importování zboží. V případě, že bude prováděn import mezi systémy Gate Biosuntec (např. ze Slovenské verze do České), tento Export se generuje automaticky systémem Gate a ID_SUBJECT se NEMUSÍ shodovat s ID subjektu v druhém systému. V tomto případě je pak ID_SUBJECT automaticky systémem nahrazeno správným ID v novém systému. 3. Tabulka základních XML tagů pro zboží v tagu PRODUCT Zboží jako celek je zabaleno v tagu PRODUCTS, a jednotlivé zboží je pak zabaleno v tagu PRODUCT. XML TAG XML značka, která označuje část XML (např. NAME_PRODUCT == Jméno produkut) Popis popis tagu co systém očekává, že v daném tagu nalezne Datový typ očekávaný datový typ, který bude načten. V případě že bude nalezen text tam, kde je vyžadováno číslo, může se stát, že tag bude přečten jako 0 (nula). Párový tag musí mít otevírací a ukončovací značku, v případě že chcete zadat prázdnou hodnotu nebo v systému tuto hodnotu vůbec nemáte, lze uvádět </TAG> (zapsat ho jako nepárový) a pokud je tag nevyžadovaný systém ho bude brát jako prázdný. Vyžadovaný označuje vyžadovaný tag, který je nutný pro import daného zboží, pokud takový tag nebude u zboží nalezen, bude automaticky zboží označeno za nevalidní a při importu je takové zboží automaticky zahozeno.
XML TAG Datový typ Popis Párový Vyžadovaný IS_AKTIV - Označení jestli se má produkt zobrazovat ID_CATEGORY INT Číslo kategorie na straně zdroje NAME_CATEGORY Název kategorie na straně zdroje ID_PRODUCT INT ID na straně zdroje NAME_PRODUCT Celý zobrazovaný název produktu PRODUCER Výrobce zboží PRICE FLOAT Cena zboží bez DPH UNIT Jednotka produktu [m, ks, bal, paleta] PRODUCT_CODE Volitelný kód produktu na straně zdroje PRODUCT_DESCRIPTION Krátký popis produktu PRODUT_DESCRIPTION_ Dlouhý popis produktu COMMISSION INT Provize DISCOUNT INT Rabat (sleva pro systém GATE) STOCKS INT Počet položek skladem EAN SELLING_UNIT MIN_ORDER_QTY INT INT Kód EAN není ověřován, jestli je validní. Doporučujeme udávat EAN13. Prodejní jednotka (počet m.j. na objednané množství 1 ks == 1000 ks) Minimální objednatelné množství počítá se v prodejních jednotkách (2 ks == 2000 ks při prodejní jednotce 1000 ks) WEIGHT_PER_UNIT INT Váha v Kg na prodejní jednotku TYPICAL_PACKAGE INT Běžné balení (paleta)
XML TAG Datový typ Popis Párový Vyžadovaný IS_BAZAR - Označení, že jde o bazarovou položku IS_COMMISSION - Označení, že jde o prodej zboží v komisním prodeji IS_ACTION - Označení, že jde o zboží v akci FOTOS - Obalový tag pro fotografie/obrázky DOC_PRODUCTS - Obalový tag pro dokumenty 4. Rozšíření tagu PRODUCT o dokumenty a obrázky (fotografie) Systém Gate BIOSUNTEC v současné době umožňuje přidání pouze jednoho obrázku a jednoho dokumentu. Proto doporučujeme řadění dokumentů a obrázků provádět dle pořadí důležitosti. V případě, že se systému nepodaří dokument či obrázek stáhnout, bude pokračovat stahováním dalších souborů, až dokud nenarazí na první stažitelný. Dokumenty Pro dokumenty je vyhrazen v tagu PRODUCT nepovinný párový tag DOC_PRODUCTS, který v sobě uchovává položky v párovém tagu DOC. V tagu DOC jsou následně vyžadovány následující položky: XML TAG Datový typ Popis Párový Vyžadovaný DOC_PRODUCT Název dokumentu DOC_URL_PRODUCT http link, kde se nachází dokument tato adresa MUSÍ být dostupná bez přihlášení! Obrázky/Fotografie Pro obrázky a fotogragie je vyhrazen v tagu PRODUCT nepovinný párový tag FOTOS, který v sobě uchovává položky v párovém tagu FOTO. V tagu FOTO jsou následně vyžadovány následující položky: XML TAG Datový typ Popis Párový Vyžadovaný DES_FOTO Popis obrázku URL_FOTO http link, kde se nachází obrázek/fotografie tato adresa MUSÍ být dostupná bez přihlášení!
5. Testování XML Importu Pro testování XML importu pro Vás byl připraven testovací skript na adrese http://gate.biosuntec.sk/xml_import.php http://gate.biosuntec.cz/xml_import.php Zde si můžete ověřit, že Váš XML soubor je platný a validní a získáte zobrazení, jak bude zpracován našim systémem. V tomto testovacím skriptu taktéž získáte informace o počtu produktů ve Vašem XML souboru, kolik produktů z toho je validních (tedy může být importováno) a kolik produktů je nevalidních. Testovací skript zároveň zobrazuje definitivní počet kategorií, které byly nalezeny ve Vašem XML souboru. Soubor lze testovat jak přímo on-line (tzn. z http odkazu) nebo provést upload XML souboru. Stejným způsobem pak lze provést reálný import přímo do systému Gate BIOSUNTEC. 6. Vzorový importní soubor XML Byl vytvořen taktéž vzorový importní soubor XML, který je dostupný z adres http://gate.biosuntec.sk/import.xml http://gate.biosuntec.cz/import.xml Tento soubor je zároveň načítán testovacím skriptem importu jako základní soubor XML, který vidíte po vstupu na výše uvedené adresy pro testování XML importu. Vytvořeno BIOSUNTEC CZ s.r.o. Kuklenská 1489 Hradec Králové 500 02 biosuntec@biosuntec.cz Technická podpora Filip Majerík info@malicky.eu Aktuální k 14. 4. 2015