Инстркуия к интеграции системы iiko v7 и выше с POS терминалами
Содержание
- Описание
- Подготовка POS терминала
- Подготовка плагина
- Настройка iikoOffice
- Работа в iikoFront
- История версий
Описание и совместимость
Плагин совместим с iiko v7 и выше и терминалами Kaspi Bank серии Smart POS А90 и А80
Необходима свободная лицензия API Payment
Интеграция реализована на Front API v6
Месторасположение файла логов -
%appdata%\iiko\CashServer\Logs\plugin-Resto.Front.Api.Kaspi.log
Внимание: плагин интеграции не работает, если у вас подключена Каспи Касса
Подготовка POS терминала
Внимание: POS терминал должен быть в одной локальной сети с кассой iiko
Лучшим решением для интеграции будет использование ethernet.
В таком случае будут исключены задержки на прохождение данных между кассой и POS терминалом. При использовании Wi-Fi для интеграции следует обеспечить надежность сигнала и не нагружать Wi-Fi сеть большим количеством устройств. Сетевой адрес должен быть либо статично прописан, либо получен фиксированный адрес по DHCP в соответствии с mac-адресом Smart Pos. Сетевые настройки устанавливает персонал клиента кассовой интеграции.
Аутентификация на API интеграции отсутствует, поэтому интеграция должна быть защищена на сетевом уровне в выделенной сети.
Интеграция реализована на базе httpd сервера, запускается вместе с приложением KaspiPay на Smart Pos и работает на порте 8080.
Для нормальной работы Smart Pos в локальной сети клиента необходимы сетевые разрешения для сервисов kaspi и google crashlytics для адресов:
qrpay.kaspi.kz порт 443 - сервис Kaspi Pay
pos.kaspi.kz порт 443 - сервис Kaspi Pay
pos.kaspi.kz 9996 cервис обновления Kaspi Pay
spos-market.kaspi.kz порт 443 - cервис обновления Kaspi Pay
spos-rkl.kaspi.kz порт 443 - cервис Kaspi Pay
spos-info.kaspi.kz порт 443 - cервис Kaspi Pay
Business.kaspi.kz порт 443 - cервис Kaspi Pay
Poslog.kaspi.kz порт 443 - cервис Kaspi Pay
*.crashlytics.com порты 80, 443 - cервис регистрации ошибок
*.fabric.io порты 80, 443 - cервис регистрации ошибок
crashlyticsreports-pa.googleapis.com порты 80, 443 - cервис регистрации ошибок
firebasecrashlyticssymbols.googleapis.com порты 80, 443 - cервис регистрации ошибок
*.1e100.net порты 80, 443 - cервис регистрации ошибок
*.google.com порты 80, 443 - cервис регистрации ошибок
*.jpush.cn порты 80, 443 - сервис обновления системы
ota.m4bank.ru порты 80, 443 - сервис обновления системы
supl.google.com порты 80, 443 - сервис точного времени
north-america.pool.ntp.org порты 80, 443 - сервис точного времени
time1.aliyun.com порты 80, 443 - сервис точного времени
xtrapath1.izatcloud.net порты 80, 443 - сервис геолокации
config.jpush.cn порт 443 - сервис обновления системы
tsis.jpush.cn порт 443 - сервис обновления системы
user.jpush.cn порт 443 - сервис обновления системы
uploadlog.jpush.cn порт 443 - сервис обновления системы
api.jpush.cn порт 443 - сервис обновления системы
217.174.185.218 порт 80 - сервис обновления системы
Подготовка плагина
1. Обратиться к одному из дилеров (idsoft.kz, kafesoft.kz) или зарегистрироваться, скачать файлы и установить, настроить самостоятельно
2. Распаковать папку по пути C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\
3. Дать пользователю windows права на запись в папку Plugins и папку плагина Resto.Front.Api.Kaspi
4. Настроить IP адрес POS терминала в плагине. Для этого в iikoFront зайти в “Дополнения”, выбрать “Настройка плагина(Kaspi)”. В открывшемся окне настроить IP адрес, порт и нажать кнопку “Сохранить”.
3. Дать пользователю windows права на запись в папку Plugins и папку плагина Resto.Front.Api.Kaspi
4. Настроить IP адрес POS терминала в плагине. Для этого в iikoFront зайти в “Дополнения”, выбрать “Настройка плагина (POS Plugin)”. В открывшемся окне выбрать вкладку "Список терминалов" и в списке настроить IP адрес, порт каждого терминала и нажать кнопку “Сохранить”.
Название терминала будет выведено при оплате если терминалов несколько:
Настройка iikoOffice
Внимание: Настройка в бэк офисе делается после первого запуска плагина на Front
В бэк офисе iiko необходимо настроить новый тип оплат.
Название - kaspi
Тип оплаты - Внешний тип оплаты
Название в чеке - kaspi
Устанавливать точную сумму - рекомендуется установить флажок
Безналичный тип - Kaspi Bank
Далее по ТЗ Заказчика пользователя iiko.
После отправки метода Payment запускается таймер, который с интервалом в 1 секунду (настраиваемый интервал) опрашивает терминал:
Пришёл ответ success - оплата считается успешной. В iiko отображается, что оплата прошла.
Пришёл ответ fail - оплата не успешная, плагин отменяет оплату “kaspi”.
Нет ответа в течение 1 минуты - оплата не успешная, плагин отменяет оплату “kaspi”.
Пришёл ответ wait - оплата в процессе, плагин ждёт дальше.
Работа в iikoFront
Оплата
Оплата производится стандартным образом через “Банковские карты” - “kaspi”.
Возврат
Возврат осуществляется стандартным методом возврата в “Закрытые заказы”. Если заказ был оплачен типом оплаты “kaspi”, плагин автоматически запросит возврат через POS терминал (kaspi Smart POS).
История версий
1.0.0.10 (latest) 20.01.2024
Исправлена ошибка лицензии при отсутствии интернета. Добавлена возможность работы с несколькими терминалами.
1.0.0.6 (stable) 24.02.2022
Исправлена ошибка проверки лицензии и ошибка автообновления.