SetRetail10 ◾️ Блокировка работы на кассе с неактуальной версией прошивки ФР

Публичное пространство

SetRetail10 ◾️ Блокировка работы на кассе с неактуальной версией прошивки ФР

https://crystals.atlassian.net/browse/SRTZ-4543

https://crystals.atlassian.net/browse/CR-14952

10.4.25.0

Описание

Функциональность реализует программную блокировку работы кассового модуля POS/Touch/SCOv3 при подключении фискального регистратора (ККТ) с неактуальной версией прошивки. Валидация версии прошивки ККТ выполняется при запуске и перезапуске кассового модуля путём сравнения с минимально разрешённой версией, заданной в настройках. При несоответствии версии минимально разрешённой работа кассы блокируется, авторизация кассира невозможна.

Ценность

  • Исключает эксплуатацию кассового оборудования с неподдерживаемыми или устаревшими версиями прошивки ККТ.

  • Снижает риски нарушения законодательства и ошибок, связанных с человеческим фактором.

  • Повышает безопасность и корректность работы кассового оборудования.

Примеры работы

Значение настройки firmwareKKT.validation.MinAllowedVersion : {"pirit2f100":"565.1.42"}.

Примеры работы успешных сценариев

Сценарий 1. Успешная валидация: один ККТ

  1. К кассе подключён ККТ Пирит 2Ф.

  2. При запуске кассового модуля версия прошивки ККТ сравнивается с минимально разрешённой.

  3. Версия соответствует требованиям.

  4. Кассовый модуль загружается без ошибок, кассир успешно авторизуется.

Сценарий 2. Успешная валидация: два одинаковых ККТ

  1. К кассе подключены два ККТ Пирит 2Ф.

  2. Оба устройства проходят проверку версии прошивки.

  3. Кассовый модуль загружается без ошибок, кассир успешно авторизуется.

Сценарий 3. Успешная валидация: два разных ККТ

  1. К кассе подключены ККТ Пирит 2Ф и ККТ другого производителя.

  2. Проверка версии прошивки выполняется только для поддерживаемой модели (Пирит 2Ф).

  3. Кассовый модуль загружается без ошибок, кассир успешно авторизуется.

Примеры работы отрицательных сценариев

Значение настройки firmwareKKT.validation.MinAllowedVersion : {"vikiprintf100":"665.4.24"}

Сценарий 4. Неуспешная валидация

  1. К кассе подключён ККТ Вики Принт с версией прошивки ниже минимально разрешённой ({"vikiprintf100":"665.4.24"}).

  2. При запуске кассового модуля выполняется проверка версии.

  3. Касса отображает сообщение:
    «Фискальный регистратор Вики Принт: Версия прошивки ККТ 665.4.23 отсутствует в списке разрешённых. Обратитесь к администратору.»

  4. Авторизация кассира заблокирована. Для повторной попытки требуется перезагрузка кассового модуля.

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

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

image-20260330-121128.png

 

SetTouch

image-20260330-115418.png

 

SetSCO

image-20260330-112630.png

 

Сценарий 5. Неуспешная валидация по одному из ККТ

  1. К кассе подключены два ККТ Вики Принт, один из которых не соответствует минимальной версии.

  2. Касса отображает сообщение об ошибке и блокирует авторизацию кассира.

Сценарий 6. Проверка не производится

  1. К кассе подключён неподдерживаемый ККТ, либо в настройке задано невалидное значение, либо настройка отсутствует.

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

Дополнительная информация

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

Ограничения

  • Валидация версии прошивки поддерживается только для моделей ККТ:

    • Пирит 2Ф;

    • Вики Принт;

    • Пирит Лайт Ф.

  • При некорректном формате настройки или отсутствии значения валидация не выполняется.

  • Для неподдерживаемых моделей ККТ проверка не производится.

Настройка

Отредактируйте и выполните скрипт на кассе в базе данных catalog:

UPDATE public.sales_management_properties SET property_value='{"pirit2f100":"565.1.42","vikiprintf100":"665.4.42"}' WHERE module_name='FISCAL_CONFIG' and property_key='firmwareKKT.validation.minAllowedVersion';
  • в поле property_value установите требуемые значения прошивок ККТ в JSON-формате "ключ":"значение", где:

    • ключ - наименование модели ККТ,

    • значение - минимально разрешённая версия прошивки.

  • Поддерживаемые ключи:

    • pirit2f100 - ККТ Пирит 2Ф

    • vikiprintf100 - ККТ Вики Принт

    • pirit_lightf - ККТ Пирит Лайт Ф

 

В случае, если требуется распространить настройку на все кассы сети - выполните скрипт на сервере SetCentrum/SetRetail в базе данных set:

SELECT add_property('FISCAL_CONFIG', null, 'firmwareKKT.validation.minAllowedVersion', '{"pirit2f100":"565.1.42","vikiprintf100":"665.4.42"}', 'Минимально разрешённая версия прошивки ККТ', 10, 2, 0);

Статьи по теме