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í. Do dlouhého popisku lze vložit URL odkazy na videa a obrázky, zobrazí se 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. Je však nutné mít správné DPH k produktu dle dané země, bez ohledu na to, zda jste nebo nejste plátce DPH. |
| 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 také validovat dostupnostní feed přímo podle instrukcí Heureky zde: https://sluzby.heureka.cz/napoveda/dostupnostni-feed/
Můžete se také podívat na naše instruktážní video.
V případě, že budete mít nějaké další dotazy, můžete se na nás obrátit skrze Centrum nápovědy.
Čeština 
English 
Slovenščina 
Magyar