Плагин OSMI Loyalty Scan для iikoFront

Плагин «OSMI Loyalty Scan» предназначен для совместной работы с приложением «OSMI Loyalty Scan», доступным для бесплатного скачивания с Google Play для Android смартфона. Плагин позволяет сканировать карту лояльности гостя и прикреплять ее к открытым заказам. Плагин совместим с системами лояльности iiko, iiko Card5 и MCRM Superkit.

Актуальная документация в виде PDF файла доступна ЗДЕСЬ

Установка и настройка плагина

1. Установите плагин в стандартную папку плагинов iiko. Обычно она на системном диске и называется C:\Program Files\iiko\iikoRMS\Front.Net\Plugins. Для этого распакуйте файл «OSMILoyaltyScan.zip» в папку «OSMILoyaltyScan».
Скачать актуальную версию плагина можно ЗДЕСЬ

2. Запустите iiko Front под учетной записью администратора системы. При запуске должны появиться сообщения о запуске плагина и режиме его работы. При первом запуске (если заранеее не была установлена лицензия на плагин) плагин запускается в демонстрационном режиме.

3.Войдите в iikoFront и нажмите кнопку «ДОПОЛНЕНИЯ» и затем «OSMI Loyalty Scan»
4.Откроется окно с информацией о плагине и режиме его работы. Если не установлена стандартная лицензия OSMI Cards для плагина или срок действия стандартной лицензии истек, то плагин работает в демонстрационном режиме. Если лицензия установлена и действует, то плагин работает в стандартном режиме.

  • В демо режиме, количество открытых заказов с прикрепленной через приложение картой лояльности ограничено одним заказом. Время действия демо лицензии не ограничено.
  • В стандартном режиме, количество открытых заказов с картами, прикрепляемыми через приложение, не ограничено. Срок действия лицензии будет определяться параметрами приобретенной лицензии.
  • Тип лицензии не влияет на ручное прикрепление карт к открытым заказам.
5. При первом запуске плагина он создаст файл конфигурации «osmi_loalty_scan_config.xml» в стандартной папке iiko конфигурации плагинов. Перейдите в папку «OSMILoyaltyScan».
6. Откройте файл «osmi_loalty_scan_config.xml» с помощью блокнота (notepad) или любого другого тексторого редактора.
  • ListenPort – Используйте это значение для настройки приложения на телефоне.
  • SystemID – Вам потребуется при запросе на получение стандартной лицензии.
  • UseCard5 - Если iiko используется с сиcтемой лояльности Card5 и новые гости попадают в систему через электронное анккетирование, то установите в true и заполните соответствующие секции Card5xx. Это требуется в ситуациях, когда клиент попал в iiko.biz через электронную анкету и получил карту, но никаких транзакций с новой картой на кассе еще не проводилось, а электронная карта уже предъявлена на кассе для первой транзакции. Если же установлен плагин MCRM для iiko, то установите в false и Card5xx секции заполнять не нужно.
В мобильном приложении в настройках укажите IP адрес и порт станции iiko Front, на которой установлен плагин, например как 192.168.20.20:8100

7. Если автоматическое обнаружение плагина мобильным приложением не сработало, то для настройки подключения к плагину с мобильного телефона вам потребуется IP адрес компьютера, на котором запущен iiko Front с установленным плагином. Узнайте его у своего администратора или определите сами, открыв на iiko Front командный терминал Windows через команду cmd и далее исполнив в открывшемся терминале команду ipconfig.

Получение стандартной лицензии

В демо режиме, плагин позволяет через мобильное приложение «OSMI Loyalty Scan» прикрепить не более одной карты лояльности к открытым заказам. Если к какому-либо открытому заказу уже была прикреплена карта лояльности, например вручную через iiko Front, то прикрепить еще одну карту к другому открытому заказу через приложение не получится.

Для снятия этого ограничения необходимо получить стандартную лицензию. Лицензия требуется для каждой установленной копии плагина. В точке устанавливается только один плагин, обычно на главной кассе. Количество мобильных приложений, подключенных к плагину, не лимитируется и не зависит от типа лицензии.
Для получения стандартной лицензии, отправьте запрос на почту licensing@osmicards.com. В письме укажите:
  • Название вашей организации
  • ИНН
  • Значение переменной SystemID из файла конфигурации плагина
После получения стандартной лицензии, скопируйте файл лицензии в папку конфигурации плагина, переименуйте файл в "license.lic" и перезапустите программу iiko Front.
Если нужна лицензия для нескольких точек, то отправьте запрос с соответствующими значениями SystemID из каждой точки. SystemID создается в момент установки плагина и уникален для каждого компьютера, на котором он устанавливается.