Кассовое ПО 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
), который покупателю необходимо отсканировать при выходе.
Если во время запроса отсутствует связь с сервером, то на экран будет выведена ошибка "Ошибка соединения с сервером".
Если штрих-код уже есть в БД сервера, то на экран будет выведена ошибка "Данный штрих-код уже использован".
В кассовом ПО Artix реализована возможность при работе с антикражными воротами использовать фискальный QR-код чека.
В данном случае шаблон exitgate.xml не требуется и его можно удалить. |
Для этого необходимо:
В настройках плагина антикражных ворот параметру mask
задать значение макроподставки с соответствующими фискальными данными, которые хранятся в объекте fiscalInfo
.
В качестве макроподстановок допускается использование свойств объекта fiscalInfo
для разных ОФД:
ОФД | Значение макроподстановки | Тип значения | Описание | Пример | Пример QR-кода ОФД |
---|---|---|---|---|---|
KZ:
| 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 | дата и время | Дата закрытия чека |
| ||
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 | дата и время | Дата закрытия чека |
| ||
fiscalSign | целое положительное число | Фискальный признак | %(fiscalInfo.fiscalSign[d]) | ||
RU:
| fnDate | дата и время | Дата закрытия чека | %(fiscalInfo.fnDate[yyyyMMddhhmm]) | t=20230802T1819&s=3.00&fn=9999078902008644&i=758&fp=1013568547&n=1 |
sum | вещественное число | Сумма чека |
| ||
fnNumber | строка | Номер фискального накопителя | %(fiscalInfo.fnNumber[s]) | ||
fdNumber | целое положительное число | Порядковый номер документа | %(fiscalInfo.fdNumber[d]) | ||
fiscalSign | целое положительное число | Фискальный признак | %(fiscalInfo.fiscalSign[d]) |
mask
задать регулярное выражение для проверки данных с QR-кода (столбец таблицы "Пример QR-кода ОФД") в соответствии с нужным ОФД.