Статья предоставляет пошаговые инструкции для решения распространенных проблем с использованием плагина 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 😃