Кассовое ПО Artix позволяет осуществлять работу с сервером антикражных ворот.

Конфигурирование модуля

Активация модуля антикражных ворот определяется параметром ExitGate, который задается в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/exitgate.ini в секции [plugins].

НаименованиеТип данныхВозможные значенияОписаниеПримечания
ExitGateстроковый
  • on
  • off
Активация модуля антикражных воротПо умолчанию off
Пример настройки
[plugins]
;ExitGate = off

Настройка плагина антикражных ворот производится в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/exitgate.ini в секции [ExitGate].

НаименованиеТип данныхОписаниеПримечания
hostстроковыйАдрес сервераПо умолчанию 127.0.0.1
portстроковыйПорт сервераПо умолчанию 8087
timeoutстроковый

Таймаут ожидания ответа от сервера (в миллисекундах)

По умолчанию 5000
maskстроковый

Шаблон для формирования данных, отправляемых на сервер

По умолчанию %(document.identifier[s])

Пример настройки
[ExitGate]
; Настройки плагина антикражных ворот

; Адрес сервера
; По умолчанию 127.0.0.1
;host = 127.0.0.1

; Порт сервера
; По умолчанию 8087
;port = 8087

; Таймаут ожидания ответа от сервера
; По умолчанию 5000 миллисекунд
;timeout = 5000

; Шаблон для формирования данных, отправляемых на сервер
; По умолчанию %(document.identifier[s])
;mask = %(document.identifier[s])

Для работы с антикражными воротами необходимо:

  1. Активировать модуль антикражных ворот (см.Конфигурирование модуля).
  2. Настроить подключение к серверу антикражных ворот (см.Конфигурирование модуля).
  3. Перезапустить кассовую программу.

При закрытии документа в ФР будет отправлен запрос к серверу антикражных ворот. При наличии связи с сервером и корректной обработке запроса идентификатор чека добавляется в БД сервера, осуществляется печать квитанции со штрих-кодом (шаблон exitgate.xml), который покупателю необходимо отсканировать при выходе.

Если во время запроса отсутствует связь с сервером, то на экран будет выведена ошибка "Ошибка соединения с сервером".

Если штрих-код уже есть в БД сервера, то на экран будет выведена ошибка "Данный штрих-код уже использован".

Передача QR-кода ОФД на сервер антикражных ворот

В кассовом ПО Artix реализована возможность при работе с антикражными воротами использовать фискальный QR-код чека. 

В данном случае шаблон exitgate.xml не требуется и его можно удалить.

Для этого необходимо:

  1. В настройках плагина антикражных ворот параметру 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])
  2. В настройках сервера антикражных ворот параметру mask задать регулярное выражение для проверки данных с QR-кода (столбец таблицы "Пример QR-кода ОФД") в соответствии с нужным ОФД.
  • No labels