Что умеет решение
Модуль «Ркипер (r_keeper) — обмен статусами заказов» обеспечивает автоматическую синхронизацию статусов между системой r_k Delivery и интернет-магазином на платформе 1С-Битрикс. При изменении статуса заказа в r_k Delivery система отправляет вебхук, который модуль перехватывает, верифицирует источник и обновляет статус заказа в личном кабинете покупателя. Клиент видит актуальную информацию о ходе выполнения: принят, готовится, курьер в пути или доставлен. Решение оптимизировано для сайтов доставки еды и ресторанов, принимающих заказы онлайн и обрабатывающих их в rKeeper.
Принцип работы основан на событийной модели: при каждом изменении статуса r_k Delivery инициирует запрос к модулю. Система проверяет подлинность запроса, находит соответствующий заказ в магазине по номеру из таблицы связей «Ркипер (r_keeper) — отправка заказов» и присваивает ему новый статус. В случае отмены заказа в rKeeper статус автоматически меняется на «Отменён» и на сайте. Все события фиксируются в таблице истории. Модуль не использует запросы к API rKeeper, не требует настройки агентов или cron-задач; обновление происходит мгновенно в момент получения уведомления.
Встроенный справочник поддерживает следующие статусы r_k Delivery: новый, подтверждён, передан на кухню, готовится, приготовлен, сборка, собран, у курьера, в пути, доставлен, отменён.
Модуль обеспечивает обмен статусами заказов между системой rKeeper и магазином. Для каждого статуса rKeeper можно сопоставить соответствующий статус заказа магазина или выбрать опцию «не менять». Отдельно настраивается поведение для неизвестных статусов, отсутствующих в справочнике.
Встроенная кнопка быстрого создания позволяет сформировать стандартные статусы магазина RA–RG и RC, такие как «Заказ принят», «Готовится», «Курьер в пути», «Доставлен» и «Отменён». Эти статусы уже включены в сопоставление по умолчанию, что обеспечивает работу модуля сразу после создания.
СТАТУС ЗАКАЗА В ЛИЧНОМ КАБИНЕТЕ
В карточке заказа покупателя отображается виджет с прогресс-баром, показывающий этапы: принят, подтверждён, готовится, собирается, в пути, доставлен. Для отменённых заказов отображается отдельное состояние «Отменён». Статус обновляется вручную кнопкой «Обновить» или автоматически с заданным интервалом. Виджет доступен только владельцу заказа или администратору. Компонент sale.personal.order.detail интегрируется в стандартную страницу заказа без изменения шаблона. Подключение или отключение виджета выполняется вручную.
БЕЗОПАСНОСТЬ
Обязательна проверка токена через заголовок X-Token или Authorization: Bearer. Изменение статуса заказа невозможно без корректного токена.
Модуль обеспечивает безопасный обмен статусами заказов между системой r_keeper и сайтом. Проверка подписи 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), который обеспечивает сопоставление заказов через таблицу связей. Необходим также доступ к шаблонам уведомлений в системе r_k Delivery через канал «api».
Модуль «Ркипер (r_keeper) — обмен статусами заказов» отвечает исключительно за передачу статусов заказов. Выгрузка меню осуществляется отдельным решением «Ркипер (r_keeper) — синхронизация меню».
General iT может установить «Ркипер(r_keeper) - обмен статусами заказов», настроить параметры модуля и проверить его работу в существующем проекте.