xml

Format Description

You can supply YML files to update your product range once in few hours.

YML (Yandex Market Language) is a data transfer and storage format for the Yandex.Market database, created by Yandex. YML is based on standard XML.
Details can be found here

Features

  • Website categorization should match YML categorization.
  • Product and category IDs in YML should match product and category IDs in orders, product actions, and category actions.
  • You need to upload the entire product range, with both available and unavailable products.
  • If retail product range is different from the website range, add retail products to YML.
  • If prices and availability vary by region, each region must have its own YML feed.
  • Custom fields can be added to products: <param name="custom field title">custom field value</param>.
  • A product can belong to multiple categories.
  • In case of an SKU, the node <offer id="321" type="vendor.model" available="true" group_id="22"> reads like this: id is the SKU ID, while group_id is the parent product ID.

Sample File

<?xml version="1.0" encoding="windows-1251"?>
<yml_catalog date="2016-02-05 17:22">
  <shop>
    <name>ABC</name>
    <company>ABC inc.</company>
    <url>http://www.abc.com/</url>
    <currencies>
      <currency id="RUR" rate="1"/>
      <currency id="USD" rate="80"/>
    </currencies>
    <categories>
      <category id="1278">Electronics</category>
      <category id="3761" parentId="1278">TVs</category>
      <category id="1553" parentId="3761">Media Players</category>
      <category id="3798">Home Appliances</category>
      <category id="1293" parentId="3798">Refrigerators</category>
    </categories>
    <delivery-options>
      <option cost="500" days="0" order-before="15"/>
      <option cost="300" days="1-3"/>
    </delivery-options>
    <cpa>1</cpa>
    <offers>
      <offer id="158" available="true" bid="80" cbid="90">
        <url>http://www.abc.com/158.html</url>
        <price>55690</price>
        <currencyId>RUR</currencyId>
        <categoryId>1293</categoryId>
        <categoryId>1278</categoryId>
        <picture>http://www.abc.com/1580.jpg</picture>
        <picture>http://www.abc.com/1581.jpg</picture>
        <picture>http://www.abc.com/1582.jpg</picture>
        <picture>http://www.abc.com/1583.jpg</picture>
        <store>false</store>
        <delivery>true</delivery>
        <name>Apple iPhone 6s 128gb Space Gray</name>
        <vendor>Apple</vendor>
        <model>iPhone 6s 128gb Space Gray</model>
        <description>Product Description 1</description>
        <sales_notes>50% Upfront Required</sales_notes>
        <barcode>7564756475648</barcode>
        <age>0</age>
        <manufacturer_warranty>false</manufacturer_warranty>
        <param name="Type">Single Unit</param>
        <param name="Material">Aluminum</param>
        <param name="Wi-Fi" unit="">+</param>
        <param name="Screen Size" unit="in">27</param>
        <param name="RAM" unit="MB">4096</param>
        <param name="HDD" unit="TB">1</param>
        <param name="Weight" unit="kg">13.8</param>
      </offer>
      <offer id="159" available="true" cbid="90">
        <url>http://www.abc.com/159.html</url>
        <price>3045.5</price>
        <currencyId>RUR</currencyId>
        <categoryId>1293</categoryId>
        <picture>http://www.abc.com/1590.jpg</picture>
        <picture>http://www.abc.com/1591.jpg</picture>
        <store>false</store>
        <delivery>true</delivery>
        <name>Koss Sporta Pro</name>
        <vendor>Koss</vendor>
        <model>Sporta Pro</model>
        <description>Product Description</description>
        <sales_notes>Order Day Purchase</sales_notes>
        <cpa>0</cpa>
        <delivery-options>
          <option cost="1000" days="1" order-before="15"/>
        </delivery-options>
        <barcode>7564756475648</barcode>
        <age>0</age>
        <manufacturer_warranty>true</manufacturer_warranty>
        <param name="Type">12344</param>
        <param name="Material">Plastic</param>
        <param name="Wi-Fi" unit="">+</param>
        <param name="Screen Size" unit="in">27</param>
        <param name="RAM" unit="MB">4096</param>
        <param name="HDD" unit="TB">1</param>
        <param name="Weight" unit="kg">13.8</param>
      </offer>
    </offers>
  </shop>
</yml_catalog>
<?xml version="1.0" encoding="windows-1251"?>
<yml_catalog date="2016-02-05 17:22">
  <shop>
    <name>ABC</name>
    <company>ABC inc.</company>
    <url>http://www.abc.com/</url>
    <currencies>
      <currency id="RUR" rate="1"/>
      <currency id="USD" rate="80"/>
    </currencies>
    <categories>
      <category id="1278">Electronics</category>
      <category id="3761" parentId="1278">TVs</category>
      <category id="1553" parentId="3761">Media Players</category>
      <category id="3798">Home Appliances</category>
      <category id="1293" parentId="3798">Refrigerators</category>
    </categories>
    <delivery-options>
      <option cost="500" days="0" order-before="15"/>
      <option cost="300" days="1-3"/>
    </delivery-options>
    <cpa>1</cpa>
    <offers>
       <offer id="321" type="vendor.model" available="true" bid="80" group_id="22">
        <url>http://best.clothes.com/product_page.asp?pid=12344</url>
        <price>5400</price>
        <currencyId>RUR</currencyId>
        <categoryId>6</categoryId>
        <picture>http://best.seller.com/img/picture1.jpg</picture>
        <picture>http://best.seller.com/img/picture2.jpg</picture>
        <store>true</store>
        <pickup>false</pickup>
        <delivery>true</delivery>
        <delivery-options>
          <option cost="200" days="1"/>
        </delivery-options>
        <vendor>Thriumph</vendor>
        <typePrefix>Lingerie Set</typePrefix>
        <model>Cotton Basics Modern</model>
        <description>Bright semi-transparent set of bra and panties...</description>
        <country_of_origin>China</country_of_origin>
        <barcode>0123456789012</barcode>
        <param name="Cup Size" unit="RU">B</param>
        <param name="Chest Size" unit="cm">95</param>
        <param name="Panties Size" unit="INT">M</param>
        <param name="Color">Red</param>
        <param name="Gender">Female</param>
        <param name="Age">Adults</param>
        <param name="Material">100% Nylon</param>
      </offer>
      <offer id="322" type="vendor.model" available="true" bid="80" group_id="22">
        <url>http://best.clothes.com/product_page.asp?pid=12344</url>
        <price>5400</price>
        <currencyId>RUR</currencyId>
        <categoryId>6</categoryId>
        <picture>http://best.seller.com/img/picture3.jpg</picture>
        <picture>http://best.seller.com/img/picture4.jpg</picture>
        <store>true</store>
        <pickup>false</pickup>
        <delivery>true</delivery>
        <delivery-options>
          <option cost="200" days="1"/>
        </delivery-options>
        <vendor>Thriumph</vendor>
        <typePrefix>Lingerie Set</typePrefix>
        <model>Cotton Basics Modern</model>
        <description>Bright semi-transparent set of bra and panties...</description>
        <country_of_origin>China</country_of_origin>
        <barcode>0123456789012</barcode>
        <param name="Cup Size" unit="RU">А</param>
        <param name="Chest Size" unit="cm">75</param>
        <param name="Panties Size" unit="INT">XS</param>
        <param name="Color">Red</param>
        <param name="Gender">Female</param>
        <param name="Age">Adults</param>
        <param name="Material">100% Nylon</param>
      </offer>
    </offers>
  </shop>
</yml_catalog>

Reference Materials

Bitrix - Connecting to Yandex.Market