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

SHOPRoot 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.
PRODUCTThis 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_ALTERNATIVEThis 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.
VATOptional 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.
MANUFACTURERContains the manufacturer (brand) of the product, based on which we pair brands on MALL. More detailed instructions on brands can be found here.
CATEGORY_TEXTThere 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.
EANAn optional element in the Heureka XML feed that matches the EAN of the product. EANs are mandatory for us and it is necessary to send them to the products.
PARAMAn 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_DATEAn 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_IDMandatory 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 az AZ (underscores, hyphens, numbers zero to nine, lowercase and uppercase letters without accents).

Availability Heureka XML feed

item_listRoot element, is contained in the file only once.
itemContains 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 idIdentifies 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_quantityNumber 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.

How useful was this post?

Click on the star to rate the post!

Average rating: / 5. Number of votes:

No votes yet! Be the first to rate this post.