Заказы и оплата (r_keeper)

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

Как заказ приходит на кассу#

Когда клиент оформляет заказ в мини-приложении, Нямбот отправляет его на кассу r_keeper (через White Server). Заказ появляется в списке «Выбор заказа для редактирования» с составом, модификаторами и комментарием — кассир и кухня его видят сразу.

В комментарии к заказу Нямбот пишет служебные строки, чтобы персоналу было понятно, как принимать оплату и что важно по заказу (адрес, приборы, промокод).

Приём заказа кассиром: автоматически или руками#

За это отвечает одна настройка White Server: кабинет WsAdmin → твой ресторан → вкладка «Параметры создания заказа» → «Время подтверждения заказа в секундах».

Два правила для второго случая:

• если кассир не нажал ничего и таймер истёк — заказ принимается сам. Молчание = согласие, заказ не теряется;
• если кассир нажал «Отклонить» (касса спросит причину: кухня перегружена, техническая неисправность, другая), заказа в кассе не будет вовсе.

🔴 Что при отказе видит клиент. Заказ у него остаётся оформленным: деньги при онлайн-оплате уже приняты, а кухня к нему не приступит. Нямбот такой отказ не проглатывает: в разделе Заказы такой заказ помечается красной меткой «Не ушёл в кассу» — и в строке таблицы, и в карточке, и в приложении «Команда». Наведи на метку: во всплывающей подсказке будет причина от кассы. Свяжись с клиентом сам: предложи другое время или верни деньги. Если отклонять заказы вам не нужно — оставь «Время подтверждения» равным 0, тогда окно приёма не появляется.

Способы оплаты#

Наличные / картой курьеру (оплата при получении)#

Деньги берёт курьер при доставке (или кассир при самовывозе) — касса ресторана в этот момент ничего не инкассирует, поэтому заказ висит с «Оплачено: 0.00».

Важно: на кассе r_keeper нал и карта при доставке выглядят одинаково. Чтобы было понятно, как принимать оплату, Нямбот пишет это прямо в комментарий заказа:

• Оплата: наличными курьеру
• Оплата: картой курьеру
• (для самовывоза — … при получении)

Онлайн (Яндекс.Пэй / ЮKassa)#

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

• строка «Предоплата · Оплата через WS» на сумму заказа;
• «Оплачено» = сумма, «Оплатить: 0.00»;
• в комментарии — Оплата онлайн · Яндекс.Пэй (или · ЮKassa).

При этом заказ остаётся открытым (не закрывается) — кухня его готовит, кассир видит, курьер везёт. Ничего вручную «пробивать» или закрывать по оплате не нужно — предоплата уже зафиксирована.

Кассиру НЕ нужно повторно проводить оплату онлайн-заказа — она уже принята («Автоматическая авторизация»).

Отмена заказа и возврат денег#

Отменить заказ можно двумя способами — оба корректно возвращают деньги клиенту при онлайн-оплате.

1. Отмена на стороне r_keeper (для клиентов на доставке r_keeper)#

Если доставку ведёт сам ресторан через модуль доставки r_keeper, заказ отменяют на стороне r_keeper, приложение «Команда» не нужно.

Как именно отменить — зависит от того, как настроен r_keeper у ресторана:

• на кассовой станции — штатное аннулирование чека;
• в окне редактирования заказа (WSA) отдельной кнопки «Отменить заказ» нет — заказ отменяется, если убрать из него все позиции и снять предоплату, затем сохранить.

Как только заказ отменён/аннулирован в r_keeper, Нямбот в течение ~1 минуты замечает это и сам:

• переводит заказ в статус «Отменён»;
• заводит задачу на возврат (при онлайн-оплате): деньги остаются на счету ресторана, пока владелец не нажмёт «Вернуть деньги гостю» в СРМ (почему так);
• присылает клиенту уведомление «Заказ отменён».

Отдельно нажимать что-то в Нямботе не нужно — отмена на стороне r_keeper зеркалится автоматически.

2. Отмена из приложения «Команда» (для доставки силами Нямбота)#

Если доставку везёт курьер Нямбота, заказ отменяет администратор в приложении «Команда» (или в СРМ). Тогда Нямбот:

• отменяет заказ на кассе r_keeper;
• заводит задачу на возврат (при онлайн-оплате) — деньги возвращает владелец из СРМ;
• уведомляет клиента.

Не удаляйте позиции вручную «в обход»#

Отменяйте заказ целиком одним из способов выше. Ручное удаление отдельных блюд на кассе «в обход» не заведёт задачу на возврат и рассинхронит заказ между кассой и Нямботом.

Статусы доставки: кто их ведёт#

• Доставка силами Нямбота — статусы «В пути» и «Доставлен» ставит курьер в приложении «Команда». Закрытие заказа на кассе НЕ отправляет клиенту «Доставлен» раньше времени — финал ставит курьер по факту доставки.
• Доставка/самовывоз силами ресторана — статусы ведёт касса, и они зеркалятся клиенту как есть.

⏱️ Насколько быстро обновляется статус. Смену статуса на кассе r_keeper Нямбот замечает в течение ~1 минуты (регулярно опрашивает кассу — это штатно и не требует настройки). Если тебе нужны мгновенные обновления статусов, напиши нам — такой режим можно включить дополнительно на стороне интеграции.