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

      Meanings and requirements for individual elements

      Required elements:

      IDENTIFICATION NUMBER (ID)*  |  NAME OF A PRODUCT* |  PRODUCT DESCRIPTION* |  PRODUCT CATEGORY*  |  PRODUCT PRICE* |  URL* |  MAIN PICTURE* |  PRODUCT AVAILABILITY*

      Recommended elements:

      DESIGNATION OF VARIANTS  |   ALTERNATIVE PICTURES |   PARAMETERS  |  DELIVERY OPTIONS | GTIN (EAN) | MANUFACTURER

      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.

      XML feed specification Element
      Heureka/Zboží <ITEM_ID>abc987</ITEM_ID>
      Google <g:id>abc987</g:id>
      Compari/Árukereső/Pazaruvaj <Identifier>abc987</Identifier>
      Ceneo id="abc987"
      Jeftinije/Ceneje <![CDATA[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.

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

      NAME OF A PRODUCT *

      Exact product name. For correct inclusion in the catalog, the product name must be sufficiently descriptive. It is not appropriate to indicate a one-word product name, e.g. the name of a collection or edition.

      Products are categorized in our catalog primarily on the basis of the product name, i.e. ideally the product name should contain the basic specification of the product, especially the designation, such as: children's bedding (so it is not appropriate to list only the bedding, if it is children's bedding.) , garden chairs, dining chairs, etc.
      The product name may contain the manufacturer or brand name, but not the store name or store URL. The title should also not contain information such as in stock, sale, promotions, free shipping, etc.

      Required for each product. 

      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ő/Pazaruvaj <Name>MERIDA double bed, 160×200 cm</Name>
      Ceneo <name>MERIDA double bed, 160×200 cm</name>
      Jeftinije/Ceneje <name><![CDATA[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. 

      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ő/Pazaruvaj

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

      Ceneo

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

      Jeftinije/Ceneje

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

      PRODUCT CATEGORY *

      Product category. The category 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. 

      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ő/Pazaruvaj

      		 <Category>Bedrooms > Beds</Category>

      Ceneo

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

      Jeftinije/Ceneje

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

      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.

      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ő/Pazaruvaj <Price>4500</Price>
      Ceneo price=“4500″
      Jeftinije/Ceneje <price>659.90</price>

      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.

      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ő/Pazaruvaj <Product_url>https://www.url.com/bed-merida.html#/90x200_cm</Product_url>
      Ceneo

      url=“https://www.url.cz/merida.html#/90x200_cm″
      Jeftinije/Ceneje

      <link><![CDATA[https://www.url.cz/merida.html#/90x200_cm]]></link>

      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) Please send images in file format PNG or JPEG.

      4) 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.

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

      6) 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.

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

      8) 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.

      9) 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.
      • Image URL has to be secured with https certificate.

      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.

      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ő/Pazaruvaj <Image_url>https://www.url.com/bed-merida.jpg</Image_url>
      Ceneo <imgs><main url=“https://www.url.com/bed-merida.jpg“/></imgs>
      Jeftinije/Ceneje <mainImage><![CDATA[https://www.url.com/bed-merida.jpg]]></mainImage>

      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. 

      All alternative image URLs have to be secured with https certificates.

      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.

      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ő/Pazaruvaj <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>
      Jeftinije/Ceneje

      <moreImages><![CDATA[https://www.url.com/bed-merida2.jpg,https://www.url.com/bed-merida3.jpg]]
      ></moreImages>

      PARAMETERS

      Product parameters. Parameters are specific characteristics of an individual product. The more parameters you enclose, the higher chances you have for success withint your campaign. 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 and other product-specific characteristics which might be important.

      You can find more about parameters and their specification here. Some of the parameters are used for sorting products into specific filters. 

      The customer who utilize filters are generally more inclined towards purchase. To avoid losing such customers, check the current status of your parameters. To list your products within the "dimensions" filter, make sure to send each dimension in a separate parameter - height separately, width separately, depth separately, etc. If this is not adhered to, it will not be possible to find the product via the "dimensions" filter. The recommended dimensions for each category can be found within the category list here.

      General principles for parameters

      1. Do not send multiple parameter values unless they exactly match the product variant, see example (decor, other available dimensions and colors), the main image must correspond to the description and the given parameters.
      2. When creating parameters, it is not necessary to exactly copy the wording of our filters in categories. We will merge slightly different naming if we receive it in this way from multiple partners.
      3. List units of measurement for numerical values (cm, mm, l, ..). 
      4. Each product should contain its own specification. Do not duplicate parameter values, see example.
      5. Parameter values such as yes x no are accepted, but values 0 x 1 are not.
      6. Send parameters as accurate as possible. Do not enter multiple values in multiple lines within one record.
      7. The parameters must be translated into the language of the given country.
      8. Dimensions must be sent in separate parameters - height separately, width separately, depth separately, etc.

      The provided parameters are shown in a table on the product detail page. The table will only be visible to customers if you send more than 3 different parameters.

      Specifying the parameters is highly recommended.

      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ő/Pazaruvaj

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

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

      <attributes>
      <name><![CDATA[Height]]></name>
      <values>
      <value><![CDATA[95 cm]]></value>
      </values>
      </attribute>
      </attributes>

      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” or "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. 

      XML feed specification Element
      Heureka/Zboží <DELIVERY_DATE>0</DELIVERY_DATE> **
      Google

      <g:availability>in stock</g:availability>

      or

      <g:availability>in_ stock</g:availability>
      Compari/Árukereső/Pazaruvaj <Delivery_Time>0</Delivery_Time> **
      Ceneo avail=“1″ **
      Jeftinije/Ceneje <stock>in stock</stock>

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

      DELIVERY OPTIONS

      Specification of options for delivery of products to the customer.

      There may be more than one delivery method for a single product and it is advisable to include the shipping cost. This will increase the overall score of the product.

      We only consider home delivery in the product quality score, not delivery to collection points.

      The free shipping label will appear on the product if one of the valid shipping options is listed with a price of 0.

      If it is not possible to add delivery information directly to XML feed, you can fill in the shipping details within your shop dashboard via the Settings > Delivery tab. Here, you can add the following information which will be automatically attributed to all the products at once: 

      • The cheapest shipping price to the indicated address
      • Free shipping for products over

      Adding the information through the shop dashboard is recommended in case of unified shipping prices and conditions for the entire product portfolio. If there are exceptions, the information must be added via XML feed. 

      Highly recommended for each product.

      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ő/Pazaruvaj

      <Delivery_Cost>FREE</Delivery_Cost>

      or the following designation: gratuit, gratis, fara cost; ingyenes, ingyen, ingyenesen; безплатно, безплатен, безплатна.
      Ceneo not specified
      Jeftinije/Ceneje <deliveryCost>0</deliveryCost>

      GTIN (EAN)

      Global Trade Item Number (GTIN) is a unique number assigned to a specific product. If your products do not have a GTIN number, it can be obtained on  GS1 system websites. 

      Never include internal numerical product identifiers in GTIN, only official product codes are allowed. 

      GTIN is recognized as valid within our system if it meets the following criteria:

      1. It consists of only 8, 12, 13, or 14 digits.
      2. It must pass the official checksum calculation (e. g. https://www.gs1.org/services/how-calculate-check-digit-manually)
      3. It cannot contain prefixes for coupon values (for more information: Solution procedure: Unsupported coupon value: GTIN [gtin])

      Including this element is highly recommended.

      XML feed specification

      Element

      Heureka/Zboží

      <EAN>6417182041488</EAN>

      Google 

      <g:gtin>6417182041488</g:gtin>

      Compari/Árukereső/Pazaruvaj

      <EAN_code>6417182041488</EAN_code>

      Ceneo

      <a name=“EAN“>
      <![CDATA[6417182041488 ]]>
      </a> 

      Jeftinije/Ceneje

      <EAN><![CDATA[6417182041488]]></EAN>

      MANUFACTURER

      Specifies the manufacturer of the product.

      Highly recommended for each product.

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

       

      * indicates a required element