Комментарии к описанию элемента <offer> в формате YML

Комментарии к описанию элемента <offer> в формате YML

Мы используем только два типа описаний товаров:
Для книгопечатной продукции – “book”, примеры:
<offer id="137322" type="book" available="true">…</offer> – книга есть в наличии, <offer id="86963" type="book" available="false">…</offer> – книги нет в наличии.
Для товаров других типов – простое описание, примеры:
<offer id="87231" available="true">…</offer> – товар есть в наличии, <offer id="87230" available="false">…</offer> – товара нет в наличии.
В элементе <offer> используются следующие тэги:

Тэг	Описание	Тип описания товара, в котором используется тэг	Обязательный (для указанного типа товара)
url	URL-адрес страницы товара	любой	ДА
price	цена, по которой данный товар можно приобрести	любой	ДА (для товаров, на которые не принимаются заказы, всегда значение «0»)
currencyId	идентификатор валюты товара – всегда «RUR»	любой	ДА
categoryId	идентификатор категории товара	любой	ДА
picture	ссылка на картинку соответствующего товарного предложения	любой	нет
author	автор произведения, составитель или редактор	book	нет
name	наименование товарного предложения	любой	ДА
publisher	издательство	book	ДА
series	серия	book	нет
year	год издания	book	нет
ISBN	один или несколько кодов ISBN через запятую	book	нет
volume	количество томов	book	ДА
vendor	производитель	простое описание	ДА
description	описание товарного предложения	любой	нет
sales_notes	дополнительная информация об условиях продажи, напр., строка вида «Цена действительна при покупке всех частей издания»	любой	нет

Наши расширения в формате MyYML

В тэге «description» элемента <offer> приводится полное описание товара без обрезания по 255 символу. В элементе <offer> используются следующие дополнительные тэги:

Тэг	Описание	Тип описания товара, в котором используется тэг	Обязательный (для указанного типа товара)
availabilityCode	код доступности товара: 0 – нет в наличии, заказы не принимаются (не должен встречаться) 1 – нет в наличии, но принимаются «предварительные» заказы 2 – есть в наличии 3 – есть в наличии и может быть отгружен очень быстро (в течение нескольких часов)	любой	ДА
rating	торговый рейтинг в относительных единицах – ноль или целое положительное число (чем больше число, тем выше рейтинг)	любой	ДА
topCategoryId	идентификатор категории высшего уровня (служебное поле)	любой	ДА
cover	тип обложки: «?», «мягкая обложка», «твердый переплет», «мягкая обложка + суперобложка», «твердый переплет + суперобложка», «картон», «интегральный переплет»	book	ДА (может быть значение «?»)
pages	количество страниц (если количество страниц неизвестно, указывается «0»); «pages» в YML называется «page_extent», но в YML «page_extent» появился позже нашего «pages», поэтому мы сохранили наше название этого поля	book	нет
new	количество дней (от 0 до 90), прошедших после добавления товара в нашу базу данных	любой	нет
sale	признак того, что товар в распродаже, пример: "скидка 15% на 2 шт."	любой	нет
md5	служебное поле, по значению которого парсер XML может проверить, изменилось ли описание товара Важно: если в описании товара изменились только характеристики «rating» и «new», значение «md5» не изменится.	любой	ДА