XML Feed Specification

Required fields

• PRODUCTS required – root element of products, listed only once in the file.
• PRODUCT required – element containing information about a specific product. Each product has its own element.
• ITEM_ID required – unique product ID in your e-shop.
• TITLE required – product name.
• CATEGORIES > CATEGORY required – product assignment to categories. The CATEGORY element can be repeated. You can also include the category ID from your e-shop.
• URL required – product URL in your e-shop.
• IMG required – product image URL in your e-shop. We recommend smaller image resolution, approximately 200x200px.
• PRICE required – current product price.

Recommended fields

• BRAND recommended – product brand.
• SALE_PRICE recommended – sale price of the product.
• MARGIN recommended – product margin.
• NUM_OF_SALES recommended – number of orders for the product.
• STOCK recommended – product stock quantity.
• DELIVERY_DATE recommended – number of delivery days if the product is out of stock.
• DELIVERY_TEXT recommended – product availability description.
• LABELS > LABEL recommended – list of product labels. The LABEL element can be repeated. Each label contains these fields:
  • LABEL_NAME – label name (e.g. New, Sale, Hit).
  • LABEL_CSS_CLASS – CSS class, if you want to use it in your design.
  • LABEL_BACKGROUND_COLOR – label background color in hex format (#rrggbb).
  • LABEL_TEXT_COLOR – label text color (#rrggbb).

Optional fields

• ITEM_GROUP_ID optional – product group ID.
• GROUP_TITLE optional – product group name when using ITEM_GROUP_ID.
• DESCRIPTION optional – product description.
• PARAMS > PARAM optional – additional product parameters (size, color, etc.). The PARAM element can be repeated. Each parameter requires a name in the PARAM_KEY element and its value in the PARAM_VALUE element.
• RELATED_PRODUCTS > RELATED_ITEM_ID optional – list of related products. The RELATED_ITEM_ID element can be repeated.

Feed example

<?xml version="1.0" encoding="utf-8"?>
<PRODUCTS>
  <PRODUCT>
    <ITEM_ID>1</ITEM_ID>
    <TITLE>Product</TITLE>
    <CATEGORIES>
      <CATEGORY id="2">Main category | Category 1</CATEGORY>
    </CATEGORIES>
    <URL>https://www.yourstoreaddress.com/product</URL>
    <IMG>https://www.yourstoreaddress.com/product_image.png</IMG>
    <PRICE>19.99</PRICE>
    <BRAND>Brand name</BRAND>
    <SALE_PRICE>17.99</SALE_PRICE>
    <MARGIN>4.50</MARGIN>
    <NUM_OF_SALES>125</NUM_OF_SALES>
    <STOCK>42</STOCK>
    <DELIVERY_DATE>3</DELIVERY_DATE>
    <DELIVERY_TEXT>In stock</DELIVERY_TEXT>
    <LABELS>
      <LABEL>
        <LABEL_NAME>New</LABEL_NAME>
        <LABEL_CSS_CLASS>label_new</LABEL_CSS_CLASS>
        <LABEL_BACKGROUND_COLOR>#00ff00</LABEL_BACKGROUND_COLOR>
        <LABEL_TEXT_COLOR>#ffffff</LABEL_TEXT_COLOR>
      </LABEL>
    </LABELS>
    <ITEM_GROUP_ID>1</ITEM_GROUP_ID>
    <GROUP_TITLE>Product group name</GROUP_TITLE>
    <DESCRIPTION>Product description</DESCRIPTION>
    <PARAMS>
      <PARAM>
        <PARAM_KEY>Size</PARAM_KEY>
        <PARAM_VALUE>XL</PARAM_VALUE>
      </PARAM>
      <PARAM>
        <PARAM_KEY>Color</PARAM_KEY>
        <PARAM_VALUE>Yellow</PARAM_VALUE>
      </PARAM>
    </PARAMS>
    <RELATED_PRODUCTS>
      <RELATED_ITEM_ID>2</RELATED_ITEM_ID>
    </RELATED_PRODUCTS>
  </PRODUCT>
</PRODUCTS>

Required fields

• CATEGORIES required – root element of categories, listed only once in the file.
• CATEGORY required – element containing information about a specific category. Each category has its own element.
• TITLE required – category name.
• URL required – category URL.

Recommended fields

• ID recommended – unique category ID in your e-shop.
• HIERARCHY recommended – category path. Optional when using ID and PARENT_ID values.

Optional fields

• PARENT_ID optional – parent category ID in your e-shop.

Feed example

<?xml version="1.0" encoding="utf-8"?>
<CATEGORIES>
  <CATEGORY>
    <TITLE>Main category</TITLE>
    <URL>https://www.yourstoreaddress.com/main_category</URL>
    <ID>1</ID>
    <HIERARCHY>Main category</HIERARCHY>
    <PARENT_ID>0</PARENT_ID>
  </CATEGORY>
  <CATEGORY>
    <TITLE>Category 1</TITLE>
    <URL>https://www.yourstoreaddress.com/category_1</URL>
    <ID>2</ID>
    <HIERARCHY>Main category | Category 1</HIERARCHY>
    <PARENT_ID>1</PARENT_ID>
  </CATEGORY>
</CATEGORIES>

Required fields

• BRANDS required – root element of brands, listed only once in the file.
• BRAND required – element containing information about a specific brand. Each brand has its own element.
• TITLE required – brand name.
• URL required – brand URL.

Feed example

<?xml version="1.0" encoding="utf-8"?>
<BRANDS>
  <BRAND>
    <TITLE>Brand name</TITLE>
    <URL>https://www.yourstoreaddress.com/brand</URL>
  </BRAND>
</BRANDS>

The article feed is used to transfer blog content, magazine articles or other text-based posts from your website to Magrano. This allows users to search within articles and find relevant answers directly from your content database.

Required fields

• ARTICLES required – root element of articles, listed only once in the file.
• ARTICLE required – element containing information about a specific article. Each article has its own element.
• TITLE required – article title.
• URL required – article URL.
• CONTENT required – complete text (content) of the article.

Optional fields

• ARTICLE_ID optional – unique article ID in your system.
• PEREX optional – short introductory text (perex, annotation) of the article.

Feed example

<?xml version="1.0" encoding="utf-8"?>
<ARTICLES>
  <ARTICLE>
    <TITLE>Blog article title</TITLE>
    <URL>https://www.yourstoreaddress.com/blog/article-title</URL>
    <CONTENT>The complete text of the article goes here...</CONTENT>
    <ARTICLE_ID>1</ARTICLE_ID>
    <PEREX>Short introductory text or perex of the article.</PEREX>
  </ARTICLE>
</ARTICLES>