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.
Pokud nastane chyba v dostupnostním souboru a máte aktivní Heureka Marketplace, pak to bohužel může ovlivnit služby. Mohou zmizet oranžová tlačítka u všech nebo u některých produktů. Podle toho jestli se feed stáhl pouze částečně.
Obchody, které v Marketplace využívají API napojení nám dostupnostní soubor nemusí zasílat vůbec. Všechny potřebné informace ověřujeme přes API.
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 jsou 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 schéma 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 e-shopu, 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 dostupnosti 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 deadlinem 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 deadlinem pro objednání. Den doručení musí být platný pro celou ČR, nikoliv pouze pro jedno město.
6) Neuvedené skladové položky
Řešení:
Pokud do dostupnostního feedu neuvedete položky, které jsou v základním feedu skladem, u produktů zobrazíme vždy „info v obchodě“, i když v základním feedu máte uvedeno <DELIVERY_DATE>0</DELIVERY_DATE>.
7) ITEM_ID se neshoduje
Řešení:
Zkontrolujte vždy pečlivě, zda je ITEM_ID v základním feedu totožné s ITEM_ID v dostupnostním feedu.
8) 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.
Dostupnostní XML soubor lze zvalidovat přímo zde. Stačí do následujícího pole zadat URL, na které se XML nachází.
Pro validaci XML souboru z technických důvodů potřebujeme znát jeho velikost před zahájením stahování. Proto 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.