Skip to content

Подключение r_keeper ​

Через подключение к r_keeper в панель приходят меню и закрытые чеки из кассы. Если на кассе настроен модуль бонусов, кассир списывает и начисляет бонусы гостю при оплате, по коду из бота.

Revisitr получает данные r_keeper через облачный сервис UCS White Server. Доступ к нему выдаёт ваш дилер UCS, поэтому без дилера не обойтись.

Перед началом ​

Попросите у дилера UCS два значения:

  • Object ID — числовой код вашего заведения в лицензионной системе UCS;
  • WS Token — токен доступа к White Server.

Шаги ​

  1. Добавьте интеграцию

    Интеграции → Добавить → r-keeper.

  2. Введите Object ID и WS Token

    Поле API URL оставьте пустым, если дилер не сказал иначе. Нажмите Создать. Панель сразу проверит связь с кассой и напишет результат.

  3. Запустите первую синхронизацию

    Откройте интеграцию и на вкладке Обзор нажмите Синхронизировать. После первой удачной загрузки интеграция становится активной и дальше обновляется сама, раз в 4 часа.

Что приходит из r_keeper ​

  • Меню. Появится в разделе меню под именем «Меню из r_keeper». Его можно переименовать и дополнить фото и описаниями. Блюда, которые убрали из кассы, не удаляются, а помечаются «не найдено в кассе». Модификаторы блюд пока не загружаются. Подробнее — Меню.
  • Чеки. Закрытые чеки, в первый раз за последние 30 дней. Чек привязывается к гостю бота по номеру телефона, если он есть в чеке.

Меню обновляется раз в сутки

UCS обновляет меню в White Server один раз в день, в 12:00 по Москве. Если вы поменяли меню в кассе утром, в панели оно появится после обеда, при ближайшей синхронизации.

Бонусы на кассе ​

Списание и начисление бонусов на кассе r_keeper работает через модуль FarCards. Для него нужны:

  • r_keeper версии 7.6.0 или новее;
  • лицензия «Farcards-HTTP» на заведение, её оформляет дилер UCS;
  • настройка модуля на кассовом сервере, её делает дилер.

Подключаем такую кассу индивидуально, вместе с вашим дилером. Напишите нам: Помощь → Связаться. Мы пришлём дилеру всё, что нужно для настройки, а вас попросим создать ключ для кассы: вкладка Настройки интеграции → блок Ключи плагина → Создать ключ. Ключ показывается один раз, скопируйте его сразу.

Как это выглядит для гостя: в боте он нажимает «💳 Лояльность» и называет кассиру код. Кассир вводит его в кассе, видит баланс, списывает бонусы, после оплаты начисляется кешбэк. Правила начисления задаются в программе лояльности.

Частые ситуации ​

«Связь с кассой установить не удалось» ​

Проверьте Object ID и WS Token на вкладке Настройки интеграции и нажмите Проверить связь на вкладке Обзор. Токен после сохранения не показывается; чтобы заменить, впишите новый, пустое поле оставит прежний. Если не помогло, уточните значения у дилера.

Во вкладке «Клиенты» пусто ​

r_keeper не передаёт базу гостей. Во вкладке появляются только гости бота, к которым привязались чеки по номеру телефона.

Уйдёт ли заказ гостя из бота на кассу ​

Нет. Заказы из бота приходят персоналу в Telegram, в r_keeper они не создаются. Подробнее — Куда приходят заказы и брони.

Нужно ли открывать порты или ставить что-то в заведении ​

Для меню и чеков нет: Revisitr сам обращается к White Server. Для бонусов на кассе дилер настраивает модуль FarCards, он связывается с Revisitr по защищённому соединению.