Музыкальная и видеопродукция. Форматы YML, CSV

Примеры

Пример видеопродукции для формата YML
<offer id="12344" type="artist.title" available="true" bid="80">
  <url>http://best.seller.ru/product_page.asp?pid=92347</url>
  <price>93</price>
  <oldprice>100</oldprice>
  <currencyId>RUR</currencyId>
  <categoryId>2</categoryId>
  <picture>http://best.seller.ru/img/device92347.jpg</picture>
  <store>false</store>
  <pickup>false</pickup>
  <delivery>true</delivery>
  <title>Свадьба Мюриэл</title>
  <year>1999</year>
  <media>DVD</media>
  <starring>Тони Колетт (Toni Collette), Рэйчел Грифитс (Rachel Griffiths)</starring>
  <director>П Дж Хоген</director>
  <originalName>Muriel's wedding</originalName>
  <country>Австралия</country>
  <description>
    Гадкий утенок из провинциального городка покидает свое гнездо, и в компании своей подруги отправляется искать веселой жизни в большой и загадочный город...
  </description>
  <age unit="year">18</age>
  <barcode>3456789012345</barcode>
</offer>
Пример музыкальной продукции для формата YML
<offer id="12345" type="artist.title" available="true" bid="80">
  <url>http://best.seller.ru/product_page.asp?pid=12946</url>
  <price>450</price>
  <oldprice>500</oldprice>
  <currencyId>USD</currencyId>
  <categoryId>2</categoryId>
  <picture>http://best.seller.ru/product_page.asp?pid=14345.jpg</picture>
  <store>false</store>
  <pickup>false</pickup>
  <delivery>true</delivery>
  <artist>Pink Floyd</artist>
  <title>Dark Side Of The Moon, Platinum Disc</title>
  <year>1999</year>
  <media>CD</media>
  <description>
    Dark Side Of The Moon, поставивший мир на уши невиданным сочетанием звуков, — это всего-навсего девять треков, и даже не все они писались специально для альбома...
  </description>
  <age unit="year">18</age>    
  <barcode>2345678901234</barcode>
</offer>

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

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

type

Тип предложения. Для музыкальной и видеопродукции значение должно быть artist.title.

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

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

artist

Исполнитель.

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

title

Название.

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

year

Год выпуска.

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

media

Носитель.

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

starring

Актеры.

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

director

Режиссер.

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

originalName

Оригинальное название.

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

country

Страна исполнителя.

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

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

id

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

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

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

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

cbid

Внимание. Элемент устарел. Используйте вместо него элемент bid.

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

bid

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

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

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

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

available

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

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

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

false — «на заказ»

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

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

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

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

url

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

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

price

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

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

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

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

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

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

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

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

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

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

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

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

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

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

oldprice

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

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

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

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

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

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

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

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

vat

Ставка НДС для товара. Используется, только если вы включили загрузку ставок из прайс-листа.

Допустимые значения и подробное описание элемента.

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

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.

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

Примечание. Стоимость доставки можно указать в файле или настроить в личном кабинете.

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

pickup

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

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

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

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

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

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

store

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

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

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

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

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

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

description

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

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

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

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

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

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

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

sales_notes

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

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

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

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

manufacturer_warranty

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

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

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

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

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

country_of_origin

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

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

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

adult

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

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

barcode

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

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

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

param

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

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

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

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

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

expiry

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

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

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

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

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

weight

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

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

Скачать список минимальных и максимальных значений веса.

В любой категории вес можно указывать с точностью до тысячных (например, 1.001 кг; разделитель целой и дробной части — точка).

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

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

dimensions

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

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

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

downloadable

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

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

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.

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