Specifikace XML souboru
Význam jednotlivých značek
Požadavky na kvalitní XML soubor
XML soubor obsahuje důležité tagy:
Ukázka základní podoby XML souboru:
Aby mohlo dojít k importu produktů do našich vyhledávačů, je zapotřebí mít vytvořený tzv. XML soubor (nebo-li XML FEED), což je jednoduchý datový formát, pomocí kterého nám předáte informace o vašem zboží a jeho cenách. XML soubor je automaticky generován z vašich stránek, a proto jeho vytvoření či úpravy konzultujte se svým webmasterem.
Export dat je základ úspěšnosti vašeho zobrazování na Heurece a proto jej doporučujeme připravit dle níže uvedených specifikací k jednotlivým položkám. Max. počet prodejných položek v XML souboru je 500 000.
<?xml version="1.0" encoding="utf-8"?>
<SHOP>
<SHOPITEM>
<ITEM_ID>AB123</ITEM_ID>
<PRODUCTNAME>Nokia 5800 XpressMusic</PRODUCTNAME>
<PRODUCT>Nokia 5800 XpressMusic</PRODUCT>
<DESCRIPTION>Klasický s plným dotykovým uživatelským rozhraním</DESCRIPTION>
<URL>http://obchod.cz/mobily/nokia-5800-xpressmusic</URL>
<IMGURL>http://obchod.cz/mobily/nokia-5800-xpressmusic/obrazek.jpg</IMGURL>
<IMGURL_ALTERNATIVE>http://obchod.cz/mobily/nokia-5800-xpressmusic/obrazek2.jpg</IMGURL_ALTERNATIVE>
<VIDEO_URL>http://www.youtube.com/watch?v=KjR759oWF7w</VIDEO_URL>
<PRICE_VAT>6000</PRICE_VAT>
<HEUREKA_CPC>5,8</HEUREKA_CPC>
<MANUFACTURER>NOKIA</MANUFACTURER>
<CATEGORYTEXT>Elektronika | Mobilní telefony</CATEGORYTEXT>
<EAN>6417182041488</EAN>
<PRODUCTNO>RM-559394</PRODUCTNO>
<PARAM>
<PARAM_NAME>Barva</PARAM_NAME>
<VAL>černá</VAL>
</PARAM>
<DELIVERY_DATE>2</DELIVERY_DATE>
<DELIVERY>
<DELIVERY_ID>CESKA_POSTA</DELIVERY_ID>
<DELIVERY_PRICE>120</DELIVERY_PRICE>
<DELIVERY_PRICE_COD>120</DELIVERY_PRICE_COD>
</DELIVERY>
<DELIVERY>
<DELIVERY_ID>PPL</DELIVERY_ID>
<DELIVERY_PRICE>90</DELIVERY_PRICE>
<DELIVERY_PRICE_COD>120</DELIVERY_PRICE_COD>
</DELIVERY>
<ITEMGROUP_ID>EF789</ITEMGROUP_ID>
<ACCESSORY>CD456</ACCESSORY>
<GIFT>Pouzdro zdarma</GIFT>
<EXTENDED_WARRANTY>
<VAL>36</VAL>
<DESC>Záruka na 36 měsíců</DESC>
</EXTENDED_WARRANTY>
<SPECIAL_SERVICE>Aplikace ochranné fólie</SPECIAL_SERVICE>
<SALES_VOUCHER>
<CODE>SLEVA20</CODE>
<DESC>Sleva 20% po zadání kódu do 31.12.2021!</DESC>
</SALES_VOUCHER>
</SHOPITEM>
<SHOPITEM>
...
</SHOPITEM>
</SHOP>
Upozornění:
Kódování znaků UTF-8
Pracujeme s kódováním znaků UTF-8. Při použití jiného druhu kódování může být problém se správným zobrazením dat.
Export neobsahuje položky, které jsou neprodejné, nedostupné a vyprodané. Při změně URL adres vašich produktů, názvu produktů či kategorií v XML se na Heurece odpárují všechny produkty a poté se znovu čeká na jejich spárování, které může trvat cca 4 pracovní dny. Je proto nutné v XML souboru zachovávat stejné URL adresy.
Varianty produktů
Pokud prodáváte produkty např. oblečení, matrace, jízdní kola, kolečkové brusle, kočárky, satelitní komplety atd., kde produkty mají pod unikátním EAN variantu lišící se barvou, vzorem, materiálem, rozměry, komponenty, velikostí atd., věnujte velkou pozornost oddílu Varianty, tag ITEMGROUP_ID.
Dostupnostní XML
Detailní a aktuální informace o dostupnosti zboží lze poskytovat také prostřednictvím samostatného XML feedu (více o dostupnostním XML)
Zpracování XML souboru
Váš XML soubor stahujeme každé dvě hodiny v případě PPC režimu, abychom vždy zajistili aktuální ceny. V případě FREE režimu je XML soubor stahován každé čtyři hodiny. Z vaší strany je třeba vždy zajistit aktuálnost souboru, aby data byla co nejrelevantnější.
Komprimace XML Souboru
Základní XML soubor přijímáme také ve formátu GZip. Lze tedy pouzit GZip kompresi HTTP přenosu tohoto souboru.
Stačí mít váš HTTP server nakonfigurovaný tak, aby tuto kompresi podporoval, což je většinou standardní chovaní.
Ke komprimaci pak dojde transparentně na straně HTTP serveru a k dekomprimaci pak opět transparentně na straně
našeho HTTP serveru. Dojde tak k úspoře objemu přenesených dat, avšak i tak přijímáme XML soubor s max. 500 000
položek k prodeji v režimu PPC i režimu FREE.
Aktualizace XML hlavičky
Před samotným stažením XML souboru kontrolujeme datum jeho poslední modifikace prostřednictvím HTTP hlavičky "Last-Modified". Doporučujeme tedy nakonfigurovat HTTP server tak, aby tuto informaci v hlavičce odpovědi odesílal. Předejde se tak zbytečné zátěži serverů na obou stranách, způsobené stahováním nezměněných XML souborů.
Popis jednotlivých elementů:
Kořenový element, v souboru je obsažen pouze jednou.
Element obsahuje informace o konkrétním produktu, v souboru je obsažen tolikrát, kolik máte variant produktů.
Např. v případě, že prodáváte 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 50 SHOPITEM.
Důkladné rozdělení variant umožňuje správné vyplnění parametrů a následné filtrování produktů.
Unikátní označení produktu v rámci e-shopu. Musí zůstat unikátní navždy, díky čemuž budeme schopni jednoznačně identifikovat produkt pro službu Ověřeno zákazníky či Dostupnostní XML soubor, i když se změní URL. Kombinace maximálně 36 znaků [ _ - 0-9 a-z A-Z ] tedy podtržítka, pomlčky, čísel nula až devět a malých a velkých písmen bez diakritiky. Tag se dosud pro párování položek nevyužívá.
Uvádění tohoto tagu je zároveň nezbytné pro fungování modelu Heureka Marketplace.
Přesný název produktu. Nesmí obsahovat žádné jiné informace, jako např. dárek, pouzdro či nabíječka zdarma, atd. Hodnota musí být obsažena také v tagu PRODUCT, jinak nebude brána v potaz. Pokud názvy produktů nebudou obsahovat produktové číslo, hrozí, že nedokážeme produkty správně identifikovat a tudíž spárovat. Maximální délka názvu produktu je 200 znaků.
Canon PowerShot SX100 červený
Digitální fotoaparát Canon SX100 Power-shot + nabíječka
Povinné údaje v názvu pro jednotlivé kategorie
Obecně platí, že název nesmí být obecný. Pokud tedy uvedete do názvu produktu výrobce, řadu a produktové číslo, měl by být produkt v pořádku zařazen.
Pokud se jedná o varianty produktů, které se liší barvou, rozměry, příchutí, množstvím a dalšími atributy, je nutné všechny tyto parametry rozlišit v názvu produktu, aby se nesloučily do jednoho.
Sekce |
Povinné údaje v názvu pro jednotlivé sekce |
Pneumatiky |
Výrobce | Řada | Velikosti | Průměr | Indexy |
Autosedačky |
Výrobce | Řada | Produktové číslo / Označení | Barva | Ročník |
Mobilní telefony |
Výrobce | Řada | Produktové číslo / Označení | Barva |
Notebooky |
Výrobce | Řada | Produktové číslo / Označení | Kód specifikace |
Digitální fotoaparáty |
Výrobce | Řada | Produktové číslo / Označení | Barva |
Televizory |
Výrobce | Řada | Produktové číslo / Označení |
PC komponenty |
Výrobce | Řada | Produktové číslo / Označení | Vzor |
Baterie |
Výrobce | Řada | Produktové číslo / Označení | Množství | Určení / Typ | Neoriginál |
Satelitní komplety |
Výrobce | Řada | PN přijímače | Typ LNB konvertoru | Typ antény | Typ karty |
Tonery |
Výrobce | Produktové číslo / Označení | Kompatibilní |
Bílé zboží |
Výrobce | Produktové číslo / Označení | Barva |
Stavebnice Lego |
Výrobce | Řada | Produktové číslo / Označení |
Stolní hry |
Výrobce | Řada | Verze |
Hračky |
Výrobce | Řada | Produktový kód | Barva |
Jízdní kola |
Výrobce | Řada | PN/Označení | Barva | Velikost kola | Velikost rámu | Ročník | Určení |
Kolečkové brusle |
Výrobce | Řada | Velikost | Barva | Ročník |
Sjezdové lyže |
Výrobce | PN | Délka | Barva | Ročník | Určení |
Sportovní výživa |
Výrobce | Řada | Množství | Příchuť |
Oblečení |
Výrobce | Řada | Barva | Určení / Typ | Velikost |
Knihy |
Název | Autor |
Hry na konzole |
Název | Verze |
Kalendáře |
Řada | Určení / Typ | Ročník |
Parfémy |
Výrobce | Řada | Množství | Určení / Typ |
Kontaktní čočky |
Výrobce | Řada | Množství | Dioptrie | Průměr | Zakřivení |
Pleťové krémy atd. |
Výrobce | Řada | Typ pleti | Určení | Množství |
Batohy |
Výrobce | Řada | Barva | Objem |
Kabelky |
Výrobce | Řada | Barva | Vzor |
Postele |
Výrobce | Řada | Barva | Rozměry / Velikost |
Sedací soupravy |
Výrobce | Řada | Barva | Určení / Typ | Rozměry / Velikost | Verze |
Ložní povlečení |
Výrobce | Řada | Rozměry / Velikost | Vzor | Materiál |
Vany |
Výrobce | Řada | Produktové číslo / Označení | Délka | Orientace |
Ubrusy |
Výrobce | Řada | Barva | Rozměry / Velikost |
Koberce |
Výrobce | Typ / Řada | Rozměr (metráž) | Barva |
Komody |
Výrobce | Řada | Barva | Rozměry / Velikost | Materiál |
Erotické pomůcky |
Výrobce | Řada | Barva |
Krmiva |
Výrobce | Určení | Plemeno | Příchuť | Množství |
Vodítka pro psy |
Výrobce | Řada | Produktové číslo / Označení | Barva | Rozměry / Velikost |
Kočárky |
Výrobce | Modelová řada | Kombinace složení | Typ kol | Ročník | Barva |
Fusaky |
Výrobce | Řada | Barva |
Káva |
Značka / Výrobce | Řada | Gramáž | Druh |
Vína |
Vinařství | Druh vína | Ročník | Objem |
Brusky |
Výrobce | Produktové číslo / Označení |
Pily |
Výrobce | Produktové číslo / Označení |
E-cigarety |
Výrobce | Řada | Kapacita | Barva | Počet kusů |
LED Pásky |
Výrobce | Druh | Délka | Počet diod | WATTY |
Čistící prostředky |
Výrobce | Kód produktu | Množství |
Přípravky ve zdraví |
Výrobce | Řada | Množství |
Potraviny |
Výrobce | Řada | Množství | Příchuť |
Puzzle |
Výrobce | Řada | Počet dílků |
E-liquidy |
Výrobce | Řada | Příchuť | Objem | Obsah nikotinu |
Brašny na NTB |
Výrobce | Produktové číslo | Úhlopříčka | Barva |
Pouzdra na mobily |
Výrobce | Produktové číslo | Barva |
Výrobce
každý produkt by měl obsahovat v názvu výrobce, docílíte tak jasnému rozlišení
Produktové číslo/označení
elektronika musí obsahovat produktový kód, který jasně určí přesný produkt, včetně všech odlišných parametrů jako je barva, materiál, druh displeje atd. Tedy variantu.
Množství
produkty, které jsou standardně prodávány po určitém množství, není potřeba označovat (např. Pneumatiky 4ks, Reproduktory 2ks atd.). V případě, že však prodáváte odlišné množství a v porovnání cen by nebylo srovnání relevantní, uveďte počet kusů do názvu produktu.
Produkty, které se prodávají na metry (látky, ubrusy, kabely, led pásky, stavebniny atd.) je nutné v názvu uvést s koupitelnou jednotkou, která je funkční. Cena pak musí odpovídat ceně za jednotku uvedenou v názvu.
Barva
každá varianta zboží, jiná barva telefonu, foťáku, trička, kolečkových bruslí, kočárku, lednice, kopaček, brýlí, atd. musí být uvedena v názvu a odlišena tak varianta.
Určení/typ
produkty, které se liší typem, toto musí mít uvedeno v názvu (např. Parfémy – toaletní x parfémovaná voda, Žárovky – normální x LED, Sedací soupravy – dvou x třímístné atd.).
Rozměry/velikost
produkty jako povlečení, postele, koberce – musí mít v názvu, případně v tagu PRODUCT odlišenu variantu rozměrem (např. 90x200). Produkty jako jízdní kola, lyže, kontaktní čočky, oblečení – musí mít v názvu odlišenu variantu velikosti.
Ročník
produ
nokkty, které s každou novou sezónou mají jiné vlastnosti (např. materiál, vzor atd.), musí mít ročník uveden v názvu (např. sportovní náčiní - jízdní kola, sjezdové lyže nebo autosedačky, kočárky, vína, atd.)
Autor a EAN
knihy, mapy, učebnice musí mít jasně určeného autora a EAN případně ISBN. Elektronické knihy musí být odlišeny vlastní kategorií.
Verze
produkty jako software musí obsahovat v názvu všechny atributy varianty, jaká je to edice, pro kolik uživatelů, jaká licence atd.
Vzor
produkty jako batohy, povlečení, bytové doplňky, atd., musí být v názvu odlišeny vzorem, podle kterého se uživatelé rozhodují pro danou variantu.
Příchuť
produkty jako krmiva pro zvířata, sušené maso, sportovní výživa atd. musí mít rozlišení varianty příchuti v názvu.
Materiál
produkty jako nábytek musí mít v názvu odlišeny varianty druhu materiálu, ze kterého je produkt vyroben. Např. dub, smrk, třešeň.
Dárkové balení
Produkty, které jsou v dárkovém balení, tedy v jiném balení, než je běžné, by měly mít označení uvedeno v názvu, např.: Vánoční balení 2021, Valentýnské balení, Dárková sada atd.
Tag Produkt obsahuje PRODUCTNAME (název produktu) + informaci o distribuci produktu nebo možnosti osobního odběru, např. „Whirlpool WBA 43983 NFC IX – osobní odběr v Praze“.Tento název bude aktuálně zobrazen v žebříčku e-shopů na produktovém detailu. Do budoucna plánujeme změnu ve způsobu zobrazování těchto informací a název v této podobě bude následně skryt.
Maximální délka názvu produktu je 255 znaků pro zobrazení ve fulltextovém vyhledávání. Pro zařazení produktů do katalogu Heureky (v PPC režimu) je povoleno maximum 200 znaků.
Pro zadání informací o rozšířené záruce a doplňkových službách nově použijte tagy k tomu určené. Prodlouženou záruku uvádějte v tagu <EXTENDED_WARRANTY>.
Doplňkové služby, jako je například vynesení do patra, servis, výměna nebo instalace spotřebiče a podobné, uvádějte do tagu <SPECIAL_SERVICES>.
Povolená rozšíření:
- pouze osobní odběr
- doba expirace produktu
- distribuce produktu (CZ, EU, mimo EU)
Nepovolená rozšíření:
- doprava zdarma (uvádějte pouze v tagu <DELIVERY>)
- dostupnost (uvádějte v dostupnostním feedu)
- autorizovaný prodejce
- splátkový prodej
- osobní odběr na pobočkách
- sleva na další nákup a další formy vyjádřené slevy (okamžitá sleva, akční cena, bonus…)
Popis produktu, snažte se uvádět co nejrelevantnější popis, ve fulltextovém vyhledávání se bere v potaz. Měl by obsahovat popis a specifikaci výrobku bez reklamy na dopravu zdarma, akce a daný obchod. Není povolena nadměrná interpunkce. Počet znaků v tagu DESCRIPTION není omezen, avšak ve fulltextu zobrazujeme pouze 200 znaků.
Pro aktivaci Heureka Marketplace je nezbytné nám v tomto tagu posílat kompletní popisek, ne pouze zkrácenou verzi (stejný text jako na detailu produktu v eshopu).
Odkaz na stránku s nabídkou daného výrobku v obchodě. Na této stránce musí být uvedena cena produktu v korunách českých a možnost vložit do košíku. Adresa musí být unikátní v rámci celého feedu. URL nesmí být delší než 300 znaků.
Odkaz na hlavní/primární obrázek produktu.
Podmínky pro obrázky
Adresa obrázku nesmí obsahovat mezery či diakritiku. Maximální délka URL adresy obrázku je 255 znaků. Pokud máte pro
více produktů jeden obrázek, použijte vždy jednu a tu samou adresu (adresa nemusí být jedinečná v rámci feedu).
Dále by obrázek neměl mít průhledné pozadí. Při změně obrázku na stránkách obchodu je třeba změnit též url adresu
obrázku v XML souboru. Minimální potřebná velikost obrázku je 20x50 nebo 50x20 pixelů, avšak aby byl obrázek
kvalitní, je třeba, aby měl alespoň 30 000 pixelů (cca 175x175 pixelů). Maximální velikost obrázků je
rozlišení 4096 x 4096 pixelů a datově max. 2000 KB (2MB).
Posílejte nám pouze obrázky (nejlépe *jpeg) produktů. Obrázky typu https://www.srovnanicen.cz/static/css/image/bez-obrazku.gif do feedu nedávejte! Zajistěte, aby na jedné url nedocházelo k rotování obrázků (na jedné adrese se musí vždy nacházet ten samý obrázek), protože náš systém si může stáhnout z vašich stránek obrázek kdykoliv. Vám by se pak mohly zobrazovat špatné (nebo také žádné) obrázky u produktů.
Obrázky musí být univerzální a obecné, nesmí tedy obsahovat vodoznak, zobrazení slevy či bonusu ani upozornění na nějakou přednost produktu včetně ocenění. V opačném případě budou blokovány.
Je-li váš obchod zapojený do modelu Heureka Marketplace a posílá obrázky s vodoznakem, tak se vaše nabídky nezobrazí na horní TOP pozici, i kdyby byly nejvýhodnější (budou se zobrazovat pouze v porovnání cen).
Odkaz na další obrázek výrobku, například pohled z jiného úhlu, přehled celého balení, apod. Lze uvést vícekrát.
Odkaz na videorecenzi produktu. Lze uvádět pouze odkazy na videa umístěná na serveru www.youtube.com.
Koncová cena produktu s DPH, v ceně musí být uvedeny autorské a recyklační poplatky.
Uvádění ceny
Ceny na serveru Heureka.cz uvádíme konečné.
Cena může být uvedena v těchto formátech:
- 25 000
- 25000
- 25000,50
- 25000.50
Nepoužívejte jako oddělovač tisíců/miliónů tečku ('.'), ta je použita k oddělování desetinných míst. Cenu uvádějte maximálně na 2 desetinná místa.
Je-li váš obchod zapojen do Heureka Marketplace je nutné nám v tomto tagu posílat ceny zboží již zaokrouhlené na celé koruny. Posíláte-li s produktem také voucher na slevu (viz tag SALES_VOUCHER) musí cena v tagu PRICE_VAT odpovídat ceně po aplikaci tohoto voucheru.
DPH, daň se liší dle kategorie zboží.
DPH
Tag <VAT> je doplňují hlavně pro EET, stále můžete posílat
<PRICE_VAT> a
<VAT>
<?xml version="1.0" encoding="utf-8"?>
<VAT>21%</VAT>
Parametr VAT je povinný pro obchody prodávající zboží s rozdílnou (sníženou) sazbou DPH v Heureka
Košíku. Více info naleznete zde.
K rozlišení nových položek. Tímto tagem označujte produkty typu:
- použité či repasované;
- s poškozeným, neoriginálním či bulk balením (White box, OEM, blist, atd.);
- vráceny ve 14 denní lhůtě;
- bez plnohodnotné záruční lhůty;
- druhé jakosti;
- výstavní či předváděcí kusy;
- rozbalené (otevřené);
- zboží ve zvláštním režimu DPH;
- a další, které Heureka nepovažuje za nové.
<ITEM_TYPE>bazar</ITEM_TYPE>
Tyto produkty nesmí být označeny jako nové, ale buď jako bazarové nebo je do XML souboru pro Heureku neuvádějte vůbec.
Zde lze uvést
parametry produktu, pokud nejsou parametry vyplněné, pak není možné zobrazovat vaše produkty v konkrétním filtrování. Parametr velikost je u produktů v sekci Móda povinný.
Formát hodnoty <VAL> může být ano x ne v případě, že si na vlastnost, odpovíte, jen má či nemá. V případě, že odpověď na vlastnost bude jinými slovy, či číselným údajem, hodnoty <VAL> již vyplňujeme danou hodnotou.
Číselné parametry jako hmotnost, hlučnost a další, musí mít v hodnotě <VAL> uvedeno nejen číslo, ale i jednotku. Jinak není parametr zařazen.
<PARAM>
<PARAM_NAME>určení</PARAM_NAME>
<VAL>dámské</VAL>
</PARAM>
<PARAM>
<PARAM_NAME>objem</PARAM_NAME>
<VAL>100ml</VAL>
</PARAM>
<PARAM>
<PARAM_NAME>VELIKOST</PARAM_NAME>
<VAL>S</VAL>
</PARAM>
<PARAM>
<PARAM_NAME>BARVA</PARAM_NAME>
<VAL>ČERNÁ</VAL>
</PARAM>
Obsahuje název výrobce produktu, využívá se pro zařazení pod filtrovací parametr, nikoli pro párování položek. Výrobce tedy musí být obsažen taktéž i v tagu PRODUCTNAME.
Pokud je produkt prodáván pod jinou značkou, která se neshoduje s výrobcem a uživatelé podle ní produkt vyhledávají – udejte značku. Např. u pracího prášku Palmex je výrobcem Henkel. Do tagu Manufacturer uveďte Palmex.
Zařazení produktu do kategorie, uvádějte vždy celou cestu k produktu, tak jak to máte na vašem eshopu (stačí nám tedy vaše kategorie) pokud jasně určují druh produktu. Případně využijte náš strom aktivních kategorií
https://www.heureka.cz/direct/xml-export/shops/heureka-sekce.xml
Elektronika | Mobilní telefony | Příslušenství | Nabíječky | Originální
Nabíječky
Pokud se vaše produkty nezařadí na základě 100% shody názvu s názvem na Heurece nebo díky EAN, je správný Categorytext jedinou možností jak spárovat (zakategorizovat) produkty.
Kategorie musí vždy jasně určovat druh produktu, které se pod ní skrývají.
Elektronika | Televize | LCD televize
Elektronika | Bílá technika | Ost. Kuchyňské přístroje | Vaflovače
Dětské zboží | Hračky | Pro nejmenší | Chrastíka
Kosmetika | Pleťové kosmetika | Pleťové krémy
Chovatelství | Pro psy | Krmivo
Oblečení | Dámské | Trička
Televize
Ostatní kuchyňské přístroje
Podle výrobce | Bosch
Hračky | Cars
Kosmetika | Pleťová kosmetika
Chovatelství | Krmiva
Oblečení | Dámské oblečení
Oblečení | Krátká trička
Pozn.: Jednotlivé podkategorie oddělujte následujícím způsobem NADKATEGORIE mezera | mezera PODKATEGORIE
EAN kód je používán k označování jednotlivých druhů zboží. Podporujeme formát EAN 13. Neuvádějte však interní čísla produktů, ale oficiální kódy zboží! (
více o EAN kódu)
EAN kód je povinnou položkou pro kategorii Knihy, Učebnice, Mapy a průvodci, Filmy, Hudba a Komiksy.
Alfanumerický kód určený pro jednoznačnou identifikaci knižních vydání. Podporujeme formáty ISBN-10 a ISBN-13. Čísla v ISBN kódu se oddělují pomlčkou, například "978-0-123456-47-2". (
více o ISBN kódu)
Tagem nastavujete maximální cenu, kterou jste ochotni za proklik nabídnout. Desetinná místa oddělujte desetinnou čárkou. Maximální cena za klik je 1 000 Kč. Pokud nechcete bidovat, tag vůbec neuvádějte. Nepište prosím číslo 0.
Dodací doba produktu ve dnech, tj. doba od přijetí platby (v případě dobírky od přijetí objednávky) do expedice zboží. Číselná hodnota je poté našim systémem automaticky převáděna na textové vyjádření.
Dostupnost se pak na Heureka.cz zobrazuje jako:
- skladem - 0
- do 3 dnů - 1-3
- do týdne - 4-7
- do 2 týdnů - 8-14
- do měsíce - 15-30
- více než měsíc - 31 a více
- info v obchodu - pokud dodací dobu neuvádíte
Pozn.: Detailní a aktuální informace o dostupnosti zboží lze poskytovat také prostřednictvím samostatného XML feedu (
více o dostupnostním XML), který je aktualizován každých 10 minut.
Příklady:
- Zboží skladem je možné uvést jako:
<DELIVERY_DATE>0</DELIVERY_DATE>
- Dodací doba uváděna ve dnech (pouze celočíselná hodnota):
<DELIVERY_DATE>4</DELIVERY_DATE>
- Dodací doba uvedená datem – od tohoto data bude produkt uveden na trh:
<DELIVERY_DATE>2013-08-15</DELIVERY_DATE>
Pozn.: Toto označení se využívá pouze pro případy, kdy je produkt nově uveden na trh a je prodejný až od určitého data, za předpokladu, že lze učinit předobjednávky. V případě, že jsou produkty dlouhodobě nedostupné a není známa ani přibližná doba dodání, pak nesmí být tyto produkty v XML souboru uváděny.
Hodnota DELIVERY_DATE |
Zobrazení na Heurece |
Přípustná interpretace na e-shopu |
hodnota 0 |
Skladem |
- skladem
- skladem u dodavatele, expedice do 24 hodin
- skladem v expedičním skladu, expedice do 24 hodin
- skladem na prodejně
- ihned (k odběru)
- expedice do 24 hodin
Pozn. počet kusů ve eshopu mít být > 0
|
hodnoty 1-3 |
Do 3 dnů |
- skladem, dodání do 2-5 pracovních dnů
- obvykle skladem (expedice do 3 dnů)
- skladem u dodavatele (expedice do 3 dnů)
|
hodnoty 4 - 7 |
Do týdne |
- skladem, dodání do 7 pracovních dnů
- obvykle skladem (expedice do 7 dnů)
- skladem u dodavatele (expedice do 7 dnů)
|
hodnota 8 - 14 |
Do 2 týdnů |
- 8 a více dní
- obvykle skladem (expedice do 14 dnů)
- skladem u dodavatele (expedice do 14 dnů)
|
hodnota 15 - 30 |
Do měsíce |
- na dotaz (expedice do 30 dnů)
- na objednávku (expedice do 30 dnů)
|
hodnota 31 a více |
Více jak měsíc |
|
prázdná hodnota |
Info v obchodu |
- neuvedená dostupnost
- neznámá
- vyprodáno
|
Způsob a cena dopravy, který lze využít pro dodání tohoto produktu. Opakuje se tolikrát, kolik způsobů dopravy lze pro tento produkt využít.
Obsahuje tagy:
- DELIVERY_ID - řetězec identifikující dopravce. Lze vybrat z námi určených dopravců, nelze uvádět jiné, než dáváme na výběr.
- DELIVERY_PRICE - celková cena (vč. DPH) konkrétního způsobu dodání pro tento produkt při platbě předem.
- DELIVERY_PRICE_COD - celková cena (vč. DPH) konkrétního způsobu dodání pro tento produkt včetně doběrečného. Pokud je cena dopravy s doběrečným stejná jako běžná cena, tak cenu v tomto tagu zopakujte. Není-li možné zboží doručit tímto dopravcem na dobírku, tag neuvádějte.
Pozn: pokud od daných dopravců využíváte více služeb, uvádějte cenu nejlevnější z nich, musí však splňovat, že touto službou je možné dodání po celé ČR zákazníkům až domů (nikoliv na výdejní místo).
Zde jsou uvedeni podporovaní dopravci v následujícím znění:
Doručení na adresu
Česká pošta - Balík Do ruky
<DELIVERY_ID>CESKA_POSTA</DELIVERY_ID>
Česká pošta - Doporučená zásilka
<DELIVERY_ID>CESKA_POSTA_DOPORUCENA_ZASILKA</DELIVERY_ID>
ČSAD Logistik Ostrava
<DELIVERY_ID>CSAD_LOGISTIK_OSTRAVA</DELIVERY_ID>
DPD
<DELIVERY_ID>DPD</DELIVERY_ID>
DHL
<DELIVERY_ID>DHL</DELIVERY_ID>
DSV
<DELIVERY_ID>DSV</DELIVERY_ID>
FOFR
<DELIVERY_ID>FOFR</DELIVERY_ID>
Gebrüder Weiss
<DELIVERY_ID>GEBRUDER_WEISS</DELIVERY_ID>
Geis
<DELIVERY_ID>GEIS</DELIVERY_ID>
GLS
<DELIVERY_ID>GLS</DELIVERY_ID>
HDS
<DELIVERY_ID>HDS</DELIVERY_ID>
PPL
<DELIVERY_ID>PPL</DELIVERY_ID>
Seegmuller
<DELIVERY_ID>SEEGMULLER</DELIVERY_ID>
TNT
<DELIVERY_ID>TNT</DELIVERY_ID>
TOPTRANS
<DELIVERY_ID>TOPTRANS</DELIVERY_ID>
UPS
<DELIVERY_ID>UPS</DELIVERY_ID>
FedEX
<DELIVERY_ID>FEDEX</DELIVERY_ID>
Raben Logistics
<DELIVERY_ID>RABEN_LOGISTICS</DELIVERY_ID>
Zásilkovna na adresu
<DELIVERY_ID>ZASILKOVNA_NA_ADRESU</DELIVERY_ID>
123kurýr
<DELIVERY_ID>123KURIER</DELIVERY_ID>
WE|DO HOME
<DELIVERY_ID>WEDO_HOME</DELIVERY_ID>
Rhenus Logistics
<DELIVERY_ID>RHENUS_LOGISTICS</DELIVERY_ID>
MESSENGER
<DELIVERY_ID>MESSENGER</DELIVERY_ID>
Výdejní místa
Zásilkovna
<DELIVERY_ID>ZASILKOVNA</DELIVERY_ID>
DPD Pickup
<DELIVERY_ID>DPD_PICKUP</DELIVERY_ID>
Balíkovna
<DELIVERY_ID>BALIKOVNA_DEPOTAPI</DELIVERY_ID>
WE|DO POINT
<DELIVERY_ID>WEDO_POINT</DELIVERY_ID>
Česká pošta - Balík Na poštu
<DELIVERY_ID>CESKA_POSTA_NAPOSTU</DELIVERY_ID>
PPL Parcelshop
<DELIVERY_ID>PPL_PARCELSHOP</DELIVERY_ID>
GLS ParcelShop
<DELIVERY_ID>GLS_PARCELSHOP</DELIVERY_ID>
AlzaPoint
<DELIVERY_ID>ALZAPOINT</DELIVERY_ID>
Výdejní boxy
DPD Box
<DELIVERY_ID>DPD_BOX</DELIVERY_ID>
Z-BOX
<DELIVERY_ID>Z_BOX</DELIVERY_ID>
WE|DO BOX
<DELIVERY_ID>WEDO_BOX</DELIVERY_ID>
PPL Parcelbox
<DELIVERY_ID>PPL_PARCELBOX</DELIVERY_ID>
Balíkovna-BOX
<DELIVERY_ID>BALIKOVNA_BOX</DELIVERY_ID>
AlzaBox
<DELIVERY_ID>ALZABOX</DELIVERY_ID>
Ostatní možnosti doručení
Online doručení
<DELIVERY_ID>ONLINE</DELIVERY_ID>
Vlastní přeprava
<DELIVERY_ID>VLASTNI_PREPRAVA</DELIVERY_ID>
Pozn: pokud nabízíte vlastní přepravu zboží, opět vaše přeprava musí splňovat, že ji nabízíte po celé ČR.
Označení skupiny produktů, které vzájemně představují varianty. Kombinace maximálně 36 znaků [ _ - 0-9 a-z A-Z ] tedy podtržítka, pomlčky, čísel nula až devět a malých a velkých písmen bez diakritiky.
Varianty v XML Feedu 2.0
Variantou odlišujte různé velikosti, barvy, vzory, sady a druhy produktů. Stejnou skupinu pak ve feedu označíte v tagu ITEMGROUP_ID.
Příklad:
<?xml version="1.0" encoding="utf-8"?>
<SHOP>
<SHOPITEM>
<ITEM_ID>325236407</ITEM_ID>
<PRODUCTNAME>Adidas Superstar 2 W EUR 36</PRODUCTNAME>
<PRODUCT>Adidas Superstar 2 W EUR 36 - novinka</PRODUCT>
<DESCRIPTION>V rámci kolekce Originals uvádí adidas sportovní obuv The Superstar, která je již od svého vzniku jedničkou mezi obuví. Jejím poznávacím znamením je mimo jiné detaily designové zakončení špičky. Díky kvalitnímu materiálu a trendy vzhledu, podtrženého logy Adidas uvnitř boty i na ní, bude hvězdou vašeho botníku.</DESCRIPTION>
<URL>http://www.obchod-s-obuvi.cz/boty/adidas-superstar-2-w7/eur-36/</URL>
<IMGURL>http://www.obchod-s-obuvi.cz/pictures/403078.jpg</IMGURL>
<IMGURL_ALTERNATIVE>http://www.obchod-s-obuvi.cz/pictures/403080.jpg</IMGURL_ALTERNATIVE>
<MANUFACTURER>Adidas</MANUFACTURER>
<CATEGORYTEXT>Obuv | Dámská obuv</CATEGORYTEXT>
<EAN>5051571703857</EAN>
<PRODUCTNO>G43755</PRODUCTNO>
<PARAM>
<PARAM_NAME>Velikost</PARAM_NAME>
<VAL>EUR 36</VAL>
</PARAM>
<DELIVERY_DATE>2</DELIVERY_DATE>
<DELIVERY>
<DELIVERY_ID>CESKA_POSTA</DELIVERY_ID>
<DELIVERY_PRICE>120</DELIVERY_PRICE>
</DELIVERY>
<ITEMGROUP_ID>ZD563</ITEMGROUP_ID>
</SHOPITEM>
<SHOPITEM>
<ITEM_ID>325236408</ITEM_ID>
<PRODUCTNAME>Adidas Superstar 2 W EUR 37</PRODUCTNAME>
<DESCRIPTION>V rámci kolekce Originals uvádí adidas sportovní obuv The Superstar, která je již od svého vzniku jedničkou mezi obuví. Jejím poznávacím znamením je mimo jiné detaily designové zakončení špičky. Díky kvalitnímu materiálu a trendy vzhledu, podtrženého logy Adidas uvnitř boty i na ní, bude hvězdou vašeho botníku.</DESCRIPTION>
<URL>http://www.obchod-s-obuvi.cz/boty/adidas-superstar-2-w7/eur-37/</URL>
<IMGURL>http://www.obchod-s-obuvi.cz/pictures/403078.jpg</IMGURL>
<IMGURL_ALTERNATIVE>http://www.obchod-s-obuvi.cz/pictures/403080.jpg</IMGURL_ALTERNATIVE>
<MANUFACTURER>Adidas</MANUFACTURER>
<CATEGORYTEXT>Obuv | Dámská obuv</CATEGORYTEXT>
<EAN>5051571703864</EAN>
<PRODUCTNO>G43755</PRODUCTNO>
<PARAM>
<PARAM_NAME>Velikost</PARAM_NAME>
<VAL>EUR 37</VAL>
</PARAM>
<DELIVERY_DATE>2</DELIVERY_DATE>
<DELIVERY>
<DELIVERY_ID>CESKA_POSTA</DELIVERY_ID>
<DELIVERY_PRICE>120</DELIVERY_PRICE>
</DELIVERY>
<ITEMGROUP_ID>ZD563</ITEMGROUP_ID>
</SHOPITEM>
<SHOPITEM>
...
</SHOPITEM>
</SHOP>
Obsahuje ITEM_ID položky, která je příslušenstvím k tomuto
produktu, např. nabíječka, pouzdro, apod. Lze uvést vícekrát.
Součet veškerých poplatků (pokud již nejsou obsaženy v konečné ceně
produktu), které je nutné zaplatit při zakoupení produktu (cena uvedena vč. DPH, nezahrnuje dopravu a balné).
Poplatek je poté automaticky připočten k ceně produktu s DPH.
Obsahuje textový popis dárků, nebo položek, které jsou k produktu zdarma.
Limit pro délku názvu jednoho dárku je 250 znaků.
Volitelně může obsahovat atribut
ID pro jednoznačnou identifikaci dárků
(doporučujeme používat).
Tento atribut má shodný formát jako ITEM_ID.
Kombinace maximálně 36 znaků [ _ - 0-9 a-z A-Z ] tedy podtržítka, pomlčky, čísel nula až devět
a malých a velkých písmen bez diakritiky.
<?xml version="1.0" encoding="utf-8"?>
<SHOP>
<SHOPITEM>
...
<GIFT>Pouzdro zdarma</GIFT>
<GIFT ID="gift01">Paměťová karta zdarma</GIFT>
</SHOPITEM>
</SHOP>
Dárek je potřeba uvádět pouze ke konkrétnímu produktu, u kterého zákazník dárek skutečně získá. Dárek nesmí být dále ničím omezen (vyšší částkou objednávky, nákupem dalšího produktu, atd.).
Lze uvádět vícekrát, v případě že všechny dárky jsou dodávány k jednomu produktu. V případě možnosti výběru mezi dárky, je uveden pouze jeden dárek.
Dárkem je myšlen předmět či voucher na danou věc, nikoli sleva či služba.
Dovoleno je také používání cashbacku, nicméně musí být uveden pouze u produktu, ke kterému je skutečně nabízen a musí být uvedena konkrétní částka, či zboží, které je předmětem cashbacku.
V případě, že je cashback od konkrétní značky a je nabízen všem uživatelům, informace je ze strany Heureky uvedena v popisu produktu a není povoleno jí uvádět do tagu GIFT.
Pokud se jedná o cashback od značky pro vybrané obchody, musí být uveden jako: "cashback XXX při registraci na stránkách XXX".
Tento tag obsahuje informaci o prodloužené záruce produktu. Pokud tedy chcete na Heurece prodlouženou záruku zobrazit, je vyplnění tohoto popisku povinné. Můžete také uvést dobu prodloužení záruky, která se uvádí v měsících. Maximální délka popisku je 128 znaků.
<?xml version="1.0" encoding="utf-8"?>
<EXTENDED_WARRANTY>
<VAL>36</VAL>
<DESC>Záruka 36 měsíců</DESC>
</EXTENDED_WARRANTY>
Tag Special Service obsahuje informaci o doplňkové službě poskytnuté k nákupu produktu. Množství nabízených služeb je omezeno na maximální počet 5, což se rovná i maximálnímu množství výskytu tohoto tagu v XML feedu. V případě překročení maximálního počtu 5 služeb nebude tento tag vůbec zpracován a u produktu se nezobrazí žádná doplňková služba. Maximální délka popisku je 128 znaků.
<?xml version="1.0" encoding="utf-8"?>
<SPECIAL_SERVICE>Instalace spotřebiče zdarma</SPECIAL_SERVICE>
<SPECIAL_SERVICE>Montáž spotřebiče zdarma</SPECIAL_SERVICE>
<SPECIAL_SERVICE>Odvoz obalového materiálu</SPECIAL_SERVICE>
<SPECIAL_SERVICE>Výnos do patra</SPECIAL_SERVICE>
Příklady doplňkových/speciálních služeb:
- servis zdarma
- vynesení do patra
- prodloužení záručního/pozáručního servisu
- prodloužená doba vrácení zboží
- a další
Co do tohoto tagu nepatří:
- doprava zdarma (uvádějte pouze v tagu )
- informace o dostupnosti (uvádějte v dostupnostním feedu)
- označení autorizovaného prodejce
- možnost splátkového prodeje
- osobní odběr na pobočkách
- sleva na další nákup
- a další formy vyjádřené slevy (okamžitá sleva, akční cena, bonus…)
Voucher na slevu k produktu. Pomocí tohoto tagu můžete poskytnout uživatelům kód na slevu, který mohou uplatnit ve vašem obchodu. Voucher se týká vždy produktu, u kterého je uveden. Pokud poskytujete plošnou slevu na všechny produkty, může být stejný voucher uveden u všech produktů obchodu.
Upozornění: Pokud chcete zaslání voucheru na slevu využít, musí cena v tagu PRICE_VAT odpovídat ceně po aplikaci tohoto voucheru.
<?xml version="1.0" encoding="utf-8"?>
<SALES_VOUCHER>
<CODE>SLEVA20</CODE>
<DESC>Sleva 20% po zadání kódu do 31.12.2021!</DESC>
</SALES_VOUCHER>
CODE obsahuje kód slevy, kterou uživatel zadá ve vašem e-shopu. Maximální délka je 24 znaků.
DESC obsahuje popis slevy, bude zobrazen u kódu. V případě, že je platnost voucheru časově omezena, doporučujeme zde platnost uvést. Maximální délka je 128 znaků. Přebytečné znaky budou oříznuty a doplněny “…”.
Podmínky zasílání voucherů na slevu ve feedu:
- Voucher musí mít možnost využít libovolný zákazník.
- Jeho použití nesmí být podmíněno například nákupem více kusů nebo druhů produktů, registrací do obchodu, členstvím ve věrnostním klubu, apod.
- Pokud je platnost voucheru časově omezena, po vypršení platnosti nesmí být voucher nadále ve feedu. Konec platnosti voucheru doporučujeme uvést v popisku DESC.
- Cena produktu zaslaná v tagu PRICE_VAT musí odpovídat ceně po aplikaci tohoto voucheru.
- Po prokliku z Heureky je cena produktu na webu vašeho obchodu viditelně zobrazena před slevou a po slevě (např. “cena s kódem ...”).
Vytvoření XML souboru pomocí CDATA
Tohoto zápisu využijete v případě textů, kde se vyskytuje příliš mnoho nepovolených znaků (např. "&", "<", ">")
<MANUFACTURER><![CDATA[Black & Decker]]></MANUFACTURER>
Nejčastější chyby
1) Nenahrazení některých znaků (např. "&", "<", ">") entitami
<MANUFACTURER>Black & Decker</MANUFACTURER>
Možné řešení:
<MANUFACTURER>Black & Decker</MANUFACTURER>
<MANUFACTURER><![CDATA[Black & Decker]]></MANUFACTURER>
Více o entitách v článku na serveru Interval.cz DTD: entity a notace.
2) Neuzavřený element
<PRODUCT>Clinique Happy EdP 30ml
<DESCRIPTION>Tenoučký slide-up s bohatou multimediální výbavou</DESCRIPTION>
<URL>http://obchod.cz/parfemy/clinique-happy-edp</URL>
3) Chybný formát url
<IMGURL>/parfemy/clinique-happy-edp/obrazek.jpg</IMGURL>
<IMGURL>není</IMGURL>
<URL>http://obchod.cz/noční krém</URL>
4) Tagy malými písmeny
Máte v XML souboru vyplněny například parametry produktu, či dopravu, ale nezobrazují se vám na Heurece?
Zkontrolujte, zda neuvádíte tagy malými písmeny, takové tagy Heureka nezpracuje.
Tagy je vždy potřeba uvádět velkými písmeny.
<param>
<param_name>barva</param_name>
<val>červená</val>
</param>
<delivery>
<delivery_id>CESKA_POSTA</delivery_id>
<delivery_price>45</delivery_price>
<delivery_price_cod>58</delivery_price_cod>
</delivery>