Технические данные
- Опубликовано:
- 21.11.2026
- Версия:
- 1.0.0
- Установлено:
- Менее 50 раз
- Подходящие редакции:
- «Малый бизнес», «Бизнес»
- Адаптивность:
- Нет
- Поддержка Композита:
- Нет
- Совместимо с Сайты24
- Нет
Пользовательское соглашение
Описание
Интеграция интернет-магазина на «1С-Битрикс» с r_keeper через UCS Delivery API. Один модуль закрывает весь цикл заказа еды и напитков: меню из r_keeper попадает в каталог сайта, заказ с сайта попадает в r_keeper, а статус приготовления и доставки возвращается покупателю в личный кабинет.
Что умеет модуль1. Выгрузка меню в торговый каталог
- Автоматическая выгрузка категорий и блюд из r_keeper в инфоблок торгового каталога по расписанию (агент с настраиваемой периодичностью) и по кнопке «Синхронизировать сейчас».
- Цена пишется в выбранный тип цен каталога; при необходимости дублируется в свойство инфоблока.
- Заполнение свойств: вес, единица измерения, пищевая ценность (калорийность, энергетическая ценность, белки, жиры, углеводы), дополнительные изображения.
- Загрузка картинок блюд (только для новых товаров или при каждой синхронизации — на ваш выбор).
- Модификаторы блюд (добавки, ингредиенты) выгружаются торговыми предложениями; справочник модификаторов хранится в отдельном Highload-блоке, который модуль создаёт сам.
- Исключение отдельных категорий и блюд по GUID из r_keeper.
- Деактивация товаров, которые исчезли из меню r_keeper.
- Статус и статистика последней выгрузки (сколько добавлено, обновлено, деактивировано) и текст ошибки — на странице настроек.
- Заказ с сайта автоматически создаётся в r_keeper: состав, модификаторы, контакты покупателя, адрес и данные доставки, способ оплаты, количество персон.
- Два режима отправки на выбор:
- при оформлении — заказ сначала создаётся в r_keeper; если ресторан отказал, оформление на сайте блокируется и покупатель видит понятную причину;
- после оплаты — заказ сохраняется на сайте и уходит в r_keeper после оплаты; при ошибке передачи заказ помечается, покупатель и администратор получают уведомление.
- при оформлении — заказ сначала создаётся в 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 отправляются только на доверенные хосты UCS Delivery по HTTPS.
- Эндпоинт подсказок адреса защищён от злоупотреблений тремя лимитами частоты запросов: на IP, на сессию и общий на сайт.
- Журнал модуля хранится вне корня сайта и недоступен по HTTP; по умолчанию журнал выключен.
- Виджет статуса показывает заказ только его владельцу.
- Доступ к настройкам — только администраторам.
- «1С-Битрикс: Управление сайтом» с установленными модулями «Информационные блоки», «Торговый каталог», «Highload-блоки» и «Интернет-магазин».
- PHP 8.2 или выше.
- Подключение к UCS Delivery API: client_id, client_secret и GUID ресторана (restaurantId) из r_keeper.
- Для статусов — возможность настроить шаблон вебхука в r_keeper Delivery.
Для ресторанов, кафе, пекарен и служб доставки готовой еды, у которых кассовая система — r_keeper, а витрина и оформление заказов — на «1С-Битрикс».
На сайте («1С-Битрикс»):
- установленные модули: «Информационные блоки» (iblock), «Торговый каталог» (catalog), «Highload-блоки» (highloadblock), «Интернет-магазин» (sale);
- PHP 8.2 или выше;
- инфоблок торгового каталога, в который будет выгружаться меню (и, если нужны модификаторы, отдельный инфоблок торговых предложений);
- хотя бы один тип плательщика и настроенное оформление заказа (компонент sale.order.ajax).
Со стороны r_keeper / UCS Delivery:
- client_id и client_secret для доступа к UCS Delivery API;
- GUID ресторана (restaurantId);
- доступ к настройке шаблонов вебхуков в r_keeper Delivery (раздел «Шаблоны», канал «api»).
- Установите решение из Маркетплейса или скопируйте каталог модуля в /bitrix/modules/ либо /local/modules/.
- Откройте «Настройки → Настройки продукта → Модули» (/bitrix/admin/partner_modules.php).
- Найдите «Ркипер (r_keeper) - меню, заказы, статусы» и нажмите «Установить».
- Если не хватает обязательных модулей, установщик покажет их список — установите их и повторите.
- На втором шаге мастера нажмите «Установить модуль».
При установке автоматически:
- создаются таблицы связей «заказ сайта ↔ заказ r_keeper» и журнала событий вебхука;
- создаётся Highload-блок «Модификаторы (rKeeper)»;
- для всех типов плательщиков создаются свойства заказа «Дата доставки ко времени» (DELIVERY_DATE) и «Время доставки» (DELIVERY_TIME);
- регистрируются обработчики событий магазина и агент выгрузки меню;
- создаётся служба доставки «Доставка rKeeper Omni (UCS)».
После установки нажмите «Перейти к настройкам модуля». Страница настроек всегда доступна по пути: «Настройки → Настройки продукта → Настройки модулей → Ркипер (r_keeper) - меню, заказы, статусы». Настройки доступны только администраторам.
Если на сайте раньше работали отдельные модули для r_keeper, не включайте их одновременно с этим решением: заказ будет отправляться в r_keeper дважды.
3. НастройкаВсе параметры собраны на одной странице, на вкладках. После изменений нажмите «Сохранить».
Вкладка «API» — подключение к r_keeperПараметрЧто указатьclient_id / client_secretДанные доступа к UCS Delivery APIID ресторана (restaurantId)GUID ресторана из r_keeperURL авторизации, URL APIПо умолчанию https://auth-delivery.ucs.ru и https://delivery.ucs.ru. Другие адреса не принимаются: данные отправляются только на доверенные хосты UCS по HTTPSЛимиты запросов окна адресаЗапросов в минуту на IP, на сессию покупателя и на весь сайт. Значения по умолчанию (30 / 30 / 600) подходят для большинства магазиновВкладка «Каталог» — куда выгружать меню
- Выберите инфоблок каталога — в него попадут категории и блюда.
- Выберите тип цены и валюту.
- Укажите коды свойств инфоблока для веса, единицы измерения, пищевой ценности и дополнительных фото. Если свойства нет — оставьте поле пустым или создайте свойство с указанным кодом.
- Настройте поведение:
- «Обновлять изображения при каждой синхронизации» — по умолчанию картинки скачиваются только для новых товаров и товаров без картинки;
- «Деактивировать товары, исчезнувшие из меню» — скрывать с сайта блюда, которых больше нет в r_keeper;
- «Исключённые GUID категорий / товаров» — то, что не нужно выгружать на сайт.
- «Обновлять изображения при каждой синхронизации» — по умолчанию картинки скачиваются только для новых товаров и товаров без картинки;
- Укажите периодичность выгрузки в минутах (по умолчанию 60). Агент создаётся автоматически и пересоздаётся при смене интервала.
- Кнопка «Синхронизировать сейчас» сохраняет настройки и сразу запускает выгрузку. Ниже показаны результат и ошибка последнего запуска.
- Для стабильной работы агентов рекомендуется перенести их выполнение на cron (стандартная рекомендация «1С-Битрикс»).
- Отправлять заказы в r_keeper — главный выключатель.
- Стадия отправки: «при оформлении» (сначала создаётся заказ в r_keeper, при отказе оформление блокируется) или «после оплаты».
- Проверять зону доставки перед сохранением заказа.
- Отменять заказ в r_keeper при отмене в магазине. Если в r_keeper включены причины отмены, укажите GUID и текст причины.
- E-mail для уведомлений об ошибках — адреса через запятую.
- ID служб доставки «самовывоз» — остальные службы считаются доставкой.
- ID платёжных систем «наличные», «карта», «онлайн» — для передачи способа оплаты в r_keeper (ID смотрите в «Магазин → Настройки → Платёжные системы»).
- Количество персон по умолчанию.
- Коды свойств заказа — сопоставьте имя, телефон, e-mail, город (LOCATION), адрес, квартиру, этаж, подъезд, домофон с кодами свойств ваших типов плательщиков.
- Доставка ко времени: коды свойств даты и времени (по умолчанию DELIVERY_DATE и DELIVERY_TIME), флажок «Скрыть свойства» (поля заполняет окно адреса, покупатель их не видит) и кнопка «Создать свойства „Доставка ко времени“» — если появился новый тип плательщика.
Подключение службы доставки. В «Магазин → Настройки → Службы доставки» убедитесь, что служба «Доставка rKeeper Omni (UCS)» активна, и при необходимости задайте ограничения (сайты, группы пользователей, регионы). Именно она показывает покупателю стоимость и время доставки до оформления заказа.
Вкладка «Вебхук» — приём статусов из r_keeper- Скопируйте URL вебхука со страницы настроек.
- Придумайте и укажите токен вебхука (X-Token) — длинную случайную строку. Без токена статусы не принимаются.
- При необходимости заполните подпись (X-Signature), белый список IP r_keeper и GUID ресторана (тогда вебхуки других ресторанов будут отклоняться).
- В r_keeper Delivery откройте «Шаблоны», создайте новый шаблон с каналом «api», укажите URL вебхука и в заголовках — X-Token с тем же значением. Условия отправки — смена статуса заказа.
- Сохраните настройки. Токен в шаблоне r_keeper и в модуле должен совпадать.
- Нажмите «Создать статусы rKeeper в магазине» — модуль создаст статусы заказа RA–RG (принят, подтверждён оператором, готовится, собирается / готов к выдаче, курьер в пути, доставлен, отменён).
- Проверьте сопоставление «статус r_keeper → статус заказа в магазине». По умолчанию уже выбраны созданные статусы; любой статус можно оставить «не менять».
- Для неизвестных статусов r_keeper можно задать отдельный статус магазина или не менять статус.
- Показывать виджет — включить или выключить.
- Путь карточки заказа — виджет выводится на страницах, адрес которых содержит эту подстроку (по умолчанию /personal/orders/; сверьте с адресом карточки заказа на вашем сайте — например, /personal/order/detail/ — и при необходимости исправьте).
- Автообновление, секунд — период обновления статуса; 0 — только по кнопке «Обновить».
Включите «Вести журнал» на время запуска и отладки. Файлы пишутся в каталог goldencode.rkeeperomni-log рядом с корнем сайта (вне доступа по HTTP); если создать такой каталог нельзя, журнал не ведётся. Путь можно переопределить константой GOLDENCODE_RKEEPEROMNI_LOG_DIR в bitrix/php_interface/dbconn.php. В журнале есть персональные данные покупателей — не оставляйте его включённым без необходимости.
4. Проверка после настройки- Меню. Нажмите «Синхронизировать сейчас» на вкладке «Синхронизация меню» — статус должен стать «Завершена успешно», в каталоге появятся категории и блюда.
- Заказ. Оформите тестовый заказ на сайте: он должен появиться в r_keeper, а в базе — связь с заказом r_keeper. При стадии «при оформлении» ошибка ресторана заблокирует оформление и покажет причину.
- Статусы. Смените статус тестового заказа в r_keeper — статус заказа в магазине изменится согласно сопоставлению, а в карточке заказа в личном кабинете обновится прогресс-бар.
- Отмена. Отмените тестовый заказ в админке магазина — он будет отменён и в r_keeper.
6. Удаление
«Настройки → Настройки продукта → Модули» → выбрать решение → «Удалить». Отметка «Сохранить настройки модуля, таблицу связей заказов с rKeeper и журнал событий вебхука» сохраняет данные для повторной установки; без неё таблицы и настройки будут удалены.
Модуль не удаляет: товары каталога, созданные выгрузкой; Highload-блок «Модификаторы»; свойства заказа DELIVERY_DATE и DELIVERY_TIME; статусы заказа RA–RG — при необходимости уберите их вручную. Служба доставки «Доставка rKeeper Omni (UCS)» деактивируется, но не удаляется, чтобы не потерять ссылки в существующих заказах.