Доставка r_keeper

На точке с R-keeper кто ведёт доставку, выбираешь ты — в СРМ, в подключении R-keeper, блок «Кто ведёт доставку»:

В обоих вариантах заказ лежит в кассе: кухня готовит его по кассе, как любой другой.

🔴 Заказ в кассе закрывает и снимает только кассир. На смене он лично отвечает за кассу, деньги и заказы в ней. Нямбот не вносит в кассу оплату курьера, не закрывает заказ и не снимает заказ, который касса уже приняла, — он оставляет кассиру пометку в комментарии заказа: кто везёт, что заказ доставлен и сколько получить, что заказ отменён и его нужно снять.

🔴 Скидки, акции, промокоды и баллы Нямбота работают только с доставкой Нямбота. С модулем доставки кассы вариант «Нямбот» в блоке «Лояльность и акции» серый: итог курьерского заказа в r_k Delivery скидок на блюда не видит, и у курьера была бы другая сумма → Скидки Нямбота в R-keeper.

---

Вариант 1. Доставку ведёт Нямбот#

Как едет заказ#

1. Гость оформляет заказ — Нямбот заводит его в кассе через White Server: состав, адрес, строка «Доставка» и комментарий. Касса называет сумму до оплаты, как у любого заказа → Заказы и оплата.

2. Кухня готовит по кассе — кухонный принтер печатает заказ как обычно. Касса без кухонного экрана не сообщает ни «Готовится», ни «Готов».

3. Заказ готов — администратор смены отмечает «Готов» в приложении «Команда», прямо из «Принят». Если на кухне стоит кухонный экран кассы и касса прислала «готов», «Готов» встаёт сам — как после отметки в «Команде», и администратору приходит уведомление о готовности. По самовывозу гость в этот момент получает «Готов к выдаче».

4. Администратор назначает своего курьера или вызывает Яндекс.Доставку. Имя и телефон курьера Нямбот записывает в заказ кассы, а в комментарий — строку Нямбот: курьер Иван, +7….

5. «В пути» видит гость в мессенджере, в кассу этот статус не уходит.

6. Курьер или администратор отмечает «Доставлен» — гость сразу получает статус, а в комментарий заказа кассы уходит пометка:

   • Нямбот: доставлен курьером Иван в 14:32 — получить 1 435 руб. наличными (или картой);
   • Нямбот: доставлен курьером Иван в 14:32 — оплачен онлайн.

   Закрывает заказ кассир — когда курьер сдал деньги.

7. Отмена в «Команде» отменяет заказ в Нямботе — гость сразу получает «Отменён», — а в заказ кассы уходит просьба Нямбот: отменён в 14:32 — сними заказ в кассе. Снимает его кассир. Деньги гостю отмена не возвращает: при онлайн-оплате заводится задача на возврат → почему так.

Каждую пометку дублирует уведомление «Пометка кассиру в заказе кассы» — администратору смены и в СРМ, чтобы её не пропустили → Администратор смены.

Кто что делает#

Повар в «Команду» на такой точке не входит — кухня работает в кассе. Подробнее про режим → «Команда» — администратор.

Открытый или закрытый заказ на кассе#

Кассир держит заказ открытым на станции — касса не даёт его менять, и пометки Нямбота ждут. Нямбот повторяет сам, пока заказ не освободится, — достаточно выйти из заказа на станции.

Что настроить#

1. СРМ → Интеграции → подключение R-keeper → «Кто ведёт доставку» → «Нямбот». Client ID и Client Secret r_k Delivery здесь не нужны.
2. Позиция доставки — блюдо «Доставка» с открытой ценой → Стоимость доставки. Шаг с синхронизацией меню в r_k Delivery пропусти — он только для модуля доставки кассы.
3. Валюта онлайн-оплаты в том же подключении — «Оплата через WS»: без фискального чека и с разрешённой предоплатой. Ею Нямбот вносит онлайн-оплату в заказ кассы предоплатой → Заказы и оплата. Валют для наличных и карты курьеру нет: эти деньги принимает кассир, когда курьер их сдаёт.
4. Сотрудники — администраторы и курьеры точки в СРМ → Сотрудники. Повара на такую точку не заводят.
5. Уведомления — включи администратору смены «Пометка кассиру в заказе кассы» → Администратор смены.
6. Яндекс.Доставка — по желанию → Яндекс.Доставка.

Как кассир принимает деньги у курьера и как касса печатает по ним чек — порядок твоей кассы. Нямбот подсказывает только сумму и способ: «получить 1 435 руб. наличными».

Адреса для уведомлений r_k Delivery в этом варианте не нужны: статусы доставки ставит «Команда».

---

Вариант 2. Доставку ведёт модуль кассы (r_k Delivery)#

Как едет заказ#

1. Гость оформляет заказ в мини-приложении, Нямбот принимает оплату.
2. Нямбот отправляет заказ в r_k Delivery по API — с адресом, составом и признаком оплаты.
3. Delivery сама кладёт заказ в кассу RK7 и ведёт его дальше: кухня, сборка, курьер.
4. Курьер работает в CourierApp — курьерском приложении r_keeper: видит адрес, телефон гостя, сумму и маршрут, и оттуда же двигает статусы.
5. Статусы возвращаются в Нямбот, и он сообщает их гостю в боте и мини-приложении: «В пути», «Доставлен», «Отменён».

Гость и Нямбот — на одном конце цепочки, кухня и курьер — на другом; переписывать заказ руками нигде не нужно.

Что нужно с твоей стороны#

Кроме лицензий и настроек ниже — CourierApp, курьерское приложение r_keeper: лицензия Delivery_CourierApp по числу устройств, запроси её у r_keeper вместе с остальными.

Курьеры, зоны, статусы и их названия — в кабинете r_k Delivery. Яндекс.Доставку, если она нужна, подключают внутри 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 само не приезжает. Завёл блюдо в менеджерской станции — открой в кабинете Delivery раздел «Меню» и нажми кружок синхронизации на карточке меню «Касса». Пока не нажал, Delivery блюдо не знает и заказ с ним не пройдёт.

Витрину в Delivery вести не надо: Нямбот отправляет блюда по их кодам из кассы.

Стоимость доставки

Цену доставки и «Бесплатно от N ₽» задаёшь у зоны в Нямботе, а в кассе нужно одно блюдо «Доставка» с открытой ценой → Стоимость доставки.

4. Валюта онлайн-оплаты (иначе аванс сядет не туда)#

Тут два места, и в обоих выбираем валюту «Оплата через WS»:

1. Админпанель White Server → «Параметры создания заказа» → «Дополнительные параметры» → «Валюта заказов» → «Оплата через WS». Это то, чем касса зачтёт предоплату.
2. Кабинет Delivery → «Интеграции → ваш источник заказа → Параметры заказа» → в полях «Валюта онлайн оплаты» и «Валюта онлайн оплаты для самовывоза» тоже выбери «Оплата через WS». Именно GUID этой валюты (без фигурных скобок) пойдёт в СРМ Нямбота на шаге 5.

Это настройка каждой точки отдельно. Если оставить «Рубли», онлайн-предоплата будет попадать на кассу как рублёвая оплата, хотя деньги уже собраны в интернете.

5. Данные в СРМ Нямбота#

Модалка R-keeper, «Кто ведёт доставку» → «Модуль доставки кассы» — появится блок «Доставка r_k Delivery»:

Валюта онлайн-оплаты нужна не только Delivery. Той же валютой касса принимает онлайн-оплату заказов, которые Нямбот заводит в кассе напрямую, — без неё касса узнаёт о таком заказе только после оплаты. При сохранении Нямбот сверяет валюту с кассой: активная, с разрешённой предоплатой и без фискального чека. Иначе сохранение откажет: «Эта валюта не подходит для онлайн-оплаты…» → Заказы и оплата.

Пока поле пустое, под ним и в карточке точки (если у неё есть онлайн-оплата) стоит жёлтая плашка: «Не задана валюта онлайн-оплаты — касса узнаёт о заказе только после оплаты и может отклонить его уже оплаченным. Укажи валюту «Оплата через WS» в подключении R-keeper».

Заведение вводить не нужно. Нямбот сам определит его по Client ID/Secret при сохранении (в поле «Заведение» подставится автоматически). Если Client ID/Secret неверны — сохранение не пройдёт с понятной ошибкой.

С модулем доставки кассы без Client ID и Client Secret подключение не сохранится: заказ на доставку отправлять было бы некуда. С доставкой Нямбота они не нужны.

6. Пуш-статусы (по желанию, но лучше включить)#

Чтобы статусы приходили мгновенно, пропиши адрес и токен Нямбота в кабинете Delivery — см. Адреса для уведомлений, раздел «r_keeper — доставка».

Без этого заказы не потеряются: Нямбот опрашивает статусы сам, просто с задержкой до минуты.

Самовывоз идёт мимо Delivery#

Доставку ведёт Delivery, а заказы-самовывоз Нямбот отправляет напрямую в кассу. Так и задумано: у самовывоза нет курьера, вести его в Delivery незачем, а при передаче через неё касса теряет признак самовывоза и заказ ложится «Доставкой».

Для тебя это незаметно: самовывоз как приходил на кассу с правильной категорией, так и приходит.

Открытый или закрытый заказ на кассе#

Это частый вопрос — «а кассир заметит заказ?». Зависит от оплаты:

Почему предоплаченный заказ закрывается: он оплачен полностью, остатка нет — касса закрывает его в чек автоматически.

Это не потеря заказа. Кухонный бегунок печатается как обычно, а сам заказ живёт в ленте r_k Delivery — кухня ведёт его оттуда, а не с экрана кассы. Если тебе привычнее вести заказы с кассы — напиши в поддержку, настроим.

---

Что где настраивается#

---

Связь с другими разделами#

• Подключение R-keeper → Подключение
• Как проходят заказы и оплата → Заказы и оплата
• Скидки и баллы Нямбота в кассе → Скидки Нямбота в R-keeper
• Приложение «Команда» → Администратор · Курьер
• Адреса для уведомлений → Адреса и URL
• Если что-то не сходится → Частые проблемы