Как подключить iiko к программе лояльности

Инструкция для владельца ресторана, кофейни или доставки на iiko. Доставка и самовывоз начинают работать сразу после подключения ключа, для зала добавляется плагин на кассовый компьютер. Как связка устроена в принципе — в обзорной статье как работает программа лояльности вместе с iiko.

Что понадобится

• Доступ в iikoWeb, чтобы создать ключ Cloud API.
• Доступ в iikoOffice, чтобы завести скидку.
• Для зала: iikoFront 9.5 или новее и лицензионный модуль плагинов. Есть ли он в вашей лицензии, подскажет менеджер iiko.

Шаг 1. Программа лояльности в Анкоре

Зарегистрируйтесь на ankora.pro и настройте программу: кэшбек, баллы или штампы, карта для Apple Wallet и Google Wallet. Сразу задайте лимит списания, например не больше 30 % заказа — именно он покажется официанту на кассе как «можно списать до». Если программа уже работает, переходите дальше.

Шаг 2. Ключ Cloud API в iikoWeb

В iikoWeb откройте «Внешние заказы» → «Настройки Cloud API» → «Добавить интеграцию». Укажите название и e-mail, выберите шаблон прав, на вкладке «Подключенные точки» отметьте ресторан. Ключ скопируйте иконкой рядом с маской вида 5e3******4c4.

Ключ создаётся именно в «Внешних заказах», а не в разделе «Интеграции» — это частая заминка.

Шаг 3. Ключ в Анкоре и проверка подключения

В кабинете Анкоры откройте «Интеграции» → «iiko» → «Подключить», вставьте ключ и сохраните. Нажмите «Проверить подключение»: Анкора подпишется на события заказов и загрузит список ваших касс.

Шаг 4. Привяжите кассы к точкам

В настройках интеграции для каждой кассы выберите точку Анкоры. Так заказы попадут в аналитику по точкам. Касса без точки не начисляет, а число точек ограничено тарифом: если касс больше, добавьте точки или перейдите на тариф выше.

Шаг 5. Скидка «Бонусы Анкора» в iikoOffice

Списание бонусов в iiko оформляется скидкой, поэтому её нужно завести один раз. В iikoOffice откройте «Дисконтная система» → «Скидки и надбавки» → «Добавить». Мастер проведёт по трём экранам.

1. Основные параметры. Название и название в пречеке — «Бонусы Анкора»: по нему мы узнаём списание в закрытом заказе. Тип — «Скидки и надбавки». Ограничения по сумме заказа и по периоду не включайте.
2. Настройки скидки. Включите «Можно назначать вручную» — без этой галочки скидки не будет ни у официанта, ни у плагина. Выключите «Можно назначать по карте», «Устанавливать автоматически» и «Выбор блюд на усмотрение официанта». Отметьте все места продаж и все режимы обслуживания, включая обе доставки.
3. Размер и тип. Метод применения — «К полной сумме заказа». Тип — «Скидка» и «Фиксированная сумма». Обязательно поставьте «Назначать сумму»: тогда сумму вводят на кассе. Если оставить «Процент», списание работать не будет.

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

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

Шаг 6. Плагин для зала

Этот шаг нужен, только если вы хотите начислять и списывать бонусы в зале. Доставка и самовывоз работают и без него.

1. На странице iiko в кабинете Анкоры, в блоке «Плагин для кассы iikoFront», нажмите «Скачать файл настроек» и скачайте папку плагина. В файле уже прописаны адрес Анкоры, ключ плагина и название скидки.
2. Скопируйте папку плагина в C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\ на кассовом компьютере.
3. Положите файл настроек рядом с плагином, в ту же папку.
4. Перезапустите iikoFront. На экране заказа появится кнопка «Анкора».

Если кнопки нет, дело чаще всего в лицензии: без модуля плагинов iikoFront не загружает плагин и ничего не сообщает, касса работает как обычно. Проверьте также версию iikoFront и то, что файл настроек лежит рядом с плагином.

Шаг 7. Тестовый заказ

Откройте заказ, нажмите «Анкора», введите телефон гостя, у которого есть карта и бонусы, спишите небольшую сумму и закройте заказ. В журнале интеграции появятся строки о списании и начислении, а гостю придёт push с новым балансом. Для доставки достаточно оформить заказ на телефон гостя: опознавать его вручную не нужно.

Что дальше

Возвраты настраивать не нужно: оформляйте их в iiko как обычно, Анкора сама снимет начисленное и вернёт списанные бонусы, в том числе при частичном возврате. Как всё это выглядит со стороны гостя и официанта, разобрано в обзоре как работает программа лояльности вместе с iiko.