База знаний
Поддержка
База знаний MCRM

Настройка интеграции с iiko

👉🏻 Настройка
👉🏻 Настройка Waiter
👉🏻 Интерфейс
👉🏻 Дополнения
💡 Что нового в текущей версии 3.3.0
Скачайте MCRM плагин для iikoFront (v.3.3.0)
Плагин устанавливается на iikoFront версий от 8.0 и выше.
Для работы с внешней системой лояльности необходимо приобрести лицензию iikoFrontPaymentPlugin.

Настройка

Шаг 1. Распаковать архив

Создайте новую папку MCRM и поместите файлы из архива в нее.
Папка должна называться именно MCRM, без каких-либо дополнительных символов.

Шаг 2. Первый запуск iikoFront

· Запустите Front.
· Дождитесь сообщения "MCRM: Ошибка авторизации. Плагин не запущен".
· Закройте Front.
На этом шаге плагин создает конфигурационный файл.

Шаг 3. Редактирование конфигурационного файла

Откройте конфиг плагина MCRM_Plugin_Config.xml и внесите в него данные поключения.
MCRM_Plugin_Config.xml

CRM_url - адрес сервера
CRM_apikey - токен предприятия
CRM_oauth_key - токен предприятия для регистрации клиентов с Front'а
  • эти данные необходимо получить у сотрудника MCRM

ConfirmDebitBonusWithSms - параметр для включения авторизации списания бонусов по коду из смс:
true - отправлять код по смс
false - списывать без авторизации

iikoWaiterPort - порт по которому плагин будет слышать Waiter

InterceptCardRoll - параметр отвечающий за перехват прокатанной (отсканированной) карты:
true - по умолчанию, прокатанная карта автоматически перехватывается плагином MCRM
false - если нужно отключить перехват. В такой конфигурации для авторизации гостя необходимо использовать кнопку плагина MCRM в заказе

Шаг 4. Создать скидку

Создать скидку как на скриншоте:
  • снять галочки "Можно назначать вручную" и "Можно назначать по карте;
  • выставить 1% на все меню.

Шаг 5. Завести внешний тип оплаты

Создать тип оплаты как на скриншоте:
  • в поле "Безналичный тип" обязательно выбрать MarketingCRM_Pro. Если такого варианта в списке нет, вернуться к шагу 2. Этот тип регистрируется при первом запуске Front'а;
  • выставить галочку: "Поводить как скидку" и выбрать скидку с Шага 4 (или Plazius).

Шаг 6. Запустить Front от Администратора

Готово! Плагин настроен и готов к работе.

Waiter

Настроим интеграцию с iikoWaiter.
· Редактируем конфиг. файл WaiterServerConfig.json.
· В поле Url прописываем адрес плагина MCRM (/ в конце обязателен): http://localhost:3000/MCRM/
Порт указывается тот, что прописан в файле MCRM_Plugin_Config.xml в параметре iikoWaiterPort (Шаг 3).
· В полях BonusPaymentTypeId и DepositPaymentTypeId вписываем id типа оплаты, созданного на Шаге 5.
Самый простой способ добыть id типа оплаты MCRM - скопировать его из файла логов MCRM плагина.
· Сохраняем сделанные изменения в конфиг. файлe WaiterServerConfig.json.
Готово!
Проверим связь. В браузере на компьютере с iikoFront и плагином Waiter открываем настройки: localhost:8100/settings
В секции External Loyalty будут отображены данные, которые мы заполнили при настройке интеграции с iikoWaiter в конфиг. файле.
  • Проверяем соединение (кнопка Check connection)
  • Видим сообщение:
Сообщение c localhost:8100:
Successfully connected.

Интерфейс

Добавление карты в заказ

Все манипуляции с картами осуществляются через кнопку MCRM в нижней панели iikoFront.
В модальном окне выбрать "Авторизация гостя".
Авторизовать клиента можно:
  • по номеру карты;
  • по номеру телефона;
  • по скану qr-кода.
Сразу после авторизации карты появятся модальные окна с персональными акциями / предложениями по гостю (если у него они есть).
Данные акции в дублируют на пречеке, печатается текст сниппета акции.
После закрытия модального окна с акциями гостя показывается основная информация.
· Первый блок - данные клиента со статистикой.
· Балансы бонусных счетов клиента:
Баланс карты - основной счет клиента (дефолтный, используется всегда). На этот счет зачисляются бонусы за покупки.
Акции / Доп.счет 1 (названия могут быть произвольные) - дополнительные опциональные счета, которые могут использоваться как депозит, счетчики, акционные счета.
· Данные о максимальном начислении и возможном списании для клиента в данном заказе.
При нажатии "ОК" карта добавляется в заказ.
В заказе с добавленной картой через кнопку MCRM можно выполнить следующие действия:
  • посмотреть информацию о клиенте;
  • отвязать карту от заказа;
  • ввести промокод (для добавления акционного блюда со 100% скидкой);
  • отправить клиенту СМС со ссылкой на установку персональной Wallet-карты.
СМС со ссылкой на карту отправится в случае использования канала СМС в MCRM и достаточном количестве средств на коммуникационном балансе предприятия.

Оплата

В режиме "Касса" выбираем "Безналичный расчет".
Выбираем бонусный счет для списания. Оплачивать бонусами можно только с одного счета.
Остаток суммы закрываем деньгами на нужный тип оплаты.
Если включена опция верификации списания бонусов, то при попытке списания появится окно, в котором нужно нажать "ОК" для отправки проверочного кода по СМС.
И ввести проверочный код.

Дополнения

Другие возможности плагина MCRM можно найти под кнопкой "Дополнения".
1 Marketing CRM
2 Начисление бонусов
3 Обновление
4 Отправка логов
5 Отправка скидок
6 Регистрация гостя
7 Редактирование гостя

Кнопка № 1 Marketing CRM

Редактирование конфиг. файла для настройки подключения.

  • Адрес сервера
  • Токен
  • oauth Токен

  • Текст на чеке - добавление произвольного текста для клиентов программы лояльности.
⚠️ После ввода или просмотра значений в окнах (адрес сервера, токен и oauth токен) выходим через кнопку ОК!
Кнопка Отмена - стирает данные настроек
  • Проверка связи - тестирование подключения.
После изменения параметров необходим перезапуск iikoFront

Кнопка №2 MCRM Начисление бонусов

Зачисление бонусов на выбранный бонусный счет гостя без создания заказа (ручное начисление бонусов).

Кнопка №3 MCRM Обновление

Проверка наличия новых версий плагина и обновление до актуальной версии.
После изменения параметров необходим перезапуск iikoFront.

Кнопка №4 MCRM Отправка логов

Отправка логов поддержке MCRM.
Отправляются:
  • api.log
  • cash-server.log
  • error.log
  • plugin-MCRM.log
  • virtual-printer.log
  • MCRM_Plugin_Config.xml

Кнопка №5 MCRM Отправка скидок

Отправка заведённых в iiko скидок поддержке MCRM с их названиями и идентификаторами.
В последующем данные скидки можно добавлять клиентам при проведении стимулирующих мероприятий.

Кнопка №6 MCRM Регистрация гостя

Добавление нового клиента в систему лояльности.
Необходимо ввести обязательные данные для успешной регистрации (обязательные поля помечены символом *).
Регистрация - это не чекин клиента в заказ, а именно создание нового клиента в базе MCRM и вашей программе лояльности.

Кнопка №7 MCRM Редактирование гостя

Изменение анкетных данных зарегистрированного клиента.
Изменению не подлежат - номер карты, телефон и дата рождения.
Перед выполнением операции редактирования и начисления бонусов необходимо произвести чекин гостя.
По всем возникшим вопросам при настройке обращайтесь к нам через Телеграм.
2023-10-17 16:02 Инструкции