Внимание!

В версии 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/4273012907/CSI+K#%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B4%D0%BE-10.4.18.0, так и процесс после переноса настроек в БД - https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/4273012907/CSI+K#%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%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/SCOC-1515

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

10.4.2.0

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

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

10.4.19.0

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

Описание

Подробная информация о социальной карте, ее особенностях и преимуществах, а также инструкция по добавлению карты на сервер SetCentrum10/SetRetail10 в статье https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/442335322.

Доработка функциональности в версии 10.4.2.0 позволяет не отображать кнопку Социальная карта на странице доступных типов оплат, если социальная карта была применена ранее.

Ценность

возможность использования социальной карты на кассе самообслуживания (далее КСО);
снижение интервенции консультанта в процесс работы покупателя с КСО;
повышение лояльности покупателей;
возможность настроить доступность кнопки Социальная карта на КСО по времени и дням недели, например, только по будням с 8.00 до 14.00.

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

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

2. Покупатель сканирует в чек социальную карту → покупатель нажимает кнопку “Начать оплату” и переходит на экран выбора доступных типов оплат.

3. Кнопка Социальная карта неактивна, отображается полоса Социальная карта применена.

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

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

Кнопка социальная карта недоступна по времени

Для кнопки Социальная карта задана настройка доступности кнопки по времени с 8.00 до 12.00 часов.

1. Покупатель добавляет товары в 12.10.

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

3. Кнопка Социальная карта отсутствует на экране.

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

Кнопка социальная карта недоступна по дню недели

Для кнопки Социальная карта задана настройка доступности кнопки - только будни.

1. Покупатель добавляет товары ( в воскресенье).

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

3. Кнопка Социальная карта отсутствует на экране.

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

Ограничения

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

Настройки

Добавление социальной карты на сервер

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

Внимание! Если социальная карта добавлена на сервер как внутренняя карта, тогда разрешите использование серверного процессинга внутренних карт.

Для включения настройки на сервере SetCentrum10/SetRetail10 перейдите ниже на странице в пространство SetLoyalty → раздел Карты и счета → вкладка Настройки → Применение внутренних карт → включите настройку Использование серверного процессинга внутренних карт.

Включенная настройка будет сохранена автоматически.

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

Префикс социальной карты определяется параметром socialCardNumberRegex.

По умолчанию значение параметра ^964390\d{13}\s\d*, т. е. номер карты - 964390, 13 цифр, пробел и еще сколько угодно цифр.

Отредактируйте и выполните скрипт в базе данных

set на сервере.

Параметр	Значение

Параметр	Значение
"enable": false	Отображение кнопки по времени не применяется. Кнопка Социальная карта всегда доступна на экране выбора типов оплат.
"enable": true	Кнопка Социальная карта доступна на экране выбора типов оплат только по заданному расписанию.
"timeFrom": "чч:мм"	Время начала отображения кнопки.
"timeTo": "чч:мм"	Время окончания отображения кнопки.
"saleDays":	Дни недели, по которым отображается кнопка.

Пример настройки для разных дней недели и времени

{
   "enable": true,
   "saleTimePeriods": [
     {
"timeFrom": "05:00",
      "timeTo": "12:00",
     "saleDays": [
        "SUNDAY",
        "SATURDAY"
      ]
     },
 {
"timeFrom": "12:00",
      "timeTo": "17:00",
     "saleDays": [
    "MONDAY",
        "TUESDAY",
        "WEDNESDAY",
        "THURSDAY",
        "FRIDAY"
      ]
     }
   ]
 }

Включение кнопки "Социальная карта"

Настройка до 10.4.18.0

1. Откройте файл /home/tc/storage/crystal-cash/modules/techProcess/techProcess-system-config.xml на кассе.

Для включения отображения кнопки Социальная карта на экране выбора доступных типов оплат отредактируйте файл на каждой кассе, на которой кнопка должна быть доступна.

2. Введите значение для параметра <property name="socialCardNumber" → нажмите F2 для сохранения изменений.

Получится строка следующего вида:

<property name="socialCardNumber" value="9463907770000000000 00"/>

Значение для параметра должно соответствовать заданному шаблону в базе данных.

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

Настройка после обновления до 10.4.18.0

Выполните настройку на каждой кассе, на которой должна быть доступна кнопка Социальная карта.

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

 UPDATE sales_management_properties
SET property_value='Номер дежурной социальной карты, например, 9463907770000000000 00', send_status=0
WHERE module_name='SCO' and property_key='SOCIAL_CARD_NUMBER';

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

Изменение надписей

Данный способ кастомизации подходит в случае, если не настроен сервис синхронизации медиаконтента SetSync.

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

Подробная инструкция по загрузке медиаконтента в MinIO в статье CSI K ◾ Как изменить картинки на CSI K (брендирование CSI K).

1. Перейдите в папку /home/tc/storage/crystal-cash/config/localizations на кассе → скопируйте в папку файл для кастомизации надписей.

Можно изменить следующие параметры:

Надпись "Социальная карта москвича" - SOCIAL_CARD_CONFIRMATION_DIALOG_HEADER;
Сообщение "Подтвердите, что у покупателя есть социальная карта" - SOCIAL_CARD_CONFIRMATION_DIALOG_PARAGRAPGH;
Надпись "Социальная карта применена" на экране выбора типов оплаты - SOCIAL_CARD_APPLIED.

2. Отредактируйте файл кастомизации → для расшифровки требуемых формулировок из UTF8 в Unicode Escape используйте онлайн-инструмент → нажмите F2 для сохранения изменений.