Кассовым ПО Artix предусмотрена возможность оплаты отдельных видов товаров, работ и услуг электронными сертификатами НСПК.
Конфигурирование модуля
Активация модуля для работы с электронными сертификатами определяется параметром nspkec
, который задается в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/nspkec.ini
в секции [plugins]
.
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
nspkec | строковый |
| Активация модуля для работы с электронными сертификатами НСПК | По умолчанию off |
[plugins] ;Электронные Сертификаты НСПК ;nspkec = off
Настройка плагина для работы с электронными сертификатами НСПК производится в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/nspkec.ini
в секции [NspkEc]
.
Наименование | Тип данных | Описание | Примечания |
---|---|---|---|
serverUrl | строковый | Адрес сервера электронных сертификатов НСПК | По умолчанию "http://localhost " |
timeout | целочисленный | Таймаут запроса к серверу в секундах | По умолчанию 30 секунд |
apiKey | строковый | Ключ доступа к API-интерфейсу фронт-офиса электронных сертификатов НСПК | По умолчанию "" |
macKey | строковый | Ключ кассы для контроля целостности данных | По умолчанию "" |
cashBoxId | строковый | Идентификатор кассы | По умолчанию "" |
settlementPlace | строковый | Место расчетов | По умолчанию "" |
echoPhrase | строковый | Фраза для проверки корректности подключения | По умолчанию "" Если параметр не задан, то используется текущее локальное время. |
numberOfTries | целочисленный | Количество попыток повторной отправки данных чека | По умолчанию |
valutCode | целочисленный | Код валюты для оплаты электронными сертификатами |
[NspkEc] ; Адрес сервера Электронных Сертификатов НСПК ; По умолчанию "http://localhost" ;serverUrl = "http://localhost" ; Таймаут запроса к серверу в секундах ; По умолчанию 30 ;timeout = 30 ; Ключ доступа к API-интерфейсу фронт-офиса Электронных Сертификатов НСПК ; По умолчанию "" ;apiKey = "". ; Ключ кассы для контроля целостности данных ; По умолчанию "" ;macKey = "". ; Идентификатор кассы ; По умолчанию "" ;cashBoxId = "". ; Место расчетов ; По умолчанию "" ;settlementPlace = "". ; Фраза для проверки корректности подключения. Если параметр не задан, то используется текущее локальное время ; По умолчанию "" ;echoPhrase = "" ; Количество попыток повторной отправки данных чека оплаты/возврата ; По умолчанию 5 ;numberOfTries = 5 ; Код валюты для оплаты Электронными Сертификатами. ;valutCode = 6
Оплата электронным сертификатом
Для оплаты электронным сертификатом необходимо:
- Активировать модуль для работы с электронными сертификатами(см. Конфигурирование модуля).
- Добавить в БД товары с кодом ТРУ.
Код ТРУ для товаров задается в товаре (БДDictionaries
таблицаTmc
полеtrucode
) или в штрих-коде товара (БДDictionaries
таблицаBarcodes
полеtrucode
). Настроить валюту для оплаты электронным сертификатом (см. Настройка валюты).
- Настроить плагин для получения фискальной информации (см. Фискальная информация о документе).
- Перезапустить кассовую программу.
- Добавить в чек товары, для которых задан код ТРУ.
- Перейти в подытог, считать карту для оплаты электронным сертификатом.
- Выбрать валюту для оплаты электронным сертификатом. Оплатить электронным сертификатом.
- Оплатить оставшиеся товары другой валютой.
- Закрыть чек.
Настройка валюты
Для оплаты электронным сертификатом НСПК необходимо:
- в утилите администрирования Yuki добавить валюту "ЭС НСПК" с характеристиками валюты:
- название плагина процессинга – "Сбербанк",
- в свойствах валюты установить – "Оплата электронным сертификатом".
О настройке валют подробнее можно прочитать в разделе "Валюты".
- в конфигурационном файле
/linuxcash/cash/conf/ncash.ini.d/nspkec.ini
в секции[NspkEc]
необходимо указать код валюты "ЭС НСПК" в параметреvalutCode
.
Оплата товаров
Электронным сертификатом можно оплачивать только позиции с кодом ТРУ. При переходе в подытог на экран будет выведен диалог "В чеке есть товары, которые можно оплатить Электронным Сертификатом. Для проверки возможности оплаты приложите карту 'Мир' к терминалу".
Если карта считана успешно, то отправляется запрос на сервер НСПК для проверки возможности оплаты товаров электронным сертификатом. Если в чеке есть товары, которые можно оплатить электронным сертификатом, то данные товары отмечаются иконкой
.Оплата электронным сертификатом НСПК осуществляется по инициативе покупателя. В чек, который можно оплатить электронным сертификатом, оплата валютой "ЭС НСПК" должна быть добавлена первой. В противном случае на экран будет выведено предупреждение "В чеке есть другие оплаты. Оплата Электронным Сертификатом невозможна".
Закрытие чека
При закрытии чека, в котором была оплата электронным сертификатом, на сервер НСПК отправляются данные чека. В данных чека указывается фискальная информация.
Если нет связи с сервером НСПК, то сообщение с данными чека будет отправлено в очередь Artix-Queue. Количество попыток повторной отправки данных чека из очереди определяется параметром numberOfTries
. Если сообщение не будет отправлено за указанное количество раз, то сообщение будет удалено из очереди.
При перезапуске сервиса очереди количество выполненных попыток повторной отправки данных чека будет обнулено.
Возврат за счет электронного сертификата
Для возврата за счет электронного сертификата необходимо:
- Выбрать чек продажи, в котором была оплата электронным сертификатом.
- Выбрать позиции для возврата, для оплаты которых был использован электронный сертификат.
- Перейти в подытог, считать карту для возврата за счет электронного сертификатом.
- Выполнить возврат денежных средств.
- Закрыть чек.
Возврат товаров
Если осуществляется возврат товаров, оплаченных электронным сертификатом, то при переходе в подытог на экран будет выведен диалог "В чеке есть товары, которые были оплачены Электронным Сертификатом. Для проверки возможности возврата приложите карту 'Мир' к терминалу". Если карта считана успешно, то отправляется запрос на сервер НСПК для проверки возможности возврата за счет электронного сертификата. Если в чеке есть товары, для которых возможен возврат, то данные товары отмечаются иконкой
.Если возврат товаров, оплаченных электронным сертификатом, невозможен, то данные товары отмечаются иконкой
. После сторнирования позиций с кодом ТРУ чек с оставшимися позициями может быть закрыт.При закрытии чека, в котором был возврат за счет электронного сертификата, на сервер НСПК отправляются данные чека аналогично чеку продажи.