Как задать параметры товара в YML файле

YML-файл состоит из cпециальных XML-тегов, которые описывают параметры товаров. Вот как их заполнять:

Основные данные

Название

Элемент <name> внутри элемента <offer>.

<name>Ударная дрель Makita HP1630, 710 Вт</name>

Категория

Элемент <market_category_id> внутри элемента <offer>.

<market_category_id>743</market_category_id>

<market_category_id> содержит номер категории, а не ее название.

Подробности в инструкции к YML.

Артикул товара (SKU)

Атрибут id элемента <offer>.

<offer id="belaya-kofta-12345">

Бренд

Название бренда или производителя. Записывайте название так, как его пишет сам бренд. Обязательно проверьте, как правильно пишется — например, на официальном сайте бренда.

Элемент <vendor> внутри элемента <offer>.

<vendor>LEVENHUK</vendor>

Штрихкод

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

Элемент <barcode> внутри элемента <offer>.

<barcode>46012300000000</barcode>

Описание

Подробное описание товара: например, его преимущества и особенности.

Элемент <description> внутри элемента <offer>.

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

Если в описании есть теги, его нужно помещать внутрь CDATA:

 <description>
   <![CDATA[
     <p>текст</p>
   ]]>
 </description>

Габариты и вес с упаковкой

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

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

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

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

Элемент <dimensions> внутри элемента <offer>.

Габариты

<dimensions>22.1/40.425/22.1</dimensions>

Вес
Элемент <weight> внутри элемента <offer>.

<weight>3.1</weight>

Изображение

Элементы <picture> внутри элемента <offer>.

<offer id="12345-abcd">
    ...
    <picture>https://best.seller.ru/img/device12346-front.jpg</picture>
    <picture>https://best.seller.ru/img/device12346-back.jpg</picture>
    ...
</offer>

Остальные данные

Цена

Цена одной единицы товара, включая все налоги. Действует во всех магазинах кабинета.

Элемент <price> внутри элемента <offer>.

<price>240</price>

Зачеркнутая цена

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

Элемент <oldprice> внутри элемента <offer>.

<oldprice>250</oldprice>

Себестоимость

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

Элемент <purchase_price> внутри элемента <offer>.

<purchase_price>200</purchase_price>

Дополнительные расходы

Дополнительные расходы на товар. Например, на доставку или упаковку.

Элемент <additional_expenses> внутри элемента <offer>.

<additional_expenses>75</additional_expenses>

Видео

Элемент <video> внутри элемента <offer>.

 <video>https://disk.yandex.ru/i/fUs4sweebCgjq_ytMN</video>
 <video>https://disk.yandex.ru/i/kEb8svrewPnaq_fnZA</video>
 <video>https://disk.yandex.ru/i/mOx2zqdbfLoph_pwGS</video>

Количество грузовых мест

Элемент <box-count> внутри элемента <offer>.

<box-count>2</box-count>

Страна производства

Страна, где был произведен товар.

Указывайте страну на русском языке.

Записывайте названия стран так, как они записаны в списке.

Элемент <country_of_origin> внутри элемента <offer>.

<country_of_origin>Россия</country_of_origin>

Артикул производителя

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

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

Если артикулов несколько, укажите их через запятую. Пример:VNDR-0005A, VNDR-0005B

Элемент <vendorCode> внутри элемента <offer>.

<vendorCode>VNDR-0005A, VNDR-0005B</vendorCode>

Особый тип товара

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

Атрибут type элемента <offer>.

• audiobook — аудиокнига;

• book — книга или цифровая книга;

• medicine — лекарство;

• artist.title — музыкальная или видеопродукция;

<offer type="audiobook">

Товар для взрослых

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

Элемент <adult>true</adult> внутри элемента <offer> или внутри элемента <offers> перед массивом из <offer> — если для взрослых предназначены все товары сразу.

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

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

Срок годности

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

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

Элемент <period-of-validity-days> внутри элемента <offer>.

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

• P1Y — 1 год;
• P1Y6M — 1 год и 6 месяцев;
• P15D — 15 дней.

<period-of-validity-days>P1Y</period-of-validity-days>

Комментарий к сроку годности

Поле предназначено для описаний условий хранения.

Элемент <comment-validity-days> внутри элемента <offer>.

<comment-validity-days>Хранить в сухом помещении.</comment-validity-days>

Срок службы

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

Элемент <service-life-days> внутри элемента <offer>.

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

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

<service-life-days>P2Y2M10D</service-life-days>

Комментарий к сроку службы

Поле предназначено для описаний условий использования.

Элемент <comment-life-days> внутри элемента <offer>.

<comment-life-days>Использовать при температуре не ниже -10 градусов.</comment-life-days>

Гарантийный срок

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

Элемент <warranty-days> внутри элемента <offer>.

Элемент <service-life-days> внутри элемента <offer>.

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

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

<warranty-days>P2Y2M10D</warranty-days>

Комментарий к гарантийному сроку

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

Указывайте комментарий на русском языке.

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

Элемент <comment-warranty> внутри элемента <offer>.

<comment-warranty>Гарантия на аккумулятор — 6 месяцев.</comment-warranty>

Инструкция к товару

Инструкции по эксплуатации, схемы сборки и т. д.

Элемент <manual> с атрибутом <title> внутри элемента <offer>, где <title> — это название инструкции.

 <manual title="Manual 1">https://ya.ru/man.pdf</manual>
 <manual title="Manual 2">https://ya.ru/man.jpg </manual>

Номер документа

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

Элемент <certificate> внутри элемента <offer>.

<certificate>6241421</certificate>

Код ТН ВЭД

Для некоторых категорий товаров код ТН ВЭД обязателен. Если это касается ваших товаров, вы получите уведомление в каталоге. На основании переданного кода ТН ВЭД Маркет определяет, подлежит ли товар обязательной маркировке.

Элемент <tn-ved-codes> внутри элемента <offer>. Внутри <tn-ved-codes> может быть сколько угодно элементов <tn-ved-code>, каждый из которых содержит один из кодов товара.

                       <tn-ved-codes>
                         <tn-ved-code>8517610008</tn-ved-code>
                       </tn-ved-codes>

Код КТРУ

Код КТРУ используется государственными и муниципальными заказчиками для унификации наименований и описаний объектов закупки.

Элемент <ctru_code> внутри элемента <offer>.

<ctru_code>20.41.32.121-00000006</ctru_code>

С какого возраста пользоваться

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

Элемент <age> внутри элемента <offer>. Единицы измерения определяет атрибут unit: unit="year" — годы, unit="month" — месяцы.

<age unit="year">6</age>

Теги

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

Элемент <set-ids> внутри элемента <offer>.

<set-ids>apple, до 500 рублей</set-ids>

Поместить в архив

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

Элемент <archived> внутри элемента <offer>.

Укажите значение true, если нужно поместить товар в архив, или false, если нужно восстановить товар из архива.

<offer id="12345-abcd">
                     ...
                     <archived>true</archived>
                     ...
                     </offer>

Доступное количество товара

Общее количество товара, доступное для продажи на Яндекс Маркете.

Как управлять остатками

Элемент <count> внутри элемента <offer>.

<count>7</count>

Обязательно указывайте дату актуальности данных в атрибуте date корневого элемента. Инструкция

Ссылка на страницу товара

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

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

Элемент <url> внутри элемента <offer>.

<url>https://best.seller.ru/product_page.asp?pid=12346</url>

Убрать из продажи

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

Валюта

Валюта, в которой указана цена товара. Покупателям Маркет показывает цену в рублях, пересчитывая ее по курсу Центробанка.

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

Элемент <currencyId> внутри элемента <offer>.

Характеристики, которые есть только у товаров конкретной категории

Что это за характеристики

Можно передавать в элементах <param> внутри элемента <offer>. Каждый элемент <param> имеет обязательный атрибут name для названия характеристики и необязательный units для единиц измерения.

Атрибут name соответствует определенному полю в карточке товара — оно должно совпадать с названием характеристики из Excel-шаблона категории. Если название атрибута не будет совпадать, поле в карточке товара останется пустым.

Если значений одного атрибута несколько, каждое из них должно быть в отдельной строке.

<offer>
                       ...
                       <param name="Номер карточки">75483602</param>
                       <param name="Состав">хлопок 100%</param>
                       <param name="Размер в сетке">S</param>
                       <param name="Размерная сетка">INT</param>
                       </offer>