Kabelmánie s.r.o. Popis exportů XML Technická dokumentace exportu zboží prostřednictvím datového XML souboru v. 2.2 - červen 2015
METODIKA IMPORTU ZBOŽÍ POMOCÍ XML Každý z partnerů si může nastavit konkrétní oddělení zboží, které požaduje, aby se ukládalo do XML souboru, který následně použije pro import zboží do svého eshopu. Z XML souboru lze také vyloučit konkrétní katalogová čísla zboží. Veškeré nastavení najdete po přihlášení v levém uživatelském menu pod položkou Nastavení exportu XML. Pro každého partnera se generuje jeho vlastní datový XML soubor. Hlavní XML datový soubor a soubor se seznamem kategorií se automaticky generuje každý den ve 23:45h. XML soubor se skladovou dostupností se generuje každých 10 minut. Odkazy na jednotlivé XML soubory najdete na výše uvedené stránce, kde můžete soubory vygenerovat i manuálně v libovolný čas pomocí tlačítka uložit. Export zboží je rozdělen do tří souborů: catxxxx.xml - soubor obsahující informace k Vámi vybraným oddělením zboží skladv2.xml - soubor obsahující pouze aktuální skladovou dostupnost xxxx.xml - hlavní datový soubor obsahující veškeré informace o zboží (ceny, popisy atd.) xxxx - zástupný symbol pro ID partnera v naší databázi. Například 45123. Podrobné popisy k jednotlivým souborům najdete na následujících stranách. 1
POPIS SOUBORU CATXXXX.XML V tomto XML souboru jsou vypsána všechna oddělení, pododdělení a jejich ID, které jste si vybrali na stránce s nastavením XML exportu. Popis jednotlivých elementů: <CATEGORIES> - počáteční značka XML souboru <CATEGORY> - obsahuje informace ke konkrétní kategorii <ID> - ID kategorie <NAME> - název kategorie <PARENT_ID> - ID nadřazené kategorie <LEVEL> - obsahuje informace o hloubce zanoření kategorií, hlavní kategorie mají hodnotu 0, jejich podkategorie 1 atd. </CATEGORY> - koncová značka Příklad struktury jedné položky zboží v XML: <CATEGORY> <ID>1</ID> <NAME>Baterie do mobilu</name> <PARENT_ID>0</PARENT_ID> <LEVEL>0</LEVEL> </CATEGORY> 2
POPIS SOUBORU SKLADV2.XML Soubor http://www.kabelmanie.cz/skladv2.xml obsahuje informace o aktuální skladové dostupnosti veškerého zboží, které je v našem eshopu. Tedy i v kategoriích, které nemáte vybrány k exportu. Tento soubor je společný pro všechny obchodní partnery. Soubor se automaticky generuje každých 10 minut. Pro párování dostupnosti se zbožím doporučujeme používat element <CATNUM> (katalogové číslo). Popis jednotlivých elementů: <SHOP> - počáteční značka souboru <PRODUCT> - značka uzavírající informace o skladové dostupnosti k jednomu konkrétnímu produktu <CATNUM> - katalogové číslo <STOCK> - položka nabývá hodnoty Skladem pokud je produkt skladem, v opačném případě se nezobrazuje <QUANTITY> - množství produktů skladem, pokud produkty skladem nejsou, nezobrazuje se <DATE> - přesné datum expedice z našeho skladu (zobrazuje se, pokud není zobrazeno <STOCK> <DAYS> - počet dní k expedici z našeho skladu (zobrazuje se pokud není <STOCK> a <DATE>, např.: 2 dny, 4 dny atd. Hodnota 98 označuje, že po vyprodání zboží se automaticky v našem eshopu skryje. </SHOP> - koncová značka souboru Příklad struktury dostupnosti položek zboží v XML: <PRODUCT> <CATNUM>160303</CATNUM> <STOCK>Skladem</STOCK> <QUANTITY>2</QUANTITY> </PRODUCT> <PRODUCT> <CATNUM>179979</CATNUM> <DATE>13.6.2012</DATE> </PRODUCT> <PRODUCT> <CATNUM>KUS2AB5</CATNUM> <DAYS>2 dny</days> </PRODUCT> 3
POPIS SOUBORU XXXX.XML Hlavní datový soubor obsahuje veškeré informace o zboží - název, ceny, url k obrázkům, ID oddělení apod. Tento soubor se generuje jednou denně v 23:45h. Každý z obchodních partnerů má svůj unikátní soubor. Doporučujeme soubor importovat jedenkrát denně. Hlavní obrázek a obrázky z galerie můžete importovat pouze tehdy, pokud dojde k jejich změně. K rozpoznání změny slouží element <IMG_MOD> a <IMGMOD1>, ve kterém je zapsáno přesné datum a čas poslední změny obrázku ve formátu timestamp. Popis jednotlivých elementů: <SHOPITEM> - počáteční značka položky zboží <ID> - unikátní číslo zboží v naší databázi <PRODUCT> - název zboží <PRODUCT_SHORT> - zkrácený název zboží, vhodný například do výpisu oddělení <SHORTNAME> - zkrácený název zboží, který se vypisuje na našich fakturách <CATNUM> - katalogové číslo <URL> - přímý odkaz na zboží na našich stránkách <IMGURL> - url adresa k hlavnímu obrázku zboží <IMGURL_SMALL1> - url adresa k malému náhledu k hlavnímu obrázku zboží <IMGSIZE> - velikost souboru hlavního obrázku udaná v Kb. <IMG_MOD> - časová značka poslední změny hlavního obrázku <IMGURLG1> - url adresa k obrázku z galerie (pokud zboží obsahuje více obrázků, další obrázek se vypíše jako další řádek a zvýší se číslo elementu na IMGURLG2, IMGURLG3, IMGURLG4 atd.) <IMGURLG_SMALL1> - url adresa k malému náhledu obrázku z galerie (pokud zboží obsahuje více obrázků, další obrázek se vypíše jako další řádek a zvýší se číslo elementu na IMGURLG_SMALL2, IMGURLG_SMALL3, IMGURLG_SMALL4 atd.) <IMGSIZE1> - velikost souboru prvního obrázku z galerie udaná v Kb (pokud zboží obsahuje více obrázků, další obrázek se vypíše jako další řádek a zvýší se číslo elementu na IMGSIZE2, IMGSIZE3 atd.). <IMGMOD1> - časová značka poslední změny daného obrázku z galerie (pokud zboží obsahuje více obrázků, další obrázek se vypíše jako další řádek a zvýší se číslo elementu na IMGMOD2, IMGMOD3 atd.). <PRICE> - velkoobchodní cena bez DPH <PRICE_VAT> - velkoobchodní cena s DPH <PRICEMOC> - maloobchodní cena bez DPH <PRICEMOC_VAT> - maloobchodní cena s DPH <CATEGORY_ID> - unikátní číslo hlavní kategorie, ve které je zboží zařazeno <CATEGORY> - název hlavní kategorie, ve které je zboží zařazeno <CATEGORIES> - obsahuje seznam ID kategorií do kterých produkt spadá <CAT_ID> - ID kategorie, do které produkt spadá (nachází se mezi tagy <CATEGORIES></CATEGORIES> <PRODUCER> - výrobce zboží <SIMILAR> - ID příbuzného zboží oddělené čárkou <STOCK> - nabývá hodnoty Skladem, pokud je produkt skladem, v opačném případě se nezobrazuje <QUANTITY> - množství produktů skladem, pokud produkty skladem, nejsou nezobrazuje se <DATE> - přesné datum expedice z našeho skladu (zobrazuje se pokud není zobrazeno <STOCK> <DAYS> - počet dní k expedici z našeho skladu (zobrazuje se pokud není <STOCK> a <DATE>, např.: 2 dny <LAST_MODIFIED> - časová značka poslední textové změny v dlouhém popisu zboží <DESCRIPTION> - krátký popis zboží <TEXT> - dlouhý popis zboží ve formátu HTML <EAN> - 13-ti místný EAN kód <AKCE> - informace, zda je zboží aktuálně v akci (1 = ano, 0 = ne) </SHOPITEM> - koncová značka položky zboží 4
PŘÍKLAD STRUKTURY HLAVNÍHO DATOVÉHO SOUBORU Níže je uveden příklad struktury hlavního datového souboru. <SHOPITEM> <ID>769</ID> <PRODUCT>Baterie Sony NP-BG1, NP-FG1-1000 mah</product> <PRODUCT_SHORT>Baterie Sony NP-BG1, NP-FG1-1000 mah</product_short> <SHORTNAME>Baterie Son NP-BG1, NP-FG1-1000 mah</shortname> <CATNUM>180020</CATNUM> <URL>http://www.kabelmanie.cz/baterie-sony-np-bg1-np-fg1/</URL> <IMGURL>http://www.kabelmanie.cz/img/goods/dealers/180020.jpg</IMGURL> <IMGURL_SMALL>http://www.kabelmanie.cz/img/goods/small/769.jpg</IMGURL_SMALL> <IMGSIZE>163264</IMGSIZE> <IMGMOD>1336742227</IMGMOD> <IMGURLG1>http://www.kabelmanie.cz/img/galery/default/7974.jpg</IMGURLG1> <IMGURLG_SMALL1>http://www.kabelmanie.cz/img/galery/small/7974.jpg</IMGURLG_SMALL1> <IMGSIZE1>93443</IMGSIZE1> <IMGMOD1>1336741671</IMGMOD1> <PRICE>193</PRICE> <PRICE_VAT>232</PRICE_VAT> <PRICEMOC>325</PRICEMOC> <PRICEMOC_VAT>390</PRICEMOC_VAT> <CATEGORY_ID>381</CATEGORY_ID> <CATEGORY>Baterie do fotoaparátů</category> <CATEGORIES> <CAT_ID>313</CAT_ID> <CAT_ID>381</CAT_ID> </CATEGORIES> <PRODUCER>Power Energy Battery</PRODUCER> <SIMILAR>254</SIMILAR> <STOCK>Skladem</STOCK> <QUANTITY>11</QUANTITY> <LAST_MODIFIED>1334840960</LAST_MODIFIED> <DESCRIPTION>Krátký popis produktu.</description> <TEXT><![CDATA[<div><strong>Kapacita: </strong>1000 mah<br /><strong>napětí: </strong>3.7 V<br /><strong>typ: </strong>li-ion<br /><strong>hmotnost: </strong>30g<br /><strong>barva: </strong>černo-červená<br /><strong>rozměry: </strong>41x35x8 mm (délka x šířka x výška)<br /><strong>kompatibilní s part number: </strong>sony<strong> </strong>np-bg1, NP-FG1 <div> </div><div><span style="mso-no-proof: yes;"><strong>určeno pro typy: </ strong></span>sony Cyber-shot DSC-N1, DSC-N2, DSC-W30, DSC-W30L, DSC-W30S, DSC-W30W, DSC-W40</span></div> Typové číslo baterie (např. NP-30, NB-2LH atd.) se shoduje s výše uvedeným číslem, pak tato <div> </div>]]></text> <EAN><![CDATA[8595181152478]]></EAN> <AKCE>0</AKCE> </SHOPITEM> 5