Прайс в формате YML

Стандарт YML (Yandex Market Language) разработан Яндексом и основан на стандарте XML.Формат YML предоставляет больше возможностей и преимуществ, чем форматы XLS, CSV.

Содержание:
  1. Требования к YML-файлу
  2. Структура YML-файла
    1. Описание магазина (элемент <shop>).
    2. Описание товара (элемент <offers>)
  3. Как составить предложение для категории «Автошины»
    1. Пример полного описания товара (элемент <offers>):
    2. Пример полного файла YML (элемент <shop> и <offers>).
    3. Типичные ошибки

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

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

2. Структура YML-файла

<?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). Подробнее описано в следующем пункте.

2.1 Описание магазина (элемент <shop>).

<shop> <name>BestSeller</name> <company>Tne Best inc.</company> <url>http://best.seller.ru</url> <currencies> <currency id="RUR" rate="1"/> <currency id="USD" rate="60"/> </currencies> <categories> <category id="1">Авто</category> <category id="10" parentId="1">Шины</category> <category id="11" parentId="1">Колесные диски</category> </categories> <offers> ... </offers> </shop>
Элемент Описание
name

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

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

Пример:

<name>ШинМастер</name>

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

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

<company>ООО “ШинМастер”</company>

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

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

Пример:

<url>http://best.seller.ru</url>

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

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

Пример:

<currencies> <currency id="RUR" rate="1"/> <currency id="USD" rate="23.98"/> <currency id="EUR" rate="CBRF"/> <currency id="UAH" rate="NBU"/> </currencies>
  • CBRF — курс по Центральному банку РФ.
  • NBU — курс по Национальному банку Украины.

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

Список категорий Маркета Карпедии, по которым вы рекламируете товары.

Пример:

<category id="1">Авто</category> <category id="10" parentId="1">Шины</category> <category id="11" parentId="1">Колесные диски</category>

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

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

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

2.1 Описание товара (элемент <offers>).

Элемент Описание элемента Обязательность элемента
name

Полное название предложения, в которое входит: тип товара, производитель, название товара. Составляйте по схеме: что (тип товара) + кто (производитель) + товар(модель, название).

Пример:

<name>Автошина Michelin Pilot Sport 2 335/30 R18 102Y шип</name>

Примечание: В случае наличия в YML в элементах offer тегов и name, и model в качестве наименования товара будет загружаться name для всего прайс-листа. Если name отсутствует, то в загрузку пойдет model.

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

Название производителя.

Пример:

<vendor>Michelin</vendor>

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

Код производителя для данного товара.

Необязательный для:

  • Шины
  • Колесные диски
id

Идентификатор предложения в Вашей базе магазина. Может состоять только из цифр и латинских букв. Максимальная длина — 20 символов. Должен быть уникальным и неизменным для одного и того же товара от загрузки к загрузке прайс-листа.

Пример:

<offer id="123457" available="true">

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

Статус товара:

  • true — «в наличии» / «готов к отправке»
  • false — «на заказ»

Если элемент не указан, используется значение по умолчанию — true.

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

URL страницы товара на сайте магазина. Максимальная длина ссылки — 512 символов.

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

Актуальная цена товара.

Пример:

<price>6000</price>

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

Валюта, в которой указана цена товара: RUR, USD, EUR, UAH. Цена и валюта должны соответствовать друг другу. Например, вместе с USD надо указывать цену в долларах, а не в рублях.

Пример:

<currencyId>RUR</currencyId>

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

Идентификатор категории товара из блока <categories>. Конечная категория, к которой отнесен товар в прайс-листе, должна соответствовать таковой в каталоге Карпедии: (Автошины, Колесные диски)

Пример:

<categoryId>2</categoryId>

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

URL-ссылка на картинку товара.

Рекомендуем ознакомиться с требованиями к ссылке и изображению.

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

Описание предложения. Длина текста не более 3000 символов (включая знаки препинания).

Пример:

<description>Зимние шипованные шины с дорожным рисунком протектора.</description>

В описании запрещено указывать:

  • Номера телефонов, адреса электронной почты, почтовые адреса, номера ICQ, логины мессенджеров, любые ссылки.
  • Слова «скидка», «распродажа», «дешевый», «подарок»(кроме подарочных категорий), «бесплатно», «акция», «специальная цена», «новинка», «new», «аналог», «заказ», «хит».
  • Условия продажи товара, например, данные об акциях или предоплате (их нужно передавать в элементе sales_notes в YML / Условия продажи в XLS).
  • Регион, в котором продается товар.
  • Информацию о разных модификациях товара (например, нельзя писать «товар в ассортименте»). Для каждой модификации нужно создать отдельное предложение.

Необязательный элемент.
sales_notes
  • Элемент обязателен, если у вас есть ограничения при покупке (например, минимальное количество товаров или необходимость предоплаты).
  • Также можно указать варианты оплаты, акции и распродажи. В этом случае использование элемента необязательно.

Допустимая длина текста — 50 символов.

Пример:

<sales_notes>Минимальный заказ: 4 шт.</sales_notes>

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

3. Как составить предложение для категории «Автошины»

Чтобы система смогла соотнести ваше предложение с карточкой модели, укажите данные в теге <name>, в указанном порядке:

  1. Название производителя.
  2. Название модели.
  3. Ширину профиля шины.
  4. Серию шины (высоту профиля).
  5. Диаметр шины.
  6. Индекс нагрузки.
  7. Максимальную скорость (индекс).
  8. Наличие технологии RunFlat (если предусмотрено). Внимание! Необходимо всегда указывать наличие технологии RunFlat, даже если аналогичного типоразмера без технологии RunFlat не существует.
  9. Наличие шипов (если предусмотрено). Внимание! Необходимо всегда указывать наличие шипов, даже если модели с аналогичным типоразмером без шипов не существует.

Пример тега <name>:

<name>Автошина Nexen Winguard Spike 175/65 R14 86T шип</name>

3.1 Пример полного описания товара:

Вы хотите разместить предложение со следующими данными:

  • Производитель: Michelin.
  • Модель: Pilot Sport 2.
  • Ширина профиля: 335.
  • Высота профиля: 30.
  • Диаметр: 18.
  • Индекс нагрузки: 102.
  • Индекс скорости: Y.
  • Технология RunFlat
  • Код производителя: 61705360
  • Описание: Разработаны специально для легковых автомобилей класса спорт.
  • Минимальная партия 4 штуки.

В YML формате это должно выглядеть так:

<offer id="123457" available="true"> <url>http://www.tires.ru/product_page.asp?pid=12344</url> <price>6000</price> <currencyId>RUR</currencyId> <categoryId>10</categoryId> <picture>http://tires.ru/img/picture1.jpg</picture> <name>Автошина Michelin Pilot Sport 2 335/30 R18 102Y RunFlat </name> <vendor>Michelin</vendor> <vendorCode>61705360</vendorCode> <description>Разработаны специально для легковых автомобилей класса спорт.<description/> <sales_notes>Минимальная партия 4 штуки.</sales_notes> </offer>

3.2 Пример полного файла YML

<shop> <name>BestSeller</name> <company>Tne Best inc.</company> <url>http://best.seller.ru</url> <currencies> <currency id="RUR" rate="1"/> <currency id="USD" rate="60"/> </currencies> <categories> <category id="1">Авто</category> <category id="10" parentId="1">Шины</category> <category id="11" parentId="1">Колесные диски</category> </categories> <offer id="123457" available="true"> <url>http://www.tires.ru/product_page.asp?pid=12344</url> <price>6000</price> <currencyId>RUR</currencyId> <categoryId>10</categoryId> <picture>http://tires.ru/img/picture1.jpg</picture> <name>Автошина Michelin Pilot Sport 2 335/30 R18 102Y RunFlat </name> <vendor>Michelin</vendor> <vendorCode>61705360</vendorCode> <description>Разработаны специально для легковых автомобилей класса спорт.<description/> <sales_notes>Минимальная партия 4 штуки.</sales_notes> </offer> </shop>

3.3 Типичные ошибки

  1. Не указано название производителя.

    Пример

    <name>Автошина Hakkapeliitta 7 SUV 225/60 R17 103T</name>

    Правильное наименование для этого предложения:

    <name>Автошина Nokian Hakkapeliitta 7 SUV 225/60 R17 103T</name>
  2. Название модели указано не полностью.

    Пример

    <name>Автошина Nokian Hakka C 205/70 R15 106/104S</name>

    Производитель Nokian выпускает две модели автошин с похожими названиями: Hakka C Cargo и Hakka C Van. Необходимо указать полное название модели.

    Правильные наименования для этих предложений:

    <name>Автошина Nokian Hakka C Cargo 205/70 R15 106/104S</name>

    <name>Автошина Nokian Hakka C Van 205/70 R15 106/104S</name>
  3. Не указано наличие шипов.

    Пример

    <name>Автошина Nexen Winguard Spike 175/65 R14 86T</name>

    Производитель Nexen выпускает два варианта шин в этом типоразмере: с шипами и без. Если вы предлагаете вариант с шипами, укажите это в предложении. Если вы предлагаете вариант без шипов, дополнительно можно ничего не указывать.

    Правильное наименование предложения для варианта с шипами:

    <name>Автошина Nexen Winguard Spike 175/65 R14 86T шип</name>

    Правильное наименование предложения для варианта без шипов:

    <name>Автошина Nexen Winguard Spike 175/65 R14 86T</name>
  4. Не указано наличие технологии RunFlat.

    Пример

    <name>Автошина Michelin Pilot Sport PS2 335/25 R20 94Y</name>

    Производитель Michelin выпускает два варианта шин в этом типоразмере: с технологией RunFlat и без. Если вы предлагаете вариант с технологией RunFlat, укажите это в предложении. Если вы предлагаете вариант без технологии RunFlat, дополнительно можно ничего не указывать.

    Правильное наименование предложения для варианта с технологией RunFlat:

    <name>Автошина Michelin Pilot Sport PS2 335/25 R20 94Y RunFlat</name>

    Правильное наименование предложения для варианта без технологии RunFlat:

    <name>Автошина Michelin Pilot Sport PS2 335/25 R20 94Y</name>