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>
Товар добавлен в корзину
i
Для минимального заказа нужно ещё заказать на i