Specifikace XML souboru

Povinné údaje v názvu pro jednotlivé kategorie
Obecně platí, že název nesmí být obecný. Pokud tedy uvedete do názvu produktu výrobce, řadu a produktové číslo, měl by být produkt v pořádku zařazen.

Výrobce
každý produkt by měl obsahovat v názvu výrobce, docílíte tak jasnému rozlišení

Produktové číslo/označení
elektronika musí obsahovat produktový kód, který jasně určí přesný produkt, včetně všech odlišných parametrů jako je barva, materiál, druh displeje atd. Tedy variantu.

Množství
produkty, které jsou standardně prodávány po určitém množství, není potřeba označovat (např. Pneumatiky 4ks, Reproduktory 2ks atd.). V případě, že však prodáváte odlišné množství a v porovnání cen by nebylo srovnání relevantní, uveďte počet kusů do názvu produktu.
Produkty, které se prodávají na metry (látky, ubrusy, kabely atd.) je nutné uvést jednotku za kterou je daná cena přímo do názvu produktu.

Barva
každá varianta zboží, jiná barva telefonu, foťáku, trička, kolečkových bruslí, kočárku, lednice, kopaček, brýlí, atd. musí být uvedeno v názvu a odlišena tak varianta.

Určení/typ
produkty, které se liší typem, toto musí mít uvedeno v názvu (např. Parfémy – toaletní x parfémovaná voda, PC hry krabicová verze x elektronická ke stažení, Žárovky – normální x LED, Sedací soupravy – dvou x třímístné atd.).

Rozměry/velikost
produkty jako povlečení, postele, koberce – musí mít v názvu odlišenu variantu rozměrem (např. 90x200). Produkty jako jízdní kola, lyže, kontaktní čočky, oblečení – musí mít v názvu odlišenu variantu velikosti.

Ročník
produkty, které s každou novou sezónou mají jiné vlastnosti (např. materiál, vzor atd.), musí mít ročník uveden v názvu (např. jízdní kola, autosedačky, vína, atd.)

Autor a EAN
knihy musí mít jasně určeného autora a EAN případně ISBN. Elektronické knihy musí být odlišeny vlastní kategorií.

Verze
produkty jako software musí obsahovat v názvu všechny atributy varianty, jaká je to edice, pro kolik uživatelů, jaká licence atd.

Vzor
produkty jako batohy, povlečení, bytové doplňky, atd., musí být v názvu odlišeny vzorem, podle kterého se uživatelé rozhodují pro danou variantu.

Příchuť
produkty jako krmiva pro zvířata, sušené maso, sportovní výživa atd. musí mít rozlišení varianty příchutě v názvu.

Materiál
produkty jako nábytek musí mít v názvu odlišeny varianty druhu materiálu, ze kterého je produkt vyroben. Např. dub, smrk, třešeň.

Příklady správných názvů produktů:

Elektro:

• Notebooky - Acer Aspire ONE 722-C6Ckk LU.SFT0C.060
• Tablety – Samsung Galaxy Tab 10.1 P7500 16GB
• Lednice - Whirlpool WBE34132 A++X
• Vysavače - Electrolux UltraOne Z 8810
• Satelitní přijímače – Topfield TF 6000CR karta Skylink Ice
• Baterie – Baterie GP 2700mAh AA 4 ks
• Televize – Samsung UE40D6530 S
• Digitální fotoaparát – Nikon D3100 Red + 18-55mm AF-S DX
• Tonery - HP Q2612A – kompatibilní – tonery musí být odděleny na originální a kompatibilní/alternativa již v názvu.

Auto-Moto:

• Pneumatiky – Barum Polaris 3 195/65 R15 91T
• Alu kola – Dezent RE 6,5x16 5x114,30 ET48
• Autodíly – Brzdové kotouče Octavia zadní Ferodo DDF929
• Autobaterie – Varta Silver dynamic 12V 74h 750A
• Autožárovky – Philips H7 (55W, 12V)
• Autokosmetika – Sonax tvrdý vosk Super Liquid 250ml
• Autosedačky – Römer King Plus 2011 – Billy

Sport:

• Jízdní kola - Felt Q220 2011
• Sjezdové lyže - Atomic Cloud 6 156cm 2011 + XTL 9 Lady
• Kopačky - Predator X TRX FG Black/White/Cyan
• Sportovní výživa - Aminostar Actions Whey Gainer 4500g

Chovatelství:

• Krmivo pro psy - Brit Care Adult Large Breed Lamb & Rice 12kg
• Vodítka - Trixie Bonies 1,5×120 cm

Bydlení:

• Povlečení - Matějovský I love London bavlna 140x200
• Polštáře - MORAVSKÁ ÚSTŘEDNA Polštář Krtek mašinka 30x30 cm
• Prostěradla - Scarlett prostěradlo froté Lux 120x60 bílé
• Radiátory - KORADO Radik VK 22-50/délka 100 cm

Zážitky:

• Zážitek – Vyhlídkový let balonem – 2 osoby/Chrudim

Nápoje:

• Vína - Vinařství Lechovice - Sylvánské zelené - pozdní sběr 2009 - Royal - 0,75l
• Destiláty – Jameson 12let 1l

Svítidla:

• Svítidla - Massive 33406/17/10
• Žárovky – LED žárovka GU10 5W 350L

Erotické pomůcky:

• Vibrátory - Fun Factory Delight růžový
• Kondomy - Durex Performa 3ks
• Lubrikační gely - Durex Play Massage gel 2 v 1 200 ml

Módní doplňky:

• Dámská trička - Lonsdale Large Logo T Shirt Ladies Toxic Red/Flyel
• Dámská obuv - Nike Backboard 386110012 EUR 36
• Kabelky – Dakine Gisele kabelka černá
• Batohy - Batoh Dakine Pivot zelený
• Hodinky - Casio GA-110-1AER G-Shock

Kosmetika:

• Parfémy - Lanvin Eclat D´Arpege parfémová voda 100 ml tester
• Pleťové krémy - EUCERIN Hyaluron - filler noční krém 50ml
• Řasenky - Lancome Prodlužující a zhušťující řasenka Virtuose 6,5 g černá

Zdraví:

• Léky - ORENZYM POR.TBL.OBD.50X200UT – název podle SUKL
• Kontaktní čočky - Air Optix Aqua (6 čoček) zakřivení 8.6, průměr 14,2 dioptrie 1,75
• Brýle - Way Fashion černé čiré

Knihy:

• Knihy – Tajemství – Julie Garwoodová
• Kalendáře – Iva Hüttnerová 2012 – nástěnný
• Filmy – Muži v naději – DVD
• Hudba – Tomáš Klus – Racek – MP3
• Hry - Battlefield 3 Limited Edition

Hračky:

• Stavebnice Lego – Lego duplo 5639 Rodinný domek
• Deskové hry – Albi Český film – otázky a odpovědi, Activity – rozšíření karet
• Puzzle - Ravensburger Tygři 5000 dílků
• Pro nejmenší - Fischer Price Skládací kelímky

Dětské zboží:

• Chůvičky - Dětská chůvička Philips SCD 510/00
• Fusaky - Emitex Combi 3v1 zimní fusak – fialový
• Kočárky - X-lander Set XA XVI 2011 forrest

Zahrada:

• Sekačky - Bosch ROTAK 34
• Aku šroubováky - Bosch PSR 18 LI-2
• Bazény - Marimex Tampa 3,66 x 0,91 m kartušová filtrace

Podmínky pro obrázky

Adresa obrázku nesmí obsahovat mezery či diakritiku. 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. Obrázky automaticky neaktualizujeme. Minimální potřebná velikost obrázku je 20x50 nebo 50x20 pixelů, avšak aby byl obrázek kvalitní, je třeba, aby měl alespoň 30 000 pixelů (cca 175x175 pixelů).

Posílejte nám pouze obrázky (nejlépe *jpeg) produktů. Obrázky typu http://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ů.

Uvádění ceny

Ceny na serveru Heureka.cz uvádíme konečné.

Cena může být uvedena v těchto formátech:

• 25 000
• 25000
• 25000,50
• 25000.50

Nepoužívejte jako oddělovač tisíců/miliónů tečku ('.'), ta je použita k oddělování desetinných míst. Cenu uvádějte maximálně na 2 desetinná místa.

Bazarová (i repasovaná) položka:

<ITEM_TYPE>bazaar</ITEM_TYPE>

Položku nepoužívejte pro nové, ale jen pro bazarové položky

Další vlastnosti či parametry produktu uvádějte pomocí PARAM, čímž zařadíte vaši produkty do dodatečného filtrování produktů.

<PARAM>
  <PARAM_NAME>určení</PARAM_NAME>
  <VAL>dámské</VAL>
</PARAM>
<PARAM>
  <PARAM_NAME>objem</PARAM_NAME>
  <VAL>100ml</VAL>
</PARAM>
<PARAM>
  <PARAM_NAME>VELIKOST</PARAM_NAME>
  <VAL>S</VAL>
</PARAM>

Pokud se vaše produkty nezařadí na základě 100% shody názvu s názvem na Heuréce nebo díky EAN, je správný Categorytext jedinou možností jak spárovat (zakategorizovat) produkty.

Kategorie musí vždy jasně určovat druh produktu, které se pod ní skrývají.

Pozn.: Jednotlivé podkategorie oddělujte následujícím způsobem NADKATEGORIE mezera  | mezera PODKATEGORIE

Pozn.: Detailní a aktuální informace o dostupnosti zboží lze poskytovat také prostřednictvím samostatného XML feedu (více o dostupnstním XML)

Uvádění dodací doby

Dodací doba musí být uváděna jako doba od přijetí platby (v případě dobírky od přijetí objednávky) do expedice zboží. Pokud je zboží skladem a vy jej vyexpedujete ještě týž den, kdy přijmete objednávku či je možné ještě tentýž den si zboží vyzvednout, pak uveďte <DELIVERY_DATE>0</DELIVERY_DATE> nebo <DELIVERY_DATE>ihned</DELIVERY_DATE>

Pozn. pokud je zboží ne centrálním (externím) skladu dodavatele, pak není možné uvádět výše uvedené.

Dále je dodací doba uváděna ve dnech, tj. počet dní od přijetí platby k expedici, uvádí se pouze celočíselná hodnota, např.

<DELIVERY_DATE>5</DELIVERY_DATE>

Jestliže jde o produkt, který bude na trhu až od určitého data, pak uvádějte např.:

<DELIVERY_DATE>2010-12-05</DELIVERY_DATE>

Pozn.: toto označení se využívá pro případy, kdy je produkt prodejný až od určitého data, ale lze učinit předobjednávky.

U produktů, u kterých není známa dodací doba, tag <DELIVERY_DATE></DELIVERY_DATE> neuvádějte vůbec. Na Heuréce se poté bude zobrazovat info v obchodu.

V případě, že jsou produkty dlouhodobě nedostupné a není známá ani přibližná doba dodání, pak by v XML souboru neměly vůbec být.

Pozn.: Jestliže je v tomto tagu uvedeno doprodan"-", nedostupn"-", vyprodan"-" či neni, pak se tyto produkty vůbec neimportují.

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.

Podporovaní dopravci

Zde jsou uvedeni podporovaní dopravci v následujícím znění:

Česká pošta

<DELIVERY_ID>CESKA_POSTA</DELIVERY_ID>

DPD

<DELIVERY_ID>DPD</DELIVERY_ID>

DHL

<DELIVERY_ID>DHL</DELIVERY_ID>

FOFR

<DELIVERY_ID>FOFR</DELIVERY_ID>

Gebrüder Weiss

<DELIVERY_ID>GEBRUDER_WEISS</DELIVERY_ID>

Geis

<DELIVERY_ID>GEIS</DELIVERY_ID>

General Parcel

<DELIVERY_ID>GENERAL_PARCEL</DELIVERY_ID>

GLS

<DELIVERY_ID>GLS</DELIVERY_ID>

HDS

<DELIVERY_ID>HDS</DELIVERY_ID>

HeurekaPoint

<DELIVERY_ID>HEUREKAPOINT</DELIVERY_ID>

InTime

<DELIVERY_ID>INTIME</DELIVERY_ID>

PPL

<DELIVERY_ID>PPL</DELIVERY_ID>

Radiálka

<DELIVERY_ID>RADIALKA</DELIVERY_ID>

TNT

<DELIVERY_ID>TNT</DELIVERY_ID>

TOPTRANS

<DELIVERY_ID>TOPTRANS</DELIVERY_ID>

UPS

<DELIVERY_ID>UPS</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.

V případě, že Vám některý přepravce chybí, kontaktujte nás.

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>