Требования к формату и методу передачи данных о товарных предложениях

Методы передачи данных

Предусмотрены два метода передачи данных о товарных предложениях в Яндекс.Маркет:

  1. Рекламодатель может разместить файл с данными (прайс-лист) на сайте. При этом должны выполняться следующие требования:

    • Файл должен быть опубликован по URL-адресу, согласованному с компанией «Яндекс.Маркет», и доступен по протоколам HTTP или HTTPS (URL-адрес файла может не соответствовать URL-адресу магазина).

      Внимание. Недопустимо использование протокола FTP и портов, отличных от 80 и 443.
    • Допускается использование кириллических URL-адресов. Если вы используете кириллическую ссылку на файл, он может быть доступен только по протоколу HTTP.

    • Длина URL-адреса не должна превышать 512 символов.

    • В URL не должны использоваться спецсимволы \r, \n, \x00.

    • Поддержка HTTP-редиректов со стороны Яндекса не производится.

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

    В случае изменения URL-адреса файла и/или авторизационных данных рекламодатель должен внести соответствующие изменения в веб-интерфейсе клиента (личном кабинете).

  2. Рекламодатель может загрузить файл с данными через веб-интерфейс клиента (личный кабинет). Рекламодатель обязуется обновить материалы (товарные предложения) не позднее 30 календарных дней с даты предыдущей загрузки материалов указанным способом.

Форматы данных

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

Передаваемые данные по следующим категориям товаров должны соответствовать только спецификации формата YML:

  • «Мягкая мебель»;

  • «Компьютерные столы»;

  • «Массажные столы»;

  • «Одежда, обувь и аксессуары»;

  • «Косметика, парфюмерия и уход»;

  • «Детские товары» за исключением подкатегорий «Детские коляски», «Подгузники», «Автокресла», «Конструкторы», «Железные дороги», «Трехколесные велосипеды», «Кроватки»;

  • «Чехлы» (для мобильных телефонов);

  • «Защитные пленки и наклейки» (для мобильных телефонов);

  • «Зарядные устройства» (для мобильных телефонов);

  • «Переходники» (для мобильных телефонов);

  • «Сумки и чехлы для планшетов».

Допускается предоставление данных в упакованном виде (архиве) с помощью алгоритма сжатия GNU ZIP (суффикс gz) или алгоритма ZIP. Архив не должен называться «yandex», в наименовании не рекомендуется использовать заглавные буквы.

Примечание. Поддержка алгоритма ZIP Яндекс.Маркетом может быть отменена в любое время.
Время обработки переданных данных Яндекс.Маркетом:
  • Товарные предложения, для которых уже существуют карточки товаров, обрабатываются и соотносятся с карточками в течение 10 часов и могут не показываться в течение указанного периода.

  • Товарные предложения, для которых карточки товаров отсутствуют, обрабатываются в течение 10 часов и могут не показываться в течение указанного периода.

  • Товарные предложения, для которых карточки товаров должны быть сформированы впервые, обрабатываются в течение 48 часов и могут не показываться в течение указанного периода.

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

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

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

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

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

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

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

    "
    &
    >
    <
    '
    &quot;
    &amp;
    &gt;
    &lt;
    &apos;
    Примечание. Вы можете использовать символы ", &, >, <, 'в блоке CDATA в описании предложения.
  3. Допустимые кодировки YML-файла: UTF-8, windows-1251.

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

<?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>
    <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="101" parentId="10">Сэндвичницы и приборы для выпечки</category>
      <category id="102" parentId="10">Мороженицы</category>
    </categories>
    <offers>
      <offer id="12346" available="true" bid="80" cbid="90" fee="325">
        <url>http://best.seller.ru/product_page.asp?pid=12348</url>
        <price>1490</price>
        <oldprice>1620</oldprice>
        <currencyId>RUR</currencyId>
        <categoryId>101</categoryId>
        <picture>http://best.seller.ru/img/large_12348.jpg</picture>
        <store>false</store>
        <pickup>true</pickup>
        <delivery>true</delivery>
        <delivery-options>
          <option cost="300" days="0" order-before="12"/>
        </delivery-options>
        <name>Вафельница First FA-5300</name>
        <vendor>First</vendor>
        <vendorCode>A1234567B</vendorCode>
        <description>
        <![CDATA[
          <p>Отличный подарок для любителей венских вафель.</p>
        ]]>
        </description>
        <sales_notes>Необходима предоплата.</sales_notes>
        <manufacturer_warranty>true</manufacturer_warranty>
        <country_of_origin>Россия</country_of_origin>
        <barcode>0156789012</barcode>
        <cpa>1</cpa>
        <rec>123,456</rec>
      </offer>
      <offer id="9012" type="vendor.model" available="true" bid="80" cbid="90" fee="325">
        <url>http://best.seller.ru/product_page.asp?pid=12345</url>
        <price>8990</price>
        <oldprice>9900</oldprice>
        <currencyId>RUR</currencyId>
        <categoryId>102</categoryId>
        <picture>http://best.seller.ru/img/model_12345.jpg</picture>
        <store>false</store>
        <pickup>false</pickup>
        <delivery>true</delivery>
        <delivery-options>
          <option cost="300" days="1" order-before="18"/>
        </delivery-options>
        <outlets> 
          <outlet id="1" instock="50"/>
          <outlet id="2" instock="20"/>
        </outlets>
        <typePrefix>Мороженица</typePrefix>
        <vendor>Brand</vendor>
        <model>3811</model>
        <description>
        <![CDATA[
          <h3>Мороженица Brand 3811</h3>
          <p>Это прибор, который придётся по вкусу всем любителям десертов и сладостей, ведь с его помощью вы сможете делать вкусное домашнее мороженое из натуральных ингредиентов.</p>
        ]]>
        </description>
        <param name="Цвет">белый</param>
        <sales_notes>Необходима предоплата.</sales_notes>
        <manufacturer_warranty>true</manufacturer_warranty>
        <country_of_origin>Китай</country_of_origin>
        <barcode>0123456789379</barcode>
        <cpa>1</cpa>
        <rec>345,678</rec>
      </offer>
    </offers>
  </shop>
</yml_catalog>

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

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

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

yml_catalog

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

Элементы, входящие в yml_catalog
shop

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

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

Элементы, входящие в shop

name

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

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

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

company

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

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

url

URL главной страницы магазина. Максимальная длина — 50 символов. Допускаются кириллические ссылки.

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

platform

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

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

version

Версия CMS.

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

agency

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

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

email

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

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

currencies

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

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

categories

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

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

delivery-options

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

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

cpa

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

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

offers

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

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

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

Описание текстового формата с разделителями

Текстовый формат с разделителями (например: CSV, TSV) является универсальным форматом при генерации прайс-листа из баз данных или редакторов электронных таблиц (например: Exсel, OpenOffice, Google Docs).

Требования к прайс-листу в текстовом формате

  1. Одна строка файла должна соответствовать одной строке электронной таблицы.

  2. В качестве разделителя столбцов используется запятая или точка с запятой (CSV), либо символ табуляции (TSV).

  3. Одна строка файла должна содержать описание одного товарного предложения.

  4. Первая строка файла должна содержать названия элементов, описывающих товарные предложения.

  5. Кодировка файла должна быть UTF-8.

  6. Текстовый формат с разделителями не допускает использование символов табуляции и переноса строки внутри полей.

  7. Файл не должен содержать пустых столбцов.

  8. В текстовом формате с разделителями отсутствует строго заданный порядок элементов, но в пределах одного файла порядок элементов должен быть одинаковым.

Отличия текстового формата с разделителями от формата YML

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

  • В текстовом формате отсутствует возможность указать свои условия конвертации валют. Для отображения цены в локальной валюте она будет пересчитана в рубли и обратно по текущему курсу ЦБ РФ.

  • В формате YML категории выгружаются в виде дерева, в текстовом формате — плоским списком.

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

Формат XLS предназначен для упрощения передачи данных для магазинов, у которых информация об ассортименте хранится в редакторе электронных таблиц Exсel.

Требования к прайс-листу в формате XLS

  1. Первая строка электронной таблицы должна содержать названия элементов, описывающих товарные предложения.

  2. Одна строка файла должна содержать описание одного товарного предложения.

  3. Не допускается использование символов табуляции и переноса строки внутри ячеек таблицы.

  4. Файл не должен содержать пустых столбцов.

  5. Файл должен состоять из одного листа.

Отличия формата XLS от формата YML

  • В формате XLS отсутствует возможность передачи характеристик товара, используемых для фильтрации товарных предложений в результатах поиска Маркета.

  • В формате XLS отсутствует возможность указать свои условия конвертации валют. Для отображения цены в локальной валюте она будет пересчитана в рубли и обратно по текущему курсу ЦБ РФ.

  • В YML-формате категории выгружаются в виде дерева, в формате XLS — плоским списком.

Валидация файлов в формате XLS, CSV

При чтении файла проверяются следующие условия:

  • все названия элементов являются корректными;

  • присутствуют все обязательные элементы;

  • каждый элемент присутствует не более одного раза.

При невыполнении любого из этих условий файл отклоняется.

Типы описаний товарных предложений (для всех форматов)

Упрощенный тип описания

Пример в формате YML

Пример одного предложения (offer):

<offer id="12341" available="true" bid="80" cbid="90" fee="325">
  <url>http://best.seller.ru/product_page.asp?pid=12345</url>
  <price>8990</price>
  <oldprice>9900</oldprice>
  <currencyId>RUR</currencyId>
  <categoryId>102</categoryId>
  <picture>http://best.seller.ru/img/model_12345.jpg</picture>
  <store>false</store>
  <pickup>false</pickup>
  <delivery>true</delivery>
  <delivery-options>
    <option cost="300" days="1" order-before="18"/>
  </delivery-options>
  <outlets> 
    <outlet id="1" instock="50"/>
    <outlet id="2" instock="20"/>
  </outlets>
  <vendor>Brand</vendor>
  <name>Мороженица Brand 3811</name>>
  <description>
  <![CDATA[
    <h3>Мороженица Brand 3811</h3>
    <p>Это прибор, который придётся по вкусу всем любителям десертов и сладостей, ведь с его помощью вы сможете делать вкусное домашнее мороженое из натуральных ингредиентов.</p>
  ]]>
  </description>
  <param name="Цвет">белый</param>
  <sales_notes>Необходима предоплата.</sales_notes>
  <manufacturer_warranty>true</manufacturer_warranty>
  <country_of_origin>Китай</country_of_origin>
  <barcode>0123456789379</barcode>
  <cpa>1</cpa>
  <rec>789,120</rec>
</offer>

Скачать пример полностью заполненного прайс-листа

Пример для формата CSV

Скачать пример прайс-листа

Пример для формата XLS

Скачать пример прайс-листа

Элементы, специфичные для упрощенного типа описания Описание элемента Обязательность элемента

name

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

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

model

Модель.

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

vendor

Производитель.

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

vendorCode

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

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

Стандартные элементы Описание Обязательность элемента

id

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

В YML является атрибутом для offer.

Подробное описание элемента.

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

cbid

Размер ставки для карточки модели.

Является атрибутом для offer.

Подробное описание атрибута.

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

bid

Размер ставки на остальных местах размещения (кроме карточки модели).

Является атрибутом для offer.

Подробное описание атрибута.

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

fee

Размер комиссии на товарное предложение, участвующее в программе «Заказ на Маркете».

Является атрибутом для offer.

Подробное описание атрибута.

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

url

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

Обязательный элемент для интернет-магазинов.

price

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

Для следующих категорий, при условии, что прайс-лист передается в формате YML, допускается указывать начальную цену «от» с помощью атрибута from="true":

«Банкетки и скамьи»; «Ванные комнаты»; «Гостиные»;

«Детские»; «Детские комоды»; «Диваны»; «Кабинеты»;

«Колыбели и люльки»; «Комоды»; «Компьютерные столы»;

«Кресла»; «Кровати»; «Кухонные гарнитуры»;

«Кухонные уголки и обеденные группы»;

«Манежи»; «Парты и стулья»; «Полки»; «Прихожие»;

«Пуфики»; «Спальни»; «Стеллажи»; «Столы и столики»;

«Стулья, табуретки»; «Тумбы»; «Шкафы».

Пример: <price from="true">2000</price>

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

oldprice

Старая цена на товар, которая обязательно должна быть выше новой цены (price). Параметр oldprice необходим для автоматического расчета скидки на товар.

Примечание. Скидка обновляется на Маркете каждые 40–80 минут.

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

currencyId

Идентификатор валюты товара (RUR, USD, UAH, KZT, BYN). Для корректного отображения цены в национальной валюте необходимо использовать идентификатор с соответствующим значением цены (например, UAH с ценой в гривнах).

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

categoryId

Внимание. Используется только в формате YML.

Идентификатор категории товара, присвоенный магазином (целое число не более 18 знаков). Товарное предложение может принадлежать только одной категории.

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

category

Внимание. Используется только в форматах XLS, CSV.

Название категории товара. Товарное предложение может принадлежать только одной категории.

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

picture

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

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

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

delivery

Возможность курьерской доставки соответствующего товара.

Возможные значения:

  • true — товар может быть доставлен курьером.

  • false — товар не может быть доставлен курьером (только самовывоз);

Внимание. Элемент delivery должен обязательно иметь значение false, если товар запрещен к дистанционной торговле (ювелирные изделия, лекарственные средства, алкогольная продукция).

Если элемент не указан, то принимается значение по умолчанию, см. подробное описание элемента.

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

delivery-options

Внимание. Используется только в формате YML.

Условия курьерской доставки товара по своему региону (виды доставки, сроки, стоимость).

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

Подробное описание элемента.

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

local_delivery_days

Внимание. Используется только в форматах XLS, CSV.

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

Доставка в день заказа (сегодня) — значение 0,  доставка на следующий день (завтра) — значение 1 и т. д. Также можно указать период «от — до» дней, например: 2–4.

Внимание. При указании периода «от — до» разброс минимального и максимального срока доставки должен составлять не более трех дней.

Максимальное значение, показываемое на Маркете — 31 день. Значение 32 и больше (либо значение не указано вообще) — показывается надпись «на заказ».

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

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

local_delivery_cost

Внимание. Используется только в форматах XLS, CSV.

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

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

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

pickup

Возможность самовывоза из пунктов выдачи.

Возможные значения:

  • true — товар можно забрать в пунктах выдачи («самовывозом»);

  • false — товар нельзя забрать в пунктах выдачи.

Если элемент не указан, то принимается значение по умолчанию, см. подробное описание элемента.

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

available

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

true — «готов к отправке»

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

false — «на заказ»
Точный срок доставки курьером или в пункт выдачи неизвестен. Срок будет согласован с покупателем персонально (максимальный срок — два месяца). На Яндекс.Маркете сроки не показываются, показывается надпись «на заказ».
Внимание. Элемент используется в дополнение к данным, настроенным в личном кабинете. Элемент не используется, когда условия локальной курьерской доставки настроены в прайс-листе (любого формата).

В YML является атрибутом для offer. Если элемент не указан, используется значение по умолчанию — true.

Подробное описание элемента.
Необязательный элемент.

store

Возможность купить товар в розничном магазине.

Возможные значения:

  • true — товар можно купить в розничных магазинах.

  • false — возможность покупки в розничных магазинах отсутствует;

Если элемент не указан, то принимается значение по умолчанию, см. подробное описание элемента.

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

outlets
Внимание. Используется только в формате YML.

В элементе указывается:

  • количество товара в точке продаж (пункте выдачи или розничном магазине);

  • доступность товара для бронирования.

Подробное описание элемента.

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

description

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

  • давать инструкции по применению, установке или сборке;

  • использовать слова «скидка», «распродажа», «дешевый», «подарок» (кроме подарочных категорий), «бесплатно», «акция», «специальная цена», «только», «новинка», «new», «аналог», «заказ», «хит»;

  • указывать номера телефонов, адреса электронной почты, почтовые адреса, номера ICQ, логины мессенджеров, любые URL-ссылки.

В формате YML допустимо использовать следующие xhtml-теги <h3>...</h3>, <ul><li>...</li></ul>, <p>...</p>, <br/> при условии, что:

  • они заключены в блок CDATA в формате <![CDATA[Текст с использованием xhtml-разметки]]>;

  • соблюдены общие правила стандарта XHTML.

Подробное описание элемента.

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

sales_notes

Элемент используется для отражения информации о:

  • минимальной сумме заказа, минимальной партии товара, необходимости предоплаты (указание элемента обязательно, если имеются такие условия);

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

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

См. подробное описание элемента.
min-quantity

Минимальное количество одинаковых товаров в одном заказе (для случаев, когда покупка возможна только комплектом, а не поштучно). Элемент используется только в категориях «Автошины», «Грузовые шины», «Мотошины», «Диски».

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

Подробное описание элемента.

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

step-quantity

Количество товара, которое покупатель может добавлять к минимальному в корзине Яндекс.Маркета. Элемент используется в дополнение к min-quantity и только в категориях «Автошины», «Грузовые шины», «Мотошины», «Диски».

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

Подробное описание элемента.

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

manufacturer_warranty

Элемент предназначен для отметки товаров, имеющих официальную гарантию производителя.

Возможные значения:

1) false — товар не имеет официальной гарантии;

2) true — товар имеет официальную гарантию.

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

country_of_origin

Элемент предназначен для указания страны производства товара. Список стран, которые могут быть указаны в этом элементе, доступен по адресу: http://partner.market.yandex.ru/pages/help/Countries.pdf.

Примечание. Если вы хотите участвовать в программе «Заказ на Маркете», то желательно указывать данный элемент.

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

adult

Элемент обязателен для обозначения товара, имеющего отношение к удовлетворению сексуальных потребностей, либо иным образом эксплуатирующего интерес к сексу.

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

age

Возрастная категория товара.

В форматах XLS, CSV:
Можно указывать только годы. Допустимые значения: 0, 6, 12, 16, 18.
В форматеYML:
  • Годы задаются с помощью атрибута unit со значением year. Допустимые значения параметра age при unit="year": 0, 6, 12, 16, 18.

  • Месяцы задаются с помощью атрибута unit со значением month. Допустимые значения параметра age при unit="month": 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12.

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

barcode

Штрихкод товара, указанный производителем. В формате YML элемент offer может содержать несколько элементов barcode.

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

cpa

С помощью элемента можно управлять участием предложений в программе «Заказ на Маркете». Допустимые значения:

  • 1 — товар можно заказать прямо на Маркете;

  • 0 — товар нельзя заказать на Маркете (только на сайте магазина).

Если значение не указано, по умолчанию считается, что товар можно заказать на Маркете.

Внимание.

Элемент должен обязательно иметь значение 0, если:

  • товар запрещен к дистанционной торговле (ювелирные изделия, лекарственные средства).

  • цена товара ниже минимальной суммы заказа.

Подробное описание элемента.

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

param

Внимание. Используется только в формате YML.

Элемент предназначен для указания характеристик товара. Для описания каждого параметра используется отдельный элемент param.

В формате YML элемент offer может содержать несколько элементов param.

Подробное описание элемента.

Для части категорий является обязательным элементом.

См. подробное описание элемента.

expiry

Элемент предназначен для указания срока годности / срока службы либо для указания даты истечения срока годности / срока службы.

Значение элемента должно быть в формате ISO8601:

— для срока годности / срока службы: P1Y2M10DT2H30M. Расшифровка примера — 1 год, 2 месяца, 10 дней, 2 часа и 30 минут;

— для даты истечения срока годности / срока службы: YYYY-MM-DDThh:mm.

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

weight

Элемент предназначен для указания веса товара. Вес указывается в килограммах с учетом упаковки.

Формат элемента: положительное число с точностью 0.001, разделитель целой и дробной части — точка.

При указании более высокой точности значение автоматически округляется следующим способом:

  • если четвертый знак после разделителя меньше 5, то третий знак сохраняется, а все последующие обнуляются;

  • если четвертый знак после разделителя больше или равен 5, то третий знак увеличивается на единицу, а все последующие обнуляются.

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

dimensions

Элемент предназначен для указания габаритов товара (длина, ширина, высота) в упаковке. Размеры указываются в сантиметрах.

Формат элемента: три положительных числа с точностью 0.001, разделитель целой и дробной части — точка. Числа должны быть разделены символом «/» без пробелов.

При указании более высокой точности значение автоматически округляется следующим способом:

  • если четвертый знак после разделителя меньше 5, то третий знак сохраняется, а все последующие обнуляются;

  • если четвертый знак после разделителя больше или равен 5, то третий знак увеличивается на единицу, а все последующие обнуляются.

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

downloadable

Элемент предназначен для обозначения товара, который можно скачать. Если указано значение параметра true, товарное предложение показывается во всех регионах независимо от регионов доставки, указанных магазином на странице Общие настройки.

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

group_id
Внимание. Элемент используется только в формате YML и только в категориях Одежда, обувь и аксессуары, Мебель, Косметика, парфюмерия и уход, Детские товары, Аксессуары для портативной электроники.

Элемент используется в описаниях всех предложений, которые являются вариациями одной модели, при этом элемент должен иметь одинаковое значение. Значение должно быть целым числом, максимум 9 разрядов.

Является атрибутом элемента offer.

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

rec

Внимание. Используется только в формате YML.

Элемент предназначен для передачи рекомендованных товаров.

Подробное описание элемента.

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

Произвольный тип описания

Пример для формата YML

Пример одного предложения (offer):

<offer id="9012" type="vendor.model" available="true" bid="80" cbid="90" fee="325">
  <url>http://best.seller.ru/product_page.asp?pid=12345</url>
  <price>8990</price>
  <oldprice>9900</oldprice>
  <currencyId>RUR</currencyId>
  <categoryId>102</categoryId>
  <picture>http://best.seller.ru/img/model_12345.jpg</picture>
  <store>false</store>
  <pickup>false</pickup>
  <delivery>true</delivery>
  <delivery-options>
    <option cost="300" days="1" order-before="18"/>
  </delivery-options>
  <outlets> 
    <outlet id="1" instock="50"/>
    <outlet id="2" instock="20"/>
  </outlets>
  <typePrefix>Мороженица</typePrefix>
  <vendor>Brand</vendor>
  <model>3811</model>
  <description>
  <![CDATA[
    <h3>Мороженица Brand 3811</h3>
    <p>Это прибор, который придётся по вкусу всем любителям десертов и сладостей, ведь с его помощью вы сможете делать вкусное домашнее мороженое из натуральных ингредиентов.</p>
  ]]>
  </description>
  <param name="Цвет">белый</param>
  <sales_notes>Необходима предоплата.</sales_notes>
  <manufacturer_warranty>true</manufacturer_warranty>
  <country_of_origin>Китай</country_of_origin>
  <barcode>0123456789379</barcode>
  <cpa>1</cpa>
  <rec>345,678</rec>
</offer>

Скачать пример полностью заполненного прайс-листа

Пример для формата CSV

Скачать пример прайс-листа

Пример для формата XLS

Скачать пример прайс-листа

Элементы, специфичные для произвольного типа описания Описание элемента Обязательность элемента

type

Тип описания предложения. Значение должно быть vendor.model.

В YML является атрибутом для offer.

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

model

Модель.

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

vendor

Производитель.

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

vendorCode

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

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

typePrefix

Тип / категория товара (например, «мобильный телефон», «стиральная машина», «угловой диван»).

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

Стандартные элементы произвольного описания соответствуют стандартным элементам упрощенного описания. См. таблицу выше.

Тип описания «Лекарства»

Аптечный магазин обязан использовать данный тип описания для всех товаров, которые являются зарегистрированными:

  • лекарственными препаратами и средствами;

  • биологически активными добавками (БАД).

Внимание.
  • Не принимаются к публикации на Маркете предложения на препараты, подлежащие предметно-количественному учету.

  • Аптечный магазин должен предоставить Маркету копию лицензии на фармацевтическую деятельность (включая приложения), а также оригинал подписанного гарантийного письма.

  • Аптечный магазин должен обязательно создать точки продаж в личном кабинете.

Пример для формата YML
<offer id="12345" available="true" type="medicine" bid="80" cbid="90">
  <currencyId>RUB</currencyId>
  <categoryId>4062</categoryId>
  <name>БАД Селен-актив n30 таблетки</name>
  <vendor>ОАО ДИОД Завод эко.тех.и питания</vendor>
  <vendorCode>123456</vendorCode>
  <url>http://www.example-apteka.ru/selen-aktiv.html</url>
  <picture>http://www.example-apteka.ru/selen-aktiv.jpg</picture>
  <price>1000</price>
  <delivery>false</delivery>
  <pickup>true</pickup>
  <store>true</store>
  <barcode>4981046350037</barcode>
  <sales_notes>Самовывоз возможен через 3 часа после заказа</sales_notes>
  <description>Биоусвояемый селен 50 мкг, витамин С 50 мг. Селен-актив обеспечивает оптимальную и постоянную антиоксидантную защиту.</description>
  <country_of_origin>Россия</country_of_origin>
  <expiry>P1Y2M10DT2H30M</expiry>
  <param name="Побочные действия">нет</param>
  <param name="Код egk">123456</param>
</offer>

Пример для формата XLS: скачать

Тип описания «Лекарства» по структуре соответствует упрощенному описанию, однако некоторые элементы не используются либо должны иметь строго определенные значения. Поэтому для данного типа описания приводится полный список элементов:

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

type

Тип описания предложения.

Внимание. Значение обязательно должно быть medicine.

В YML является атрибутом для offer.

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

Возможность забрать товар в пункте выдачи (самовывоз).

Внимание. Значение обязательно должно бытье true.
Обязательный элемент.
available

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

true — «готов к отправке в пункт выдачи»

Товар будет доступен в пункте выдачи в указанные сроки. На Яндекс.Маркете показываются сроки, настроенные в личном кабинете.

false — «на заказ»
Точный срок поставки в пункт выдачи неизвестен. Срок будет согласован с покупателем персонально (максимальный срок — два месяца). На Яндекс.Маркете сроки не показываются, показывается надпись «на заказ».

В YML является атрибутом для offer. Если элемент не указан, используется значение по умолчанию — true.

Подробное описание элемента.
Обязательный элемент.
delivery

Возможность курьерской доставки товара.

Внимание. Значение обязательно должно быть false.
Обязательный элемент.
cpa

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

Если магазин не участвует в программе, использовать данный элемент не требуется.

Обязательный элемент, если магазин участвует в программе.
param
Внимание. Используется только в формате YML.

Характеристики и параметры лекарства. Для описания каждого параметра используется отдельный элемент param. Элемент offer может содержать несколько элементов param.

Один из параметров, который следует указать в <param>, — код лекарства в Едином городском классификаторе (ЕГК).

Подробное описание элемента.

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

name

Название товарного предложения: тип товара (БАД, лекарственный препарат, медицинское изделие и т. п.) + торговое название препарата.

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

vendor

Производитель.

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

vendorCode

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

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

id

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

В YML является атрибутом для offer.

Подробное описание элемента.

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

bid

Размер ставки на остальных местах размещения (кроме карточки модели).

Является атрибутом для offer.

Подробное описание атрибута.

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

cbid

Размер ставки для карточки модели.

Является атрибутом для offer.

Подробное описание атрибута.

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

url

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

Обязательный элемент для интернет-магазинов.

price

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

Для следующих категорий, при условии, что прайс-лист передается в формате YML, допускается указывать начальную цену «от» с помощью атрибута from="true":

«Банкетки и скамьи»; «Ванные комнаты»; «Гостиные»;

«Детские»; «Детские комоды»; «Диваны»; «Кабинеты»;

«Колыбели и люльки»; «Комоды»; «Компьютерные столы»;

«Кресла»; «Кровати»; «Кухонные гарнитуры»;

«Кухонные уголки и обеденные группы»;

«Манежи»; «Парты и стулья»; «Полки»; «Прихожие»;

«Пуфики»; «Спальни»; «Стеллажи»; «Столы и столики»;

«Стулья, табуретки»; «Тумбы»; «Шкафы».

Пример: <price from="true">2000</price>

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

oldprice

Старая цена на товар, которая обязательно должна быть выше новой цены (price). Параметр oldprice необходим для автоматического расчета скидки на товар.

Примечание. Скидка обновляется на Маркете каждые 40–80 минут.

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

currencyId

Идентификатор валюты товара (RUR, USD, UAH, KZT, BYN). Для корректного отображения цены в национальной валюте необходимо использовать идентификатор с соответствующим значением цены (например, UAH с ценой в гривнах).

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

categoryId

Внимание. Используется только в формате YML.

Идентификатор категории товара, присвоенный магазином (целое число не более 18 знаков). Товарное предложение может принадлежать только одной категории.

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

category

Внимание. Используется только в форматах XLS, CSV.

Название категории товара. Товарное предложение может принадлежать только одной категории.

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

picture

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

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

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

store

Возможность купить товар в розничном магазине.

Возможные значения:

  • true — товар можно купить в розничных магазинах.

  • false — возможность покупки в розничных магазинах отсутствует;

Если элемент не указан, то принимается значение по умолчанию, см. подробное описание элемента.

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

outlets
Внимание. Используется только в формате YML.

В элементе указывается:

  • количество товара в точке продаж (пункте выдачи или розничном магазине);

  • доступность товара для бронирования.

Подробное описание элемента.

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

description

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

  • давать инструкции по применению, установке или сборке;

  • использовать слова «скидка», «распродажа», «дешевый», «подарок» (кроме подарочных категорий), «бесплатно», «акция», «специальная цена», «только», «новинка», «new», «аналог», «заказ», «хит»;

  • указывать номера телефонов, адреса электронной почты, почтовые адреса, номера ICQ, логины мессенджеров, любые URL-ссылки.

В формате YML допустимо использовать следующие xhtml-теги <h3>...</h3>, <ul><li>...</li></ul>, <p>...</p>, <br/> при условии, что:

  • они заключены в блок CDATA в формате <![CDATA[Текст с использованием xhtml-разметки]]>;

  • соблюдены общие правила стандарта XHTML.

Подробное описание элемента.

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

sales_notes

Элемент используется для отражения информации о:

  • минимальной сумме заказа, минимальной партии товара, необходимости предоплаты (указание элемента обязательно, если имеются такие условия);

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

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

См. подробное описание элемента.

country_of_origin

Элемент предназначен для указания страны производства товара. Список стран, которые могут быть указаны в этом элементе, доступен по адресу: http://partner.market.yandex.ru/pages/help/Countries.pdf.

Примечание. Если вы хотите участвовать в программе «Заказ на Маркете», то желательно указывать данный элемент.

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

barcode

Штрихкод товара, указанный производителем. В формате YML элемент offer может содержать несколько элементов barcode.

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

expiry

Элемент предназначен для указания срока годности / срока службы либо для указания даты истечения срока годности / срока службы.

Значение элемента должно быть в формате ISO8601:

— для срока годности / срока службы: P1Y2M10DT2H30M. Расшифровка примера — 1 год, 2 месяца, 10 дней, 2 часа и 30 минут;

— для даты истечения срока годности / срока службы: YYYY-MM-DDThh:mm.

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

weight

Элемент предназначен для указания веса товара. Вес указывается в килограммах с учетом упаковки.

Формат элемента: положительное число с точностью 0.001, разделитель целой и дробной части — точка.

При указании более высокой точности значение автоматически округляется следующим способом:

  • если четвертый знак после разделителя меньше 5, то третий знак сохраняется, а все последующие обнуляются;

  • если четвертый знак после разделителя больше или равен 5, то третий знак увеличивается на единицу, а все последующие обнуляются.

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

dimensions

Элемент предназначен для указания габаритов товара (длина, ширина, высота) в упаковке. Размеры указываются в сантиметрах.

Формат элемента: три положительных числа с точностью 0.001, разделитель целой и дробной части — точка. Числа должны быть разделены символом «/» без пробелов.

При указании более высокой точности значение автоматически округляется следующим способом:

  • если четвертый знак после разделителя меньше 5, то третий знак сохраняется, а все последующие обнуляются;

  • если четвертый знак после разделителя больше или равен 5, то третий знак увеличивается на единицу, а все последующие обнуляются.

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

Тип описания «Книги»

Пример для формата YML
<offer id="12342" type="book" available="true" bid="80">
  <url>http://best.seller.ru/product_page.asp?pid=14345</url>
  <price>80</price>
  <oldprice>90</oldprice>
  <currencyId>RUR</currencyId>
  <categoryId>3</categoryId>
  <picture>http://best.seller.ru/product_page.asp?pid=14345.jpg</picture>
  <store>false</store>
  <pickup>false</pickup>
  <delivery>true</delivery>
  <delivery-options>
    <option cost="200" days="1"/>
  </delivery-options>
  <author>Александра Маринина</author>
  <name>Все не так. В 2 томах. Том 1</name>
  <publisher>Эксмо</publisher>
  <series>А. Маринина — королева детектива</series>
  <year>2007</year>
  <ISBN>978-5-699-23647-3</ISBN>
  <volume>2</volume>
  <part>1</part>
  <language>rus</language>
  <binding>70x90/32</binding>
  <page_extent>288</page_extent>
  <description>
    Все прекрасно в большом патриархальном семействе Руденко...
  </description>
  <downloadable>false</downloadable>
  <age unit="year">18</age>
</offer>
Элементы, специфичные для данного типа описания Описание элемента Обязательность элемента

name

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

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

author

Автор произведения.

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

publisher

Издательство.

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

series

Серия.

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

year

Год издания.

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

ISBN

International Standard Book Number — международный уникальный номер книжного издания, если их несколько, то указываются через запятую.

Форматы ISBN и SBN проверяются на корректность. Валидация кодов происходит не только по длине, также проверяется контрольная цифра (check-digit) — последняя цифра кода должна согласовываться с остальными цифрами по определенной формуле. При разбиении ISBN на части при помощи дефиса (например, 978-5-94878-004-7) код проверяется на соответствие дополнительным требованиям к количеству цифр в каждой из частей.

Обязателен для попадания на карточку книжного издания.

volume

Количество томов.

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

part

Номер тома.

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

language

Язык произведения.

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

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

table_of_contents

Оглавление. Выводится информация о названиях произведений, если это сборник рассказов или стихов.

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

type

Тип описания предложения. Для описания книг значение должно быть book.

В YML является атрибутом для offer.

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

binding

Переплет.

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

page_extent

Количество страниц в книге, должно быть целым положительным числом.

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

Стандартные элементы описания «Книги» соответствуют стандартным элементам упрощенного описания. См. таблицу выше.

Тип описания «Аудиокниги»

Пример для формата YML
<offer id="12342" type="audiobook" available="true" bid="80">
  <url>http://best.seller.ru/product_page.asp?pid=14345</url>
  <price>200</price>
  <oldprice>250</oldprice>
  <currencyId>RUR</currencyId>
  <categoryId>3</categoryId>
  <picture>http://best.seller.ru/product_page.asp?pid=14345.jpg</picture>
  <author>Владимир Кунин</author>
  <name>Иваnов и Rабинович, или Аj'гоу ту 'Хаjфа!</name>
  <publisher>1С-Паблишинг, Союз</publisher>
  <year>2008</year>
  <ISBN>978-5-9677-0757-5</ISBN>
  <language>ru</language>
  <performed_by>Николай Фоменко</performed_by>
  <performance_type>начитана </performance_type>
  <storage>CD</storage>
  <format>mp3</format>
  <description>
    Перу Владимира Кунина принадлежат десятки сценариев к кинофильмам, серия книг про КЫСЮ и многое, многое другое.
  </description>
  <downloadable>true</downloadable>
  <age unit="year">18</age>
</offer>
Элементы, специфичные для данного типа описания Описание элемента Обязательность элемента

name

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

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

author

Автор произведения.

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

publisher

Издательство.

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

series

Серия.

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

year

Год издания.

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

ISBN

International Standard Book Number — международный уникальный номер книжного издания, если их несколько, то указываются через запятую.

Форматы ISBN и SBN проверяются на корректность. Валидация кодов происходит не только по длине, также проверяется контрольная цифра (check-digit) — последняя цифра кода должна согласовываться с остальными цифрами по определенной формуле. При разбиении ISBN на части при помощи дефиса (например, 978-5-94878-004-7) код проверяется на соответствие дополнительным требованиям к количеству цифр в каждой из частей.

Обязателен для попадания на карточку книжного издания.

volume

Количество томов.

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

part

Номер тома.

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

language

Язык произведения.

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

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

table_of_contents

Оглавление. Выводится информация о названиях произведений, если это сборник рассказов или стихов.

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

type

Тип описания предложения. Для описания аудиокниг значение должно быть audiobook.

В YML является атрибутом для offer.

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

performed_by

Исполнитель. Если их несколько, перечисляются через запятую.

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

performance_type

Тип аудиокниги (радиоспектакль, «произведение начитано» и т.п.).

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

storage

Носитель, на котором поставляется аудиокнига.

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

format

Формат аудиокниги.

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

recording_length

Время звучания задается в формате mm.ss (минуты.секунды).

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

Стандартные элементы описания «Аудиокниги» соответствуют стандартным элементам упрощенного описания. См. таблицу выше.

Тип описания «Музыкальная и видеопродукция»

Пример видеопродукции для формата YML
<offer id="12344" type="artist.title" available="true" bid="80">
  <url>http://best.seller.ru/product_page.asp?pid=92347</url>
  <price>93</price>
  <oldprice>100</oldprice>
  <currencyId>RUR</currencyId>
  <categoryId>2</categoryId>
  <picture>http://best.seller.ru/img/device92347.jpg</picture>
  <store>false</store>
  <pickup>false</pickup>
  <delivery>true</delivery>
  <title>Свадьба Мюриэл</title>
  <year>1999</year>
  <media>DVD</media>
  <starring>Тони Колетт (Toni Collette), Рэйчел Грифитс (Rachel Griffiths)</starring>
  <director>П Дж Хоген</director>
  <originalName>Muriel's wedding</originalName>
  <country>Австралия</country>
  <description>
    Гадкий утенок из провинциального городка покидает свое гнездо, и в компании своей подруги отправляется искать веселой жизни в большой и загадочный город...
  </description>
  <age unit="year">18</age>
  <barcode>3456789012345</barcode>
</offer>
Пример музыкальной продукции для формата YML
<offer id="12345" type="artist.title" available="true" bid="80">
  <url>http://best.seller.ru/product_page.asp?pid=12946</url>
  <price>450</price>
  <oldprice>500</oldprice>
  <currencyId>USD</currencyId>
  <categoryId>2</categoryId>
  <picture>http://best.seller.ru/product_page.asp?pid=14345.jpg</picture>
  <store>false</store>
  <pickup>false</pickup>
  <delivery>true</delivery>
  <artist>Pink Floyd</artist>
  <title>Dark Side Of The Moon, Platinum Disc</title>
  <year>1999</year>
  <media>CD</media>
  <description>
    Dark Side Of The Moon, поставивший мир на уши невиданным сочетанием звуков, — это всего-навсего девять треков, и даже не все они писались специально для альбома...
  </description>
  <age unit="year">18</age>    
  <barcode>2345678901234</barcode>
</offer>
Элементы, специфичные для данного типа описания Описание элемента Обязательность элемента

type

Тип описания предложения. Для описания музыкальной и видеопродукции значение должно быть artist.title.

В YML является атрибутом для offer.

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

artist

Исполнитель.

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

title

Название.

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

year

Год выпуска.

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

media

Носитель.

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

starring

Актеры.

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

director

Режиссер.

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

originalName

Оригинальное название.

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

country

Страна.

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

Стандартные элементы описания «Музыкальная и видеопродукция» соответствуют стандартным элементам упрощенного описания. См. таблицу выше.

Тип описания «Билеты на мероприятия»

Пример для формата YML
<offer id="1234" type="event-ticket"  available="true" bid="80"> 
  <url>http://best.seller.ru/product_page.asp?pid=57384</url>
  <price>1000</price>
  <oldprice>1100</oldprice>
  <currencyId>RUR</currencyId>
  <categoryId>3</categoryId> 
  <picture>http://best.seller.ru/product_page.asp?pid=72945.jpg</picture>
  <store>false</store>
  <pickup>false</pickup>
  <delivery>true</delivery>
  <local_delivery_cost>300</local_delivery_cost>
  <name>Дмитрий Хворостовский и Национальный филармонический оркестр России...</name>
  <place>Московский  международный Дом музыки</place>
  <hall>Большой зал</hall>
  <hall_part>Партер р. 1-5<hall_part>
  <date>2012-02-25 12:03:14</date> 
  <is_premiere>0<is_premiere>
  <is_kids>0</is_kids>
  <description>
  Концерт Дмитрия Хворостовского и Национального филармонического оркестра России...
  </description>
  <age>6</age>
</offer>
Элементы, специфичные для данного типа описания Описание элемента Обязательность элемента

type

Тип описания предложения. Для описания билетов на мероприятие значение должно быть event-ticket.

В YML является атрибутом для offer.

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

name

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

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

place

Место проведения.

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

hall

Зал.

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

hall_part

Ряд и место в зале.

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

date

Дата и время сеанса. Предпочтительный формат: YYYY-MM-DD hh:mm:ss. Рекомендуемые форматы.

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

is_premiere

Признак премьерности мероприятия.

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

is_kids

Признак детского мероприятия.

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

Стандартные элементы описания «Билеты на мероприятия» соответствуют стандартным элементам упрощенного описания. См. таблицу выше.

Тип описания «Туры»

Пример для формата YML
<offer id="12341" type="tour" available="true" bid="80">
  <url>http://best.seller.ru/product_page.asp?pid=12344</url>
  <price>24129</price>
  <oldprice>25000</oldprice>
  <currencyId>USD</currencyId>
  <categoryId>6</categoryId>
  <picture>http://best.seller.ru/img/device12345.jpg</picture>
  <store>false</store>
  <pickup>true</pickup>
  <delivery>false</delivery>
  <local_delivery_cost>300</local_delivery_cost>
  <worldRegion>Африка</worldRegion>
  <country>Египет</country>
  <region>Хургада</region>
  <days>7</days>
  <dataTour>2012-01-01 12:00:00</dataTour>
  <dataTour>2012-01-08 12:00:00</dataTour>
  <name>Hilton</name>
  <hotel_stars>5*****</hotel_stars>
  <room>SNG</room>
  <meal>ALL</meal>
  <included>авиаперелет, трансфер, проживание, питание, страховка</included>
  <transport>Авиа</transport>
  <description>Отдых в Египте.</description>
  <price_min>24000</price_min>
  <price_max>25000</price_max>
  <options>?</options>
</offer>
Элементы, специфичные для данного типа описания Описание элемента Обязательность элемента

type

Тип описания предложения. Для описания туров значение должно быть tour.

В YML является атрибутом для offer.

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

name

Название отеля (в некоторых случаях название тура).

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

worldRegion

Часть света.

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

country

Страна.

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

region

Курорт или город.

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

days

Количество дней тура.

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

dataTour

Даты заездов. Предпочтительный формат: YYYY-MM-DD hh:mm:ss. Рекомендуемые форматы.

В формате YML элемент offer может содержать несколько элементов dataTour.

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

hotel_stars

Звезды отеля.

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

room

Тип комнаты (SNG, DBL и т. п.).

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

meal

Тип питания (All, HB и т. п.).

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

included

Что включено в стоимость тура.

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

transport

Транспорт.

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

price_min

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

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

price_max

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

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

options

Опции.

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

Стандартные элементы описания «Туры» соответствуют стандартным элементам упрощенного описания. См. таблицу выше.

Предыдущие версии документа

Предыдущая версия технических требований, действовавшая с 28.04.2017 до 31.05.2017

Предыдущая версия технических требований, действовавшая с 13.03.2017 до 27.04.2017

Предыдущая версия технических требований, действовавшая с 19.09.2016 до 12.03.2017

Предыдущая версия технических требований, действовавшая с 12.09.2016 до 18.12.2016

Предыдущая версия технических требований, действовавшая с 11.02.2016 до 11.09.2016

Предыдущая версия технических требований, действовавшая с 23.12.2015 до 10.02.2016

Предыдущая версия технических требований, действовавшая с 20.07.2015 до 22.12.2015

Предыдущая версия технических требований, действовавшая с 01.04.2015 до 19.07.2015

Предыдущая версия технических требований, действовавшая с 26.12.2014 до 31.03.2015

Предыдущая версия технических требований, действовавшая с 11.11.2014 до 25.12.2014

Предыдущая версия технических требований, действовавшая с 29.10.2014 до 10.11.2014

Предыдущая версия технических требований, действовавшая с 16.09.2014 до 28.10.2014

Предыдущая версия технических требований, действовавшая с 12.08.2014 до 15.09.2014

Предыдущая версия технических требований, действовавшая с 08.10.2013 до 11.08.2014

Предыдущая версия технических требований, действовавшая с 16.07.2013 до 07.10.2013

Предыдущая версия технических требований, действовавшая с 11.02.2013 до 15.07.2013

Предыдущая версия технических требований, действовавшая с 10.12.2012 до 10.02.2013

Предыдущая версия технических требований, действовавшая с 02.05.2012 до 09.12.2012

Предыдущая версия технических требований, действовавшая с 16.11.2011 до 01.05.2012

Предыдущая версия технических требований, действовавшая с 30.08.2011 до 15.11.2011

Предыдущая версия технических требований, действовавшая с 01.06.2011 до 29.08.2011

Предыдущая версия технических требований, действовавшая с 20.04.2011 до 31.05.2011

Предыдущая версия технических требований, действовавшая с 29.03.2011 до 19.04.2011

Предыдущая версия технических требований, действовавшая с 09.02.2011 до 28.03.2011