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

Данный документ является действующим, если расположен по адресу https://yandex.ru/support/market-tech-requirements/index.xml.

Дата публикации: 2 декабря 2016 г.

Дата вступления в силу: 19 декабря 2016 г.

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

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

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

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

      Внимание! Недопустимо использование протокола FTP и портов, отличных от 80 и 443.
    • Длина 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. URL-адрес товарного предложения на сайте магазина должен быть закодирован в соответствии со стандартом RFC-1738.

  4. Допустимые кодировки 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.

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

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

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

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

name

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

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

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

company

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

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

url

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

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

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:

Вы можете скачать пример полностью заполненного прайс-листа в формате YML. Далее представлен пример составления предложения (offer):

<offer id="12346" available="true" bid="80">
  <url>http://best.seller.ru/product_page.asp?pid=12348</url>
  <price>600</price>
  <oldprice>800</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>
  <delivery-options>
    <option cost="200" days="1"/>
  </delivery-options>
  <outlets>
    <outlet id="2" instock="50"/>
  </outlets>
  <name>Наручные часы Casio A1234567B</name>
  <vendor>Casio</vendor>
  <vendorCode>A1234567B</vendorCode>
  <description>Изящные наручные часы.</description>
  <sales_notes>Необходима предоплата.</sales_notes>
  <manufacturer_warranty>true</manufacturer_warranty>
  <country_of_origin>Япония</country_of_origin>
  <age unit="year">18</age>
  <barcode>0123456789012</barcode>
  <cpa>1</cpa>  
</offer>
Примеры для формата CSV:

Скачать пример упрощенного типа описания

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

Скачать пример упрощенного типа описания

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

name

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

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

model

Модель.

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

vendor

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

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

vendorCode

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

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

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

id

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

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

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

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

cbid

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

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

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

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

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

bid

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

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

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

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

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

fee

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

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

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

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

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

url

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

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

price

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

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

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

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

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

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

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

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

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

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

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

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

oldprice

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

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

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

currencyId

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

Примечание. BYN — новые белорусские рубли. Один новый белорусский рубль равен 10 000 старых (1 BYN = 10 000 BYR).

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

categoryId

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

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

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

category

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

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

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

picture

Ссылка на картинку соответствующего товарного предложения. Недопустимо давать ссылку на логотип магазина или «заглушку» — страницу, где написано «картинка отсутствует». Максимальная длина URL — 512 символов.

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

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

delivery

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

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

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

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

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

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

delivery-options

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

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

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

Обязательный элемент, если элемент delivery имеет значение true.

local_delivery_days

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

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

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

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

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

Обязательный элемент, если элемент delivery имеет значение true.

local_delivery_cost

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

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

Примечание. Ранее local_delivery_cost использовался в формате YML. В настоящее время элемент является устаревшим для этого формата. Использование элемента в YML пока поддерживается Маркетом, однако рекомендуется перейти на элемент delivery-options.

Обязательный элемент, если элемент delivery имеет значение true.

pickup

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

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

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

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

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

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

available

В форматах XLS, CSV:
Срок поставки в пункт выдачи: 0–2 дня или «на заказ».
В формате YML:
  • Если используется элемент local_delivery_cost, available передает срок курьерской доставки и срок поставки в пункт выдачи: 0–2 дня или «на заказ».

  • Если используется элемент delivery-options, available передает только срок поставки в пункт выдачи (0–2 дня или «на заказ»).

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

Подробное описание элемента.
Обязательный элемент, если элемент pickup имеет значение 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 символов. .

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

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

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

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

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

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 id="12341" type="vendor.model" available="true" bid="80">
  <url>http://best.seller.ru/product_page.asp?pid=12344</url>
  <price>16800</price>
  <oldprice>17000</oldprice>
  <currencyId>USD</currencyId>
  <categoryId>6</categoryId>
  <picture>http://best.seller.ru/img/device12345.jpg</picture>
  <store>false</store>
  <pickup>false</pickup>
  <delivery>true</delivery>
  <delivery-options>
    <option cost="200" days="1"/>
  </delivery-options>
  <outlets>
    <outlet id="2" instock="50"/>
  </outlets>
  <typePrefix>Принтер</typePrefix>
  <vendor>НP</vendor>
  <vendorCode>CH366C</vendorCode>
  <model>Deskjet D2663</model>
  <description>
  Серия принтеров для людей, которым нужен надежный, простой в использовании 
  цветной принтер для повседневной печати...
  </description>
  <sales_notes>Необходима предоплата.</sales_notes>
  <manufacturer_warranty>true</manufacturer_warranty>
  <country_of_origin>Япония</country_of_origin>
  <barcode>1234567890120</barcode>
  <cpa>1</cpa>
  <expiry>P5Y</expiry>
  <weight>2.07</weight>
  <dimensions>100/25.45/11.112</dimensions>
  <param name="Максимальный формат">А4</param>
  <param name="Технология печати">термическая струйная</param>
  <param name="Тип печати">Цветная</param>
  <param name="Количество страниц в месяц" unit="стр">1000</param>
  <param name="Потребляемая мощность" unit="Вт">20</param>
  <param name="Вес" unit="кг">2.73</param>
</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 — товар поставляется в течение 0–2 дней;

  • false — товар поставляется в течение 3–60 дней.

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

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

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

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

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

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

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

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

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

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

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

name

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

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

vendor

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

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

vendorCode

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

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

id

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

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

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

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

bid

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

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

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

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

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

cbid

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

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

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

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

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

url

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

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

price

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

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

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

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

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

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

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

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

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

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

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

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

oldprice

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

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

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

currencyId

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

Примечание. BYN — новые белорусские рубли. Один новый белорусский рубль равен 10 000 старых (1 BYN = 10 000 BYR).

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

categoryId

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

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

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

category

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

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

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

picture

Ссылка на картинку соответствующего товарного предложения. Недопустимо давать ссылку на логотип магазина или «заглушку» — страницу, где написано «картинка отсутствует». Максимальная длина URL — 512 символов.

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

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

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

Опции.

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

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

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

Предыдущая версия технических требований, действовавшая с 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