Установка плагина для iiko
Для работы с объемным списанием на терминалы, где работают бармены, необходимо установить плагин для работы. Вы можете установить плагин самостоятельно или попросить нашей помощи, обратившись в поддержку: Как связаться с тех.поддержкой
Для выполнения установки понадобится API токен, который можно получить в нашей техподдержке.
Один плагин обязательно должен быть установлен на главной кассе, если помимо главной кассы есть ещё терминалы, где работают с алкоголем, то также установить везде.
Инструкция по установке
Скачайте файл https://cdn.dxbx.ru/iiko/updater/Setup.exe и запустите его двойным кликом по иконке. Дальнейшие действия зависят от сообщения, которое выведет установщик:
Если установщик выведет сообщение «iikoFront найден», переходите к следующему шагу.
Если установщик выведет сообщение «Папка iikoFront не найдена», то нажмите на кнопку «Изменить папку…» и выберите папку с iikoFront на вашем компьютере вручную.
Подсказка: на рабочем столе зачастую есть ярлык iikoFront — можно нажать на него правой кнопкой мыши, кликнуть на кнопку «Свойства» и в открывшемся окне посмотреть путь до файла в строке «Рабочая папка».
2. Найдите в списке ниже кнопки «Изменить папку…» плагин в статусе «Не установлен». Дважды кликните на него.
3. В открывшемся окне необходимо заполнить следующие пункты:
Лицензия — если вы используете лицензию от iiko, то выберите ApiPayment, если вы используете нашу лицензию, то выберите iikoConnector for DocsInBox Marking.
API токен Марк. — нужно вставить ваш API токен в это поле, если у вас подключено списание пива в Честный Знак через DocsInBox. В первой строке обязательно нужно указывать то юрлицо, которое реализует разливное пиво.
API токен ЕГАИС — нужно вставить ваш API токен в это поле, если у вас подключено списание крепкого алкоголя в ЕГАИС через DocsInBox.
Главная касса — выставьте «Да», если плагин устанавливается на главную кассу. В остальных случаях оставьте «Нет».
Важно: одна из касс обязательно должна быть главной.Hard mode ЧЗ — при выборе «Да» при добавлении в заказ блюда с пивом сразу запрашивается кран и объем.
При выборе “Нет” указывать кран и объем для блюда можно в любой момент, пока заказ открыт.Hard mode ЕГАИС — не влияет на функциональность, можно выбирать любое значение.
4. После заполнения нажмите на кнопку «Установить».
Автообновление не всегда корректно работает на Windows 7. Может появляться данная ошибка, как на скриншоте:
В этом случае необходимо обновить версию .NET Framework. Скачать нужную версию можно здесь: https://dotnet.microsoft.com/en-us/download/dotnet-framework/thank-you/net472-web-installer
Если это не помогло, то нужно обновить версию Windows.
5. Когда установка будет завершена, проверьте, что в списке в столбце «Статус» значится «Обновлён».
6. После настройки плагина, необходимо перезагрузить iikoFront. Достаточно через комбинацию клавиш Alt+F4 закрыть iikoFront и открыть снова. Если такой возможности нет, то можно перезагрузить кассу.
Таким образом мы закончили установку плагина.
При запуске iiko front выводится сообщение об успешном запуске плагина.
При успешном запуске на экране заказа отобразится кнопка DxBx.
Обновление плагина для iiko
Запустите файл Setup.exe на устройстве, где необходимо обновить плагин. Файл, если вы не можете найти его на устройстве, можно скачать здесь: https://cdn.dxbx.ru/iiko/updater/Setup.exe
Если версия актуальная, в столбце «Версия» и «Доступно» будут одинаковые значения. Если значения разные и обновление не происходит автоматически, то выключите апдейтер и снова его включите. Когда плагин обновиться перезапустите iiko.
Конфигурирование плагина для iiko
После скачивания плагина вы можете произвести более точную настройку.
Для этого нужно перейти по адресу C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\Get.Front.DxBxExciseStamps
Для редактирования настроек нужно открыть файл - Get.Front.DxBxExciseStamps.dll.config любым удобным редактором текста (например Блокнот).
После открытия файла в текстовом редакторе вы увидете текст содержаший настройки параметрам.
Перечень параметров доступных для конфигурирования:
Параметр | Описание | Пример заполнения |
---|---|---|
RequestsTimeOut | Время ожидания ответа на запрос сервера | 00:01:30 |
IsHardModeHardAlco | ! Не используется Включение/отключение Hard Mode для ЕГАИС | True False |
IikoUserPIN | Пин-код пользователя для авторизации плагина в системе | 12344321 (Пользователь централизованной доставки) |
IsMainCashDesk | Признак главной/ведомой кассы | True False |
XDxBxBeerUrl | Адрес сервера для работы с маркированной продукцией | https://dxbx.ru/api/integration/marking/v1/ |
CheckPeriodInSec | Таймер опроса нашего сервера на наличие обновление, в секундах | 300 |
ShelfLifeOrder | Время жизни чеков, которые не были отправлены из-за ошибки сервера ЕГАИС, в часах | 24 |
DxBxBaseUrl | Адрес сервера для работы с ЕГАИС | https://dxbx.ru/api/integration/egais/v2/ |
DxBxToken | Токен авторизации на сервере для работы с маркированной продукцией. Может быть несколько токенов. | Один токен: 00000000-0000-0000-0000-000000000000 Два и более токенов: 00000000-0000-0000-0000-000000000000, 00000000-0000-0000-0000-000000000000 Разделителем является запятая. Если указано несколько токенов, то по каждому будет запрашиваться доступ в кабинет Честного знака, если есть настройка в DxBx. |
IsHardModeBeer | Включение/отключение Hard Mode для Маркированной продукции | True False |
DxBxHardAlcoToken | Токен авторизации на сервере для работы с ЕГАИС. может быть только один. | 00000000-0000-0000-0000-000000000000 Если оставить поле заполненное нулями(как в примере) или сделать его пустым, тогда для работы ЕГАИС будет автоматически использован первый токен из поля DxBxToken, даже если их там указано несколько. |