Heureka XML feed

Struktura feedu

Kořenový element SHOP obsahuje pro každý produkt jeden SHOPITEM. Nejdůležitější pole:

• ITEM_ID — jedinečné ID produktu v e-shopu
• PRODUCTNAME a PRODUCT — název produktu (PRODUCT bývá delší, s doplňujícím textem)
• DESCRIPTION — popis, často včetně HTML
• URL, IMGURL a IMGURL_ALTERNATIVE — odkaz na produkt a obrázky
• PRICE_VAT — cena s DPH
• EAN — čárový kód, klíčový pro párování produktů mezi e-shopy
• CATEGORYTEXT — cesta v kategoriích Heureky
• PARAM s PARAM_NAME a VAL — parametry jako barva, materiál nebo rozměr
• DELIVERY_DATE — dodací lhůta ve dnech (0 = skladem)
• ITEMGROUP_ID — spojuje varianty jednoho produktu

Ukázka

<SHOP>
  <SHOPITEM>
    <ITEM_ID>565322</ITEM_ID>
    <PRODUCTNAME>Keter Zahradní úložný box Emily, 270 l, antracit</PRODUCTNAME>
    <URL>https://www.example.cz/keter-emily</URL>
    <IMGURL>https://www.example.cz/img/emily.jpg</IMGURL>
    <PRICE_VAT>1149</PRICE_VAT>
    <EAN>7290112634597</EAN>
    <CATEGORYTEXT>Heureka.cz | Bydlení a doplňky | Nábytek | Úložné prostory | Úložné boxy</CATEGORYTEXT>
    <PARAM>
      <PARAM_NAME>Objem</PARAM_NAME>
      <VAL>270 l</VAL>
    </PARAM>
    <DELIVERY_DATE>14</DELIVERY_DATE>
  </SHOPITEM>
</SHOP>

Typické problémy

Formát je jednoduchý, ale e-shopy si ho vykládají po svém. Při zpracování desítek feedů narazíš hlavně na tohle:

• CATEGORYTEXT je prázdný, zkrácený, nebo místo stromu Heureky obsahuje vlastní kategorie e-shopu.
• EAN chybí, je neplatný, nebo ho e-shop dává stejný všem variantám.
• Parametry jsou volný text — „bílá“, „Bílá“, „white“ i „bílá/dub“ znamenají totéž.
• Varianty chodí jako samostatné SHOPITEMy bez ITEMGROUP_ID, takže katalog zaplaví desítky téměř stejných řádků.

Heureka feed a vHub

Heureka XML je jeden z formátů, které vHub načítá — vedle Google Merchant a vlastních exportů e-shopů. Všechny převádí na jednu strukturu, takže tvůj kód nemusí znát rozdíly mezi nimi.