Книги. Форматы YML, CSV

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

<offer id="12342" type="book" bid="80">
  <url>http://best.seller.ru/product_page.asp?pid=14345</url>
  <price>80</price>
  <oldprice>90</oldprice>
  <currencyId>RUR</currencyId>
  <categoryId>3</categoryId>
  <picture>http://best.seller.ru/product_page.asp?pid=14345.jpg</picture>
  <store>false</store>
  <pickup>false</pickup>
  <delivery>true</delivery>
  <delivery-options>
    <option cost="200" days="1"/>
  </delivery-options>
  <author>Александра Маринина</author>
  <name>Все не так. В 2 томах. Том 1</name>
  <publisher>Эксмо</publisher>
  <series>А. Маринина — королева детектива</series>
  <year>2007</year>
  <ISBN>978-5-699-23647-3</ISBN>
  <volume>2</volume>
  <part>1</part>
  <language>rus</language>
  <binding>70x90/32</binding>
  <page_extent>288</page_extent>
  <description>
    Все прекрасно в большом патриархальном семействе Руденко...
  </description>
  <downloadable>false</downloadable>
  <age unit="year">18</age>
</offer>

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

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

name

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

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

publisher

Издательство.

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

ISBN

International Standard Book Number — международный уникальный номер книжного издания. Если их несколько, укажите все через запятую.

Форматы ISBN и SBN проверяются на корректность. Валидация кодов происходит не только по длине, также проверяется контрольная цифра (check-digit) — последняя цифра кода должна согласовываться с остальными цифрами по определенной формуле. При разбиении ISBN на части при помощи дефиса (например, 978-5-94878-004-7) код проверяется на соответствие дополнительным требованиям к количеству цифр в каждой из частей.

Используйте номер ISBN, чтобы привязать ваше предложение к карточке товара. Подбронее см. в разделе Как попасть на карточку товара.

Обязателен для попадания на карточку книжного издания.

author

Автор произведения.

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

series

Серия.

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

year

Год издания.

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

volume

Общее количество томов, если издание состоит из нескольких томов.

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

part

Укажите номер тома, если издание состоит из нескольких томов.

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

language

Язык, на котором издано произведение.

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

table_of_contents

Оглавление.

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

type

Тип предложения. Для книг значение должно быть book.

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

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

binding

Формат.

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

page_extent

Количество страниц в книге, должно быть целым положительным числом.

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

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.

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

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

id

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

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

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

Обязательно

cbid

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

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

bid

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

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

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

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

url

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

Обязательно

price

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

  • Формат: целое или дробное число.

  • Разделитель целой и дробной части — точка.

  • Цена должна соответствовать стоимости товара, иначе магазин при проверке получит ошибку.

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

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

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

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

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

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

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

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

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

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

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

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

Обязательно

oldprice

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

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

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

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

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

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

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

currencyId

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

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

Обязательно

categoryId

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

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

Обязательно

category

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

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

Обязательно

picture

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

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

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

supplier

ОГРН или ОГРНИП стороннего продавца. ОГРН должен содержать 13 символов, ОГРНИП — 15.

Используется только с атрибутом ogrn.

Пример: <supplier ogrn="1012398745"/>

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

delivery

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

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

  • true — курьерская доставка есть;

  • false — курьерской доставки нет.

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

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

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

pickup

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

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

  • true — самовывоз есть;

  • false — самовывоза нет.

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

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

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

delivery-options

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

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

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

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

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

pickup-options

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

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

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

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

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

local_delivery_days

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

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

Примеры значений
  • Доставка в день заказа (сегодня) — значение 0.

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

  • Доставки от двух до четырех дней — значение 2–4.

    Внимание. При указании срока «от — до» разница между минимальным и максимальным значением должна быть не больше трех дней.

Максимальный срок, который показывает Маркет, — 31 день. Если указано значение 32 или больше, появится информация о доставке «до 60 дней» (или надпись «предзаказ», если в базе данных Маркета есть дата, когда товар официально начнет продаваться).

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

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

local_delivery_cost

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

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

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

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

local-pickup-days

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

Срок поставки товара в пункты выдачи в регионе магазина (в днях).

Примеры значений

Товар доступен для самовывоза:

  • в день заказа (сегодня) — значение 0;

  • на следующий день (завтра) — значение 1;

  • в срок от двух до четырех дней — значение 2–4.

    Внимание. При указании срока «от — до» разница между минимальным и максимальным значением должна быть не больше трех дней.

Максимальный срок, который показывает Маркет, — 31 день. Если указано значение 32 или больше, появится информация о доставке «до 60 дней» (или надпись «предзаказ», если в базе данных Маркета есть дата, когда товар официально начнет продаваться).

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

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

local-pickup-cost

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

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

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

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

store

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

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

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

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

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

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

description

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

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

В формате YML допустимо использовать некоторые xhtml-теги при условии, что они заключены в блок CDATA и соблюдены общие правила стандарта 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 — одна характеристика).

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

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

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

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

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

  • likenew — как новый (товар не был в употреблении, уценен из‑за недостатков);
  • used — подержанный (товар был в употреблении).

В элементе reason обязательно укажите причину уценки и подробно опишите недостатки. Длина текста не более 3000 символов (включая знаки препинания).

Пример:

<condition type="likenew">
  <reason>Повреждена упаковка</reason>
</condition>
Внимание. Информация о причинах уценки должна быть исчерпывающей. Тексты не должны быть уклончивыми. Например, нельзя писать: «Причины уценки узнавайте у консультанта».

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

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

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

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

  • likenew — как новый;

  • used — подержанный.

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

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

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

Причины уценки и подробное описание недостатков.

Информация о причинах уценки должна быть исчерпывающей. Тексты не должны быть уклончивыми. Например, нельзя писать: «Причины уценки узнавайте у консультанта».

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

Обязательно, если указан condition-type
credit-template
Внимание. Используется только в формате YML.

Идентификатор кредитной программы.

  • Если на товар действует отдельная кредитная программа, получите ее идентификатор в личном кабинете и укажите его в атрибуте id.
    Пример
    <credit-template id="20034"/>
  • Если на товар действует общая кредитная программа, не заполняйте элемент, и эта кредитная программа отобразится у товара по умолчанию.

Подробнее о покупке в кредит.

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

Идентификатор кредитной программы.

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

  • Если на товар действует общая кредитная программа, не заполняйте элемент, и эта кредитная программа отобразится у товара по умолчанию.
Подробнее о покупке в кредит.
Необязательно

expiry

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

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

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

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

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

weight

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

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

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

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

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

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

dimensions

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

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

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

downloadable

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

Обязательно, если товар можно приобрести только в электронном виде

available

С помощью элемента available со значением false можно задать для товара вместо конкретного срока доставки надпись «до 60 дней» (или «предзаказ», если в базе данных Маркета есть дата, когда товар официально начнет продаваться).

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

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

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