Доставка r_keeper
У доставки две модели, и переключает их один тумблер в СРМ Нямбота: Интеграции → подключение R-keeper → «Доставка». Выбирай ту, что ближе к тому, как у тебя устроена работа.
Две модели: кто ведёт доставку#
Доставку ведёт Нямбот (по умолчанию)#
Заказ из мини-приложения падает напрямую в кассу RK7. Логистика — в приложении «Команда»: там назначаешь курьера (своего или Яндекс.Доставку), там же двигаются статусы. Клиент видит их в боте.
Ничего дополнительно подключать не нужно — это работает сразу после подключения R-keeper.
Доставку ведёт r_k Delivery#
Нямбот отправляет заказ в r_k Delivery по API, а она сама кладёт его в кассу и ведёт курьера. Статусы возвращаются в Нямбот, клиент видит их в боте как обычно.
⚠️ На такой точке приложение «Команда» доставку не ведёт: кнопок назначения курьера и перевода в «В пути»/«Доставлен» там не будет. Яндекс.Доставка из Нямбота тоже не вызывается. Курьеры, зоны и статусы — всё в твоём кабинете r_k Delivery.
Что нужно, чтобы включить r_k Delivery#
1. Лицензии r_keeper на объекте#
Базовый набор доставки: Delivery_Base, Delivery_Filial, «Интерфейс к r_keeper Delivery», «XML-интерфейс для WSA».
⚠️ Плюс обязательно
Delivery_Api— отдельный модуль, в базовый набор не входит. Без него подключение по API не создать, и Нямбот не сможет отправлять заказы в Delivery. Запроси её у r_keeper вместе с остальными.
2. Подключение по API в кабинете Delivery#
Кабинет r_k Delivery → Интеграции → «Подключение по API» → «Добавить».
- ⚠️ При создании обязательно выбери Меню (представление меню) — иначе подключение не создастся. Меню может быть пустым, наполнять его не нужно.
- Скопируй выданные Client ID и Client Secret — они понадобятся в следующем шаге.
3. Синхронизация меню с кассой#
Карточка заведения → вкладка «Синхронизация меню» → включи «По категории заказа» и укажи код категории доставки (тот же, что стоит в СРМ Нямбота в блоке «Маршрутизация заказа», обычно 2).
Это нужно, чтобы цены в Delivery совпадали с прейскурантом кассы. Если не совпадут — касса отклонит заказ с ошибкой о расхождении цены.
Витрину в Delivery вести не надо: Нямбот отправляет блюда по их кодам из кассы.
4. Валюта онлайн-оплаты (иначе аванс сядет не туда)#
Тут два места, и в обоих выбираем валюту «Оплата через WS»:
- Админпанель White Server → «Параметры создания заказа» → «Дополнительные параметры» → «Валюта заказов» → «Оплата через WS». Это то, чем касса зачтёт предоплату.
- Кабинет Delivery → «Интеграции → ваш источник заказа → Параметры заказа» → в полях «Валюта онлайн оплаты» и «Валюта онлайн оплаты для самовывоза» тоже выбери «Оплата через WS». Именно GUID этой валюты (без фигурных скобок) пойдёт в СРМ Нямбота на шаге 5.
Это настройка каждой точки отдельно. Если оставить «Рубли», онлайн-предоплата будет попадать на кассу как рублёвая оплата, хотя деньги уже собраны в интернете.
5. Данные в СРМ Нямбота#
Модалка R-keeper → тумблер «Доставка» переключи на r_keeper → появится блок «Доставка r_k Delivery»:
| Поле | Где взять |
|---|---|
| Client ID | Кабинет Delivery → Интеграции → Подключение по API |
| Client Secret | Там же (вводится один раз, потом хранится зашифрованным) |
| GUID валюты предоплаты | Кабинет Delivery → «Валюта онлайн оплаты» (валюта «Оплата через WS», GUID без фигурных скобок) |
Заведение вводить не нужно. Нямбот сам определит его по Client ID/Secret при сохранении (в поле «Заведение» подставится автоматически). Если Client ID/Secret неверны — сохранение не пройдёт с понятной ошибкой.
Без Client ID и Client Secret тумблер «Доставка» не сохранится на r_keeper — Нямботу иначе некуда отправлять заказ.
6. Push-статусы (по желанию, но лучше включить)#
Чтобы статусы приходили мгновенно, пропиши адрес и токен Нямбота в кабинете Delivery — см. Адреса для уведомлений, раздел «r_keeper — доставка».
Без этого заказы не потеряются: Нямбот опрашивает статусы сам, просто с задержкой до минуты.
Самовывоз идёт мимо Delivery#
Даже когда доставку ведёт r_k Delivery, заказы-самовывоз Нямбот отправляет напрямую в кассу. Так и задумано: у самовывоза нет курьера, вести его в Delivery незачем, а при передаче через неё касса теряет признак самовывоза и заказ ложится «Доставкой».
Для тебя это незаметно: самовывоз как приходил на кассу с правильной категорией, так и приходит.
Открытый или закрытый заказ на кассе#
Это частый вопрос — «а кассир заметит заказ?». Зависит от модели:
| Заказ | На кассе |
|---|---|
| Доставку ведёт Нямбот (любая оплата) | Открыт, в активном списке заказов |
| Любой самовывоз | Открыт, в активном списке |
| Доставку ведёт Delivery, оплачен онлайн | Касса сразу закрывает его в «Закрытые чеки» |
| Доставку ведёт Delivery, наличные курьеру | Открыт (остаток не погашен) |
Почему предоплаченный заказ закрывается: он оплачен полностью, остатка нет — касса закрывает его в чек автоматически.
Это не потеря заказа. Кухонный бегунок печатается как обычно, а сам заказ живёт в ленте r_k Delivery — кухня ведёт его оттуда, а не с экрана кассы. Если тебе привычнее вести заказы с кассы — напиши в поддержку, настроим.
Что где настраивается#
| Что | Где |
|---|---|
| Курьеры, зоны доставки, статусы, их названия | Кабинет r_k Delivery |
| Подключение Яндекс.Доставки к Delivery | Кабинет r_k Delivery → Интеграции |
| Тумблер «кто ведёт доставку», креды API | СРМ Нямбота, модалка R-keeper |
| Категории/типы заказа, стол | СРМ Нямбота, блок «Маршрутизация заказа» |
| Валюта онлайн-оплаты | Админпанель White Server |
Связь с другими разделами#
- Подключение R-keeper → Подключение
- Как проходят заказы и оплата → Заказы и оплата
- Адреса для уведомлений → Адреса и URL
- Если что-то не сходится → Частые проблемы