Стандарт YML (Yandex Market Language) разработан Яндексом и основан на стандарте XML.

SNPMarket использует расширенную версию YML, для охвата всего необходимого функционала.

Формат YML предоставляет больше возможностей и преимуществ, чем форматы XLS, CSV.

• В YML нельзя использовать непечатаемые символы с ASCII-кодами от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки).
• Кодировка YML файла - UTF-8.
• Символы " & > < ' нужно заменять на эквивалентные коды:

Примечание. Вы можете использовать символы " & > < ' в блоке CDATA в описании предложения.

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2017-02-05 17:22">
  <shop>
    ...
    <offers>
      ...     
    </offers>
  </shop>
</yml_catalog>

Элемент	Описание
xml header	Стандартный XML-заголовок. Должен начинаться с первой строки, с нулевого символа.
yml_catalog	Любой XML-документ может содержать только один корневой элемент. Формат YML в качестве корневого использует элемент <yml_catalog>. Атрибут date элемента <yml_catalog> должен соответствовать дате и времени генерации YML-файла на стороне магазина. Дата должна иметь формат YYYY-MM-DD hh:mm.
shop	Элемент содержит описание магазина (shop), его предложений (offers).

<shop>
  <name>BestSeller</name>
  <url>http://best.seller.ru</url>
  <company>Tne Best inc.</company>
  <categories>
    <category id="1">Бытовая техника</category>
    <category id="10" parentId="1">Мелкая техника для кухни</category>
    <category id="101" parentId="10">Сэндвичницы и приборы для выпечки</category>
    <category id="102" parentId="10">Мороженицы</category>
  </categories>
  <offers>
    ...
  </offers>
</shop>

Элемент	Описание
name	Короткое название магазина, не более 20 символов. В названии нельзя использовать слова, не имеющие отношения к наименованию магазина, например «лучший», «дешевый», указывать номер телефона и т. п. Название магазина должно совпадать с фактическим названием магазина, которое публикуется на сайте. При несоблюдении этого требования наименование SNPMarket может самостоятельно изменить название без уведомления магазина. Обязательный элемент.
url	URL главной страницы магазина. Максимум 50 символов. Допускаются кириллические ссылки.
company	Полное наименование компании, владеющей магазином. Не публикуется, используется для внутренней идентификации.
categories	Список категорий магазина.
category	Категория магазина. Должна содержать атрибут id и, если категория не корневая, атрибут parentId.
offers	Список предложений магазина. Каждое предложение описывается в отдельном элементе offer.

<offer id="12346">
  <availability>
    <count>1</count>
    <waiting>1</waiting>
  </availability>
  <name>Вафельница First FA-5300</name>
  <vendor>First</vendor>
  <vendorCode>A1234567B</vendorCode>
  <price>1490</price>
  <priceOpt>1300</priceOpt>
  <priceSNP>1000</priceSNP>
  <categoryId>101</categoryId>
  <url>http://best.seller.ru/product_page.asp?pid=12348</url>
  <picture>http://best.seller.ru/img/large_12348.jpg</picture>
  <description>
  <![CDATA[
    <h3>Мороженица Brand 3811</h3>
    <p>Это прибор, который придётся по вкусу всем любителям десертов и сладостей.</p>
  ]]>
  </description>
  <param name="Цвет">белый</param>
  <param name="Вес" unit="Кг.">1</param>
  <barcode>0156789012</barcode>
  <weight>10</weight>
  <dimensions>10/15/10</dimensions>
  <age unit="year">18</age>
  <pack>2</pack>
</offer>

Элемент	Описание	Обязательность
id	Идентификатор предложения. Может состоять только из цифр и латинских букв. Максимальная длина — 20 символов. Должен быть уникальным для каждого предложения.	Да
name	Полное название предложения, в которое входит: тип товара, производитель, название товара. Составляйте по схеме: что (тип товара) + кто (производитель) + товар (модель, название).	Да
price	Актуальная цена товара. (розница)	Нет
*priceOpt	Актуальная цена товара. (оптовая)	Нет
*priceSNP	Актуальная цена товара. (закупочная, для SNPMarket)	Да
categoryId	Идентификатор категории товара, присвоенный магазином (целое число, не более 18 знаков).	Да
*availability	Наличие товаров, требует заполненного count или waiting.	Да
*count	Кол-во товаров в наличии	Нет / Да
*waiting	Кол-во товаров, ожидаемых к поступлению	Нет / Да
vendor	Название производителя.	Нет
vendorCode	Код производителя для данного товара.	Нет
url	URL страницы товара на сайте магазина. Максимальная длина ссылки — 512 символов. Допускаются кириллические ссылки.	Нет
picture	URL-ссылка на картинку товара.	Нет
description	Описание предложения. Длина текста не более 3000 символов (включая знаки препинания). В описании запрещено указывать: Номера телефонов, адреса электронной почты, почтовые адреса, номера ICQ, логины мессенджеров, любые ссылки. Слова «скидка», «распродажа», «дешевый», «подарок» (кроме подарочных категорий), «бесплатно», «акция», «специальная цена», «новинка», «new», «аналог», «заказ», «хит». Условия продажи товара, например, данные об акциях или предоплате. Регион, в котором продается товар. Информацию о разных модификациях товара (например, нельзя писать «товар в ассортименте»). Для каждой модификации нужно создать отдельное предложение. В формате YML допустимо использовать следующие xhtml-теги <h3>...</h3>, <ul><li>...</li></ul>, <p>...</p>, <br/> при условии, что: они заключены в блок CDATA в формате <![CDATA[ Текст с использованием xhtml-разметки ]]>; соблюдены общие правила стандарта XHTML.	Нет
barcode	Штрихкод товара от производителя в одном из форматов: EAN-13, EAN-8, UPC-A, UPC-E.	Нет
param	Все важные характеристики товара — цвет, размер, объем, материал, вес, возраст, пол, и т. д. Атрибут unit указывается, если параметр имеет единицы измерения. В YML элемент offer может содержать несколько элементов param (один элемент param — одна характеристика).	Нет
weight	Вес товара в килограммах с учетом упаковки.	Нет
dimensions	Габариты товара (длина, ширина, высота) в упаковке. Размеры укажите в сантиметрах. Формат: три положительных числа с точностью 0.001, разделитель целой и дробной части — точка. Числа должны быть разделены символом «/» без пробелов.	Нет
age	Возрастная категория товара. SNPMarket обрабатывает данный параметр, если установлен атрибут unit="year" и значение равно 18.	Нет
*pack	Продается ли товар упаковками (например батарейки в блистере по 8 шт.). Если товар продается поштучно (пометрово и т.п.), то ничего указывать не нужно.	Нет

* Атрибуты, отмеченные звездочкой добавлены SNPMarket. Если Вы не можете добавить эти атрибуты в свой файл, необходимо сформировать дополнительную выгрузку.

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2017-02-05 17:22">
  <shop>
    <name>BestSeller</name>
    <company>Tne Best inc.</company>
    <url>http://best.seller.ru</url>
    <categories>
      <category id="1">Бытовая техника</category>
      <category id="10" parentId="1">Мелкая техника для кухни</category>
      <category id="101" parentId="10">Сэндвичницы и приборы для выпечки</category>
      <category id="102" parentId="10">Мороженицы</category>
    </categories>
    <offers>
      <offer id="12346">
        <availability>
          <count>1</count>
          <waiting>1</waiting>
        </availability>
        <name>Вафельница First FA-5300</name>
        <vendor>First</vendor>
        <vendorCode>A1234567B</vendorCode>
        <price>1490</price>
        <priceOpt>1300</priceOpt>
        <priceSNP>1000</priceSNP>
        <categoryId>101</categoryId>
        <url>http://best.seller.ru/product_page.asp?pid=12348</url>
        <picture>http://best.seller.ru/img/large_12348.jpg</picture>
        <description>
        <![CDATA[
          <h3>Мороженица Brand 3811</h3>
          <p>Это прибор, который придётся по вкусу всем любителям десертов и сладостей.</p>
        ]]>
        </description>
        <param name="Цвет">белый</param>
        <param name="Вес" unit="Кг.">1</param>
        <barcode>0156789012</barcode>
        <weight>10</weight>
        <dimensions>10/15/10</dimensions>
        <age unit="year">18</age>
        <pack>2</pack>
      </offer>
    </offers>
  </shop>
</yml_catalog>

Для удобства использования, SNPMarket добавил в YML элементы:

• availability
• count
• waiting
• pack
• priceOpt
• priceSNP

В случае, если Вы не можете модифицировать свой YML файл - необходимо прикрепить дополнительную выгрузку в следующем формате:

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2017-02-05 17:22">
  <shop>
    <offers>
      <offer id="12346">
        <availability>
          <count>1</count>
          <waiting>1</waiting>
        </availability>
        <pack>2</pack>
        <priceOpt>1000</priceOpt>
        <priceSNP>900</priceSNP>
      </offer>
    </offers>
  </shop>
</yml_catalog>

Элемент	Описание
yml_catalog	Атрибут date должен совпадать с данным атрибутом из основной выгрузки YML.
shop, offers	Элементы, необходимые для соблюдения стандарта YML.
id	Идентификатор предложения. Должен совпадать с идентификатором из основной выгрузки YML.
pack	Продается ли товар упаковками (например батарейки в блистере по 8 шт.). Если товар продается поштучно (пометрово и т.п.), то ничего указывать не нужно.
availability	Наличие товаров, требует заполненного count или waiting.
count	Кол-во товаров в наличии
waiting	Кол-во товаров, ожидаемых к поступлению
priceOpt	Актуальная цена товара. (оптовая) (Не обязательное поле)
priceSNP	Актуальная цена товара. (закупочная, для SNPMarket) (Обязательное поле)