Зеркало акции кассы

Зеркало — это карточка акции в Нямботе, которая повторяет условие акции, настроенной в кассе. Гость видит в корзине прогресс: «осталось добрать 500 ₽», «добавь ещё одну пиццу». Сумму чека зеркало не трогает — скидку и подарок применяет касса при оформлении.

Обычно условие в зеркало переносит синхронизация: Нямбот читает акцию iikoCard и держит карточку в том же виде, что и касса. Руками условие повторяешь, только если заводишь зеркало сам — по акции, которую Нямбот прочитать не может.

💡 Зачем это нужно: касса умеет считать сложные акции, но не умеет заранее рассказать о них гостю в мини-приложении. Зеркало закрывает именно это: что сделать, чтобы акция сработала.

Что зеркало умеет повторить#

Условие в кассеПоле зеркалаЧто увидит гость
Заказ от суммыМинимальная сумма заказа«Осталось 500 ₽ до акции»
Нужны конкретные блюдаТребуемые блюда«Добавьте Барбекю» — блюдо названо поимённо
Нужно блюдо определённого размераРазмеры требуемых блюд«Добавьте Барбекю 30 см»
Нужны блюда определённых категорийТребуемые группы товаров«Добавь пиццу»
Нужно N позиций из категорииМин. кол-во товаров«Добавь ещё 2 позиции»
Нужно на сумму из категорииМин. сумма товаров из групп«Осталось 300 ₽ по напиткам»
Дни недели и часы («Счастливый час»)Дни недели, время начала и окончанияАкция помечена недоступной вне окна
Гость получает блюдо в подарокБлюдо-подарок из акции кассыКарточка с фото: что именно достанется
Только самовывоз или только курьерполя нет — переносит синхронизация«Только при самовывозе»

Галочка «Все группы должны быть представлены в корзине» переключает условие между «любая из групп» и «все группы сразу» — как «пицца или паста» против «пицца и напиток».

💡 Блюда или группы — что выбрать. В кассе условие обычно задают конкретными блюдами: тогда бери «Требуемые блюда», и достаточно любого из выбранных. Группы удобнее, когда условие про целую категорию — «любой ролл». Заполнил и то, и другое — нужно и то, и другое. На требуемые блюда галочка «все группы сразу» не действует.

📏 Размеры. Поле «Размеры требуемых блюд» оставляй пустым, если подходит любой размер. Заполняй, только когда в кассе условие сужено — например «пицца 35 см». Если не заполнить, гость возьмёт 25 см, увидит «условие выполнено» и останется без подарка: зеркало окажется мягче кассы. То же и с подарком — у него свой выбор размера, и «фри малая» задаётся именно там.

⏰ Дни и часы считаются по времени торговой точки, а не по часам телефона гостя. Гость из другого города видит то же, что и гость за соседним столом.

Два условия «Счастливый час» в одной акции касса требует оба сразу, и Нямбот берёт их общее время: «с 12:00 до 18:00» и «с 15:00 до 22:00» дадут окно с 15:00 до 18:00. Если общего времени нет или в одном условии несколько интервалов, одним окном акцию не показать — она уходит в плашку «Из кассы».

Условие «Тип заказа»: только самовывоз или только курьер#

В iikoCard акцию можно ограничить способом получения: условие «Тип заказа» → «Доставка самовывозом» или «Доставка курьером». Так настраивают, например, «−10 % на самовывоз».

Нямбот читает это условие сам и переносит в зеркало:

  • покупатель видит на карточке акции пометку «Только при самовывозе» или «Только при доставке курьером»;
  • условие акции Нямбот считает выполненным только при этом способе получения. Пока покупатель способ не выбрал или выбрал другой, выгоду Нямбот не обещает: курьером касса такую скидку не даст;
  • в списке акций и в карточке в СРМ стоит метка «Только самовывоз» или «Только доставка курьером». Поля под неё в форме нет: способ задаёт касса, и меняется он в iikoCard.

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

Как касса считает порог «от суммы» — проверено пробами#

Коротко: у подарка порог сравнивается с суммой чека, а у процентной скидки — с ценами блюд по меню. Это сняли серией живых проб на кассе (17–18.08.2026), потому что документация iiko базу порога не называет нигде.

  • Подарок: комбо считается своей ценой, а не ценами составляющих. Два набора по 800 ₽ — это 1 600 ₽ для порога «от 2000 ₽», даже если блюда внутри стоят по меню 2 360 ₽. Подарка не будет, и Нямбот честно покажет «осталось добрать 400 ₽».
  • 🔴 Процентная скидка сработает раньше, чем покажет Нямбот. Её порог касса считает по ценам блюд, до скидки набора: на тех же двух наборах «−15 % от 2500 ₽» уже сработала (2 360 + напитки ≥ 2 500), хотя чек был 2 240 и Нямбот ещё просил добрать. Гость получит скидку, которую карточка обещала только «после добора» — в чеке он не потеряет, но и добирать ему было не нужно. Если в твоих акциях есть и комбо, и процентная скидка от суммы — проверь пару чеков на кассе, прежде чем рассказывать о пороге гостям.
  • База процентной скидки — только блюда вне набора. На чеке из двух наборов и двух напитков по 320 ₽ скидка −15 % составила 96 ₽, то есть посчиталась с 640 ₽ напитков: блюда внутри набора и подарки в базу не вошли.
  • Подарки порог не кормят. Если гость сам положил в корзину блюдо, которое акция даёт в подарок, касса сделает его бесплатным — и чек станет меньше. Порог «от суммы» проверяется уже ПОСЛЕ этого: блюдо за 570 ₽, ставшее подарком, из суммы выпадает. Нямбот считает так же и лишнего не обещает.
  • Подарки разных акций складываются. Если корзина выполняет условия двух акций с подарками, касса даст оба — по одному на каждую акцию, а внутри акции ещё и по кратности, если она включена.

🔍 Если сверяешь с трассой расчёта iiko: число actual у условия «Сумма заказа» считается по ценам меню. Для процентной скидки решает именно оно, а для подарка — нет: условие может «сойтись», а подарка не будет, потому что чек оказался меньше порога.

Как завести#

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

Заводить самому нужно, только если карточки нет:

  1. Сначала настрой саму акцию в кассе — в iikoCard. Деньги считает она, и без неё зеркало показывает прогресс в никуда.
  2. В Нямботе: Маркетинг → Акции → Создать, тип — «Акция кассы».
  3. Заполни условие теми же цифрами, что в кассе.
  4. Если по акции полагается подарок — выбери блюдо в поле «Блюдо-подарок из акции кассы». Оно нужно, только чтобы гость увидел, что получит; в заказ Нямбот его не добавляет.
  5. Оформи один пробный заказ и сверь: гость дошёл до условия — касса дала скидку.

⚡ Плашка «Из кассы» на вкладке «Акции» — там видно, что настроено в кассе, но до покупателя не дошло. Кампании в ней трёх видов:

  • карточку можно завести одной кнопкой — Нямбот кампанию прочитал, а карточки нет. Так бывает после удаления: удалённую карточку синхронизация не воскрешает (иначе убрать её было бы нельзя), а вернуть — одна кнопка «Завести карточку»;
  • показать нельзя — разбор не осилил условие, и причина названа прямо: купон, кратность «каждая третья», комбо, баллы, «Тип заказа» с уточнениями, несколько размеров у подарка, несколько подарков разными действиями, незнакомая настройка. Наведи на метку — подсказка скажет, что поправить в кассе. Ложная карточка хуже отсутствия карточки: она пообещала бы гостю то, чего в кассе нет;
  • блюда нет в меню — условие прочитано, но блюда из условия или размера подарка нет в меню точки. Синхронизируй меню или проверь артикул блюда в кассе — карточка появится сама на ближайшей синхронизации.

Пусто в плашке — она так и пишет: «всё дошло до покупателя». Молчащий блок неотличим от сломанного, поэтому она отвечает всегда.

💡 Механики со своим разделом в плашку не попадают: баллы — вкладка «Баллы кассы», купоны — «Купоны кассы», автоматические скидки — «Скидки iikoCard на блюда» и «Скидки iikoOffice», комбо — меню.

🔴 Главное: условие ведёт касса, а карточку — ты#

Если карточка сделана из кампании кассы (синхронизацией или кнопкой «Завести карточку»), её условие Нямбот держит в том же виде, что и касса. На каждой синхронизации он сверяет акцию iikoCard с зеркалом и сам переносит всё, что разошлось:

  • порог суммы, скидку, число блюд и кратность подарка;
  • блюда и категории условия, блюдо-подарок и его размер;
  • сроки акции и часы «Счастливого часа»;
  • способ получения из условия «Тип заказа».

Эти поля в форме заперты: меняются они в iikoCard, а до гостя доезжают сами. Твоё в карточке — название, описание, фото и переключатель показа. Их синхронизация не трогает никогда.

Когда акция в кассе перестаёт работать, карточка скрывается от гостей сама и возвращается тоже сама:

Что случилось в кассеМетка в СРМКак вернуть
Акцию выключили — саму, всю её программу, или у программы кончился срок«Скрыта: акция выключена в кассе»включи акцию или программу в iikoCard
Акцию удалили«Скрыта: акции нет в кассе»верни акцию в кассе или удали карточку
В акцию добавили настройку, которую Нямбот не читает«Скрыта: условие не читается»убери настройку в кассе
Условие прочитано, но блюда или размера подарка нет в меню точки«Скрыта: нет в меню»синхронизируй меню или проверь артикул и размеры блюда в кассе

Пропажу акции Нямбот ещё и присылает тебе уведомлением.

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

  • зеркало обещает больше, чем даёт касса — гость добрал корзину до 1500 ₽, а в кассе порог уже 2000 ₽, и скидки в чеке нет;
  • зеркало строже кассы — скидку касса даст, но гость о ней не узнал заранее и мог не собрать корзину вовсе;
  • акцию в кассе выключили, а зеркало осталось — гость видит акцию, которой больше нет.

Поменял акцию в кассе — зеркало обновится само#

На ближайшей синхронизации Нямбот перенесёт новое условие в зеркало и повесит на акцию оранжевую метку «Кампания изменилась». Это уведомление, а не задание: условие уже новое, поправлять его руками не нужно.

Зачем тогда метка. Название, описание и фото остались твоими, и они могли разойтись с новым условием. Было «Подарок от 1500 ₽», порог в кассе подняли до 2000 ₽ — прогресс гость увидит верный, а название карточки по-прежнему обещает 1500 ₽. Метка напоминает посмотреть на карточку глазами гостя.

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

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

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

Когда касса подтверждает выгоду#

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

Так сделано ради скорости и ради самой кассы: у iiko лимит пять обращений в минуту на ключ, общий на все точки сети. Раньше одна корзина съедала до восьми обращений, и два покупателя, одновременно листающих меню, могли положить интеграцию для всей сети.

Что это значит на экране покупателя:

  • в корзине подарок показан карточкой акции по зеркалу — Нямбот обещает его от твоего имени;
  • 🔴 по блюду, которое покупатель положил в корзину сам, зеркало молчит. Касса на такую строку может не выдать подарок, а обнулить купленное (см. главное правило подарка) — сколько единиц она занулит, а сколько добавит сверху, заранее не сосчитать. Выгоду покупатель увидит на оформлении, живым ответом кассы: показать меньше можно, больше — никогда;
  • на оформлении числа перерисовываются теми, что подтвердила касса. Если она чего-то не подтвердила, покупатель видит об этом прямую подпись — например, «Заведение не подтвердило подарок «Лимонад домашний»»;
  • сумма всегда кассовая: зеркало на неё не влияет.

🔴 Отсюда цена расхождения. Раз обещание в корзине строится по зеркалу, а не по кассе, устаревшее зеркало покупатель видит СРАЗУ. У карточки из кампании кассы окно расхождения короткое: от правки в iikoCard до ближайшей синхронизации гость видит прежнее условие, дальше — новое. У зеркала, заведённого руками, это окно длится, пока ты его не поправишь.

Две акции сразу на одну корзину — касса их складывает#

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

Механизма «приоритет акции» в iikoCard нет вовсе; единственный настоящий рычаг — галочка «Не применять другие скидки к позициям комбо».

«Первый заказ» — их два, и они разные#

Условие «только новому гостю» есть и в iikoCard, и в Нямботе — но считают они разные множества гостей:

Где условиеЧто считается первым заказом
iikoCardпервый заказ гостя в кассе, включая зал и заказы по телефону
Нямбот, переключатель «Кому доступна»первый заказ через Нямбот

Гость, который вчера ужинал в зале, для Нямбота новый, а для кассы — нет. Включишь переключатель в зеркале — он увидит акцию, а скидки в чеке не будет.

Правило: поставил условие «новому гостю» в iikoCard — переключатель в Нямботе не трогай. Считать будет касса.

Чего зеркалом не показать#

  • Накопительные акции между заказами («пятый кофе в подарок» по карте гостя). Зеркало считает по текущей корзине и о прошлых заказах ничего не знает — касса эти данные не отдаёт. Такую механику Нямбот не показывает и показывать не будет; вместо неё бери купоны: покупатель вводит код и сразу видит подарок.

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

    Галочка «Может сработать несколько раз в 1 заказе» у акции с подарком — другое дело: она зеркалится. Гость видит карточку акции, а сколько подарков ему положено на его корзину, называет касса при расчёте.

  • Размер выгоды. Зеркало никогда не пишет «−300 ₽»: сумму называет касса при оформлении, и до её ответа Нямбот её не знает.

  • «Тип заказа» с уточнениями — конкретные типы заказа, источник, район, улица или город. Зеркало знает только способ получения, см. Условие «Тип заказа».

Зеркало и сумма заказа#

Зеркало — витрина. Оно не меняет итого, не участвует в расчёте и не складывается с другими акциями. Всё, что относится к деньгам на iiko-точке, приходит из кассы:

Коротко#

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