1. FAVI help page
  2. XML feed requirements
  3. Meanings and requirements for individual elements

Meanings and requirements for individual elements


IDENTIFICATION NUMBER (ID) *

The ID is a unique designation for each product in the e-shop system. The designation is may not be changed during the period of cooperation, otherwise, the product history and position may be lost.

In the event that multiple products have the same ITEM_ID, the XML feed will be considered faulty and the update will not work.

The element can contain numbers, lowercase and uppercase letters without diacritics, and special characters such as dashes and underscores. 

Required for each product.

Examples depend on which XML feed which you use on FAVI:

XML feed specification Element
Heureka/Zboží <ITEM_ID>abc987</ITEM_ID>
Google <g:id>abc987</g:id>
Compari/Árukereső: <Identifier>abc987</Identifier>
Ceneo id=“abc987

DESIGNATION OF VARIANTS

Designation of group product variants. Products that are different variations of a single product have a unique ITEM_ID but the same ITEMGROUP_ID.

Recommended for each product.

Examples depend on which XML feed which you use on FAVI:

XML feed specification Element
Heureka/Zboží <ITEMGROUP_ID>ZD563</ITEMGROUP_ID>
Google  <g:item_group_id>ZD563</g:item_group_id>
Compari/Árukereső: <GroupId>ZD563</GroupId>
Ceneo not specified in Ceneo specification

NAME OF A PRODUCT *

Exact product name. The name identifies the product and helps to list it properly in the catalog. The product name should be clear and descriptive. It is not appropriate to use a single-word name, such as a generic name of a collection or edition. 

Required for each product. 

Examples depend on which XML feed which you use on FAVI:

XML feed specification Element

Heureka/Zboží

<PRODUCTNAME>MERIDA double bed, 160×200 cm</PRODUCTNAME>
Google  <title>MERIDA double bed, 160×200 cm</title>
Compari/Árukereső <Name>MERIDA double bed, 160×200 cm</Name>
Ceneo <name>MERIDA double bed, 160×200 cm</name>

PRODUCT DESCRIPTION *

Product description. The description should include information about the specific product variant. We welcome the use of relevant keywords that help to list your products in filters. The product description should be descriptive and full of information that motivates customers to make a purchase.

It is better to create an unformatted product description, as your coding will be retained in the FAVI catalog. It is not allowed to include URLs to another page of your shop, email addresses, and general contact information.

On the product detail page in the FAVI catalogue, you can check what the description of a particular product should look like. In general, the FAVI system allows only for the following html codes:

  • <p> </p>, 
  • <b> </b>,
  • <strong> </strong>,
  • <i> </i>,
  • <em> </em>, 
  • <br>, 
  • <ul> </ul>,
  • <li> </li>,
  • <ol> </ol>.

Other codes and formats are not supported. Using them can destroy the text and reduce its quality. Take care also when encoding a special character if it is needed. For example, the ampersand symbol (&) must be encoded with the ASCII string &lt;li&gt if you do not use CDATA for sending information.  

Required for each product. 

Examples depend on which XML feed which you use on FAVI:

XML feed specification

Element

Heureka/Zboží

<DESCRIPTION>Modern bed is made from …</DESCRIPTION>
Google <g:description>Modern bed is made from …</g:description>

Compari/Árukereső

<Description>Modern bed is made from…</Description>

Ceneo

<desc><![CDATA[Modern bed is made from …]]></desc>


PRODUCT CATEGORY *

Product category. The category primarily determines the classification of the product in the catalog and should be specified as accurately as possible. It is permitted to send categories according to the FAVI category tree, or you can also specify your own categories if they are sufficiently detailed. It is best to always categorize the entire product path – for example, Bedroom>Beds. 

Complete category tree for all countries are available here:

The FAVI catalog will automatically load all products that are listed in the XML feed provided it includes an appropriate category, a valid link and an adequately sized image.

For each product, the category element should only be mentioned once in the XML feed. If the product does not have a category, it will not load into the catalog.

The following categories will also be rejected for import:

  • categories not applicable to the catalog
  • very general categories (such as discounts, sales, promotions, names of rooms etc.)
  • categories that are not in the appropriate language.

Categories should not be changed frequently. Changing categories will remove products from the catalog until newly submitted categories are re-approved.

Required for each product. 

Examples depend on which XML feed which you use on FAVI:

XML feed specification

Element

Heureka/Zboží

<CATEGORYTEXT>Bedrooms > Beds</CATEGORYTEXT>

Google **

<g:google_product_category>Bedrooms> Beds</g:google_product_category>

<g:product_type>Bedrooms > Beds > single</g:product_type>

Compari/Árukereső

<Category>Bedrooms > Beds</Category>

Ceneo

<cat>
<![CDATA[Bedrooms > Beds]]>
</cat>


PRODUCT PRICE (VAT INCLUDED) *

Total product price including VAT (value-added tax). The FAVI system accepts prices only in the following formats: 

  • 8 000
  • 8000
  • 8000,70
  • 8000.70

Please do not use a dot to separate thousands and millions. The dot may only be used as a decimal separator. The FAVI system automatically rounds the number to two decimal places.

Discounts for products in the FAVI catalog are automatically generated by the system based on the stored base price history. If the price in the XML feed is reduced, the price of the product on FAVI will also be reduced and the amount of the discount will be calculated. Therefore, we do not receive information about discounts from any special entry in the XML feed. 

Required for each product.

Examples depend on which XML feed which you use on FAVI:

XML fee specification

Element
Heureka/Zboží <PRICE_VAT>4500</PRICE_VAT>
Google 

<g:price>5500</g:price>
for product in sale: <g:sale_price>4500</g:sale_price>

Compari/Árukereső: <Price>4500</Price>
Ceneo price=“4500″

URL *

The URL specifies a link to the product website of your e-shop. The product landing page must include the product price, specific information about the product, and a button to purchase or order the product. The URL must be unique within the XML feed, otherwise, products with the same link will be merged.

The URL must be valid, no spaces or diacritics are allowed, and special characters must be used in a specific HTML form, otherwise, the products will not be uploaded to the catalog.

Required for each product.

Examples depend on which XML feed which you use on FAVI:

XML feed specification Element
Heureka/Zboží <URL>https://www.url.com/bed-merida.html#/90x200_cm</URL>
Google <link>https://www.url.com/bed-merida.html#/90x200_cm</link>
Compari/Árukereső: <Product_url>https://www.url.com/bed-merida.html#/90x200_cm</Product_url>
Ceneo

url=“https://www.url.com/bed-merida.html#/90x200_cm″


MAIN PICTURE *

The main product image, as one of the most important aspects of the XML feed, must meet the following criteria:

1) The product in the main picture must not conflict with its specification – that is, with its name or description. This applies in particular to cases where the image of the product with respect to its specification is:

  • in a different decor or color (a chair in beech decor should not have a chair in walnut decor in the picture),
  • in a different size (a sticker measuring 25 x 25 cm should not be shown in the picture over the entire wall, etc.)
  • displayed with more products than it is available for the product price (e.g. displaying the whole bedroom set when the given price includes only a wardrobe; or displaying a whole set including a table with chairs when the given price includes only a table; or displaying the product in a different color) The picture should display only the number of items sold in the set (e.g. a set of two chairs should not include more than two chairs in the image). Alternatively, the use of a number to indicate the number of identical products in one package (set) will be tolerated (e.g. it is permitted to display an image with one chair with the number ‘2’ in the corner to indicate that the set contains two chairs). However, the digits must not cover the product or be otherwise distracting: for this reason, it is best to place the number in the corner of the picture).
  • 2) The product in the main image must be represented by a real photograph: it is not permitted to use a sketch or illustration.

3) The main image must be at least 600 x 600 px. However, it is recommended to send the largest possible size, ideally over 1000 x 1000 px.

4) The product in the main image must be shown in its entirety and therefore not only a certain part or detail.

5) It is permitted to display the product against a white background. If the product is embedded in an interior setting, the product must be prominent enough in the picture so that the customer knows at a first glance which product it is.

6) The main image must not contain any additional text or other graphical modifications (icons, watermarks, logos, 1 + 1 markings, discounts, bows etc.).

7) When displaying colour variants, the main image must not be just a colored square. Each image of a colour variant must display the actual product.

8) It is not permitted to embed the image in a border.

If an image does not meet the above criteria, it may be blocked from display. All additional pictures that are available (drawings, details, interior and composition photos) should be sent as alternative pictures, which will be displayed directly on the product detail page in the FAVI catalog.

If the product is blocked from display as a result of non-compliance with any of the above image listing criteria and the system later detects an image modification, the image will be re-assessed and the product may be returned to the catalog. However, to change the image, you must also change the URL in the XML feed. A new image will only be loaded if the system detects a URL change. If no change is made, the original image is retained.

The URL for the main (and alternative) product image must meet the following conditions:

  • Image URL must not contain spaces. The space should be replaced manually by the “%20” sign: our system does not replace it automatically.
  • Image URL must not contain accents or diacritics.
  • Image URL must not be blocked. If the FAVI system is not allowed to download the image due to a URL block by the server, the product will not be loaded into the catalog.

It should be taken into account that if the image is updated for the loaded product and its new URL is unavailable (blocked, with spaces or accents), the product will be deactivated within the catalog.

Required for each product.

Examples depends on specification of XML feed which you use on FAVI:

XML feed specification Element
Heureka/Zboží <IMGURL>https://www.url.com/bed-merida.jpg</IMGURL>
Google <g:image_link>https://www.url.com/bed-merida.jpg</g:image_link>
Compari/Árukereső: <Image_url>https://www.url.com/bed-merida.jpg</Image_url>
Ceneo <imgs><main url=“https://www.url.com/bed-merida.jpg“/></imgs>

ALTERNATIVE PICTURES

The URL for alternative product images. Other provided images are shown on the product detail page. The maximum number of images is 20. 

In alternative images, it is appropriate to provide:

  • photos of the product inside a room,
  • photos of the product alongside other products (e.g. from the same collection),
  • the product from different angles,
  • more detailed images of particular parts of the product,
  • sketches showing the dimensions, etc.

Recommended for each product.

Examples depend on which XML feed which you use on FAVI:

XML feed specification Element
Heureka/Zboží <IMGURL_ALTERNATIVE>https://www.url.com/bed-merida2.jpg</IMGURL_ALTERNATIVE>
Google  <g:additional_image_link>https://www.url.com/bed-merida2.jpg<g:additional_image_link>
Compari/Árukereső: <Image_url_2>https://www.url.com/bed-merida2.jpg</Image_url_2>
Ceneo

<imgs><i url=“https://www.url.com/bed-merida2.jpg“/></imgs>


PARAMETERS

Product parameters. The information provided in the form of parameters is shown in the table on the product detail page. If you send more parameters for your products, your campaign will likely be more successful. In particular, please provide product specifications that are not obviously visible from the picture.

Highly recommended parameters include: 

  • material,
  • shape,
  • pattern,
  • texture,
  • color, 
  • decor, 
  • style, 
  • dimensions,
  • other product-specific characteristics which might be important.

Specifying the parameters is highly recommended.

Examples depend on which XML feed which you use on FAVI:

XML feed specification Element
Heureka/Zboží  <PARAM>
  <PARAM_NAME>Height</PARAM_NAME>
  <VAL>95 cm</VAL>
</PARAM>
Google

<g:color>brown</g:color>
<g:material>solid wood, beech</g:material>
<g:pattern>striped</g:pattern>

<g:product_detail>
   <g:section_name>Size</g:section_name>
   <g:attribute_name>Height</g:attribute_name>
   <g:attribute_value>95 cm</g:attribute_value>
</g:product_detail>

Compari/Árukereső:

<Attributes>
  <Attribute>
    <Attribute_name>Height</Attribute_name>
    <Attribute_value>95 cm</Attribute_value>
  </Attribute>
</Attributes>

Ceneo

<attrs>
   <a name=“Height“>
     <95 cm>
   </a>
</attrs>


PRODUCT AVAILABILITY *

Timing of the shipment of the product (measured in days) from receipt of payment (in the case of advance payment), or from receipt of the order (in the case of payment on delivery).

Stock products in the catalog are marked products, which contain the following:

  • DELIVERY_DATE value 0, 1, 2 or 3 (Heureka/Zboží)
  • Delivery_Time value 0, 1, 2 or 3 (Compari/Árukereső) 
  • “in stock” element availability (Google)
  •  avail value 0, 1, 2 or 3 (Ceneo) 

Values other than these will be reflected in the total ranking of the product, so it is definitely recommended to specify a delivery date. However, it is also necessary that the specified value for the delivery time corresponds to the delivery time which is stated in your e-shop, as it is seen after clicking the link from FAVI. 

Required for each product. 

Examples depend on which XML feed which you use on FAVI:

XML feed specification Element
Heureka/Zboží <DELIVERY_DATE>0</DELIVERY_DATE> **
Google <g:availability>in stock</g:availability>
Compari/Árukereső: <Delivery_Time>0</Delivery_Time> **
Ceneo avail=“1″ **

** In elements DELIVERY_DATE, Delivery_Time an avail fill one number not a range of values.


DELIVERY OPTIONS

Product delivery options specification. There can be multiple delivery methods per product. A free shipping label will be displayed for a product if one of the valid shipping options is with price 0. 

Highly recommended for each product.

Examples depend on which XML feed which you use on FAVI:

XML feed specification Element
Heureka/Zboží <DELIVERY>
   <DELIVERY_ID>PPL</DELIVERY_ID>
   <DELIVERY_PRICE>0</DELIVERY_PRICE>
   <DELIVERY_PRICE_COD>20</DELIVERY_PRICE_COD>
</DELIVERY>
Google  <g:shipping>
    <g:price>0 CZK</g:price>
</g:shipping>
Compari/Árukereső:

<Delivery_Cost>FREE</Delivery_Cost>

or the following designation: gratuit, gratis, fara cost, ingyenes; ingyen, ingyenesen.

Ceneo not specified

MANUFACTURER

Specifies the manufacturer of the product.

Highly recommended for each product.

Examples depend on which XML feed which you use on FAVI:

XML feed specification Element
Heureka/Zboží <MANUFACTURER>Joinery XYZ</MANUFACTURER>
Google  <g:brand>Joinery XYZ</g:brand>
Compari/Árukereső: <Manufacturer>Joinery XYZ</Manufacturer>
Ceneo <attrs>
   <a name=“Manufacturer“>
     <![CDATA[Joinery XYZ]]>
    </a>
</attrs>

 

* indicates a required element