Частые вопросы по интеграции с iiko (FAQ)

Последние изменения: 05.11.2024

Статья предоставляет пошаговые инструкции для решения распространенных проблем с использованием плагина Resto.Front.Api.SamosalePlugin в системе iiko. Основные проблемы связаны с запуском плагина и ошибками совместимости с библиотекой "Newtonsoft.Json".


1. Что делать, если плагин не запускается?


Необходимо проверить следующее:

1) точно ли перенесли папку Resto.Front.Api.SamosalePlugin с файлами manifest и Resto.Front.Api.SamosalePlugin.dll скопировать в место установки фронта в папку Front.Net\Plugins (стандартный путь - C:\Program Files\iiko\iikoRMS\Front.Net\Plugins);

2) файл Resto.Front.Api.SamosalePlugin.dll разблокирован:


Зайдите в свойства плагина, как на скриншоте выше. Если будет аналогично тому, как на скрине выше, то нужно установить отметку в чекбоксе "Разблокировать" и применить.

3) нужно проверить, чтобы верный токен был указан в файле Samosale.config (\AppData\Roaming\iiko\CashServer\PluginConfigs\Resto.Front.Api.SamosalePlugin)



Токен берется из личного кабинета Samosale раздела Настройки–> Пользователи–> Пользователи.

4) по умолчанию названия файлов могут различаться, нужно поменять название файла .dll на то, которое прописано в manifest и тогда плагин должен заработать:

2. Что делать, если на кассе (iikoFront) возникает подобная ошибка?

При возникновении данной ошибки нужно добавить этот файл в папку плагина фронта (Program Files\iiko\iikoRMS\Front.Net\Plugins\Resto.Front.Api.SamosalePlugin). Данная ошибка появляется по причине того, что возникает проблема совместимости с библиотекой "Newtonsoft.Json". Новая версия iiko может требовать другую версию этой библиотеки, которая отличается от установленной.

Программа не смогла загрузить файл или часть сборки с названием "Newtonsoft.Json". Версия "Newtonsoft.Json", которую она пыталась использовать (версия 6.0.0.0) не соответствует той, которая была ожидаема. Это может быть связано с тем, что программа ожидала одну версию "Newtonsoft.Json", но нашла другую.


3. Как добавить QR-код для регистрации клиентов на пречеке iiko?

Нужно внести изменения в поле QR-код для нового гостя на дополнении к пречеку конфигурационного файла самостоятельно. 

<qrCodeLink>
<link>https://app.samosale.ru/pied_piper</link>;
<size01234>1</size01234>
</qrcodeLink>

Вместо https://app.samosale.ru/pied_piper необходимо добавить ссылку на вашу страницу регистрации (Настройки –> Страница регистрации –> Редактор в ЛК Samosale).

Вместо 1 вводите на ваше усмотрение число от 1 до 4. Это размер QR-кода (по умолчанию 1).

В новой версии плагина для вашего удобства были добавлены комментарии к коду в файле Samosale.config. В начале файла есть объяснение для каждого параметра, а также непосредственно перед каждым нужным участком кода



Если вы не нашли ответ на свой вопрос, задайте его нам в Telegram @SamosaleSupport_Bot 😃


Помогла ли вам статья?