Кассовое ПО Artix позволяет осуществлять работу с сервером антикражных ворот.
Конфигурирование модуля
Активация модуля антикражных ворот определяется параметром ExitGate
, который задается в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/exitgate.ini
в секции [plugins]
.
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
ExitGate | строковый |
| Активация модуля антикражных ворот | По умолчанию off |
[plugins] ;ExitGate = off
Настройка плагина антикражных ворот производится в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/exitgate.ini
в секции [ExitGate]
.
Наименование | Тип данных | Описание | Примечания |
---|---|---|---|
host | строковый | Адрес сервера | По умолчанию 127.0.0.1 |
port | строковый | Порт сервера | По умолчанию 8087 |
timeout | строковый | Таймаут ожидания ответа от сервера (в миллисекундах) | По умолчанию 5000 |
mask | строковый | Шаблон для формирования данных, отправляемых на сервер | По умолчанию |
[ExitGate] ; Настройки плагина антикражных ворот ; Адрес сервера ; По умолчанию 127.0.0.1 ;host = 127.0.0.1 ; Порт сервера ; По умолчанию 8087 ;port = 8087 ; Таймаут ожидания ответа от сервера ; По умолчанию 5000 миллисекунд ;timeout = 5000 ; Шаблон для формирования данных, отправляемых на сервер ; По умолчанию %(document.identifier[s]) ;mask = %(document.identifier[s])
Для работы с антикражными воротами необходимо:
- Активировать модуль антикражных ворот (см.Конфигурирование модуля).
- Настроить подключение к серверу антикражных ворот (см.Конфигурирование модуля).
- Перезапустить кассовую программу.
При закрытии документа в ФР будет отправлен запрос к серверу антикражных ворот. При наличии связи с сервером и корректной обработке запроса идентификатор чека добавляется в БД сервера, осуществляется печать квитанции со штрих-кодом (шаблон exitgate.xml
), который покупателю необходимо отсканировать при выходе.
Если во время запроса отсутствует связь с сервером, то на экран будет выведена ошибка "Ошибка соединения с сервером".
Если штрих-код уже есть в БД сервера, то на экран будет выведена ошибка "Данный штрих-код уже использован".
Передача QR-кода ОФД на сервер антикражных ворот
В кассовом ПО Artix реализована возможность при работе с антикражными воротами использовать фискальный QR-код чека.
exitgate.xml
не требуется и его можно удалить.Для этого необходимо:
В настройках плагина антикражных ворот параметру
mask
задать значение макроподставки с соответствующими фискальными данными, которые хранятся в объектеfiscalInfo
.В качестве макроподстановок допускается использование свойств объекта
fiscalInfo
для разных ОФД:ОФД Значение макроподстановки Тип значения Описание Пример Пример QR-кода ОФД KZ:
- Программный ФН (softwarefn)
- Программный ФР (JNFD)
fiscalSign целое положительное число Фискальный признак %(fiscalInfo.fiscalSign[d])
https://consumer.oofd.kz/?i=1710742993&f=000000000099&s=1.00&t=20230815T155040
serialnum строка Регистрационный номер ККТ %(fiscalInfo.serialnum[s])
sum вещественное число Сумма чека %(fiscalInfo.sum[.2f])
fnDate дата и время Дата закрытия чека %(fiscalInfo.fnDate[yyyyMMddhhmmss])
BY:
ПКС "Цифровые кассы" (cashboxservice)
fiscalSign целое положительное число Уникальный идентификатор %(fiscalInfo.fiscalSign[d])
Передается значение уникального идентификатора UZ:
Программное обеспечение виртуальной кассы ARTIX (fiscaldriveapi)
fnNumber строка Номер фискального модуля %(fiscalInfo.fnNumber[s])
https://ofd.soliq.uz/check?t=UZ191211502346&r=5221&c=20230815153405&s=520414301255
fdNumber целое положительное число Порядковый номер документа %(fiscalInfo.fdNumber[d])
fnDate дата и время Дата закрытия чека %(fiscalInfo.fnDate[yyyyMMddhhmmss])
fiscalSign целое положительное число Фискальный признак %(fiscalInfo.fiscalSign[d])
RU:
- Пирит
- Штрих
- Атол
fnDate дата и время Дата закрытия чека %(fiscalInfo.fnDate[yyyyMMddhhmm])
t=20230802T1819&s=3.00&fn=9999078902008644&i=758&fp=1013568547&n=1
sum вещественное число Сумма чека %(fiscalInfo.sum[.2f])
fnNumber строка Номер фискального накопителя %(fiscalInfo.fnNumber[s])
fdNumber целое положительное число Порядковый номер документа %(fiscalInfo.fdNumber[d])
fiscalSign целое положительное число Фискальный признак %(fiscalInfo.fiscalSign[d])
- В настройках сервера антикражных ворот параметру
mask
задать регулярное выражение для проверки данных с QR-кода (столбец таблицы "Пример QR-кода ОФД") в соответствии с нужным ОФД.