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

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

Пример для формата 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 см. по ссылке.
Обязательно
condition
Внимание. Используется только в формате YML.

Используйте элемент для товаров, товаров, уцененных из-за недостатков.

  • В атрибуте type укажите значение likenew (означает, что товар не был в употреблении).
  • В элементе reason укажите причину уценки.

Пример:

<condition type="likenew">
   <reason>Повреждена упаковка</reason>
</condition>
Дополнительная информация

На Маркете во многих категориях можно размещать товары, уцененные из-за недостатков (likenew), и товары, бывшие в употреблении (used). Однако в категории «Алкоголь» можно размещать только новые товары, уцененные из-за недостатков. Нельзя размещать товары, бывшие в употреблении.

Необязательно
condition-type
Внимание. Используется только в формате CSV.

Используйте элемент для товаров, уцененных из-за недостатков. Укажите значение likenew (означает, что товар не был в употреблении).

Если товар не уценен, не используйте этот элемент.

Дополнительная информация

На Маркете во многих категориях можно размещать товары, уцененные из-за недостатков (likenew), и товары, бывшие в употреблении (used). Однако в категории «Алкоголь» можно размещать только новые товары, уцененные из-за недостатков. Нельзя размещать товары, бывшие в употреблении.

Необязательно
condition-reason
Внимание. Используется только в формате CSV.

Причины уценки.

Обязательно, если указан condition-type
Остальные элементы Описание Обязательность

id

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

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

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

Обязательно

bid

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

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

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

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

url

URL страницы товара на сайте магазина. Максимальная длина ссылки — 512 символов. Допускаются кириллические ссылки. 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

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

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

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

vendorCode

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

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

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

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

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

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

description

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

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

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

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

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

sales_notes

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

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

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

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

country_of_origin

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

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

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

expiry

Срок годности / срок службы либо дата истечения срока годности / срока службы.

Значение элемента должно быть в формате ISO8601:

  • Для срока годности / срока службы — P1Y2M10DT2H30M. Расшифровка примера — 1 год, 2 месяца, 10 дней, 2 часа и 30 минут.

  • Для даты истечения срока годности / срока службы — YYYY-MM-DDThh:mm.

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

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.

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