V tomto článku naleznete přehled povinných elementů produktového a dostupnostního Heureka XML feedu. Tyto elementy jsou klíčové pro správné napojení a spuštění vašich produktů.
Produktový Heureka XML feed
SHOP | Kořenový element, v souboru je obsažen pouze jednou. |
SHOP_ITEM | Element obsahuje kompletní strukturu produktu, v souboru je obsažen tolikrát, kolik má partner produktů či variant. Např. v případě, že partner prodává tričko v pěti velikostech (S, M, L, XL, XXL) a deseti barvách (bílé, žluté, oranžové, červené, modré, fialové, zelené, hnědé, béžové, šedé a černé) je nutné do XML uvést 50x SHOPITEM. |
ITEM_ID | Unikátní označení produktu v rámci e-shopu, na jeho základě se vygeneruje MALL ID. ID musí zůstat unikátní, protože nám slouží k jednoznačné identifikaci produktu. Například pro správné napárovaní dostupnosti v Dostupnostním Heureka XML feedu. Kombinace maximálně 36 znaků, povolené znaky jsou: _ – 0-9 a-z A-Z (podtržítka, pomlčky, čísla nula až devět, malé a velké písmena bez diakritiky). |
PRODUCTNAME | Přesný název produktu. Délka je validována naším systémem – na max. 200 znaků. |
PRODUCT | Tento element není povinný, ale pokud jej ve feedu posíláte, tak se páruje na krátký popisek produktu. |
DESCRIPTION | Popis produktu by měl obsahovat nejrelevantnější informace o produktu, které se berou v potaz ve fulltextovém vyhledávání. Není zde možné úvádět: reklamy, akce nebo propagaci vašeho e-shopu. Počet znaků v elementu DESCRIPTION je validován naším systémem na 13 000 znaků. |
IMGURL | Odkaz na hlavní/primární obrázek produktu. Velikost obrázků je validována naším systémem – max. 2000px x 2000px a max. 1,5MB. |
IMGRUL_ALTERNATIVE | Tento element není povinný, ale pokud jej ve feedu posíláte, tak si z něj čerpáme další obrázky pro daný produkt. |
PRICE_VAT | Koncová cena produktu s DPH. |
VAT | Nepovinný element, z kterého čerpáme sazbu DPH. V případě, že se tento element ve feedu nenachází, tak lze DPH nastavit manuálně na všechny produkty v portálu ve Stavu feedu. |
MANUFACTURER | Obsahuje výrobce (značku) produktu, na základě kterého párujeme značky na MALL. Detailnější instrukce ke značkám naleznete zde. |
CATEGORY_TEXT | Zde se nachází zařazení produktu do kategorie. Doporučujeme využít strom kategorií Heureky, propárovaní tak proběhne automaticky. Strom Heureky naleznete zde: https://www.heureka.cz/direct/xml-export/shops/heureka-sekce.xml. V opačném případe lze kategorie napárovat ručně v partnerském portálu, více naleznete zde. |
EAN | Nepovinný element v Heureka XML feedu, který se páruje na EAN produktu. Pro nás jsou EANy povinné a je potřebné je k produktům posílat. |
PARAM | Nepovinný element, který lze následně napárovat na naše parametry v portálu. V případě tvoření variatního produktu je tento element povinný. Detailnější návod naleznete zde. |
DELIVERY_DATE | Nepovinný element, který se páruje na naše Delivery Delay (doba doručení) na úrovni produktu. |
ITEMGROUP_ID | Povinný element nezbytný pro varianty, na jeho základě náš systém rozezná variantní produkt. Kombinace maximálně 36 znaků, povolené znaky jsou: _ – 0-9 a-z A-Z (podtržítka, pomlčky, čísla nula až devět, malé a velké písmena bez diakritiky). |
Dostupnostní Heureka XML feed
item_list | Kořenový element, v souboru je obsažen pouze jednou. |
item | Obsahuje informace o dostupnosti konkrétního produktu, v souboru je obsažen tolikrát, kolik má partner dostupných produktů či variant. |
item id | Identifikuje konkrétní produkt. Hodnota se musí shodovat s hodnotou elementu <ITEM_ID> produktu z produktového Heureka XML feedu. Tedy vaše ID z produktového a dostupnostního feedu musí být totožné. |
stock_quantity | Počet kusů připravených k okamžité expedici. Přípustná hodnota je celé číslo. |
Pokud provedete změny na vašem e-shopu (eshop XYZ vs. Heureka), tak se projeví za cca 2 hodiny (pravidelná aktualizace). Následně se změny objeví v URL odkazu se strukturou feedu, který máte vložený u nás v partnerském portálu.
Jak na validaci Heureka XML feedu?
Vhodný validátor pro Heureka XML feed poskytuje Mergado. Tento validátor nezohledňuje specifické požadavky, které je potřeba dodržet pro úspěšné napojení na MALL, jedná se pouze o všeobecnou validaci Heureka feedu.
Validátor naleznete zde: https://audit.mergado.com/.