настройка iiko config

Настройка iiko Config (удалённая конфигурация плагина)

Инструкция описывает удалённую конфигурацию плагина ReMarked для касс iiko и права пользователя интеграции продаж, без которых не работает автоматическая выгрузка меню.

Общие сведения

Начиная с версии 2.1.0 плагин ReMarked для касс на платформе iiko использует удалённый конфиг, настраиваемый на стороне ReMarked. В конфигурационный файл iiko указывается только токен для получения конфигурации — он отличается от токенов системы броней и системы лояльности.

Для настройки конфигурации необходимо создать приложение «Конфигурация плагина для IIKO» с типом приложения «Другое». Приложение создаётся уникальным для каждой кассы, на которую устанавливается плагин.

Данные, отправляемые в сторону iiko, собираются из нескольких приложений и интеграций. Основной объём настроек находится в приложении «Конфигурация плагина для IIKO», часть настроек берётся из приложения «API Системы лояльности Remarked» (синхронизация между приложениями происходит через токен приложения лояльности).

Параметры приложения «Конфигурация плагина для IIKO»

Параметр Назначение
Псевдоним кассы Название кассы для понимания, что это за касса (внутреннее использование)
Логин AnyDesk Данные для подключения к кассе (внутреннее использование)
Пароль AnyDesk Данные для подключения к кассе (внутреннее использование)
Ключ приложения Токен, устанавливаемый в конфиг кассы для получения настроек
Модуль резервов Включает/отключает модуль работы с бронями (включать только на главных кассах во избежание ошибок и дублирований)
Адрес WS Адрес веб-сокета, к которому подключается касса. Важные значения — порт (см. таблицу распределения портов) и токен для подключения (берётся из приложения «IikoFront Брони»)
Время переподключения WS Время, через которое касса попробует переподключиться при обрыве. По умолчанию 20 секунд, без необходимости не менять
Работа с предзаказами Включает/отключает обработку плагином предзаказов, созданных при бронировании в ReMarked
Модуль лояльности Включает/отключает модуль работы с программой лояльности ReMarked
Чекин гостей Включает/отключает поиск гостей и добавление их к заказу
Получать скидки после чекина Включает/отключает запрос на расчёт скидок и подарков сразу после чекина гостя
Проверка баланса Включает/отключает просмотр баланса гостя на кассе
Добавление гостей Включает/отключает создание гостя в ПЛ прямо на кассе
Списывать баллы Включает/отключает процессы списания/начисления баллов
Промокоды Включает/отключает работу с промокодами
EndPoint для лояльности Адрес, на который приходят запросы для ПЛ. Не трогать без необходимости
EndPoint для IIKOData Адрес, на который приходят запросы для передачи номенклатуры. Не трогать без необходимости
Токен системы лояльности Токен взаимодействия с системой лояльности (берётся из приложения «API Системы лояльности Remarked»)
GUID скидки Идентификатор скидки из iiko — берётся из лога плагина при первом запуске или предоставляется клиентом
Порт Waiter Порт, используемый локально на кассе для взаимодействия сервера waiter и плагина
Получать гостей из IikoTransport Включает/отключает получение гостей из iikoTransport
Токен IikoTransport Ключ авторизации в iikoTransport
Организация IikoTransport Идентификатор организации в iikoTransport
Активность Указывает, что конфиг активен и его можно получить

Параметры из приложения «API Системы лояльности Remarked»

Параметр Назначение
Подтверждение списания баллов Включает/отключает подтверждение списания баллов гостем через сообщение
Доступные варианты получения гостя Влияет на показ официанту полей ввода номера карты и номера телефона

Логика «Доступные варианты получения гостя»:

  • Если не выбран ни один вариант — включены оба варианта.
  • Если выбраны «Номер карты» и/или «Динамический номер карты» — показывается окно для ввода номера карты.
  • Если выбран «Номер телефона» — показывается окно ввода номера телефона.

Обновление настроек

  1. Внести правки в приложении конфигурации и сохранить.
  2. Перезапустить iiko.

Права пользователя интеграции продаж в iikoOffice

Без перечисленных прав автоматическая выгрузка меню не работает. Назначьте пользователю интеграции продаж следующие права.

Код Описание
B_SALE Работа с розничными продажами
B_APT Просматривать типы оплаты
B_CUDS Работать с дисконтной системой
B_RPT Просмотр отчётов
B_CASR Просматривать отчёты по продажам
B_VN Просмотр номенклатурных справочников
B_EN Редактирование номенклатурных справочников

Если в сети используется iikoChain — настройки прав, скидок и типов оплаты выполняются в iikoChain, затем синхронизируются с iikoOffice.

Динамические карты

  1. Выполнить стандартную настройку «Конфигурации плагина iiko».
  2. В приложении «API Системы лояльности Remarked» → «Доступные варианты получения гостя» выбрать «Динамический номер карты» (см. скриншот в исходной инструкции).