Heureka Offer Feed XML Documentation¶

Welcome to the comprehensive documentation for the Heureka Offer Feed XML specification. This documentation is automatically generated from validated field definitions to ensure accuracy and consistency.

Overview¶

Version: 1.0
Total Fields: 26
Required Fields: 8

Heureka Offer Feed XML format allows e-shops to submit product information to Heureka.cz for price comparison and shopping services.

Quick Start¶

The XML feed follows this basic structure:

<?xml version="1.0" encoding="UTF-8"?>
<SHOP>
  <SHOPITEM>
    <!-- Required fields -->
    <ITEM_ID>product_123</ITEM_ID>
    <PRODUCTNAME>Samsung Galaxy S24</PRODUCTNAME>
    <URL>https://example.com/product/123</URL>
    <PRICE_VAT>25000</PRICE_VAT>
    <CATEGORYTEXT>Heureka.cz | Electronics | Mobile Phones</CATEGORYTEXT>

    <!-- Complex conditional field examples -->
    <PARAM>
      <VAL>128GB</VAL>
      <PARAM_NAME>Storage</PARAM_NAME>
    </PARAM>
    <PARAM/> <!-- Empty parameter -->

    <DELIVERY>
      <DELIVERY_ID>PPL</DELIVERY_ID>
      <DELIVERY_PRICE>99</DELIVERY_PRICE>
    </DELIVERY>

    <!-- Attribute-based field example -->
    <GIFT ID="gift_123">Free wireless headphones</GIFT>

    <!-- Other optional fields... -->
  </SHOPITEM>
</SHOP>

Complete Field Reference¶

Field Name	Display Name	Type	Architecture	Required	Description
`ITEM_ID`	Item Id	string	simple	✓	Unique product identifier within the e-shop. Maximum 36 characters. Allowed char...
`PRODUCTNAME`	Productname	string	simple	✓	Basic product name that includes all mandatory category-specific information. Ma...
`URL`	Url	string	simple	✓	Unique product page URL that displays price and add-to-cart option. Maximum 300...
`IMGURL`	Imgurl	string	simple	✓	Primary product image URL. Maximum 255 characters. Must start with http:// or ht...
`PRICE_VAT`	Price Vat	string	simple	✓	Final product price including VAT in Czech Koruna (CZK). Maximum 2 decimal place...
`CATEGORYTEXT`	Categorytext	string	simple	✓	Product category path. Must start with "Heureka.cz
`DELIVERY_DATE`	Delivery Date	string	simple	✓	Expected delivery time. Can be number of days (1-999) or specific date in YYYY-M...
`IMGURL_ALTERNATIVE`	Imgurl Alternative	string	simple	○	Additional product images. Maximum 10 alternative images. Each URL maximum 255 c...
`PRODUCT`	Product	string	simple	○	Alternative product identifier or code. Optional field for additional product re...
`DESCRIPTION`	Description	string	simple	○	Detailed product description with features, specifications, and benefits.
`VAT`	Vat	string	simple	○	VAT rate percentage applied to the product (e.g., "21" for 21% VAT).
`MANUFACTURER`	Manufacturer	string	simple	○	Product manufacturer or brand name. Used for filtering and brand-specific search...
`EAN`	Ean	string	simple	○	European Article Number (EAN-13) barcode. Must be exactly 13 digits.
`ISBN`	Isbn	string	simple	○	International Standard Book Number. Accepts ISBN-10 (10 digits with possible X)...
`ITEM_TYPE`	Item Type	string	simple	○	Type or classification of the product item for categorization purposes.
`MANUFACTURER_POSTAL_ADDRESS`	Manufacturer Postal Address	string	simple	○	Manufacturer's physical postal address for legal and contact purposes.
`MANUFACTURER_ELECTRONIC_ADDRESS`	Manufacturer Electronic Address	string	simple	○	Manufacturer's electronic contact (email address or website URL) for support and...
`HEUREKA_CPC`	Heureka Cpc	decimal	simple	○	Heureka Cost Per Click bid amount. Must be a positive decimal number greater tha...
`ITEMGROUP_ID`	Itemgroup Id	string	simple	○	Group identifier for product variants (color, size, pattern variations). Maximum...
`ACCESSORY`	Accessory	string	simple	○	Related accessory product ITEM_ID. Maximum 10 accessories can be specified for c...
`SPECIAL_SERVICE`	Special Service	string	simple	○	Special service offered with the product (e.g., installation, setup, training)....
`DELIVERY`	Delivery	string	complex_conditional	✓	Shipping method information. Maximum 100 different shipping methods. Must contai...
`PARAM`	Param	string	complex_conditional	○	Product parameter with name-value pair. Must contain both VAL and PARAM_NAME ele...
`EXTENDED_WARRANTY`	Extended Warranty	string	complex_conditional	○	Extended warranty option. Must contain both VAL (warranty period) and DESC (warr...
`SALES_VOUCHER`	Sales Voucher	string	complex_conditional	○	Sales voucher or discount code. Must contain both CODE and DESC elements when pr...
`GIFT`	Gift	string	attribute_based	○	Gift item with description and ID. Content describes the gift (max 250 character...

This documentation is automatically generated from the field definitions. For questions or issues, please contact the development team.