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>

Порог для скидок с Маркетом

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

Подробно об этом способе продвижения читайте в статье Скидки с Маркетом.

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

<cofinance_price>300</cofinance_price>

Видео

Элемент <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 — музыкальная или видеопродукция;

• on.demand — товар под заказ.

<offer type="audiobook">

Буду маркировать

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

Для товаров, подлежащих обязательной маркировке, нужно корректно передать код ТН ВЭД.

Элемент <cargo-types>CIS_REQUIRED</cargo-types> внутри элемента <offer>.

<offer>
                           ...
                           <cargo-types>CIS_REQUIRED</cargo-types>
                           </offer>

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

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

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

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

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

Цифровой товар

Параметр, устанавливаемый для цифровых товаров, которые просто скачиваются.

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

<offer>
                           ...
                           <downloadable>true</downloadable>
                           </offer>

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

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

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

Элемент <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>

НДС

Значение ставки НДС для товара.

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

<vat>VAT_20</vat>

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

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

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

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

<count>7</count>

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

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

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

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

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

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

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

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

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

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

<offer id="12345-abcd">
                       ...
                       <disabled>true</disabled>
                       ...
                       </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>

Только для уценки

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

Тип уценки

Элемент <condition> внутри элемента <offer>. Тип задается в атрибуте type. Возможные значения:

• preowned — бывший в употреблении товар, раньше принадлежал другому человеку.
• showcasesample — витринный образец.
• reduction — уцененный товар, есть дефекты.
• renovated — восстановленный товар.
• refurbished — повторная продажа товара. Для одежды и аксессуаров указывайте только это значение. Не используйте для других категорий.

<condition type="reduction">...</condition>

Внешний вид

Элемент <quality> внутри элемента <condition>. Возможные значения:

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

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

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

Элемент <reason> внутри элемента <condition>.

<condition type="preowned">
       <quality>excellent</quality>
       <reason>
       <![CDATA[
         <ul>
         <li>Описание: телефон как новый, полностью в рабочем состоянии, есть незначительные следы эксплуатации — небольшие потертости по центру задней крышки.
 </li>
         <li>Комплект: полный комплект с инструкцией, зарядкой и наушниками.</li>
         <li>Упаковка: есть две заметных царапины на заводской упаковке, замят уголок коробки.</li>
         <li>Гарантия: 90 дней.</li>
         </ul>
       ]]>
       </reason>
 </condition>

Только для модели DBS

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

Эти настройки очень гибкие — например, для каждого товара можно указать несколько вариантов доставки. Полноценно ими управлять можно только на странице товара в кабинете или через YML.

Обратите внимание: параметры доставки и самовывоза есть не только у товара, но и у самого DBS-магазина. Если для товара ничего не задано, действуют настройки, заданные для магазина.

Валюта

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

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

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

Товар в наличии

Поле указывает, есть ли товар в наличии.

Элемент <available> указывается как атрибут элемента <offer>. true — товар в наличии, false — отсутствует.

<offer id="12345-abcd" available="false">

Доставка

Есть ли курьерская доставка.

Элемент <delivery>false</delivery> внутри элемента <offer> или <shop>.

<delivery>true</delivery>

Срок доставки

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

Если возможна доставка в день заказа, укажите 0. Если не знаете точное количество дней, укажите интервал через дефис. Разброс не должен превышать двух дней.

Если доставка дольше 30 дней

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

Атрибут days элемента <option> внутри <delivery-options>.

<delivery-options> может содержать до пяти <option>.

<delivery-options>
                       <option days="1" order-before="14"/>
                       </delivery-options>

Доставка при заказе до

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

Атрибут order-before элемента <option> внутри <delivery-options>.

<delivery-options> может содержать до пяти <option>.

<delivery-options>
                       <option days="1" order-before="14"/>
                       </delivery-options>

Самовывоз

Доступен ли самовывоз.

Элемент <pickup>false</pickup> внутри элемента <offer> или <shop>.

<pickup>true</pickup>

Срок самовывоза

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

Если возможен самовывоз в день заказа, укажите 0. Если не знаете точное количество дней, укажите интервал через дефис. Разброс не должен превышать двух дней.

Если самовывоз доступен через 30 дней или позже

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

Атрибут days элемента <option> внутри <pickup-options>.

<pickup-options> может содержать до пяти <option>.

<pickup-options>
                       <option days="1" order-before="14"/>
                       </pickup-options>

Самовывоз при заказе до

Атрибут order-before элемента <option> внутри <pickup-options>.

<pickup-options> может содержать до пяти <option>.

<pickup-options>
                       <option days="1" order-before="14"/>
                       </pickup-options>

Полезные ссылки

• Документация API Яндекс Маркета для продавцов
• Новости для партнеров
• Наш Телеграм-канал
• Обучающие видеоролики