Каталог решений

Покупка продления купона

Общая сумма:
0 руб.
Продолжить покупки

Ркипер (r_keeper) - меню, заказы, статусы

Интеграция интернет-магазина на «1С-Битрикс» с r_keeper через UCS Delivery API. Один модуль закрывает весь цикл заказа еды и напитков: меню из r_keeper попадает в каталог сайта, заказ с сайта попадает в r_keeper, а статус приготовления и доставки возвращается покупателю в личный кабинет.Что умеет модуль1. Выгрузка меню в торговый каталогАвтоматическая выгрузка категорий и блюд из r_keeper в инфоблок торгового каталога по расписанию (агент с настраиваемой периодичностью) и по кнопке «Синхронизировать сейчас».Цена пишется в выбранный тип цен каталога; при необходимости дублируется в свойство инфоблока.Заполнение свойств: вес, единица измерения, пищевая ценность (калорийность, энергетическая ценность, белки, жиры, углеводы), дополнительные изображения.Загрузка картинок блюд (только для новых товаров или при каждой синхронизации — на ваш выбор).Модификаторы блюд (добавки, ингредиенты) выгружаются торговыми предложениями; справочник модификаторов хранится в отдельном Highload-блоке, который модуль создаёт сам.Исключение отдельных категорий и блюд по GUID из r_keeper.Деактивация товаров, которые исчезли из меню r_keeper.Статус и статистика последней выгрузки (сколько добавлено, обновлено, деактивировано) и текст ошибки — на странице настроек.2. Отправка заказов в r_keeperЗаказ с сайта автоматически создаётся в r_keeper: состав, модификаторы, контакты покупателя, адрес и данные доставки, способ оплаты, количество персон.Два режима отправки на выбор:при оформлении — заказ сначала создаётся в r_keeper; если ресторан отказал, оформление на сайте блокируется и покупатель видит понятную причину;после оплаты — заказ сохраняется на сайте и уходит в r_keeper после оплаты; при ошибке передачи заказ помечается, покупатель и администратор получают уведомление.Отмена заказа в r_keeper при отмене заказа в магазине (в том числе из админки) с поддержкой справочника причин отмены.Проверка зоны доставки по адресу до сохранения заказа.Собственная служба доставки «Доставка rKeeper Omni (UCS)»: стоимость и время доставки рассчитываются через UCS API по адресу и составу заказа и показываются покупателю до нажатия «Оформить заказ».Окно ввода адреса с подсказками (геокодинг UCS) прямо на странице оформления заказа.Доставка «ко времени»: покупатель выбирает дату и время, заказ уходит в r_keeper с ожидаемым временем вместо «как можно скорее».Название позиции в корзине всегда совпадает с названием блюда, а не торгового предложения-модификатора.Письма администраторам о неудачной отправке или отмене заказа.3. Обмен статусами заказовПриём вебхуков 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С-Битрикс».

Ркипер (r_keeper) - меню, заказы, статусы

Ркипер (r_keeper) - меню, заказы, статусы

Купить: 13 000 руб.
Купить продление
Скриншоты
Описание

Технические данные

Опубликовано:
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.
  • Статус и статистика последней выгрузки (сколько добавлено, обновлено, деактивировано) и текст ошибки — на странице настроек.
2. Отправка заказов в r_keeper
  • Заказ с сайта автоматически создаётся в r_keeper: состав, модификаторы, контакты покупателя, адрес и данные доставки, способ оплаты, количество персон.
  • Два режима отправки на выбор:
    • при оформлении — заказ сначала создаётся в r_keeper; если ресторан отказал, оформление на сайте блокируется и покупатель видит понятную причину;
    • после оплаты — заказ сохраняется на сайте и уходит в r_keeper после оплаты; при ошибке передачи заказ помечается, покупатель и администратор получают уведомление.
  • Отмена заказа в r_keeper при отмене заказа в магазине (в том числе из админки) с поддержкой справочника причин отмены.
  • Проверка зоны доставки по адресу до сохранения заказа.
  • Собственная служба доставки «Доставка rKeeper Omni (UCS)»: стоимость и время доставки рассчитываются через UCS API по адресу и составу заказа и показываются покупателю до нажатия «Оформить заказ».
  • Окно ввода адреса с подсказками (геокодинг UCS) прямо на странице оформления заказа.
  • Доставка «ко времени»: покупатель выбирает дату и время, заказ уходит в r_keeper с ожидаемым временем вместо «как можно скорее».
  • Название позиции в корзине всегда совпадает с названием блюда, а не торгового предложения-модификатора.
  • Письма администраторам о неудачной отправке или отмене заказа.
3. Обмен статусами заказов
  • Приём вебхуков 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С-Битрикс».

Отзывы (0)
Обсуждения (0)
Здесь пока никто ничего не написал. Будьте первым.
Установка
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»).
2. Установка
  1. Установите решение из Маркетплейса или скопируйте каталог модуля в /bitrix/modules/ либо /local/modules/.
  2. Откройте «Настройки → Настройки продукта → Модули» (/bitrix/admin/partner_modules.php).
  3. Найдите «Ркипер (r_keeper) - меню, заказы, статусы» и нажмите «Установить».
  4. Если не хватает обязательных модулей, установщик покажет их список — установите их и повторите.
  5. На втором шаге мастера нажмите «Установить модуль».

При установке автоматически:

  • создаются таблицы связей «заказ сайта ↔ заказ 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) подходят для большинства магазинов
Вкладка «Каталог» — куда выгружать меню
  1. Выберите инфоблок каталога — в него попадут категории и блюда.
  2. Выберите тип цены и валюту.
  3. Укажите коды свойств инфоблока для веса, единицы измерения, пищевой ценности и дополнительных фото. Если свойства нет — оставьте поле пустым или создайте свойство с указанным кодом.
  4. Настройте поведение:
    • «Обновлять изображения при каждой синхронизации» — по умолчанию картинки скачиваются только для новых товаров и товаров без картинки;
    • «Деактивировать товары, исчезнувшие из меню» — скрывать с сайта блюда, которых больше нет в r_keeper;
    • «Исключённые GUID категорий / товаров» — то, что не нужно выгружать на сайт.
  • Модификаторы (по желанию): отметьте «Выгружать модификаторы», выберите инфоблок торговых предложений и, при необходимости, укажите код свойства «группа модификатора». Модуль сам подключит этот инфоблок как торговые предложения, создаст в нём свойства CML2_LINK (привязка к блюду) и MODIFICATORS (справочник модификаторов) и свяжет его с каталогом, если связь ещё не задана. Уже существующая связь каталога с другим инфоблоком предложений не изменяется.Вкладка «Синхронизация меню»
    • Укажите периодичность выгрузки в минутах (по умолчанию 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
    1. Скопируйте URL вебхука со страницы настроек.
    2. Придумайте и укажите токен вебхука (X-Token) — длинную случайную строку. Без токена статусы не принимаются.
    3. При необходимости заполните подпись (X-Signature), белый список IP r_keeper и GUID ресторана (тогда вебхуки других ресторанов будут отклоняться).
    4. В r_keeper Delivery откройте «Шаблоны», создайте новый шаблон с каналом «api», укажите URL вебхука и в заголовках — X-Token с тем же значением. Условия отправки — смена статуса заказа.
    5. Сохраните настройки. Токен в шаблоне r_keeper и в модуле должен совпадать.
    Вкладка «Статусы»
    1. Нажмите «Создать статусы rKeeper в магазине» — модуль создаст статусы заказа RA–RG (принят, подтверждён оператором, готовится, собирается / готов к выдаче, курьер в пути, доставлен, отменён).
    2. Проверьте сопоставление «статус r_keeper → статус заказа в магазине». По умолчанию уже выбраны созданные статусы; любой статус можно оставить «не менять».
    3. Для неизвестных статусов r_keeper можно задать отдельный статус магазина или не менять статус.
    Вкладка «Личный кабинет» — виджет статуса
    • Показывать виджет — включить или выключить.
    • Путь карточки заказа — виджет выводится на страницах, адрес которых содержит эту подстроку (по умолчанию /personal/orders/; сверьте с адресом карточки заказа на вашем сайте — например, /personal/order/detail/ — и при необходимости исправьте).
    • Автообновление, секунд — период обновления статуса; 0 — только по кнопке «Обновить».
    Вкладка «Журнал»

    Включите «Вести журнал» на время запуска и отладки. Файлы пишутся в каталог goldencode.rkeeperomni-log рядом с корнем сайта (вне доступа по HTTP); если создать такой каталог нельзя, журнал не ведётся. Путь можно переопределить константой GOLDENCODE_RKEEPEROMNI_LOG_DIR в bitrix/php_interface/dbconn.php. В журнале есть персональные данные покупателей — не оставляйте его включённым без необходимости.

    4. Проверка после настройки
    1. Меню. Нажмите «Синхронизировать сейчас» на вкладке «Синхронизация меню» — статус должен стать «Завершена успешно», в каталоге появятся категории и блюда.
    2. Заказ. Оформите тестовый заказ на сайте: он должен появиться в r_keeper, а в базе — связь с заказом r_keeper. При стадии «при оформлении» ошибка ресторана заблокирует оформление и покажет причину.
    3. Статусы. Смените статус тестового заказа в r_keeper — статус заказа в магазине изменится согласно сопоставлению, а в карточке заказа в личном кабинете обновится прогресс-бар.
    4. Отмена. Отмените тестовый заказ в админке магазина — он будет отменён и в r_keeper.
    5. Если что-то не работаетСимптомЧто проверитьНе получается токен / ошибка подключенияclient_id, client_secret, URL авторизации и API; доступность хостов UCS с сервераМеню не выгружаетсяВыбран ли инфоблок каталога, указан ли restaurantId, ошибка на вкладке «Синхронизация меню», журналНет модификаторовВключена ли опция «Выгружать модификаторы», выбран ли инфоблок предложений, нет ли в журнале предупреждений о связи каталога с другим инфоблоком предложенийЗаказ не уходит в r_keeperВключён ли «Отправлять заказы», стадия отправки, соответствие кодов свойств заказа, журнал, e-mail уведомленийНет стоимости доставкиАктивна ли служба «Доставка rKeeper Omni (UCS)» и подходит ли она под ограничения службыСтатусы не меняютсяСовпадает ли токен в r_keeper и в модуле, открыт ли URL вебхука с сервера r_keeper, не мешает ли белый список IP, заполнено ли сопоставление; события вебхука видны в журналеВиджета нет в личном кабинетеВключён ли виджет и совпадает ли «Путь карточки заказа» с адресом страницы; виджет виден только владельцу заказа
    6. Удаление

    «Настройки → Настройки продукта → Модули» → выбрать решение → «Удалить». Отметка «Сохранить настройки модуля, таблицу связей заказов с rKeeper и журнал событий вебхука» сохраняет данные для повторной установки; без неё таблицы и настройки будут удалены.

    Модуль не удаляет: товары каталога, созданные выгрузкой; Highload-блок «Модификаторы»; свойства заказа DELIVERY_DATE и DELIVERY_TIME; статусы заказа RA–RG — при необходимости уберите их вручную. Служба доставки «Доставка rKeeper Omni (UCS)» деактивируется, но не удаляется, чтобы не потерять ссылки в существующих заказах.

  • Поддержка
    Техническая поддержка осуществляется в мессенджере на сайте zolotoykod.ru 8/7 с 9 до 18 МСК.

    Другие решения разработчика

    Решение добавлено в корзину

    Перейдите в корзину и оформите заказ или продолжите покупки
    Перейти в корзину
    Продолжить покупки