Klávesové zkratky na tomto webu Na obsah stránky
Seznam.cz

Zboží.cz

Specifikace XML pro internetové obchody

Co je XML feed?

Jedná se o speciální datový soubor ve formátu XML, který obsahuje informace o nabízených položkách (název, popis, cena, údaje o dostupnosti apod.).

Generované XML si vytvářejí ve spolupráci se svými webmastery samy internetové obchody synchronně s databází uvedenou na stránkách internetového obchodu.

V případě, že si XML soubor tvoříte ručně, otevřete např. Poznámkový blok a na první řádek vložte hlavičku:

<?xml version="1.0" encoding="windows-1250"?>
(kódování zadejte dle použitého typu)

na druhý řádek napište: <SHOP>
na čtvrtý řádek napište: </SHOP>
mezi řádky s <SHOP> a </SHOP> vložte produkt spolu s jeho popisem - např.:
<SHOPITEM>
<PRODUCT>Světélkující podložka pod myš</PRODUCT>
<DESCRIPTION>Fosforeskující okraj, nevyžaduje baterie.</DESCRIPTION>
<URL>http://obchod.cz/podlozky-pod-mys/fosfor</URL>
<ITEM_TYPE>new</ITEM_TYPE>
<DELIVERY_DATE>1</DELIVERY_DATE>
<IMGURL>http://obchod.cz/obrazky/podlozky-pod-mys/fosfor.jpg</IMGURL>
<PRICE>620</PRICE>
<PRICE_VAT>756</PRICE_VAT>
</SHOPITEM>

Výsledný soubor nahrajte na Vaše stránky tak, aby byl k dispozici pro pravidelné stahování naším robotem.

UPOZORNĚNÍ
Jestliže Váš XML feed obsahuje řádově desetitisíce položek, doporučujeme jej rozdělit na více částí, případně komprimovat do archivu ZIP či gzip (robot dokáže pracovat i s komprimovanými archivy).

Význam jednotlivých značek

<SHOP>

povinné

Kořenová značka, v jejímž rámci je vše ostatní.

<SHOPITEM>

povinné

V této značce jsou obsaženy informace týkající se 1 výrobku.

<PRODUCT>

nepovinné (pokud jsou uvedeny elementy PRODUCTNAME a PRODUCTNAMEEXT)

Hlavní název výrobku, který musí odpovídat jeho povaze. Musí obsahovat všechny potřebné údaje, aby byl výrobek pomocí názvu odlišitelný od ostatních položek. Může obsahovat informace, které jsou specifické pro daný obchod, např. "... + dárek zdarma". Název nesmí obsahovat:

  • reklamní slogany a superlativy (např. "nejlevnější obchod")
  • nadměrně se opakující klíčová slova či fráze (dvakrát či vícekrát za sebou)
  • nadměrnou interpunkci, smajlíky, tři tečky a vykřičníky
  • informace, které přímo nesouvisí s nabízeným produktem

Maximální zobrazovaná délka je 64 znaků, přičemž za tečkami a čárkami musejí být mezery, jak je běžné v českých textech. V názvu položky zboží smí být pouze jeden vykřičník. Před vykřičníkem nesmí být mezera.
Pokud element není uveden, tak se automaticky vytvoří z PRODUCTNAME a PRODUCTNAMEEXT.

<PRODUCTNAME>

nepovinné

Krátký název výrobku včetně značky, ale bez přívlastků a parametrů. Tento element se spolu s PRODUCTNAMEEXT používá při zakládání nových výrobků do produktové databáze. Nesmí obsahovat žádné prvky, které by byly specifické jen pro daný obchod – jde o obecné pojmenování výrobku z pohledu spotřebitele.

<DESCRIPTION>

povinné

Popis výrobku. Obsahuje výhradně informace o produktu v českém jazyce, nesmí obsahovat:

  • reklamní texty a slogany týkající se internetového obchodu
  • nadměrně se opakující klíčová slova nebo fráze (dvakrát či vícekrát za sebou)

Není povolena nadměrná interpunkce, smajlíky nebo tři tečky. Za tečkami a čárkami musejí být mezery, jak je běžné v českých textech. Před vykřičníkem nesmí být mezera.

<URL>

povinné

Odkaz na stránku s nabídkou daného výrobku.

<IMGURL>

nepovinné

Odkaz na obrázek výrobku, který jej věrně zobrazuje. Součástí obrázku nesmí být vodoznaky ani jiné výrazné grafické prvky. Obrázek může být ve formátu JPEG nebo PNG, ostatní formáty nejsou podporovány.

<PRICE>

nepovinné (v případě, že je uvedena značka PRICE_VAT)

Cena v Kč bez DPH. Akceptována je pouze číselná hodnota bez mezer mezi řády, k oddělení haléřů slouží tečka.

Příklad:

<PRICE> 12345.50 </PRICE>

<VAT>

povinné v případě, že je uvedena značka PRICE

Procentní sazba DPH.

Příklad:

<VAT> 20 </VAT>
<VAT> 0.20 </VAT>
Oba výše uvedené zápisy jsou ekvivalentní a představují 20% sazbu DPH.

<PRICE_VAT>

nepovinné v případě, že jsou uvedeny značky PRICE a VAT

Cena v Kč včetně DPH.

<MAX_CPC>

nepovinné

Maximální cena za proklik v Kč. Akceptována je číselná hodnota bez mezer mezi řády, k oddělení haléřů slouží tečka. Přípustná hodnota je z intervalu 1 až 500 Kč. Pro odstranění předchozího nastavení slouží prázdná hodnota.

<MAX_CPC> 23.50 </MAX_CPC>

<DUES>

povinné (pokud se poplatky vztahují k nabízenému sorimentu a nejsou již obsaženy v ceně)

Součet veškerých poplatků, které je nutné zaplatit při zakoupení výrobku (cena uvedena včetně DPH, nezahrnuje dopravu a balné).

<DELIVERY_DATE>

nepovinné

Doba vyřízení objednávky. Dodací doba musí být uváděna jako doba od přijetí platby do expedice zboží. Číselná hodnota je poté systémem automaticky převáděna na textové vyjádření:

  • Zboží skladem se může uvést jako: 
    <DELIVERY_DATE> 0 </DELIVERY_DATE>
    <DELIVERY_DATE> ihned </DELIVERY_DATE>
  • Je možné uvádět dodací dobu ve dnech (pouze celočíselná hodnota): 
    <DELIVERY_DATE> 5 </DELIVERY_DATE>
  • Dostupnost uvedená datem - od tohoto data bude produkt dostupný: 
    <DELIVERY_DATE> 2007-03-05 </DELIVERY_DATE>
Dostupnost se pak zobrazuje jako jedna z možností:
  • skladem – 0 dní
  • do týdne – 1-7 dní
  • více jak týden – 8 a více dní
  • neznámá – při hodnotě -1; případně není-li tag DELIVERY_DATE v XML feedu vůbec

<SHOP_DEPOTS>

nepovinné

Tzv. identifikátor kamenných poboček, ve kterých je položka skladem k okamžitému osobnímu odběru.

O přidělení identifikátoru je potřeba požádat na e-mailové adrese zbozi@firma.seznam.cz. V e-mailu uveďte IČ, název společnosti a adresu kamenné prodejny či výdejního místa. Přidělený identifikátor se vztahuje pouze k jednomu IČ obchodu a jeho provozovnám. Jednotlivé identifikátory je možno oddělit středníkem. Po přidělení identifikátoru je obchod zařazen do filtru "Region".

<ITEM_TYPE>

nepovinné v případě, že je zboží nové

Udává, zda se jedná o nové či bazarové (použité, renovované, repasované) zboží.

Nová položka: 
<ITEM_TYPE> new </ITEM_TYPE>
Bazarová položka: 
<ITEM_TYPE> bazaar </ITEM_TYPE>

<TOLLFREE>

nepovinné

Slouží obchodům s placenou službou Zboží Standard k výběru položek, které budou při vyhledávání upřednostněny. Výchozí hodnota je 0 – veškeré položky tedy budou upřednostněny.

Položka bude upřednostněna: 
<TOLLFREE> 0 </TOLLFREE>
Položka nebude upřednostněna: 
<TOLLFREE> 1 </TOLLFREE>

<FIRMY_CZ>

nepovinné

Internetový obchod, který má placený zápis na službě Firmy.cz si může určit až 5 položek, které se budou zobrazovat v detailu zápisu v sekci "Aktuální nabídka".

Položka se bude zobrazovat ve firemním zápise: 
<FIRMY_CZ> 1 </FIRMY_CZ>
Položka se nebude zobrazovat ve firemním zápise: 
<FIRMY_CZ> 0 </FIRMY_CZ>

V případě, že se tento tag v XML feedu nenachází nebo je hodnotou 1 označeno více jak 5 položek, systém zobrazí náhodně vybrané položky.

<MANUFACTURER>

nepovinné

Název výrobce produktu.

<CATEGORYTEXT>

nepovinné

Zařazení produktu do kategorie. Uvádějte vždy celou cestu k produktu. Pokud je výrobek v několika kategoriích, můžete element zopakovat. Preferovaný oddělovač je znak " | ". Lze použít i znaky " - " nebo " > " (je třeba použít entitu &gt;). Např.:

<CATEGORYTEXT>Foto | Paměťové karty | Compact Flash</CATEGORYTEXT>
<CATEGORYTEXT>MP3 | Paměťové karty | Compact Flash</CATEGORYTEXT>

<EAN>

nepovinné (doporučujeme jej ale uvádět)

Kód výrobku EAN13 – musí se jednat o validní kód včetně kontrolní číslice. EAN kód výrazně napomáhá správnému napárování do skupin výrobků. Element je možné opakovat.

<PRODUCTNO>

nepovinné

Kód výrobku udávaný výrobcem, u knih např. ISBN. Neuvádějte zde vlastní kódy výrobků.

Tvorba variant produktů

<VARIANT>

nepovinné

Varianty produktů (např. různé barvy mobilních telefonů nebo velikosti oblečení). Element je uvnitř elementu SHOPITEM a zároveň může obsahovat stejné elementy jako SHOPITEM (všechny jsou nepovinné). Varianta produktu se chápe jako samostatný produkt, potřebná data se načtou nejprve ze samotného elementu VARIANT, pokud tam nejsou, tak se načtou (zdědí) z vnějšího elementu SHOPITEM. V okamžiku, kdy je uveden jeden element VARIANT, tak je výsledkem jeden produkt. U samotných variant není vyžadována jedinečná hodnota elementu URL, je ale nutné zajistit jedinečnost kombinace URL, PRODUCTNAME a PRODUCTNAMEEXT. Příklad elementu SHOPITEM s variantami:

<SHOPITEM>
     <PRODUCTNAME>Nokia 6300</PRODUCTNAME>
     <MANUFACTURER>Nokia</MANUFACTURER>
     <URL> ... </URL>
     <IMGURL> ... </IMGURL>
     <VARIANT>
          <PRODUCTNAMEEXT>Black</PRODUCTNAMEEXT>
          <IMGURL> ... </IMGURL>
          <EAN> ... </EAN>
          <PRODUCTNO> ... </PRODUCTNO>
     </VARIANT>
     <VARIANT>
          <PRODUCTNAMEEXT>Red</PRODUCTNAMEEXT>
          <IMGURL> ... </IMGURL>
          <EAN> ... </EAN>
          <PRODUCTNO> ... </PRODUCTNO>
     </VARIANT>
</SHOPITEM>

<PRODUCTNAMEEXT>

nepovinné

Jedná se o hodnotu parametru tvořícího variantu. Popis výrobku se nadále uvádí v elementu DESCRIPTION. Element má stejné použití jako PRODUCTNAME a platí pro něj stejná pravidla

Příklad feedu

<?xml "1.0" encoding="windows-1250"?>
<SHOP>

<SHOPITEM>
<PRODUCT>Světélkující podložka</PRODUCT>
<DESCRIPTION>Fosforeskující okraj, nevyžaduje baterie.</DESCRIPTION>
<URL>http://obchod.cz-pod-mys/fosfor</URL>
<ITEM_TYPE>new</ITEM_TYPE>
<DELIVERY_DATE>1</DELIVERY_DATE>
<IMGURL>http://obchod.cz/obrazky/podlozky-pod-mys/fosfor.jpg</IMGURL>
<PRICE>620</PRICE>
<PRICE_VAT>756</PRICE_VAT>
</SHOPITEM>

<SHOPITEM>
<PRODUCT>Podložka pod myš - kočka</PRODUCT>
<DESCRIPTION>Ergonomická podložka pod myš, potisk s .</DESCRIPTION> 
<DUES>20</DUES>
<ITEM_TYPE>bazaar</ITEM_TYPE>
<DELIVERY_DATE>0</DELIVERY_DATE>
<SHOP_DEPOTS>111</SHOP_DEPOTS>
<IMGURL>http://obchod.cz/obrazky/podlozky-pod-mys/kocka.jpg</IMGURL>
<PRICE>420</PRICE>
<PRICE_VAT>512</PRICE_VAT>
<TOLLFREE>1</TOLLFREE>
</SHOPITEM>

</SHOP>

V případě, že se v XML feedu vyskytují jiné značky než výše uvedené, nebudou systémem zpracovány.