iiko — программы через iikoCard

iikoCard (m1.iiko.cards) — это тонкая настройка лояльности и акций. Сюда идёшь, когда грубой настройки в iikoWeb уже не хватает: нужны условия, подарки, купоны, комбо, несколько программ сразу и их комбинации.

💡 Если тебе достаточно плоской скидки или простого кэшбэка — это iikoWeb (грубая настройка). iikoCard — когда нужно «по-взрослому».

Что удобно заводить именно в iikoCard#

• Скидочные программы с условиями (от суммы, по дню/времени, для сегмента гостей).
• Бонусные программы (баллы) с гибкими правилами начисления и списания.
• Подарочные программы («Блюдо в подарок» по условию).
• Купоны (серии, персональные коды) — см. Купоны.
• Комбо — см. Комбо.
• Несколько программ сразу и их комбинации.

Обязательный шаг: сопоставление акций и скидок#

Чтобы программы iikoCard срабатывали на заказах из Нямбота, в iikoOffice нужно сделать сопоставление — без него касса скидку/подарок не применит, даже если в iikoCard всё верно:

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

⚠️ Без сопоставления касса вернёт ошибку «iikoCard is not enabled», даже если подключение зелёное. Это самая частая причина «скидка не применяется».

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

Переподключиться → Получить маркетинговые акции → Сохранить и закрыть → Состояние подключения → Обновить.

Охват программы: вся сеть или отдельные рестораны#

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

Нямбот читает охват и не показывает гостю программу, которая на его ресторан не распространяется. На экранах это видно так:

• «Интеграции» → сегмент «Заведения кассы» → колонка «Программы кассы»: жёлтая метка, если часть программ ограничена;
• «Маркетинг» → вкладка iiko → строка над вкладками с меткой «программ кассы: N» и расшифровкой в подсказке.

⚠️ Пустой список организаций в программе означает «во всех точках сети», а не «ни в одной». Если ждёшь, что программа сработает только в одном ресторане, — сними галочку и выбери его явно.

Оплата баллами: тип оплаты в iikoOffice#

Чтобы покупатель мог списать баллы на внешнем заказе, в iikoOffice нужен один тип оплаты — без него касса вернёт «Тип оплаты не найден», и заказ с баллами не пройдёт:

1. Открой Розничные продажи → Типы оплат → Добавить.
2. Наименование — например «Бонусы iikoCard5», Тип — «Безналичный расчёт».
3. В блоке Безналичный тип выбери «Система iikoCard5» (именно её, не просто «iikoCard» — это ключевой момент).
4. Поставь галку «Может приниматься извне» (без неё внешний заказ Нямбота не сможет использовать этот тип).
5. Сохрани.

Заводить гостю карту не нужно — покупатель определяется по номеру телефона. После этого в чеке появятся две строки: «Бонусы iikoCard5» и основной способ оплаты.

💡 Сколько баллов можно списать, считает iikoCard (по балансу гостя и правилам). Начисление баллов работает штатно — гость определяется по телефону.

Нюансы#

• Скидка и подарок применяются с небольшой задержкой (1–3 секунды после создания заказа) — это нормально, не баг.

• Блюдо-подарок: если у него есть размер или обязательный модификатор (основа, лёд) — они подставляются по умолчанию автоматически. Детали и обходные пути — на странице Купоны.

• Не дублируй скидку в iikoWeb «Дисконт» и в программе iikoCard на одно и то же блюдо — касса применит обе, см. Скидки на блюда.

• Сколько подарков даст акция — решает касса, и по умолчанию это один на заказ. Три бургера — один соус. Чтобы подарок давался за каждое блюдо, открой условие акции «Количество заказанных блюд» и включи галочку «Может сработать несколько раз в 1 заказе». Нямбот показывает гостю ровно столько подарков, сколько вернула касса: обещать больше он не станет, иначе на кассе сумма разошлась бы с экраном.

  Обратный ход тоже ничего от тебя не требует: снял галочку — гость сразу видит один подарок, повторной настройки в Нямботе нет. На карточке акции в разделе «Акции» при этом появится метка «Кампания изменилась» — Нямбот не переписывает зеркало сам, чтобы не затирать твои правки; подробнее — Зеркало акции кассы.

• Подарочное блюдо, добавленное гостем самостоятельно, подарок не отменяет — и не заменяет. То, что гость положил в корзину сам, он покупает; подарок приходит отдельной строкой ровно на ту кратность, которую дала акция. Три бургера, три своих кетчупа и акция «бургер → соус» — это «Кетчуп 3 × 50 ₽» платно плюс «Кетчуп ×3 · ПОДАРОК · 0 ₽», всего шесть кетчупов, и шесть же уедет на кухню.

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

Как подарок выглядит на кассе#

Подарок приходит на кассу строкой по полной цене, а рядом идёт скидка на её сумму. Не строкой с ценой 0.

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

Так же ведёт себя и сам кассир, когда пробивает подарок руками: строка встаёт полной ценой, а бесплатной её делает скидка. Заказ из Нямбота ничем от ручного не отличается.

Почему именно так, а не «цена 0»:

• позиция за 0 ₽ для iiko — просто товар за ноль. Касса не считает её подарком, к акции не привязывает, в отчёты по маркетинговым кампаниям она не попадёт;
• в учёте это разные вещи: продажа за 0 ₽ занижает выручку, а скидка остаётся скидкой по программе лояльности;
• при цене 0 касса начинает дарить ту строку, которую гость купил сам, — и суммы разъезжаются.

На экране оплаты касса сводит все скидки заказа в один процент и не подписывает, какая акция его дала, — это её обычное поведение, одинаковое для заказов из Нямбота и пробитых вручную. Название программы Нямбот в кассу передаёт: разбор по акциям виден в iikoCard и в карточке заказа в СРМ.

Коротко#

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