Špecifikácia XML súboru

Ide o povinný tag, bez ktorého sa položky na Heureke nezobrazia.
Jedinečné označenie produktu v rámci e-shopu. Musí zostať unikátny navždy, vďaka čomu budeme schopní jednoznačne identifikovať produkt pre službu Overené zákazníkmi či Dostupnostný XML súbor, aj keď sa zmení URL.

Kombinácia maximálne 36 znakov [ _ - 0-9 a-z A-Z ], t. j. podčiarkovníkov, pomlčiek, číslic 0-9 a veľkých a malých písmen bez diakritiky. Tag sa zatiaľ na párovanie položiek nepoužíva.

V tagu PRODUCTNAME by mal byť uvedený základný názov produktu, ktorý obsahuje všetky povinné informácie podľa vybranej kategórie. Maximálna dĺžka textu v tomto tagu je obmedzená na 200 znakov.

PRODUCTNAME by nemal obsahovať žiadne doplnkové informácie ako napr. darček, puzdro či nabíjačka zadarmo a pod.

Vo všeobecnosti platí, že názov nesmie byť všeobecný. Pokiaľ teda v názve produktu uvediete výrobcu, sériu a číslo produktu, mal by byť produkt zaradený správne. Ak ide o varianty produktov, ktoré sa líšia farbou, rozmermi, príchuťou, množstvom a ďalšími atribútmi, musíte v názve produktu rozlišovať všetky tieto parametre.

Príklady správnych názvov produktov nájdete tu.

Popis produktu, snažte sa uvádzať čo najrelevantnejší popis, vo fulltextovom vyhľadávaní sa berie do úvahy. Mal by obsahovať popis a špecifikáciu výrobku bez reklamy na dopravu zadarmo, akcie a daný obchod. Nie je povolená nadmerná interpunkcia. Počet znakov v tagu DESCRIPTION nie je obmedzený, avšak vo fulltexte zobrazujeme iba 200 znakov.

Pre aktiváciu Heureka Marketplace je potrebné zaslať nám celý popis v tomto tagu, nie len jeho skrátenú verziu (rovnaký text ako v detaile produktu v e-shope).

Odkaz na stránku s ponukou daného výrobku v obchode. Na tejto stránke musí byť uvedená cena produktu v € a možnosť vložiť do košíka.
URL adresa musí byť pre každý produkt jedinečná. Ak máte viacero variantov produktu, uistite sa, že adresa URL je jedinečná pre každý variant.
Ak máte varianty produktov na svojom e-shope na jednej stránke, potom je jediným riešením používať tzv. hashtagy.

Funguje to tak, že do XML feedu rozdelíte každý variant produktu zvlášť so svojim vlastným PRODUCTNAME (v ktorom je aj produktový kód) a ako URL použijete napr. 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

Prehliadače potom odkážu iba na text pred znakom #, teda u oboch na zhodnú adresu http://www.test.cz/product/tastickova-matrace-argon-latex-9-zon, ale pre náš systém bude braná do úvahy adresa celá aj s textom za znakom #; URL teda pre nás bude unikátny.
URL adresa nesmie byť dlhšia ako 300 znakov.

Túto úpravu odporúčame riešiť s vašim webmasterom.

Odkaz na hlavný/primárny obrázok produktu.

Podmienky pre obrázky:

• Adresa obrázku nesmie obsahovať medzery či diakritiku.
• Maximálna dĺžka URL adresy obrázka je 255 znakov.
• Pokiaľ máte pre viac produktov jeden obrázok, použite vždy jednu a tú istú adresu (adresa nemusí byť jedinečná v rámci feedu).
• Okrem toho by obrázok nemal mať priehľadné pozadie.
• Pri zmene obrázka na stránkach obchodu je potrebné zmeniť tiež URL adresu obrázka v XML súbore.

Špecifikácia:

• Minimálna potrebná veľkosť obrázka je 20 x 50 alebo 50 x 20 pixelov (odporúčame ale aspoň 175 x 175 pixelov) a 30 kB
• Maximálna veľkosť obrázkov je 4 096 x 4 096 pixelov a 2 000 kB
• Maximálna dĺžka URL adresy obrázka je 255 znakov
• Aktuálne podporujeme iba formát jpeg

Posielajte nám len obrázky (najlepšie *jpeg) produktov. Obrázky typu https://www.srovnanicen.cz/static/css/image/bez-obrazku.gif do feedu nedávajte! Zaistite, aby na jednej url nedochádzalo k rotácii obrázkov (na jednej adrese sa musí vždy nachádzať ten istý obrázok), pretože náš systém si môže stiahnuť z vašich stránok obrázok kedykoľvek. Vám by sa potom mohli zobrazovať nesprávne (alebo tiež žiadne) obrázky pri produktoch vo fulltexte.
Obrázky musia byť univerzálne a všeobecné, nesmú teda obsahovať vodoznak, zobrazenie zľavy, či bonusu ani upozornenia na niektorú z predností produktu vrátane ocenení. V opačnom prípade budú zablokované.

Ak je váš obchod zapojený do modelu Heureka Marketplace a posiela obrázky s vodoznakom, vaše ponuky sa nezobrazia na najvyššej TOP pozícii, aj keď sú najvýhodnejšie (zobrazia sa len v porovnaní cien).

Cena môže byť uvedená v týchto formátoch:

• 25 000
• 25000
• 25000,50
• 25000.50

Nepoužívajte ako oddeľovač tisícov/miliónov bodku ('.'), tá je použitá na oddelenie desatinných miest. Cenu vyplňte maximálne na 2 desatinné miesta.

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.

Ak je váš obchod zapojený do Heureka Marketplace je nutné nám v tomto tagu posielať ceny tovaru už zaokrúhlené na celé eurá. Ak posielate s produktom aj voucher na zľavu (viď tag SALES_VOUCHER) musí cena v tagu PRICE_VAT zodpovedať cene po aplikácii tohto voucheru.

Cena musí byť uvedená za výrobok a nemôžete uviesť cenu za množstevnú zľavu. Množstevné zľavy nie sú na Heureke podporované.
Ak sa teda cena mení z dvoch položiek, neuvádzajte ju na Heureke.

Ak sa vaša cena v porovnaní neaktualizuje, častou chybou je, že ešte nebola vygenerovaná vo feede a nemáme informáciu o zmene.

Vždy odporúčame skontrolovať, či je cena už aktualizovaná v XML súbore a či bol feed medzičasom importovaný z našej strany.

DPH

Tag <VAT> ich dopĺňajú hlavne pre EET, stále môžete posielať <PRICE_VAT> a <VAT>

    
<?xml version="1.0" encoding="utf-8"?>
<VAT>21%</VAT>    

Parameter VAT je povinný pre obchody predávajúci tovar s rozdielnou (zníženou) sadzbou DPH v Heureka Košíku. Viac info nájdete tu.

• použité alebo repasované;
• s poškodeným, neoriginálnym či bulk balením White box, OEM, blist, atd.);
• vrátené v 14 dennej lehote;
• bez plnohodnotnej záručnej lehoty;
• druhej akosti;
• výstavné či predvádzacie kusy;
• rozbalené;
• tovar v osobitnom režime DPH;
• a ďalšie, ktoré Heureka nepovažuje za nové.

<ITEM_TYPE>bazar</ITEM_TYPE>

Tieto produkty nesmú byť označené ako nové, ale buď ako bazárové alebo ich do XML súboru pre Heureku vôbec neuvádzajte.

Ako správne zadať parametre do XML súboru

Zoznam parametrov (XLSX/CSV)

Parametre produktu sú uvedené tu. Ak parametre nie sú vyplnené, nie je možné zobraziť vaše produkty v konkrétnom filtrovaní.

Zaradenie produktu do kategórie, uvádzajte vždy celú cestu k produktu, ideálne podľa nášho stromu kategórií. Využívať môžete samozrejme aj svoje kategórie, len sa uistite, že zodpovedajú štruktúre kategorizácie Heureky.

Správne uvedená kategorizačná cesta:

Zle uvedená kategorizačná cesta:

EAN kód sa používa na označenie jednotlivých druhov tovaru. Podporujeme formát EAN 13. Iné formáty nebudeme spracovávať, a preto bude kód EAN považovaný za chybný.

Neuvádzajte však interné čísla produktov, ale oficiálne kódy tovarov! (Viac informácií o kóde EAN)

EAN kód je povinnou položkou pre kategórie Knihy, Učebnice, Mapy a sprievodcovia, Filmy, Hudba a Komiksy.

Ak predávate iný tovar, potom EAN kód nie je povinný, a preto ho nie je potrebné zasielať.

Dodacia doba produktu v dňoch, tzn. doba od prijatia platby (v prípade dobierky od prijatia objednávky) do expedície tovaru. Číselná hodnota je potom našim systémom automaticky prevedená na textové vyjadrenie.

• skladom - 0
• do 3 dní - 1-3
• do týždňa - 4-7
• do 2 týždňov - 8-14
• do mesiaca - 15-30
• viac ako mesiac - 31 a viac
• info v obchode - pokiaľ dodaciu dobu neuvádzate

Neuvádzajte hodnotu s pomlčkou, ale iba jednu vybranú číslicu.
Napríklad: 2

Pozn.: Detailné a aktuálne informácie o dostupnosti tovaru je možné poskytovať tiež prostredníctvom samostatného XML feedu (viac o dostupnostnom XML), ktorý je aktualizovaný každých 10 minút.

• Tovar skladom je možné uviesť ako:
  

  <DELIVERY_DATE>0</DELIVERY_DATE>

• Dodacia doba uvádzaná v dňoch (iba celočíselná hodnota):
  

  <DELIVERY_DATE>4</DELIVERY_DATE>

• Dodacia doba uvedená dátumom - od tohto dátumu bude produkt dostupný:
  

  <DELIVERY_DATE>2013-08-15</DELIVERY_DATE>

Každú dopravu je možné pri produkte uvádzať iba raz. Ak uvediete dvoch dopravcov pri jednom produkte, spôsobíte chybu a nezobrazí sa ani jedna doprava. Maximálny počet dopráv vo feede je 100 rôznych.

Ak zvolíte dopravu cez feed, doprava uvedená v administrácii pod „ceny dopravy“ bude úplne ignorovaná, pretože tag DELIVERY má prednosť.

Obsahuje tagy:

• DELIVERY_ID - reťazec identifikujúci dopravcu. Je možné vybrať z nami určených dopravcov, nie je možné uvádzať iné, než dávame na výber.
• DELIVERY_PRICE - celková cena (vr. DPH) konkrétneho spôsobu dodania pre tento produkt pri platbe vopred.
• DELIVERY_PRICE_COD - celková cena (vr. DPH) konkrétneho spôsobu dodania pre tento produkt vrátane dobierkového. Pokiaľ je cena dopravy s dobierkou rovnaká ako bežná cena, tak cenu v tomto tagu zopakujte. Ak nie je možné tovar doručiť týmto dopravcom na dobierku, tag neuvádzajte.

Pozn: pokiaľ od daných dopravcov využívate viac služieb, uvádzajte cenu najlacnejšiu z nich, musí však platiť, že touto službou je možné dodanie po celej SR až domov (nie na výdajné miesto).

Tu sú uvedení podporovaní dopravcovia v následujúcom znení:

Doručenie na adresu

Slovenská pošta - Balík na adresu

<DELIVERY_ID>SLOVENSKA_POSTA</DELIVERY_ID>

DPD

<DELIVERY_ID>DPD</DELIVERY_ID>

DHL

<DELIVERY_ID>DHL</DELIVERY_ID>

DSV

<DELIVERY_ID>DSV</DELIVERY_ID>

Expres Kuriér

<DELIVERY_ID>EXPRES_KURIER</DELIVERY_ID>

Gebrüder Weiss

<DELIVERY_ID>GEBRUDER_WEISS</DELIVERY_ID>

Geis

<DELIVERY_ID>GEIS</DELIVERY_ID>

GLS

<DELIVERY_ID>GLS</DELIVERY_ID>

Express One

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

SDS

<DELIVERY_ID>SDS</DELIVERY_ID>

SPS

<DELIVERY_ID>SPS</DELIVERY_ID>

Packeta domov

<DELIVERY_ID>PACKETA_DOMOV</DELIVERY_ID>

PaletExpress

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

DEPO

<DELIVERY_ID>DEPO</DELIVERY_ID>

DACHSER

<DELIVERY_ID>DACHSER</DELIVERY_ID>

QDL

<DELIVERY_ID>QDL</DELIVERY_ID>

FOFR

<DELIVERY_ID>FOFR</DELIVERY_ID>

GO4

<DELIVERY_ID>GO4</DELIVERY_ID>

Výdajné miesta

Slovenská pošta - Balík na poštu

<DELIVERY_ID>SLOVENSKA_POSTA_NAPOSTU_DEPOTAPI</DELIVERY_ID>

Packeta

<DELIVERY_ID>PACKETA</DELIVERY_ID>

DPD Pickup

<DELIVERY_ID>DPD_PICKUP</DELIVERY_ID>

WE|DO POINT

<DELIVERY_ID>WEDO_POINT</DELIVERY_ID>

Balíkovo

<DELIVERY_ID>BALIKOVO</DELIVERY_ID>

GLS ParcelShop

<DELIVERY_ID>GLS_PARCELSHOP</DELIVERY_ID>

DEPO

<DELIVERY_ID>DEPO</DELIVERY_ID>

AlzaPoint

<DELIVERY_ID>ALZAPOINT</DELIVERY_ID>

Pošta Point

<DELIVERY_ID>POSTA_POINT</DELIVERY_ID>

GLS Depo

<DELIVERY_ID>GLS_DEPO</DELIVERY_ID>

Výdajné 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>

BalíkoBOX

<DELIVERY_ID>BALIKOBOX</DELIVERY_ID>

GLS Balikomat

<DELIVERY_ID>GLS_BALIKOMAT</DELIVERY_ID>

AlzaBox

<DELIVERY_ID>ALZABOX</DELIVERY_ID>

Balíkovo Box

<DELIVERY_ID>BALIKOVO_BOX</DELIVERY_ID>

Ostatné možnosti doručenia

Online doručenie

<DELIVERY_ID>ONLINE</DELIVERY_ID>

Vlastná preprava

<DELIVERY_ID>VLASTNA_PREPRAVA</DELIVERY_ID>

Pozn: ak ponúkate vlastnú prepravu tovaru, aj v tomto prípade musí vaša preprava spĺňať podmienky, že ju ponúkate v celej krajine. Ide o vašu prepravu k zákazníkovi. Nejde o osobný odber, mestskú/obecnú prepravu atď.

Obsahuje ITEM_ID položky, ktorá je príslušenstvom k tomuto produktu, napr. nabíjačka, puzdro a pod. Možno uviesť viackrát.

Umožňuje vášmu e-shopu predávať príslušenstvo k tovaru, ktorý má zákazník v košíku. Tieto doplnky si sami zvolíte, či už ide o nabíjačky, puzdrá alebo čokoľvek relevantné.

Ku každému produktu je možné priradiť až 10 tagov, obsahujúcich ITEM_ID položky. Zákazníkovi sa potom pred zakúpením zobrazuje maximálne 10 konkrétnych produktov.

<?xml version="1.0" encoding="utf-8"?>
<SHOP>
<SHOPITEM>
  ...
  <GIFT>Púzdro zadarmo</GIFT>
  <GIFT ID="gift01">Pamäťová karta zadarmo</GIFT>
  </SHOPITEM>
</SHOP>

Darček je potrebné uvádzať iba ku konkrétnemu produktu, u ktorého zákazník darček skutočne získa. Darček nesmie byť ďalej ničím obmedzený (vyššou čiastkou objednávky, nákupom ďalšieho produkt atď.). Možno uvádzať viackrát v prípade, že všetky darčeky sú dodávané k jednému produktu. V prípade možnosti výberu medzi darčekmi, je uvedený iba jeden darček.

Ak uvádzate viac darčekov, nie je možné si určiť ich pozíciu na produktovej karte. Ak sa rozhodnete k jednému produktu zasielať viac darčekov, je potrebné v zásielke odoslať všetky uvedené darčeky (nie je možné si vybrať, aký darček pošlete).

Darčekom je myslený predmet či voucher na danú vec, nie zľava či služba. Povolené je taktiež používanie cashbacku, avšak musí byť uvedený iba pri produkte, ku ktorému je skutočne ponúkaný a musí byť uvedená konkrétna čiastka, či tovar, ktorý je predmetom cashbacku.

V prípade, že je cashback od konkrétnej značky a je ponúkaný všetkým užívateľom, informácia je zo strany Heureky uvedená v popise produktu a nie je povolené ju uvádzať do tagu GIFT. Ak sa jedná o cashback od značky pre vybrané obchody, musí byť uvedený ako: „cashback XXX pri registrácii na stránkach XXX“.

Tento tag obsahuje informáciu o predĺženej záruke produktu. Ak teda chcete na Heureke predĺženú záruku zobraziť, je vyplnenie tohto popisku povinné. Môžete tiež uviesť dobu predĺženia záruky, ktorá sa uvádza v mesiacoch. Maximálna dĺžka popisku je 128 znakov.

Ak uvediete vo VAL väčšiu hodnotu ako 999, bude Heureka zobrazovať doživotnú záruku .

<?xml version="1.0" encoding="utf-8"?>
<EXTENDED_WARRANTY>
    <VAL>36</VAL>
    <DESC>Záruka 36 mesiacov</DESC>
</EXTENDED_WARRANTY>

Tag Special Service obsahuje informáciu o doplnkovej službe poskytnutej k nákupu produktu. Množstvo ponúkaných služieb je obmedzené na maximálny počet 5, čo sa rovná aj maximálnemu množstvu výskytu tohto tagu pri jednom produkte. V prípade prekročenia maximálneho počtu 5 služieb nebude tento tag vôbec zpracovaný a pri produkte sa nezobrazí žiadna doplnková služba. Maximálna dĺžka popisku je 128 znakov.

<?xml version="1.0" encoding="utf-8"?>
<SPECIAL_SERVICE>Inštalácia spotrebiča zadarmo</SPECIAL_SERVICE>
<SPECIAL_SERVICE>Montáž spotrebiča zadarmo</SPECIAL_SERVICE>
<SPECIAL_SERVICE>Odvoz obalového materiálu</SPECIAL_SERVICE>
<SPECIAL_SERVICE>Výnos na poschodie</SPECIAL_SERVICE>

Príklady doplnkových/špeciálnych služieb:

• servis zdarma,
• vynesenie na poschodie,
• predĺžená doba vrátenia tovaru,
• a ďalšie.

Čo do tohoto tagu nepatrí:

• doprava zadarmo (uvádzajte iba v tagu <DELIVERY>),
• informácie o dostupnosti (uvádzajte v dostupnom feede, alebo <DELIVERY_DATE>),
• označenie autorizovaného predajcu,
• možnosť splátkového predaja,
• osobný odber na pobočkách,
• zľava na ďalší nákup,
• predĺžená záruka,
• a ďalšie formy vyjadrenej zľavy (okamžitá zľava, akčná cena, bonus...).

Voucher na zľavu k produktu. Pomocou tohto tagu môžete poskytnúť používateľom kód na zľavu, ktorý môžu uplatniť vo vašom e-shope. Voucher sa týka vždy produktu, u ktorého je uvedený. Pokiaľ poskytujete plošnú zľavu na všetky produkty, môže byť rovnaký voucher uvedený pri všetkých produktoch obchodu.

Upozornenie: Pokiaľ chcete zaslanie vouchera na zľavu využiť, musí cena v tagu PRICE_VAT zodpovedať cene po aplikácii tohto vouchera.

<?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 zľavy, ktorú používateľ zadá vo vašom e-shope. Maximálna dĺžka je 24 znakov.

DESC obsahuje popis zľavy, bude zobrazený pri kóde. V prípade, že je platnosť voucheru časovo obmedzená, odporúčame tu platnosť uviesť. Maximálna dĺžka je 128 znakov. Prebytočné znaky budú orezané a doplnené tromi bodkami.

Podmienky zasielania voucherov na zľavu vo feede:

• Voucher musí byť využiteľný ktorýmkoľvek zákazníkom.
• Jeho použitie nesmie byť podmienené napríklad nákupom viacerých kusov alebo druhov produktov, registráciou do obchodu, členstvom vo vernostnom klube, a pod.
• Pokiaľ je platnosť voucheru časovo obmedzená, po vypršaní platnosti nesmie byť voucher naďalej vo feede. Koniec platnosti voucheru odporúčame uviesť v popise DESC.
• Cena produktu zaslaná v tagu PRICE_VAT musí zodpovedať cene po aplikácii tohto voucheru.
• Po prekliku z Heureky je cena produktu na webe vášho obchodu viditeľne zobrazená pred zľavou a po zľave (napr. "cena s kódom ...").