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, whilegroup_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
Updated 8 months ago