Specifications

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

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

we recommend to include, the mark can be repeated

Additional URLs of images that faithfully display the offer. Images marked as such are taken as additional and will be displayed on the offer detail and will also be used for product cards.

The image can be in JPEG or PNG format, other formats are not supported. The recommended image size is at least 425×440 px (in case of non-standard images you need to keep at least 1 of the dimensions), as with IMGURL. If you change the image without changing IMGURL_ALTERNATIVE, the original image remains on Zboží.cz.

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

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

Supported values for carrier services

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>

numeric value, max. two decimal places

The lowest price for the last 30 days before the start of the discount in CZK including VAT and fees. If more than one decimal place is given, the excess decimal places will be cut off. A decimal point and a full stop may be used to separate the order of crowns and pennies.

Terms, to view discount information:

• the sales (discounted) <PRICE_VAT> is entered correctly
• the price in the promotion is lower than the lowest selling price in the last 30 days before the start of the promotion
• the discount is not older than 30 days
• the amount of discount is in the range of 5% – 90%

The discount information will be displayed in the product details as well as for the respective offer in the Product Listings.

<PRICE_BEFORE_DISCOUNT>5786</PRICE_BEFORE_DISCOUNT><PRICE_BEFORE_DISCOUNT>5786.90</PRICE_BEFORE_DISCOUNT><PRICE_BEFORE_DISCOUNT>5786.35</PRICE_BEFORE_DISCOUNT>

maximum length 500 characters

<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

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

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