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

Последние изменения: 18.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. В начале файла есть объяснение для каждого параметра, а также непосредственно перед каждым нужным участком кода



4. Как сделать так, чтобы на надбавку не начислялся кэшбэк при оплате и она не участвовала в расчете итоговой суммы для списания бонусов?

С выходом новой версии плагина 1.4.0.0 от 24.09.2024 это стало возможным. Теперь надбавка передается нам вместе с чеком как отдельная позиция номенклатуры, и на нее можно выставлять запрет на начисление/списание по аналогии с тем, как мы это делали с товарами и категориями


Напомним, что надбавка создается в iikoOffice.

Пошаговая настройка надбавки:

◆ переходим Дисконтная система –> Cкидки и надбавки и нажимаем на кнопку "Добавить"


◆ указываем название и название в пречеке. Вбиваем в поле "Название" именно то наименование, которое вы хотите, чтобы у вас отображалось в чеке

◆ на втором шаге оставляем все настройки по умолчанию

◆ на следующем шаге выбираем тип "Надбавка" – "Процент" и задаем нужное вам значение в процентах. Жмем Далее


◆ выставлям отметку в чекбоксе "Активировать скидку" для активации нашей созданной надбавки. Нажимаем OK


После проделанных действий надбавка появится на кассе (iikoFront). После этого необходимо будет провести тестовую оплату.

➤ На кассе выбираем товарную позицию и нажимаем на блок "Скидка"


➤ Далее выбираем нужную надбавку 


➤ Переходим к оплате. Для этого нажимаете на значок "Касса"


➤ Нажимаем на кнопку "Точная сумма" и выбираем способ оплаты



▸ После проведения оплаты в Samosale должен передаться чек с надбавкой как с товарной позицией. Это можно проверить в Разделе Касса –> Чеки, найдя нужный чек




▸ Далее мы переходим в личный кабинет Samosale (Настройки –> Товары и Категории –> Товары). Вводим в строку поиска название нужно добавки 


▸ В карточке товара устанавливаем ограничения на списание бонусов (Установить макс. скидку) и их начисление (Установить кэшбэк). Деактивируем все чекбоксы


5. Как сделать так, чтобы при выборе способа оплаты "Без выручки" чек не передавался в Samosale?

После последнего обновления плагина до версии 1.4.0.0 логика работы была пересмотрена, и теперь чек не передается, если вы выбираете способ оплаты "Без выручки" на кассе. Актуально для сотрудников, которые обедают за счет заведения

Настраивается данный способ оплаты в iikoOffice (Розничные продажи –> Типы оплат) 


Тип документа обязательно должен быть Акт списания




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


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