CSI-K, SetSCO (4:3) ◾ Вывод звуковых сигналов колонками при работе покупателя с КСО

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

CSI-K, SetSCO (4:3) ◾ Вывод звуковых сигналов колонками при работе покупателя с КСО

https://crystals.atlassian.net/browse/SCOC-1482

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

10.4.1.0

https://crystals.atlassian.net/browse/SCOC-2243

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

10.4.14.0

https://crystals.atlassian.net/browse/SCOC-2274

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

10.4.15.0

https://crystals.atlassian.net/browse/SCOC-2460

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

10.4.20.0

Описание

С версии 10.4.1.0 функциональность позволяет сопровождать действия покупателя на КСО звуковыми сигналами, чтобы расширить методы информирования покупателя о событиях на кассе.

В версию 10.4.8.0 вместе с функциональностью отложенного чека на КСО добавлен двукратный звук оповещения о создании отложенного чека.

В обновление 10.4.14.0 добавлены новые звуковые сигналы на КСО при запросе сканирования марки.

В версии 10.4.15.0 функциональность была расширена: теперь действия покупателя на КВП будут также сопровождаться звуковыми сигналами.

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

Звуковое сопровождение на кнопку "Вызов помощника"

1. Покупатель нажимает НАЧАТЬ на экране КСО или добавляет первый товар в чек.

2. Покупателю требуется помощь консультанта → покупатель нажимает кнопку Позвать помощника.

3. КСО воспроизводит звук "Ассистент уже спешит к Вам" → вместо кнопки вызова консультанта отображается сообщение Помощник идет к вам.

4. Консультант подходит к КСО и проходит авторизацию → воспроизведение звука приостановлено.

Звуковое сопровождение на ошибку “Извините, ничего не найдено"

1. Покупатель нажимает НАЧАТЬ на экране КСО или добавляет первый товар в чек.

2. Покупатель сканирует штрихкод несуществующего товара → на экране отображается сообщение об ошибке Извините, ничего не найдено → КСО воспроизводит Негативный звук.

image-20250410-121112.png

3. Покупатель сканирует далее верный штрихкод → воспроизведение звука приостановлено.

Звуковое сопровождение на успешную оплату

1. Покупатель добавляет произвольные товары в чек через пик-лист или сканирование → покупатель нажимает Начать оплату.

2. КСО переходит на экран выбора типов оплат → покупатель выбирает оплату Банковской картой.

3. Оплата прошла успешно → КСО воспроизводит Положительный звук.

Звуковое сопровождение при нажатии “Отложить чек”

1. Покупатель добавляет товары в чек → покупатель нажимает Перейти к оплате.

image-20241024-150850.png

2. КСО переходит на экран выбора типов оплаты → кнопка Отложить чек доступна для покупателя → покупатель нажимает кнопку Отложить чек.

image-20241024-151027.png

3. На экране КСО появляется информационное сообщение Для оплаты наличными нажмите Продолжить и пройдите для оплаты на кассу → покупатель нажимает кнопку Продолжить → на кассе воспроизводится двукратный звук, информирующий о создании отложенного чека → печатается нефискальный документ с штрихкодом для восстановления данного чека.

image-20241024-151724.png

Звуковое сопровождение при добавлении в чек маркированного товара

1. Покупатель сканирует штрихкод маркированного товара.

2. КСО открывает экран запроса сканирования марки и воспроизводит звук Просканируйте марку товара.

image-20250410-143849.png

3. Покупатель сканирует марку → звук приостановлен.

image-20250410-144602.png

Звуковое сопровождение при добавлении в чек акцизного товара

1. Покупатель сканирует штрихкод товара с акцизной маркой.

2. КСО открывает экран запроса сканирования акцизной марки и воспроизводит звук Просканируйте акцизную марку.

image-20250410-145157.png

3. Покупатель сканирует акцизную марку → звук приостановлен.

image-20250410-145237.png

КВП приняла вес товара и добавила его в чек

1. Покупатель сканирует штрихкод товара → покупатель кладет товар на КВП.

2. КСО успешно приняла вес товара → товар добавлен в чек → КСО воспроизводит звук успешного добавления товара на КВП.

Пример работы отрицательного сценария

Отсутствует файл для звукового сопровождения

1. Покупатель нажимает НАЧАТЬ на экране КСО или добавляет первый товар в чек.

2. Покупателю требуется помощь консультанта → покупатель нажимает кнопку Позвать помощника.

3. Звуковое сопровождение отсутствует

4. Консультант подходит к КСО и проходит авторизацию.

Добавление маркированного товара через меню помощника

1. Покупатель нажимает кнопку Позвать помощника.

2. Консультант подходит к КСО и проходит авторизацию

3. Консультант сканирует штрихкод маркированного товара → КСО открывает экран запроса сканирования марки и НЕ воспроизводит звук Просканируйте марку товара.

4. Консультант сканирует марку товара → товар добавлен в чек.

Ошибка на КВП “Это не тот товар, который вы просканировали…”

1. Покупатель сканирует штрихкод товара → КВП ожидает вес товара на платформе.

2. Покупатель кладет товар на КВП.

3. Вес товара на КВП не соответствует весу, записанному в БД → на экране КСО отображается сообщение Это не тот товар, который вы просканировали. Положите правильный товар или позовите помощника.

4. Покупатель кладет правильный товар на КВП.

5. КСО успешно приняла вес товара → товар добавлен в чек → КСО воспроизводит звук успешного добавления товара на КВП.

Ошибка на КВП “Сначала просканируйте товар”

1. Покупатель сканирует штрихкод товара → покупатель кладет отсканированный товар на КВП.

2. КСО успешно приняла вес товара → товар добавлен в чек → КСО воспроизводит звук успешного добавления товара на КВП.

3. Покупатель кладет еще один товар на КВП (без предварительного сканирования штрихкода).

4. На экране КСО отображается сообщение Сначала просканируйте товар → КСО воспроизводит звук Сначала просканируйте товар.

5. Покупатель убирает неотсканированный товар с КВП → звук приостановлен.

Ошибка на КВП “Верните товар на платформу”

1. Покупатель сканирует штрихкод товара → КВП ожидает вес товара на платформе.

2. Покупатель кладет товар на КВП → КСО успешно приняла вес товара → товар добавлен в чек → КСО воспроизводит звук успешного добавления товара на КВП.

3. Покупатель снимает товар с КВП → на экране КСО отображается сообщение Верните товар на платформу → КСО воспроизводит звук Верните товар на платформу.

4. Покупатель кладет отсканированный товар обратно на КВП → звук приостановлен.

Ошибка КВП в момент оплаты “Снимите товар с весов”

1. Покупатель отсканировал в чек 3 товара → покупатель разместил 3 товара на КВП → КВП успешно приняла вес товаров.

2. Покупатель нажимает Начать оплату → КСО переходит на экран выбора типов оплаты.

3. Покупатель выбирает требуемый тип оплаты → КСО отправляет запрос в банк.

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

5. На экране КСО отображается сообщение Снимите товар с весов → КСО воспроизводит звук Снимите товар с весов.

6. Покупатель снимает лишний товар с КВП → звук приостановлен → оплата чека успешно завершена.

Ошибка КВП в момент оплаты “Верните товар на платформу” и “На весы положен неверный товар”

1. Покупатель отсканировал в чек 3 товара → покупатель разместил 3 товара на КВП → КВП успешно приняла вес товаров.

2. Покупатель нажимает Начать оплату КСО переходит на экран выбора типов оплаты.

3. Покупатель выбирает требуемый тип оплаты → КСО отправляет запрос в банк.

4. Покупатель снимает с КВП один из просканированных товаров.

5. На экране КСО отображается сообщение Верните товар на платформу → КСО воспроизводит звук Верните товар на платформу.

6. Покупатель кладет другой товар на КВП.

7. На экране КСО отображается сообщение На весы положен неверный товар → КСО воспроизводит звук Положен неверный товар.

8. Покупатель кладет товар на КВП, который был снять в шаге 3 → звук приостановлен → оплата чека успешно завершена.

Ограничения

1. Если звуковой файл отсутствует в папке /home/tc/storage/crystal-cash/media/sound, то звук не воспроизводится.

2. Внимание! Для моделей CSI K 32” и CSI K 27” требуется комплект колонок с внешней звуковой картой, который можно запросить через вашего менеджера в CSI.

3. Внимание! Для модели CSI s.kit комплект колонок не требуется. Убедитесь, что аудиокабель jack-jack 3,5mm подключен в монитор и системный блок.

4. При добавлении товара в чек сразу по марке звук scan_mark.mp3 не будет воспроизведен.

5. Звуковое сопровождение не будет работать при добавлении и удалении маркированных и акцизных товаров через меню помощника.

6. При ошибках валидации (SetMark, ЧЗ) во время добавления маркированного товара звуковых сигналов не будет. Обрабатываются только три ошибки, проверяемые на уровне КСО: Марка уже была добавлена в чек, Некорректная марка, Марка принадлежит другому товару.

Особенности 

Изначально в папке на кассе находятся дефолтные звуковые файлы (attendant, cash_payment, negative, positive, scan_excise, scan_mark, away_error_cwp, scan_error_cwp, inc_error_cwp, article_handled_cwp, pay_mode_item_places_error_cwp, pay_mode_wrong_item_returned_error_cwp, payment_reminder, print_check_refusal).

Для использования собственных звуковых файлов загрузите требуемые файлы в папку /home/tc/storage/crystal-cash/media/sound → измените названия файлов в соответствии с дефолтными настройками (attendant, cash_payment, negative, positive, scan_excise, scan_mark, away_error_cwp, scan_error_cwp, inc_error_cwp, article_handled_cwp, pay_mode_item_places_error_cwp, pay_mode_wrong_item_returned_error_cwp, payment_reminder, print_check_refusal).

image-20251009-153752.png

Настройка

Обратите внимание!

Все настройки в этой главе применимы только для ОС Tinycore.

Настройка звуковой карты

https://crystals.atlassian.net/browse/SCOP-901

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

10.4.9.0

Для корректной работы функциональности звукового сопровождения на КСО установите и настройте MPlayer и ALSA (Advanced Linux Sound Architecture) под текущую звуковую карту.

1. Загрузите на кассу файл в папку /home/tc/storage.

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

cd /home/tc/storage sh ./enable_sound_tinycore.sh

3. После запуска скрипта отобразятся доступные звуковые устройства → введите номер требуемой звуковой карты.

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

Если будет обнаружена только одна звуковая карта - процесс настройки начнется автоматически.

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

4. Запустится процесс установки и настройки → после завершения перезагрузите кассу с помощью команды ниже.

cash restart

Настройка в базе данных 

Для включения функциональности выполните в базе данных 

set на сервере SetCentrum10/SetRetail10. 

UPDATE sales_management_properties SET property_value='{ "enable": true, "sounds": { "ATTENDANT": { "file": "attendant.mp3", "initTimeout": 100, "timeout": 2000, "repeat": 1 }, "NEGATIVE": { "file": "negative.mp3", "initTimeout": 100, "timeout": 2000, "repeat": 1 }, "SCAN_EXCISE": { "file": "scan_excise.mp3", "initTimeout": 100, "timeout": 5000, "repeat": 100 }, "SCAN_MARK": { "file": "scan_mark.mp3", "initTimeout": 100, "timeout": 5000, "repeat": 100 }, "POSITIVE": { "file": "positive.mp3", "initTimeout": 100, "timeout": 2000, "repeat": 1 }, "CASH_PAYMENT": { "file": "cash_payment.mp3", "initTimeout": 100, "timeout": 2000, "repeat": 1 }, "AWAY_ERROR_CWP": { "file": "away_error_cwp.mp3", "initTimeout": 2000, "timeout": 2000, "repeat": 1 }, "SCAN_ERROR_CWP": { "file": "scan_error_cwp.mp3", "initTimeout": 2000, "timeout": 2000, "repeat": 1 }, "PAYMENT_REMINDER": { "file": "payment_reminder.mp3", "repeat": 2, "timeout": 20000, "initTimeout": 20000 }, "INC_ERROR_CWP": { "file": "inc_error_cwp.mp3", "initTimeout": 2000, "timeout": 2000, "repeat": 1 }, "ARTICLE_HANDLED_CWP": { "file": "article_handled_cwp.mp3", "initTimeout": 100, "timeout": 2000, "repeat": 1 }, "PRINT_CHECK_REFUSAL": { "file": "print_check_refusal.mp3", "repeat": 1, "timeout": 2000, "initTimeout": 100 }, "PAY_MODE_ITEM_PLACES_ERROR_CWP": { "file": "pay_mode_item_places_error_cwp.mp3", "initTimeout": 100, "timeout": 2000, "repeat": 1 }, "PAY_MODE_WRONG_ITEM_RETURNED_ERROR_CWP": { "file": "pay_mode_wrong_item_returned_error_cwp.mp3", "initTimeout": 100, "timeout": 2000, "repeat": 1 } } }', send_status=0 WHERE module_name='SCO' and property_key='soundProperties';

Описание полей настройки

Название

Описание

Возможные значения

Название

Описание

Возможные значения

enable

Флаг включения звуковых сообщений

true/false

sounds

Объект с настройками типов звуковых сообщений

 

ATTENDANT, NEGATIVE, POSITIVE, CASH_PAYMENT, SCAN_EXCISE, SCAN_MARK, AWAY_ERROR_CWP, SCAN_ERROR_CWP, PAYMENT_REMINDER INC_ERROR_CWP, ARTICLE_HANDLED_CWP, PRINT_CHECK_REFUSAL, PAY_MODE_ITEM_PLACES_ERROR_CWP, PAY_MODE_WRONG_ITEM_RETURNED_ERROR_CWP

Типы звуковых сообщений. 

 

Данные ключевые слова не должны меняться.

 

file

Название файла для данного типа звукового сообщения.

Звуковые файлы находятся в папке /home/tc/storage/crystal-cash/media/sound.

Если требуемых файлов в данной папке не будет, то звуковое сообщение не проигрывается. 

Строка с названием аудиофайла

initTimeout

Начальная задержка воспроизведения данного типа звукового сообщения в миллисекундах.

[0, 2^63 - 1)

Оптимально ставить от 100 миллисекунд.

timeout

Задержка между воспроизведениями звукового сообщения, если количество повторений >1 в миллисекундах.

[0, 2^63 - 1)

repeat

Количество повторений определенного звукового сообщения

[0, 2^31 - 1)

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

Базовые звуки

10.4.1.0 10.4.8.0 10.4.14.0 10.4.15.0 10.4.20.0

Название звукового файла

Звуковое сообщение

Название звукового файла

Звуковое сообщение

attendant.mp3

Фраза "Ассистент уже спешит к Вам"

negative.mp3

Негативный звук

positive.mp3

Положительный звук

cash_payment.mp3

Двукратный звук

scan_excise.mp3

Просканируйте акцизную марку

scan_mark.mp3

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

away_error_cwp.mp3

Верните товар на платформу

scan_error_cwp.mp3

Вы просканировали не тот товар

inc_error_cwp.mp3

Сначала просканируйте товар

article_handled_cwp.mp3

Принятие веса КВП

pay_mode_item_places_error_cwp.mp3

Снимите товар с весов

pay_mode_wrong_item_returned_error_cwp.mp3

Положен неверный товар

payment_reminder.mp3

Отказ покупателя от печати чека

print_check_refusal.mp3

Напоминание на этапе оплаты

Соотношение события на кассе и звукового сигнала

10.4.1.0 10.4.8.0 10.4.14.0 10.4.15.0 10.4.20.0

Событие

Звуковой сигнал

Событие

Звуковой сигнал

Покупатель нажимает на кнопку Позвать помощника

Ассистент уже спешит к Вам.

На экране кассы отображается уведомление

"Помощник подойдет для подтверждение вашего возраста"

Ассистент уже спешит к Вам.

На экране кассы отображается предупреждающее сообщение 

"Отказ от сканирования марки"

Негативный звук/

Ассистент уже спешит к Вам.

На экране кассы отображается предупреждающее сообщение 

"Извините, ничего не найдено" (товар не найден, отсканирован

несуществующий штрихкод, повторное сканирование марки)

Негативный звук

На экране кассы отображается сообщение "Помощник подойдет

для редактирования чека"

Ассистент уже спешит к Вам.

Успешное завершение оплаты

Положительный звук

Ошибка при совершении оплаты

Негативный звук

На экране выбора типов оплат покупатель нажимает Отложить чек.

Двукратный звук

Покупатель сканирует штрихкод маркированного товара.

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

Покупатель сканирует штрихкод алкогольного товара.

Просканируйте акцизную марку.

Покупатель снял отсканированный товар с КВП.

Верните товар на платформу.

Покупатель кладет товар на КВП → вес товара не соответствует весу, записанному в БД КВП.

Это не тот товар, который вы просканировали. Положите правильный товар или позовите помощника.

Покупатель кладет на КВП товар, не сканируя его.

Сначала просканируйте товар.

КСО успешно приняла вес товара и добавила товар в чек.

Положительный звук принятия товара

Покупатель отказался от печати бумажной копии чека.

Отказ покупателя от печати чека

Покупатель бездействует на этапе оплаты.

Напоминание на этапе оплаты

Функциональность ниже работает только при включенном контроле веса на КВП во время оплаты

Инструкция по включению функциональности в статье CSI K ◾️ Контроль веса до проведения оплаты

После перехода к оплате покупатель кладет на КВП дополнительный товар

Снимите товар с весов.

После перехода к оплате покупатель снимает один из отсканированных товаров с КВП (1) → покупатель кладет на платформу другой товар → общий вес на платформе не соответствует весу отсканированных товаров (2)

1. Верните товар на платформу.

2. Положен неверный товар.

 

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