Struktura XML feedu Tobor.cz - srovnávač cen zboží

Tobor

Tobor XML-feed specification

XML-feed contain information about products from your e-shop. Make sure that the feed would contain relevant information about the products. Our robot periodically request the feed for refresh products prices and status. Usually XML-feed is generated programmatically. We also support Heureka.cz and Zbozi.cz formats.

If you are not sure how to obtain the XML feed, discuss with your webmaster or contact the supplier of the platform of your e-shop.

You can validate the feed here. Place the final valid version of your file on your website and send the link to Tobor, for example: http://example.com/tobor.xml

Products feed example

<?xml version="1.0" encoding="utf-8"?>
<SHOP>
	<SHOPITEM>
		<ITEM_ID>4550</ITEM_ID>
		<PRODUCTNAME>Xiaomi Redmi 3 2GB/16GB</PRODUCTNAME>
		<PRODUCT>Xiaomi Redmi 3 2GB/16GB + pouzdro zdarma</PRODUCT>
		<DESCRIPTION>Xiaomi Redmi 3, Wholesale Various High Quality Xiaomi Redmi 3 Products from Global Xiaomi Redmi 3 Suppliers and Xiaomi Redmi 3 Factory.</DESCRIPTION>
		<URL>http://www.vasobchod.cz/mobily/samsung-galaxy-s4-mini</URL>
		<IMGURL>http://example.com/images/xiaomi-rermi-3-logo.jpg</IMGURL>
		<IMGURL_ALTERNATIVE>http://example.com/images/xiaomi-rermi-3-1.jpg</IMGURL_ALTERNATIVE>
		<IMGURL_ALTERNATIVE>http://example.com/images/xiaomi-rermi-3-2.jpg</IMGURL_ALTERNATIVE>
		<PRICE_VAT>3629</PRICE_VAT>
		<MAX_CPC>4,5</MAX_CPC>
		<MANUFACTURER>Xiaomi</MANUFACTURER>
		<CATEGORYTEXT>Elektronika | Mobilní telefony</CATEGORYTEXT>
		<EAN>6954176857941</EAN>
		<PRODUCTNO>Redmi 3</PRODUCTNO>
		<PARAM>
			<PARAM_NAME>Hmotnost</PARAM_NAME>
			<VAL>144g</VAL>
		</PARAM>
		<PARAM>
			<PARAM_NAME>Colour</PARAM_NAME>
			<VAL>black</VAL>
		</PARAM>
		<DELIVERY_DATE>0</DELIVERY_DATE>
		<DELIVERY>
			<DELIVERY_ID>CESKA_POSTA</DELIVERY_ID>
			<DELIVERY_PRICE>129</DELIVERY_PRICE>
			<DELIVERY_PRICE_COD>129</DELIVERY_PRICE_COD>
		</DELIVERY>
		<DELIVERY>
			<DELIVERY_ID>VLASTNI_PREPRAVA</DELIVERY_ID>
			<DELIVERY_PRICE>0</DELIVERY_PRICE>
			<DELIVERY_PRICE_COD>0</DELIVERY_PRICE_COD>
		</DELIVERY>
		<ITEMGROUP_ID>G476</ITEMGROUP_ID>
	</SHOPITEM>
	<SHOPITEM>
	...
	</SHOPITEM>
</SHOP>

File requirements

Save the file in UTF-8 coding otherwise set right encoding attribute <?xml version="1.0" encoding="windows-1250"?>;
Divide huge file on parts if your feed is larger than 256Mb. In this case send each file link separately;
Optionally, send "Last-modified" HTTP header for prevent extra requests to the file;

Elements

<SHOP> ^require

The root element in the feed, included only once

Is require	Yes
Allow multiple	No
Example	<?xml version="1.0" encoding="utf-8"?> <SHOP> ... </SHOP>

<SHOPITEM> ^require

Element is cover for tags below. Repeat it for each item.

Is require

Yes

Allow multiple

Yes

Example

<SHOP>
	<SHOPITEM>
		<PRODUCTNAME>SONY Playstation 3 320GB</PRODUCTNAME>
		<!--... -->
	</SHOPITEM>
	<SHOPITEM>
		<PRODUCTNAME>Slunečník Solartent premium Beige</PRODUCTNAME>
		<!--... -->
	</SHOPITEM>
	<!--... -->
</SHOP>

<ITEM_ID> ^require

Unique identifier of a product within a shop.

Is require	Yes
Allow multiple	No
Requirements	Allow only alpha-numeric characters. Maximum 18 chars, otherwise ID will be replaced
Example	<ITEM_ID>JK506</ITEM_ID>

<PRODUCTNAME> ^require

Product name. Can contain brand, model name, colour, size, material, dimensions/size. Do not use noise phrases, such us: "New arrival", "Free shipping", "Hot sale", "+ gift"

Is require	Yes
Allow multiple	No
Requirements	Up to 255 chars
Example	<PRODUCTNAME>Úložný box Reisenthel Storagebox S černý</PRODUCTNAME>

Recommendations:

Categories type	Name criteria
Tires	Manufacturer + Series + Sizes + Diameter + Indexy
Car seats	Manufacturer + Series + Product number / Mark + Colour + Class
Mobile Phones	Manufacturer + Series + Product number / Mark + Colour
Notebooks	Manufacturer + Series + Product number / Mark + Model specifications
Digital cameras	Manufacturer + Series + Product number / Mark + Colour
Televisions	Manufacturer + Series + Product number / Mark
PC components	Manufacturer + Series + Product number / Mark + Standard
Battery	Manufacturer + Series + Product number / Mark + Amount + Specifying / Type + Original
Satellite sets	Manufacturer + Series + Version + Incomplete + Card
Toners	Manufacturer + Product number / Mark + Compatible
Home appliances	Manufacturer + Product number / Mark + Colour
Lego	Manufacturer + Series + Product number / Mark
Table games	Manufacturer + Series + Version
Toys	Manufacturer + Series \|Product code + Colour
Bicycles	Manufacturer + Series + Product number / Mark + Colour + Size + Class
Roller skates	Manufacturer + Series + Colour + Class
Downhill skis	Manufacturer + Series + Length / Curvature + Class
Sports nutrition	Manufacturer + Series + Amount + Flavor
Clothes	Manufacturer + Series + Colour + Specifying / Type + Size
Books	Title + Autor
Game console	Name + Version
Calendars	Series + Specifying / Type + Class
Perfume	Manufacturer + Series + Amount + Specifying / Type
Contact lenses	Manufacturer + Series + Amount + Diopter + Diameter + Curvature
Beauty creams etc.	Manufacturer + Series + Skin type + Specifying + Amount
Backpacks	Manufacturer + Series + Colour + Volume
Handbags	Manufacturer + Series + Colour + Standard
Beds	Manufacturer + Series + Colour + Dimensions / Size
Sofas	Manufacturer + Series + Colour + Specifying / Type + Dimensions / Size + Version
Bedding	Manufacturer + Series + Dimensions / Size + Standard + Material
Bathtubs	Manufacturer + Series + Product number / Mark + Length + Orientation
Tablecloths	Manufacturer + Series + Colour + Dimensions / Size
Carpets	Manufacturer + Series + Specifying / Type + Standard + Dimensions
Chests	Manufacturer + Series + Colour + Dimensions / Size + Material
Feed	Manufacturer + Series + Amount + Flavor
Guides for dogs	Manufacturer + Series + Product number / Mark + Colour + Dimensions / Size
Strollers	Manufacturer + Series + Colour + Class + Version
Wraps	Manufacturer + Series + Colour
Coffee	Manufacturer + Amount
Wine	Manufacturer + Series + Amount + Specifying / Type + Class
Grinding machines	Manufacturer + Product number / Mark
Saws	Manufacturer + Product number / Mark
E-cigarettes	Manufacturer + Series + Kapacita + Colour + Number of pieces
LED Strips	Manufacturer + Species + Length + Number of diodes + Watt
Cleaning products	Manufacturer + Product code + Amount
Means of health	Manufacturer + Series + Amount
Food	Manufacturer + Series + Amount + Flavor
Puzzle	Manufacturer + Series + Number of pieces
E-liquidy	Manufacturer + Series + Flavor + Volume
Bags NTB	Manufacturer + Product number + Diagonal + Colour
Cases for mobile phones	Manufacturer + Product number + Colour

<PRODUCT>

Contain PRODUCTNAME + extended information. For example: "... + 16gb memory card as a gift", "... free servicing"

Is require	No
Allow multiple	No
Requirements	In sum up to 255 chars
Example	<PRODUCT>Xiaomi Redmi 3 2GB/16GB + pouzdro zdarma</PRODUCT>

<DESCRIPTION>

Products description, allow only div, p, h4, ul, li, strong, table, tr, th, td, br tags. For line spacing use Enter. Please, do not list products parameters and images inside. Use specified below tag <PARAM> and <IMGURL_ALTERNATIVE> for this purposes.

Is require	No
Allow multiple	No
Requirements	Up to 2000 chars
Example	<DESCRIPTION>Text</DESCRIPTION>

<URL> ^require

Link to product page. Url must be unique within the feed. Do not use filters parameters in URL. Disallow use third-side domains for redirection. Images wider then 716px will be resized.

Is require	Yes
Allow multiple	No
Requirements	Up to 255 chars
Example	<URL>http://www.vasobchod.cz/mobily/samsung-galaxy-s4-mini</URL>

<IMGURL> ^require

Logotype url. Images wider then 716px will be resized.

Is require	Yes
Allow multiple	No
Requirements	In sum up to 255 chars
Example	<IMGURL>http://example.com/images/xiaomi-rermi-3-logo.jpg</IMGURL>

<IMGURL_ALTERNATIVE>

Addition images. Each image url must be covered in this tag.

Is require	No
Allow multiple	Yes
Example	<IMGURL_ALTERNATIVE>http://example.com/images/xiaomi-rermi-3-1.jpg</IMGURL_ALTERNATIVE> <IMGURL_ALTERNATIVE>http://example.com/images/xiaomi-rermi-3-2.jpg</IMGURL_ALTERNATIVE>

<PRICE_VAT> ^require

Final price in CZK included VAT and fees.

Is require	Yes
Allow multiple	No
Requirements	Maximum 2 decimal places. The surplus decimals will be eliminated.
Example	<PRICE_VAT>3629</PRICE_VAT>, <PRICE_VAT>12.55</PRICE_VAT>, <PRICE_VAT>46,55</PRICE_VAT>

<MAX_CPC>

Maximum price you are offer per click

Is require	No
Allow multiple	No
Requirements	Maximum 2 decimal places. The surplus decimals will be eliminated.
Example	<MAX_CPC>4.5</MAX_CPC>

<MANUFACTURER>

Manufacturer of offer.

Is require	No
Allow multiple	No
Requirements
Example	<MANUFACTURER>Bosch</MANUFACTURER>

<CATEGORYTEXT> ^require

Categories chain, from main category to subcategory. For faster recognizing show good categorized path (categories chain) to product. Recommends that CATEGORYTEXT match a name of the our categories

Is require	Yes
Allow multiple	No
Requirements	Up to 400 chars
Example	<CATEGORYTEXT>Oblečení a móda \| Obuv \| Pánské boty</CATEGORYTEXT>

<EAN>

EAN Code (Barcode) is used for identify goods. We allow EAN-13 and EAN-8 formats. Products with EAN have higher priority on system.

Is require	No
Allow multiple	No
Requirements	Up to 13 digits
Example	<EAN>6954176857941</EAN>

<ISBN>

The International Standard Book Number (ISBN) is a unique numeric commercial book identifier.

Is require	No
Allow multiple	No
Requirements	Up to 17 chars
Example	<ISBN>978-3-16-148410-0</ISBN>

<PRODUCTNO>

Manufacturer Part Number, MPN or model name. Products with <PRODUCTNO> have higher priority on system.

Is require	No
Allow multiple	No
Requirements	Up to 51 chars
Example	<PRODUCTNO>S600</PRODUCTNO>, <PRODUCTNO>AS368CZ/B</PRODUCTNO>

<PARAM>

Product parameters. Products with empty parameters may not displayed in filters. Recommender parameters are: "colour", "size", "material", "dimensions", "size". All parameters will be displayed in your order. Products with parameters have higher priority on system.

Is require	No
Allow multiple	Yes
Requirements
Example	<PARAM> <PARAM_NAME>Hmotnost</PARAM_NAME> <VAL>144g</VAL> </PARAM> <PARAM> <PARAM_NAME>Colour</PARAM_NAME> <VAL>black</VAL> </PARAM>

PARAM_NAME: Parameters name, up to 51 length

VAL: Value, up to 128 length

<DELIVERY_DATE>

Products status, dispatch time

Is require	No
Allow multiple	No
Requirements	Digits from -1 to 120
Example	<DELIVERY_DATE>0</DELIVERY_DATE>

0: Product in stock, ready to dispatch in 24 hours in working day

1-120: Approximately days from payment to dispatch product

-1: Product out of stock

<DELIVERY>

Is require	No
Allow multiple	Yes
Requirements
Example	<DELIVERY> <DELIVERY_ID>CESKA_POSTA</DELIVERY_ID> <DELIVERY_PRICE>129</DELIVERY_PRICE> <DELIVERY_PRICE_COD>129</DELIVERY_PRICE_COD> </DELIVERY> <DELIVERY> <DELIVERY_ID>VLASTNI_PREPRAVA</DELIVERY_ID> <DELIVERY_PRICE>0</DELIVERY_PRICE> <DELIVERY_PRICE_COD>0</DELIVERY_PRICE_COD> </DELIVERY>

DELIVERY_ID: Carrier code

DELIVERY_PRICE: celková cena (vč. DPH) konkrétního způsobu dodání pro tento produkt při platbě předem

DELIVERY_PRICE_COD: celková cena (vč. DPH) konkrétního způsobu dodání pro tento produkt včetně doběrečného. Pokud je cena dopravy s doběrečným stejná jako běžná cena, tak cenu v tomto tagu zopakujte. Není-li možné zboží doručit tímto dopravcem na dobírku, tag neuvádějte

Carrier	Code for <DELIVERY_ID>
Vlastní přeprava	VLASTNI_PREPRAVA
Česká pošta - Do ruky	CESKA_POSTA
Česká pošta - Na poštu	CESKA_POSTA_NA_POSTU
ČSAD Logistik Ostrava	CSAD_LOGISTIK_OSTRAVA
DPD	DPD
DHL	DHL
DSV	DSV
FOFR	FOFR
Gebrüder Weiss	GEBRUDER_WEISS
Geis	GEIS
GLS	GLS
HDS	HDS
InTime	INTIME
PPL	PPL
Seegmuller	SEEGMULLER
TNT	TNT
TOPTRANS	TOPTRANS
UPS	UPS
FedEX	FEDEX
Raben Logistics	RABEN_LOGISTICS

<ITEMGROUP_ID>

Marking of products that represent the different options (size, color, ...)

Is require	No
Allow multiple	No
Requirements	String, up to 51 length
Example	<ITEMGROUP_ID>G476</ITEMGROUP_ID>

Specifikace XML souboru