Маркет для магазинов

Формат YML

YML (Yandex Market Language) — это стандарт, разработанный Яндексом для принятия и размещения информации в базе данных Яндекс.Маркета. YML основан на стандарте XML.

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

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

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

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

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

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

<?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.ru/</url>
    <currencies>
      <currency id="RUR" rate="1"/>
      <currency id="USD" rate="80"/>
    </currencies>
    <categories>
      <category id="1278">Электроника</category>
      <category id="3761" parentId="1278">Телевизоры</category>
      <category id="1553" parentId="3761">Медиа-плееры</category>
      <category id="3798">Бытовая техника</category>
      <category id="1293" parentId="3798">Холодильники</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.ru/158.html</url>
        <price>55690</price>
        <currencyId>RUR</currencyId>
        <categoryId>1293</categoryId>
        <picture>http://www.abc.ru/1580.jpg</picture>
        <picture>http://www.abc.ru/1581.jpg</picture>
        <picture>http://www.abc.ru/1582.jpg</picture>
        <picture>http://www.abc.ru/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>Описание товара 1</description>
        <sales_notes>Необходима предоплата 50%</sales_notes>
        <barcode>7564756475648</barcode>
        <age>0</age>
        <manufacturer_warranty>false</manufacturer_warranty>
        <param name="Тип">моноблок</param>
        <param name="Материал">алюминий</param>
        <param name="Wi-Fi" unit="">есть</param>
        <param name="Размер экрана" unit="дюйм">27</param>
        <param name="Размер оперативной памяти" unit="Мб">4096</param>
        <param name="Объём жесткого диска" unit="Тб">1</param>
        <param name="Вес" unit="кг">13.8</param>
      </offer>
      <offer id="159" available="true" cbid="90">
        <url>http://www.abc.ru/159.html</url>
        <price>3045.5</price>
        <currencyId>RUR</currencyId>
        <categoryId>1293</categoryId>
        <picture>http://www.abc.ru/1590.jpg</picture>
        <picture>http://www.abc.ru/1591.jpg</picture>
        <store>false</store>
        <delivery>true</delivery>
        <name>Наушники Koss Sporta Pro</name>
        <vendor>Koss</vendor>
        <model>Sporta Pro</model>
        <description>Описание товара</description>
        <sales_notes>Покупка в день заказа</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="Тип">12344</param>
        <param name="Материал">пластик</param>
        <param name="Wi-Fi" unit="">да</param>
        <param name="Размер экрана" unit="дюйм">27</param>
        <param name="Размер оперативной памяти" unit="Мб">4096</param>
        <param name="Объём жесткого диска" unit="Тб">1</param>
        <param name="Вес" unit="кг">13.8</param>
      </offer>
    </offers>
  </shop>
</yml_catalog>

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

ЭлементОписание
xml header

Стандартный XML-заголовок. Должен начинаться с первой строки, с нулевого символа.

yml_catalog

Любой XML-документ может содержать только один корневой элемент. Формат YML в качестве корневого использует элемент <yml_catalog>. Атрибут date элемента <yml_catalog> должен соответствовать дате и времени генерации YML-файла на стороне магазина. Дата должна иметь формат YYYY-MM-DD hh:mm.

shop

Элемент содержит описание магазина и его товарных предложений.

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

name

Короткое название магазина, должно содержать не более 20 символов. В названии нельзя использовать слова, не имеющие отношения к наименованию магазина, например «лучший», «дешевый», указывать номер телефона и т. п.

Название магазина должно совпадать с фактическим названием магазина, которое публикуется на сайте. При несоблюдении данного требования наименование может быть изменено Яндекс.Маркетом самостоятельно без уведомления магазина.

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

company

Полное наименование компании, владеющей магазином. Не публикуется, используется для внутренней идентификации.

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

url

URL главной страницы магазина.

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

platform

Система управления контентом, на основе которой работает магазин (CMS).

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

version

Версия CMS.

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

agency

Наименование агентства, которое оказывает техническую поддержку магазину и отвечает за работоспособность сайта.

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

email

Контактный адрес разработчиков CMS или агентства, осуществляющего техподдержку.

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

currencies

Список курсов валют магазина.

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

categories

Список категорий магазина.

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

delivery-options

Стоимость и сроки курьерской доставки по своему региону.

Обязательный элемент, если все данные по доставке передаются в прайс-листе.

cpa

Элемент предназначен для управления участием товарных предложений в программе «Заказ на Маркете».

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

offers

Список предложений магазина. Каждое предложение описывается в отдельном элементе offer. Здесь не приводится список всех элементов, входящих в offer, так как он зависит от типа описания предложения. Для большинства категорий товаров подходят следующие типы описаний:

Для некоторых категорий товаров нужно использовать собственные типы описаний:

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

Оцените статью
Спасибо за ваш отзыв!