Элементы внутри offer в упрощенном типе

Упрощенный и произвольный типы подходят для большинства товаров. Оба типа предоставляют равные возможности и обеспечивают одинаковое качество привязки к карточкам модели и отображению в Поиске.

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

Формат фида для подключения интернет-магазина к Поиску создан на основе формата для интеграции с Яндекс Маркетом. При этом некоторые элементы в описанном формате необязательны или не используются для формирования результатов в Поиске.

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

Ниже перечислены элементы, необходимые для подключения магазина к Поиску.

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

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

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

Примечание

Обязателен

На что влияет

name

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

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

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

Оптимальная длина — 50‑60 символов, максимальная — 150.

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

Пример: Ударная дрель Makita HP1630, 710 Вт

Да

Используется для формирования объединенной карточки товара.

Стандартные элементы

Описание

Примечание

Обязателен

На что влияет

vendor

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

Указывайте название так, как его пишет сам бренд.

Нет

Используется для формирования объединенной карточки товара.

vendorCode

Артикул производителя. Код товара, который ему присвоил производитель.

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

Пример: VNDR-0005A, VNDR-0005B

Нет

Используется для формирования объединенной карточки товара.

id

Атрибут элемента offer. Идентификатор товара в вашей системе. Если вы не используете идентификаторы, составьте SKU прямо во время добавления товара. Например, подойдет комбинация артикула и типа товара.

У каждого товара SKU должен быть свой. После добавления товара поменять его SKU нельзя.

Любая последовательность длиной до 80 знаков. В нее могут входить английские и русские (кроме ё) буквы, цифры и символы . , / \ ( ) [ ] - =

Идентификатор должен быть уникальным для каждого товара, при этом это должны быть разные товары. Под разными идентификаторами может быть один и тот же товар, если он продается в разных регионах или у товара есть признак бывшего в употреблении (б/у).

Пример: belaya-kofta-12345

Да

url

Адрес страницы на вашем сайте с фотографиями и описанием товара.

Максимальная длина URL — 512 символов. Записывайте его согласно стандарту RFC 3986.

Пример: http://best.seller.ru/product_page.asp?pid=12346

Да

price

Цена одной единицы товара, включая все налоги.

Основная часть данных обновляется в Поиске раз в 4 часа. Чтобы быстро обновить цену, используйте API Поиска.

Да

oldprice

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

Цена указывается в рублях. Число должно быть целым.

Можно указать цену со скидкой от 5 до 75%.

oldprice должна быть выше price.

Нет

currencyId

Валюта, в которой указана цена товара.

Поддерживаются российские рубли (RUR).

Да

categoryId

Категория в магазине. Элемент categoryId содержит номер категории, а не ее название. Список категорий с номерами разместите в элементе categories.

Старайтесь указать категорию более конкретно. Например, тушь для ресниц лучше отнести к категории Декоративная косметика, а не просто Косметика.

Да

available

Атрибут элемента offer. Поле указывает, есть ли товар в наличии.

Для участия в Поиске используйте только со значением true.

Нет

picture

Изображение товара.

Принимаются изображения в формате JPEG или PNG.

Вес до 10 МБ, размер не меньше 300 × 300 пикселей.

Укажите ссылку на изображение или несколько изображений. Первое фото становится основным.

Да

Используется для формирования объединенной карточки товара.

delivery

Наличие курьерской доставки.

Принимает значения true и false.

Указывает на условия, специфичные для товара. Условия доставки, которые действуют для магазина в целом, указывайте внутри элемента shop.

Нет

delivery-options

Количество дней, требуемых на доставку.

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

Указывает на условия, специфичные для товара. Условия доставки, которые действуют для магазина в целом, указывайте внутри элемента shop. Подробное описание элемента.

Нет

pickup

Наличие самовывоза.

Принимает значения true и false.

Указывает на условия, специфичные для товара. Условия самовывоза, которые действуют для магазина в целом, указывайте внутри элемента shop.

Нет

pickup-options

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

Указывает на условия, специфичные для товара. Условия самовывоза, которые действуют для магазина в целом, указывайте внутри элемента shop. Подробное описание элемента.

Нет

description

Описание товара.

Не давайте в описании инструкций по установке и сборке. Не используйте слова «скидка», «распродажа», «дешевый», «подарок», «бесплатно», «акция», «специальная цена», «новинка», «new», «аналог», «заказ», «хит». Не указывайте контактную информацию и не размещайте ссылки.

Можно использовать теги br и p для переноса строки.

Оптимальная длина — 400‑600 символов, максимальная — 3000.

Пример: В комплекте с детским микроскопом есть все, что нужно вашему ребенку для изучения микромира.

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

Да

Используется для формирования объединенной карточки товара.

sales_notes

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

Условия для конкретного товара.

Параметры доставки и самовывоза есть не только у товара, но и у магазина. Если для товара условия не заданы, действуют настройки, заданные для магазина.

Нет

adult

Товар имеет отношение к удовлетворению сексуальных потребностей, либо иным образом эксплуатирует интерес к сексу. Возможные значения — true, false.

Используйте этот элемент вместо элемента age.

Нет

barcode

Штрихкод товара от производителя. Если товар продается упаковками — нужен штрихкод упаковки.

Указывайте в виде последовательности цифр. Подойдут коды EAN-13, EAN-8, UPC-A, UPC-E.

Для товаров определенных категорий и торговых марок обязательно передавайте код GTIN. Внутренние коды, которые начинаются на 2 или 02, не подходят.

Для книг указывайте ISBN.

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

Пример: 4601230000000

Нет

Используется для формирования объединенной карточки товара.

param

Характеристики товара.

Каждый имеет обязательный атрибут name для названия характеристики и необязательный units для единиц измерения.

<offer>
  ...
  <param name="Размер экрана" unit="дюйм">27</param>
  <param name="Материал">алюминий</param>
  <param name="Wi-Fi">есть</param>
</offer>

Нет

weight

Вес товара с упаковкой.

Указывайте в килограммах. Можно использовать дроби: разделитель — точка или запятая, не больше трех цифр после него.

Пример: 3.1

Нет

dimensions

Длина, ширина, высота в упаковке.

Указывайте в сантиметрах. Можно использовать дроби: разделитель — точка или запятая, не больше трех цифр после него.

Пишите числа через / без пробелов.

Пример: 20.1/20.551/22.5

Нет

period-of-validity-days

Срок годности. Период, по прошествии которого товар становится непригоден.

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

Срок можно указывать в годах, месяцах, днях, неделях и часах.

Обязательно указывайте срок, если он есть.

Продолжительность указывается согласно ISO 8601, то есть в виде строчки, начинающейся буквой P:

  • P1Y — 1 год;

  • P1Y2M — 1 год и 2 месяца;

  • P15D — 15 дней;

  • P2Y10D — 2 года, 10 дней;

  • P2Y6M10D — 2 года, 6 месяцев и 10 дней.

Нет

comment-validity-days

Комментарий к сроку годности. Поле предназначено для описаний условий хранения.

Не длиннее 250 знаков и без спецсимволов.

Пример: Хранить в сухом помещении.

Нет

service-life-days

Срок службы. В течение срока службы товар должен исправно выполнять свою функцию. Обязательно указывайте срок, если он есть.

Срок можно указывать в годах, месяцах и днях.

Продолжительность указывается согласно ISO 8601, то есть в виде строчки, начинающейся буквой P:

  • P1Y — 1 год;
  • P1Y2M — 1 год и 2 месяца;
  • P15D — 15 дней;
  • P2Y10D — 2 года, 10 дней;
  • P2Y6M10D — 2 года, 6 месяцев и 10 дней.

Нет

comment-life-days

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

Не длиннее 250 знаков и без спецсимволов.

Пример: Использовать при температуре не ниже -10 градусов.

Нет

warranty-days

Гарантийный срок. В течение какого времени можно бесплатно заменить или починить товар.

Срок можно указывать в годах, месяцах или днях.

Продолжительность указывается согласно ISO 8601, то есть в виде строчки, начинающейся буквой P:

  • P1Y — 1 год;
  • P1Y2M — 1 год и 2 месяца;
  • P15D — 15 дней;
  • P2Y10D — 2 года, 10 дней;
  • P2Y6M10D — 2 года, 6 месяцев и 10 дней.

Нет

comment-warranty

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

Не длиннее 250 знаков и без спецсимволов.

Пример: Гарантия на аккумулятор — 6 месяцев

Нет

certificate

Номер документа. Номер документа на товар: сертификата, декларации соответствия и т. п.

Пример: 6241421.

Нет

tn-ved-code

Код ТН ВЭД. Обязательно укажите, если он есть.

10 или 14 цифр без пробелов.

Пример: 8517610008

Нет

condition

Признак товара бывшего в употреблении (б/у).

Обязательно указывайте атрибут type:

  • preowned — бывший в употреблении, раньше принадлежал другому человеку.

  • showcasesample — витринный образец.

  • reduction — уцененный товар.

<condition type="preowned">
  <quality>excellent</quality>
</condition>

Нет

Элементы внутри condition

quality

Элемент внутри condition. Состояние, внешний вид товара.

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

  • perfect — как новый, товар в идеальном состоянии.

  • excellent — отличный, следы использования или дефекты едва заметные.

  • good — хороший, есть заметные следы использования или дефекты.

Да

reason

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

<condition type="preowned">
  <quality>excellent</quality>
  <reason>Повреждена заводская упаковка,
  незначительные следы эксплуатации (грязные
  следы на задней крышке). Есть гарантия
  производителя.</reason>
</condition>

Да

Пример файла

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2020-11-22T14:37:38+03:00">
    <shop>
        <name>BestSeller</name>
        <company>Tne Best inc.</company>
        <url>http://best.seller.ru</url>
        <platform>uCoz</platform>
        <categories>
            <category id="1">Бытовая техника</category>
            <category id="10" parentId="1">Мелкая техника для кухни</category>
            <category id="101" parentId="10">Сэндвичницы и приборы для выпечки</category>
        </categories>
        <delivery-options>
            <option cost="200" days="1"/>
        </delivery-options>

        <offers>
            <offer id="9012">
                <name>Мороженица Brand 3811</name>
                <vendor>Brand</vendor>
                <vendorCode>A1234567B</vendorCode>
                <url>http://best.seller.ru/product_page.asp?pid=12345</url>
                <price>8990</price>
                <oldprice>9990</oldprice>
                <enable_auto_discounts>true</enable_auto_discounts>
                <currencyId>RUR</currencyId>
                <categoryId>101</categoryId>
                <picture>http://best.seller.ru/img/model_12345.jpg</picture>
                <description>
                    <![CDATA[
                        <p>Это прибор, который придётся по вкусу всем любителям десертов и сладостей</p>
                        <p>С его помощью вы сможете делать вкусное домашнее мороженое из натуральных ингредиентов.</p>
                    ]]>
                </description>
                <sales_notes>Необходима предоплата.</sales_notes>
                <manufacturer_warranty>true</manufacturer_warranty>
                <barcode>4601546021298</barcode>
                <param name="Цвет">белый</param>
                <weight>3.6</weight>
                <dimensions>20.1/20.551/22.5</dimensions>
                <condition type="preowned">
                    <quality>excellent</quality>
                    <reason>
                        Повреждена заводская упаковка, незначительные следы эксплуатации (грязные следы на задней крышке). Есть гарантия производителя.
                    </reason>
                </condition>
            </offer>
        </offers>
    </shop>
</yml_catalog>

Написать в службу поддержки