Про установку и первоначальную настройку интеграции можно прочитать в разделе "Быстрый старт". |
В интеграции Artix:SCO поддержан не весь функционал Artix:POS. |
Artix:SCO предоставляется и устанавливается вместе с дистрибутивом Artix. Для установки Artix:SCO используется дистрибутив на базе ОС Ubuntu 18.04 или 22.04.
Основным пакетом является artix-sst-sco
, у него в зависимостях все, что необходимо для работы интеграции.
SCO поставляется в пакете sst-sco
. В Artix пакет artix-sst-sco-core
отвечает за взаимодействие с SCO.
Используется ядро Artix, то есть настройка такая же, как и на обычной кассе, за исключением той части функционала, которая реализована на стороне SCO.
Настройки интеграции по умолчанию находятся в /linuxcash/cash/conf/ncash.ini.d/sstsco.ini
. Этот файл также содержит настройки ядра, которые меняют логику работы Artix.
Наименование | Возможные значения | Описание |
---|---|---|
Файл /linuxcash/cash/conf/ncash.ini.d/sstsco.ini , секция [SstSco] , настройки интеграции с SCO | ||
address | <адрес>:<порт> по умолчанию localhost:3200 | Адрес API сервера SCO |
cashCode | целое число по умолчанию не задано | Код валюты для оплаты наличными. |
catalogPicklist |
| Загружать список визуального подбора из каталогов. Если false, используются многоуровневые каталоги. |
Коды валют для типов оплат настраиваются в поле code на стороне SCO |
Устанавливается дополнительный файл настроек |
Работа с платежными системами реализована на стороне Artix. |
Все сообщения об ошибках от этих систем по умолчанию показываются консультанту без изменения.
При помощи настроек можно показывать отдельные ошибки покупателю, также можно изменить текст сообщений.
Этот функционал поддерживается, только если платежная система и реализация Artix передают отдельные коды ошибок. |
Наименование | Возможные значения | Описание |
---|---|---|
Файл /linuxcash/cash/conf/ncash.ini.d/sstsco.ini , секция [SstSco] , настройки интеграции с SCO | ||
paymentFailCustomerCodes | список кодов через запятую по умолчанию не задано | Список кодов ошибок банковского терминала для отображения покупателю. |
Файл /linuxcash/cash/conf/ncash.ini.d/sstsco.ini , Секция [PaymentFailMessages] , настройки интеграции с SCO | ||
<код ошибки> | текст сообщения или id i18n | Замена текста сообщений для указанных кодов ошибок. Терминал после выполнения операции присылает код и сообщение. Сообщение от терминала может быть неинформативным. Его можно изменить |
<код валюты>.<код ошибки> | текст сообщения или id i18n | Замена текста сообщений для указанных кодов ошибок с привязкой к коду валюты |
[SstSco] paymentFailCustomerCodes = 362, 2000, 4451, 4455, 5120 [PaymentFailMessages] 362 = Ваша карта не читается 2000 = Операция прервана клиентом 4451 = Недостаточно средств 4455 = Неверный ПИН-код 5120 = Клиент не ввел ПИН-код |
[SstSco] paymentFailCustomerCodes = 3.362, 3.2000, 3.4451, 3.4455, 3.5120 [PaymentFailMessages] 3.362 = Ваша карта не читается 3.2000 = Операция прервана клиентом 3.4451 = Недостаточно средств 3.4455 = Неверный ПИН-код 3.5120 = Клиент не ввел ПИН-код |
[SstSco] paymentFailCustomerCodes = 1000000 |
Файлы переводов сообщений со стороны Artix расположены в /linuxcash/cash/conf/translations
.
Наименование | Возможные значения | Описание |
---|---|---|
Файл /linuxcash/cash/conf/ncash.ini.d/sstsco.ini , секция [plugins] , Плагин интернационализации | ||
i18n |
| Включение перевода сообщений Artix |
Файл /linuxcash/cash/conf/ncash.ini.d/sstsco.ini , секция [I18n] , Список загружаемых языков | ||
languages | Список языков через запятую | Список загружаемых языков Artix На КСО установлено "ru, en, kk, uz, kz" |
Во все команды SCO при добавлении в справочники Artix указывается префикс SST_. Это сделано для того, чтобы команды SCO не пересекались с командами Artix. |
Меню настраивается так же, как и на обычной кассе. При этом необходимо создавать отдельные от обычной кассы корневые меню.
Список доступных команд SCO можно посмотреть в разделе "Главное меню".
Команды Artix добавляются без изменения.
Если для касс самообслуживания созданы отдельные корневые меню, то надо изменить коды меню на стороне SCO.
[Menu] closedCheck = 10 openCheck = 11 |
Логирование на стороне Artix работает так же, как и на обычной кассе.
Логи SCO по умолчанию пишутся в /linuxcash/logs/current/sst-sco
.
Подробнее про обновление в Artix написано здесь. |
В каталоге /etc/apt/sources.list.d
находится файл artix.list
. В нем прописан репозиторий, в котором необходимо указать актуальную версию релиза (например, artix-4.6.172-1
):
deb http://update.artix.su/bionic artix-<номер релиза> artix main contrib |
deb http://update.artix.su/jammy artix-<номер релиза> artix main contrib |
Для синхронизации и установки новых версий пакетов выполните команды:
apt update apt install artix-sst-sco |
или
aptitude update aptitude upgrade |