Informácie o užívateľovi

Odhlásiť sa
Administrácia e-shopu
  • Nastavenia
    • Pridať obchod
  • Nápoveda a aktuality
    • Príručka Heureky pre eshopy
    • Dôležité dokumenty
    • Podporované Shop systémy

Špecifikácia XML súboru

  • Význam jednotlivých elementov
  • Požiadavky na kvalitný XML súbor
  • Ukážka základnej podoby XML súboru
  • Spracovanie XML súboru
  • Najčastejšie chyby

Ukážka základnej podoby XML súboru:

Aby bolo možné importovať produkty do našich vyhľadávačov, je potrebné mať vytvorený tzv. XML súbor (alebo XML FEED), čo je jednoduchý dátový formát, pomocou ktorého nám poskytnete informácie o vašich produktoch a ich cenách.

XML súbor je automaticky generovaný z vašich stránok, a preto jeho vytvorenie či úpravy konzultujte so svojim webmasterom.

Heureka XML feedy nevytvára ani neupravuje. Preto je potrebné sa ohľadom prípadných chýb obrátiť priamo na svojho programátora alebo hostingovú agentúru. Za vytvorenie a následnú úpravu XML súboru zodpovedá práve obchod.

Export dát je základom úspechu vášho zobrazovania na Heureke, preto ho odporúčame pripraviť podľa nižšie uvedených špecifikácií pre jednotlivé položky. Maximálny počet predajných položiek v XML súbore je 500 000 a je možné nám odovzdať len jednu URL adresu základného XML súboru. Nie je možné rozdeliť feed do dvoch feedov a zvýšiť tak počet položiek.

Význam jednotlivých značiek

SHOP | SHOPITEM | ITEM_ID | PRODUCTNAME | PRODUCT | DESCRIPTION | URL | IMGURL | IMGURL_ALTERNATIVE | PRICE_VAT | VAT | ITEM_TYPE | PARAM | MANUFACTURER | MANUFACTURER_POSTAL_ADDRESS | MANUFACTURER_ELECTRONIC_ADDRESS | CATEGORYTEXT | EAN | ISBN | HEUREKA_CPC | DELIVERY_DATE | DELIVERY | ITEMGROUP_ID | ACCESSORY | GIFT | EXTENDED_WARRANTY | SPECIAL_SERVICE | SALES_VOUCHER

Požiadavky na kvalitný XML súbor

XML súbor obsahuje dôležité tagy:

  • PRODUCTNAME - názov obsahuje výrobcu, produktové číslo či kód
  • ITEM_ID - jednoznačná a trvalá identifikácia produktu
  • PRICE_VAT - cena produktu - povinné
  • URL - jedinečná adresa, ktorá odkazuje na produkt - povinné
  • CATEGORYTEXT - celá cesta k produktu
  • DELIVERY - cena dopravy k jednotlivým produktom
  • DELIVERY_DATE - správne uvádzanie dostupnosti produktov
  • IMGURL - obrázok produktu
  • ITEMGROUP_ID - varianty veľkostí, farieb, vzorov atď. sú jednotlivé produkty, ktoré je možné združovať
<?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žívateľským rozhraním</DESCRIPTION>
    <URL>http://obchod.sk/mobily/nokia-5800-xpressmusic</URL>
    <IMGURL>http://obchod.sk/mobily/nokia-5800-xpressmusic/obrazok.jpg</IMGURL>
    <IMGURL_ALTERNATIVE>http://obchod.sk/mobily/nokia-5800-xpressmusic/obrazok2.jpg</IMGURL_ALTERNATIVE>
    <PRICE_VAT>240</PRICE_VAT>
    <HEUREKA_CPC>0,24</HEUREKA_CPC>
    <MANUFACTURER>NOKIA</MANUFACTURER>
    <MANUFACTURER_POSTAL_ADDRESS>Pučálkovic 234, 09293 Zlobice</MANUFACTURER_POSTAL_ADDRESS>
    <MANUFACTURER_ELECTRONIC_ADDRESS>[email protected]</MANUFACTURER_ELECTRONIC_ADDRESS>
    <CATEGORYTEXT>Elektronika | Mobilné telefóny</CATEGORYTEXT>
    <EAN>6417182041488</EAN>
    <PARAM>
      <PARAM_NAME>Farba</PARAM_NAME>
      <VAL>čierna</VAL>
    </PARAM>
    <DELIVERY_DATE>2</DELIVERY_DATE>
    <DELIVERY>
      <DELIVERY_ID>SLOVENSKA_POSTA</DELIVERY_ID>
      <DELIVERY_PRICE>3</DELIVERY_PRICE>
      <DELIVERY_PRICE_COD>5</DELIVERY_PRICE_COD>
    </DELIVERY>
    <DELIVERY>
      <DELIVERY_ID>PPL</DELIVERY_ID>
      <DELIVERY_PRICE>3</DELIVERY_PRICE>
      <DELIVERY_PRICE_COD>5</DELIVERY_PRICE_COD>
    </DELIVERY>
    <ITEMGROUP_ID>EF789</ITEMGROUP_ID>
    <ACCESSORY>CD456</ACCESSORY>
    <GIFT>Púzdro zadarmo</GIFT>
    <EXTENDED_WARRANTY>
        <VAL>36</VAL>
        <DESC>Záruka na 36 mesiacov</DESC>
    </EXTENDED_WARRANTY>
    <SPECIAL_SERVICE>Aplikácia ochrannej fólie</SPECIAL_SERVICE>
  </SHOPITEM>
  <SHOPITEM>
  ...
  </SHOPITEM>
</SHOP>

Varovanie:

Kódovanie znakov UTF-8
Pracujeme s kódovaním znakov UTF-8. Pri použití iného druhu kódovania môže byť problém so správnym zobrazením dát.

Export neobsahuje položky, ktoré sú nepredajné, nedostupné alebo vypredané. Keď zmeníte URL adresy svojich produktov, názvy produktov alebo kategórií v XML, Heureka zruší spárovanie všetkých produktov a potom čaká na ich opätovné spárovanie, čo môže trvať približne 4 pracovné dni. Je preto potrebné zachovať rovnaké adresy URL v súbore XML.

Varianty produktov
Pokiaľ predávate produkty napr. oblečenie, matrace, bicykle, kolieskové korčule, kočíky, satelitné komplety atď., kde produkty majú pod unikátnym EAN variantu odlišujúcu sa farbou, vzorom, materiálom, rozmermi, komponentmi, veľkosťou atď., venujte veľkú pozornosť časti Varianty, tag ITEMGROUP_ID.

Dostupnostný XML
Detailné a aktuálne informácie o dostupnosti tovaru je možné poskytovať taktiež prostredníctvom samostatného XML feedu (viac o dostupnostnom XML)

Spracovanie XML súboru

V prípade režimu PPC sťahujeme váš súbor XML každé dve hodiny, aby sme zabezpečili vždy aktuálne ceny. V prípade režimu FREE sa súbor XML sťahuje každé štyri hodiny. Z vašej strany musíte zabezpečiť, aby bol súbor vždy aktuálny, aby boli údaje čo najrelevantnejšie.

Kompresia súboru XML
Základný XML súbor prijímame aj vo formáte GZip. Možno teda použiť GZip kompresiu HTTP prenosu tohto súboru. Stačí mať váš HTTP server nakonfigurovaný tak, aby túto kompresiu podporoval, čo je väčšinou štandardné chovanie. Ku komprimácii potom dôjde transparentne na strane HTTP servera a dekomprimácii potom opäť transparentne na strane nášho HTTP servera. Dôjde tak k úspore objemu prenesených dát, avšak i tak prijímame XML súbor s maximálne 500 000 položkami k predaji v režime PPC i režime FREE.

Aktualizácia XML hlavičky
Pred samotným stiahnutím XML súboru kontrolujeme dátum poslednej modifikácie prostredníctvom HTTP hlavičky "Last-Modified". Odporúčame teda nakonfigurovať HTTP server tak, aby túto informáciu v hlavičke odpovede odosielal. Predíde sa tak zbytočnej záťaži serverov na oboch stranách, spôsobené sťahovaním nezmenených XML súborov.


Popis jednotlivých elementov:

SHOP
Koreňový element, v súbore je obsiahnutý len raz.
SHOPITEM
Element obsahuje informácie o konkrétnom produkte, v súbore je uvedený toľkokrát, koľko máte produktov. V prípade, že predávate tričko v piatich veľkostiach (S, M, L, XL, XXL) a desiatich farbách (biele, žlté, oranžové, modré, fialové, zelené, hnedé, béžové, sivé a čierne) je nutné do XML uviesť 50 SHOPITEM.
Dôkladné rozdelenie variant umožňuje správné vyplnenie parametrov a následné filtrovanie produktov.
ITEM_ID

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.

PRODUCTNAME

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.

PRODUCT
Tag PRODUCT obsahuje PRODUCTNAME (presný názov produktu) + možnú doplňujúcu informáciu o distribúcii produktu alebo možnosti osobného odberu, napr. „Whirlpool WBA 43983 NFC IX – osobný odber v Prahe“.
DESCRIPTION

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

URL

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.

IMGURL

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

IMGURL_ALTERNATIVE
Odkaz na ďalší obrázok výrobku, napríklad pohľad z iného uhlu, prehľad celého balenia, a pod. Môžete uviesť viackrát.
PRICE_VAT
Koncová cena produktu s DPH, v cene musia byť uvedené autorské a recyklačné poplatky.
Uvádzanie ceny v €.
Ceny na serveri Heureka.sk uvádzame konečné.

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.

VAT
DPH, daň sa líši podľa kategórie tovaru.

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.

ITEM_TYPE
Na rozlíšenie nových položiek. Týmto tagom označujeme produkty typu:
  • 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.

PARAM

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

MANUFACTURER
Tag MANUFACTURER obsahuje názov výrobcu výrobku, využíva sa na zaradenie pod filtrovací parameter, nie na párovanie položiek. Výrobca preto musí byť uvedený aj v tagu PRODUCTNAME.
MANUFACTURER_POSTAL_ADDRESS
Tag MANUFACTURER_POSTAL_ADDRESS obsahuje poštovú adresu výrobcu, na ktorú sa zákazníci môžu obrátiť.
MANUFACTURER_ELECTRONIC_ADDRESS
Tag MANUFACTURER_ELECTRONIC_ADDRESS uvádza elektronický kontakt na výrobcu – môže to byť e-mail alebo webová stránka s kontaktným formulárom.
CATEGORYTEXT

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:

Heureka.sk | Veľké spotrebiče | Práčky a sušičky | Práčky

Zle uvedená kategorizačná cesta:

Veľké spotrebiče | Práčky a sušičky
EAN

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

ISBN
Alfanumerický kód určený pre jednoznačnú identifikáciu knižných vydaní.. Podporujeme formáty ISBN-10 a ISBN-13. Čísla v ISBN kóde sa oddeľujú pomlčkou, napríklad "978-0-123456-47-2". (viac o ISBN kóde)
HEUREKA_CPC
Tagom nastavujete maximálnu cenu, ktorú ste ochotní za prekliknutie ponúknuť. Desatinné miesta oddeľujte desatinnou čiarkou. Maximálna cena za preklik je 50,00 €. Pokiaľ nechcete biddovať, tag vôbec neuvádzajte. Nepíšte prosím číslo 0.
DELIVERY_DATE

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.

Dostupnosť sa potom na Heureka.sk zobrazuje ako:
  • 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.

Príklady:
  • 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>
Pozn.: toto označenie sa využíva pre prípady, kedy je produkt predajný až od určitého dátumu, ale je možné urobiť predobjednávky. V prípade, že sú produkty dlhodobo nedostupné a nie je známa ani približná doba dodania, potom nesmú byť v XML súbore uvedené.
Hodnota DELIVERY_DATE Zobrazenie na Heureke Prípustná interpretácia v eshope
hodnota 0 Skladom
  • skladom
  • skladom u dodávateľa, expedícia do 24 hodín
  • skladom v expedičnom sklade, expedícia do 24 hodín
  • skladom na predajni
  • ihneď (k odberu)
  • expedícia do 24 hodín
    Pozn. počet kusov v eshope musí byť > 0
hodnoty 1-3 Do 3 dní
  • skladom, dodanie do 5 pracovných dní
  • obvykle skladom (expedícia do 3 dní)
  • skladom u dodávateľa (expedícia do 3 dní)
hodnoty 4-7 Do týždňa
  • skladom, dodanie do 7 pracovných dní
  • obvykle skladom (expedícia do 7 dní)
  • skladom u dodávateľa (expedícia do 7 dní)
hodnota 8-14 Do 2 týždňov
  • 8 a viac dní
  • obvykle skladom (expedícia do 14 dní)
  • skladom u dodávateľa (expedícia do 14 dní)
hodnota 15-30 Do mesiaca
  • na otázku (expedícia do 30 dní)
  • na objednávku (expedícia do 30 dní)
hodnota 31 a viac Viac ako mesiac
  • na otázku
  • na objednávku
prázdna hodnota Info v obchode
  • neuvedená dostupnosť
  • neznáma
  • vypredané
DELIVERY
Spôsob a cena dopravy, ktoré je možné využiť na dodanie tohto produktu. Opakuje sa toľkokrát, koľko spôsobov dopravy je možné pre tento produkt využiť.

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>

DB SCHENKER

<DELIVERY_ID>DB_SCHENKER</DELIVERY_ID>

EMONS

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

PPL Parcelshop

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

PPL Parcelbox

<DELIVERY_ID>PPL_PARCELBOX</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ď.

ITEMGROUP_ID
Označenie skupiny produktov, ktoré vzájomne predstavujú varianty. Kombinácia maximálne 36 znakov [ _ - 0-9 a-z A-Z ] teda podčiarknutia, pomlčky, čísel nula až deväť a malých a veľkých písmen bez diakritiky. Tag sa zatiaľ pre zaraďovanie položiek nevyužíva.

Varianty v XML Feede 2.0

Variantou odlišujte rôzne veľkosti, farby, vzory, sady a druhy produktov. Rovnakú skupinu potom vo feede označíte v tagu ITEMGROUP_ID.

Prí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 kolekcie Originals uvádza adidas športovú obuv The Superstar, ktorá je už od svojho vzniku jedničkou medzi obuvou. Jej poznávacím znamením je mimo iných detailov designové zakončenie špičky. Vďaka kvalitnému materiálu a trendy vzhľadu, podčiarknutého logami Adidas vo vnútri topánky aj na nej, bude hviezdou vášho botníku.</DESCRIPTION>
    <URL>http://www.obchod-s-obuvou.sk/topanky/adidas-superstar-2-w7/eur-36/</URL>
    <IMGURL>http://www.obchod-s-obuvou.sk/pictures/403078.jpg</IMGURL>
    <IMGURL_ALTERNATIVE>http://www.obchod-s-obuvi.sk/pictures/403080.jpg</IMGURL_ALTERNATIVE>
    <MANUFACTURER>Adidas</MANUFACTURER>
    <CATEGORYTEXT>Obuv | Dámská obuv</CATEGORYTEXT>
    <EAN>5051571703857</EAN>
    <PRODUCTNO>G43755</PRODUCTNO>
    <PARAM>
      <PARAM_NAME>Veľkosť</PARAM_NAME>
      <VAL>EUR 36</VAL>
    </PARAM>
    <DELIVERY_DATE>2</DELIVERY_DATE>
    <DELIVERY>
      <DELIVERY_ID>SLOVENSKA_POSTA</DELIVERY_ID>
      <DELIVERY_PRICE>5</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 kolekcie Originals uvádza adidas športová obuv The Superstar, ktorá je už od svojho vzniku jedničkou medzi obuvou. Jej poznávacím znamením je mimo iných detailov designové zakončenie špičky. Vďaka kvalitnému materiálu a trendy vzhľadu, podčiarknutého logami Adidas vo vnútri topánky aj na nej, bude hviezdou vášho botníku.</DESCRIPTION>
    <URL>http://www.obchod-s-obuvou.sk/topanky/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>Velikosť</PARAM_NAME>
      <VAL>EUR 37</VAL>
    </PARAM>
    <DELIVERY_DATE>2</DELIVERY_DATE>
    <DELIVERY>
      <DELIVERY_ID>SLOVENSKA_POSTA</DELIVERY_ID>
      <DELIVERY_PRICE>5</DELIVERY_PRICE>
    </DELIVERY>
    <ITEMGROUP_ID>ZD563</ITEMGROUP_ID>
  </SHOPITEM>
  <SHOPITEM>
  ...
  </SHOPITEM>
</SHOP>
ACCESSORY

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.

GIFT
Obsahuje textový popis darčekov, alebo položiek, ktoré sú k produktu zdarma. Limit pre dĺžku názvu jedného darčeku je 250 znakov. Je možné uviesť viackrát. Voliteľne môže obsahovať atribút ID pre jednoznačnú identifikáciu darčekov (odporúčame používať). Tento atribút má zhodný formát ako ITEM_ID. Kombinácie maximálne 36 znakov [ _ - 0-9 a-z A-Z ] teda podčiarknutia, pomlčky, čísla 0-9 a veľké a malé písmená bez diakritiky.
<?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“.

EXTENDED_WARRANTY

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

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

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

Vytvorenie XML súboru pomocou CDATA

Tento zápis využijete v prípade textov, kde sa vyskytuje príliš veľa nepovolených znakov (např. &, <, >)

<MANUFACTURER><![CDATA[Black & Decker]]></MANUFACTURER>

Najčastejšie chyby

1) Nenahradenie niektorých znakov (napr. "&", "<", ">") entitami

<MANUFACTURER>Black & Decker</MANUFACTURER>

Možné riešenie:

<MANUFACTURER>Black &amp; Decker</MANUFACTURER>
<MANUFACTURER><![CDATA[Black & Decker]]></MANUFACTURER>

Viac o entitách v článku na serveri Interval.cz DTD: entity a notácie.

2) Neuzavretý element

<PRODUCT>Clinique Happy EdP 30ml
<DESCRIPTION>Tenučký slide-up s bohatou multimediálnou výbavou</DESCRIPTION>
<URL>http://obchod.sk/parfumy/clinique-happy-edp</URL>

3) Chybný formát url

<IMGURL>/parfumy/clinique-happy-edp/obrazok.jpg</IMGURL>
<IMGURL>nie je</IMGURL>
<URL>http://obchod.sk/nočný krém</URL>

4) Tagy malými písmenami

Máte v xml súbore vyplnené napríklad parametre produktu, či dopravu, ale nezobrazujú sa vám na Heureke? Skontrolujte si, či neuvádzate tagy malými písmenami. Takéto tagy Heureka nespracuje. Tagy je vždy potrebné uvádzať veľkým písmom.

<param>
    <param_name>farba</param_name>
    <val>červená</val>
</param>
<delivery>
    <delivery_id>SLOVENSKA_POSTA</delivery_id>
    <delivery_price>3</delivery_price>
    <delivery_price_cod>5</delivery_price_cod>
</delivery>
Heureka

U nás nájdete vyše 15 400 000 produktov a 10 900 internetových obchodov

O Heureke

  • Čo je Heureka?
  • Kontakty
  • Podmienky používania
  • Voľné pracovné miesta
  • Pre média
  • Heureka bloguje
  • Blog HeurekaDevs

Pre zákazníkov

  • Ako nakúpiť
  • Heureka v mobile
  • Heureka radí
  • Nakúpte priamo u nás
  • Používanie cookies
  • Ochrana súkromia

Pre partnerov

  • Administrácia e-shopu
  • Registrovať nový e-shop
  • Služby pre e‑shopy
  • Heureka Marketplace
  • Služby pre značky
  • Dátové prehľady
  • Affiliate program
  • Edukačné videá
  • Nápoveda

Projekty

  • Overené zákazníkmi
  • ShopRoku
  • ProduktRoku
  • Certifikácia partnerov
  • Black Friday

Zákaznícka linka

+421 2/205 703 60

Sledujte nás na sociálnych sieťach

Copyright © 2007–2025, Heureka Group a.s., všetky práva vyhradené.