<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2018-09-25 17:22">
  <shop>
    <categories>
      <category id="1278">Electronics</category>
      <category id="1293" parentId="1278">Smartphones</category>
      <category id="1345" parentId="1278">Phones</category>
      <category id="3761" parentId="1278">TVs</category>
      <category id="1553" parentId="3761">Media-players</category>
      <category id="3798">Appliances</category>     
    </categories>
    <offers>
      <offer id="1637" available="false" group_id="12345">
        <url>http://example.com/product/id1637</url>
        <price>226.50</price>
        <oldprice>250</oldprice>
        <categoryId>1293</categoryId>
        <categoryId>1345</categoryId>
        <picture>http://example.com/images/1637_1.jpg</picture>
        <name>Product 1</name>
        <param name="Color">Black</param>
        <description>Description of the product 1637</description>
        <vendor>Vendor name</vendor>
        <model>Model of the product</model>
        <stock id="Spain">
          <available>true</available>
          <price>230.30</price>
          <oldprice>252</oldprice>
          <url>http://example.com/product/id1637</url>
          <picture>http://example.com/images/1637_2.jpg</picture>
        </stock>
        <stock id="Italy">
          <available>false</available>
          <price>235</price>
          <oldprice>251.60</oldprice>
          <url>http://example.com/product/id1637</url>
          <picture>http://example.com/images/1637_2.jpg</picture>
        </stock>
      </offer>
      <offer id="1638" available="false" group_id="12345">
        <url>http://example.com/product/id1638</url>
        <price>545.30</price>
        <categoryId>1293</categoryId>
        <categoryId>1345</categoryId>
        <picture>http://example.com/images/1638_1.jpg</picture>
        <name>Product 2</name>
        <param name="Color">White</param>
        <description>Description of the product 1638</description>
        <vendor>Vendor name</vendor>
        <model>Model of the product</model>
        <stock id="Spain">
          <available>true</available>
          <price>500</price>
          <oldprice>550</oldprice>
          <url>http://example.com/product/id1638</url>
          <picture>http://example.com/images/1638_2.jpg</picture>
        </stock>
        <stock id="Italy">
          <available>true</available>
          <price>540.50</price>
          <oldprice>600</oldprice>
          <url>http://example.com/product/id1638</url>
          <picture>http://example.com/images/1638_3.jpg</picture>
        </stock>
      </offer>
    </offers>
  </shop>
</yml_catalog>

Required parameters of the XML:

• <?xml version="1.0" encoding="UTF-8"?> - standard XML header. Must start with the first line, with a null character.
• <yml_catalog> - denotes the beginning of the XML file, where:
  • "date" - integration date of the XML file. The date should be in the format YYYY-MM-DD hh:mm.
• <shop> - includes information of categories and products.
• <categories> - includes declaration of all categories.
• <category> declaration of a single category. Attributes of an element:
  • "id" - number, identifier of a category;
  • "parentId" - identifier of a parent category (creates nesting).
• <offers> - includes declaration of all product offers.
• <offer> - declaration of a single product offer. Attributes of an element:
  • "id" - number, identifier of a product;
  • "available" - specifies the product's availability status outside of stockId, always "false";
  • "group_id" - number, identifier of a products group. Combines all offers that are variations of the same product. It should have the same value. The value must be an integer. If the product is not a group offer, then the identifier of the product offer must be passed to the parameter.
• <name> - name of a product offer.
• <url> -  link to a product page of a product offer. The link should be permanent, begin with http or https.
• <picture> - link to a picture of a product offer. The link should be permanent, begin with http or https. Images should have resolution lower than 400x400px or their size should be lower than 1 MB. Pictures format JPEG or PNG. We recommend to use images from category page. These images will be used in recommendation blocks and trigger emails.
• <price> - A price for a product offer, no spaces, the fractional part is indicated by a dot.
• <categoryId> - number, identifier of a products category. It could be specified several times. One parameter should contain only one identifier.
• <stock> - declaration of a region (warehouse) of a product, subattributes of the element:
  • "id" - identifier of a region (warehouse). It could contain letters and numbers. For each region (warehouse), the required parameter is an availability. Availability is declared separately in the <available> tag.
• <available> - indicates the availability (absence) of the product offer. It could be true or false. Each parameter <stock> could contain additional parameters <price>, <oldprice>, <description> to personalize information for this region (warehouse). If these parameters are not specified, the information from the main offer will be used.