Specifikace

Význam jednotlivých značek

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.

je nutné uvést přesné znění

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

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

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

<SHOPITEM>
...
</SHOPITEM>

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ů (viz 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>

doporučená délka 250-1024 znaků

Textový popis jednotlivé nabídky ve formátu čistého textu s odřádkováním odstavců. Popisek musí být relevantní a přesný. 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, která odkazuje na stránku nabídky v e-shopu.
URL nesmí obsahovat znaky české diakritiky, mezery a jiné nestandardní znaky.

Každá nabídka, včetně jejích variant, musí mít svou unikátní URL adresu.

Tagování URL pomocí UTM parametrů při biddování ze Zboží.cz.

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

čí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.

Konečná cena musí být uvedena v kladné hodnotě.

V případě, že bude cena uvedena v řádu haléřů, pak ji automaticky zaokrouhlíme.

U položek jako jsou podlahy, dlažby a podobné materiály musí být jasně uvedeno, zda se jedná o cenu za m², balení nebo jinou jednotku.

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

celé číslo nebo datum ve formátu RRRR-MM-DD
pro bazarové položky je povinné uvádět hodnotu 0 (skladem)

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 v tagu DELIVERY_DATE

Hodnota 0 (skladem)
Přípustná hodnota na webu e-shopu

  • 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

Hodnota 1-3 (do 3 dnů)
Přípustná hodnota na webu e-shopu

  • skladem (expedice do 3 pracovních dnů)
  • obvykle skladem
  • skladem u dodavatele
  • obvykle do 3 dnů
  • 1-3 dny

Hodnota 4-7 (do týdne)
Přípustná hodnota na webu 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

Hodnota 8 a více (za více než týden)
Přípustná hodnota na webu e-shopu

  • 8 a více dní
  • na objednávku
  • do 30 dní

Datum ve formátu RRRR-MM-DD (za více než týden)
Přípustná hodnota na webu e-shopu

  • předobjednávka + datum uvedení na trh
  • připravujeme + datum uvedení na trh
  • vychází + datum uvedení na trh

Hodnota -1 (neznámá dostupnost)
Přípustná hodnota na webu e-shopu

  • neznámá

<DELIVERY_DATE>0</DELIVERY_DATE>
<DELIVERY_DATE>3</DELIVERY_DATE>
<DELIVERY_DATE>25</DELIVERY_DATE>
<DELIVERY_DATE>2017-12-24</DELIVERY_DATE>

bazarové nabídky musí mít minimální velikost obrázku 800×600 px, tzn. i u obrázků na výšku musí mít kratší strana 800px

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, 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ů). 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>

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

Název DELIVERY_ID
AlzaBox ALZABOX
Balíkovna CESKA_POSTA_BALIKOVNA
Česká pošta CESKA_POSTA_NA_POSTU
DPD Pickup DPD_PICKUP
GLS Parcelshop GLS_PARCELSHOP
PPL ParcelShop PPL_PARCELSHOP
Toptrans Depo TOPTRANS_DEPO
One Point ONE_POINT
Zásilkovna ZASILKOVNA
Vlastní výdejní místa VLASTNI_VYDEJNI_MISTA

Podporované hodnoty dopravců

Název DELIVERY_ID
123 kurýr 123_KURYR
Česká pošta CESKA_POSTA
Balíkovna na adresu BALIKOVNA_NA_ADRESU
DB_SCHENKER DB_SCHENKER
DPD DPD
DHL DHL
DSV DSV
Emons EMONS
FOFR FOFR
Gebrüder Weiss GEBRUDER_WEISS
Geis GEIS
GLS GLS
HDS HDS
One Courier ONE_COURIER
Náš kurýr NAS_KURYR
MESSENGER MESSENGER
PPL PPL
TNT TNT
TOPTRANS TOPTRANS
UPS UPS
FedEx FEDEX
Raben Logistics RABEN_LOGISTICS
RHENUS RHENUS
Zásilkovna (na adresu) ZASILKOVNA_NA_ADRESU
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ě 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).

Nelze nastavit dopravu dle hmotnosti zásilky.

E-shop musí zajišťovat dopravu v rámci území České republiky.

<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

Slouží k uvedení doplňkových informací o nabídce. Podporované hodnoty se zobrazují u nabídek na Zboží.cz. Informace o vybrané EXTRA_MESSSAGE musí být uvedena na vašem webu.

Texty (např. „Dárek zdarma“) se také zobrazují u dané nabídky ve Zboží inzerátech a Dynamickém banneru Skliku. Zároveň se ve Zboží inzerátech u nabídky zobrazí štítek „Akce“.

EXTRA_MESSAGE v produktovém detailu – zobrazujeme více výhod najednou.

 

Podporované hodnoty <EXTRA_MESSAGE>

Hodnota Text zobrazovaný na Zboží.cz
free_gift Dárek zdarma
extended_warranty Prodloužená záruka
voucher Voucher na další nákup
free_accessories Příslušenství zdarma
free_case Pouzdro zdarma
free_installation Montáž zdarma
extended_return Prodloužená doba na vrácení
free_return Vrácení s dopravou zdarma
premium_installation Odborná instalace spotřebiče
appliance_pickup Odvoz starého spotřebiče
authorized_service Autorizovaný servis
split_payment Možnost nákupu na splátky
pay_later Možnost odložené platby
gift_package Dárkové balení
custom Jiné
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)
  • 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ů.

Hodnota tagu Příklad volitelného textu
FREE_GIFT_TEXT Obal na mobilní telefon
FREE_ACCESSORIES_TEXT Originální síťový kabel kompatibilní s tímto zařízením
VOUCHER_TEXT 100 Kč na další nákup
CUSTOM_TEXT Výnos do patra, Věrnostní program

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

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

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

<PARAM_NAME>
povinné, název parametru
např. délka, objem, velikost, barva, určení

<VAL>
povinné, hodnota parametru
např. 110, 500, XXL, černé, dětské

<UNIT>
nepovinné, jednotka parametru
např. 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.

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

čí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,60 – 3,60 Kč bez DPH dle výše prodejní ceny. 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,60 až 1000 Kč.
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,60 – 3,60 Kč bez DPH dle výše prodejní ceny.
Minimální cena za proklik
Prodejní cena Cena za proklik
do 200 Kč 0,60 Kč
do 500 Kč 1,20 Kč
do 1 000 Kč 1,80 Kč
do 2 500 Kč 2,40 Kč
do 10 000 Kč 3,00 Kč
nad 10 000 Kč 3,60 Kč

 

Každoročně v období hlavní sezóny (od října do ledna) je cena za proklik účtovaná podle sezónního ceníku.

Prodejní cena Cena za proklik
do 200 Kč 0,75 Kč
do 500 Kč 1,50 Kč
do 1 000 Kč 2,40 Kč
do 2 500 Kč 3,30 Kč
do 10 000 Kč 4,15 Kč
nad 10 000 Kč 5 Kč

Poznámka: Pokud si e-shop nastaví maximální cenu za proklik, kterou je ochoten pro danou nabídku 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.

<MAX_CPC>23.50</MAX_CPC>

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

Maximální cena za proklik ve fulltextovém výsledku hledání a ve výpisu kategorie v Kč. Proklik uskutečněný ze Zboží.cz do internetového obchodu je zpoplatněn minimální cenou 0,60 – 3,60 Kč bez DPH dle výše prodejní ceny. 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,60 až 1000 Kč.
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,60 – 3,60 Kč bez DPH dle výše prodejní ceny.
Minimální cena za proklik
Prodejní cena Cena za proklik
do 200 Kč 0,60 Kč
do 500 Kč 1,20 Kč
do 1 000 Kč 1,80 Kč
do 2 500 Kč 2,40 Kč
do 10 000 Kč 3,00 Kč
nad 10 000 Kč 3,60 Kč

Každoročně v období hlavní sezóny (od října do ledna) je cena za proklik účtovaná podle sezónního ceníku.

Prodejní cena Cena za proklik
do 200 Kč 0,75 Kč
do 500 Kč 1,50 Kč
do 1 000 Kč 2,40 Kč
do 2 500 Kč 3,30 Kč
do 10 000 Kč 4,15 Kč
nad 10 000 Kč 5 Kč

Poznámka: Pokud si e-shop nastaví maximální cenu za proklik, kterou je ochoten pro danou nabídku 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.

 

<MAX_CPC_SEARCH>23.50</MAX_CPC_SEARCH>

možné uvést hodnotu 0 nebo 1

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

Pokud je nastaveno „0“ nabídka se ve Zboží.cz nebude zobrazovat. Pokud není uvedeno, nebo je uvedeno „1“, nabídka se ve Zboží.cz zobrazí.

Tag VISIBILITY nemá vliv na nabídky zobrazované v DRTG.

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 „Sortiment“ – „Doprava“ – vpravo 3 tečky – „Nastavení míst“ – „Identifikátor“. Zde naleznete přehled ID Firmy.cz, které se použije jako identifikátor do XML feedu.

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

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.

Např.
výrobce Henkel, značky Persil, Ariel, Perwoll
výrobce Coca-Cola, značky Coca-Cola, Fanta, Sprite, Kinley, Schweppes

maximálně 250 znaků

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 Dynamický banner a Dynamický retargeting na službě Sklik. Pro každou nabídku lze mít jeden <CUSTOM_LABEL_0><CUSTOM_LABEL_1>.

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

maximálně 25 znaků

Tato hodnota se zobrazuje uživatelům u dané nabídky v Dynamickém banneru a Dynamickém retargetingu Skliku. Na rozdíl od značek <CUSTOM_LABEL_0> a <CUSTOM_LABEL_1> s ní není možné filtrovat v produktových skupinách v Skliku.

Příklady hodnot
sleva, výprodej, novinka, bestseller, montáž zdarma, Řecko – Rhodos, zbývá 12 kusů, viz dynamický banner na službě Sklik.

Pro každou nabídku lze mít jeden <CUSTOM_LABEL_3>.

<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>
<CUSTOM_LABEL_3>Výprodej</CUSTOM_LABEL_3>
</SHOPITEM>

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.

Např.
Latitude
iPod | iPod Touch
ThinkPad | Edge

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>

XML feed bez povinných tagů není možné pro inzerci na Zboží.cz využít.

Všechny doporučené tagy zvyšují kvalitu vašeho XML feedu a tím i kvalitu vaší kampaně na Zboží.cz. Zároveň se zvýší pravděpodobnost zobrazení vašich nabídek ve výsledcích hledání.

Potřebujete další pomoc?

Pokud si stále nevíte rady, obraťte se na naše konzultanty.