Для корректной работы настройка проверки пин-кодов должна быть включена и на кассе и на сервере сертификатов.

Принцип работы

Принцип взаимодействия кассового ПО и сервера сертификатов приведен на схеме:
HOW-TO > Настройка проверки пин-кода при оплате сертификатом > Общая схема проверки пин-кода при оплате сертификатом.png

Настройка на сервере

Сервер сертификатов может быть установлен:

на машине вместе с кассовым сервером (Artix Control Center),
на отдельной машине (подробнее можно прочитать в разделе "Установка серверов лояльности на отдельные машины").

Для работы с сертификатами необходимо выполнить следующие шаги:

Установить сервер сертификатов:
- для установки только сервера сертификатов, выполните команду:
  sudo apt-get install artixcs-accounting-certificates
  Порт по умолчанию 38057.
- для установки бонусного сервера (БС) и сервера сертификатов, выполните команду:
  sudo apt-get install artixcs-accounting-bonuses-certificates
  Порт по умолчанию 38056.
Создать сертификаты на LM и загрузить справочник на кассу.
Подробнее о сертификатах можно прочитать в разделе "Сертификаты", о загрузке справочников – в разделе "Назначение вкладок для объектов торговой сети" вкладка "Справочники".
Включить проверку пин-кодов в файле /opt/artixcs-accounting-certificates/application.properties, прописать:
accounting.logic.checkPincode = true
Перезапустить сервер:
- сервер сертификатов командой:
  sudo service artixcs-accounting-certificates restart
- бонусный сервер и сервер сертификатов командой:
  sudo service artixcs-accounting-bonuses-certificates restart
Заполнить таблицу accountpincodeTemp в БД artixcsAll на кассовом сервере.
Для этого необходимо загрузить справочник "Пин-коды".
Настроить Data Transfer для переноса данных из кассового сервера в БД db_certificates (для сервера сертификатов) или db_bonuses_certificates (для БС и сервера сертификатов). Подробнее об этом в разделе "Настройка трансфера бонусов (Data transfer)".
Записи из таблицы accountpincodeTemp БД кассового сервера будут перенесены в таблицу Pincode в БД (БС).

Настройка на кассе

Для работы с сертификатами необходимо на кассе выполнить следующие шаги:

Настроить стыковку кассы и сервера сертификатов. Указать адрес сервера сертификатов в файле /linuxcash/cash/conf/plugins/artix_certificate.xml.
Включить проверку пин-кодов в файле /linuxcash/cash/conf/ncash.ini.d/artixcertificate.ini, прописать:
usePincode = false
Настроить валюту для оплаты сертификатом одним из способов:
- загрузить на кассу справочник "Валюты",
- через утилиту администрирования Yuki,
- в Artix Control Center: выбрать магазин, вкладку "Сервис" → вкладка "Справочники" → элемент "Валюты".
Перезапустить кассу.

После применения всех настроек при оплате сертификатом на кассе будет отображен диалог ввода пин-кода сертификата.

Возможные ошибки и решения:

Если на экран кассы выведено сообщение:

"Не настроен модуль для работы с сертификатами" – необходимо проверить наличие файла /linuxcash/cash/conf/plugins/artix_certificate.xml на кассе.
"Нет связи с бонусным сервером" / "Аутентификация не пройдена" / "Нет доступа к данным на сервере" – необходимо в файле artix_certificate.xml на кассе проверить следующие настройки: address, user, password, terminalId.
Если с настройками на кассе все в порядке, то проверить работу сервера лояльности:
- если установлен сервер сертификатов:
  service artixcs-accounting-certificates status
- если установлен бонусный сервер + сервер сертификатов:
  service artixcs-accounting-bonuses-certificates status
  Логи можно просмотреть в файле /var/log/artix/<название_пакета>/<название_пакета>.log.
"Оплата сертификатом запрещена" / "Сертификат еще не продан" / "Нет средств для оплаты" – необходимо проверить статус и баланс сертификата на сервере. Статус должен быть PAY_ONLY, баланс больше 0. Подробнее о статусах сертификата можно прочитать в разделе "Подарочные сертификаты".