Kabelmánie s.r.o. Popis exportů XML
Technická dokumentace exportu zboží prostřednictvím datového XML souboru v. 2.2 - červen 2015
www.kabelmanie.cz
[email protected]
+420 534 009 359
Kabelmánie s.r.o., Čápkova 17/11, 602 00 Brno - Veveří
IČO: 29264766
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
www.kabelmanie.cz
[email protected]
+420 534 009 359
Kabelmánie s.r.o., Čápkova 17/11, 602 00 Brno - Veveří
IČO: 29264766
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ů:
- počáteční značka XML souboru - obsahuje informace ke konkrétní kategorii - ID kategorie - název kategorie - ID nadřazené kategorie - obsahuje informace o hloubce zanoření kategorií, hlavní kategorie mají hodnotu „0“, jejich podkategorie „1“ atd. - koncová značka
Příklad struktury jedné položky zboží v XML: 1 Baterie do mobilu 0 0
2
www.kabelmanie.cz
[email protected]
+420 534 009 359
Kabelmánie s.r.o., Čápkova 17/11, 602 00 Brno - Veveří
IČO: 29264766
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 (katalogové číslo).
Popis jednotlivých elementů: <SHOP> - počáteční značka souboru - značka uzavírající informace o skladové dostupnosti k jednomu konkrétnímu produktu - katalogové číslo <STOCK> - položka nabývá hodnoty „Skladem“ pokud je produkt skladem, v opačném případě se nezobrazuje - množství produktů skladem, pokud produkty skladem nejsou, nezobrazuje se - přesné datum expedice z našeho skladu (zobrazuje se, pokud není zobrazeno <STOCK> - počet dní k expedici z našeho skladu (zobrazuje se pokud není <STOCK> a , např.: „2 dny“, „4 dny“ atd. Hodnota „98“ označuje, že po vyprodání zboží se automaticky v našem eshopu skryje. - koncová značka souboru
Příklad struktury dostupnosti položek zboží v XML: 160303 <STOCK>Skladem 2 179979 13.6.2012 KUS2AB5 2 dny
3
www.kabelmanie.cz
[email protected]
+420 534 009 359
Kabelmánie s.r.o., Čápkova 17/11, 602 00 Brno - Veveří
IČO: 29264766
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 a , 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ží - unikátní číslo zboží v naší databázi - název zboží - 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 - katalogové číslo - přímý odkaz na zboží na našich stránkách - url adresa k hlavnímu obrázku zboží - url adresa k malému náhledu k hlavnímu obrázku zboží - velikost souboru hlavního obrázku udaná v Kb. - časová značka poslední změny hlavního obrázku - 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.) - 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.) - 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.). - č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.). - velkoobchodní cena bez DPH - velkoobchodní cena s DPH - maloobchodní cena bez DPH - maloobchodní cena s DPH - unikátní číslo hlavní kategorie, ve které je zboží zařazeno - název hlavní kategorie, ve které je zboží zařazeno - obsahuje seznam ID kategorií do kterých produkt spadá - ID kategorie, do které produkt spadá (nachází se mezi tagy - 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 - množství produktů skladem, pokud produkty skladem, nejsou nezobrazuje se - přesné datum expedice z našeho skladu (zobrazuje se pokud není zobrazeno <STOCK> - počet dní k expedici z našeho skladu (zobrazuje se pokud není <STOCK> a , např.: „2 dny“ - časová značka poslední textové změny v dlouhém popisu zboží - krátký popis zboží - dlouhý popis zboží ve formátu HTML <EAN> - 13-ti místný EAN kód - informace, zda je zboží aktuálně v akci (1 = ano, 0 = ne) - koncová značka položky zboží
4
www.kabelmanie.cz
[email protected]
+420 534 009 359
Kabelmánie s.r.o., Čápkova 17/11, 602 00 Brno - Veveří
IČO: 29264766
PŘÍKLAD STRUKTURY HLAVNÍHO DATOVÉHO SOUBORU Níže je uveden příklad struktury hlavního datového souboru. <SHOPITEM> 769 Baterie Sony NP-BG1, NP-FG1 - 1000 mAh Baterie Sony NP-BG1, NP-FG1 - 1000 mAh <SHORTNAME>Baterie Son NP-BG1, NP-FG1 - 1000 mAh 180020 http://www.kabelmanie.cz/baterie-sony-np-bg1-np-fg1/ http://www.kabelmanie.cz/img/goods/dealers/180020.jpg http://www.kabelmanie.cz/img/goods/small/769.jpg 163264 1336742227 http://www.kabelmanie.cz/img/galery/default/7974.jpg http://www.kabelmanie.cz/img/galery/small/7974.jpg 93443 1336741671 193 232 325 390 381 Baterie do fotoaparátů 313 381 Power Energy Battery <SIMILAR>254 <STOCK>Skladem 11 1334840960 Krátký popis produktu. <strong>Kapacita: 1000 mAh
<strong>Napětí: 3.7 V
<strong>Typ: Li-ion
<strong>Hmotnost: 30g
<strong>Barva: černo-červená
<strong>Rozměry: 41x35x8 mm (délka x šířka x výška)
<strong>Kompatibilní s part number: Sony<strong> NP-BG1, NP-FG1
<span style="mso-no-proof: yes;"><strong>Určeno pro typy: Sony Cyber-shot DSC-N1, DSC-N2, DSC-W30, DSC-W30L, DSC-W30S, DSC-W30W, DSC-W40
Typové číslo baterie (např. NP-30, NB-2LH atd.) se shoduje s výše uvedeným číslem, pak tato
]]> <EAN> 0
5
www.kabelmanie.cz
[email protected]
+420 534 009 359
Kabelmánie s.r.o., Čápkova 17/11, 602 00 Brno - Veveří
IČO: 29264766