iiko — купоны

На iiko-ТТ поле «Промокод» в оформлении заказа работает как купон iikoCard. Промокоды, заведённые в Нямботе, на iiko-ТТ не действуют — их роль берут купоны iiko.

Как это работает для покупателя#

1. Покупатель вводит номер купона на Корзине и жмёт «Применить».
2. Нямбот проверяет купон в iikoCard и показывает результат: применённую скидку/подарок или «купон не найден».
3. При оформлении заказа купон уходит в iiko — она применяет ту же скидку у себя.

💡 Сами купоны (серии, номера, условия) создаются в iikoCard (раздел маркетинга). Гость видит нейтральное поле «Промокод» — без брендов и тегов iiko.

Подарочные акции — это купон, а не накопительная программа#

Если хочешь дарить гостю блюдо при условии (например, «закажи 3 бургера → лимонад в подарок»), в iikoCard есть два пути:

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

1. Прогресс недоступен через API. iiko не возвращает «осталось купить ещё N блюд» — поля прогресса в расчёте лояльности приходят пустыми. Показать гостю «ещё 2 бургера до подарка» без отдельного учёта нельзя.
2. Накопление — между заказами. Программа стекает: 1 бургер сегодня, 2 на следующей неделе — и подарок выдаётся неожиданно, без объяснения.
3. Сложно объяснить без прогресс-бара. В мини-приложении нет места показать состояние кошелька; купон же виден сразу: «Применён купон PIZZA, +Лимонад домашний».

Вывод: для подарочных акций создавай купон + маркетинговую программу с условием «У гостя есть купон» → «Блюдо в подарок».

Как создать рекламный купон (один код для всех)#

Пример: реклама «введи PIZZA — получи пиццу в подарок при заказе от 2000 ₽».

Шаг 1 — Создай серию купонов

iikoCard → Купоны → Действия → Выпустить купоны

⚠️ Ключевой момент: без галочки «Единичный купон» iiko создаст 1 000 уникальных кодов (PIZZA005927, PIZZA013208…) — это для персональной раздачи, не для рекламы. С галочкой создаётся один код PIZZA, который вводят все покупатели.

Шаг 2 — Создай маркетинговую программу с условием и подарком

iikoCard → Программы → Создать → Маркетинговая акция

1. Заполни название, период действия, поставь галку «Действует».
2. В блоке «Условия и действия, применяемые к заказу» нажми «+ Создать» и добавь две строки:
   • Условие 1: «У гостя есть купон из серий» → выбери PIZZA
   • Условие 2: «Сумма заказа больше или равно» → 2000
3. В колонке «Действие» нажми «+ Создать» → выбери «Блюда в подарок» → выбери нужное блюдо и размер.
4. Нажми «Сохранить».

Шаг 3 — Синхронизируй с кассой

iikoOffice → Настройка iikoCard → Сопоставление акций и скидок → Получить маркетинговые акции → Сохранить

⚠️ Без этого шага касса не увидит новую программу и подарок не применится, даже если в iikoCard всё верно. Подробнее — Программы через iikoCard.

Нюансы купонов, которые важно знать#

Размер блюда-подарка — пиши с пробелом. Если у блюда есть размер (пицца, бургер), вводи его как 25 см (с пробелом), а не 25см. Без пробела iiko не возвращает ID размера, и подарок не уходит в заказ корректно.

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

Если нужен конкретный вариант (не дефолт) — создай отдельное блюдо-подарок в iikoOffice:

• Название: Чизбургер 25см Подарок
• Цена: 0
• Модификаторов нет — конкретный вариант (тесто, бортик) зашит в рецепт
• В акции iikoCard используй это блюдо вместо основного

После сохранения акции всегда делай синк. Новая программа появляется в расчёте лояльности сразу, но касса не применит скидку/подарок, пока не сделано «Сопоставление акций и скидок» в iikoOffice. Не пропускай этот шаг.

Где посмотреть свои серии в Нямботе#

Маркетинг → вкладка «Купоны кассы» — список серий, у которых есть неактивированные купоны, и когда список обновлялся.

Это зеркало, только для просмотра: серии заводятся в iikoCard, Нямбот их не создаёт и не гасит. Число неактивированных купонов — снимок на момент синхронизации, а не счётчик в реальном времени: купон могли погасить на кассе минуту назад. Поэтому рядом всегда стоит дата — без неё цифра выглядела бы точной, а она такой не бывает.

На каких точках действует серия#

Серия принадлежит ключу iiko и его организации, а не выбранной торговой точке: купон гасится на любой точке, подключённой этим ключом. Поэтому над таблицей стоит подпись «Серии ключа «…» действуют на всех его точках» — наведи на неё, чтобы увидеть список точек.

Если часть точек подключена другим ключом, их серии здесь не появятся: переключись на такую точку в шапке СРМ — таблица покажет серии её ключа.

Колонки и номера купонов#

Список номеров нужен для одного: сверить номер, который называет гость. Он тоже снимок — купон могли погасить на кассе после синхронизации, и решает всегда касса. Если купонов в серии много, показываются первые 500 — об этом честно написано над списком.

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

Коротко#

• «Промокод» на iiko-ТТ = купон iikoCard; промокоды Нямбота не действуют.
• Свои серии видно в СРМ: Маркетинг → «Купоны кассы» (только просмотр).
• Для рекламы (один код всем) ставь галочку «Единичный купон».
• Подарки делай через купон, а не накопительную программу.
• Размер подарка пиши с пробелом; для точного варианта заводи отдельное блюдо-подарок.
• После любой правки — сопоставление акций и скидок в iikoOffice.