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ě Dále je do tohoto tagu volitelně možné uvádět kódování ve formátu ISO
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 (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 Označení jestli se má produkt zobrazovat
IS_AKTIV
-
ID_CATEGORY
INT
Číslo kategorie na straně zdroje
NAME_CATEGORY
TEXT
Název kategorie na straně zdroje
ID_PRODUCT
INT
NAME_PRODUCT
TEXT
Celý zobrazovaný název produktu
PRODUCER
TEXT
Výrobce zboží
PRICE
FLOAT
UNIT
TEXT
Jednotka produktu [m, ks, bal, paleta]
PRODUCT_CODE
TEXT
Volitelný kód produktu na straně zdroje
PRODUCT_DESCRIPTION
TEXT
Krátký popis produktu
PRODUT_DESCRIPTION_TEXT
TEXT
Dlouhý popis produktu
COMMISSION
INT
Provize
DISCOUNT
INT
Rabat (sleva pro systém GATE)
STOCKS
INT
Počet položek skladem
EAN
TEXT
SELLING_UNIT
INT
MIN_ORDER_QTY
INT
WEIGHT_PER_UNIT
INT
Váha v Kg na prodejní jednotku
TYPICAL_PACKAGE
INT
Běžné balení (paleta)
ID na straně zdroje
Cena zboží bez DPH
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)
Párový Vyžadovaný
XML TAG
Datový typ Popis
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
Párový Vyžadovaný
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
DOC_PRODUCT
TEXT
Název dokumentu
DOC_URL_PRODUCT
TEXT
http link, kde se nachází dokument – tato adresa MUSÍ být dostupná bez přihlášení!
Párový Vyžadovaný
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
DES_FOTO
TEXT
Popis obrázku
URL_FOTO
TEXT
http link, kde se nachází obrázek/fotografie – tato adresa MUSÍ být dostupná bez přihlášení!
Párový Vyžadovaný
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
[email protected]
Technická podpora Filip Majerík
[email protected]
Aktuální k 14. 4. 2015
