Алкогольные напитки. Форматы: YML, CSV

Внимание. Чтобы размещать на Маркете алкоголь, необходимо предоставить лицензии и гарантийное письмо. Подробнее см. в разделе Алкогольная продукция на Маркете.
  1. Пример для формата YML
  2. Список и описание элементов

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

<shop>
 <name>BestSeller</name>
 <company>Tne Best inc.</company>
 <url>http://best.seller.ru</url>
 <currencies>
   <currency id="RUR" rate="1"/>
 </currencies>
 <categories>
   <category id="1">Алкоголь</category>
   <category id="2" parentId="1">Шампанское и игристые вины</category>
 </categories>
 <offers>
   <offer id="345925" type="alco" bid="80">
    <name>Игристое вино брют розовое Santa Margherita Rose Италия, 0.75 л</name>
    <vendor>Santa Margherita</vendor>
    <url>http://shop.seller.ru/products/342995</url>
    <price>1750</price>
    <oldprice>1600</price>
    <currencyId>RUR</currencyId>
    <categoryId>3</categoryId>
    <picture>http://media.seller.ru/shop/342995_large.jpg</picture>
    <description>Прекрасный аперитив. Отлично сочетается с морепродуктами и белым 
мясом птицы.</description>
    <country_of_origin>Италия</country_of_origin>
    <pickup>true</pickup>
    <param name="Объем" unit="л">0.75</param>
    <param name="содержание сахара">брют</param>
    <param name="год урожая">2016</param>
    <param name="крепость">12.5%</param>
    <param name="цвет">розовое</param>
    <barcode>4607071772810</barcode>
  </offer>  
 </offers>
</shop>

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

Категории в блоке shop

В элементе categories рекомендуем использовать такое дерево и названия:

<categories>
  <category id="1">Алкоголь</category>
  <category id="2" parentId="1">Коньяк, арманьяк, бренди</category>
  <category id="3" parentId="1">Виски, бурбон</category>
  <category id="4" parentId="1">Крепкий алкоголь</category>
  <category id="5" parentId="1">Ликеры, настойки, наливки</category>
  <category id="6" parentId="1">Водка</category>
  <category id="7" parentId="1">Слабоалкогольные напитки</category>
  <category id="8" parentId="1">Шампанское и игристое вино</category>
  <category id="9" parentId="1">Вино</category>
  <category id="10" parentId="1">Крепленое вино</category>
  <category id="11" parentId="1">Пиво и пивные напитки</category>
</categories>

Идентификаторы категорий могут быть другими (удобные вам).

Предложение offer

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

type

Тип описания предложения. Значение должно быть alco.

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

Обязательно

name

Название предложения. Составляйте согласно рекомендациям в файле: Скачать

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

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

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

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

Наличие товара:

  • Значение true — товар в наличии, отображается на Маркете.

  • Значение false — товара нет, он будет скрыт с Маркета.

Если элемент не указан, считается, что товар в наличии (значение по умолчанию — true).

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

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

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

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

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

Все важные характеристики напитка — объем, выдержка, крепость, год урожая и т. п.

Объем

Возможные варианты на примере YML:

<param name="Объем" unit="литр">0.7</param>
<param name="Объём" unit="л">0.750</param>
<param name="Volume" unit="L">0.7</param>
<param name="Объем" unit="мл">450</param>
Внимание. Разделитель целой и дробной части — точка.
Выдержка
Можно указывать в европейской системе (VSOP, XO и т. п.) или в годах. Пример для YML: 
<param name="Выдержка" unit="лет">12</param>
<param name="Выдержка">XO</param>
Сорта винограда
В YML каждый сорт укажите в отдельном элементе param:
<param name="Сорт винограда">Санджовезе</param>
<param name="Сорт винограда">Каберне 
совиньон</param>
Подарочная упаковка
<param name="Подарочная упаковка">есть</param>

или

<param name="Подарочная упаковка">да</param>
Остальные характеристики
Заполните согласно рекомендациям в файле: Скачать
Примечание. Структуру элемента param в CSV см. по ссылке.
 Обязательно
Остальные элементы Описание Обязательность

id

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

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

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

Обязательно

bid

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

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

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

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

url

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

Обязательно

currencyId

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

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

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

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

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

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

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

Если это набор с разными напитками (например, бутылка шампанского + бутылка вина), укажите категорию одного из напитков (например, напитка, который считается основным).		 Обязательно

picture

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

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

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

price

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Обязательно

oldprice

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

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

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

purchase_price

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

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

vendorCode

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

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

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

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

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

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.

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

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, разделитель целой и дробной части — точка. Числа должны быть разделены символом «/» без пробелов.

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

age

Возрастное ограничение на товар.

В формате CSV:
Можно указывать только годы. Допустимые значения: 0, 6, 12, 16, 18.
В формате YML:

  • Годы задаются с помощью атрибута unit со значением year. Допустимые значения параметра age при unit="year": 0, 6, 12, 16, 18.

  • Месяцы задаются с помощью атрибута unit со значением month. Допустимые значения параметра age при unit="month": 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12.

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

type

Тип описания предложения. Значение должно быть alco.

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

Обязательно

name

Название предложения. Составляйте согласно рекомендациям в файле: Скачать

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

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

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

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

Наличие товара:

  • Значение true — товар в наличии, отображается на Маркете.

  • Значение false — товара нет, он будет скрыт с Маркета.

Если элемент не указан, считается, что товар в наличии (значение по умолчанию — true).

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

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

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

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

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

Все важные характеристики напитка — объем, выдержка, крепость, год урожая и т. п.

Объем

Возможные варианты на примере YML:

<param name="Объем" unit="литр">0.7</param>
<param name="Объём" unit="л">0.750</param>
<param name="Volume" unit="L">0.7</param>
<param name="Объем" unit="мл">450</param>
Внимание. Разделитель целой и дробной части — точка.
Выдержка
Можно указывать в европейской системе (VSOP, XO и т. п.) или в годах. Пример для YML: 
<param name="Выдержка" unit="лет">12</param>
<param name="Выдержка">XO</param>
Сорта винограда
В YML каждый сорт укажите в отдельном элементе param:
<param name="Сорт винограда">Санджовезе</param>
<param name="Сорт винограда">Каберне 
совиньон</param>
Подарочная упаковка
<param name="Подарочная упаковка">есть</param>

или

<param name="Подарочная упаковка">да</param>
Остальные характеристики
Заполните согласно рекомендациям в файле: Скачать
Примечание. Структуру элемента param в CSV см. по ссылке.
 Обязательно
Остальные элементы Описание Обязательность

id

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

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

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

Обязательно

bid

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

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

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

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

url

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

Обязательно

currencyId

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

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

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

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

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

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

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

Если это набор с разными напитками (например, бутылка шампанского + бутылка вина), укажите категорию одного из напитков (например, напитка, который считается основным).		 Обязательно

picture

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

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

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

price

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Обязательно

oldprice

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

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

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

purchase_price

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

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

vendorCode

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

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

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

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

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

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.

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

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, разделитель целой и дробной части — точка. Числа должны быть разделены символом «/» без пробелов.

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

age

Возрастное ограничение на товар.

В формате CSV:
Можно указывать только годы. Допустимые значения: 0, 6, 12, 16, 18.
В формате YML:

  • Годы задаются с помощью атрибута unit со значением year. Допустимые значения параметра age при unit="year": 0, 6, 12, 16, 18.

  • Месяцы задаются с помощью атрибута unit со значением month. Допустимые значения параметра age при unit="month": 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12.

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