Нямбот
НЯМБОТРуководство
О продуктеОткрыть СРМ

Сеть из нескольких объектов

Главное отличие от iiko: у R-keeper свои креды и свои коды маршрутизации на каждый ресторан. Одного ключа на сеть здесь не существует, поэтому объекты добавляются по одному.

Коротко: как заказ находит нужную кассу#

Гость в мини-приложении выбирает торговую точку — про коды объектов он не знает ничего. Заказ уходит на кассу того объекта, чьи креды и коды маршрутизации ты ввёл в форме этой точки.

Связка задаётся один раз, при подключении объекта, и больше нигде не спрашивается. Креды здесь защищены жёстче, чем у iiko: свои логин и пароль WS у каждой точки, и Нямбот никогда не подставляет чужие сам — нет своих, подключение просто не работает, а не отправляет заказ наугад.

А вот коды маршрутизации так не защищены. Категория, тип заказа и стол — обычные числа: валидные коды соседнего ресторана Нямбот от нужных не отличит, и заказ либо встанет не на ту кассу, либо не напечатается — молча, без ошибки.

Поэтому пробный заказ на каждый объект обязателен — см. раздел ниже.

Что запросить у франчайзи или своего IT#

На каждый объект отдельно:

  • креды WS API v2 (логин и пароль объекта RK7);
  • код категории и код типа заказа — отдельно для доставки и отдельно для самовывоза;
  • код стола;
  • GUID заведения, если подключаешь облачную доставку r_k Delivery.

Коды нельзя «взять как у соседнего объекта»: у каждого ресторана своя база RK7, и чужие коды означают заказ, который встал не на ту кассу или не напечатался — молча, без ошибки.

Как добавляются объекты#

«Интеграции» → карточка R-keeper → «Подключить R-keeper», и так по одному объекту на каждую точку.

Мастер «один ключ → все точки» для R-keeper не подходит: он рассчитан на сценарий, где один ключ отдаёт список организаций. Здесь такого списка нет.

r_k Delivery — исключение#

Облачный модуль доставки работает как iiko: одно API-подключение (Client ID и Secret) покрывает несколько заведений. Эти креды живут на уровне кабинета, а заведение у каждой точки своё — Нямбот определяет его по кнопке «Определить» прямо в форме.

⚠️ Представление меню у одного подключения Delivery одно. Если у точек разные меню, понадобится несколько подключений.

Почему меню и скидки на точках расходятся#

  • Прайс-листы разные. У каждого объекта свой прайс-лист, поэтому цена одного и того же блюда на точках отличается. Нямбот хранит отличия по точкам и показывает гостю цену его точки.
  • Скидки справочника задаются на объект. Скидка, заведённая в одном ресторане, на другом не появится — и Нямбот её туда не перенесёт.
  • Стоп-лист всегда локальный — его ведёт касса конкретного объекта.

Обязательный шаг — пробный заказ#

Коды маршрутизации можно ввести валидные, но не те: ни схема, ни RK7 отличить это не могут. Единственная проверка — пробный заказ на каждый объект после подключения. Пока он не прошёл, объект не считается готовым к работе.

Что дальше#