Example of VendorYML file with description of elements

Example of XML file

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" date="2010-04-01T17:00:00" version="1.0" xsi:noNamespaceSchemaLocation="VendorYML-1.0.xsd">
 <vendor name="Canon">
 <url>http://canon.com/</url>
 <categories>
 <category id="1">Electronics</category>
 <category id="10" parentId="1">Photos</category>
 <category id="100" parentId="10">Compact cameras</category>
 <category id="101" parentId="10">SLR cameras</category>
 <category id="102" parentId="1">Camcorders</category>
 <category id="2">Data storage</category>
 <category id="11" parentId="2">Memory cards</category>
 <category id="12" parentId="2">USB-flash drives</category>
 <category id="13" parentId="2">Portable hard drives</category>
 </categories>
 <models>
 <model id="34121" categoryId="10">
 <name>EOS 60D Body</name>
 <alias>EOS 60D W/O LENS</alias>
 <type>Digital camera</type>
 <vendorCode>4460B007</vendorCode>
 <promoUrl>http://canon.com/eos-60d</promoUrl>
 <pictureUrl type="main">http://canon.com/eos-60d.jpg</pictureUrl>
 <pictureUrl>http://canon.com/eos-60d-angle.jpg</pictureUrl>
 <pictureUrl type ="interior">http://canon.com/eos-60d-table.jpg</pictureUrl>
 <instructionUrl>http://canon.com/eos-60d.pdf</instructionUrl>
 <driversUrl>http://canon.com/eos-60d.zip</driversUrl>
 <barcode>1234567890123</barcode>
 <barcode>1234657654321</barcode>
 <announceDate>2016-04-01</announceDate>
 <inStockDate>2016-05-01</inStockDate>
 <addDate>2016-03-01</addDate>
 <updateDate>2016-06-01</updateDate>
 <isActual>true</isActual>
 <recomendedPrice currency="RUR">55000</recomendedPrice>
 <description>Зеркальная фотокамера любительского уровня.</description>
 <param name="Weight" unit="g">750</param>
 <param name="Bayonet mount">Canon EF/EF-S</param>
 <param name="Matrix type">CMOS</param>
 <param name="Crop factor">1.6</param>
 <param name="Matrix resolution" unit="Mpx">19</param>
 <param name="Red eye reduction">yes</param>
 <param name="GPS receiver">no</param>
 <param name="Maximum roll resolution">1920x1080</param>
 <rec type="component" isSupplement="true" innerId="167" marketId="7888908">Canon EF 50 mm f/1.8 STM objective</rec>
 <rec type="accessory" isSupplement="true" marketId="14210745">Camera bag Gadget Bag</rec>
 <rec type="consumable" isSupplement="true">Battery for Canon AcmePower AP-LP-E6</rec> 
 </model>
 </models>
 </vendor>
</yml_catalog>

Download example in XML format

Download XSD schema

Element description

Elements are optional unless stated otherwise.

Element

Description

yml_catalog

An XML file can only contain one root <yml_catalog> element.

The date attribute corresponds to the date and time when the vendor generated the XML file. Date format: YYYY-MM-DDThh:mm:ss.

Required element.

yml_catalog elements

vendor

Name of vendor or brand. If you need to send data about several vendors, describe each one using a separate <vendor> element.

Required element.

vendor elements

url

Link to vendor's official site; can enter several links.

categories

List of product-model categories.

Required element.

models

List of product-models.

Required element.

categories elements

category

Description of one category. Attributes:

  • id — category ID (mandatory)
  • parentId — ID of higher-level category (only mandatory for subcategories).

Required element.

Category names can be in English or Russian.

models elements

model

Name of one product-model. Attributes:

  • id — product-model ID (mandatory)
  • categoryId — ID of category that product-model belongs to (mandatory)

Required element.

model elements

name

Name of product-model. You do not need to specify the product category, type, vendor's name or specifications in the name element.

Required element.

Can be in English or Russian.

alias

Alternative name of product-model. You can specify multiple alias elements (but not more than 10) for one product-model.

Can be in English or Russian.

type

Product-model type. Specify this element if the category contains different types of products. For example, dolls and constructor sets in the “Children's products” category.

vendorCode

SKU (code assigned by vendor).

promoUrl

Link to product-model page on vendor's site.

pictureUrl

Link to image of product-model on vendor's site. There should be one element per link. You can enter several pictureUrl for one product-model.

instructionUrl

Link to product instructions on the vendor's site.

driversUrl

Link to product drivers on the vendor's site.

barcode

Product barcode.

announceDate

Date of product announcement.

Date format: yyyy-mm-dd.

inStockDate

Start date of official sales.

Date format: yyyy-mm-dd.

addDate

Date product-model description was added to catalog.

Date format: yyyy-mm-dd.

updateDate

Date changes were made to product specifications.

Date format: yyyy-mm-dd.

isActual

Product-model's relevance:

  • true — model in production

  • false — model no longer in production.

recomendedPrice

Recommended price. To report prices correctly, specify the currency ID using the currency attribute (possible values: RUR, RUB, USD, EUR, UAH, BYN, KZT).

description

Description of product-model.

Can only be in Russian.

param

Model parameters. Every parameter is described in a separate <param> element. You can specify multiple <param> elements for one product-model.

rec

Recommended or compatible product. Each product is described in a separate <rec> element. You can specify multiple <rec> elements for one product-model.