Внимание!

В версии 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/4746412214/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/4746412214/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-1735

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

10.2.90.0

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

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

10.4.18.0

1 Описание
2 Ценность
3 Пример работы успешного сценария
4 Пример работы отрицательного сценария
- 4.1 У покупателя 0 бонусных баллов
5 Ограничения
6 Настройка
7 Статьи по теме

Описание

Начиная с версии 10.2.90.0 на кассе самообслуживания доступно использование бонусных баллов. После обновления на версию 10.3.4.0 стало возможным списание бонусов при работе с КСО с подтверждением по SMS, в том случае, если покупатель забыл бонусную карту, но хотел бы воспользоваться картой лояльности.

Также с версии 10.4.9.0, как при использовании бонусов внешних плагинов лояльности, так и при использовании бонусов SetRetail10, на КСО покупателю будет отображаться диалоговое окно с предложением списать доступные бонусные баллы (при условии наличия карты лояльности в чеке).

Ценность

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

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

Включена настройка расчета скидок при переходе к оплате

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

2. Покупатель сканирует штрихкод бонусной карты → цвет баннера меняется на зеленый → текст сообщения меняется на Скидки буду рассчитаны после перехода к оплате! Доступно бонусных баллов <количество бонусов на счету покупателя> → покупатель нажимает Начать оплату.

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

4. Количество баллов к списанию заполняется автоматически (в зависимости от баланса на счету и условий кассовой механики), или покупатель вводит другое требуемое значение → покупатель нажимает Подтвердить.

5. Чек оплачен бонусными баллами → покупатель забирает товары и уходит.

Включена настройка пред-расчета скидок

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

2. Покупатель сканирует штрихкод бонусной карты → цвет баннера меняется на зеленый → текст сообщения меняется на Карта добавлена. Доступно бонусных баллов <количество бонусов на счету покупателя> → цены товаров пересчитаны с учетом скидок, ниже указана сумма к оплате → покупатель нажимает Начать оплату.

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

4. Количество баллов к списанию заполняется автоматически (в зависимости от баланса на счету и условий кассовой механики), или покупатель вводит другое требуемое значение → покупатель нажимает Подтвердить.

5. Чек оплачен бонусными баллами → покупатель забирает товары и уходит.

Подтверждение списания бонусов

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

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

3. Отображается всплывающее окно с предложением списать бонусы с текстом В чеке можно списать бонусы На карте ХХХ бонусов Списать YYY бонусов? и двумя кнопками Отменить и Списать → покупатель нажимает Списать.

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

Отказ от списания бонусов

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

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

3. Отображается всплывающее окно с предложением списать бонусы с текстом В чеке можно списать бонусы На карте ХХХ бонусов Списать YYY бонусов? и двумя кнопками Отменить и Списать → покупатель нажимает Отменить.

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

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

У покупателя 0 бонусных баллов

Начиная с версии 10.4.14.7.

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

2. Бонусная карта добавлена в чек → информационная красная полоса с текстом Для получения скидки просканируйте вашу карту меняется на зеленую с текстом Карта добавлена → баланс карты не отображается, так как у покупателя на счету 0 баллов.

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

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

Ограничения

Начиная с версии 10.4.14.7 изменен механизм применения бонусных баллов: ранее, если на бонусном счету покупателя было 0 баллов, то способ оплаты бонусными баллами на КСО все равно был доступен.

При этом при выборе данного способа оплаты покупателю отображалась информация о бонусных баллах на карте и баллах, доступных к списанию. Если списание было невозможно, тогда покупатель могу вернуться к выбору других способов оплаты нажатием кнопки Назад.

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

Настройка

Настройка бонусного процессинга на сервере

Обратите внимание, для корректной работы функциональности начисления и списания бонусов (бонусы SetRetail10) на сервере одновременно должны быть запущены две кассовые механики:

1. Начисление бонусных баллов; результатом кассовой механики является Зачисление бонусов;

2. Списание бонусных баллов; результатом кассовой механики является Применение бонусов Бонусы как скидка.

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

Использование бонусов SetRetail10

Использование бонусов внешних плагинов лояльности

Настройка кассовых механик

https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/3983278254.

Настройка использования бонусных баллов на КСО

Настройка в шаблоне кассы

1. Войдите на сервер SetCentrum/SetRetail10 → перейдите в раздел Кассовый модуль → вкладка Шаблоны касс → выберите шаблон кассы самообслуживания → кликните Редактировать.

2. В шаблоне кассы перейдите в раздел ПРОЦЕСС ТОРГОВЛИ → вкладка НАСТРОЙКИ → меню Типы оплат → включите Оплата бонусной картой → кликните Сохранить.

Доступные бонусные процессинги

Бонусный процессинг	Параметр для настройки

Бонусный процессинг

Параметр для настройки

Бонусы SetRetail10

(бонусы внутренней системы лояльности)

<property name="bonusAsDiscountType" value="BONUS_SR10"/>

Бонусы SetAPI

(бонусы внешней системы лояльности)

<property name="bonusAsDiscountType" value="SET_API"/>

Бонусы Informix

<property name="bonusAsDiscountType" value="INFORMIX"/>

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

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

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

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

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

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

UPDATE sales_management_properties
SET property_value='Название бонусного процессинга' -- SET_API, INFORMIX, BONUS_SR10
, send_status=0
WHERE module_name='SCO' and property_key='BONUS_AS_DISCOUNT_TYPE';

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

Настройка отображения окна с предложением списать бонусы

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

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

10.4.9.0

Окно для списания бонусов доступно только для двух бонусных процессингов: бонусы SetAPI (SET_API) и бонусы SetRetail10 (BONUS_SR10).

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

Настройка подтверждения списания бонусов через SMS

Инструкция по настройке и примеры работы функциональности описаны в статье https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/3220406330.

CSI K ◾ Применение бонусных баллов на КСО