Про установку и первоначальную настройку интеграции можно прочитать в разделе "Быстрый старт".

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
  • true
  • false (по умолчанию)
Загружать список визуального подбора из каталогов.
Если false, используются многоуровневые каталоги.

Коды валют для типов оплат настраиваются в поле code на стороне SCO 

Устанавливается дополнительный файл настроек /opt/sst-sco/conf/artix.ini, который нельзя менять.
В нем задается конфигурация SCO для совместимости с Artix.

Изменение сообщений от платежных систем

Работа с платежными системами реализована на стороне 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 = Клиент не ввел ПИН-код
Настройка отображения ошибок терминала Сбербанка с привязкой к коду валюты 3
[SstSco]
paymentFailCustomerCodes = 3.362, 3.2000, 3.4451, 3.4455, 3.5120

[PaymentFailMessages]
3.362 = Ваша карта не читается
3.2000 = Операция прервана клиентом
3.4451 = Недостаточно средств
3.4455 = Неверный ПИН-код
3.5120 = Клиент не ввел ПИН-код
Отображение покупателю ошибки "Время ожидания оплаты по QR-коду истекло. Оплата не произведена"
[SstSco]
paymentFailCustomerCodes = 1000000

Языковые настройки

Файлы переводов сообщений со стороны Artix расположены в /linuxcash/cash/conf/translations .

НаименованиеВозможные значенияОписание
Файл /linuxcash/cash/conf/ncash.ini.d/sstsco.ini, секция [plugins], Плагин интернационализации
i18n
  • on
  • off (по умолчанию)

Включение перевода сообщений Artix
На КСО установлено on

Файл /linuxcash/cash/conf/ncash.ini.d/sstsco.ini, секция [I18n], Список загружаемых языков
languages

Список языков через запятую
по умолчанию "ru, en, kk, uz"

Список загружаемых языков Artix
На КСО установлено "ru, en, kk, uz, kz"

Настройка действий и меню

Во все команды SCO при добавлении в справочники Artix указывается префикс SST_. Это сделано для того, чтобы команды SCO не пересекались с командами Artix. 

Меню настраивается так же, как и на обычной кассе. При этом необходимо создавать отдельные от обычной кассы корневые меню.
Список доступных команд SCO можно посмотреть в разделе "Главное меню".
Команды Artix добавляются без изменения. 

Если для касс самообслуживания созданы отдельные корневые меню, то надо изменить коды меню на стороне SCO.

/opt/sst-sco/conf/menu.ini
[Menu]
closedCheck = 10
openCheck = 11

Логирование

Логирование на стороне Artix работает так же, как и на обычной кассе.

Логи SCO по умолчанию пишутся в /linuxcash/logs/current/sst-sco.

Обновление программы

Подробнее про обновление в Artix написано здесь.

  1. В каталоге /etc/apt/sources.list.d находится файл artix.list. В нем прописан репозиторий, в котором необходимо указать актуальную версию релиза (например, artix-4.6.172-1):

    Для Ubuntu 18.04
    deb http://update.artix.su/bionic artix-<номер релиза> artix main contrib
    Для Ubuntu 22.04
    deb http://update.artix.su/jammy artix-<номер релиза> artix main contrib

  2. Для синхронизации и установки новых версий пакетов выполните команды:

    apt update
apt install artix-sst-sco

    или

    aptitude update
aptitude upgrade
  • No labels