Лекарства. Форматы YML, CSV

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

  • лекарственными препаратами и средствами;

  • биологически активными добавками (БАД).

Если товар может продаваться в аптеке, но не относится к лекарственным препаратам или БАДам, используйте упрощенный или произвольный тип описания.

Внимание.

  • Не принимаются к публикации на Маркете предложения на препараты, подлежащие предметно-количественному учету.

  • Рецептурные препараты, не подлежащие предметно-количественному учету, принимаются к публикации.

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

  • Аптечный магазин должен создать точки продаж в личном кабинете, если планирует продавать безрецептурные лекарства только через самовывоз или если в ассортименте магазина рецептурные препараты.

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

Рекомендуем ознакомиться с рекомендацией Как составить предложение для категории «Лекарственные препараты и БАДы».

  1. Пример для формата YML
  2. Список и описание элементов

Пример для формата YML

<offer id="12345" type="medicine" bid="80" cbid="90">
  <name>БАД Селен-актив n30 таблетки</name>
  <vendor>ОАО ДИОД Завод эко.тех.и питания</vendor>
  <vendorCode>123456</vendorCode>
  <currencyId>RUB</currencyId>
  <categoryId>4062</categoryId>
  <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>
  <pickup-options>
    <option cost="300" days="1-3"/>                        
  </pickup-options>
  <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>
</offer>

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

Элементы с особыми значениями Описание Обязательность

type

Тип описания предложения.

Внимание. Значение обязательно должно быть medicine.

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

 Обязательно
pickup

Возможность забрать товар в пункте выдачи (самовывоз).

Внимание. Для рецептурных лекарств значение обязательно должно быть true.
 Обязательно
delivery

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

Внимание. Для рецептурных лекарств значение обязательно должно быть false.

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

 Обязательно
param

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

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

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

name

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

Обязательно

vendor

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

Необязательно

vendorCode

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

Необязательно

id

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

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

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

Обязательно

bid

Размер ставки.

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

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

Необязательно

cbid

Внимание. Элемент устарел. Используйте вместо него элемент bid.

Необязательно

url

URL страницы товара на сайте магазина. Максимальная длина ссылки — 2048 символов. Допускаются кириллические ссылки. URL‑адрес формируется на основе стандарта RFC 3986.

Обязательно

price

Актуальная цена товара.

  • Формат: целое или дробное число.

  • Разделитель целой и дробной части — точка.

  • Цена должна соответствовать стоимости товара, иначе магазин при проверке получит ошибку.

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

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

Посмотреть список категорий

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

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

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

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

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

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

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

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

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

Обязательно

oldprice

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

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

Необязательно

purchase_price

Закупочная цена товара. Она нужна для расчета наценки и настройки стратегии по маржинальности в PriceLabs.

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

Автоматический расчет и показ скидок для предложения.

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

Необязательно

currencyId

Валюта, в которой указана цена товара: RUR, USD, EUR, UAH, KZT, BYN. Цена и валюта должны соответствовать друг другу. Например, вместе с USD надо указывать цену в долларах, а не в рублях.

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

Обязательно

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

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

Обязательно

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

Название категории товара.

Обязательно

picture

URL-ссылка на картинку товара.

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

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

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

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

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

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

Необязательно

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

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

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

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

Необязательно

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

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

Примеры значений

  • Доставка в день заказа (сегодня) — значение 0.

  • Доставка на следующий день (завтра) — значение 1.

  • Доставки от двух до четырех дней — значение 2–4.

    Внимание. При указании срока «от — до» разница между минимальным и максимальным значением должна быть не больше трех дней.

Максимальный срок, который показывает Маркет, — 31 день. Если указано значение 32 или больше, появится информация о доставке «до 60 дней» (или надпись «предзаказ», если в базе данных Маркета есть дата, когда товар официально начнет продаваться).

Также срок доставки по своему региону можно настроить в личном кабинете.

Необязательно

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

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

Также стоимость доставки по своему региону можно настроить в личном кабинете.

Необязательно

local-pickup-days
Внимание. Используется только в формате CSV.

Срок поставки товара в пункты выдачи в регионе магазина (в календарных днях).

Примеры значений

Товар доступен для самовывоза:

  • в день заказа (сегодня) — значение 0;

  • на следующий день (завтра) — значение 1;

  • в срок от двух до четырех дней — значение 2–4.

    Внимание. При указании срока «от — до» разница между минимальным и максимальным значением должна быть не больше двух дней.

Максимальный срок, который показывает Маркет, — 31 день. Если указано значение 32 или больше, появится информация о доставке в пункты выдачи « до 60 дней » (или надпись « предзаказ », если в базе данных Маркета есть дата, когда товар официально начнет продаваться).

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

Необязательно

local-pickup-cost
Внимание. Используется только в формате CSV.

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

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

Необязательно

store

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

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

  • true — товар можно купить без предварительного заказа;

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

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

Необязательно

description

Описание предложения. Оно отображается:

  • в разделе Все предложения карточки товара — в полном виде;

  • в результатах поиска Маркета — в сокращенном виде (описание длиной не больше 300 символов).

Длина текста — не более 3000 символов (включая знаки препинания).

В описании запрещено указывать:
  • Номера телефонов, адреса электронной почты, почтовые адреса, номера ICQ, логины мессенджеров, любые ссылки.
  • Слова «скидка», «распродажа», «дешевый», «подарок» (кроме подарочных категорий), «бесплатно», «акция», «специальная цена», «новинка», «new», «аналог», «заказ», «хит».
  • Условия продажи товара, например, данные об акциях или предоплате (их нужно передавать в элементе sales_notes в YML / Условия продажи в XLS).
  • Регион, в котором продается товар.
  • Информацию о разных модификациях товара (например, нельзя писать «товар в ассортименте»). Для каждой модификации нужно создать отдельное предложение.

В формате YML допустимо использовать некоторые xhtml-теги при условии, что они заключены в блок CDATA и соблюдены общие правила стандарта XHTML.

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

Необязательно

sales_notes
  • Элемент обязателен, если у вас есть ограничения при покупке (например, минимальное количество товаров или необходимость предоплаты).

  • Также можно указать варианты оплаты, акции и распродажи. В этом случае использование элемента необязательно.

  • Не указывайте в элементе информацию, которая заставляет покупателя уходить с Маркета. Например, «Скидка в группе ВКонтакте — 2%».

Допустимая длина текста — 50 символов.

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

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

country_of_origin

Страна производства товара. Информацию необходимо указывать по закону. Если поле будет не заполнено, товар может быть скрыт с витрины.

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

Поле необязательно, но рекомендуем его заполнить

barcode

Штрихкод товара от производителя в одном из форматов: EAN-13, EAN-8, UPC-A, UPC-E.

В YML элемент offer может содержать несколько элементов barcode.

Данные в barcode влияют на привязку предложения к карточке товара и отображение правильных характеристик, которые соответствуют модификации товара на его карточке. Рекомендуем ознакомиться с подробным описанием элемента.

Необязательно

expiry

Срок годности или службы.

Значение элемента должно соответствовать стандарту ISO 8601. Например: P1Y2M10DT2H — 1 год, 2 месяца, 10 дней, 2 часа.

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

  • дату и время истечения срока по стандарту ISO 8601: 2022-12-10T12:00;

  • срок с точностью до минут: P1Y2M10DT2H30M — 1 год, 2 месяца, 10 дней, 2 часа, 30 минут.

В дальнейшем эти возможности перестанут поддерживаться.

Необязательно

weight

Вес товара в килограммах с учетом упаковки.

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

Скачать список минимальных и максимальных значений веса.

В любой категории вес можно указывать с точностью до тысячных (например, 1.001 кг; разделитель целой и дробной части — точка).

Если минимальное значение указано 0, ограничений по минимальному весу нет, и можно указывать начиная с одного грамма (0.001 кг).

Необязательно

dimensions

Габариты товара (длина, ширина, высота) в упаковке. Размеры укажите в сантиметрах.

Формат: три положительных числа с точностью 0.001, разделитель целой и дробной части — точка. Числа должны быть разделены символом «/» без пробелов.

Необязательно
Элементы с особыми значениями Описание Обязательность

type

Тип описания предложения.

Внимание. Значение обязательно должно быть medicine.

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

 Обязательно
pickup

Возможность забрать товар в пункте выдачи (самовывоз).

Внимание. Для рецептурных лекарств значение обязательно должно быть true.
 Обязательно
delivery

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

Внимание. Для рецептурных лекарств значение обязательно должно быть false.

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

 Обязательно
param

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

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

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

name

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

Обязательно

vendor

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

Необязательно

vendorCode

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

Необязательно

id

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

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

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

Обязательно

bid

Размер ставки.

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

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

Необязательно

cbid

Внимание. Элемент устарел. Используйте вместо него элемент bid.

Необязательно

url

URL страницы товара на сайте магазина. Максимальная длина ссылки — 2048 символов. Допускаются кириллические ссылки. URL‑адрес формируется на основе стандарта RFC 3986.

Обязательно

price

Актуальная цена товара.

  • Формат: целое или дробное число.

  • Разделитель целой и дробной части — точка.

  • Цена должна соответствовать стоимости товара, иначе магазин при проверке получит ошибку.

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

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

Посмотреть список категорий

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

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

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

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

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

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

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

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

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

Обязательно

oldprice

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

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

Необязательно

purchase_price

Закупочная цена товара. Она нужна для расчета наценки и настройки стратегии по маржинальности в PriceLabs.

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

Автоматический расчет и показ скидок для предложения.

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

Необязательно

currencyId

Валюта, в которой указана цена товара: RUR, USD, EUR, UAH, KZT, BYN. Цена и валюта должны соответствовать друг другу. Например, вместе с USD надо указывать цену в долларах, а не в рублях.

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

Обязательно

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

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

Обязательно

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

Название категории товара.

Обязательно

picture

URL-ссылка на картинку товара.

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

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

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

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

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

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

Необязательно

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

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

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

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

Необязательно

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

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

Примеры значений

  • Доставка в день заказа (сегодня) — значение 0.

  • Доставка на следующий день (завтра) — значение 1.

  • Доставки от двух до четырех дней — значение 2–4.

    Внимание. При указании срока «от — до» разница между минимальным и максимальным значением должна быть не больше трех дней.

Максимальный срок, который показывает Маркет, — 31 день. Если указано значение 32 или больше, появится информация о доставке «до 60 дней» (или надпись «предзаказ», если в базе данных Маркета есть дата, когда товар официально начнет продаваться).

Также срок доставки по своему региону можно настроить в личном кабинете.

Необязательно

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

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

Также стоимость доставки по своему региону можно настроить в личном кабинете.

Необязательно

local-pickup-days
Внимание. Используется только в формате CSV.

Срок поставки товара в пункты выдачи в регионе магазина (в календарных днях).

Примеры значений

Товар доступен для самовывоза:

  • в день заказа (сегодня) — значение 0;

  • на следующий день (завтра) — значение 1;

  • в срок от двух до четырех дней — значение 2–4.

    Внимание. При указании срока «от — до» разница между минимальным и максимальным значением должна быть не больше двух дней.

Максимальный срок, который показывает Маркет, — 31 день. Если указано значение 32 или больше, появится информация о доставке в пункты выдачи « до 60 дней » (или надпись « предзаказ », если в базе данных Маркета есть дата, когда товар официально начнет продаваться).

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

Необязательно

local-pickup-cost
Внимание. Используется только в формате CSV.

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

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

Необязательно

store

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

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

  • true — товар можно купить без предварительного заказа;

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

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

Необязательно

description

Описание предложения. Оно отображается:

  • в разделе Все предложения карточки товара — в полном виде;

  • в результатах поиска Маркета — в сокращенном виде (описание длиной не больше 300 символов).

Длина текста — не более 3000 символов (включая знаки препинания).

В описании запрещено указывать:
  • Номера телефонов, адреса электронной почты, почтовые адреса, номера ICQ, логины мессенджеров, любые ссылки.
  • Слова «скидка», «распродажа», «дешевый», «подарок» (кроме подарочных категорий), «бесплатно», «акция», «специальная цена», «новинка», «new», «аналог», «заказ», «хит».
  • Условия продажи товара, например, данные об акциях или предоплате (их нужно передавать в элементе sales_notes в YML / Условия продажи в XLS).
  • Регион, в котором продается товар.
  • Информацию о разных модификациях товара (например, нельзя писать «товар в ассортименте»). Для каждой модификации нужно создать отдельное предложение.

В формате YML допустимо использовать некоторые xhtml-теги при условии, что они заключены в блок CDATA и соблюдены общие правила стандарта XHTML.

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

Необязательно

sales_notes
  • Элемент обязателен, если у вас есть ограничения при покупке (например, минимальное количество товаров или необходимость предоплаты).

  • Также можно указать варианты оплаты, акции и распродажи. В этом случае использование элемента необязательно.

  • Не указывайте в элементе информацию, которая заставляет покупателя уходить с Маркета. Например, «Скидка в группе ВКонтакте — 2%».

Допустимая длина текста — 50 символов.

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

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

country_of_origin

Страна производства товара. Информацию необходимо указывать по закону. Если поле будет не заполнено, товар может быть скрыт с витрины.

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

Поле необязательно, но рекомендуем его заполнить

barcode

Штрихкод товара от производителя в одном из форматов: EAN-13, EAN-8, UPC-A, UPC-E.

В YML элемент offer может содержать несколько элементов barcode.

Данные в barcode влияют на привязку предложения к карточке товара и отображение правильных характеристик, которые соответствуют модификации товара на его карточке. Рекомендуем ознакомиться с подробным описанием элемента.

Необязательно

expiry

Срок годности или службы.

Значение элемента должно соответствовать стандарту ISO 8601. Например: P1Y2M10DT2H — 1 год, 2 месяца, 10 дней, 2 часа.

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

  • дату и время истечения срока по стандарту ISO 8601: 2022-12-10T12:00;

  • срок с точностью до минут: P1Y2M10DT2H30M — 1 год, 2 месяца, 10 дней, 2 часа, 30 минут.

В дальнейшем эти возможности перестанут поддерживаться.

Необязательно

weight

Вес товара в килограммах с учетом упаковки.

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

Скачать список минимальных и максимальных значений веса.

В любой категории вес можно указывать с точностью до тысячных (например, 1.001 кг; разделитель целой и дробной части — точка).

Если минимальное значение указано 0, ограничений по минимальному весу нет, и можно указывать начиная с одного грамма (0.001 кг).

Необязательно

dimensions

Габариты товара (длина, ширина, высота) в упаковке. Размеры укажите в сантиметрах.

Формат: три положительных числа с точностью 0.001, разделитель целой и дробной части — точка. Числа должны быть разделены символом «/» без пробелов.

Необязательно