R-keeper — модификаторы и мини-приложение
Модификаторы блюда в R-keeper (основа, бортик, добавки, размер) задаются схемой модификаторов, привязанной к блюду. Нямбот читает схему и раскладывает группы по секциям мини-приложения. Вид секции определяется не названием группы, а её настройками Минимум / Максимум в r_keeper.
Как группа превращается в секцию#
| Настройки группы в r_keeper | Как покажет Нямбот |
|---|---|
| Минимум 1 и Максимум 1 — обязательный одиночный выбор | Переключатель-сегменты (как «Основа: Тонкая / Пышная», «Размер: 25 / 30 / 35 см») |
| Минимум 0 (или Максимум больше 1) — необязательный/множественный | Карточки «Добавить по вкусу» (с ценой) |
⚠️ Сегментами-переключателем становится только обязательный одиночный выбор (Минимум 1 + Максимум 1). Поставишь у «Основы» Максимум больше 1 — она уедет в «Добавить по вкусу».
Цена опции#
Цена опции зависит от флага группы «влияет на цену» (changesPrice) в r_keeper:
- Влияет на цену — опция показывается с ценой-надбавкой (цена блюда-ингредиента). Например, «Пышная +50 ₽».
- Не влияет — опция бесплатная (выбор без доплаты), цена
0.
💡 Цена опции берётся из карточки блюда-ингредиента в r_keeper. Хочешь поменять доплату за «Пышную основу» — меняй цену соответствующего ингредиента в r_keeper.
Где настраивать в r_keeper#
Менеджерская станция → Menu → Схемы модификаторов и Группы модификаторов:
- Создай группу модификаторов (например, «Основа») с опциями-ингредиентами («Тонкая», «Пышная»).
- Задай Минимум / Максимум: для обязательного выбора —
1 / 1; для добавок —0 / N. - Включи «влияет на цену», если за опции берётся доплата, и задай цены ингредиентов.
- Привяжи схему к нужному блюду.
После правок нажми «Синхронизировать» в СРМ (Интеграции).
Порядок в справочнике: раскладка по папкам (рекомендуется)#
Когда групп и схем модификаторов много, они сваливаются одной кучей под Все и в них легко запутаться. Их рекомендуется разложить по папкам-категориям (например, «Пища», «Роллы») — так удобнее ориентироваться:
- В справочнике Модификаторы: ПКМ на Все → New Set of Modifier Groups (Набор групп модификаторов), назови папку («Пища», «Роллы»), затем перетащи нужные группы внутрь.
- То же самое в справочнике Схемы модификаторов — папки создаются так же, схемы перетаскиваются в них мышкой.
💡 Раскладка по папкам — это чисто визуальная организация справочника. Она не меняет ни состав схем, ни привязку схемы к блюду, ни коды/ID. У блюда в поле Modifier Scheme остаётся та же схема — проверь это после перекладки на паре блюд.
Для Нямбота папки невидимы: меню синхронизируется по ID схем и групп, а не по папкам. После раскладки витрина и модификаторы в мини-приложении остаются прежними — можно даже не пересинхронизировать.
Как это выглядит на кассе и кухне#
Когда гость меняет состав в мини-приложении, Нямбот передаёт на кассу r_keeper только его изменения — то, что гость выбрал, доплатил или убрал. На кухонном терминале r_keeper это выглядит так:
| В мини-приложении гость… | На кассе/кухне | Почему так выглядит |
|---|---|---|
| Выбрал обязательное (основа, бортик, рис) | модификатор обычным текстом — [ Пышная ], [ Колбасный ] | Выбор бесплатный, а на терминале обычным = бесплатный (цена 0) |
Добавил доп за деньги (напр. + Ветчина +70 ₽) | модификатор жирным — [ Ветчина ] | На терминале r_keeper жирным всегда показывается платный модификатор (цена > 0). Добавленные допы платные → жирные |
Убрал ингредиент (напр. − Лук) | строка «Без: Лук» в составе блюда | Убранное уходит в комментарий к блюду — своё поле позиции у White Server. Касса печатает его отдельной строкой прямо под блюдом |
| Не трогал ингредиент состава | на кассу не уходит вовсе | Повар знает рецепт блюда. Раньше оставшийся состав уезжал модификаторами, и [ Лук ] стоял рядом с [ Ветчина ] — неотличимо от добавки, кухня клала лук вторым слоем |
Как кассиру/повару читать список под блюдом:
- Жирный модификатор = гость доплатил за этот ингредиент (добавка сверху).
- Обычный (не жирный) модификатор = обязательный выбор гостя: основа, бортик, рис (
[ Пышная ],[ Сырный ]). - Строка «Без: …» = что из блюда убрать. Она стоит там же, под своим блюдом, — искать в общем комментарии заказа не нужно.
- Всё остальное — по рецепту: чего в списке нет, то готовится как обычно.
Жирность на терминале — признак платности (цена > 0), а не «добавленный». Совпадает лишь потому, что добавки платные, а выбор бесплатный. Менять в номенклатуре не нужно. Названия выбора идут как есть (
[ Пышная ]), без приписки группы («Основа»): касса и так группирует модификаторы под блюдом.
Как называть модификаторы в группе «убрать»#
🔴 Называй сам ингредиент — «Огурец», «Имбирь», «Лук», — а не «Без огурца».
Модификаторы такой группы Нямбот кладёт в состав блюда в мини-приложении: гость видит их галочками и вычёркивает ненужное. Если модификатор назван «Без огурца», гость снимает галку с «Без огурца» — выходит двойное отрицание, и на кассу поедет «Без: Без огурца». Слово «Без:» Нямбот подставляет сам.
Строку в списке модификаторов «без» всё равно не даст: касса «убрать» и «добавить» на уровне модификатора не различает, а [ Лук ] повар прочтёт как «оставить». Поэтому убранное и уходит текстом — строкой «Без: …» в комментарии к блюду, прямо в его составе.
Что важно знать#
- Имя и состав группы берутся из справочника модификаторов r_keeper — Нямбот их только показывает (read-only).
- Размеры блюд через модификатор — это частный случай переключателя (Минимум 1 + Максимум 1) с ценой на опциях. Подробно про размеры и альтернативу (отдельные блюда) — Размеры блюд.
- Секции «Можно убрать» (убрать ингредиент из состава) поддерживаются: группа-ингредиенты без доплаты попадают в состав, гость снимает галку — ингредиент уходит в «Без: …» на кассе (см. выше).
- Служебные схемы r_keeper (марки «Честный знак», «Комментарий к блюду», системные модификаторы WSA) Нямбот отфильтровывает и в витрину не пускает.
Не приходят модификаторы или приходят пустые? → Частые проблемы.