R-keeper — подключение
Подключение R-keeper занимает три шага: указать код объекта, настроить маршрутизацию заказа и убедиться, что цены приходят из нужного прайс-листа.
🔑 Токен интеграции (
AggregatorAuthentication) хранится на сервере Нямбота и в браузер не передаётся — отдельно его вводить не нужно. От тебя нужен только код объекта и коды маршрутизации.
Перед началом: что должно быть готово в R-keeper#
- Касса r_keeper 7 работает, на объекте установлен и подключён WSAgent (обычно настраивает дилер r_keeper при установке кассы).
- Меню заведено в r_keeper, у блюд есть цены в прайс-листе категории доставки (см. шаг 3 — это частая причина «цена 0»).
- Под рукой менеджерская станция r_keeper (
rk7man) — оттуда берём коды категории, типа заказа и стола.
Шаг 1. Узнай код объекта (objectId)#
objectId — числовой идентификатор твоего ресторана в системе r_keeper.
- Войди в личный кабинет
l.ucs.ru. - Открой свой объект — в карточке/адресной строке будет числовой код объекта (например,
766660120).
Это тот же код, по которому r_keeper лицензирует твою кассу. Если не находишь — спроси у дилера r_keeper, который ставил кассу.
Шаг 2. Подключи R-keeper в СРМ#
- В СРМ открой раздел «Интеграции».
- На карточке R-keeper нажми «Подключить».
- Торговая точка — выбери ТТ, к которой подключаешь R-keeper.
- Код объекта r_keeper (objectId) — вставь число из шага 1 и нажми «Проверить соединение».
- После успешной проверки переходи к маршрутизации (шаг 3).
✅ «Проверить соединение» дёргает r_keeper и убеждается, что объект на связи и отвечает. Если проверка не проходит — чаще всего на объекте не запущен WSAgent или касса, либо не выданы лицензии WS. См. Частые проблемы.
Шаг 3. Настрой маршрутизацию заказа (и прайс-лист цен)#
В окне подключения найди секцию «Маршрутизация заказа (R-keeper)». Эти коды r_keeper нужны, чтобы заказ из Нямбота лёг в кассу на правильный тип сервиса — и чтобы пришли цены (об этом ниже).
| Поле | Что это | Где взять в r_keeper |
|---|---|---|
| Категория — доставка | orderCategoryCode для доставочного заказа | менеджерская → Order → Order Categories (например, «WSA: Доставка») |
| Тип — доставка | orderTypeCode, совместимый с категорией доставки | менеджерская → Order → Order Types (например, «Доставка курьером») |
| Категория — самовывоз | orderCategoryCode для самовывоза (если используешь) | там же, Order Categories |
| Тип — самовывоз | orderTypeCode для самовывоза | там же, Order Types |
| Код стола | стол виртуального зала WSA, куда падают заказы | менеджерская → Options → Tables and Plans → Hall Plans and Tables (зал «Виртуальный зал WSA») |
⚠️ Категория и тип должны быть совместимой парой — отдельно для доставки и отдельно для самовывоза. У каждой категории заказа в разделе «Order Types Usage» должен быть отмечен галкой её тип (у «WSA: Доставка» — «Доставка курьером», у «WSA: Самовывоз» — «Самовывоз»), а у самого типа стоять Right Level = Права WSA. Если галки нет или пара не совпадает — касса вернёт ошибку «Тип заказа не подходит категории», и заказ в кассу не уйдёт (клиент при этом увидит «Заказ принят»). Коды в полях маршрутизации — это поле Code категории/типа (не External Code). Пошагово — в Частых проблемах.
💰 Категория доставки определяет не только маршрут, но и ПРАЙС-ЛИСТ. В r_keeper цены живут в пресете кассы, привязанном к категории заказа. Нямбот запрашивает меню именно по категории доставки — поэтому цены витрины = цены в чеке. Если у блюда нет цены в прайс-листе этой категории, оно придёт с ценой 0 ₽ (см. ниже).
После заполнения нажми «Сохранить». Нямбот сразу подтянет меню.
Шаг 4. Проверь, что цены пришли#
Открой Меню в СРМ и посмотри на R-keeper-блюда:
- Цены проставлены (не
0 ₽) — отлично, всё настроено. - Везде
0 ₽— у блюд нет цены в прайс-листе категории доставки или не заполнена «Категория — доставка» в маршрутизации. Задай цены в нужном прайс-листе r_keeper и пересинхронизируй. → Частые проблемы: цена приходит нулём. - Часть блюд
0 ₽— у этих конкретных позиций не задана цена в прайс-листе категории доставки. Поправь их в r_keeper.
Что появится после подключения#
- Меню → блюда с бейджем «R-keeper» — импортированные категории, блюда, цены, вес, КБЖУ (read-only, управляются в r_keeper).
- Модификаторы из схем r_keeper — как они раскладываются по секциям мини-аппа, см. Модификаторы.
- Интеграции — в таблице подключений видно статус, метрики синка и кнопку «Синхронизировать сейчас».
🔁 Меню обновляется автоматически раз в сутки ночью. После правок в r_keeper жми «Синхронизировать» в списке подключений, чтобы обновить сразу.
🌳 Если у объекта несколько меню (в r_keeper это «Дерево меню» — несколько страниц селектора под разные концепции), Нямбот берёт витрину доставки. По умолчанию используется меню, назначенное селектором доставки в r_keeper. Если меню одно — ничего настраивать не нужно, оно подтянется само.
Коды представлений меню — когда они нужны#
Поле «Коды представлений меню» в окне подключения (секция «Меню») почти всегда остаётся пустым: тогда Нямбот берёт активное меню кассы, и это правильный вариант для одного заведения с одним прайсом.
Коды нужны, только если на кассе настроено несколько прайс-представлений — например «Доставка» и «Зал» с разными ценами на одни и те же блюда. Тогда впиши коды представлений (поле Code страницы селектора в менеджерской RK7), и каждое появится в Нямботе отдельной витриной — гость выберет нужную в мини-приложении.
⚠️ Это не то же самое, что несколько меню в мини-приложении: те собираются из категорий автоматически и к настройкам кассы отношения не имеют.
🖊️ Меню R-keeper доступно только для чтения — название, цена, состав меняются в r_keeper. Что можно в Нямботе: задать своё фото блюду (см. ниже) и собрать дополнения к заказу. → Дополнения.
Фото блюд: два способа#
Картинку блюда можно взять из r_keeper или загрузить в Нямботе — выбирай, как удобнее.
- Через r_keeper. Если у тебя уже есть хранилище с картинками и ссылки на них, укажи ссылку в настройках блюда в r_keeper — расширенное свойство «Фото для доставки» (
PhotoForDelivery). Картинку хостишь у себя (публичный URL), r_keeper только передаёт ссылку. Фото приедет в Нямбот на ближайшей синхронизации меню (кнопка «Синхронизировать» или ночью). - Через СРМ Нямбота. Загрузи фото прямо в карточке блюда в СРМ — оно сразу показывается в витрине мини-приложения, поверх того, что пришло из r_keeper. Своё хранилище не нужно.
💡 Если фото в r_keeper пустое, а в СРМ Нямбота загружено — в витрине показывается фото из Нямбота. Так проще всего: не надо ничего настраивать в r_keeper.
Заказы, пробитые на самой кассе#
В Нямботе живут заказы, пришедшие через него: мини-приложение, бот, сайт. Заказ, который официант пробил в зале, — внутреннее дело кассы: он остаётся в r_keeper и в её отчётах, Нямбот его не забирает и не показывает.
На интеграцию это не влияет: заказы из Нямбота уходят в кассу, статусы возвращаются, меню и стоп-лист синхронизируются как обычно. Просто выручка в Нямботе — это выручка онлайн-канала, а полная выручка заведения смотрится в отчётах r_keeper.
Дальше#
- Разные размеры блюд (пиццы, роллы) → Размеры блюд.
- Модификаторы (основа, добавки, «можно убрать») → Модификаторы.
- Кросс-сейл соусов/напитков → Дополнения.
- Что-то не так → Частые проблемы.
🏪 У тебя больше одного объекта? Как добавлять объекты и почему меню и скидки на точках расходятся — в разделе Сеть из нескольких объектов.
Как отключить r_keeper от точки#
Интеграции → строка точки → корзина. Нямбот покажет список того, что удалит, и попросит подтвердить.
Удаляется всё, что приехало из кассы для этой точки:
- меню (представления), группы и блюда с их размерами;
- модификаторы и ингредиенты кассы;
- комбо и их категории;
- загруженные фото этих позиций (файлы удаляются с сервера);
- цены, наличие и скидки этой точки.
Остаётся: история заказов и вся аналитика по ней. Позиции в старых заказах хранятся снимком — названием, ценой и фото на момент заказа, — поэтому отчёты не «поедут».
После отключения точка возвращается на собственное меню Нямбота: меню, стоп-листы, доставка и лояльность снова управляются в СРМ.
⚠️ Отключение — не пауза: импортированное меню удаляется, и вернуть его можно только повторным подключением и синхронизацией.