Маркет для магазинов

Упрощенный тип описания товарного предложения (форматы YML, CSV, XLS)

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

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

Примеры для разных форматов

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

Вы можете скачать пример полностью заполненного прайс-листа в формате YML. Далее представлен пример составления предложения (offer):

<offer id="12346" available="true" bid="80">
  <url>http://best.seller.ru/product_page.asp?pid=12348</url>
  <price>600</price>
  <oldprice>800</oldprice>
  <currencyId>USD</currencyId>
  <categoryId>6</categoryId>
  <picture>http://best.seller.ru/img/device12345.jpg</picture>
  <store>false</store>
  <pickup>true</pickup>
  <delivery>false</delivery>
  <delivery-options>
    <option cost="200" days="1"/>
  </delivery-options>
  <outlets>
    <outlet id="2" instock="50"/>
  </outlets>
  <name>Наручные часы Casio A1234567B</name>
  <vendor>Casio</vendor>
  <vendorCode>A1234567B</vendorCode>
  <description>Изящные наручные часы.</description>
  <sales_notes>Необходима предоплата.</sales_notes>
  <manufacturer_warranty>true</manufacturer_warranty>
  <country_of_origin>Япония</country_of_origin>
  <age unit="year">18</age>
  <barcode>0123456789012</barcode>
  <cpa>1</cpa>  
</offer>
Примеры для формата CSV:

Скачать пример упрощенного типа описания

Примеры для формата XLS:

Скачать пример упрощенного типа описания

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

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

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

name

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

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

model

Модель.

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

vendor

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

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

vendorCode

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

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

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

id

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

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

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

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

cbid

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

Размер ставки для карточки модели.

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

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

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

bid

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

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

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

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

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

fee

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

Размер комиссии на товарное предложение, участвующее в программе «Заказ на Маркете».

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

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

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

url

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

Обязательный элемент для интернет-магазинов.

price

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

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

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

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

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

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

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

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

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

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

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

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

oldprice

Старая цена на товар, которая обязательно должна быть выше новой цены (price). Параметр oldprice необходим для автоматического расчета скидки на товар.

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

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

currencyId

Идентификатор валюты товара (RUR, USD, UAH, KZT, BYN). Для корректного отображения цены в национальной валюте необходимо использовать идентификатор с соответствующим значением цены (например, UAH с ценой в гривнах).

Примечание. BYN — новые белорусские рубли. Один новый белорусский рубль равен 10 000 старых (1 BYN = 10 000 BYR).

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

categoryId

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

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

market_category

Категория товара, в которой он должен быть размещен на Яндекс.Маркете. Допустимо указывать названия категорий только из товарного дерева категорий Яндекс.Маркета.

Скачать дерево категорий Яндекс.Маркета.

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

picture

Ссылка на картинку соответствующего товарного предложения. Недопустимо давать ссылку на логотип магазина или «заглушку» — страницу, где написано «картинка отсутствует». Максимальная длина URL — 512 символов.

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

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

delivery

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

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

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

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

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

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

delivery-options

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

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

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

Обязательный элемент, если элемент delivery имеет значение true.

local_delivery_days

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

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

Доставка в день заказа (сегодня) — значение 0,  доставка на следующий день (завтра) — значение 1 и т. д. Также можно указать период «от — до» дней, например: 2–4.

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

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

Обязательный элемент, если элемент delivery имеет значение true.

local_delivery_cost

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

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

Примечание. Ранее local_delivery_cost использовался в формате YML. В настоящее время элемент является устаревшим для этого формата. Использование элемента в YML пока поддерживается Маркетом, однако рекомендуется перейти на элемент delivery-options.

Обязательный элемент, если элемент delivery имеет значение true.

pickup

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

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

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

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

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

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

available

В форматах XLS, CSV:
Срок поставки в пункт выдачи: 0–2 дня или «на заказ».
В формате YML:
  • Если используется элемент local_delivery_cost, available передает срок курьерской доставки и срок поставки в пункт выдачи: 0–2 дня или «на заказ».

  • Если используется элемент delivery-options, available передает только срок поставки в пункт выдачи (0–2 дня или «на заказ»).

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

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

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 символов. .

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

manufacturer_warranty

Элемент предназначен для отметки товаров, имеющих официальную гарантию производителя.

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

1) false — товар не имеет официальной гарантии;

2) true — товар имеет официальную гарантию.

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

country_of_origin

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

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

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

adult

Элемент обязателен для обозначения товара, имеющего отношение к удовлетворению сексуальных потребностей, либо иным образом эксплуатирующего интерес к сексу.

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

age

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

В форматах XLS, 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

Штрихкод товара, указанный производителем. В формате YML элемент offer может содержать несколько элементов barcode.

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

cpa

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

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

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

param

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

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

В формате YML элемент offer может содержать несколько элементов 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.

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

Оцените статью
Спасибо за ваш отзыв!