Что умеет решение
Модуль обеспечивает интеграцию интернет-магазина на платформе «1С-Битрикс» с системой r_keeper через UCS Delivery API. Решение полностью автоматизирует процесс заказа еды и напитков: меню из r_keeper синхронизируется с каталогом сайта, заказы формируются на сайте и передаются в r_keeper, а статусы приготовления и доставки отображаются в личном кабинете покупателя.
Выгрузка меню в торговый каталог
Категории и блюда автоматически переносятся из r_keeper в инфоблок каталога по заданному расписанию (настраиваемый агент) или по кнопке «Синхронизировать сейчас». Цены записываются в выбранный тип цен каталога и при необходимости дублируются в свойствах инфоблока. Заполняются характеристики: вес, единица измерения, пищевая ценность (калорийность, энергетическая ценность, белки, жиры, углеводы), а также загружаются дополнительные изображения. Картинки блюд можно загружать только для новых товаров или при каждой синхронизации по выбору администратора.
Модификаторы блюд, такие как добавки и ингредиенты, выгружаются как торговые предложения. Справочник модификаторов создается модулем автоматически и хранится в отдельном Highload-блоке. Система позволяет исключать определенные категории и блюда по их GUID из r_keeper, а также автоматически деактивирует товары, которые были удалены из меню r_keeper.
На странице настроек отображаются статус и статистика последней выгрузки: количество добавленных, обновленных и деактивированных позиций, а также текст ошибки при сбое.
Заказы с сайта автоматически создаются в системе r_keeper. В передаваемые данные включаются состав заказа, модификаторы, контактные сведения покупателя, адрес и детали доставки, способ оплаты и количество персон.
Предусмотрено два режима передачи заказа:
1. При оформлении: заказ сначала создается в r_keeper. Если ресторан отказывает в приеме, процесс оформления на сайте блокируется, а клиенту показывается понятное сообщение о причине отказа.
2. После оплаты: заказ сохраняется на сайте и передается в r_keeper только после успешной оплаты. В случае ошибки передачи заказ помечается, а покупатель и администратор получают уведомление.
Отмена заказа в r_keeper синхронизируется с отменой заказа в магазине, включая действия из административной панели. Поддерживается справочник причин отмены.
Перед сохранением заказа выполняется проверка зоны доставки по указанному адресу.
Интегрирована служба доставки «Доставка rKeeper Omni (UCS)». Стоимость и время доставки рассчитываются через UCS API на основе адреса и состава заказа и отображаются покупателю до нажатия кнопки «Оформить заказ».
На странице оформления заказа реализовано окно ввода адреса с подсказками, использующее геокодирование UCS.
Функция доставки по точному времени позволяет покупателю выбрать конкретную дату и час получения заказа. В систему r_keeper заказ передаётся с указанием запланированного времени, а не с пометкой о срочности.
В корзине всегда отображается точное название блюда, а не название модификатора или торгового предложения.
Система автоматически направляет уведомления администраторам в случае сбоев при отправке заказа или его отмене.
Модуль принимает входящие вебхуки от r_keeper Delivery для отслеживания изменений статуса заказа.
Безопасность передачи данных обеспечивается обязательным токеном X-Token, опциональной подписью X-Signature, фильтрацией по IP-адресам и привязкой к конкретному ресторану.
Соответствие статусов r_keeper статусам заказа в магазине настраивается через административную панель. При необходимости недостающие статусы создаются одной кнопкой.
Ведётся полный журнал всех входящих событий вебхука. Это гарантирует сохранность статуса даже в случае получения уведомления раньше, чем заказ установит соединение с r_keeper.
В личном кабинете покупателя отображается виджет статуса с прогресс-баром. Этапы включают: принятие заказа, подтверждение, приготовление, сборка и готовность к выдаче, движение курьера и доставка. Виджет поддерживает автоматическое обновление и ручную кнопку обновления.
Секретные ключи и токены API передаются исключительно по защищённому протоколу HTTPS на доверенные хосты UCS Delivery.
Эндпоинт с подсказками адресов защищён от перегрузки тремя уровнями ограничений частоты запросов: для каждого IP-адреса, для каждой сессии и общим для всего сайта.
Журнал работы модуля размещается за пределами корневой директории сайта и недоступен по протоколу HTTP; по умолчанию ведение журнала отключено.
Виджет отображения статуса показывает информацию о заказе исключительно его владельцу.
Доступ к настройкам модуля имеют только администраторы.
Для работы требуется система «1С-Битрикс: Управление сайтом» с установленными модулями «Информационные блоки», «Торговый каталог», «Highload-блоки» и «Интернет-магазин».
Требуется версия PHP 8.2 или новее.
Для подключения к API UCS Delivery необходимы параметры: client_id, client_secret и GUID ресторана (restaurantId), получаемые из системы r_keeper.
Для синхронизации статусов предусмотрена возможность настройки шаблона вебхука в сервисе r_keeper Delivery.
Модуль предназначен для ресторанов, кафе, пекарен и служб доставки готовой еды, использующих кассовую систему r_keeper и платформу «1С-Битрикс» для витрины и оформления заказов.
General iT может подключить «Ркипер (r_keeper) - меню, заказы, статусы», настроить его и проверить корректность интеграции с текущим сайтом.