Misea
Pro

Если у вас iiko — бонусы на кассе

Как связать бонусы Misea с кассой iiko, чтобы кассир видел баланс гостя и списывал баллы при оплате.

Если у вас iiko — бонусы на кассе

Эта статья нужна, только если ваше заведение работает на iiko. Если кассы iiko у вас нет — пропустите её, программа лояльности Misea работает и без неё.

Задача: сделать так, чтобы кассир на кассе увидел того же гостя и тот же баланс, что и вы в Misea, и мог списать баллы при оплате.

Сначала — про то, кто считает баллы

Есть два расклада, и от него зависит всё дальнейшее.

Расклад 1 (по умолчанию): баллы считает Misea. Misea начисляет баллы по вашим правилам и сама выкладывает баланс гостя в iiko, чтобы кассир видел то же число. Ничего специально включать не надо.

Расклад 2: баллы считает касса. Подходит тем, у кого бонусная программа уже давно работает в iiko и переносить её никуда не хочется. Misea тогда ничего не начисляет — она показывает баланс, который ведёт iiko, и обновляет его у гостя на карте в телефоне.

Второй расклад включается по вашей просьбе поддержкой Misea, переключателя в панели управления для него нет.

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

Что нужно сделать на стороне iiko

Всё, что ниже, делается в самой iiko, а не в Misea. Названия пунктов у разных версий iiko немного отличаются — если у вас на экране написано иначе, ищите по смыслу или позовите своего iiko-партнёра: у него это занимает пятнадцать минут.

Порядок такой.

1. Включить модуль iikoCard

iikoCard — это отдельный облачный модуль iiko, который отвечает за гостей, карты и бонусы. Без него касса про бонусы ничего не знает.

Включается он в iikoOffice, в разделе лояльности, и там же есть страница проверки связи. Все строки на ней должны быть зелёными. Если какая-то красная — включение требует действий на серверной стороне iiko, это делает партнёр iiko или их поддержка. Дальше идти бессмысленно, пока не позеленеет.

2. Создать бонусную программу

Программы iikoCard живут на отдельном портале — iiko.biz. Это не iikoOffice, вход туда отдельный.

Создайте программу и обратите внимание на два поля:

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

3. Создать две акции внутри программы

Это шаг, который пропускают чаще всего, а без него ничего не работает.

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

  1. Начисление — действие «пополнить счёт на процент от заказа». Процент задаёте вы (например, 5%).
  2. Оплата бонусами — действие «оплата со счёта». Тут же можно ограничить, какую часть чека разрешено закрывать бонусами.

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

4. Попросить у нас адрес для уведомлений

Чтобы Misea узнавала о списаниях на кассе сразу, а не с задержкой, в настройках iikoCard прописывается адрес, на который iiko шлёт уведомления об изменении баланса.

Этот адрес у каждого заведения свой, и получить его можно только в поддержке Misea — самостоятельно собрать его нельзя, там есть секретная часть. Напишите нам, мы пришлём готовую строку, вы вставите её в iikoCard в поле для webhook-уведомлений.

Если этого не сделать, ничего страшного не произойдёт: Misea всё равно сверяет балансы с iiko каждые 10 минут. Разница только в скорости: гость увидит новый баланс не через секунду, а в пределах десяти минут.

Что Misea делает сама

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

  • заводит гостя в iikoCard, когда он у вас появляется;
  • выдаёт ему номер карты из 13 цифр — тот самый, что печатается на карте в телефоне под штрихкодом;
  • обновляет имя, фамилию, телефон, почту и дату рождения, когда гость их меняет;
  • держит балансы в согласии с кассой;
  • перерисовывает карту в телефоне гостя после каждого изменения баланса.

При первом подключении iiko Misea дополнительно подтягивает всю накопленную базу гостей за прошлые годы. Отдельной кнопки для этого нет и не нужно.

Проверка на кассе

  1. Откройте на кассе iikoFront новый заказ.
  2. Подставьте гостя: либо поднесите к сканеру телефон гостя с открытой картой, либо введите 13-значный номер карты вручную (он написан на карте под штрихкодом).
  3. На экране должны появиться имя гостя и его баланс.
  4. При закрытии чека должны быть кнопки начисления и оплаты бонусами.

Если что-то не так

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

Касса пишет «гость не найден». Проверьте в iiko.biz, есть ли там гость с таким номером карты. Если нет — попросите гостя открыть свой личный кабинет или сделать любой заказ, после этого Misea отправит его в iiko.

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

Баланс в Misea и на кассе разошёлся. Подождите 10 минут — сверка идёт сама. Если через 10 минут числа всё ещё разные, напишите в поддержку и укажите номер карты гостя.

Гость списал баллы на кассе, а в Misea баланс прежний. То же самое: либо адрес для уведомлений (шаг 4) не прописан, либо прописан с ошибкой. До исправления баланс подтянется сверкой в пределах 10 минут.

Что дальше