Описание

Начиная с версии SetRetail 10.4.21.0 для работы любого нового API-плагина на кассе требуется разрешение со стороны сервиса лицензирования (SLM) и прохождение процедуры подключения к SET. Процедура подключения плагина отличается для различных плагинов:

Плагины, разрабатываемые CSI - через лицензирование;
Плагины, разрабатываемые клиентами самостоятельно под себя и принадлежащие клиентам - через “белые списки”;
Плагины, разрабатываемые партнерами/вендорами и принадлежащие вендору - через лицензирование.

На процедуру не влияет вопрос включения плагина в дистрибутив кассы, ключевым для определения процедуры является вопрос принадлежности прав собственности на плагин.

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

С версии SetRetail 10.4.25.0 функциональность поддерживается на КСО SetSCO v.3.

Условия работы

В случае отсутствия лицензии или если плагин не включен в белый список, блокируется транспорт с кассы на сервер. Этот сценарий сопровождается информированием кассиров на кассе о том, что касса работает без лицензии.

Примеры сообщений

Клавиатурная касса

172.29.17.126_24_11_2025-15_49_53-20251124-124955.png

Касса самообслуживания

При возникновении данной ошибки проверьте файл /home/tc/storage/crystal-cash/logs/license.log, в нем будут писаться события о недоступности плагинов.

Уровень логирования подобных записей - INFO.

В случае, если на какой-то плагин касса не найдет лицензии, в логе будут фигурировать записи следующего вида (с соответствующим названием и id плагина):

Plugin StolotoPlugin-2.6.1 with id ru.crystals.setapi.stoloto.service having license issues!

19.11 15:27:38.063 INFO  [LicenseServiceImpl] Plugin "RFIDAdvanCloud-1.0.0" with id "ru.crystals.plugins.rfidadvan" is having license issues! | #23 schedule@5b9d55db
19.11 15:27:38.065 INFO  [LicenseServiceImpl] Cash does not have a valid license of module - api-ru.crystals.plugins.rfidadvan! Outgoing transport disabled! | #23 schedule@5b9d55db

Версия SetAgent

Для корректной работы требуется версия SetAgent не ниже 1.5.6. Версия агента указана в левом нижнем углу визуализации: