Podrobné informace o dostupnosti zboží v e-shopu i na jednotlivých kamenných pobočkách lze předávat prostřednictvím samostatného XML souboru. Tento soubor je automaticky generován z vašich stránek, a proto jeho vytvoření či úpravy konzultujte se svým webmasterem. Dostupnostní XML soubor zpracováváme pouze v případě PPC režimu.
XML soubor s informacemi o dostupnosti se stahuje každých deset minut a je nutné, aby vždy obsahoval aktuální a pravdivé údaje a splňoval následující specifikaci. Pro stahování souboru vyžadujeme podporu GZip komprese přenosu.
Informace o dostupnosti zboží z dostupnostního XML má přednost před touto informací v hlavním XML souboru.
Dostupnostní XML soubor slouží výhradně pro položky, které jsou připravené k okamžité expedici přepravní službou, nebo fyzicky skladem na kamenné pobočce, případně pro ty u kterých znáte přesné datum dodání zákazníkovi (nebo přesné datum, kdy bude produkt připraven k vyzvednutí na pobočce).
Doba mezi objednáním (tzv. orderDeadline, více níže) a dodáním zboží zákazníkovi, nesmí překročit 3 dnů.
Produkty, které nesplňují výše zmíněné podmínky, nejsou považovány za "skladové", jejich uvedení do dostupnostního XML souboru bude vyhodnoceno jako chyba a XML soubor nebude stahován a parsován až do jejich odstranění.
Uvádějte pouze produkty, u kterých dodáváte unikátní <ITEM_ID> v hlavním XML souboru.
<?xml version="1.0" encoding="utf-8"?>
<item_list>
<item id="536234275543">
<stock_quantity>13</stock_quantity>
<delivery_time orderDeadline="2011-09-10 12:00">2011-09-11 13:00</delivery_time>
<depot id="434">
<stock_quantity>2</stock_quantity>
</depot>
<depot id="437">
<pickup_time orderDeadline="2011-09-10 12:00">2011-09-11 18:00</pickup_time>
</depot>
<depot id="436">
....
</depot>
....
</item>
<item id="536234275547">
....
</item>
....
</item_list>
Dostupnostní XML musí být 100% validní. V opačném případě vůbec nedojde k jeho naparsování a nebudou tedy k dispozici žádná data o dostupnosti zboží. Validitu dostupnostního XML je možné zkontrolovat prostřednictvím odkazu "Zkontrolovat XML soubor" v administračním rozhraní na adrese https://sluzby.heureka.cz/obchody/dostupnost/. Dále lze využít RelaxNG schema dostupnostního XML, které lze stáhnout zde.
Obsahuje-li dostupnostní XML soubor chybu déle než dvě hodiny, již nejsou prováděny další pokusy o znovustažení a naparsování. Aby byl po opravě chyby soubor stažen a naparsován, je nutné vynulovat počet pokusů o znovustažení v administraci obchodu na adrese https://sluzby.heureka.cz/obchody/dostupnost/.
1) Nulový počet kusů v eshopu
<item_list>
<item id="ABC001">
<stock_quantity>5</stock_quantity>
</item>
<item id="ABC002">
<stock_quantity>0</stock_quantity>
</item>
<item id="ABC003">
<stock_quantity>7</stock_quantity>
</item>
</item_list>
Řešení:
Produkt v dostupnostním XML souboru zcela vynechte.
<item_list>
<item id="ABC001">
<stock_quantity>5</stock_quantity>
</item>
<item id="ABC003">
<stock_quantity>7</stock_quantity>
</item>
</item_list>
2) Nulový počet kusů v eshopu, nenulový počet kusů na pobočce
<item_list>
<item id="ABC001">
<stock_quantity>0</stock_quantity>
<depot id="434">
<stock_quantity>2</stock_quantity>
</depot>
</item>
</item_list>
Řešení:
Vynechte informaci o dostupnostni v eshopu, v XML souboru uveďte pouze počet kusů dostupných na pobočce.
<item_list>
<item id="ABC001">
<depot id="434">
<stock_quantity>2</stock_quantity>
</depot>
</item>
</item_list>
3) Nulový počet kusů na pobočce
<item_list>
<item id="ABC001">
<stock_quantity>5</stock_quantity>
<depot id="434">
<stock_quantity>0</stock_quantity>
</depot>
</item>
</item_list>
Řešení:
Informaci o dostupnosti na pobočce zcela vynechte.
<item_list>
<item id="ABC001">
<stock_quantity>5</stock_quantity>
</item>
</item_list>
4) Uvedená orderDeadline již proběhla
9.5.2012 v 19:00 je v dostupnostním XML souboru uvedeno:
<item_list>
<item id="ABC001">
<delivery_time orderDeadline="2012-05-09 17:00">2012-05-10 13:00</delivery_time>
</item>
</item_list>
Řešení:
Po překročení orderDeadline pro aktuální den, generujte do dostupnostního XML souboru údaje platné pro den následující.
<item_list>
<item id="ABC001">
<delivery_time orderDeadline="2012-05-10 17:00">2012-05-11 13:00</delivery_time>
</item>
</item_list>
5) Den doručení je shodný s deadline pro objednání
<item_list>
<item id="ABC001">
<stock_quantity>4</stock_quantity>
<delivery_time orderDeadline="2013-05-06 14:00">2013-05-06 18:00</delivery_time>
</item>
</item_list>
Řešení:
Není možné uvádět shodný den doručení s deadline pro objednání. Den doručení musí být platný pro celou ČR, nikoliv pouze pro jedno město.
6) Vše je OK, ale nezobrazuje se datum pro objednání a doručení
Řešení:
Datum pro objednání a doručení (Např.: Doručení do zítra? Objednejte dnes, do 15:00.) se zobrazí pouze v případě, že uvedená orderDeadline je dnes nebo zítra. Zkontrolujte tedy datum objednání a doručení, který nám předáváte v dostupnostním XML souboru.
7) Zobrazuje se datum pro objednání a doručení, ale zároveň Info v obchodu
Řešení:
Informace Skladem se zobrazí pouze v případě, že datum doručení je za méně než 3 pracovní dny.
V případě, že import dostupnostního XML souboru probíhá správně, a uváděné údaje jsou v pořádku, zobrazuje se u produktu vašeho obchodu v porovnání cen doplňková hláška ve formátu "Doručení do úterý? Objednejte dnes do 15:00." Informace se zobrazuje nejdříve v den předcházející uvedené orderDeadline a pokud do jejího vypršení zbývá alespoň 10 minut.
Dostupnostní XML soubor lze zvalidovat přímo zde. Stačí do následujícího pole zadat URL, na které se XML nachází.
Před validací XML souboru je pro nás z technických důvodů nutné, znát před zahájením stahování jeho velikost. Z tohoto důvodu je nutné, aby server při http požadavku vracel v odpovědi hlavičku Content-Length s odpovídající hodnotou.
Pozn.: Tento validátor provádí pouze validaci správné struktury XML souboru, nikoliv správnost uvedených dat, jako je doba doručení, nebo orderDeadline. U těchto údajů se kontroluje pouze zda jejich formát odpovídá specifikaci.
Pro použití vlastního XML validátoru je k dispozici specifikace ve formátu Relax NG. Soubor se specifikací lze stáhnout zde.