Povinné elementy pro Heureka XML feedy

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. Nesmí být totožný s ITEMGROUP_ID. Kombinace maximálně 50 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ů. Nejsou povolené speciální znaky.
PRODUCT	Tento element není povinný. Pokud jej ve feedu posíláte, tak se páruje na krátký popisek produktu (v MALL max. 300 znaků). Nespáruje se za předpokladu, že je element totožný s PRODUCTNAME. V tomto případě se krátký popis produktu doplní z elementu DESCRIPTION.
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ů. Toto jsou základní HTML tagy, které lze v dlouhém popise používat: <a>, <b>, <br>, <div>, <dl>, <dt>, <em>, <hr>, <i>, <img>, <li>, <ol>, <p>, <strong>, <sub>, <sup>, <table>, <tbody>, <td>, <tfoot>, <th>, <thead>, <tr>, <u>, <ul>. V tazích není potřeba používat vlastní styly, bez nich se text nejlépe přizpůsobí našim stránkám. Pokud budete mít nějaké tabulky v popise, je ještě nutné přidat <table class=”tbl”>, aby byla tabulka responzivní. Odkazy na videa a obrázky, vložené do dlouhého popisku, náš systém nezpracuje. Nezobrazí se tedy v detailu produktu na webu.
IMGURL	Odkaz na hlavní/primární obrázek produktu. Velikost obrázků je validována naším systémem – max. 2000px x 2000px, min. 100 KB a max. 2 MB. URL obrázku nesmí obsahovat mezery a diakritiku. Pokud změníte obrázek, je nutné změnit i URL obrázku, URL nesmí být stejné.
IMGURL_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. Maximální počet obrázků je 20. Pokud změníte obrázek, je nutné změnit i URL obrázku, URL nesmí být stejné. Není možné vložit duplicitní obrázek (URL ani obsahem).
PRICE_VAT	Koncová cena produktu s DPH. Cena nesmí zahrnovat provizi. Cena musí být uvedená bez mezer, jak je uvedené v obrázku níže.
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.
CATEGORYTEXT	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. Systém akceptuje pouze 13 numerických znaků. Pro nás jsou EANy povinné a je potřebné je k produktům posílat. V případě, že má váš EAN 14 numerických znaků, vložte ho jako 13místný bez 0 na začátku. Pokud máte kratší 8místný EAN doplňte na začátek tolik 0 kolik chybí do 13 znaků. Více informaci o EAN kódech naleznete v zde: https://knowledgebase.mallgroup.com/ean-povinnym-atributem-pro-produkty/
PARAM	Nepovinný element, který lze následně napárovat na naše parametry v portálu. Pro správné zobrazení numerických hodnot parametru je potřebné vyplňovat hodnoty s čárkou, nikoliv s tečkou (např. 0,5). 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. V tomto případě nebude nastavení Delivery delay v dopravě zohledněno a systém upřednostní nastavení na úrovni produktu. Pro správné párování je potřebné uvádět celá čísla max. dvoumístná.
ITEMGROUP_ID	Povinný element nezbytný pro varianty, na jeho základě náš systém rozezná variantní produkt. Nesmí být totožný s ITEM_ID. 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/.

Můžete se také podívat na naše instruktážní video.