Описание

В предыдущих версиях SetKiosk при сканировании уцененного товара на экране прайс-чекера отображалась только стандартная цена — цена уценки не показывалась. Покупателю приходилось полагаться исключительно на этикетку, наклеенную на товар, без возможности проверить актуальность цены через прайс-чекер.

Функциональность отображения стоимости уцененного товара решает эту проблему: при сканировании штрихкода уцененного товара система автоматически распознаёт уценочный штрих-код, извлекает из него цену уценки и отображает на экране специальный шаблон с двумя ценами — зачёркнутой оригинальной и выделенной красным ценой уценки.

Структура уценочного штрихкода

Часть штрих-кода	Описание	Пример

Часть штрих-кода	Описание	Пример
Префикс	Признак уценочного ШК (например, 997, 98, 99, 998, 999, 3, 6666)	997
Штрихкод товара	Реальный ШК товара в базе Set10 (13 цифр)	2155896558968
CRC	Контрольные цифры (2 цифры)	77
Цена уценки	Цена в копейках (7 цифр)	0155555 (= 1555,55 руб.)

Пример полного ШК: 9972155896558968770155555

Ценность

Прозрачность для покупателя. Покупатель может проверить цену уцененного товара на прайс-чекере и убедиться, что она совпадает с ценой на этикетке.
Снижение количества ошибок. Исключается ситуация, когда покупатель видит на прайс-чекере полную цену и считает, что уценочная этикетка недействительна.
Удобство персонала. Консультанты и кассиры не тратят время на объяснение причин расхождения между ценой на этикетке и ценой на прайс-чекере.

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

При сканировании происходит разбор штрихкода товара, после чего на экране отображается цена уценки.

Настройка

1. Добавьте файл шаблона в папку шаблонов прайс-чекера files/screens. Путь к папке задаётся параметром customScreensFolder в файле /opt/set-kiosk/application.yaml. Данный файл определяет визуальное оформление экрана с двумя ценами — перечёркнутой оригинальной и выделенной красным ценой уценки.

Готовый пример шаблона указан в задаче https://crystals.atlassian.net/browse/SRTS-4249.

2. Выполните настройки в файле конфигурации приложения /opt/set-kiosk/application.yaml

Готовый пример .

3. Установите настройки для отображения штрихкода уценки:

  # настройки для парсинга ШК
  barcodeSettings:
    # признак включенной настройки
    enabled: true
    # Регулярное выражение для парсинга ШК. например, bookId=0*(?<barcode>[^&]+)
    # Можно задать название группы "?<barcode>"; если имя группы не задано, то берется первая найденная группа.
    # Появились группы уценки (?<markdownBarcode>\\d{длинна кода}) и ?<markdownPrice>\\d{длинна кода}). Без объявления групп
    # уценочная логика не работает (отработает старое поведение).
    # Если по регулярному выражению ничего не найдено (или регулярное выражение не задано), то используется отсканированный ШК целиком
    regex: ^((?<prefix>98|99|997|998|999|3|6666)(?<markdownBarcode>\d{13})\d{2}(?<markdownPrice>\d{7}))$

Конфигурация экрана №7 в `application.yaml`

В секции screenSettings.screens файла application.yaml необходимо добавить блок для экрана №7:

screenSettings:
  screens:
    - number: 7
      name:
        price7: "Цена уценки"
      condition: price7 != null

Условие price7 != null означает, что экран №7 будет автоматически выбран только в том случае, если при парсинге штрихкода была успешно извлечена цена уценки (именованная группа markdownPrice в regex). Если товар не уценён — используется стандартный шаблон.

Описание параметров:
- enabled: true — включает функциональность парсинга штрихкода.
- regex: ^((?<prefix>98|99|997|998|999|3|6666)(?<markdownBarcode>\d{13})\d{2}(?<markdownPrice>\d{7}))$ — задает регулярное выражение, по которому будет парситься штрихкод.
- 98|99|997|998|999|3|6666 — перечень возможных префиксов, по которым определяется штрихкод уценки.
- ?<markdownBarcode>\d{13} — основной штрихкод товара, по которому в Set10 будет получена информация о товаре (13 — длина штрихкода).
- \d{2} — контрольные цифры (CRC).
- ?<markdownPrice>\d{7} — цена уценки (7 — количество цифр в значении цены).

Пример разбора штрих-кода ценки для вывода на экран прайс-чекера

9972155896558968770155555

997 — префикс.
2155896558968 — реальный штрихкод в базе SetRetail10.
77 — контрольные цифры (CRC).
0155555 — цена 1555,55.