Редактирование: установка-плагина

Путь: 02_Настройка_iiko/установка-плагина.md

Содержимое (Markdown)

# Установка плагина 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=Все
```

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

```cmd
%SystemRoot%\System32\netsh.exe http add urlacl url=http://*:8002/ user=Everyone
```
или
```cmd
%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»).

Отмена