iiko — купоны

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

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

1. Покупатель вводит номер купона на Корзине и жмёт «Применить».
2. Нямбот спрашивает кассу и называет выгоду словами, а не просто «применён»:
   • подарок — «Промокод применён — Морс клюквенный 0,3 л в подарок. Добавим его при оформлении на следующем шаге»;
   • деньги — «Промокод применён — скидка 300 ₽. Учтём её при оформлении на следующем шаге»;
   • 🔴 номер верный, но этой корзине ничего не даёт (условие акции не выполнено) — так и написано. Раньше такой покупатель читал «Купон применён» и платил, ожидая подарок, которого не будет;
   • номер не найден или уже потрачен — причина словами кассы.
3. При оформлении заказа купон уходит в iiko — она применяет ту же скидку у себя, и на том экране выгода повторяется уже как факт, без «на следующем шаге».

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Шаг 3 — Отметь серию многоразовой в Нямботе

СРМ → Маркетинг → «Купоны кассы» → переключатель «Многоразовые купоны»

🔴 Без этой отметки рекламный код сработает только у первого гостя — остальные увидят «Этот промокод уже использован». Признака многоразовости нет в API кассы, поэтому Нямбот по умолчанию считает купон одноразовым и бережёт тебя от недоплаты. Разбор — ниже, в разделе про вкладку «Купоны кассы».

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

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

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

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

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

🔴 Подарочная позиция обязана лежать во внешнем меню — в скрытой группе «Подарки». Не положишь в меню — подарок не доедет до заказа: Нямбот собирает подарочную строку по номенклатуре кассы, а туда блюдо попадает только вместе с меню. Чтобы гость его при этом не купил, сними у группы «Видимость группы». Подробнее — Программы через iikoCard.

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

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

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

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

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

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

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

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

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

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

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

🔴 Рекламный купон: включи переключатель «Многоразовые купоны»#

Если ты выпустил серию для рекламы — один код на всех, галочка «Активировать купон после закрытия заказа» снята, — обязательно отметь её в Нямботе: Маркетинг → «Купоны кассы» → переключатель «Многоразовые купоны» в строке серии.

Без отметки промокод сработает только у первого гостя. Остальные увидят «Этот промокод уже использован». Так устроена защита от повторного применения: обычный купон гость может потратить один раз, и Нямбот помнит это сам — касса про гашение купона сообщает с задержкой в несколько минут, и за это окно заказ уезжает недоплаченным.

Спросить кассу «а этот купон многоразовый?» нельзя: в её API такого признака нет вовсе. Поэтому отметку ставишь ты.

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

Отметка действует на всю серию, включая номера, выпущенные после последней синхронизации: такого номера ещё нет в списке, и Нямбот спросит кассу, из какой он серии. Регистр букв не важен — PIZZA и pizza для кассы и для Нямбота один и тот же промокод.

Переключатель снимается так же — серия снова станет одноразовой.

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

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

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

Коротко#

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