Маркет для производителей

Описание формата VendorYML

VendorYML — это формат, разработанный Яндексом для принятия и размещения информации в базе данных Яндекс.Маркета. VendorYML основан на стандарте XML (XML DTD). Единый формат представления данных позволяет быстро и качественно обрабатывать предоставляемую производителями информацию о товарах.

Требования к YML-файлу

  1. Стандарт YML не допускает использования непечатаемых символов с ASCII-кодами от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки).

  2. Символы ", &, >, <, ' нужно заменять на эквивалентные коды:

    Символ в тексте

    Код для YML-файла

    "
    &
    >
    <
    '
    &quot;
    &amp;
    &gt;
    &lt;
    &apos;
  3. URL-адрес товарного предложения на сайте магазина должен быть закодирован в соответствии со стандартом RFC-1738.

  4. Допустимые кодировки YML-файла: UTF-8, windows-1251.

Пример XML-файла

<?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="Название бренда">
    <url>http://www.brand-site.ru/</url>
    <url>http://www.brand-site2.ru/</url>
    <categories>
      <category id="1">Электроника</category>
      <category id="10" parentId="1">Фото</category>
      <category id="100" parentId="10">Компактные фотоаппараты</category>
      <category id="101" parentId="10">Зеркальные фотоаппараты</category>
      <category id="102" parentId="1">Видеокамеры</category>
      <category id="2">Хранение данных</category>
      <category id="11" parentId="2">Карты памяти</category>
      <category id="12" parentId="2">USB-flash накопители</category>
      <category id="13" parentId="2">Переносные жесткие диски</category>
    </categories>
    <models>
      <model id="12341" categoryId="10">
        <name>Название модели</name>
        <vendorCode>Дополнительное название модели</vendorCode>
        <promoUrl>http://www.brand.ru/model.html</promoUrl>
        <pictureUrl>http://www.brand.ru/model_BIG.jpg</pictureUrl>
        <pictureUrl>http://www.brand.ru/model_BIG2.jpg</pictureUrl>
        <pictureUrl>http://www.brand.ru/model_small.jpg</pictureUrl>
        <instructionUrl>http://www.brand.ru/instructions/model.pdf</instructionUrl>
        <driversUrl>http://www.brand.ru/drvs/model.html</driversUrl>
        <barcode>1234567890123</barcode>
        <barcode>1234567890000</barcode>
        <announceDate>2014-03-01</announceDate> 
        <inStockDate>2014-06-25</inStockDate>
        <isActual>true</isActual>
        <recomendedPrice currency="RUB">45000</recomendedPrice>
        <addDate>2010-05-11</addDate>
        <updateDate>2010-10-15</updateDate>
        <description>Описание в свободной форме</description> 
        <param name="Вес" unit="г">750</param>
        <param name="Байонет">Canon EF/EF-S</param>
        <param name="Тип матрицы">CMOS</param>
        <param name="Кроп-фактор">1.6</param>
        <param name="Разрешение матрицы" unit="Мп">19</param>
        <param name="Подавление эффекта красных глаз">есть</param>
        <param name="GPS-приемник">отсутствует</param>
        <param name="Максимальное разрешение роликов">1920x1080</param>
      </model>
    </models>
  </vendor>
</yml_catalog>

Скачать пример в формате XML

Скачать XSD схему

Описание элементов

Элемент

Описание

<yml_catalog>

XML-файл может содержать только один корневой элемент <yml_catalog>. Атрибут date должен соответствовать дате и времени генерации XML-файла на стороне производителя. Дата должна иметь формат YYYY-MM-DDThh:mm:ss.

Обязательный элемент.

<vendor>

Информация о производителе. Если нужно передать данные о нескольких производителях, описывайте каждого в отдельном элементе <vendor>.

Вложенные элементы: <url>, <categories>, <models>.

<url>

Ссылка на официальный сайт производителя, можно указывать несколько ссылок.

Необязательный элемент.

<categories>

Список категорий товаров.

Обязательный элемент.

<models>

Список моделей.

Обязательный элемент.