Špecifikácia XML súboru
Význam jednotlivých značiek
Požiadavky na kvalitný XML súbor
XML súbor obsahuje dôležité tagy:
Ukážka základnej podoby XML súboru
Aby mohlo dôjsť k importu produktov 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 odovzdáte informácie o vašom tovare a jeho cenách. XML súbor je automaticky generovaný z vašich stránok, a preto jeho vytvorenie či úpravy konzultujte so svojim webmasterom.
Export dát je základ úspešnosti vášho zobrazovania na Heureke a preto ho odporúčame pripraviť podľa nižšie uvedenej špecifikácie k jednotlivým položkám. Max. počet predajných položiek v XML súbore 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ží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>
<VIDEO_URL>http://www.youtube.com/watch?v=KjR759oWF7w</VIDEO_URL>
<PRICE_VAT>240</PRICE_VAT>
<HEUREKA_CPC>0,24</HEUREKA_CPC>
<MANUFACTURER>NOKIA</MANUFACTURER>
<CATEGORYTEXT>Elektronika | Mobilné telefóny</CATEGORYTEXT>
<EAN>6417182041488</EAN>
<PRODUCTNO>RM-559394</PRODUCTNO>
<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>
Upozornenie:
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é a vypredané. Pri zmene URL adries vašich produktov, názvov produktov alebo kategórií v XML súbore sa na Heureke odpoja všetky produkty z kategórií a potom sa znovu čaká na ich zaradenie, ktoré môže trvať cca 4 pracovné dni. Je preto nutné v XML súbore zachovávať rovnaké URL adresy.
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áš XML súbor sťahujeme každé dve hodiny, aby sme vždy zaistili aktuálne ceny. Z vašej strany je potrebné vždy zaistiť aktuálnosť súboru, aby dáta boli čo najrelevantnejšie.
Komprimácia XML Súboru
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 max. 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:
Koreňový element, v súbore je obsiahnutý len raz.
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.
Unikátne označenie produktu v rámci e-shopu. Musí zostať unikátne navždy, vďaka čomu budeme schopní jednoznačne identifikovať produkt, aj keď sa zmení URL. 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.
Presný názov produktu. Nesmie obsahovať žiadne iné informácie, ako napr. + darček, alebo doprava zdarma. Hodnota musí byť obsiahnutá tiež v tagu PRODUCT, inak nebude braný v úvahu. Pokiaľ názvy produktov nebudú obsahovať produktové číslo, hrozí, že nedokážeme produkty správne identifikovať a tiež zaradiť. Maximálna dĺžka názvu produktu je 200 znakov.
Canon PowerShot SX100 červený
Digitálny fotoaparát Canon SX100 Power-shot + nabíjačka
Povinné údaje v názve pre jednotlivé kategórie
Všeobecne platí, že názov nesmie byť obecný. Pokiaľ teda uvediete do názvu produktu výrobcu, radu a produktové číslo, mal by byť produkt v poriadku zaradený.
Pokiaľ ide o varianty produktov, ktoré sa líšia farbou, rozmermi, príchuťou, množstvom a ďalšími atribútmi, je nutné všetky tieto parametre rozlíšiť v názve produktu, aby sa nezlúčili do jedného.
Sekcie |
Povinné údaje v názve pre jednotlivé sekcie |
Pneumatiky |
Výrobca | Trieda | Veľkosť | Priemer | Indexy |
Autosedačky |
Výrobca | Trieda | Produktové číslo / Označenie | Farba | Ročník |
Mobilné telefóny |
Výrobca | Trieda | Produktové číslo / Označenie | Farba |
Notebooky |
Výrobca | Trieda | Produktové číslo / Označenie | Kód špecifikácie |
Digitálne fotoaparáty |
Výrobca | Trieda | Produktové číslo / Označenie | Farba |
Televízory |
Výrobca | Trieda | Produktové číslo / Označenie |
PC komponenty |
Výrobca | Trieda | Produktové číslo / Označenie | Vzor |
Batérie |
Výrobca | Trieda | Produktové číslo / Označenie | Množstvo | Určenie / Typ | Neoriginál |
Satelitné komplety |
Výrobca | Trieda | PN prijímača | Typ LNB konvertoru | Typ antény | Typ karty |
Tonery |
Výrobca | Produktové číslo / Označenie | Kompatibilný |
Biela technika |
Výrobca | Produktové číslo / Označenie | Farba |
Stavebnice Lego |
Výrobca | Trieda | Produktové číslo / Označenie |
Stolné hry |
Výrobca | Trieda | Verzia |
Hračky |
Výrobca | Trieda | Produktový kód | Farba |
Bicykle |
Výrobca | Trieda | Produktové číslo / Označenie | Farba | Veľkost kolesa | Veľkost rámu | Ročník | Určenie |
Kolieskové korčule |
Výrobca | Trieda | Veľkosť | Farba | Ročník |
Zjazdové lyže |
Výrobca | Produktové číslo | Dĺžka | Farba | Ročník | Určenie |
Športová výživa |
Výrobca | Trieda | Množstvo | Príchuť |
Oblečenie |
Výrobca | Trieda | Farba | Určenie / Typ | Veľkosť |
Knihy |
Názov | Autor |
Hry na konzoly |
Názov | Verzia |
Kalendáre |
Trieda | Určenie / Typ | Ročník |
Parfémy |
Výrobca | Trieda | Množstvo | Určenie / Typ |
Kontaktné šošovky |
Výrobca | Trieda | Množstvo | Dioptrie | Priemer | Zakrivenie |
Pleťové krémy atď. |
Výrobca | Trieda | Typ pleti | Určenie | Množstvo |
Batohy |
Výrobca | Trieda | Objem |
Kabelky |
Výrobca | Trieda | Farba | Vzor |
Postele |
Výrobca | Trieda | Farba | Rozmery / Veľkosť |
Sedacie súpravy |
Výrobca | Trieda | Farba | Určenie / Typ | Rozmery / Veľkosť | Verzia |
Posteľné prádlo |
Výrobca | Trieda | Rozmery / Veľkosť | Vzor | Materiál |
Vane |
Výrobca | Trieda | Produktové číslo / Označenie | Dĺžka | Orientácia |
Obrusy |
Výrobca | Trieda | Farba | Rozmery / Veľkosť |
Koberce |
Výrobca | Typ / Rada | Rozmer (metráž) | Farba |
Komody |
Výrobca | Trieda | Farba | Rozmery / Veľkosť | Materiál |
Erotické pomôcky |
Výrobca | Rada | Farba |
Krmivá |
Výrobca | Trieda | Plemeno | Množstvo | Príchuť |
Vodítka pre psov |
Výrobca | Trieda | Produktové číslo / Označenie | Farba | Rozmery / Veľkosť |
Kočíky |
Výrobca | Trieda | Kombinace složení | Typ kolies | Farba | Ročník |
Fusaky |
Výrobca | Trieda | Farba |
Káva |
Značka / Výrobca | Rada | Gramáž | Druh |
Vína |
Vinárstvo | Druh vína | Množstvo | Ročník |
Brúsky |
Výrobca | Produktové číslo / Označenie |
Píly |
Výrobca | Produktové číslo / Označenie |
E-cigarety |
Výrobca | Trieda | Kapacita | Farba | Počet kusov |
LED Pásky |
Výrobca | Druh | Dĺžka | Počet diód | WATTY |
Čistiace prostriedky |
Výrobca | Kód produktu | Množstvo |
Prípravky pre zdravie |
Výrobca | Trieda | Množstvo |
Potraviny |
Výrobca | Trieda | Množstvo | Príchuť |
Puzzle |
Výrobca | Trieda | Počet dielikov |
E-liquidy |
Výrobca | Trieda | Príchuť | Objem | Obsah nikotínu |
Tašky na NTB |
Výrobca | Produktové číslo | Uhlopriečka | Farba |
Obaly na mobily |
Výrobca | Produktové číslo | Farba |
Výrobca
každý produkt by mal obsahovať v názve výrobcu, docielite tak jasné rozlíšenie
Produktové číslo/označenie
elektronika musí obsahovať produktový kód, ktorý jasne určí presný produkt, vrátane všetkých odlišných parametrov ako je farba, materiál, druh displeja atď. teda varianta.
Množstvo
produkty, ktoré sú štandardne predávané v určitom množstve, nie je potrebné označovať (napr. Pneumatiky 4ks, Reproduktory 2ks atď.). V prípade, že však predávate odlišné množstvo a v porovnaní cien by nebolo porovnanie relevantné, uveďte počet kusov do názvu produktu.
Produkty, ktoré sa predávajú na metre (látky, obrusy, káble, led pásky, stavebniny atď.) je nutné uviesť jednotku, za ktorú je daná cena, priamo do názvu produktu.
Farba
každá varianta tovaru, iná farba telefónu, fotoaparátu, trička, kolieskových korčúľ, kočíka, chladničky, kopačiek, okuliarov, atď. musí byť uvedená v názve a tak odlíšená varianta.
Určenie/typ
produkty, ktoré sa líšia typom, toto musí mať uvedené v názve (napr. Parfémy – toaletné x parfumovaná voda, Žiarovky – normálne x LED, Sedacie súpravy – dvoj x trojmiestne atď.).
Rozmery/veľkosť
produkty ako obliečky, postele, koberce – musia mať v názve, prípadne v tagu PRODUCT odlišnú variantu rozmerom (napr. 90x200). Produkty ako bicykle, lyže, kontaktné šošovky, oblečenie – musia mať v názve odlišnú variantu veľkosti.
Ročník
produkty, ktoré s každou novou sezónou majú iné vlastnosti (napr. materiál, vzor atď.), musia mať ročník uvedený v názve (napr. bicykle, autosedačky, vína, atď.)
Autor a EAN
knihy musia mať jasne určeného autora a EAN prípadne ISBN. Elektronické knihy musia byť odlíšené vlastnou kategóriou.
Verzia
produkty ako software musia obsahovať v názve všetky atribúty varianty, aká je to edícia, pre koľko užívateľov, aká licencia atď.
Vzor
produkty ako batohy, obliečky, bytové doplnky, atď., musia byť v názve odlíšené vzorom, podľa ktorého sa používatelia rozhodujú pre danú variantu.
Príchuť
produkty ako krmivá pre zvieratá, sušené mäso, športová výživa atď. musia mať rozlíšenie varianty príchute v názve.
Materiál
produkty ako nábytok musia mať v názve odlíšené varianty druhu materiálu, z ktorého je produkt vyrobený. Napr. dub, smrek, čerešňa.
Darčekové balenie
Produkty, ktoré sú v darčekovom balení, teda v inom balení, než je bežné, by mali mať označenie uvedené v názve, napr.: Vianočné balenie 2021, Valentínske balenie, Darčeková sada atd.
Tag Produkt obsahuje PRODUCTNAME (názov produktu) + informáciu o distribúcii produktu alebo možnosti osobného odberu , napr. „Whirlpool WBA 43983 NFC IX – osobný odber v Bratislave“.Tento názov bude aktuálne zobrazený v rebríčku e-shopov na produktovom detaile. Do budúcna plánujeme zmenu v spôsobe zobrazovania týchto informácií a názov v tejto podobe bude následne skrytý.
Maximálna dĺžka názvu produktu je 255 znakov pre zobrazenie vo fulltextovom vyhľadávaní. Pre zaradenie produktov do katalógu Heureky (v PPC režime) je povolených maximum 200 znakov.
Pre zadanie informácií o rozšírenej záruke a doplnkových službách novo použite tagy k tomu určené. Predĺženú záruku uvádzajte v tagu <EXTENDED_WARRANTY>. Doplnkové služby, ako je napríklad výnos na poschodie, servis, výmena alebo inštalácia spotrebiča a podobné, uvádzajte do tagu <SPECIAL_SERVICES>.
Povolené rozšírenia:
- iba osobný odber
- doba expirácie produktu
- distribúcia produktu (CZ, EU, mimo EU)
Nepovolené rozšírenia:
- doprava zadarmo (uvádzajte iba v tagu )
- dostupnosť (uvádzajte v dostupnostnom feede)
- autorizovaný predajca
- splátkový predaj
- osobný odber na pobočkách
- zľava na ďalší nákup a ďalšie formy vyjadrené zľavy (okamžitá zľava, akčná cena, bonus…)
Obsahuje
PRODUCTNAME + informáciu naviac. Tento názov bude
zobrazený v porovnaní cien. Napr. „Whirlpool WBA 43983 NFC IX – 5 rokov rozšírená záruka“.
Maximálna dĺžka názvu produktu je 255 znakov pre zobrazenie vo fulltextovom vyhľadávaní.
Pre zaradenie produktov do katalógu Heureky (v PPC režime) je maximum 200 znakov pre spracovanie a zobrazenie na detaile produktov.
Povolené rozšírenie:
- Predĺžená záruka
- Záruka x rokov na motor, súčiastky atď.
- Vynesenie do poschodia v cene
- Predĺženie záručného/pozáručného servisu
- Servis zdarma
- Predĺžená možnosť vrátenia tovaru do
- Len osobný odber
- Darčekové balenie
- Distribúcia produktu (SR, EU, mimo EU)
- a ďalšie služby spojené s produktom
Nepovolené rozšírenie:
- Doprava zdarma – uvádzajte len v tagu DELIVERY
- Dostupnosť – uvádzajte v dostupnostnom feede
- Autorizovaný predajca
- Predaj na splátky
- Osobný odber na X pobočkách
- Zľava na ďalší nákup
- a ďalšie formy vyjadrenej zľavy (okamžitá zľava, akčná cena, bonus …)
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.
Odkaz na stránku s ponukou daného výrobku v obchode. Na tejto stránke musí byť uvedená cena produktu v eurách a možnosť vložiť do košíka. Adresa musí byť unikátna v rámci celého feedu. URL nesmie obsahovať viac ako 300 znakov.
Odkaz na hlavný/primárny obrázok produktu.
Podmienky pre obrázky
Adresa obrázku nesmie obsahovať medzery alebo diakritiku. Maximálna dĺžka URL adresy obrázka je 255 znakov.
Ak máte pre viacero produktov jeden obrázok, použite vždy jednu a tú istú adresu (adresa nemusí byť
jedinečná v rámci feedu). Ďalej by obrázok nemal mať priehľadné pozadie. Pri zmene obrázku na stránkach
obchodu je potrebné zmeniť aj url adresu obrázku v XML súbore. Obrázky automaticky neaktualizujeme.
Minimálna potrebná veľkosť obrázku je 20x50 alebo 50x20 pixelov, avšak aby bol obrázok kvalitný, je potrebné,
aby mal aspoň 30 000 pixelov (cca 175x175 pixelov). Maximálna veľkosť obrázkov je rozlíšenie 4096 x 4096
pixelov a dátovo max. 2000 KB (2MB).
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é.
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.
Odkaz na videorecenziu produktu. Môžete uviesť iba odkazy na videá umiestnené na serveri www.youtube.com.
Celková cena produktu s DPH, v cene musia byť uvedené autorské a recyklačné poplatky.
Uvádzanie ceny
Na serveri Heureka.sk zobrazujeme celkové ceny.
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.
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.
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.
Tu je možné uviesť
parametre produktu, pokiaľ nie sú parametre vyplnené, nie je možné zobrazovať vaše produkty v konkrétnom filtrovaní. Parameter veľkosť je pri produktoch v sekcii Móda povinný.
Formát hodnoty <VAL> môže byť áno x nie v prípade, že si na vlastnosť, odpoviete, iba má či nemá.
V prípade, že odpoveď na vlastnosť bude inými slovami, či číselným údajom, hodnoty <VAL> už vyplňujeme danú hodnotou.
Číselné parametre ako hmotnosť, hlučnosť a ďalší, musí mať v hodnote <VAL> uvedené nielen číslo, ale i jednotku. Inak nie je parameter zaradený.
<PARAM>
<PARAM_NAME>určenie</PARAM_NAME>
<VAL>dámske</VAL>
</PARAM>
<PARAM>
<PARAM_NAME>objem</PARAM_NAME>
<VAL>100ml</VAL>
</PARAM>
<PARAM>
<PARAM_NAME>VEĽKOSŤ</PARAM_NAME>
<VAL>S</VAL>
</PARAM>
<PARAM>
<PARAM_NAME>FARBA</PARAM_NAME>
<VAL>ČIERNA</VAL>
</PARAM>
Obsahuje názov výrobcu produktu, využíva sa pre zaradenie pod filtrovací parameter, no nie pre párovanie položiek. Výrobca musí byť obsiahnutý taktiež aj v tagu PRODUCTNAME.
Zaradenie produktu do kategórie, uvádzajte vždy celú cestu k produktu, tak ako to máte na vašom eshope (stačia nám vaše kategórie) pokiaľ jasne určujú druh produktu. Prípadne využite náš strom aktívnych kategórií
https://www.heureka.sk/direct/xml-export/shops/heureka-sekce.xml
Elektronika | Mobilné telefóny | Príslušenstvo | Nabíjačky
Nabíjačky
Pokiaľ sa vaše produkty nezaradia na základe 100% zhody názvu s názvom na Heureke alebo vďaka EAN, je správny Categorytext jedinou možnosťou ako spárovať (za-kategorizovať) produkty.
Kategórie musia vždy jasne určovať druh produktu, ktorý sa pod nimi skrýva.
Elektronika | Televízory | LCD televízory
Elektronika | Biela technika | Ost. Kuchynské prístroje | Vaflovače
Detský tovar | Hračky | Pre najmenších | Hrkálky
Kozmetika | Pleťová kozmetika | Pleťové krémy
Chovateľstvo | Pre psov | Krmivo
Oblečenie | Dámske | Tričká
Televízory
Ostatné kuchynské prístroje
Podľa výrobcu | Bosch
Hračky | Cars
Kozmetika | Pleťová kozmetika
Chovateľstvo | Krmivá
Oblečenie | Dámske oblečenie
Oblečenie | Krátke tričká
Pozn.: Jednotlivé podkategórie oddeľujte následujúcim spôsobom NADKATEGÓRIA medzera | medzera PODKATEGÓRIA
EAN kódje používaný k označovaniu jednotlivých druhov tovaru. Podporujeme formát EAN 13. Neuvádzajte však interné čísla produktov, ale oficiálne čiarové kódy tovaru! (
viac o EAN kódu)
EAN kód je povinnou položkou pre kategórie Knihy, Učebnice, Mapy a sprievodcovia, Filmy, Hudba a Komiksy.
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)
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.
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
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 2-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 |
|
prázdna hodnota |
Info v obchode |
- neuvedená dostupnosť
- neznáma
- vypredané
|
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ť.
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>
HDS
<DELIVERY_ID>HDS</DELIVERY_ID>
Express One
<DELIVERY_ID>EXPRESS_ONE</DELIVERY_ID>
PPL
<DELIVERY_ID>PPL</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>
SDS
<DELIVERY_ID>SDS</DELIVERY_ID>
SPS
<DELIVERY_ID>SPS</DELIVERY_ID>
123KURIER
<DELIVERY_ID>123KURIER</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>
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>
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 ParcelLocker
<DELIVERY_ID>GLS_PARCELLOCKER</DELIVERY_ID>
AlzaBox
<DELIVERY_ID>ALZABOX</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, znovu vaša preprava musí spĺňať, že ju ponúkate po celej SR.
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>
Obsahuje ITEM_ID položky, ktorá je príslušenstvom k tomuto
produktu, napr. nabíjačka, púzdro, a pod. Je možné uviesť viackrát.
Súčet všetkých poplatkov (pokiaľ už nie sú obsiahnuté v konečnej cene
produktu), ktoré je nutné zaplatiť pri zakúpení produktu (cena uvedená vr. DPH, nezahrnuje dopravu a balné).
Poplatok je potom automaticky pripočítaný k cene produktu s DPH.
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, čísel nula až deväť
a malých a veľkých 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, pri ktorom zákazník darček skutočne získa. Darček nesmie byť ďalej ničím obmedzený (vyššia čiastka objednávky, nákup ďalšieho produktu, atď.).
Možno ho uvádzať viackrát, v prípade, že sú všetky darčeky dodávané k jednému produktu. V prípade možnosti výberu medzi darčekmi, je uvedený iba jeden darček.
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ácie je zo strany Heureky uvedená v popisku produktu a jej uvádzanie v tagu GIFT nie je povolené.
Ak sa jedná o cashback od značky iba 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 v XML feede. 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 zadarmo
- výnos na poschodie
- predĺženie záručného/pozáručného servisu
- 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 dostupnostnom feede)
- označenie autorizovaného predajcu
- možnosť splátkového predaja
- osobný odber na pobočkách
- zľava na ďalší nákup
- 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 obchode. 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é “…”.
Podmienky zasielania voucherov na zľavu vo feede:
- Voucher musí mať možnosť využiť ľubovoľný zákazník.
- 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 (napr. "&", "<", ">")
<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 & 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>