CSI K ◾️ Применение и отмена позиционного купона в чеке

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

CSI K ◾️ Применение и отмена позиционного купона в чеке

https://crystals.atlassian.net/browse/SCO-26

10.2.26.0

Описание

С версии 10.2.26.0 добавлена функциональность использования купонов (обычных и позиционных) для получения скидки при работе с кассой самообслуживания.

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

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

Применение обычного купона на КСО

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

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

3. На экране отображается сообщение Отсканируйте штрихкод купона или введите его номер вручную → покупатель нажимает Ввести номер купона.

4. Покупатель вводит номер купона → нажимает Применить.

5. На экране отображается информационное сообщение Погашен купон "<название купона>" с номером <номер купона>.

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

7. КСО возвращается на экран выбора типов оплат → покупатель закрывает чек любым доступным способом.

Применение позиционного купона на КСО

1. Покупатель сканирует штрихкод позиционного купона на стартовом экране → на экране отображается сообщение Купон добавлен в чек Скидки будут рассчитаны при переходе к оплате.

2. На КСО запускается таймер 10 секунд → покупатель сканирует штрихкод товара до истечения 10 секунд → товар добавляется в чек → к товару применяется купон и соответствующая скидка.

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

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

Информирование покупателя о невалидном купоне

1. Покупатель подходит к КСО и сканирует невалидный купон с номером штрихкода 286143102458.

2. На экране КСО появляется сообщение для покупателя с инструкцией по применению купона.

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

4. Покупатель нажимает Начать оплату.

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

image-20250421-101305.png

6. КСО переходит на экран выбора типа оплаты → скидка к товару НЕ применена.

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

Настройка

Настройка купонов на сервере

Основная информация о разных видах купонов, их применении в рамках программы лояльности и инструкция по работе с редактором купонов в разделах SetLoyalty ◾️ Купоны и SetRetail10 ◾️ Купоны.

На КСО используются также купоны внешних плагинов лояльности. Подробная информация в статье SetLoyalty ◾️ API | SetLoyalty◾️API Купоны.

Включение отображения купонов на экране выбора типов оплат

Для включения отображения купонов выполните скрипт в базе данных catalog на кассе.

UPDATE sales_management_properties SET property_value='true', send_status=0 WHERE module_name='SCO' and property_key='SHOW_COUPONS_ON_PAYMENT_SCREEN';

Настройка использования позиционных купонов

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

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

10.3.31.0

Начиная с версии 10.3.31.0 изменена логика работы КСО с позиционными купонами.

При сканировании позиционного купона в чек до добавления товаров:

  1. система начинает отсчёт времени до отмены купона или добавления товара (по умолчанию - 10 секунд, значение настраиваемое);

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

Купон отменяется, если:

  • в течение 10 секунд не отсканирован товар,

  • нажата кнопка Назад.

Таймаут ожидания сканирования товара

Для настройки таймаута ожидания сканирования товара отредактируйте и выполните скрипт в базе данных catalog на кассе. По умолчанию значение параметра = 10 секунд.

UPDATE sales_management_properties SET property_value='Таймаут(сек) ожидания сканирования товара после применения позиоционного купона', send_status=0 WHERE module_name='SCO' and property_key='positionalCouponScanTimeout';

Как изменить текст окна подсказки для сканирования товара (SetSCO 4:3)

Обратите внимание, кастомизация окна подсказки доступна только для кассы самообслуживания SetSCO (визуализация 4:3).

Вид окна подсказки по умолчанию на SetSCO (касса 4:3)

image-20250421-092130.png

1. Для изменения текста отредактируйте значение параметра PAYMENT_COUPON_ADDED в файле /home/tc/storage/crystal-cash/config/localizations/res-custom_ru.properties.

Если файла в папке нет, тогда скачайте  в указанную папку на кассу. 

image-20250421-090300.png

2. Переведите целевой текст из кодировки UTF-8 в Unicode Escape с помощью онлайн-инструмента.

image-20250421-090938.png

3. Вставьте расшифровку в файл, чтобы получилось выражение ниже → сохраните изменения в файле.

PAYMENT_COUPON_ADDED = \u0421\u043a\u0438\u0434\u043a\u0438\u0020\u0431\u0443\u0434\u0443\u0442\u0020\u0440\u0430\u0441\u0441\u0447\u0438\u0442\u0430\u043d\u044b\u0020\u043f\u043e\u0441\u043b\u0435\u0020\u043f\u0435\u0440\u0435\u0445\u043e\u0434\u0430\u0020\u043a\u0020\u043e\u043f\u043b\u0430\u0442\u0435\u002e\u0020\u041f\u0440\u043e\u0441\u043a\u0430\u043d\u0438\u0440\u0443\u0439\u0442\u0435\u0020\u0448\u0442\u0440\u0438\u0445\u043a\u043e\u0434\u0020\u0442\u043e\u0432\u0430\u0440\u0430\u0020\u0438\u043b\u0438\u0020\u0434\u043e\u0431\u0430\u0432\u044c\u0442\u0435\u0020\u0435\u0433\u043e\u0020\u0438\u0437\u0020\u043f\u0438\u043a\u002d\u043b\u0438\u0441\u0442\u0430\u002e
image-20250421-131557.png

4. Перезагрузите кассу.

image-20250421-131409.png
Пример измененного текста подсказки

Как изменить картинку

Для изменения картинки поместите изображение в папку /home/tc/storage/crystal-cash/images.

Требования для изображения:

  • название файла - coupon_scan_done;

  • размер изображения - 460 х 460 px.;

  • формат изображения -png.

image-20250422-152357.png

Включение информирования покупателя (CSI-K)

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

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

10.4.14.0

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

Обратите внимание, функциональность работает только для купонов внешних систем лояльности. При использовании купонов базовой лояльности (SR10) или SLS информирование покупателя не будет происходить.

1. Подключитесь к кассе → откройте файл /home/tc/storage/crystal-cash/modules/techProcess/techProcess-system-config.xml.

2. Для включения сообщений от плагина лояльности вставьте в файл строку <property name="bonusAsDiscountType" value="SET_API"/> →  сохраните изменения в файле.

3. Перезагрузите кассу.

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

© 1994-2025, ООО «Кристалл Сервис Интеграция».
Все права защищены..

Политика обработки персональных данных