Ркипер(r_keeper) - обмен статусами заказов, ver. 1.0.3

Рейтинг:
Работает на редакциях Битрикс:
Малый бизнесБизнес
В случае покупки "Ркипер(r_keeper) - обмен статусами заказов" у нас, мы предложим вам "Бесплатную базовую установку" на ваш сервер.
Помощь, техподдержка
Нужна помощь?
Поможем с настройкой "Ркипер(r_keeper) - обмен статусами заказов"

1. Описание решения

Ркипер(r_keeper) - обмен статусами заказов — модуль, который принимает от r_k Delivery уведомления (вебхуки) о смене статуса заказа и переносит этот статус в заказ интернет-магазина «1С-Битрикс». Покупатель видит в личном кабинете, на каком этапе его заказ: принят, готовится, курьер в пути, доставлен. Подходит для сайтов доставки еды и ресторанов, которые принимают заказы на сайте и обрабатывают их в rKeeper.

КАК РАБОТАЕТ

r_k Delivery при каждой смене статуса заказа отправляет вебхук на адрес модуля. Модуль проверяет, что запрос действительно пришёл от r_keeper, и находит заказ сайта по номеру заказа rKeeper. Номер берётся из таблицы связей модуля «Ркипер(r_keeper) - отправка заказов». Затем модуль ставит заказу соответствующий статус магазина. Если в rKeeper заказ отменили, на сайте он тоже отменяется. Каждое событие сохраняется в таблицу истории. Запросов к API rKeeper модуль не делает, агенты и cron не нужны: статус на сайте меняется сразу, как только приходит событие.

СОПОСТАВЛЕНИЕ СТАТУСОВ

— Готовый справочник статусов r_k Delivery: новый, подтверждён, передан на кухню, готовится, приготовлен, сборка, собран, у курьера, в пути, доставлен, отменён;
— Для каждого статуса rKeeper можно выбрать статус заказа магазина или оставить «не менять»;
— Отдельная настройка для неизвестных статусов, которых нет в справочнике;
— Кнопка быстрого создания статусов магазина RA–RG и RC («Заказ принят», «Готовится», «Курьер в пути», «Доставлен», «Отменён» и др.). Эти статусы уже выбраны в сопоставлении по умолчанию, так что модуль работает сразу после создания.

СТАТУС ЗАКАЗА В ЛИЧНОМ КАБИНЕТЕ

— В карточке заказа покупателя появляется виджет с прогресс-баром. Этапы: принят → подтверждён → готовится → собирается → в пути → доставлен;
— Для отменённых заказов показывается отдельное состояние «Отменён»;
— Статус можно обновить кнопкой «Обновить» или автоматически с заданным интервалом;
— Виджет показывается только владельцу заказа или администратору;
— Виджет встраивается в стандартную страницу заказа (компонент sale.personal.order.detail) без правки шаблона. Его можно отключить или подключить вручную.

БЕЗОПАСНОСТЬ

— Обязательная проверка токена: заголовок X-Token или Authorization: Bearer. Без верного токена статус заказа изменить нельзя;
— Необязательная проверка подписи X-Signature: фиксированное значение или HMAC тела запроса (sha256 / sha1 / md5);
— Белый список IP-адресов r_keeper;
— Можно принимать события только от одного ресторана (по GUID restaurantId), события от других точек отклоняются.

КОНТРОЛЬ

— История вебхуков в отдельной таблице: номер заказа rKeeper, номер заказа сайта, статус, дата;
— Журнал приёма и смены статусов. Он хранится в каталоге вне корня сайта и недоступен по HTTP;
— Отклонённые запросы попадают в журнал с указанием причины: неверный токен, подпись, IP или чужой ресторан.

НАСТРОЙКА

— Вебхук: готовый URL для шаблона r_k Delivery, токен, подпись, белый список IP, GUID ресторана;
— Статусы: сопоставление статусов rKeeper со статусами магазина, создание недостающих статусов;
— Личный кабинет: включение виджета, путь карточки заказа, интервал автообновления;
— Журнал: включение логирования.

ТРЕБОВАНИЯ

— Модуль «Интернет-магазин» (sale);
— Модуль «Ркипер(r_keeper) - отправка заказов» (goldencode.rkeeperorders): по его таблице связей заказы rKeeper сопоставляются с заказами сайта;
— Доступ к шаблонам уведомлений в r_k Delivery (канал «api»).

Выгрузку меню выполняет отдельное решение «Ркипер(r_keeper) - синхронизация меню».

Опубликовано 21.11.2026
Версия 1.0.3
Установлено Менее 50 раз
Адаптивность Нет
Поддержка Композита Нет
Подходящие редакции Малый бизнес, Бизнес
Для корректной работы сайта мы используем файлы куки.
Принять