offer, описание одного товара

Пример

<offer id="50736">
  <name>Антиперспирант женский Цветочный бриз Каждый День, 50мл</name>
  <price>100</price><!--Цена во всех точках, кроме указанных в outlets-->
  <oldprice>120</oldprice><!--Старая цена для расчета скидки во всех точках, кроме 
указанных в outlets-->
  <promo id="1"/><!--Акция во всех точках, кроме указанных в outlets-->
  <currencyId>RUR</currencyId>
  <categoryId>24048</categoryId>
  <vendor>Цветочный бриз</vendor>
  <vendorCode>4690363024544</vendorCode>
  <description>50 мл</description>
  <barcode>4690363024544</barcode>
  <param name="weight" unit="г">50</param>
  <outlets>
    <outlet id="1001" instock="11">
      <price>90</price><!--Цена только в этой точке-->
      <oldprice>120</oldprice><!--Старая цена для расчет скидки только в этой точке-->
      <promo id="2"/><!--Акция только в этой в точке-->
    </outlet>
    <outlet id="1002" instock="5"/>
  </outlets>
  <private-label>true</private-label>
</offer>

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

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

id

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

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

Обязательно

type Отметка о том, что товар является алкоголем. Укажите type="alco" для алкогольных напитков. Обязательно только для алкоголя

name

Полное название предложения, в которое входит: тип товара, производитель, название товара, важные характеристики. Составляйте по схеме: что (тип товара) + кто (производитель) + товар (название) + важные характеристики.

Обязательно

price

Текущая цена товара.

Примечание. Если товар продается по весу (не штуками), указывайте цену за 1 кг. Например, если вы продаете на развес фрукты, овощи, конфеты и т. п.

Обязательно

oldprice

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

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

currencyId

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

Обязательно

categoryId

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

Обязательно

vendor

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

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

vendorCode

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

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

outlets

Информация по точкам продаж (количество товара, цена и/или акция которая действует только в определенной точке).

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

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

description

Характеристики товара: объем (в литрах, миллилитрах); количество штук, крепость, жирность и т. п.

Примечание. Вес и размеры указывайте в отдельных элементах: param, dimensions.

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

country_of_origin

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

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

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

barcode

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

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

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

param

Все важные характеристики товара — вес, объем, количество штук и т. д.

offer может содержать несколько элементов param (один элемент param — одна характеристика).

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

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

expiry

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

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

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

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

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

dimensions

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

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

50.5/47/100

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

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.

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

private-label

Товар собственной торговой марки. Возможные значения: true, false. Значение по умолчанию: false. Необязательно