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

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

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

Главное правило подарка: своя позиция в номенклатуре#

🔴 Дари то, что гость не может купить. Заведи в номенклатуре iiko отдельную позицию с собственным названием и артикулом — «Пицца Барбекю 25 см (подарок)», «Морс клюквенный 0,3 л (подарок)», — положи её во внешнее меню в скрытую группу «Подарки» (как именно — ниже) и указывай подарком в акции.

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

Акция «2 любые пиццы + пицца Барбекю 25 см в подарок», гость собрал корзину:

Гость хотел купить две пиццы Барбекю и не заплатит за них ничего. С отдельной позицией этого не происходит: купленная «Барбекю 25 см» и подаренная «Барбекю 25 см (подарок)» — разные артикулы, обнулять кассе нечего, подарок приходит своей строкой.

Куда класть подарочную позицию: в меню, но в скрытую группу#

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

Но продаваться подарок не должен. Поэтому:

1. в iikoWeb → Внешние меню заведи группу «Подарки»;
2. в её настройках сними «Видимость группы»;
3. складывай туда все подарочные позиции.

Гость такую группу и её блюда не увидит: ни в меню, ни в поиске, ни по прямой ссылке — Нямбот читает признак скрытия и не показывает их. А касса подарок выдаст, потому что в номенклатуре он есть.

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

💡 Цену и картинку подарочной позиции задавай как обычному блюду. Гость их увидит в строке подарка: название и фото Нямбот берёт из меню. Цена на сумму заказа не влияет — подарочную строку касса зануляет сама.

Что ещё важно знать:

• две акции могут дарить одно и то же блюдо. Касса отвечает по каждой кампании отдельно и называет её имя, поэтому подпись «за что подарок» остаётся верной. Проверено живым заказом: купонная акция и обычная подарили один и тот же морс, гость получил две строки с разными подписями, а нормы акций не схлопнулись;
• размер в подарочном действии задавай всегда. Оставишь пустым — касса выберет сама и не обязательно дешёвый: на живом заказе она выдала Барбекю 30 см за 650 ₽ вместо 25 см за 570 ₽;
• правило работает и для купонов. Купон только включает акцию, дальше механика та же. Живой случай: акция «купон + Барбекю → морс», а морс уже лежал в корзине платный — касса обнулила его, и заказ подешевел на 250 ₽;
• один купон включает все акции своей серии, подарки складываются — обнулить касса может сразу несколько строк;
• если подарок того же вида, что и предмет условия («пицца за пиццы»), ставь в условии галочку «Не учитывать бесплатные блюда». Иначе подарки считаются в условии, и акция разгоняет сама себя.

Порядок: сначала программа, потом акции внутри неё#

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

«Категория» в масках — это категория товара, а не группа#

В масках условий и действий iikoCard («Тип» — «Категория») касса сравнивает имя с категорией товара из карточки позиции (iikoOffice → «Дополнительная информация» → «Категория»), а не с группой номенклатуры и не с группой внешнего меню. Новая позиция часто получает категорию по умолчанию — например, «Пицца». Проверь категории у блюд и услуг, которые участвуют в акциях: Нямбот считает прогресс акций по тем же категориям товара, что и касса.

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

• Скидочные программы с условиями (от суммы, по дню/времени, для сегмента гостей).
• Бонусные программы (баллы) с гибкими правилами начисления и списания.
• Подарочные программы («Блюдо в подарок» по условию).
• Купоны (серии, персональные коды) — см. Купоны.
• Комбо — см. Комбо.
• Несколько программ сразу и их комбинации.
• Бесплатная доставка от суммы — не акция 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. Сохрани.
6. В Нямботе: Интеграции → подключение iiko → «Типы оплаты iiko» → «Баллы (iikoCard)» — выбери этот тип. Пока он не выбран, гость баллы на витрине не спишет: Нямбот прячет списание, чтобы заказ не упал уже после оплаты.

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

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

Нюансы#

• Касса считает акции 2–5 секунд. Столько занимает расчёт при переходе к оформлению: покупатель видит на месте будущих подарков подпись «Заведение считает акции», а когда касса отвечает — состав и суммы дорисовываются. Это нормально, не баг.

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

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

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

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

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

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

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

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

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

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

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

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

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

Коротко#

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