Вебмастер
Содержимое сайта и партнерские программы
Партнерские программы
Безопасность сайта

Технические требования

Определение YML

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

Настройте экспорт информации о товарах и услугах из вашей базы данных в YML-файл или используйте CMS со встроенными возможностями экспорта данных в формат YML. Разместите файл на сайте вашего магазина по URL, который указывается в разделе «Товары и цены». YML-файл регулярно скачивается роботом и обновленные данные экспортируются в базу данных.

Вы можете скачать XML DTD YML-файла по ссылке: http://partner.market.yandex.ru/pages/help/shops.dtd. Шаблон YML-файла вы найдете по ссылке: http://partner.market.yandex.ru/pages/help/YML.xml.

Внимание! Стандарт YML учитывает порядок следования элементов, поэтому важно соблюдать его в соответствии с шаблонами shops.dtd, YML.xml и предоставленными примерами. Это требование продиктовано стандартом XML DTD.

Примеры использования тегов представлены в разделе Примеры и описания.

Чтобы легко и быстро подготовить YML-файл, следуйте нашим рекомендациям.

Условия и рекомендации по передаче данных

  1. YML-файл должен быть доступен по протоколам HTTP или FTP. Вы можете использовать авторизацию для доступа к этому файлу. В этом случае во время загрузки файла укажите логин и пароль для его автоматического скачивания роботом.

    В случае изменения URL-адреса и/или авторизационных данных вам необходимо внести соответствующие изменения в разделе «Товары и цены».

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

  3. Вы можете разместить YML-файл в упакованном виде с помощью алгоритма сжатия ZIP (расширение .zip) или GNU ZIP (расширение .gz).

  4. Максимальный объем YML-файла составляет 500 Мб.

  5. В YML-файле нельзя использовать элементы с пустыми значениями. Если элемент не является обязательным и он неприменим для вашего случая, его необходимо удалить.

  6. В ссылках, указанных в YML-файле, не рекомендуется использовать пробелы и кириллические символы. Это может привести к невалидности файла.

  7. Адрес сайта в ссылках должен быть указан так же, как при добавлении сайта в Вебмастер: с префиксом www или без него, протоколом HTTP или HTTPS.

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

    Символ в текстеКод для YML-файла

    "

    "

    &

    &

    >

    >

    <

    &lt;

    '

    &apos;

  9. Запрещается размечать YML-файл специальными знаками Unicode (идеограммами). Например, не допускается использовать в разметке следующие значки: .

Примеры и описания

XML-заголовок

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

Вторая строка заголовка XML-документа определяет ссылку на файл описания формата данных (XML DTD). Здесь достаточно указать только имя файла shops.dtd, путь указывать не нужно.

Пример

<?xml version="1.0" encoding="windows-1251"?>
<!DOCTYPE yml_catalog SYSTEM "shops.dtd">

yml_catalog

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

Пример

<yml_catalog date="2010-04-01 17:00">
  <shop>
    ...
  </shop>
</yml_catalog>

shop

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

Пример

<shop>
    <name>BestShop</name>
    <company>Best online seller Inc.</company>
    <url>http://www.best.seller.ru/</url>

    <currencies> ... </currencies>
    <categories> ... </categories>
    <local_delivery_cost> ... </local_delivery_cost>
    <offers> ... </offers>
</shop>
Примечание. Название магазина, указываемое в элементе name, не должно превышать 20 символов. В противном случае оно автоматически будет заменено на имя домена, указанное в элементе url.

currencies

Элемент currencies задает список курсов валют магазина. Каждая из валют описывается отдельным элементом currency.

Данные о ценах принимаются в рублях (RUR, RUB), гривнах (UAH), белорусских рублях (BYN), тенге (KZT), долларах (USD) и евро (EUR). В результатах поисковой выдачи цены могут отображаться в рублях, гривнах, белорусских рублях и тенге в зависимости от региона пользователя. Если в вашем YML-файле не задан курс для отображаемой валюты, то используется курс Центрального Банка страны, к которой относится регион пользователя. Применяется курс, установленный на текущий день. Курс обновляется ежедневно в 00.00.

Пример

<currencies>
    <currency id="RUR" rate="1"/>
    <currency id="USD" rate="23.98"/>
    <currency id="EUR" rate="CBRF"/>
    <currency id="UAH" rate="NBU"/>
    <currency id="KZT" rate="CB"/>
</currencies>

Атрибут id элемента <currency> указывает код одной или нескольких валют, которые могут быть использованы в YML-файле.

Атрибут rate указывает курс валюты к курсу основной валюты, взятой за единицу (валюта, для которой rate="1"). Атрибут rate может иметь следующие значения:

  • Постоянное число — внутренний курс, который вы используете.

  • CBRF — курс по Центральному банку РФ.

  • NBU — курс по Национальному банку Украины.

  • NBK — курс по Национальному банку Казахстана.

  • СВ — курс по банку той страны, к которой относится магазин по своему региону, указанному в партнерском интерфейсе.

В качестве основной валюты (для которой установлено rate="1") могут быть использованы только рубль (RUR, RUB), белорусский рубль (BYN), гривна (UAH) или тенге (KZT).

Пример, когда курс USD и EUR соответствуют курсу Национального банка Украины:

Пример

<currencies>
    <currency id="UAH" rate="1"/>
    <currency id="USD" rate="NBU"/>
    <currency id="EUR" rate="NBU"/>
</currencies>

categories

Элемент categories содержит список категорий магазина. Каждая категория описывается отдельным элементом category. Описание категории должно включать ее идентификатор (атрибут id) для всех категорий и идентификатор категории более высокого уровня для подкатегорий. Идентификатор категории должен быть уникальным положительным целым числом (не может быть равен «0»). Если элемент parentId не указан, то категория считается корневой.

Параметры:

  • id — идентификатор вашей категории товаров.

  • parentId — идентификатор более высокой по иерархии (родительской) категории товаров.

Пример

<categories>
    <category id="1">Книги</category>
    <category id="2" parentId="1">Детективы</category>
    <category id="3" parentId="1">Боевики</category>
    <category id="4">Видео</category>
    <category id="5" parentId="4">Комедии</category>
    <category id="6">Принтеры</category>
    <category id="7">Оргтехника</category>
</categories>

local_delivery_cost

Внимание! Элемент local_delivery_cost является устаревшим. Рекомендуем отказаться от использования данного элемента и перейти на использование элемента delivery-options, так как новый элемент предоставляет больше возможностей.

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

Cтоимость доставки каждого отдельного товара может быть указана в элементе local_delivery_cost внутри элемента offer.

Если в YML-файле указана общая стоимость доставки, то она действует на все товары, кроме тех, на которые стоимость доставки указана непосредственно в соответствующем элементе offer.

Пример

<shop>
    <currencies> ... </currencies>
    <categories> ... </categories>
    <local_delivery_cost>300</local_delivery_cost>
    <offers>
      <offer>...</offer>
      ...
    </offers>
</shop>

delivery-options

Элемент используется для указания стоимости и сроков курьерской доставки по своему региону.

offers

В элементе offers содержится список товарных предложений магазинов. Каждое товарное предложение описывается в отдельном элементе offer.

Пример

<offers>
  <offer>
    <offer id="123" type="vendor.model" available="true">
      ...
    </offer>
  ...
</offers>

В YML существуют несколько типов описаний предложений товаров. Тип устанавливает, какие поля используются для описания предложения.

Тип описания указывается в атрибуте type элемента offer:

Пример

<offer id="123" type="vendor.model" available="true">
  <url>...</url>
  ...
</offer>

Упрощенное описание

description и name

В элементе name указывается заголовок товарного предложения (длина не более 120 символов). В заголовке рекомендуется указывать полное уникальное название товара. Заголовок не может состоять только из цифр.

В элементе description указывается описание товарного предложения (длина не более 175 символов). В описании товарного предложения рекомендуется указывать основные характеристики товара.

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

Пример

<offer>
  <name>Ортопедический матрас Орматек Mono Prim   EVS500</name>
  <description>Односторонний матрас средней жесткости на   основе блока независимых пружин EVS 500, 
  который равномерно распределяет нагрузку по всей   горизонтальной поверхности матраса 
  и обеспечивает направленную поддержку позвоночника.   Наполнители: пенополиуретан 
  и латексированная кокосовая койра. Размер: 90x195 см,   высота: 17 см.
  Максимальный вес на 1 спальное место: 100   кг.</description>
</offer>

adult

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

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

Тег adult может быть указан:

  • перед элементом offers — для обозначения всего списка товарных предложений;
  • в элементе offer — для отдельных товарных предложений.

Пример

<adult>true</adult>
<offers>
    <offer>...</offer>
    ...
</offers>

Пример


<offer>
    ...
    <typePrefix>Вибратор гелевый</typePrefix>
    <vendor>Robotic</vendor>
    <model>Реалистик 9</model>
    ...
    <adult>true</adult>
    ...
</offer>

vendor

В элементе vendor указывается производитель товара или его торговая марка.

Элемент vendor применим в двух типах описания товарного предложения — упрощенном и vendor.model. При описании товара рекомендуется всегда указывать производителя или торговую марку.

Пример

<offer>
  <vendor>Nokia</vendor>
</offer>

Типы описаний

Элемент offer поддерживает несколько типов описаний предложений. Рекомендуем использовать различные типы описаний для предложений из соответствующих категорий. Если вы захотите размещаться на Яндекс.Маркете, это позволит вам упростить процесс подготовки соответствующего YML-файла.

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

Произвольный товар (vendor.model)

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

Пример

<offer id="12341" type="vendor.model" available="true">
    <url>http://www.best.seller.ru/product_page.asp?pid=12344</url>
    <price>700</price>
    <currencyId>USD</currencyId>
    <categoryId>6</categoryId>
    <delivery>true</delivery>
    <local_delivery_cost>300</local_delivery_cost>
    <typePrefix>Принтер</typePrefix>
    <vendor>НP</vendor>
    <vendorCode>CH366C</vendorCode>
    <model>Deskjet D2663</model>
    <description>Серия принтеров для людей, которым нужен надежный, простой в использовании 
    цветной принтер для повседневной печати. Формат А4. Технология печати: 4-цветная термальная струйная. 
    Разрешение при печати: 4800х1200 т/д.
    </description>
    <manufacturer_warranty>true</manufacturer_warranty>
    <country_of_origin>Япония</country_of_origin>
    <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>

Элементы, входящие в offer (обязательные элементы в таблице выделены жирным шрифтом):

Элементы

Описание

url

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

price

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

Указанное значение не должно быть равно нулю.

currencyId

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

categoryId

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

delivery

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

«false» — товар не может быть доставлен («самовывоз»).

«true» — доставка товара осуществлятся в регионы, указанные во вкладке «Магазин» в разделе «Товары и цены». Стоимость доставки описывается в теге <local_delivery_cost>.

typePrefix

Группа товаров/категория.

vendor

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

model

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

description

Описание товарного предложения.

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

vendorCode

Код товара (указывается код производителя).

local_delivery_cost

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

available

Статус доступности товара — в наличии/на заказ.

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

«true» — товарное предложение в наличии. Магазин готов сразу договариваться с покупателем о доставке товара.

sales_notes

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

manufacturer_warranty

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

country_of_origin

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

downloadable

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

adult

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

param

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

Книги (book)

Пример

<offer id="12342" type="book" available="true">
    <url>http://www.best.seller.ru/product_page.asp?pid=14345</url>
    <price>80</price>
    <currencyId>RUR</currencyId>
    <categoryId>3</categoryId>
    <delivery>true</delivery>
    <local_delivery_cost>300</local_delivery_cost>
    <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>
</offer>

Элементы, входящие в offer (обязательные элементы в таблице выделены жирным шрифтом):

Элементы

Описание

url

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

В ссылках, указанных в YML-файле, не рекомендуется использовать пробелы и кириллические символы. Это может привести к невалидности файла.

price

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

Указанное значение не должно быть равно нулю.

currencyId

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

categoryId

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

delivery

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

«false» — товар не может быть доставлен («самовывоз»).

«true» — доставка товара осуществлятся в регионы, указанные во вкладке «Магазин» в разделе «Товары и цены». Стоимость доставки описывается в теге <local_delivery_cost>.

author

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

name

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

publisher

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

series

Серия.

year

Год издания.

ISBN

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

Формат ISBN проверяется на корректность. При проверке учитываются:

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

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

description

Аннотация к книге.

volume

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

part

Номер тома.

language

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

binding

Переплет.

page_extent

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

table_of_contents

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

Аудиокниги (audiobook)

Пример

<offer id="12342" type="audiobook" available="true">
    <url>http://www.best.seller.ru/product_page.asp?pid=14345</url>
    <price>200</price>
    <currencyId>RUR</currencyId>
    <categoryId>3</categoryId>
    <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>
    <recording_length>45m23s</recording_length>
    <description>Перу Владимира Кунина принадлежат десятки сценариев к
    кинофильмам, серия книг про КЫСЮ и многое, многое другое.</description>
    <downloadable>true</downloadable>
</offer>

Элементы, входящие в offer (обязательные элементы в таблице выделены жирным шрифтом):

Элементы

Описание

url

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

В ссылках, указанных в YML-файле, не рекомендуется использовать пробелы и кириллические символы. Это может привести к невалидности файла.

price

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

Указанное значение не должно быть равно нулю.

currencyId

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

categoryId

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

author

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

name

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

publisher

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

series

Серия.

year

Год издания.

ISBN

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

Формат ISBN проверяется на корректность. При проверке учитываются:

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

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

description

Аннотация к книге.

performed_by

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

performance_type

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

language

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

volume

Номер тома.

part

Номер части.

format

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

storage

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

recording_length

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

table_of_contents

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

Музыкальная и видео продукция (artist.title)

Пример для музыки

<offer id="12345" type="artist.title" available="true">
    <url>http://www.best.seller.ru/product_page.asp?pid=12946</url>
    <price>15</price>
    <currencyId>USD</currencyId>
    <categoryId>2</categoryId>
    <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, поставивший мир на уши
    невиданным сочетанием звуков, — это всего-навсего девять 
    треков, и даже не все они писались специально для альбома. 
    Порывшись по сусекам, участники Pink Floyd мудро сделали 
    новое из хорошо забытого старого — песен, которые 
    почему-либо не пошли в дело или остались незаконченными. 
    Одним из источников вдохновения стали саундтреки 
    для кинофильмов, которые группа производила в больших количествах.</description>
</offer>

Элементы, описывающие музыку в offer (обязательные элементы в таблице выделены жирным шрифтом):

Элементы

Описание

url

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

В ссылках, указанных в YML-файле, не рекомендуется использовать пробелы и кириллические символы. Это может привести к невалидности файла.

price

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

Указанное значение не должно быть равно нулю.

currencyId

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

categoryId

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

delivery

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

«false» — товар не может быть доставлен («самовывоз»).

«true» — доставка товара осуществлятся в регионы, указанные во вкладке «Магазин» в разделе «Товары и цены». Стоимость доставки описывается в теге <local_delivery_cost>.

artist

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

title

Название.

year

Год выпуска.

media

Носитель.

Пример для видео

<offer id="12344" type="artist.title" available="true">
    <url>http://www.best.seller.ru/product_page.asp?pid=92347</url>
    <price>93</price>
    <currencyId>RUR</currencyId>
    <categoryId>2</categoryId>
    <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>
</offer>

Элементы, описывающие видео в offer (обязательные элементы в таблице выделены жирным шрифтом):

Элементы

Описание

url

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

В ссылках, указанных в YML-файле, не рекомендуется использовать пробелы и кириллические символы. Это может привести к невалидности файла.

price

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

Указанное значение не должно быть равно нулю.

currencyId

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

categoryId

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

delivery

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

«false» — товар не может быть доставлен («самовывоз»).

«true» — доставка товара осуществлятся в регионы, указанные во вкладке «Магазин» в разделе «Товары и цены». Стоимость доставки описывается в теге <local_delivery_cost>.

title

Название фильма.

starring

Актеры.

director

Режиссер.

originalName

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

country

Страна.

year

Год выпуска.

media

Носитель.

adult

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

Туры (tour)

Пример

<offer id="12341" type="tour" available="true">
    <url>http://www.best.seller.ru/product_page.asp?pid=12344</url>
    <price>958</price>
    <currencyId>USD</currencyId>
    <categoryId>6</categoryId>
    <delivery>false</delivery>
    <local_delivery_cost>300</local_delivery_cost>
    <worldRegion>Африка</worldRegion>
    <country>Египет</country>
    <region>Хургада</region>
    <days>7</days>
    <dataTour>01/01/03</dataTour>
    <dataTour>08/01/03</dataTour>
    <name>Hilton</name>
    <hotel_stars>5*****</hotel_stars>
    <room>SNG</room>
    <meal>ALL</meal>
    <included>авиаперелет, трансфер, проживание, питание, страховка</included>
    <transport>Авиа</transport>
    <description>Отдых в Египте.</description>
</offer>

Элементы, входящие в offer (обязательные элементы в таблице выделены жирным шрифтом):

Элементы

Описание

url

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

В ссылках, указанных в YML-файле, не рекомендуется использовать пробелы и кириллические символы. Это может привести к невалидности файла.

price

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

Указанное значение не должно быть равно нулю.

currencyId

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

categoryId

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

delivery

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

«false» — товар не может быть доставлен («самовывоз»).

«true» — доставка товара осуществлятся в регионы, указанные во вкладке «Магазин» в разделе «Товары и цены». Стоимость доставки описывается в теге <local_delivery_cost>.

worldRegion

Часть света.

country

Страна.

region

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

days

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

dataTour

Даты заездов.

name

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

hotel_stars

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

room

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

meal

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

included

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

transport

Транспорт.

description

Описание тура.

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

Билеты на мероприятие (event-ticket)

Пример

<offer id="1234" type="event-ticket"  available="true"> 
    <url>url товарного предложения</url>
    <price>100000</price>
    <currencyId>RUR</currencyId>
    <categoryId>3</categoryId>
    <delivery>true</delivery>
    <local_delivery_cost>300</local_delivery_cost>
    <name>Дмитрий Хворостовский и Национальный филармонический
 оркестр России. Дирижер — Владимир Спиваков.</name>
    <place>Московский  международный Дом музыки</place>
    <hall plan="url плана зала">Большой  зал<hall>
    <hall_part>Партер р. 1-5<hall_part>
    <date>2009-12-31T19:00</date> 
    <is_premiere>0<is_premiere>
    <is_kids>0</is_kids>
    <description>Концерт Дмитрия Хворостовского и Национального филармонического
    оркестра России</description>
</offer>

Элементы, входящие в offer (обязательные элементы в таблице выделены жирным шрифтом):

Элементы

Описание

url

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

В ссылках, указанных в YML-файле, не рекомендуется использовать пробелы и кириллические символы. Это может привести к невалидности файла.

price

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

Указанное значение не должно быть равно нулю.

currencyId

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

categoryId

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

delivery

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

«false» — товар не может быть доставлен («самовывоз»).

«true» — доставка товара осуществлятся в регионы, указанные во вкладке «Магазин» в разделе «Товары и цены». Стоимость доставки описывается в теге <local_delivery_cost>.

name

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

place

Зал.

hall plan

Ссылка на изображение с планом зала.

date

Дата и время сеанса. Указываются в формате ISO 8601: YYYY-MM-DDThh:mm.

is_premiere

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

is_kids

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

Упрощенное описание

Это базовый, наиболее простой тип описания.

Пример

<offer id="12346" available="true">
    <url>http://www.best.seller.ru/product_page.asp?pid=12348</url>
    <price>699.54</price>
    <currencyId>USD</currencyId>
    <categoryId>6</categoryId>
    <delivery>false</delivery>
    <local_delivery_cost>300</local_delivery_cost>
    <name>Золотые наручные часы </name>
    <vendor>Longines</vendor>
    <vendorCode>A1234567B</vendorCode>
    <description>Изящные золотые часы.</description>
    <country_of_origin>Швейцария</country_of_origin>
</offer>

Элементы, входящие в offer (обязательные элементы в таблице выделены полужирным шрифтом):

Элементы

Описание

url

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

В ссылках, указанных в YML-файле, не рекомендуется использовать пробелы и кириллические символы. Это может привести к невалидности файла.

price

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

Указанное значение не должно быть равно нулю.

currencyId

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

categoryId

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

delivery

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

  • «false» — товар не может быть доставлен («самовывоз»).

  • «true» — доставка товара осуществлятся в регионы, указанные во вкладке «Магазин» в разделе «Товары и цены». Стоимость доставки описывается в теге <local_delivery_cost>.

local_delivery_cost

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

name

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

vendor

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

vendorCode

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

description

Описание товарного предложения.

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

country_of_origin

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

adult

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

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