Specifikace XML feedu

Nabídkový XML feed je datový soubor, který obsahuje informace o jednotlivých prodejních položkách (nabídkách) ve vašem eshopu (název, cena, údaje o dostupnosti apod.).

Feed je nejčastěji generován přímo z databáze eshopu. Nevíte-li, jak XML feed získat, poraďte se se svým webmasterem, nebo se obraťte na poskytovatele platformy pro váš eshop. Může vypadat třeba takto: (text mezi <!-- a --> jsou komentáře)

<?xml version="1.0" encoding="utf-8"?>
 <!-- kódování zadejte dle použitého typu ("utf-8", "windows-1250" ...). Doporučené a výchozí je utf-8 -->
 <SHOP xmlns="http://www.zbozi.cz/ns/offer/1.0">
 <SHOPITEM>
 <ITEM_ID>62448</ITEM_ID>
 <PRODUCTNAME>Solartent MC234CZ/A premium Beige</PRODUCTNAME>
 <PRODUCT>Stínítko z laminátových prutů Solartent MC234CZ/A premium Berige </PRODUCT>
 <DESCRIPTION>Velmi praktické stínítko s lehkou konstrukcí z laminátových prutů.</DESCRIPTION>
 <CATEGORYTEXT>Dům, byt a zahrada | Zahrada | Stínící technika | Zahradní slunečníky</CATEGORYTEXT>
 <EAN>8594061743744</EAN>
 <PRODUCTNO>MC234CZ/A</PRODUCTNO>
 <MANUFACTURER>Solartent</MANUFACTURER>
 <URL>http://example.com/slunecniky/solartent123</URL>
 <DELIVERY_DATE>0</DELIVERY_DATE>
 <DELIVERY>
 <DELIVERY_ID>DPD_PICKUP</DELIVERY_ID>
 <DELIVERY_PRICE>100</DELIVERY_PRICE>
 <DELIVERY_PRICE_COD>149</DELIVERY_PRICE_COD>
 </DELIVERY>
 <EXTRA_MESSAGE>free_gift</EXTRA_MESSAGE>
 <FREE_GIFT_TEXT>Powerbanka ADATA s kapacitou 12500 mAh</FREE_GIFT_TEXT>
 <EXTRA_MESSAGE>extended_warranty</EXTRA_MESSAGE>
 <PARAM>
 <PARAM_NAME>barva</PARAM_NAME>
 <VAL>Béžová</VAL>
 </PARAM>
 <IMGURL>http://example.com/obrazky/slunecniky/solartent123.jpg</IMGURL>
 <PRICE_VAT>1290</PRICE_VAT>
 <MAX_CPC>6,50</MAX_CPC>
 <MAX_CPC_SEARCH>5,80</MAX_CPC_SEARCH>
 </SHOPITEM>
 <SHOPITEM>
 <!-- popis druhé nabídky... -->
 </SHOPITEM>
 <!-- ... -->
 </SHOP>

Správná struktura značek v XML feedu a také množství a korektnost informací, které jsou v nich uvedené, přispívá k efektivitě jakékoli kampaně ve Zboží.cz. Správnost svého XML feedu si můžete zkontrolovat v našem validátoru. Doporučujeme jednotlivé položky XML feedu odřádkovat, v případě výskytu chyby pak validátor může konkrétně informovat, kde se vyskytovala. Při pracování feedu neukládáme duplicitní položky. Duplicitní položky posuzujeme pouze podle shodného názvu v tagu Productname.

Vytvořený XML feed je vždy třeba nahrát na web tak, aby si z jeho URL adresy mohlo Zboží.cz pravidelně stahovat informace o jednotlivých nabídkách. Frekvenci stahování lze nastavit v rozmezí 1 x až 12 x denně. Celkový počet položek ve feedu není omezen, maximální velikost feedu je 1 GB.

Význam jednotlivých značek v nabídkovém XML feedu

Hlavička XML: <?xml version="1.0" encoding="utf-8"?>

Nepovinná, nutno uvádět pouze pokud používáte jiné kódování než UTF-8. České Windows typicky ukládají soubory v kódování windows-1250.

<SHOP xmlns="http://www.zbozi.cz/ns/offer/1.0" > – kořenová značka XML feedu

odkaz

Uvádějte s parametrem xmlns="http://www.zbozi.cz/ns/offer/1.0", který značí že jde o feed vytvořený podle aktuální specifikace.

<SHOP xmlns="http://www.zbozi.cz/ns/offer/1.0">
 <SHOPITEM><!-- ... --></SHOPITEM>
 <SHOPITEM><!-- ... --></SHOPITEM>
 <!-- ... -->
 </SHOP>

<SHOPITEM> – obaluje informace týkající se jedné konkrétní nabídky

odkaz
opakujte pro každou položku
<SHOP xmlns="http://www.zbozi.cz/ns/offer/1.0">
 <SHOPITEM>
 <PRODUCTNAME>SONY Playstation 3 320GB</PRODUCTNAME>
 <!-- ... -->
 </SHOPITEM>
 <SHOPITEM>
 <PRODUCTNAME>Slunečník Solartent premium Beige</PRODUCTNAME>
 <!-- ... -->
 </SHOPITEM>
 <!-- ... -->
 </SHOP>

Vlastnosti položky

Následující značky popisují vlastnosti položky ve vašem feedu, přidávají se tedy dovnitř elementu <SHOPITEM>…</SHOPITEM>.

<PRODUCTNAME> – název nabídky

odkaz
povinné, doporučená délka 70 znaků, maximum 255 znaků.

Obecné pojmenování výrobku z pohledu spotřebitele bez rozšiřujících údajů eshopu. Musí obsahovat všechny potřebné údaje tak, aby byla nabídka pomocí názvu odlišitelná od ostatních nabídek v XML feedu, a řídí se jednotnou šablonou rozlišenou pro různé kategorie produktů (vizte Pravidla pojmenování nabídek). Základní šablona platná pro většinu kategorií je
Výrobce (Produktová řada) Produktové označení Varianta

Do názvu uveďte skutečného výrobce dílu, nikoli značku, se kterou jsou vaše produkty kompatibilní. Informace o kompatibilitě s určitými značkami můžete uvést do atributu ‘popis’ [description].

<PRODUCTNAME>SONY Playstation 3 320GB</PRODUCTNAME>

<DESCRIPTION> – popis nabídky

odkaz
povinné (doporučená délka 250-1024 znaků)

Textový popis jednotlivé nabídky ve formátu čistého textu s odřádkováním odstavců. Musí obsahovat výhradně informace o výrobku v českém jazyce. Začátek popisu by měl v několika větách obsahovat hlavní výhody daného produktu. Popis 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)

V popisku není žádoucí opakovat název výrobce, modelové označení výrobku. Nevkládejte zde také informace týkající se dárků, pro ně je určena značka EXTRA_MESSAGE. Není povolena nadměrná interpunkce, použití emotikonů nebo ukončení věty třemi tečkami. Za tečkami a čárkami musí být mezery, jak je běžné v českých textech.

<DESCRIPTION>Herní konzole s vysokým výkonem a obrovskou nabídkou her...</DESCRIPTION>

<URL> – adresa nabídky v eshopu

odkaz
povinné

URL adresa, která odkazuje na stránku nabídky v eshopu.
URL nesmí obsahovat znaky české diakritiky, mezery a jiné nestandardní znaky.

<URL>http://example.com/slunecniky/solartent123</URL>

<PRICE_VAT> – cena

odkaz
povinné; číselná hodnota, max. dvě desetinná místa

Konečná cena v Kč včetně DPH a poplatků. Při uvedení více desetinných míst budou přebytečná desetinná místa odříznuta. Pro oddělení řádu korun a haléřů je možné použít desetinnou čárku i tečku.

<PRICE_VAT>5786</PRICE_VAT>
<PRICE_VAT>5786.90</PRICE_VAT>
<PRICE_VAT>5786,35</PRICE_VAT>

<DELIVERY_DATE> – dostupnost

odkaz
povinné (celé číslo nebo datum ve formátu RRRR-MM-DD)

Doba vyřízení objednávky – musí být uváděna jako doba od přijetí objednávky do expedice zboží. Číselná hodnota je systémem automaticky převáděna na textové vyjádření. U předobjednávek a připravovaných produktů uvádějte datum uvedení na trh ve formátu RRRR-MM-DD.

Podporované hodnoty <DELIVERY_DATE>
Hodnota <DELIVERY_DATE> Přípustná vyjádření na stránkách obchodu
0 (skladem)
  • skladem
  • skladem u dodavatele, expedice do 24 hodin
  • skladem v expedičním skladu, expedice do 24 hodin
  • skladem na prodejně
  • ihned (k odběru)
  • expedice do 24 hodin
  • počet kusů > 0
1-3 (do 3 dnů)
  • skladem (expedice do 3 pracovních dnů)
  • obvykle skladem
  • skladem u dodavatele
  • obvykle do 3 dnů
  • 1-3 dny
4-7 (do týdne v e-shopu)
  • skladem, dodání do 4-7 pracovních dnů
  • do 7 dnů
  • skladem (expedice do týdne)
  • obvykle skladem
  • obvykle expedujeme do 7 dnů
  • 4-7 dnů
  • do týdne
8 a více (více jak týden)
  • 8 a více dní
  • na objednávku
  • do 30 dní
datum ve formátu RRRR-MM-DD (předobjednávka)
  • předobjednávka + datum uvedení na trh
  • připravujeme + datum uvedení na trh
  • vychází + datum uvedení na trh
-1 (neznámá dostupnost)
  • neuvedená dostupnost v detailu produktu
  • neznámá

Příklady:

<DELIVERY_DATE>0</DELIVERY_DATE>
<DELIVERY_DATE>3</DELIVERY_DATE>
<DELIVERY_DATE>25</DELIVERY_DATE>
<DELIVERY_DATE>2017-12-24</DELIVERY_DATE>
odkaz
nepovinné

Na Zboží.cz máme definovaný seznam dopravců a sítí výdejních míst které podporujeme. Dopravcem může být i eshop sám (podporujeme pouze  dopravce s dopravou po celé ČR), stejně tak může prezentovat síť svých výdejních míst.

Výdejní místa - Podporované hodnoty <DELIVERY>
Název DELIVERY_ID
Česká pošta CESKA_POSTA_NA_POSTU
DPD Pickup DPD_PICKUP
Geis Point GEIS_POINT
GLS Parcelshop GLS_PARCELSHOP
PPL ParcelShop PPL_PARCELSHOP
Toptrans Depo TOPTRANS_DEPO
Uloženka ULOZENKA
Zásilkovna ZASILKOVNA
Vlastní místa VLASTNI_VYDEJNI_MISTA

Dopravci - Podporované hodnoty <DELIVERY>
Název DELIVERY_ID
Česká pošta CESKA_POSTA
DB_SCHENKER DB_SCHENKER
DPD DPD
DHL DHL
DSV DSV
FOFR FOFR
Gebrüder Weiss GEBRUDER_WEISS
Geis GEIS
GLS GLS
HDS HDS
InTime INTIME
MESSENGER MESSENGER
PPL PPL
TNT TNT
TOPTRANS TOPTRANS
UPS UPS
FedEx FEDEX
Raben Logistics RABEN_LOGISTICS
RHENUS RHENUS
Vlastní přeprava VLASTNI_PREPRAVA

 

  • DELIVERY_ID – identifikátor dopravce nebo sítě výdejních míst ze seznamu podporovaných
  • DELIVERY_PRICE – cena s DPH za dopravu nebo vyzvednutí položky při platbě předem
  • DELIVERY_PRICE_COD – cena s DPH za dopravu nebo vyzvednutí položky při platbě dobírkou


Pokud pro položku, dopravce nebo výdejní místo není dobírka možná, by neměl být tag DELIVERY_PRICE_COD u položky uveden. Stejně tak pokud není možné položku na výdejní místo nebo konkrétním dopravcem doručit, nesmí být u této položky tag uveden (např. nadrozměrné položky)

Příklad:
<DELIVERY>
<DELIVERY_ID>DPD_PICKUP</DELIVERY_ID>
<DELIVERY_PRICE>100</DELIVERY_PRICE>
<DELIVERY_PRICE_COD>149</DELIVERY_PRICE_COD>
</DELIVERY>
odkaz
Samostatné nabídky budeme moci zařadit do výpisu příslušné kategorie pouze v případě, u nichž je uveden CATEGORYTEXT, který bude odpovídat názvu kategorií z našeho číselníku.

Strojově čitelný strom kategorií Zboží.cz je průběžně aktualizovaný na adrese https://www.zbozi.cz/static/categories.json či ke stažení ve formátu pro MS Excel https://www.zbozi.cz/static/categories.csv. Do feedu je potřeba uvádět kompletní cestu kategorie ze stromu kategorií Zboží.cz. Jako oddělovač slouží svislá čára | (tzv. pipe)

 

Příklad:

<CATEGORYTEXT>Foto | Fotoaparáty a videokamery | Digitální fotoaparáty | Digitální kompakty</CATEGORYTEXT>
<CATEGORYTEXT>Foto | Fotoaparáty a videokamery | Blesky</CATEGORYTEXT>

 

Pokud také využíváte reklamu SKLIK a Produktové inzeráty (PI) a máte nastaveno podle kategorií, po změně hodnoty v tagu ve vašem feedu, dojde také v SKLIKu k zneaktivnění původně nastavených skupin podle kategorie. Prosím proveďte také úpravu v nastavení SKLIKU pro PI.

 

odkaz

Název nabídky, který musí odpovídat její povaze. Musí obsahovat všechny potřebné údaje, aby byla nabídka pomocí názvu odlišitelná od ostatních nabídek v XML feedu. Může obsahovat informace, které jsou specifické pro daný obchod, např. "+ dárek zdarma". Jde ve své podstatě o rozvětvenou značku PRODUCTNAME včetně přívlastků. Tento název bude použit v případě, že se nabídka nespáruje a bude se zobrazovat v nabídkách.

Do názvu uveďte skutečného výrobce dílu, nikoli značku, se kterou jsou vaše produkty kompatibilní. Informace o kompatibilitě s určitými značkami můžete uvést do atributu ‘popis’ [description].

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, emotikony, tři tečky a vykřičníky
  • informace, které přímo nesouvisí s nabídkou

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.

odkaz
výrazně doporučujeme uvádět

Unikátní identifikátor (alfanumerické znaky) nabídky v rámci eshopu, typicky např. ID položky ve skladovém systému, je povolena jakákoli kombinace znaků [0-9, a-z, A-Z, _ , -] tedy čísel nula až devět, malých a velkých písmen bez diakritiky, a také podtržítka a pomlčky. Díky této značce budete schopni vždy jednoznačně identifikovat nabídku a sledovat její historii a výkon v rámci služby Zboží.cz, i když se změní její URL či název. Proto je klíčové, aby zůstala stejná i v případě změny e-shopového řešení.

<ITEM_ID>62448</ITEM_ID>
<ITEM_ID>Ohpai9Aecuux</ITEM_ID>
odkaz
nepovinné; strukturovaná značka, možné opakovat

Dodatečné parametry, které mohou být použity k filtrování produktů na webu Zboží.

Značka <PARAM> má následující podznačky:

<PARAM_NAME> povinné Název parametru.
Například: délka, objem, velikost, barva, určení
<VAL> povinné Hodnota parametru.
Například: 110, 500, XXL, černá, dětské
<UNIT> nepovinné Jednotka parametru.
Například: cm, ml, GB, MHz

Parametry produktů rozlišované pro jednotlivé kategorie si můžete stáhnout ve formátu CSV (kódování UTF-8) nebo JSON.

Příklad:

<PARAM>
 <PARAM_NAME>FM rádio</PARAM_NAME>
 <VAL>Ano</VAL>
 </PARAM>
 <PARAM>
 <PARAM_NAME>velikost paměti</PARAM_NAME>
 <VAL>32</VAL>
 <UNIT>GB</UNIT>
 </PARAM>
 <PARAM>
 <PARAM_NAME>barva</PARAM_NAME>
 <VAL>černá</VAL>
 </PARAM>
 <PARAM>
 <PARAM_NAME>rozlišení</PARAM_NAME>
 <VAL>1920 x 1080 (FHD)</VAL>
 </PARAM>
odkaz
nepovinné, doporučujeme uvádět; značku je možné opakovat

URL adresa obrázku, který nabídku věrně zobrazuje. Součástí obrázku nesmí být vodoznaky, loga obchodů, reklamní nápisy ani jiné výrazné grafické prvky. Obrázek může být ve formátu JPEG nebo PNG, ostatní formáty nejsou podporovány. Doporučený rozměr obrázku je alespoň 425x440 px (v případě nestandardních obrázků je potřeba dodržet alespoň 1 z rozměrů). Pokud změníte obrázek bez změny IMGURL, na Zboží.cz zůstává původní obrázek.

<IMGURL>http://example.com/obrazky/slunecniky/solartent123.jpg</IMGURL>
odkaz
nepovinné, doporučujeme uvádět
GTIN, Global Trade Item Number – Globální číslo obchodní položky

Akceptováno je osmi-, dvanácti-, třinácti-, nebo čtrnáctimístné číslo bez mezer.

Globální číslo obchodní položky GTIN (často nesprávně nazývané EAN) je určeno k mezinárodní identifikaci obchodních položek v následujících formátech:
GTIN-8   - 8 číslic, kóduje se v čárovém kódu EAN-8
GTIN-13   - 13 číslic, kóduje se v čárovém kódu EAN-13
GTIN-14  - 14 číslic, kóduje se v čárovém kódu ITF-14, GS1-128 nebo GS1 DataBar
V USA a Kanadě se používá GTIN-12 (12 číslic) pro čárové kódy UPC-A a UPC-E.
Nástroj pro výpočet kontrolních číslic naleznete zde: https://www.gs1cz.org/vypocet-kontrolni-cislice

 

<EAN>8594061743744</EAN>
odkaz
nepovinné, doporučujeme uvádět

Mezinárodní standardní číslo knihy ve formátu ISBN-10 nebo ISBN-13. Akceptováno je desetimístné nebo třináctimístné číslo, buď bez mezer, nebo může být jako oddělovač skupin použita mezera či pomlčka, oddělovače však nesmějí být kombinovány.

<ISBN>9781444102451</ISBN>
<ISBN>978-1-78038-067-4</ISBN>
<ISBN>978 1 86201 559 3</ISBN>
odkaz
nepovinné, doporučujeme uvádět

Označení produktu uváděné výrobcem (Manufacturer Part Number, MPN). Tímto označením výrobce jedinečným způsobem identifikuje produkt. Akceptována je libovolná kombinace čísel a písmen.

<PRODUCTNO>MC234CZ/A</PRODUCTNO>
<PRODUCTNO>VGNNS31S/S.CEZ</PRODUCTNO>
<PRODUCTNO>60002456</PRODUCTNO>
<PRODUCTNO>8834A001AA</PRODUCTNO>
odkaz
nepovinné, doporučujeme uvádět

Označuje skupinu nabídek, které vzájemně představují varianty. Variantou považujeme všechny nabídky stejného výrobce, řady, názvu a se shodnou cenovou úrovní, přičemž se liší odchylkou jednoho parametru.

Př.:
Název: Nordblanc Sprinter NBLC59 červené
Varianta: 42

Výjimkou jsou případy, kdy je variantní vazba stanovena přímo výrobcem či je definována přístupem trhu k segmentu.

Př:
Název: Apple iPhone 5S
Varianta: 16 GB Stříbrný

Pro označení skupiny variantních nabídek je povolena jakákoli kombinace maximálně 36 znaků [0-9, a-z, A-Z, _ , -] tedy čísel nula až devět, malých a velkých písmen bez diakritiky, podtržítka a pomlčky.

Tato značka je velmi důležitá při tvorbě variant jednotlivých nabídek a její uvádění významně přispívá ke zkvalitnění dodávaných dat i prezentace nabídek ve službě Zboží.cz. V sekci Oblečení a móda lze pomocí tagu <ITEMGROUP_ID> slučovat přímo skupiny nabídek a je možné tak přispět k přehlednějšímu náhledu na nabídky.

Stejně postupujeme i v případě varinatních vazeb mezi produkty, viz Seznam kategorií, kde dochází k slučování variant produktů

Příklad struktury XML feedu při označení variant pomocí ITEMGROUP_ID:

<SHOPITEM>
 <PRODUCTNAME>Apple iPod Touch (5. gen.) 16GB - Space Gray</PRODUCTNAME>
 <!-- ... -->
 <ITEMGROUP_ID>oerjn641ern</ITEMGROUP_ID>
 </SHOPITEM>
 
 <SHOPITEM>
 <PRODUCTNAME>Apple iPod Touch (5. gen.) 32GB Pink</PRODUCTNAME>
 <!-- ... -->
 <ITEMGROUP_ID>oerjn641ern</ITEMGROUP_ID>
 </SHOPITEM>
 
 <SHOPITEM>
 <PRODUCTNAME>Apple iPod Touch (5. gen.) 64GB Blue</PRODUCTNAME>
 <!-- ... -->
 <ITEMGROUP_ID>oerjn641ern</ITEMGROUP_ID>
 </SHOPITEM>
odkaz
nepovinné, doporučujeme uvádět

Výrobce konkrétní nabídky.
Příklad: Apple, Bosch, Dell, Henkel, Lenovo
Podmínky pro založení naleznete v sekci značky na Zboží.cz.

odkaz
povinné pro všechny erotické nabídky

Tímto tagem se označují všechny erotické nabídky.
Chcete-li, aby se vaše erotické nabídky zobrazovaly v erotických kategoriích, použijte u nich tag

<EROTIC>1</EROTIC>

a zároveň vyplňte tag CATEGORYTEXT.

odkaz
nepovinné, možné opakovat

Slouží k uvedení doplňkových informací o nabídce. Podporované hodnoty se zobrazují u nabídek na Zboží.cz.

EXTRA_MESSAGE v produktovém detailu - zobrazujeme 1 extra message.

Extra message u nabídky v produktovém detailu na Zboží.cz

EXTRA_MESSAGE u samostatných nabídek - zobrazujeme až 2 extra message.

Extra message u nabídky na Zboží.cz

Podporované hodnoty <EXTRA_MESSAGE>
Hodnota <EXTRA_MESSAGE> Text zobrazovaný na Zboží.cz
free_gift Dárek zdarma
extended_warranty Rozšířená záruka
voucher Voucher na další nákup
free_accessories Příslušenství zdarma
free_case Pouzdro zdarma
free_installation Montáž zdarma

K vybraným EXTRA_MESSAGE je nyní možnost připojit text, kde můžete uvést, o jaký konkrétní dárek nebo příslušenství se jedná. Vztahuje se k těmto hodnotám:
  • dárek zdarma (free_gift)
  • příslušenství zdarma (free_accessories)
  • voucher na další nákup (voucher)

FREE_GIFT_TEXT, FREE_ACCESSORIES_TEXT, VOUCHER_TEXT rozšíří EXTRA_MESSAGE o textovou informaci s omezením na 160 znaků, kde lze uvést, o jaký konkrétní dárek nebo příslušenství se jedná.
Nové tagy k tagu <EXTRA_MESSAGE>
Tagy k <EXTRA_MESSAGE> Volitelný text
FREE_GIFT_TEXT Např. Obal na mobilní telefon
FREE_ACCESSORIES_TEXT Např. Originální síťový kabel kompatibilní s tímto zařízením
VOUCHER_TEXT Např. 100 Kč na další nákup

Aby se daná EXTRA_MESSAGE s textovou informací zobrazila na webu, je podmíněno přítomností příslušné EXTRA_MESSAGE ve feedu. Jedná se o volitelné nové tagy. Maximální četnost je 1x.

Řazení extra message (která má být první, druhá …) se řídí pořadím značek v XML feedu.

Příklad:
<EXTRA_MESSAGE>free_gift</EXTRA_MESSAGE>
<FREE_GIFT_TEXT>Powerbanka ADATA s kapacitou 12500 mAh</FREE_GIFT_TEXT>

<BRAND> – značka produktu

odkaz
nepovinné

Název značky. Tato značka slouží v XML feedu pro specifické případy licencování značky (Hello Kitty, Star Wars), nebo samostatné značky jednoho výrobce (výrobce Henkel: značky Persil, Ariel, Perwoll; výrobce Coca-Cola: značky Coca-Cola, Fanta, Sprite, Kinley, Schweppes).

<SHOP_DEPOTS> – výdejní místo pro okamžitý odběr

odkaz
nepovinné, možné opakovat

Identifikátor výdejního místa, ve kterém je nabídka skladem k okamžitému osobnímu odběru. Na takovém výdejním místě musí být možné výrobek prohlédnout, vyzkoušet a případně reklamovat. Je-li identifikátor vyplněn a u nabídky je zároveň ve značce DELIVERY_DATE uvedena hodnota 0 (skladem), na webu Zboží.cz je možné ji dohledat pomocí filtru „Na prodejně“.

Identifikátor výdejního místa je ID z Firmy.cz. V administraci Zboží.cz v záložce "Provozovna" a dále "Výdejní místa", je přehled ID Firmy.cz, které se použije jako identifikátor do XML feedu. (Položka označená "Identifikátor pro feed" se používá v první verzi feedu. Do feedu jehož specifikaci právě čtete patří skutečně hodnota ze sloupce "ID Firmy.cz".)

<SHOPITEM>
 <!-- ... -->
 <SHOP_DEPOTS>554875</SHOP_DEPOTS>
 </SHOPITEM>
 
 <SHOPITEM>
 <!-- ... -->
 <SHOP_DEPOTS>554875</SHOP_DEPOTS>
 <SHOP_DEPOTS>12822045</SHOP_DEPOTS>
 </SHOPITEM>

<VISIBILITY> – zobrazování nabídky na Zboží.cz

odkaz
nepovinné, 0 nebo 1

Možnost vyloučit konkrétní nabídku ze zobrazování na Zboží.cz

Pokud je nastaveno <VISIBILITY>0</VISIBILITY> nabídka se ve Zboží.cz nebude zobrazovat. Pokud není uvedeno, nebo je uvedeno <VISIBILITY>1</VISIBILITY>, nabídka se ve Zboží.cz zobrazí.

<CUSTOM_LABEL_0>, <CUSTOM_LABEL_1> – dodatečné označení nabídky

odkaz
nepovinné

Označí vybrané nabídky libovolným textem a tím z nich vytvoří skupinu (např.: podle prodejnosti, sezóny, slevy…). Tento tag slouží k filtraci nabídek pro produktové inzeráty na službě Sklik. Pro každou nabídku lze mít jeden <CUSTOM_LABEL_0>, <CUSTOM_LABEL_1>CUSTOM_LABEL má maximálně 250 znaků.

<SHOPITEM>
 <PRODUCTNAME>Slunečník Solartent premium Beige</PRODUCTNAME>
 <!-- ... -->
 <CUSTOM_LABEL_0>Letni akce</CUSTOM_LABEL_0>
 <CUSTOM_LABEL_1>Vysoká prodejnost</CUSTOM_LABEL_1>
 </SHOPITEM>

<MAX_CPC> – maximální cena za proklik v detailu produktu

odkaz
nepovinné; číselná hodnota, max. dvě desetinná místa

Maximální cena za proklik v detailu produktu v Kč. Proklik uskutečněný ze Zboží.cz do internetového obchodu je zpoplatněn minimální cenou 0,50 - 2 Kč bez DPH dle výše prodejní ceny (tabulka Minimální cena za proklik). Akceptována je číselná hodnota bez mezer mezi řády, k oddělení haléřů slouží čárka nebo tečka. Přípustná hodnota je z intervalu 0,50 až 500 Kč. Pro odstranění předchozího nastavení slouží prázdná hodnota. Není-li značka MAX_CPC u nabídky uvedena, nebo je v ní vyplněna hodnota menší než cena za proklik dle výše prodejní ceny, za proklik v produktovém detailu bude účtováno minimální cenou 0,50 - 2 Kč bez DPH dle výše prodejní ceny.

<MAX_CPC>23.50</MAX_CPC>
Minimální cena za proklik
Prodejní cena Cena za proklik
do 100 0,50 Kč
do 300 1,00 Kč
do 1000 1,25 Kč
do 5000 1,50 Kč
nad 5000 2,50 Kč


Poznámka: Pokud si eshop nastaví maximální cenu za proklik, kterou je ochoten pro danou položku v produktu nebo fulltextu zaplatit, systém spočítá cenu prokliku, která je nutná k udržení na dané pozici (second-price). Použije-li zákazník řazení od nejlevnější nabídky, účtuje se pouze ceníková cena.

odkaz
nepovinné; číselná hodnota, max. dvě desetinná místa

Maximální cena za proklik ve fulltextovém výsledku hledání v Kč. Proklik uskutečněný ze Zboží.cz do internetového obchodu je zpoplatněn minimální cenou 0,50 - 2 Kč bez DPH dle výše prodejní ceny (tabulka Minimální cena za proklik). Akceptována je číselná hodnota bez mezer mezi řády, k oddělení haléřů slouží čárka nebo tečka. Přípustná hodnota je z intervalu 0,50 až 500 Kč. Pro odstranění předchozího nastavení slouží prázdná hodnota. Není-li značka MAX_CPC_SEARCH u nabídky uvedena, nebo je v ní vyplněna hodnota menší než cena za proklik dle výše prodejní ceny, za proklik v nabídkách bude účtováno minimální cenou 0,50 - 2 Kč bez DPH dle výše prodejní ceny.

<MAX_CPC_SEARCH>23.50</MAX_CPC_SEARCH>
Minimální cena za proklik
Prodejní cena Cena za proklik
do 100 0,50 Kč
do 300 1,00 Kč
do 1000 1,25 Kč
do 5000 1,50 Kč
nad 5000 2,50 Kč


Poznámka: Pokud si eshop nastaví maximální cenu za proklik, kterou je ochoten pro danou položku v produktu nebo fulltextu zaplatit, systém spočítá cenu prokliku, která je nutná k udržení na dané pozici (second-price). Použije-li zákazník řazení od nejlevnější nabídky, účtuje se pouze ceníková cena.

<PRODUCT_LINE> – produktová řada

odkaz
k použití pro rozšiřování produktové databáze; jednotlivé části jsou oddělované znakem pipe |

Řada a její podřada definovaná dle výrobce. Typicky jde o rodinu produktů, které výrobce sdružil pod jednotný název.

Příklady:

  • Latitude
  • iPod | iPod Touch
  • ThinkPad | Edge

<LIST_PRICE> – doporučená koncová prodejní cena

odkaz
k použití pro rozšiřování produktové databáze; číselná hodnota, max. dvě desetinná místa

Orientační doporučená prodejní cena nabídky v Kč včetně DPH a poplatků (tzv. MSRP - manufacturer's suggested retail price).

<RELEASE_DATE> – datum oficiálního zahájení prodeje v ČR

odkaz
k použití pro rozšiřování produktové databáze; datum a čas ve formátu RRRR-MM-DDTHH:MM:SS

Datum oficiálního zahájení prodeje výrobku pro Českou republiku. Uvádí se ve formátu RRRR-MM-DDTHH:MM:SS, při neuvedení času se bere půlnoc.

<RELEASE_DATE>2015-04-27T09:18:46</RELEASE_DATE>
<RELEASE_DATE>2015-03-14</RELEASE_DATE>

Anglická verze specifikace

Specifikaci v angličtině si můžete stáhnout zde.

odkaz