Что умеет решение
Модуль синхронизации меню Ркипер (r_keeper) обеспечивает периодическую выгрузку данных из системы rKeeper через UCS Delivery API в торговый каталог платформы 1С-Битрикс: Управление сайтом. Решение предназначено для сайтов доставки еды и ресторанов, использующих rKeeper для управления ассортиментом, и позволяет автоматически поддерживать актуальность блюд, цен и остатков без ручного ввода.
Работа модуля построена на использовании агента Битрикса с настраиваемым интервалом опроса. Система запрашивает актуальное меню через UCS Delivery API и синхронизирует его с инфоблоком каталога: создаёт отсутствующие разделы и товары, обновляет существующие. Идентификация элементов осуществляется по GUID из rKeeper (XML_ID), что исключает создание дубликатов при повторных запусках. Выгрузку можно инициировать вручную через кнопку в настройках. Модуль корректно функционирует как при использовании встроенных хитов, так и при переносе агентов в системный планировщик cron, не требуя дополнительных настроек на сервере.
В каталог выгружаются следующие данные:
— Категории меню, которые формируют вложенную структуру разделов инфоблока;
— Блюда, создаваемые как товары каталога с переносом названия, описания и цены;
— Изображения блюд: файлы скачиваются на сервер, кэшируются и не загружаются повторно, пока не произойдут изменения в исходных данных.
Модуль «Ркипер» обеспечивает синхронизацию меню из системы r_keeper в информационную систему. В настраиваемые свойства инфоблока передаются данные о пищевой ценности (калорийность, энергетическая ценность, белки, жиры, углеводы), а также вес и единица измерения. Если блюдо находится в стоп-листе r_keeper, его остаток устанавливается в ноль; после снятия из стоп-листа остаток автоматически восстанавливается. Модификаторы (ингредиенты) выгружаются только при активации соответствующей опции.
Справочник модификаторов хранится в Highload-блоке. Сами модификаторы выгружаются как торговые предложения в отдельный инфоблок и связываются с блюдами через механизм CML2_LINK. Цена предложения формируется как сумма цены основного блюда и цены выбранного модификатора. Создание Highload-блока, свойства-справочника и связей между инфоблоками происходит автоматически, при этом существующая настройка связи торгового каталога не нарушается.
Модуль предоставляет гибкие настройки контроля данных. Цена записывается в выбранный тип цен и может дублироваться в свойство инфоблока по желанию. Категории и отдельные блюда можно исключить из выгрузки, указав их GUID. Активирована опция деактивации товаров, исчезнувших из меню: позиции, отсутствующие в r_keeper, автоматически снимаются с публикации. Символьные коды генерируются методом транслитерации с обязательным контролем уникальности. Реализована защита от параллельного запуска: фоновый агент и ручная синхронизация не конфликтуют друг с другом.
На странице настроек отображается журнал операций с ротацией, а также статистика последней выгрузки с разбивкой по статусам: добавлено, обновлено или деактивировано.
Настройка подключения включает ввод параметров client_id, client_secret и ID ресторана, которые выдаются системой UCS. При необходимости адреса API можно переопределить. В разделе каталога выбираются инфоблок, тип цен, валюта и коды свойств в соответствии с вашим шаблоном. Параметры синхронизации позволяют задать интервал работы агента, включить ведение журнала и выполнить ручной запуск.
Для работы модуля необходимы установленные компоненты: «Информационные блоки» (iblock), «Торговый каталог» (catalog) и «Highload-блоки» (highloadblock). Также требуется учётная запись UCS Delivery API с правами доступа к меню ресторана.
Передача заказов в систему rKeeper осуществляется отдельным решением «rKeeper: заказы». Модули функционируют независимо друг от друга.
Внедрение «Ркипер(r_keeper) - синхронизация меню» можно поручить General iT — от установки до настройки и проверки совместимости с сайтом.