Все элементы, входящие в offer. Упрощенный тип. Форматы YML, CSV

YML

В этом разделе описаны все элементы одного предложения — offer. Описание элементов более высокого уровня (offers и другие) см. в разделе Формат YML.

XLS

Данный раздел не относится к формату XLS. Описание полей в формате XLS см. в разделе Формат XLS / Описание полей.

CSV

В этом разделе представлено описание всех элементов для формата CSV.

Упрощенный тип

Упрощенный и произвольный типы описаний подходят для большинства товаров.

Оба типа описаний предоставляют равные возможности и обеспечивают одинаковое качество привязки к карточкам модели и публикации на Маркете. Однако упрощенный тип более гибкий, поскольку элементы model и vendor являются для него необязательными, тогда как для произвольного типа они обязательны.

Примеры

Пример одного предложения (offer) для формата YML
<offer id="12341" available="true" bid="80" cbid="90" fee="325">
  <url>http://best.seller.ru/product_page.asp?pid=12345</url>
  <price>8990</price>
  <oldprice>9900</oldprice>
  <currencyId>RUR</currencyId>
  <categoryId>102</categoryId>
  <picture>http://best.seller.ru/img/model_12345.jpg</picture>
  <store>false</store>
  <pickup>false</pickup>
  <delivery>true</delivery>
  <delivery-options>
    <option cost="300" days="1" order-before="18"/>
  </delivery-options>
  <outlets> 
    <outlet id="1" instock="50"/>
    <outlet id="2" instock="20"/>
  </outlets>
  <vendor>Brand</vendor>
  <name>Мороженица Brand 3811</name>>
  <description>
  <![CDATA[
    <h3>Мороженица Brand 3811</h3>
    <p>Это прибор, который придётся по вкусу всем любителям десертов и сладостей, ведь с его помощью вы сможете делать вкусное домашнее мороженое из натуральных ингредиентов.</p>
  ]]>
  </description>
  <param name="Цвет">белый</param>
  <sales_notes>Необходима предоплата.</sales_notes>
  <manufacturer_warranty>true</manufacturer_warranty>
  <country_of_origin>Китай</country_of_origin>
  <barcode>0123456789379</barcode>
  <cpa>1</cpa>
  <rec>789,120</rec>
</offer>

Скачать пример полностью заполненного прайс-листа

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

Скачать пример прайс-листа

Список и описание элементов упрощенного типа

Элементы, специфичные для типа описания, формируют название предложения на Маркете и влияют на привязку к карточке модели. Рекомендуем обязательно ознакомиться с разделом vendor, name, model, typePrefix, в котором подробно рассмотрены нюансы составления названия предложения.

Элементы, специфичные для упрощенного типа описания Описание элемента Обязательность элемента

name

Полное название предложения, в которое входит: тип товара, производитель, название товара. Составляйте по схеме «ЧТО (тип товара) + КТО (производитель) + ТОВАР».

Обязательный элемент.

model

Модель товара.

Необязательный элемент.

vendor

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

Необязательный элемент.

vendorCode

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

Необязательный элемент.

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

id

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

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

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

Обязательный элемент.

cbid

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

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

Подробное описание атрибута.

Необязательный элемент.

bid

Размер ставки на остальных местах размещения (все, кроме карточки товара).

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

Подробное описание атрибута.

Необязательный элемент.

fee

Размер комиссии от цены товара, если товар будет заказан на Маркете.

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

Подробное описание атрибута.

Необязательный элемент.

available

Статус товара:

true — «в наличии» / «готов к отправке»

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

false — «на заказ»

Точный срок доставки курьером или в пункт выдачи неизвестен. Срок будет согласован с покупателем персонально (максимальный срок — два месяца). На Маркете у товара будет показана надпись «на заказ» вместо срока.

Внимание. Элемент используется в дополнение к данным, настроенным в личном кабинете. Элемент не используется, когда условия локальной курьерской доставки настроены в прайс-листе (любого формата).

Является атрибутом для offer. Если элемент не указан, используется значение по умолчанию — true.

Подробное описание элемента.
Необязательный элемент.

url

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

Если магазин размещается по обеим моделям сразу:

  • передавайте url, чтобы был доступен переход с предложения на сайт;

  • не передавайте url, чтобы переход с предложения на сайт был недоступен.

Элемент обязателен для модели «Переход на сайт» .

price

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

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

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

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

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

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

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

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

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

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

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

Обязательный элемент.

oldprice

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

Примечание. Скидка обновляется на Маркете каждые 40–80 минут.

Необязательный элемент.

currencyId

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

Примечание. В текстовом формате нет возможности указать свои условия конвертации валют. При показе цены покупателю она будет пересчитана в нужную валюту по текущему курсу ЦБ РФ.

Обязательный элемент.

categoryId

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

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

Обязательный элемент.

category

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

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

Обязательный элемент.

picture

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

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

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

delivery

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

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

  • true — товар может быть доставлен курьером.

  • false — товар не может быть доставлен курьером (только самовывоз);

Внимание. Элемент delivery должен обязательно иметь значение false, если товар запрещено продавать дистанционно (ювелирные изделия, лекарственные средства).

Если элемент не указан, то принимается значение по умолчанию, см. подробное описание элемента.

Необязательный элемент.

delivery-options

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

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

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

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

Необязательный элемент.

local_delivery_days

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

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

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

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

Также можно указать период «от — до» дней, например: 2–4.

Внимание. При указании периода «от — до» разброс минимального и максимального срока доставки должен составлять не более трех дней.

Максимальное значение, показываемое на Маркете — 31 день. Значение 32 и больше (либо значение не указано вообще) — показывается надпись «на заказ».

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

Необязательный элемент.

local_delivery_cost

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

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

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

Необязательный элемент.

pickup

Возможность самовывоза из пунктов выдачи.

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

  • true — товар можно забрать в пунктах выдачи («самовывозом»);

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

Если элемент не указан, то принимается значение по умолчанию, см. подробное описание элемента.

Необязательный элемент.

store

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

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

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

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

Если элемент не указан, то принимается значение по умолчанию, см. подробное описание элемента.

Необязательный элемент.

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

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

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

Необязательный элемент.

description

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

  • давать инструкции по применению, установке или сборке;

  • использовать слова «скидка», «распродажа», «дешевый», «подарок» (кроме подарочных категорий), «бесплатно», «акция», «специальная цена», «новинка», «new», «аналог», «заказ», «хит»;

  • указывать номера телефонов, адреса электронной почты, почтовые адреса, номера ICQ, логины мессенджеров, любые URL-ссылки.

В формате YML допустимо использовать следующие xhtml-теги <h3>...</h3>, <ul><li>...</li></ul>, <p>...</p>, <br/> при условии, что:

  • они заключены в блок CDATA в формате <![CDATA[ Текст с использованием xhtml-разметки ]]>;

  • соблюдены общие правила стандарта XHTML.

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

Необязательный элемент.

sales_notes

  • Если в вашем магазине есть следующие условия заказа, обязательно укажите их:

    • минимальная сумма заказа;

    • минимальная партия товара;

    • необходимость предоплаты.

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

    В этом случае использование элемента необязательно.

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

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

Минимальное количество одинаковых товаров в одном заказе (для случаев, когда покупка возможна только комплектом, а не поштучно). Элемент используется только в категориях «Автошины» , «Грузовые шины», «Мотошины», «Диски» .

Если элемент не указан, используется значение по умолчанию — 1.

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

Необязательный элемент.

step-quantity

Количество товара, которое покупатель может добавлять к минимальному в корзине Яндекс.Маркета. Элемент используется в дополнение к min-quantity и только в категориях «Автошины» , «Грузовые шины», «Мотошины», «Диски» .

Если элемент не указан, используется значение по умолчанию — 1.

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

Необязательный элемент.

manufacturer_warranty

Официальная гарантия производителя.

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

  • true — товар имеет официальную гарантию производителя;

  • false — товар не имеет официальной гарантии производителя.

Необязательный элемент.

country_of_origin

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

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

Примечание. Если вы хотите участвовать в программе «Заказ на Маркете» , то желательно указывать данный элемент.

Необязательный элемент.

adult

Товар имеет отношение к удовлетворению сексуальных потребностей, либо иным образом эксплуатирует интерес к сексу. Возможные значения — true, false.

Необязательный элемент.

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.

Необязательный элемент.

barcode

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

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

Необязательный элемент.

cpa

Участие предложений в программе «Заказ на Маркете» . Допустимые значения:

  • 1 — товар доступен для заказа прямо на Маркете;

  • 0 — товар недоступен для заказа на Маркете (только на сайте магазина).

Если значение не указано, по умолчанию считается, что товар можно заказать на Маркете.

Внимание.

Элемент должен обязательно иметь значение 0, если:

  • товар запрещен к дистанционной торговле (ювелирные изделия, лекарственные средства);

  • цена товара ниже минимальной суммы заказа.

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

Необязательный элемент.

param

Все важные характеристики товара — цвет, размер, объем, материал, вес, возраст, пол, и т. д.

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

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

Для части категорий является обязательным элементом.

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

expiry

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

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

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

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

Необязательный элемент.

weight

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

Формат: положительное число с точностью 0.001, разделитель целой и дробной части — точка.

При указании более высокой точности значение автоматически округляется следующим способом:

  • если четвертый знак после разделителя меньше 5, то третий знак сохраняется, а все последующие обнуляются;

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

Необязательный элемент.

dimensions

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

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

При указании более высокой точности значение автоматически округляется следующим способом:

  • если четвертый знак после разделителя меньше 5, то третий знак сохраняется, а все последующие обнуляются;

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

Необязательный элемент.

downloadable

Продукт можно скачать. Если указано true, предложение показывается во всех регионах.

Необязательный элемент.

group_id
Внимание. Элемент используется только в формате YML и только в категориях Одежда, обувь и аксессуары, Мебель, Косметика, парфюмерия и уход, Детские товары, Аксессуары для портативной электроники.

Элемент объединяет всех предложения, которые являются вариациями одной модели и должен иметь одинаковое значение. Значение должно быть целым числом, максимум 9 разрядов.

Является атрибутом элемента offer.

Необязательный элемент.

rec

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

Идентификаторы рекомендованных товаров.

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

Необязательный элемент.