Ркипер(r_keeper) - обмен статусами заказов, ver. 1.0.3
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 раз |
| Адаптивность | Нет |
| Поддержка Композита | Нет |
| Подходящие редакции | Малый бизнес, Бизнес |
