Specifikace XML souboru

Jedná se o povinný tag, bez kterého nedojde k zobrazení položek na Heurece.
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 0-9 a malých a velkých písmen bez diakritiky. Tag se dosud pro párování položek nevyužívá.

V tagu PRODUCTNAME by měl být uveden základní název produktu, který obsahuje všechny povinné informace podle vybrané kategorie. Maximální délka textu v tomto tagu je omezena na 200 znaků.

PRODUCTNAME by neměl obsahovat žádné doplňkové informace jako např. dárek, pouzdro či nabíječka zdarma apod.

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.

Příklady správných názvů produktů naleznete zde.

Tag PRODUCT obsahuje PRODUCTNAME (přesný název produktu) + možnou doplňující informaci o distribuci produktu nebo možnosti osobního odběru, např. „Whirlpool WBA 43983 NFC IX – osobní odběr v Praze“.

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 Kč a možnost vložit do košíku. URL adresa musí být u každého produktu unikátní. V případě, že máte více variant produktu, zajistěte unikátnost URL pro každou variantu. Pokud máte varianty produktů na svém e-shopu na jedné stránce, pak je jediným řešením používat tzv. hashtagy.

Funguje to tak, že do XML feedu rozdělíte každou variantu produktu zvlášť se svým vlastním PRODUCTNAME (ve kterém je i produktový kód) a jako URL použijete např. toto:

http://www.test.cz/product/tastickova-matrace-argon-latex-9-zon#1

http://www.test.cz/product/tastickova-matrace-argon-latex-9-zon#2

Prohlížeče pak odkáží pouze na text před znakem #, tedy u obou na shodnou adresu http://www.test.cz/product/tastickova-matrace-argon-latex-9-zon, ale pro náš systém bude brána v potaz adresa celá i s textem za znakem #; URL tedy pro nás bude unikátní.
URL nesmí být delší než 300 znaků.

Tuto úpravu doporučuji řešit s vaším webmasterem.

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.

Specifikace

• Minimální potřebná velikost obrázku je 20 x 50 nebo 50 x 20 pixelů (doporučujeme ale alespoň 175 x 175 pixelů) a 30 kB
• Maximální velikost obrázků je 4 096 x 4 096 pixelů a 2 000 kB
• Maximální délka URL adresy obrázku je 255 znaků
• Aktuálně podporujeme pouze formát jpeg

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).

Koncová cena produktu s DPH, v ceně musí být uvedeny autorské a recyklační poplatky.
Uvádění ceny v Kč.
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.
Cena musí být uvedena za jeden produkt a nelze uvádět cenu v množstevní slevě. Množstevní slevy nejsou na Heurece podporovány.
Pokud se tedy cena od dvou kusů mění, neuvádějte jí na Heurece.

V případě, že se vaše cena v porovnání neaktualizuje, častou chybou bývá, že zatím nebyla generována do feedu a my tak nemáme o změně informace.

Doporučujeme vždy zkontrolovat, že cena je již v XML souboru aktualizovaná a od té doby již proběhl z naší strany import feedu.

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.

• použité či repasované;
• s poškozeným, neoriginálním či bulk balením (White box, OEM, blist, atd.);
• vráceny ve 14denní 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í.

Seznam parametrů (XLSX/CSV)

Zařazení produktu do kategorie, uvádějte vždy celou cestu k produktu, ideálně podle našeho stromu kategorií. Využívat můžete samozřejmě také své kategorie, jen se ujistěte, že odpovídají struktuře kategorizace Heureky.

Správně uvedená kategorizační cesta:

Heureka.cz | Velké spotřebiče | Pračky a sušičky | Pračky

Špatně uvedená kategorizační cesta:

Velké spotřebiče | Pračky a sušičky

EAN kód je povinnou položkou pro kategorie Knihy, Učebnice, Mapy a průvodci, Filmy, Hudba a Komiksy.
Pokud tedy prodáváte jiné zboží, pak EAN není povinný a není tedy třeba ho zasílat.

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í.

• 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

Neuvádějte hodnotu s pomlčkou, ale pouze jednu vybranou číslici.

• 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>

Cena a způsob dopravy, který lze využít pro dodání tohoto produktu. Opakuje se tolikrát, kolik způsobů dopravy lze pro tento produkt využít.

Každou dopravu lze u produktu uvádět pouze jednou. V případě, že uvedete dva dopravce u jednoho produktu, způsobíte chybu a ani jednu dopravu nezobrazíme. Maximální počet doprav ve feedu je 100 různých.

V případě, že zvolíte dopravu skrze feed, pak je doprava, která je vyplněna v administraci pod „ceny dopravy“ zcela ignorována, jelikož tag DELIVERY má přednost.

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>

PPL

<DELIVERY_ID>PPL</DELIVERY_ID>

Seegmuller

<DELIVERY_ID>SEEGMULLER</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>

One Courier

<DELIVERY_ID>ONE_COURIER</DELIVERY_ID>

Rhenus Logistics

<DELIVERY_ID>RHENUS_LOGISTICS</DELIVERY_ID>

MESSENGER

<DELIVERY_ID>MESSENGER</DELIVERY_ID>

Balíkovna na adresu

<DELIVERY_ID>BALIKOVNA_NA_ADRESU</DELIVERY_ID>

QDL

<DELIVERY_ID>QDL</DELIVERY_ID>

DB SCHENKER

<DELIVERY_ID>DB_SCHENKER</DELIVERY_ID>

EMONS

<DELIVERY_ID>EMONS</DELIVERY_ID>

Výdejní místa

<DELIVERY_ID>ZASILKOVNA</DELIVERY_ID>

DPD Pickup

<DELIVERY_ID>DPD_PICKUP</DELIVERY_ID>

Balíkovna

<DELIVERY_ID>BALIKOVNA_DEPOTAPI</DELIVERY_ID>

One Point

<DELIVERY_ID>ONE_POINT</DELIVERY_ID>

PPL Parcelshop

<DELIVERY_ID>PPL_PARCELSHOP</DELIVERY_ID>

GLS ParcelShop

<DELIVERY_ID>GLS_PARCELSHOP</DELIVERY_ID>

AlzaPoint

<DELIVERY_ID>ALZAPOINT</DELIVERY_ID>

UPS_Access Point

<DELIVERY_ID>UPS_ACCESS_POINT</DELIVERY_ID>

Výdejní boxy

DPD Box

<DELIVERY_ID>DPD_BOX</DELIVERY_ID>

Z-BOX

<DELIVERY_ID>Z_BOX</DELIVERY_ID>

One Box

<DELIVERY_ID>ONE_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>

GLS Parcelbox

<DELIVERY_ID>GLS_PARCELBOX</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. Jedná se o vaši dopravu k zákazníkovi. Nejde o osobní odběr, dopravu po městě/ kraji atd.

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.

Umožňuje vašemu e-shopu prodávat příslušenství ke zboží, které má zákazník v košíku. Tyto doplňky si sami zvolíte, ať už jde o nabíječky, pouzdra či cokoliv relevantního.

Ke každému produktu lze přiřadit až 10 tagů, obsahujících ITEM_ID položky. Zákazníkovi se pak před zakoupením zobrazuje maximálně 10 konkrétních produktů.

<?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.

Pokud uvádíte více dárků, nelze si určit jejich pozici na produktové kartě. Pokud se rozhodnete k jednomu produktu zasílat více dárků, je třeba v zásilce odeslat všechny uvedené dárky (nelze si vybrat, jaký dárek pošlete).

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ů.

Pokud uvedete ve VAL větší hodnotu než 999, bude Heureka zobrazovat doživotní záruku.

<?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 u jednoho produktu. 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á doba vrácení zboží,
• a další

Co do tohoto tagu nepatří:

• doprava zdarma (uvádějte pouze v tagu DELIVERY),
• informace o dostupnosti (uvádějte v dostupnostním feedu, nebo DELIVERY_DATE),
• označení autorizovaného prodejce,
• možnost splátkového prodeje,
• osobní odběr na pobočkách,
• sleva na další nákup,
• prodloužená záruka,
• 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 e-shopu. 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 třemi tečkami.

Podmínky zasílání voucherů na slevu ve feedu:

• Voucher musí být využitelná libovolným zákazníkem.
• 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…“).