Настройка отображения диалога выбора пакетов

На кассе самообслуживания пользователю может быть предложено добавить пакеты к покупке.
Если настройка suggestAddBag включена, то будет отображаться диалог с ценой пакета, в котором можно выбрать количество пакетов или отменить добавление.
При включении настройки suggestAddBagManualInput будет отображаться диалог ввода с цифровой клавиатурой. В диалоге кнопка "Без пакета" отключается, если введено количество.

При включении настройки suggestAddBag требуется указать для параметра bagBarcode первым значением штрих-код товара, который будет добавлен в чек в качестве пакета.

Диалог может отображаться:

• при переходе из формирования в оплату,
• при переходе из приветствия в формирование по кнопке "Начать" или сканированием позиции.
  

Если в чеке уже есть пакеты, то в диалогах добавления пакетов будет отображаться общее количество добавленных пакетов.

Отображение картинки в диалоге

В диалог предложения пакетов можно добавить изображение. Для этого нужно подкинуть картинку с названием add_bag.png в /opt/sst-sco/themes/<используемая тема оформления>/icons.
Изменить размер изображения можно через параметр addBagIconHeight из группы параметров geometry (в theme.json).

[Theme]
geometryAddBagIconHeight = "200px"

Настройка формы добавления пакетов

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

Строка и столбец – это числовые значения, которые задают относительный порядок пакетов. Столбец опционален, и если столбец не указан, значит в строке один пакет.

[Check]
suggestAddBag = true
bagBarcode = 123, 321

[Check.addBag.1]
code = 123
[Check.addBag.2]
code = 321
[Check.addBag.3]
own = true

[Check.addBag]
spacing = 50

Добавление пакетов по кнопке

Также диалог добавления пакета можно назначить на кнопку действия с командой CHECK_ADDBAG. С её помощью в режиме формирования чека пользователь может самостоятельно добавить пакеты в нужном количестве. Работа кнопок не зависит от параметров suggestAddBag и addBagItems. Параметр bagBarcode обязателен к корректному заполнению.

Действие CHECK_ADDBAG имеет следующие параметры:

По нажатию кнопки из примера ниже отобразится диалог выбора одного пакета ( со штрих-кодом "99") с сообщением "Добавить пакет к покупке?" и с новой строки "Цена: <цена за единицу>" . 

[Check]
bagBarcode = 99

[Check.FormingForm.actions.4]
; Кнопка добавления пакета
command = CHECK_ADDBAG
text = customAddBag
count = 1
message = customAddBagMsg

[I18n.ru]
customAddBag = Добавить пакет
customAddBagMsg = Добавить пакет к покупке?\nЦена: %1

Если видов пакетов для добавления несколько (например, средний и маленький), то можно для каждого настроить отдельную кнопку. Например:

[Check]
bagBarcode = 99, 123

[Check.FormingForm.actions.4.1]
; Кнопка добавления пакета
command = CHECK_ADDBAG
text = customAddBagSmall
addOne = true
barcodeIndex = 0

[Check.FormingForm.actions.4.2]
; Кнопка добавления пакета
command = CHECK_ADDBAG
text = customAddBagMiddle
addOne = true
barcodeIndex = 1

[I18n.ru]
customAddBagSmall = Маленький\nпакет
customAddBagMiddle = Средний\nпакет

Добавление пакета покупателя

Покупателю может быть предоставлена возможность добавить свой пакет на контрольные весы.

При значении параметра ownBag=true во всех возможных диалогах добавления пакетов дополнительно появляется кнопка "Свой пакет". Также кнопка "Свой пакет" может быть доступна в форме выбора пакетов.
При нажатии на кнопку "Свой пакет" разрешается положить на весовую платформу пакет покупателя в рамках допустимого веса, заданного параметром ownBagMaxWeight. При превышении веса отобразится соответствующая ошибка. Если добавить допустимый вес, то можно будет продолжить покупки. Пакет покупателя не добавляется в чек. 

Вес пакета учитывается при увеличении веса от 1 до ownBagMaxWeight включительно.

Кнопка "Свой пакет" скрывается со всех форм при превышении лимита добавлений пакета покупателя, заданного параметром ownBagLimit.

Если модуль контроля веса выключен, то кнопка "Свой пакет" в диалогах будет доступна постоянно.

В ошибке веса пакета покупателя можно изменить изображение. Для этого нужно подкинуть картинку с названием incorrect_weight_own_bag.png в /opt/sst-sco/themes/<используемая тема оформления>/hints.

Контроль веса пакетов

Для пакетов, которые добавляются в чек и на контрольные весы, необходимо включить контроль веса пакетов.

Необходимо установить обязательный ручной эталон в диапазоне от 0 до веса пакета.

Если значение параметра bagWeightControl=false, то можно избежать ошибок веса при добавлении пакетов, увеличив общую погрешность весов до веса пакета параметром scaleError.