База знаний
База знаний MCRM

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


Плагин устанавливается на 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 можно найти под кнопкой Дополнения
Кнопка Marketing CRM - проверка связи и изменение параметров подключения.
После изменения параметров необходим перезапуск iikoFront
MCRM Регистрация гостя - добавление нового клиента в систему лояльности. Необходимо ввести обязательные данные для успешной регистрации.
Регистрация - это не чекин клиента в заказ, а именно создание нового клиента в базе MCRM и вашей программе лояльности.
MCRM Редактирование гостя - изменение анкетных данных зарегистрированного клиента.
Изменению не подлежат - номер карты, телефон и дата рождения
Начисление бонусов MCRM - зачисление бонусов на выбранный бонусный счет гостя без создания заказа (ручное начисление бонусов)
Перед выполнением операции редактирования и начисления бонусов необходимо произвести чекин гостя
Инструкции