XML feed specification

1. Product catalog - INFO

File structure:

<SHOP> – packaging element
<PARAMETERS> – parameter definition (e.g. composition, color)
<PRODUCTS> – product list

Each element PARAMETER has attribut id, name, unit and group

PRODUCT elements:

Besides elements ID, URL a NAME all other elements are optional.

Element	Popis
`ID`	product ID
`URL`	Odkaz na detail produktu
`NAME`	Link to product detail
`MPN`	Manufacturer's name
`DESC`	Short description
`CATEGORY`	product category (větve oddělené "\|")
`SUPRA_CATEGORY`	Parent categories - men, women, children (separated "\|")
`COLOR`	Basic colour (all colours and patterns of the product are listed in the parameters)
`IMG`	Main product image
`ALT_IMG`	Alternative product image (may contain multiple)
`SET_IMG`	Product set image (if sold as a set)
`SYMBOLS_IMG`	Care symbols image
`BRAND`	Brand
`EAN`	EAN kód
`PARAMETERS`	Product parameters (contains individual PARAM elements)
`SIZES`	List of sizes and variants (includes individual SIZE elements)

PARAM elementy:

Element	Popis
`VAL`	Contains the unformatted parameter value (some parameters can have more values)

Each PARAM has attribute id where parameter ID is specified in the parameter definition

SIZE elements:

Besides elements ID, NAME all other elements are optional.

Element	Description
`ID`	Product ID (sizes)
`NAME`	Product name
`MPN`	Manufacturer's name
`EAN`	EAN code
`INFO`	Additional information about size

2. Availability and prices - AVAIL

File structure:

<SHOP>
<ITEMS> – list of items

Main elements v ITEM:

All listed elements are mandatory.

Element	Description
`PRICE`	Price without VAT
`PRICE_VAT`	Price with VAT
`PRICE_RETAIL_VAT`	Recommended retail price with VAT
`VAT`	VAT rate
`UNIT`	Packaging type (e.g. packaging)
`UNIT_ONE_QTY`	Number of pieces per unit
`UNIT_ONE_NAME`	Unit name (e.g. pair)
`ONSTOCK`	Available quantity in stock

Each ITEM has attribute id which contains product ID or size variant

3. Linking both feeds

Products in INFO are linked to availability in v AVAIL using the value:

<PRODUCT><ID> ⟷ <ITEM id="...">
Or in case of size variants using: <SIZES><SIZE><ID>

Example:

        <PRODUCT>
          <ID>121134</ID>
          <NAME>Ponožky pánské vtipné WOODOO s obrázky ŽOLÍKOVÝCH KARET (3 páry)</NAME>
          ...
          <SIZES>
            <SIZE>
              <ID>119572</ID>
              <NAME>39-42 (26-28)</NAME>
              ...
            </SIZE>
            <SIZE>
              <ID>119573</ID>
              <NAME>43-46 (29-31)</NAME>
              ...
            </SIZE>
          </SIZES>
        </PRODUCT>

        <ITEM id="119572">
          <PRICE>114</PRICE>
          <ONSTOCK>50</ONSTOCK>
        </ITEM>

        <ITEM id="119573">
          <PRICE>114</PRICE>
          <ONSTOCK>48</ONSTOCK>
        </ITEM>

Interpretation

The product is available in two variants: 39–42 a 43–46.
Each variant has its own stock availability:
- 39–42: 50 kusů
- 43–46: 48 kusů
Both variants are sold for 114 Kč bez DPH, which corresponds to 137,94 Kč s DPH.

4. Versioning static content

All links to images and other static content are provided with a version reference indicating the last modification/change of the file in the format: v=yyyyMMddhhmmss