Restaurant Commerce — меню, Ordering, KDS, Kiosk и POS

Reven Ordering, KDS, Kiosk и POS используют одно меню, одинаковые правила ценообразования и общую запись заказа. Поэтому проданную или изменённую позицию меню не нужно вручную обновлять в каждом канале.

Меню

Пользователь с правом menu:manage может управлять:

• локацией, меню, публикацией и порядком категорий;
• названием позиции, SKU, описанием, ценой, сравнительной ценой и изображением;
• метками Vege, Vegan, New и Bestseller и уровнем остроты;
• показом позиции в дополнительных категориях;
• станциями приготовления;
• группами модификаторов и минимальным/максимальным числом выборов;
• вариантами, доплатой, значением по умолчанию, активностью и статусом sold out;
• вместимостью заказов, базовым lead time и зонами доставки.

SKU важен для связей между локациями и ваучеров на конкретную позицию. Он должен быть стабильным и уникальным в выбранной клиентом модели.

Ordering и обработка заказа

Публичный клиент выбирает обслуживание на месте, самовывоз или доставку, доступную для адреса/зоны. Сервер заново рассчитывает цены, модификаторы, стоимость доставки, минимум, купоны, ваучеры и сумму платежа. Расчёт нельзя основывать на значении, переданном только браузером.

После корректной оплаты заказ может быть принят автоматически или ожидать сотрудника. В ручном режиме сотрудник принимает его и указывает обещанное время. Типичная последовательность: оплачен → принят → готовится → готов → завершён. Возврат требует orders:manage и проверки каждого tender и использованного преимущества.

KDS

KDS показывает активные заказы и позиции по станциям приготовления. Сотрудники с kds:operate обновляют этап работы. Экран должен работать на выделенном устройстве, а процедура заведения — учитывать потерю сети и ручную передачу заказа.

Kiosk

Гость может начать заказ еды или, если настроено, отдельную покупку ваучера. Для еды он выбирает способ получения, позиции и модификаторы, может отсканировать карту Loyalty, купон или ваучер, затем оплачивает оставшуюся сумму.

Панель Kiosks используется для однократной регистрации устройства и контроля соединения, терминала, фискального принтера, сканера, бумаги и последней ошибки. Локальный агент устанавливает исходящее соединение с Reven и хранит секрет устройства вне frontend-кода.

В production адаптер терминала должен поддерживать статус, идемпотентный старт, запрос результата, reversal и refund; фискальный адаптер — состояние устройства, бумагу, фискализацию и проверку результата. Неоднозначный результат необходимо проверить по reference провайдера. Нельзя «вслепую» запускать второй платёж. Оплаченный заказ передаётся в работу только после обязательной фискализации, если такой сценарий активен.

POS

POS использует общее меню для заказов у стойки, по телефону и вручную перенесённых из marketplace. Доступность терминальной оплаты зависит от установленного провайдера и устройства. При вводе внешнего заказа сотрудник должен сохранить его reference и не создавать параллельный онлайн-платёж.

Границы решения

Reven v1 сам по себе не является сертифицированной польской фискальной кассой. Клиент сохраняет требуемый законом фискальный процесс, если объём внедрения не включает конкретную утверждённую интеграцию. Драйверы в пакете агента могут быть симуляторами; production-статус подтверждается для конкретного терминала и принтера.

Проверки перед запуском

1. Создайте заказ для обслуживания на месте, самовывоза и каждой зоны доставки.
2. Проверьте базовую цену, модификаторы, сбор, минимум, ваучер/купон и остаток к оплате.
3. Проверьте успешный и отклонённый платёж, повторный webhook и возврат.
4. Проверьте автоматический и ручной режим, KDS и обещанное время.
5. На реальном киоске проверьте idle/reset, сканер, терминал, фискализацию, отсутствие бумаги, потерю сети и восстановление.