¶ Интеграция IIKO и ППС Барс
¶ В интеграции участвуют
- ПО IIKO (разворачивают и настраивают сотрудники Iiko)
- плагин BarsPaymentPlugin (разворачивают и настраивают сотрудники Iiko)
- HTTP-service Барс (разворачивают и настраивают сотрудники ППС Барс)
- ППС Барс (разворачивают и настраивают сотрудники ППС Барс)
¶ Плагин BarsPaymentPlugin
Плагин - https://disk.yandex.ru/d/NMdeWtHBYsEllg
Общие сведения
ППС Барс в рамках функции ведения лицевых счетов посетителей и биллинга по реализованным товарам и услугам выступает в качестве ведущей системы. ППС Барс связывает каждый лицевой счет с одним или несколькими электронными идентификаторами, выданных посетителям на время посещения. На лицевых счетах ППС Барс фиксируются платежные транзакции и по запросу рассчитывается текущий баланс доступных денежных средств. Начальный баланс средств на лицевом счете предоставляется посетителю в кредит.
Кассовая система iiko реализует товары только по безналичному расчету в рамках имеющихся средств на лицевых счетах посетителей путем авторизации через электронные идентификаторы.
Окончательный расчет с посетителями за предоставленные товары и услуги с использованием наличных денежных средств или банковских карт и с выдачей фискальных чеков происходит на рабочих местах кассиров ППС Барс. Фискальный чек оформляется с детализацией по номенклатуре.
Со стороны кассовой системы iiko интеграция выполнена в виде платежного плагина.
Со стороны ППС Барс взаимодействие осуществляется через модуль HttpService.
Схема взаимодействия
iikoFront >> iiko2Bars.Plugin >> Барс.HttpService >> ППС Барс
Технические требования
- Лицензия iikoFrontAPI. (500 руб/мес на каждые 10 экземпляров плагинов)
- Версия ПО iiko на объекте не ниже 7.x
- Версия ПО БАРС HttpService не ниже 1.0.0.15 (служба интеграции со стороны БАРСа)
- Совместимое RFID оборудование. RFID считыватели для касс iiko должны при считывании возвращать код идентичный коду карт в системе БАРС.
Установка
Платежный плагин устанавливается на каждую кассу iiko, где осуществляются расчеты по электронным идентификаторам посетителей. Установка плагина происходит ручным копированием папки плагина с содержимым из архива с дистрибутивом версии. Папку установки рекомендуется назвать как BarsPaymentPlugin без использования номеров версии в названии папки.Путь для развертки плагина:
C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\BarsPaymentPlugin
Для запуска плагина необходимо перезапустить iikoFront (один раз в режиме администратора для регистрации порта).
Убедитесь по логам плагина, что плагин успешно стартанул.
Обновление плагина поддерживается в автоматическом режиме при публикации новых версий на репозитарии автообновления iiko.
Также автообновление плагина можно инициировать ручным способом через раздел Дополнения.
Настройка типа оплаты
Настройка типа оплаты
После первого успешного запуска плагина необходимо настроить в iikoOffice новый тип оплаты для расчета по электронным идентификаторам.
Необходимо добавить внешний тип оплаты по примеру на скриншоте. Наименование типа оплаты и название в чеке не регламентируются.
Настройка конфига плагина
Настройка связи с HttpService Модуль HttpService устанавливается на автоматизированный объект в единственном экземпляре и все кассы iiko обращаются к нему.Для взаимодействия с модулем HttpService необходимо настроить конфиг плагина.
Конфиг плагина расположен в папке по пути
%appdata%\Roaming\iiko\CashServer\PluginConfigs\BarsPaymentPlugin\BarsPaymentPlugin.json
(пример расположения - C:\Users\user\AppData\Roaming\iiko\CashServer\PluginConfigs\BarsPaymentPlugin)
{ "PaymentKind": "370", "BarsApiAddress": "192.168.0.209:15580", "RkUnits": [ { "Name": "10", "PointsOfSales": [] } ] }
Параметры для настройки:
"PaymentKind": - код валюты из конфига http-сервиса (параметр Deposit)
"BarsApiAddress": - ip:порт http-сервиса
RkUnits "Name": - айди кассы из Барса
НДС
НДС Настройка налога НДС выполняется на стороне БАРСа путем прописывания ставки для налога с кодом (идентификатором) 18. Если предприятие без НДС, то в БАРСе прописывается процент = 0, если с НДС, то 20.Со стороны платежного плагина информация о налогах, передаваемая в тэгах ниже, захаркожена и не меняется от настроек iiko.
<LINETAXES count="0">
<TAX id="{aac36cc0-cb5b-4b23-a83d-8267fbe67673}" sum="0" />
</LINETAXES>
<CHECKTAXES>
<TAX id="{aac36cc0-cb5b-4b23-a83d-8267fbe67673}" sum="0" code="18" rate="18" name="НДС" />
</CHECKTAXES>
¶ ПО IIKO
IikoOffice
Номенклатура:
В меню слева - Товары и склады, Номенклатура
Признак предмета расчета:
Товары и склады - Номенклатура - Добавление новой или Редактирование существующей номенклатуры
Настройка товарной группы для продажи маркированной продукции:
Товары и склады - Номенклатура - Добавление новой или Редактирование существующей номенклатуры
IikoFront