Общие правила формирования прайс-листа для Berito (формат BML)

Метод передачи данных

Общие требования к BML- файлу

Примеры и описание элементов

Заголовок документа (XML header)

Элемент каталога yml_catalog

Описание магазина и его товарных предложений <shop>

Список курсов валют магазина - элемент <currencies>

Список категорий магазина - элемент <categories>

Описания товарных предложений магазина - элемент <offers>

Обязательные и желательные элементы <offer>

URL страницы товара - элемент <URL>

Цена товара - элемент <price>

Идентификатор валюты товара - элемент <currencyId>

Идентификатор категории товара - элемент <categoryId>

Ссылки на картинки товара - элемент <picture>

Название товарного предложения - элемент <name>, <model>

Группа товаров/ вид товаров - элемент <typePrefix>

Бренд товара - элемент <vendor>

Код производителя - элемент <vendorCode>

Описание товара - элемент <description>

Описание характеристик товара - элемент <param>

Страна производитель - элемент <country_of_origin>

Указание скидки - элемент <oldprice>

Назад к Ответам на вопросы

Метод передачи данных

Чтобы осуществить передачу информации о товарах, настройте ее экспорт из вашей базы данных в BML (YML)-файл или используйте CMS со встроенными возможностями экспорта данных в формат BML (YML).

Разместите файл на сайте вашего магазина по URL, который указывается при регистрации, либо в личном сообщении модератору на сервисе после активации аккаунта.

К XML-файлу должен быть предоставлен доступ по протоколу HTTP.

Допускается сжатие файла в ZIP-архив или TAR.GZ архив. XML-файл, регулярно скачивается роботом и обновленные данные импортируются в базу Berito.

Формат BML полностью соответствует формату YML, за исключением того, что в BML  есть определенные обязательные параметры, которые не обязательны в формате YML.

Общие требования к BML- файлу

Стандарт BML не допускает использования в текстовых данных непечатаемых символов с ASCII-кодами в диапазоне значений от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки). Это требует обязательной замены некоторых символов на эквивалентные им символьные коды:

Символ в тексте

 Код для BML-файла

"

&quot;

&

&amp;

>

&gt;

<

&lt;

'

 &apos;

Примеры и описание элементов

Заголовок документа (XML header)

Это стандартный XML-заголовок со ссылкой на файл описания формата. Заголовок должен начинаться с первой строки, с нулевого символа, в котором должен содержится версия XML и кодировка.

Вторая строка заголовка XML-документа определяет ссылку на файл описания формата данных (XML DTD). Здесь достаточно указать только имя файла shops.dtd, путь указывать не нужно.

Пример:

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE yml_catalog SYSTEM "shops.dtd">

Элемент каталога yml_catalog

Формат BML в качестве корневого использует элемент <yml_catalog>.

<yml_catalog date="2014-03-05 15:54">

<shop>.....</shop>

</yml_catalog>

Все BML документы должны содержать только один корневой элемент.

Атрибут date это дата и время генерации BML-файла на стороне магазина. Дата должна иметь формат YYYY-MM-DD hh:mm.

Описание магазина и его товарных предложений <shop>

В элементе <shop> содержится описание магазина и товаров магазина.

<shop>

<name>Your-shop</name>

 <company>Your_shop_company</company>

 <url>http://your-shop.ru/</url>

 <currencies> ... </currencies>

 <categories> ... </categories>

 <offers> ... </offers>

</shop>

Магазин описывается следующими элементами, красным выделены обязательные для Berito:

Элемент

Описание

name

Короткое название магазина, не более 20 символов.

company

Полное наименование компании, владеющей магазином

url

URL главной страницы магазина

platform

Система управления контентом, на основе которой работает магазин (CMS)

version

Версия CMS

agency

Наименование агентства, которое оказывает техническую поддержку магазину и отвечает за работоспособность сайта

email

Контактный адрес разработчиков CMS или агентства, осуществляющего техподдержку.

Все данные переданные в этом тэге нигде не публикуются.

Список курсов валют магазина - элемент <currencies>

Элемент <currencies> задает список курсов валют магазина. Каждая из валют описывается отдельным элементом <currency>. Для каждой валюты в списке указывается курс к рублю.

На текущий момент все цены на Berito показываются в рублях, поэтому в качестве основной валюты (для которой установлено rate="1") может быть использован только рубль.

<currencies>

<currency id="RUR" rate="1"/>

</currencies>

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

Каждый элемент currency имеет следующие параметры:

id - идентификатор валюты (USD, EUR, ...)

rate - курс валюты к рублю

<currencies>

<currency id="USD" rate="30"/>

<currency id="EUR" rate="40"/>

</currencies>

Список категорий магазина - элемент <categories>

В элементе <categories> содержится список категорий магазина. Каждая категория описывается отдельным элементом <category>.

<categories>

<category id="1">Верхняя одежда</category>

<category id="2" parentId="1">Куртки</category>

<category id="3" parentId="1">Комбинезоны</category>

</categories>

Параметры:

Требования: Описание категории должно включать ее идентификатор (параметр id) для всех категорий и идентификатор категории более высокого уровня для подкатегорий.

Идентификатор категории должен быть уникальным положительным целым числом.

Если элемент <parentId> не указан, то категория считается корневой.

Описания товарных предложений магазина - элемент <offers>

В элементе <offers> содержится список товарных предложений магазинов. Каждое товарное предложение описывается отдельным элементом <offer>.

<offers>

<offer>...</offer>

...

</offers>

Пример простого описания offer с некоторыми базовыми элементами:

<offer id="1025787156" available="true">

<url>

http://your-shop.ru/id/1060500767</url>

<price>695.0</price>

<oldprice>1390.0</oldprice>

<currencyId>RUR</currencyId>

<categoryId>307179491</categoryId>

<picture>

http://your-shop.ru/spree/products/000/008/424/large/deux-par-deux-i94_s11_coll_64-8424.jpg

</picture>

<vendor>Deux par deux</vendor>

<vendorCode>I94_S11_coll_64</vendorCode>

<model>

Платье детское (для девочек)

</model>

<country_of_origin>Канада</country_of_origin>

<param name="Размер" unit="BRAND">92</param>

<param name="Цвет">Черный</param>

<param name="Пол">Женский</param>

<param name="Возраст">Детский</param>

<param name="Линейка">Sweet n-Rose</param>

<param name="Возраст от" unit="месяцев">18</param>

<param name="Возраст до" unit="месяцев">30</param>

<param name="Состав">100% полиэстер</param>

<param name="Коллекция">Sweet n-Rose</param>

<param name="Сезоны">Весна, Лето, Для дома</param>

</offer>

У элемента offer могут быть следующие атрибуты:

id - идентификатор товарного предложения. Атрибут может содержать только цифры и латинские буквы.
Максимальная длина id — 20 символов.
Идентификатор предложения должен быть уникальным и неизменным среди всех товарных предложений одного прайс-листа.
Если у двух и более товарных предложений указать одинаковые атрибуты id, то идентификатор будет присвоен только первому из этих предложений.
Если при последующих обновлениях файла магазина id уже размещенных товаров будут меняться или под id уже размещенных товаров будут представлены другие товары, то это приведет к автоматическому неверному размещению товаров в каталоге и последующей блокировке файла до его исправления магазином.

available - статус доступности товара

Обязательные и желательные элементы <offer>

Обязательные для всех категорий выделены красным. Некоторые элементы могут быть обязательными для товаров в определенных категориях.

Об этом указано в их описании и в требованиях к контенту категорий.

элемент

атрибут

название

<offer>  

id

идентификатор товарного предложения

available 

доступность к продаже

<price> 

цена

<oldprice>

 

старая цена (для указания скидки)

<url>

URL страницы товара

<categoryId>

идентификатор категории товара

<currencyId>

идентификатор валюты товара

<picture>

изображение

<name>

название товара

<typePrefix>

Вид товара в категории

<vendor> 

Производитель (бренд)

<vendorCode>

Код производителя

<description>

Описание товара

<param>

name=Размер

Размер товара

name=Цвет

Цвет товара

name=Пол

Для женщин или для мужчин

<country_of_origin>

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

 

URL страницы товара - элемент <URL>

Максимальная длина URL — 512 символов. Обязательный элемент.

<offer id="12346" available="true">

<url>your-shop.ru/product_page.asp?pid=12346</url>

<price>600</price>

...

</offer>

Цена товара - элемент <price>

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

<offer id="12346" available="true">

...

<price>600</price>

<currencyId>USD</currencyId>

...

</offer>

Идентификатор валюты товара - элемент <currencyId>

Идентификатор валюты товара (RUR, USD, EUR). Для корректного отображения цены. Обязательный элемент.

<offer id="12346" available="true">

...

<currencyId>USD</currencyId>

<categoryId>6</categoryId>

......

</offer>

Идентификатор категории товара - элемент <categoryId>

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

Элемент <offer> может содержать только один элемент <categoryId>. Обязательный элемент.

<offer id="12346" available="true">

...

<categoryId>6</categoryId>

<picture>http://best.seller.ru/img/device12345.jpg</picture>

...

</offer>

Ссылки на картинки товара - элемент <picture>

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

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

<offer id="12346" available="true">

...

<picture>http://shop-pop.ru/img/device12385.jpg</picture>

<picture>http://shop-pop.ru/img/device12386.jpg</picture>

...

</offer>

Требования к изображениям.

Изображение товара должно быть четким, в разрешении не менее 500х500 пикселей и не должно содержать водяных знаков (логотип или адрес сайта, нанесенный поверх изображения товара).

Некачественные изображения товаров на 20% снижают конверсию и, соответственно, количество заказов.

Название товарного предложения - элемент <name>, <model>

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

<offer id="12346" available="true">

<name>Платье детское (для девочек)</name>
<typePrefix>Платья</typePrefix>

...

</offer>

По такой же логике читается тэг <model>, использовать можно любой из них.

<offer id="12346" available="true">

<model>Платье детское (для девочек)</model>
<typePrefix>Платья</typePrefix>

...

</offer>

Группа товаров/ вид товаров - элемент <typePrefix>

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

<offer id="12346" available="true">

...

<typePrefix>Платье</typePrefix>

<vendor>Deux par deux</vendor>

...

</offer>

Бренд товара - элемент <vendor>

Производитель. Отображается в названии товара, участвует в фильтрации товаров. Обязательный элемент.

<offer id="12346" available="true">

...

<vendor>Deux par deux</vendor>

<vendorCode>I94_S11_coll_64</vendorCode>

...

</offer>

При указании бренда на английском (оригинальном) языке не следует писать его транслитом или добавлять в виде транслита к оригинальному названию

Код производителя - элемент <vendorCode>

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

<offer id="12346" available="true">

...

<vendorCode>I94_S11_coll_64</vendorCode>

<description>Изящное платье для маленьких принцесс. </description>

...

</offer>

Описание товара - элемент <description>

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

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

<offer id="12346" available="true">

...

<description>Изящное платье для маленьких принцесс.</description>

<param name="Пол">женские</param>

...

</offer>

Описание характеристик товара - элемент <param>

Каждый элемент <param> описывает одну характеристику. Элемент <offer> может содержать любое количество <param>.

Элемент <param> имеет атрибуты:

<offer id="12346" available="true">

...

<param name="Размер" unit="BRAND">92</param>

<param name="Цвет">Черный</param>

<param name="Пол">Женский</param>

<param name="Возраст">Детский</param>

<param name="Линейка">Sweet n-Rose</param>

<param name="Возраст от" unit="месяцев">18</param>

<param name="Возраст до" unit="месяцев">30</param>

<param name="Состав">100% полиэстер</param>

<param name="Коллекция">Sweet n-Rose</param>

<param name="Сезоны">Весна, Лето, Для дома</param>

...

</offer>

Страна производитель - элемент <country_of_origin>

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

<offer id="12346" available="true">

...

<country_of_origin>Россия</country_of_origin>

...

</offer>

Указание скидки - элемент <oldprice>

В этом элементе указывается стоимость товара до применения к нему скидки. В каталоге будет указана старая цена, новая цена и размер скидки. Кроме того, все предложения со скидками от 15% автоматически попадут в различные разделы Распродажи.

Размер скидки рассчитывается как разница между ценами указанными в тэгах <oldprice> и <price>.

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

 

<offer id="12346" available="true">

...

<price>9500</price>

<oldprice>14100</oldprice>

...

</offer>

Назад к Ответам на вопросы