https://crystals.atlassian.net/browse/SRTB-8974

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

1 Описание
2 Ценность
3 Примеры работы
4 Примеры отрицательных сценариев
5 Ограничения
6 Формат штрихкода с признаком алармирования
7 Настройка
8 Статьи по теме

Описание

Начиная с версии 10.4.11.0 реализована возможность распознавания штрихкода с признаком алармирования предварительно взвешенных товаров на весах самообслуживания, интегрированных с системой умного взвешивания, на кассах POS и SetTouch.

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

Ценность

Уменьшение количество инцидентов пересорта товара, чтобы сократить потери магазина, связанные с пересортицей товара.

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

Пример окна клавиатурной кассы

Пример окна SetTouch

Покупатель выбрал товар, совпадающий с рекомендацией внешней системы распознавания товара

Кассир сканирует ШК с весового товара Огурец с ШК: 46906599920000000.
Касса распознает признак алармирования 0000.
Касса добавляет товар в Чек.
В Kafka отправляет событие 20 - Добавление товарной позиции, в поле "alarmCode": 0000 указан признак алармирования. В полях, соответствующих информации о товаре, указывается информация о добавленном товаре - Огурец.

Покупатель выбрал товар, не совпадающий с рекомендацией внешней системы распознавания товара. Кассир добавил отсканированный товар

Кассир сканирует ШК с весового товара Виноград с ШК: 46906599910000011.
Касса распознает признак алармирования 0011.
Касса отображается сообщение “Проверьте отсканированный товар”.
Кассир выбирает “Товары совпадают” в окне с сообщением.
Товар добавляется в Чек.
В Kafka отправляет событие 20 - Добавление товарной позиции, в поле "alarmCode": 0011 указан признак алармирования. В полях, соответствующих информации о товаре, указывается информация о добавленном товаре - Виноград.

Система алармирования выключена

Кассир сканирует ШК с весового товара Яблоко с ШК: 46906599930001000.
Касса распознает признак алармирования 1000.
Касса добавляет товар в Чек.
В Kafka отправляет событие 20 - Добавление товарной позиции, в поле "alarmCode": 1000 указан признак алармирования.

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

Покупатель выбрал товар, не совпадающий с рекомендацией внешней системы распознавания товара. Кассир отменил добавление товара

Кассир сканирует ШК с весового товара Виноград с ШК: 46906599910000011.
Касса распознает признак алармирования 0011.
Касса отображается сообщение “Проверьте отсканированный товар”.
Кассир выбирает “Отменить добавление”.
Касса отменяет добавление товара в Чек.
В Kafka отправляет событие 23 - Отмена товара, в поле "alarmCode": 0011 указан признак алармирования. В полях, соответствующих информации о товаре, указывается информация об отсканированном товаре - Виноград.

На сервере выключена настройка “Распознавать штрихкод с алармированием”

В БД настроен штрих-код трансформер

Кассир сканирует ШК с весового товара Яблоко с ШК: 46906599930001000
Касса распознала отсканированный ШК.
Касса НЕ отображает сообщение “Проверьте отсканированный товар”.
Касса добавила товар в чек.

На сервере включена настройка “Распознавать штрихкод с алармированием”

В БД не настроен штрих-код трансформер

Кассир сканирует ШК с весового товара Яблоко с ШК: 46906599930001000
Касса не распознала ШК и отображает ошибку “Неизвестный штрихкод: 46906599930001000”

Ограничения

Код алармирования может быть любой длины и может состоять как из цифр, так и из букв. Исключением является 5-значный код, для его использования требуется дополнительная настройка функциональности EAN13+5, поэтому использовать 5-значный код не рекомендуется.
Также для 5-значного кода алармирования существует дополнительное ограничение: нельзя загружать код алармирования, состоящий только из 5 цифр (без первой буквы) , например 11111. Первым символом кода алармирования в этом случае обязательно должна быть буква.
ШК-трансформер, используемый для алармирования, не должен совпадать по длине с ШК-трансформером, используемым для других функциональностей (например, ШК уценки).

Формат штрихкода с признаком алармирования

Штрихкод может иметь следующий формат:

AAAAAAAAAAAAAEEEE, 17 знаков:

A - 13 цифр: EAN13 весового товара,
E - 4 символа: признак алармирования. Ограничения по количеству символов указаны в главе Ограничения.

Пример штрихкода с алармированием

Пример описания секций ШК-трансформера

fields:

ean13 - ean 13 весового товара
alarm - признак алармирования

position:

needProductСonformityСheck - проверка соответствия товара
- true - требуется проверка соответствия товара
- false - не требуется проверка соответствия товара

Примеры масок ШК-трансформера

Система алармирования включена, покупатель выбрал товар, не совпадающий с рекомендацией внешней системы распознавания товара (код 0011)

{
	"description": "ШК алармирования",
	"fields": [
		{
			"name": "ean13",
			"length": "13"
		},
		{
			"name": "alarm",
			"value": "0011"
		}
	],
	"inputRestrictions": {
		"scannerOnly": true
	},
	"result": {
		"productRef": {
			"barcode": {
				"source": "field",
				"value": "ean13"
			}
		},
		"position": {
			"attributes": {
				"needProductConformityCheck": true
			},
			"properties": [
				{
					"name": "alarmCode",
					"value": {
						"source": "field",
						"value": "alarm"
					}
				}
			],
			"prismaEventProperties": [
				{
					"name": "alarmCode",
					"value": {
						"source": "field",
						"value": "alarm"
					}
				}
			]
		}
	}
}

Система алармирования включена, покупатель выбрал товар, совпадающий с рекомендацией внешней системы распознавания товара (код 0000)

{
	"description": "ШК алармирования",
	"fields": [
		{
			"name": "ean13",
			"length": "13"
		},
		{
			"name": "alarm",
			"value": "0000"
		}
	],
	"inputRestrictions": {
		"scannerOnly": true
	},
	"result": {
		"productRef": {
			"barcode": {
				"source": "field",
				"value": "ean13"
			}
		},
		"position": {
			"attributes": {
				"needProductConformityCheck": false
			},
			"properties": [
				{
					"name": "alarmCode",
					"value": {
						"source": "field",
						"value": "alarm"
					}
				}
			],
			"prismaEventProperties": [
				{
					"name": "alarmCode",
					"value": {
						"source": "field",
						"value": "alarm"
					}
				}
			]
		}
	}
}

Cистема алармирования выключена (код 1000)

{
	"description": "ШК алармирования",
	"fields": [
		{
			"name": "ean13",
			"length": "13"
		},
		{
			"name": "alarm",
			"value": "1000"
		}
	],
	"inputRestrictions": {
		"scannerOnly": true
	},
	"result": {
		"productRef": {
			"barcode": {
				"source": "field",
				"value": "ean13"
			}
		},
		"position": {
			"attributes": {
				"needProductConformityCheck": false
			},
			"properties": [
				{
					"name": "alarmCode",
					"value": {
						"source": "field",
						"value": "alarm"
					}
				}
			],
			"prismaEventProperties": [
				{
					"name": "alarmCode",
					"value": {
						"source": "field",
						"value": "alarm"
					}
				}
			]
		}
	}
}

Настройка

1. Включите функциональность штрихкода-трансформера - выполните скрипт по базе данных set:

UPDATE sales_management_properties 
SET property_value = 'true',
    send_status = 0
WHERE module_name = 'CASH_BARCODE_PROCESSOR' 
  AND plugin_name = 'transformer' 
  AND property_key = 'enabled';

2. На сервере перейдите в Кассовый модуль → Шаблоны касс → Кассовый шаблон → Процесс торговли → Дополнительные настройки → установите флажок Распознавать штрихкод с алармированием → кликните СОХРАНИТЬ.

По умолчанию настройка выключена.

3. Выполните скрипт для задания маски для распознавания штрихкодов с алармированием.

В приведенном примере скрипта установлены следующие значения:

alarm: value = 0011; needProductСonformityСheck = true - система распознавания включена, проверка требуется;
alarm: value = 0000; needProductСonformityСheck = false - система включена, проверка соответствия не требуется;
alarm: value = 1000; needProductСonformityСheck = false - система выключена, проверка не требуется.

Отредактируйте значения при необходимости.

4. Перезагрузите кассовый модуль.

Портал поддержки продуктов CSI

SetRetail10 ◾️ Поддержка штрихкода с признаком алармирования для внешних систем распознавания товара