Установка плагина ReMarked на iiko

Инструкция описывает установку и обновление плагина ReMarked Loyalty на кассы iikoFront, а также дополнительную настройку для совместной работы с мобильным официантом iikoWaiter.

Подготовка к установке

Технические требования

• iikoFront не ниже версии 8.7.
• Активная лицензия API Payment на всех терминалах, на которые планируется установка.
• Доступы AnyDesk (желательно с паролями) ко всем терминалам ввода заказов — кассам и официантским станциям.
• Настроенная скидка для плагина (см. «Настройка скидки и типа оплаты»).

Порядок установки

1. Настроить конфигурацию кассы по инструкции «Настройка iiko Config» (создать приложение «Конфигурация плагина для IIKO» и получить ключ конфигурации).
2. Скачать последнюю версию плагина из папки поставки (Google Drive).
3. Подключиться к кассе по AnyDesk.
4. Разархивировать плагин в папку на кассе:

   C:\Program Files\iiko\iikoRMS\Front.Net\Plugins

5. Переименовать папку с плагином в формат с датой установки:

   BeOpen.Front.Remarked.JsonRpc_240531

   где 240531 — дата установки в формате ГГММДД.

6. В файле конфигурации BeOpen.Front.Remarked.JsonRpc.dll.config в разделе ConfigToken указать ключ, полученный при настройке конфигурации кассы.
7. Перезагрузить iikoFront.
8. Убедиться, что плагин запустился — появилось сообщение «Remarked plugin has been started».
9. Получить GUID скидки (см. ниже) и добавить его в конфигурацию кассы.
10. После перезагрузки в iikoOffice выполнить настройку типа оплаты.
11. Перезагрузить iikoFront ещё раз.

Получение GUID скидки

GUID скидки, заданной в iikoOffice, можно получить двумя способами.

Способ 1 — через iikoTransport (см. скриншот в исходной инструкции).

Способ 2 — через логи плагина:

1. После установки плагина перейти в папку:

   %appdata%\iiko\CashServer\Logs

2. Найти файл plugin-BeOpen.Front.Remarked.JsonRpc_240531.log, где 240531 — дата установки в формате ГГММДД.
3. Открыть его любым текстовым редактором.
4. Найти строку:

   =========== Available flexible sum discounts types ===========

5. Ниже перечислены GUID-ы и названия всех доступных скидок. Найти нужную скидку и скопировать её GUID.

Возможная ошибка при установке (резервирование порта)

При установке может возникнуть ошибка резервирования URL-адреса:

ERROR: Sended command: %SystemRoot%\System32\netsh.exe http add urlacl url=http://*:8002/ user=Все

Решение — вручную выполнить команду в консоли с корректным именем группы пользователей:

%SystemRoot%\System32\netsh.exe http add urlacl url=http://*:8002/ user=Everyone

или

%SystemRoot%\System32\netsh.exe http add urlacl url=http://*:8002/ user=Всё

Дополнительная настройка для iikoWaiter

iikoWaiter — мобильный модуль iiko (Android/iOS), обеспечивающий доступ к функционалу iikoFront (создание, редактирование и оплата заказов, меню, столы, синхронизация с сервером). Если модуль лояльности используется совместно с iikoWaiter, выполните дополнительные настройки.

1. Запустить iikoFront с установленными плагинами.
2. Перейти в браузере по адресу:

   http://localhost:8100/settings

3. Выключить использование лояльности «Card5 Loyalty» (1).
4. В поле «Server address» раздела «External Loyalty» вставить адрес (2):

   http://localhost:{port}/Remarked/

   где {port} — порт waiter из настроек плагина.

5. Включить использование лояльности «External Loyalty» (3).
6. Проверить подключение к сервису лояльности (4).
7. Если подключение успешно — сохранить настройки Waiter.

Адрес сервера и конфиг iikoWaiter

• Адрес сервера PrimeHill:

  http://127.0.0.1:8115/

• Расположение конфига:

  \AppData\Roaming\iiko\CashServer\PluginConfigs\WaiterServer\WaiterServerConfig.json

  В этом файле можно прописать адрес сервера и включить лояльность (см. скриншоты в исходной инструкции).

Обновление плагина

1. Получить ключ конфигурации кассы — из прошлой установки плагина или из приложения «Конфигурация плагина для IIKO».
2. Скачать последнюю версию плагина из папки поставки.
3. Подключиться к кассе по AnyDesk.
4. Разархивировать плагин в C:\Program Files\iiko\iikoRMS\Front.Net\Plugins.
5. Переименовать папку с плагином в BeOpen.Front.Remarked.JsonRpc_240531 (дата установки ГГММДД).
6. В файле BeOpen.Front.Remarked.JsonRpc.dll.config в разделе ConfigToken указать ключ конфигурации кассы.
7. Остановить iikoFront.
8. Удалить старую папку с плагином.
9. Запустить iikoFront.
10. Убедиться, что появилось сообщение «Remarked plugin has been started».

Снятие логов плагина

1. Подключиться к кассе по AnyDesk и перейти в режим передачи файлов.
2. Перейти в папку:

   %appdata%\iiko\CashServer\Logs

3. Найти файлы plugin-BeOpen.Front.Remarked.JsonRpc_240531.log (за сегодняшний день) или архивы вида 2024-05-31-plugin-BeOpen.Front.Remarked.JsonRpc_240531.zip, где первые цифры — дата, за которую находятся логи.
4. Скачать файлы двойным кликом.

Для автоматического сбора логов удобно использовать ПО «Диагностика» (см. «Диагностика iiko»).