Интеграция партнеров

Mambo24 принимает файлы, созданные в соответствии с форматом Yandex YML Прайс лист для Mambo24 должен соответствовать общим требованиям формирования прайс листа. Для размещения товаров на Mambo24 необходимо соблюдать требования к контенту. Без выполнения указанных требований, товары данных категорий не будут выгружены на Mambo24

Пример xml файла партнеров с едой - https://mambo24.ru/uploads/example_restaurants.xml

Пример xml файла партнеров с товарами - https://mambo24.ru/uploads/example_products.xml

Пример xml файла партнеров с купонами - https://mambo24.ru/uploads/example_coupons.xml

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

Чтобы осуществить передачу информации о товарах, настройте ее экспорт из вашей базы данных в YML-файл или используйте CMS со встроенными возможностями экспорта данных в формат YML. Разместите файл на сайте вашего магазина по URL, который указывается при регистрации, либо отдельным письмом в Службу поддержки. К YML-файлу должен быть предоставлен доступ по протоколу HTTP или HTTPS. Доступ может быть закрыт apache авторизацией по имени пользователя и паролю. XML-файл, регулярно скачивается роботом и обновленные данные импортируются в базу Mambo24.

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

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

Символ в тексте	Код для YML-файла
"	"
&	&
>	>
<	<
'	'

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

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

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

Элемент yml_catalog

<yml_catalog date="2016-01-01 17:07">
<shop>
...
</shop>
</yml_catalog>

Любой XML документ может содержать только один корневой элемент. Формат YML в качестве корневого использует элемент yml_catalog. Атрибут date элемента yml_catalog должен соответствовать дате и времени генерации XMLфайла на стороне магазина. Дата должна иметь формат YYYYMMDD HH:mm.

Элемент shop

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

<shop>
<name>Shop-pop</name>
<company>Shop_pop_chock</company>
<url>http://shop-pop-top/</url>
<currencies> ... </currencies>
<categories> ... </categories>
<offers> ... </offers>
</shop>

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

Элемент	Описание
name	Короткое название магазина, не более 20 символов.
company	Полное наименование компании, владеющей магазином.
url	URL главной страницы магазина

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

Элемент <currencies> задает список курсов валют магазина. Каждая из валют описывается отдельным элементом <currency>. Для каждой валюты в списке указывается курс к рублю. На текущий момент все цены на Mambo24 показываются в рублях, поэтому в качестве основной валюты (для которой установлено rate="1") может быть использован только рубль

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

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

<currencies>
<currency id=”USD” rate=”30”/>
<currency id=”EUR” rate=”40”/>
</currencies>

Элемент categories

Параметры:

id — идентификатор Вашей категории товаров

parentId — идентификатор предыдущей по иерархии категории товаров

<categories>
<category id="1">Книги</category>
<category id="2">Видео</category>
<category id="3" parentId="1">Детективы</category>
<category id="4" parentId="1">Боевики</category>
<category id="5" parentId="2">Комедии</category>
<category id="6">Принтеры</category>
<category id="7">Оргтехника</category>
</categories>

В элементе categories содержится список категорий магазина. Каждая категория описывается отдельным элементом category. Описание категории должно включать ее идентификатор (параметр id) для всех категорий и идентификатор категории более высокого уровня для подкатегорий. Идентификатор категории должен быть уникальным положительным целым числом. Ни у одной категории параметр id не может быть равен "0". Если элемент parentId не указан, то категория считается корневой.

Элемент offers

<offers>
<offer>...</offer>
...
</offers>