ВАЖНО!
Перед установкой плагина убедитесь, что в пакете лицензий IIko есть лицензия FrontPaymentPlugin (Внутренний платежный интерфейс фронта).
Версия IIko должна быть не ниже 7.9.
Установка и настройка плагина:
1. Папку Resto.Front.Api.SamosalePlugin с файлами manifest и Resto.Front.Api.SamosalePlugin.dll скопировать в место установки фронта в папку Front.Net\Plugins (стандартный путь - C:\Program Files\iiko\iikoRMS\Front.Net\Plugins)
2. Запустить фронт
3. При запуске фронта в папке \AppData\Roaming\iiko\CashServer\PluginConfigs\Resto.Front.Api.SamosalePlugin создастся файл Samosale.config. Внутри тега token укажите токен подключения к системе Samosale (откуда его взять, см. здесь)
Также есть возможность изменения:
- адреса подключения в поле url;
- интервала переотправки заказов в оффлайн режиме (по умолчанию 60 сек) offlineRetryTimer;
- интервала проверки подтверждения списания бонусов (по умолчанию 3 сек) checkConfirmationTimer;
- таймаута проверки подтверждения списания бонусов (по умолчанию 120 сек) checkConfirmationTimeout.
Примечание: В плагине нет возможности аварийного прерывания ожидания подтверждения (т.к. это не предусмотрено API iiko Front). Поэтому если что-то пойдёт не так, кассиру придётся ждать две минуты до окончания таймера.
4. В айко офисе зайти в Дисконтная система -> Скидки и надбавки, создать новую скидку. Этой скидкой будет проводится оплата бонусами Samosale.
Для этого необходимо:
Нажать кнопку «Добавить»
Указать название и название в пречеке (можно одно и то же), нажать Далее
Убрать все галочки выше окна "Места продаж, где применяется скидка" (по умолчанию стоят галочки "Можно назначать вручную" и "Можно назначать по карте", их надо убрать), нажать «Далее»
В окне с настройками суммы скидки и категорий блюд ничего не менять, нажать Далее;
Убедиться, что стоит галочка "Активировать скидку" и нажать ОК.
5. В айко офисе зайти в Розничные продажи -> Типы оплат, создать новый тип оплаты. Для этого:
Нажать сверху кнопку Добавить
Указать название и название в чеке (можно одно и то же);
В поле "Тип" выбрать "Внешний тип оплаты"
Убрать галочку "Открывать денежный ящик"
В поле "Безналичный тип" в выпадающем меню выбрать Samosale Payment. Этот тип появляется, если у вас удачно запустился плагин Samosale кассе
Поставить галочку "Проводить как скидку" (для этого должна быть убрана галочка "Является фискальным")
В поле "Скидка" в выпадающем меню выбрать созданную на предыдущем этапе скидку
Нажать Сохранить
6. Перезапустить фронт.
Рекомендуем ознакомиться также с нашей статьей, в которой мы постарались ответить на часто задаваемые вопросы, связанные с незапуском плагина.
Если вы не нашли ответ на свой вопрос, задайте его нам в Telegram @SamosaleSupport_Bot 😃