Specifikace

doporučujeme uvádět, značku je možné opakovat
akceptujeme pouze prvních 20 obrázků

Další URL adresy obrázků, které nabídku věrně zobrazují. Takto označené obrázky bereme jako další a budou zobrazeny na detailu nabídky a budou použity i pro produktové karty.

Obrázek může být ve formátu JPEG, PNG nebo WEBP, ostatní formáty nejsou podporovány. Doporučený rozměr obrázku je alespoň 425×440 px (v případě nestandardních obrázků je potřeba dodržet alespoň 1 z rozměrů), stejně jako u IMGURL. Pokud změníte obrázek bez změny IMGURL_ALTERNATIVE, na Zboží.cz zůstává původní obrázek.

<IMGURL_ALTERNATIVE>http://example.com/obrazky/destnik1/solartent123.jpg</IMGURL_ALTERNATIVE>
<IMGURL_ALTERNATIVE>http://example.com/obrazky/destnik2/solartent123.jpg</IMGURL_ALTERNATIVE>
<IMGURL_ALTERNATIVE>http://example.com/obrazky/destnik3/solartent123.jpg</IMGURL_ALTERNATIVE>

maximální zobrazovaná délka 64 znaků

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. Jde ve své podstatě o rozvětvenou značku PRODUCTNAME včetně přívlastků. Tento název bude použit při výsledcích hledání.

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.

Výrobce konkrétní nabídky, pomáhá při filtraci značky v konkrétní kategorii. Podmínky pro založení značky naleznete v sekci značky na Zboží.cz.

<MANUFACTURER>Apple</MANUFACTURER>
<MANUFACTURER>Bosch</MANUFACTURER>
<MANUFACTURER>Dell</MANUFACTURER>

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.

Podporované hodnoty výdejních míst

Podporované hodnoty dopravců

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ě na dobírku

Vlastní přepravu je možné uvést pouze v případě, že zásilku můžete doručit po celé České republice.

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

<DELIVERY>
<DELIVERY_ID>DPD_PICKUP</DELIVERY_ID>
<DELIVERY_PRICE>100</DELIVERY_PRICE>
<DELIVERY_PRICE_COD>149</DELIVERY_PRICE_COD>
</DELIVERY>

povinné pro všechny bazarové nabídky

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 názvu stejného výrobku inzerovaného v nabídce, XML feedu a jeho URL nebo e-shopového řešení. V případě, že se změní nabídka na jiný inzerovaný výrobek a to i v případě změny barvy, velikosti atd. je zapotřebí změnit ITEM_ID, aby se nabídka automaticky odpárovala z neodpovídající produktové karty.

<ITEM_ID>62448</ITEM_ID>
<ITEM_ID>Ohpai9Aecuux</ITEM_ID>

maximální délka 500 znaků

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.

V XML feedu je povoleno u jedné nabídky uvádět pouze 10 hodnot tagu CATEGORYTEXT.

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)

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

číselná hodnota, max. dvě desetinná místa

Nejnižší cena za posledních 30 dní před začátkem slevy 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.

Podmínky, pro zobrazení informace o slevě:

• je správně zadaná prodejní (zlevněná) <PRICE_VAT>
• cena v akci je nižší než nejnižší prodejní cena za posledních 30 dní před začátkem slevové akce
• sleva není starší než 30 dní
• výše slevy je v rozmezí 5% – 90%

Informace o slevě se zobrazí v detailech produktů, stejně jako u příslušné nabídky ve Zboží inzerátech.

<PRICE_BEFORE_DISCOUNT>5786</PRICE_BEFORE_DISCOUNT>
<PRICE_BEFORE_DISCOUNT>5786.90</PRICE_BEFORE_DISCOUNT>
<PRICE_BEFORE_DISCOUNT>5786,35</PRICE_BEFORE_DISCOUNT>

Zobrazení slevového kuponu je podmíněné přihlášením.

Slouží k uvedení informace o možnosti využití slevového kódu na uplatnění slevy pro konkrétní nabídku. Informace o slevovém kuponu se zobrazí u nabídek na Zboží.cz a ve Zboží inzerátech.

Pravidla pro slevový kupon
– kupon musí být v e-shope viditelně uveden
– využití kuponu na straně e-shopu není ničím dalším podmíněno
– musí být platný pro danou nabídku, u které je uveden
– pro plošnou slevu může být využít stejný kupon u všech nabídek

Značka <SALES_VOUCHER> má následující povinné atributy:

<CODE>
string
Kód, který uživatel zadá ve vašem e-shopu. Může být kombinace textu s číslem, maximálně v délce 24 znaků. Pro optimální zobrazení a použití doporučujeme kratší řetězec, do 12 znaků.

<PRICE_WITH_VOUCHER>
číselná hodnota, v Kč, max. dvě desetinná místa
Zlevněná cena po uplatnění slevového kuponu.

<DATE_FROM>
Datum od kdy kupon platí

<DATE_TO>
Datum prvního dne, kdy kupon již neplatí
Oba datumy se uvádí ve formátu RRRR-MM-DD

<TEXT>
maximální délka je 128 znaků
Obsahuje popis akce, slevy, ke ktere je kupon vázán.

<SALES_VOUCHER>
<CODE>SLEVA10</CODE>
<PRICE_WITH_VOUCHER>9999</PRICE_WITH_VOUCHER>
<DATE_FROM>2024-04-01T00:00:00</DATE_FROM>
<DATE_TO>2024-04-30T23:59:59</DATE_TO>
<TEXT>Týden značky, dodatečná sleva 10 % na vybrané TV a soundbary platí do 29. 4. 2024 nebo do vyprodání zásob.</TEXT>
</SALES_VOUCHER>

možné opakovat

• dárek zdarma (free_gift)
• příslušenství zdarma (free_accessories)
• voucher na další nákup (voucher)
• jiné (custom)

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

CUSTOM_TEXT lze použít na rozšíření EXTRA_MESSAGE o textovou informaci o dalších doplňkových službách poskytovaných u nabídky, které nejsou explicitně uvedeny ve zbylých hodnotách značky. Do popisu je možné uvést více služeb do maximálního počtu 160 znaků.

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 není limitována.

<EXTRA_MESSAGE>free_gift</EXTRA_MESSAGE>
<FREE_GIFT_TEXT>Powerbanka ADATA s kapacitou 12500 mAh</FREE_GIFT_TEXT>

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>

strukturovaná značka, možné opakovat

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

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 s hodnotou 1 a zároveň vyplňte tag CATEGORYTEXT.

<EROTIC>1</EROTIC>

povinné pro všechny bazarové, rozbalené a repasované nabídky (nabídky se budou zobrazovat na službě Sbazar a ve Zboží inzerátech)

new – nové zboží (nepovinný tag)

open_box (rozbalené) – zboží rozbalené za účelem předvádění či focení pro e-shop nebo vrácené jinými zákazníky. Žádné nebo jen drobné stopy používání. Kompletní příslušenství. Nemusí mít originální obal. Zákonná záruka.

used (použité) – zboží se stopami používání. Plně funkční. Obsah balení nemusí být kompletní, obsahuje ale příslušenství nutné k provozu. Může mít poškozený nebo neoriginální obal. Obrázek by měl zobrazovat reálný stav, neměl by být ilustrační. Zákonná záruka.

refurbished (repasované) – odborně opravené nebo renovované zboží. Může mít stopy používání, je ale plně funkční. Obrázek by měl zobrazovat reálný stav, neměl by být ilustrační. Zákonná záruka.

Aby se mohly inzeráty na Sbazaru vydávat, je třeba splňovat pravidla pro inzerci rozbaleného a použitého zboží. 

<CONDITION>new</CONDITION>
<CONDITION>open_box</CONDITION>
<CONDITION>used</CONDITION>
<CONDITION>refurbished</CONDITION>

povinné pro všechny bazarové, rozbalené a repasované nabídky

doporučená délka cca 200 znaků, maximum 2000 znaků

Textový popis stavu zboží. Nejedná se o popis nabídky!

Popis závad inzerované nabídky, tedy čím se stav nabízeného zboží liší od zcela nového výrobku, včetně stavu balení či přiloženého příslušenství.

Příklad:

<CONDITION_DESC>Vráceno ve lhůtě 14 dnů. Prasklý plastový kryt vysavače v zadní části, 
v příslušenství chybí vůně do vysavače. Originální obalový materiál je lehce potrhaný.</CONDITION_DESC>

povinné pro všechny bazarové, rozbalené a repasované nabídky

Číselná hodnota musí vyjadřovat počet měsíců záruky, kterou e-shop garantuje při zakoupení zboží.

Doživotní záruka: 999

Příklad:

<WARRANTY>12</WARRANTY>

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>

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>

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.

Např.
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.

Např.
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.

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>