XML specification

XML tags

Optional, to be specified only if you use an encoding other than UTF-8. Czech Windows typically saves files in windows-1250 encoding.

the exact wording is required

Specify with the parameter xmlns=“http://www.zbozi.cz/ns/offer/1.0″, which indicates that it is an XML feed created according to the current specification.

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

The following tags describe the properties of the item in your feed, added inside the element.

<SHOPITEM>
...
</SHOPITEM>

recommended length 70 characters, maximum 255 characters

General naming of the product from the consumer’s point of view, without additional data from the online retailer. It must contain all the necessary data to make the offer distinguishable from other offers in the XML feed by name and follow a uniform template differentiated for different product categories (see Offer naming rules). The basic template valid for most categories is:

Manufacturer (Product line) product model variant

Include the actual manufacturer of the part in the name headline, not the brand that your products are compatible with. You can include information about compatibility with certain brands in the ‚description‘ <DESCRIPTION> attribute.

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

recommended length 250-1024 characters

Text description of each offer in plain text format with paragraph indentation. It must only contain information about the product in the Czech language. The beginning of the description should summarize the main advantages of the product in a few sentences.

The description must not contain:

  • advertising texts and slogans promoting an online store
  • excessively repetitive keywords or phrases (twice or more in a row)

It is not desirable to repeat the name of the manufacturer or the model designation of the product in the description. Do not insert information related to free gifts, for which the EXTRA_MESSAGE tag is intended. Excessive punctuation, use of emoticons or ending sentences with three periods (…) are not allowed. Periods and commas must be followed by spaces, as is common in Czech texts.

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

URL address that links to the offer page in the online store.
The URL must not contain Czech diacritics, spaces and other non-standard characters.

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

numeric value, max. two decimal places

Final price in CZK including VAT and fees. If more than one decimal place is given, the excess decimal places will be cut off. Decimal points and commas may be used to separate the order of crowns and hellers.

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

whole number or date in the YYYY-MM-DD format

The order processing time must be stated as the time from receipt of the order to dispatch of the goods. The numerical value is automatically converted by the system into text. For pre-orders and upcoming products, please indicate the date of launch in YYYY-MM-DD format.

Supported values in the DELIVERY_DATE tag

Value 0 (in stock)
Permitted value on the online store website

  •  in stock
  •  in stock at the supplier, dispatches within 24 hours
  •  in stock in the dispatch warehouse, dispatches within 24 hours
  •  in stock at the store
  •  immediately (for collection)
  •  dispatches within 24 hours
  •  number of units > 0

Value 1-3 (within 3 days)
Permitted value on the online store website

  •  in stock (dispatches within 3 working days)
  •  usually in stock
  •  in stock at the supplier
  •  usually within 3 days
  •  1-3 days

Value 4-7 (within a week)
Permitted value on the online store website

  •  in stock, delivery within 4-7 working days
  •  within 7 days
  •  in stock (dispatches within one week)
  •  usually in stock
  •  usually dispatched within 7 days
  •  4-7 days
  •  within a week

Value 8 and more (in more than a week)
Permitted value on the online store website

  •  8 days or more
  •  to order
  •  within 30 days

Date in the YYYY-MM-DD format (in more than a week)
Permitted value on the online store website

  •  pre-order + launch date
  •  coming soon + launch date
  •  new launch + launch date

Value -1 (availability unknown)
Permitted value on the online store website

  • unknown

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

we recommend including the brand, which can be repeated

pre-owned goods offers must have a minimum image size of 800×600 px, i.e. even for portrait images the shorter side must be at least 800px

URL of the image that faithfully displays the product offer. The image must not include watermarks, store logos, advertising or other prominent graphic elements. The image can be in JPEG or PNG format, other formats are not supported. The recommended size of the image is at least 425×440 px (in the case of non-standard images, at least one of the dimensions must be respected). If you change the image without changing the IMGURL, the original image remains on Zboží.cz.

<IMGURL>http://example.com/obrazky/slunecniky/solartent123.jpg</IMGURL>

maximum length shown is 64 characters

The name of the offer, which must faithfully describe its nature. It must contain all the necessary information to make the offer name distinguishable from other offers in the XML feed. It can contain information that is specific to the store, e.g. „+ free gift“. It is essentially an extended PRODUCTNAME tag including attributes. This name will be used if the offer is not paired and will be displayed in the offers.

Include the actual manufacturer of the product in the name, not the brand that your products are compatible with. You can include information about compatibility with certain brands in the ‚description‘ attribute.

This field must not include:

  •  advertising slogans and superlatives (e.g. ‚cheapest deal‘)
  •  excessively repetitive keywords or phrases (twice or more in a row)
  •  excessive punctuation, emoticons, three periods (…) and exclamation marks
  •  information that is not directly related to the offer

The maximum display length is 64 characters, with spaces after periods and commas, as is common in Czech texts. Only one exclamation mark is allowed in the item name. The exclamation mark must not be preceded by a space.

The manufacturer of a specific product offer; it helps filter tags in a specific category. The conditions for creating a tag can be found in the section Brands on Zboží.cz.

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

On Zboží.cz we have a defined list of carriers and pick-up locations that we support. The carrier can also be the online store itself (we support only carriers that cover the whole territory of the Czech Republic). The online retailer can also present their own network of pick-up locations.

Supported values for pick-up locations

Name DELIVERY_ID
Balíkovna CESKA_POSTA_BALIKOVNA
Č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
WE|DO Uloženka WEDO_ULOZENKA
Zásilkovna ZASILKOVNA
Vlastní výdejní místa VLASTNI_VYDEJNI_MISTA

Supported values for carrier services

Name 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
WE|DO HOME WEDO_HOME
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 identifier of the carrier or network of pick-up locations from the list of those supported
DELIVERY_PRICE price including VAT for shipping or collecting the item when paying in advance
DELIVERY_PRICE_COD price incl. VAT for shipping or collecting the item when paying cash on delivery

You can only specify your own shipping if you can deliver the item to any location in the Czech Republic.

If cash on delivery is not possible for the offer, carrier or a pick-up point, the DELIVERY_PRICE_COD tag should not be included with the offer. Similarly, if the offer cannot be delivered to the pick-up point or by a specific carrier, the tag should not be included for that offer (e.g. oversized items).

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

mandatory for all pre-owned goods offers

Unique identifier (alphanumeric characters) of the offer in the online store, typically the item ID in the warehouse system, any combination of characters [0-9, a-z, A-Z, _ , -], i.e. the numbers zero to nine, upper and lower case letters without diacritics, as well as underscores and hyphens are allowed.

With this tag, you will always be able to uniquely identify an offer and track its history and performance on Zboží.cz, even if its URL or name changes. Therefore, it is crucial that it remains the same even if the offer name, XML feed and its URL or e-commerce solution changes.

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

maximum length 500 characters

We will only be able to include separate offers in the listing of the relevant category if they have a CATEGORYTEXT that matches the category name from our codebook.

The machine-readable category tree of Zboží.cz is continuously updated at https://www.zbozi.cz/static/categories.json or downloadable in MS Excel format at https://www.zbozi.cz/static/categories.csv. The complete category path from the Zboží.cz category tree must be entered in the feed. The vertical line | (pipe) is used as a separator.

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

can be repeated

Provides additional information about the offer. Supported values are displayed for offers on Zboží.cz. Information about the selected EXTRA_MESSAGE must be listed on your website.

Texts (e.g. „Free gift“) are also displayed for the offer in Product Ads and the Sklik Dynamic Banner.

EXTRA_MESSAGE in the product detail – we display 1 extra message.EXTRA_MESSAGE alongside separate offers – we display up to 2 extra messages.

Supported values  <EXTRA_MESSAGE>

Value Text displayed at 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

You can now add text to the selected EXTRA_MESSAGE, where you can indicate what the specific free gift or accessory is. Applies to the following values:

  • free gift (free_gift)
  • free accessories (free_accessories)
  • voucher for a future purchase (voucher)

FREE_GIFT_TEXT, FREE_ACCESSORIES_TEXT, VOUCHER_TEXT extends the EXTRA_MESSAGE with a text information limited to 160 characters to indicate what the specific gift or accessory is.

 Value Example of optional text
FREE_GIFT_TEXT Mobile phone case
FREE_ACCESSORIES_TEXT Original power cable compatible with this device
VOUCHER_TEXT CZK 100 redeemable against the next purchase

In order for a given EXTRA_MESSAGE with text information to be displayed on the website, the corresponding EXTRA_MESSAGE must be displayed in the feed. These are optional new tags. The maximum frequency is 1x.

The order of the extra message (which should be first, second …) is governed by the order of the tags in the XML feed.

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

GTIN, Global Trade Item Number

Eight-, twelve-, thirteen-, or fourteen-digit numbers without spaces are accepted.

The Global Trade Item Number GTIN (often incorrectly called EAN) is used to identify trade items internationally in the following formats:

GTIN-8 – 8 digits, encoded in EAN-8 barcode.
GTIN-13 – 13 digits, encoded in EAN-13 barcode.
GTIN-14 – 14 digits, encoded in ITF-14, GS1-128 or GS1 DataBar barcode.

In the USA and Canada, GTIN-12 (12 digits) is used for UPC-A and UPC-E barcodes.

The tool for calculating check numbers can be found here: https://www.gs1cz.org/vypocet-kontrolni-cislice

<EAN>8594061743744</EAN>

structured tag, can be repeated

Additional parameters that can be used to filter products on the Zboží.cz website.

The tag <PARAM> has the following sub-tags:

<PARAM_NAME>mandatory, parameter name

e.g. length, volume, size, colour, purpose

<VAL>mandatory, parameter namee.g. 110, 500, XXL, black, children’s

<UNIT>
optional, parameter unit
e.g. cm, ml, GB, MHz

Product parameters differentiated for each category can be downloaded in the CSV format (UTF-8 encoding) or 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>

mandatory for all adult offers

This tag is used for all adult offers.
If you want your adult offers to be displayed in adult categories, use the EROTIC tag with the value 1 and fill in the tag CATEGORYTEXT.

<EROTIC>1</EROTIC>

mandatory for all second-hand, open-box and refurbished offers (offers will be displayed on the service Sbazar)

new – new goods (optional tag)

open_box (original packaging not intact) – goods unpacked for the purpose of demonstration or photography for the online retailer or returned by a customer. The goods do not show any traces of use. All accessories are included. May not have original packaging. Minimum 24 month warranty.

used – goods returned by customers, goods with signs of use. Fully functional. Package contents may not be complete, but includes accessories necessary for operation. May have damaged or non-original packaging. Minimum 12 month warranty.

refurbished – professionally repaired or refurbished goods. It may have signs of use but is fully functional. Minimum 12 months warranty.

* In order to publish ads on Sbazar, it is mandatory to set up following tags: DELIVERY_DATE with the value 0, CONDITION_DESC and WARRANTY in the offer.

 

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

mandatory for all second-hand, open-box and refurbished offers

recommended length approximately 200 characters, maximum 2000 characters

Text description of the condition of the goods. This is not an offer description!

A brief description of the condition and any defects of the advertised offer, including the condition of the packaging or included accessories.

Example (must be written in Czech)

<CONDITION_DESC>Returned within 14 days. Cracked rear plastic cover of 
the vacuum cleaner,vacuum cleaner fragrance missing in the accessories. 
Original packaging material is slightly torn.</CONDITION_DESC>

mandatory for all second-hand, open-box and refurbished offers

The numerical value must reflect the number of months of warranty that the online retailer guarantees when the goods are purchased.

Lifetime guarantee: 999

Example:

<WARRANTY>12</WARRANTY>

The product designation given by the manufacturer (Manufacturer Part Number, MPN). This designation uniquely identifies the product to the manufacturer. Any combination of numbers and letters is acceptable.

<PRODUCTNO>MC234CZ/A</PRODUCTNO>
<PRODUCTNO>VGNNS31S/S.CEZ</PRODUCTNO>
<PRODUCTNO>60002456</PRODUCTNO>
<PRODUCTNO>8834A001AA</PRODUCTNO>

The international standard book number in ISBN-10 or ISBN-13 format. A ten or thirteen-digit number is acceptable, either without spaces, or a space or dash may be used as a group separator. However, separators may not be combined.

<ISBN>9781444102451</ISBN>
<ISBN>978-1-78038-067-4</ISBN>
<ISBN>978 1 86201 559 3</ISBN>

Indicates a group of offers which together represent model variants. A model variant is defined as all offers of products of the same manufacturer, series, name and price level, where one parameter differentiates them.

Example
Name Nordblanc Sprinter NBLC59 červený
Model 42

Exceptions are cases where the model variant link is set directly by the manufacturer or defined by the market approach to the segment.

Example
Name Apple iPhone 5S
Model 16 GB Stříbrný

Any combination of up to 36 characters [0-9, a-z, A-Z, _ , -], i.e. numbers zero to nine, upper and lower case letters without diacritics, underscores and hyphens is allowed to denote a group of model variant offers.

This tag is very important in the creation of model variants for individual offers and its introduction significantly contributes to the quality of the supplied data and the presentation of offers at the Zboží.cz platform. In the Clothing and Fashion section, the <ITEMGROUP_ID> tag can be used to merge groups of offers directly and thus contribute to a clearer view of the offers.

Example of XML feed structure when tagging variants with 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>

numeric value, max. two decimal places

Maximum price per click in product detail in CZK. A click from Zboží.cz to the online store is charged at a minimum price of CZK 0.50 – 3 excluding VAT depending on the sale price. A numerical value without spaces between lines is accepted; the decimal places (hellers) are separated with a decimal point or comma. The range of accepted values is from the interval CZK 0.50 – 500.

If the MAX_CPC tag is not specified in the offer or if the value is less than the price per click according to the sales price, the minimum price of CZK 0.50 – 3 excluding VAT will be charged for the click in the product detail according to the sale price.

Minimum price per click

Sale price Price per klik
up to 200 CZK 0,50 CZK
up to 500 CZK 1,00 CZK
up to 1 000 CZK 1,50 CZK
up to 2 500 CZK 2,00 CZK
up to 10 000 CZK 2,50 CZK
over 10 000 CZK 3,00 CZK

 

During the high season (from October to January), the CPC is annually charged according to the seasonal price list. For each click leading to the e-shop from the Zboží.cz service, a minimum price of CZK 0.60 – 3.60 excluding VAT is charged (following the sales price of the offer).

Note: If the online retailer sets a maximum price per click that it is willing to pay for a given offer in a product or full-text, the system will calculate the price per click that is necessary to maintain the position (second-price). If the customer uses the ranking from the lowest price offer, only the list price is charged.

<MAX_CPC>23.50</MAX_CPC>

numeric value, max. two decimal places

Maximum price per click in the full-text search result in CZK.

A click from Zboží.cz to the online store is charged at a minimum price of CZK 0.50 – 3 excluding VAT depending on the sale price. A numerical value without spaces between lines is accepted; the decimal places (hellers) are separated with a decimal point or comma. The range of accepted values is from the interval CZK 0.50 – 500.

If the MAX_CPC_SEARCH tag is not specified in the offer or if the value is less than the price per click according to the sales price, the minimum price of CZK 0.50 – 3 excluding VAT will be charged for the click in the product detail according to the sale price.

Minimum price per click
Sale price Price per klik
up to 200 CZK 0,50 CZK
up to 500 CZK 1,00 CZK
up to 1 000 CZK 1,50 CZK
up to 2 500 CZK 2,00 CZK
up to 10 000 CZK 2,50 CZK
over 10 000 CZK 3,00 CZK

During the high season (from October to January), the CPC is annually charged according to the seasonal price list. For each click leading to the e-shop from the Zboží.cz service, a minimum price of CZK 0.60 – 3.60 excluding VAT is charged (following the sales price of the offer).

Note: If the online retailer sets a maximum price per click that it is willing to pay for a given offer in a product or full-text, the system will calculate the price per click that is necessary to maintain the position (second-price). If the customer uses the ranking from the lowest price offer, only the list price is charged.

 

<MAX_CPC_SEARCH>23.50</MAX_CPC_SEARCH>

the value 0 or 1 can be entered

Option to exclude a specific offer from being displayed by Zboží.cz.

If set to „0“ the offer will not be displayed on Zboží.cz. If it is not set, or if it is set to „1“, the offer will be displayed on Zboží.cz.

can be repeated

Identifier of the location where the offer is in stock for immediate personal collection. It must be possible to inspect, test and, if necessary, claim the product at such a collection point. If the identifier is filled in and the DELIVERY_DATE tag is set to 0 (in stock), it can be found on the Zboží.cz website using the „In store“ (Na prodejně) filter.

The identifier of the collection location is the ID from Firmy.cz. In the administration of Zboží.cz, in the tab „Store“ (Provozovna) and then „Collection locations“ (Výdejní místa), there is an overview of the ID from Firmy.cz, which is used as an identifier in the XML feed.

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

Brand name.

This tag is used in the XML feed for specific cases of brand licensing (Hello Kitty, Star Wars) or separate brands of one manufacturer.

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

maximum length 250 characters

It attaches any text to a group of selected offers and groups them (e.g. by sales, season, discount…). This tag is used to filter offers for product ads on Sklik. For each offer you can have one <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>

maximum 25 characters

This value is displayed to the users for the given offer in the Dynamic Banner in Sklik. Unlike the tags  <CUSTOM_LABEL_0> and <CUSTOM_LABEL_1> this tag does not allow for filtering in Sklik product groups.

Examples of values
discount, sale, new, bestseller, free installation, Greece – Rhodes, 12 pieces left, see Dynamic Banner in Sklik.

For each offer you can have one <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>

used for building the product database; individual parts are separated by pipe |

Product range and sub-range defined according to the manufacturer. Typically, it is a family of products that the manufacturer has grouped under a single name.

Example
Latitude
iPod | iPod Touch
ThinkPad | Edge

to be used for product database building; numeric value, max. two decimal places

MSRP – manufacturer’s suggested retail price in CZK including VAT and fees is used.

This value may also appear as a strikethrough (original price) in the Dynamic Banner or a percentage discount will be calculated from it in the Dynamic Banner. For both cases, it will only be used if it is at least 1% higher than the value.

Date of official launch of the product in the Czech Republic. It is given in the format YYYY-MM-DDTHH:MM:SS; if the time is not specified, midnight is taken as a default time.

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

XML without mandatory tags cannot be used to advertise on Zboží.cz.

All the recommended tags will increase the quality of your XML feed and also the quality of your campaign on Zboží.cz. It will also increase the likelihood of your offers showing up in search results.

Potřebujete další pomoc?

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