Podrobné informácie o dostupnosti tovaru v e-shope aj v jednotlivých kamenných pobočkách je možné dodávať prostredníctvom samostatného XML súboru. Tento súbor je automaticky generovaný z vašich stránok, a preto jeho vytvorenie alebo úpravy konzultujte so svojim webmasterom. Dostupnostný XML súbor spracovávame iba v PPC režime.
XML súbor s informáciami o dostupnosti sa sťahuje každých desať minút a je nutné, aby vždy obsahoval aktuálne a pravdivé údaje a spĺňal následujúcu špecifikáciu. Na sťahovanie súboru vyžadujeme podporu GZip kompresie prenosu.
Ak sa v dostupnostnom súbore vyskytne chyba a máte aktívny Heureka Marketplace, môže to bohužiaľ ovplyvniť služby. Môžu zmiznúť oranžové tlačidlá pri všetkých alebo pri niektorých produktoch. Podľa toho, či sa feed stiahol len čiastočne.
Obchody, ktoré v Marketplace využívajú API napojenia nám dostupný súbor nemusí zasielať vôbec. Všetky potrebné informácie overujeme cez API.
Informácie o dostupnosti tovaru z dostupnostného XML majú prednosť pred touto informáciou v hlavnom XML súbore.
Dostupnostný XML súbor slúži výhradne pre položky, ktoré sú pripravené k okamžitej expedícii prepravnou službou, alebo sú fyzicky na kamennej pobočke, prípadne pre tie, pri ktorých viete presný dátum dodania zákazníkovi (alebo presný dátum, kedy bude produkt pripravený k vyzdvihnutiu na pobočke).
Doba medzi objednaním (tzv. orderDeadline, viac nižšie) a dodaním tovaru zákazníkovi, nesmie prekročiť 3 dní.
Produkty, ktoré nespĺňajú vyššie uvedené podmienky, nie sú považované za "skladové", ich uvedenie do dostupnostného XML súboru bude vyhodnotené ako chyba a XML súbor nebude sťahovaný a parsovaný až do ich odstránenia.
Uvádzajte len produkty, u ktorých dodávate unikátny <ITEM_ID> v hlavnom XML súbore.
<?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í byť 100% validný. V opačnom prípade vôbec nedôjde k jeho naparsovaniu a nebudú teda k dispozícii žiadne dáta o dostupnosti tovaru. Validitu dostupnostného XML je možné skontrolovať prostredníctvom odkazu "Skontrolovať XML súbor" v administračnom rozhraní na adrese https://sluzby.heureka.sk/obchody/dostupnost/. Ďalej je možné využiť RelaxNG schéma dostupnostného XML, ktorú je možné stiahnuť zde.
Ak dostupnostný XML súbor obsahuje chybu dlhšie než dve hodiny, už nerobíme ďalšie pokusy o znovu stiahnutie a naparsovanie. Aby bol po oprave chyby súbor stiahnutý a naparsovaný, je nutné vynulovať počet pokusov o znovustiahnutie v administrácii obchodu na adrese https://sluzby.heureka.sk/obchody/dostupnost/.
1) Nulový počet kusov v eshope
<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>
Riešenie:
Produkt v dostupnostnom XML súbore vynechajte.
<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 kusov v e-shope, nenulový počet kusov na pobočke
<item_list>
<item id="ABC001">
<stock_quantity>0</stock_quantity>
<depot id="434">
<stock_quantity>2</stock_quantity>
</depot>
</item>
</item_list>
Riešenie:
Vynechajte informáciu o dostupnosti v eshope, v XML súbore uveďte len počet kusov dostupných na pobočke.
<item_list>
<item id="ABC001">
<depot id="434">
<stock_quantity>2</stock_quantity>
</depot>
</item>
</item_list>
3) Nulový počet kusov na pobočke
<item_list>
<item id="ABC001">
<stock_quantity>5</stock_quantity>
<depot id="434">
<stock_quantity>0</stock_quantity>
</depot>
</item>
</item_list>
Riešenie:
Informáciu o dostupnosti na pobočke celkom vynechajte.
<item_list>
<item id="ABC001">
<stock_quantity>5</stock_quantity>
</item>
</item_list>
4) Uvedená orderDeadline už prebehla
9. 5. 2012 v 19:00 je v dostupnostnom XML súbore uvedené:
<item_list>
<item id="ABC001">
<delivery_time orderDeadline="2012-05-09 17:00">2012-05-10 13:00</delivery_time>
</item>
</item_list>
Riešenie:
Po prekročení orderDeadline pre aktuálny deň generujte do dostupnostného XML súboru údaje platné pre deň nasledujúci.
<item_list>
<item id="ABC001">
<delivery_time orderDeadline="2012-05-10 17:00">2012-05-11 13:00</delivery_time>
</item>
</item_list>
5) Deň doručenia je zhodný s deadlinom na objednanie
<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>
Riešenie:
Deň doručenia nie je možné uvádzať zhodný s deadlinom na objednanie. Deň doručenia musí byť platný pre celú SR, nie iba pre jedno mesto.
6) Neuvedené skladové položky
Ak do dostupnostného feedu neuvediete položky, ktoré sú v základnom feede skladom, u produktov zobrazíme vždy „info v obchode“, aj keď v základnom feede máte uvedené
7) ITEM_ID sa nezhoduje
Skontrolujte vždy starostlivo, či je ITEM_ID v základnom feede totožné s ITEM_ID v dostupnom feede.
Riešenie:
Informácie Skladom sa zobrazí iba v prípade, že dátum doručenia je za menej ako 3 pracovné dni.
Dostupnostný XML súbor je možné zvalidovať priamo tu. Stačí do nasledujúceho poľa zadať URL, na ktorej sa XML nachádza.
Pre validáciu XML súboru z technických dôvodov potrebujeme poznať jeho veľkosť pred začatím sťahovania. Preto je nutné, aby server pri http požiadavke vrátil v odpovedi hlavičku Content-Length s odpovedajucou hodnotou.
Pozn.: Tento validátor urobí len validáciu správnej štruktúry XML súboru, nie správnosť uvedených dát, ako je doba doručenia, alebo orderDeadline. Pri týchto údajoch sa kontroluje iba, či ich formát zodpovedá špecifikácii.
Na použitie vlastného XML validátora je k dispozícii špecifikácia vo formáte Relax NG. Súbor so špecifikáciou je možné stiahnuť tu.