iiko — комбо-наборы

Комбо в iiko — это конструктор: гость выбирает по одному блюду в каждой группе («Пицца», «Напиток», «Соус»), а цена считается по правилу набора (чаще — фиксированная). Нямбот показывает такой конструктор в мини-аппе и отправляет собранный набор прямо в кассу iiko.

ℹ️ Комбо ≠ обычное блюдо. Это отдельная сущность iikoCard, а не блюдо с фиксированным составом. Заводится в кабинете iikoCard, а во внешнее меню добавляется отдельной вкладкой.

🔑 Источник правды для блюд и модификаторов — номенклатура iikoOffice. Вес, цену и название блюд и модификаторов внутри комбо задавай в карточках товаров в iikoOffice (BackOffice), и только потом жми «Обновить данные» во внешнем меню. Если править их прямо в витрине iikoWeb — при обновлении затрутся (вес станет 1000 г, у модификаторов пропадёт цена). Название модификатора при этом приходит верное: «Несколько вариантов» — плейсхолдер интерфейса iikoWeb, а не то, что уезжает в API. Цену модификатора Нямбот при необходимости добирает из номенклатуры сам.

🖼 А вот фото и описание САМОГО комбо ведём в Нямботе. Комбо в iiko — это акция iikoCard, объекта в бэк-офисе у него нет: задать фото и описание там негде, а «Обновить данные» стирает то, что вписано в витрине. Поэтому источник правды для них — карточка комбо в СРМ Нямбота («Меню» → вкладка кассы → «Комбо» → значок фото). Синхронизация их не перезаписывает, а кнопка «Вернуть из кассы» в любой момент возвращает значение кассы.

♻️ Пересоздал комбо в iikoCard — это новое комбо. У новой акции другой идентификатор, связи со старой нет, поэтому фото и описание нужно задать заново.

---

Шаг 1. Создать комбо в iikoCard#

Открой кабинет m1.iiko.cards (не iikoWeb) → раздел «Программы» → создай акцию с действием «Комбо-блюдо».

1. Категории комбо (необязательно, для группировки в витрине): раздел «Категории комбо» → выбери организацию → «Создать» → имя категории. Категорию можно удалить, только пока она не назначена ни одному комбо.
2. Действие «Комбо-блюдо» в акции:
   • Название (его увидит касса и гость);
   • опц. Категория;
   • Стоимость — одна из стратегий: Фиксированная цена (на весь набор), Цена за каждое блюдо, % скидки на самое дешёвое / дорогое / на все блюда.
3. Группы блюд — в каждой гость выбирает 1 блюдо. Пример: «Пицца» (Барбекю / Четыре сыра) + «Напиток» (Лимонад / Морс) + «Соус» (Сырный / Сладкий чили). У группы есть флаг «Основное блюдо».
4. На строке блюда задаются: Размер, Запрещённые модификаторы и «Увеличить стоимость на» (доплата).

---

Шаг 2. Главный нюанс — размер и модификаторы блюда в комбо#

У блюда в комбо есть свои обязательные модификаторы (у пиццы — Основа и Бортик, у напитка — лёд и т.п.). В конструкторе комбо iiko нельзя предвыбрать конкретный модификатор — можно только:

• Зафиксировать размер — колонка «Размер» (например, 30 см). Хочешь дать выбор размера — заведи блюдо отдельными строками на каждый размер.
• Запретить лишние модификаторы — поле «Запрещённые модификаторы».

⚠️ iiko не передаёт запреты во внешнее меню. Поэтому Нямбот не может «увидеть», что ты запретил, и ориентируется на модификатор по умолчанию из номенклатуры.

Как это работает на практике#

Чтобы блюдо в комбо всегда уходило с нужным вариантом (например, классический бортик и тонкая основа), сделай так:

1. В номенклатуре отметь нужный вариант как модификатор по умолчанию (Бортик → Классический «по умолчанию», Основа → Тонкая «по умолчанию»).
2. В комбо в «Запрещённых модификаторах» запрети все остальные варианты этой группы (Сырный, Сосисочный — для бортика).

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

💡 Правило простое: «зашитый» в комбо вариант должен быть модификатором по умолчанию в номенклатуре. Нямбот покажет его гостю в составе («Барбекю, 30 см, Классический бортик, Тонкая основа») и отправит на кассу.

---

Шаг 3. Добавить комбо во внешнее меню#

В iikoWeb → «Внешние заказы» → «Внешнее меню» (твой номер меню) → вкладка КОМБО:

• Добавляй комбо по артикулу, а не выбором названия из списка — так iiko не выдаст ошибку «Артикул не найден во внешнем меню» (она возникает при двух одноимённых блюдах).
• После добавления нажми ↻ «Загрузить из номенклатуры».

---

Шаг 4. Синхронизация и проверка в мини-аппе#

1. В СРМ Нямбота на вкладке iiko «Меню» нажми синхронизацию — в результате будет счётчик «Комбо N», а комбо появятся в таблице «Комбо».
2. Открой мини-апп (при необходимости Ctrl+F5) — комбо появится отдельной категорией «Комбо». Тап по нему открывает конструктор: гость выбирает блюдо в каждой группе, видит зашитые модификаторы и итоговую цену, считаемую iiko.
3. Оформи тестовый заказ — комбо уйдёт на кассу iiko как набор (в чеке — позиции комбо со скидкой до итоговой цены набора).

---

Частые проблемы#

📋 Размер фиксируется в комбо, обязательные модификаторы берутся по умолчанию — поэтому держи номенклатуру и комбо согласованными: «зашитый» вариант = вариант по умолчанию + запрет остальных.