This article provides an overview of the required elements of the Heureka XML product and availability feed. These elements are key to properly connecting and launching your products.
Product Heureka XML feed
|SHOP||Root element, is contained in the file only once.|
|SHOP_ITEM||Element contains the complete structure of the product, is included in the file as many times as the partner has products or variants. E.g. in case that partner sells t-shirt in five sizes (S, M, L, XL, XXL) and ten colors (white, yellow, orange, red, blue, purple, green, brown, beige, gray and black) it is necessary to enter 50x SHOPITEM into XML.|
|ITEM_ID||Unique product designation within the e-shop, based on which a MALL ID is generated. The ID must remain unique because it serves to uniquely identify the product. For example, for proper availability pairing in the Heureka Availability XML feed. Must not be the same as ITEMGROUP_ID.|
Combinations of a maximum of 36 characters, allowed characters are: _ - 0-9 az AZ (underscores, hyphens, numbers zero to nine, lowercase and uppercase letters without accents).
|PRODUCTNAME||Exact product name. The length is validated by our system max. 200 characters.|
|PRODUCT||This element is optional. |
If you send it in the feed, then pairs on a short product label (in MALL max. 300 characters). It does not match if the element is the same as PRODUCTNAME. In this case, a short description of the product is added from the DESCRIPTION element.
|DESCRIPTION||Product description should contain the most relevant product information that is taken into account in the full-text search. It is not possible to mention here: advertisements, events or promotion of your e-shop. |
The number of characters in the DESCRIPTION element is validated by our system to 13 000 characters.
|IMGURL||Link to the main / primary image of the product. The size of the images is validated by our system - max 2000px x 2000px, min. 100 KB and max. 2 MB.|
Image URL must not contain spaces or accents.
|IMGURL_ALTERNATIVE||This element is not mandatory, but if you send it in the feed, we draw additional images for the product. The maximum number of images is 20.|
|PRICE_VAT||Final price of the product with VAT. The price must not include commission.|
|VAT||Optional element from which we draw the VAT rate. If this element is not in the feed, then VAT can be set manually for all products in the portal in Feed status.|
|MANUFACTURER||Contains the manufacturer (brand) of the product, based on which we pair brands on MALL. More detailed instructions on brands can be found here.|
|CATEGORY_TEXT||There is product classification. We recommend using the Heureka category tree, so pairing will take place automatically. Heureka tree can be found here: https://www.heureka.cz/direct/xml-export/shops/heureka-sekce.xml. Otherwise, the categories can be paired manually in the partner portal, you can find more here.|
|EAN||Optional element in the Heureka XML feed that is matched to the EAN of the product. The system only accepts 13 numeric characters. EANs are mandatory for us and it is necessary to send them to the products. |
If your EAN has 14 numeric characters, enter it as 13 digits without the 0 at the beginning. If you have a shorter 8-digit EAN, add as many 0's to the beginning as needed to fill the 13 characters.
|PARAM||An optional element that can then be paired to our parameters in the portal.|
In the case of creating a variety product, this element is mandatory.
You will find more detailed instructions here.
|DELIVERY_DATE||An optional element that matches ours Delivery Delay (delivery time) at product level. In this case, the Delivery delay setting in transport will not be taken into account and the system will give priority to product-level settings. For correct pairing, it is necessary to state integers with a maximum of two digits.|
|ITEMGROUP_ID||Mandatory element necessary for variants, on the basis of which our system recognizes a variant product. Must not be the same as ITEM_ID.|
Combinations of a maximum of 36 characters, allowed characters are: _, -, 0-9, a-z, A-Z (underscores, hyphens, numbers zero to nine, lowercase and uppercase letters without accents).
Availability Heureka XML feed
|item_list||Root element, is contained in the file only once.|
|item||Contains information about the availability of a specific product, is included in the file as many times as the partner has available products or variants.|
|item id||Identifies a specific product. The value must match the value of the element product from the Heureka XML feed product. So your product and availability feed IDs must be the same.|
|stock_quantity||Number of pieces ready for immediate dispatch.|
The allowed value is an integer.
If you make changes to your e-shop (eshop XYZ vs. Heureka), it will take effect in about 2 hours (regular updates). Subsequently, the changes will appear in the URL of the link with the structure of the feed, which you have inserted in our partner portal.
How to validate a Heureka XML feed?
A suitable validator for the Heureka XML feed is provided by Mergado. This validator does not take into account the specific requirements that need to be met for a successful connection to MALL, this is only a general validation of the Heureka feed.
You can find the validator here: https://audit.mergado.com/.
You can also watch our instructional video (only in Czech)