Внимание!

В версии 10.4.18.0 часть настроек КСО была перенесена из конфигурационного файла /home/tc/storage/crystal-cash/modules/techProcess/techProcess-system-config.xml в базу данных catalog в таблицу sales_management_properties.

Это касается следующих настроек:

bonusAsDiscountType → BONUS_AS_DISCOUNT_TYPE (Включение списания бонусов как скидки);
enableDCMode → ENABLE_DC_MODE (Показывать экран запроса ДК);
bypassItems → BYPASS_ITEMS (Список товаров, вес которых не проверяется);
itemsWithoutBarcode → ITEMS_WITHOUT_BARCODE (Список товаров без штрихкода);
printPaymentSlipsAsOne → PRINT_PAYMENT_SLIPS_AS_ONE (Печатать все слипы оплат одним документом);
ageRequiredIgnore → AGE_REQUIRED_IGNORE (Игнорировать возрастные ограничения);
doubleScanInterval → DOUBLE_SCAN_INTERVAL (Защита от двойного сканирования (мс));
awaitingListSize → AWAITING_LIST_SIZE (Кол-во товаров в буфере для подтверждения);
packingTik → PACKING_TIK (Кол-во «тиков» без изменения веса до блокировки);
socialCardNumber → SOCIAL_CARD_NUMBER (Номер дежурной соц. карты);
bankCardLikeDiscountIgnore → BANK_CARD_LIKE_DISCOUNT_IGNORE (Игнорировать банковскую карту, похожую на скидку);
countableGoods → COUNTABLE_GOODS (Для этих товаров запрашивается ввод количества);
errorStackEnable → ERROR_STACK_ENABLE (Обработка ошибок через стек);
giftCardOnlyMSR → GIFT_CARD_ONLY_MSR (Подарочная карта считывается только сканером MSR);
internalScannerBeeper → INTERNAL_SCANNER_BEEPER (Использовать звук из сканера);
packingTime → PACKING_TIME (Время упаковки товаров после покупки).

В статье ниже будет описан как изначальный процесс настроек - https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/4102226034/CSI+K#%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B2-XML-%D1%84%D0%B0%D0%B9%D0%BB%D0%B5-(%D0%B4%D0%BE-10.4.18.0), так и процесс после переноса настроек в БД - https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/4102226034/CSI+K#%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B2-%D0%B1%D0%B0%D0%B7%D0%B5-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85-(%D0%BF%D0%BE%D1%81%D0%BB%D0%B5-%D0%BE%D0%B1%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D1%8F-%D0%B4%D0%BE-10.4.18.0).

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

10.2.26.0

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

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

10.4.18.0

1 Описание
2 Пример работы
3 Настройка
4 Статьи по теме

Описание

С версии 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. На экране КСО появляется сообщение для покупателя о невалидности примененного купона → покупатель нажимает Ок.

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

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

Настройка

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

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

На КСО используются также купоны внешних плагинов лояльности. Подробная информация в статье https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/4243914869/SetLoyalty+API#SetLoyalty◾️API-SetLoyalty%E2%97%BE%EF%B8%8FAPI-%D0%9A%D1%83%D0%BF%D0%BE%D0%BD%D1%8B.

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

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

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 изменена логика работы КСО с позиционными купонами.

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

система начинает отсчёт времени до отмены купона или добавления товара (по умолчанию - 10 секунд, значение настраиваемое);
отображается окно с подсказкой для покупателя отсканировать товар - в течение 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)

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

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

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

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

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

Пример измененного текста подсказки

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

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

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

название файла - coupon_scan_done;
размер изображения - 460 х 460 px.;
формат изображения -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 информирование покупателя не будет происходить.

Настройка в XML-файле (до 10.4.18.0)

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

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

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

Настройка в базе данных (после обновления до 10.4.18.0)

1. Выполните скрипт ниже на кассе в базе данных catalog в таблице sales_management_properties.

UPDATE sales_management_properties
SET property_value='SET_API', send_status=0
WHERE module_name='SCO' and property_key='BONUS_AS_DISCOUNT_TYPE';

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

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