Начиная с версии 10.3.2.0 файл плагина входит в состав дистрибутива сервера, а также в патчи обновления сервера и кассы. Отдельная установка не требуется.

Платформа «ЦФТ-Лояльность» – инструмент для бизнеса любого масштаба с широкой возможностью кастомизации решений для банковского сектора, ритейла, страховых компаний и других участников рынка. В рамках SetRetail10 - это внешний бонусный процессинг.

Официальный сайт - https://loyalty.cft.ru/

Настройка плагина

Добавление процессинга

1. На сервере SetRetail/SetCentrum перейдите в Интеграция → Внешние процессинги → кликните

.

2. Введите в строке поиска ЦФТ → кликните Внешние процессинги лояльности → установите флажок ЦФТ-Лояльность → кликните

.

3. Кликните по процессингу ЦФТ-Лояльность.

Список настроек

Начиная с версии 10.3.21.0 изменились названия вкладок и состав. Настройка вкладок до версии 10.3.21.0.

Произведите настройку процессинга на вкладках → кликните

.

Вкладка "ОБЩИЕ"

Настраивается соединение с процессингом и сертификаты подключения к нему.

Название настройки	Описание	Пример

Название настройки	Описание	Пример
URL Purchase API *	URL сервиса ЦФТ	https://loystg-api.demo.korona.net:11450/purchase/v1
Таймаут соединения, сек. *	Таймаут соединения в секундах	3
Таймаут ожидания ответа, сек. *	Таймаут ожидания ответа в секундах	5
Список кодов ошибок HTTP, по которым должна выполняться переотправка запросов	Коды ошибок при HTTP-запросах, для которых требуется повторная отправка	500, 501, 503
Файл цепочки корневых сертификатов (PEM-файл)	Файл со списком корневых сертификатов
Файл клиентского сертификата (PFX-файл)	Файл с клиентским сертификатом
Пароль к файлу хранилища клиентского сертификата	Пароль к файлу клиентского сертификата	testPC03
Настройки подарочных карт	JSON-файл с настройками подарочных карт
Шаблоны слип-чеков (json-формат)	JSON-файл с шаблонами печати слип-чеков для различных операций
Печатать слип вне чека	Флажок для печати слип-чеков
Идентификатор сети бонусных карт *	Идентификатор сети карт лояльности ЦФТ	248599
Идентификатор сети подарочных карт *	Идентификатор сети ПК ЦФТ	248599
Идентификатор партнера *	Идентификатор участника ЦФТ	248598
Внешний идентификатор торговой точки *	Идентификатор торговой точки ЦФТ	set10_plugin_point
Внешний идентификатор кассы *	Идентификатор кассы торговой точки ЦФТ	pos1
Электронный чек по e-mail https://crystals.atlassian.net/browse/SR-5848 https://crystals.atlassian.net/browse/CR-7821 10.3.19.0	При установленном флажке чек будет отправлен на электронную почту клиента
Регулярное выражение для проверки e-mail https://crystals.atlassian.net/browse/SR-5848 https://crystals.atlassian.net/browse/CR-7821 10.3.19.0	Выражение для проверки адреса электронной почты на корректность	^[^\.@]+(\.[^\.@]+)*@[^\.@]+(\.[^\.@]+)+$
Генерировать внешний идентификатор кассы https://crystals.atlassian.net/browse/SR-5991 https://crystals.atlassian.net/browse/CR-6895 10.3.21.0	При установленном флажке внешний идентификатор кассы генерируется в соответствии с шаблоном для каждой кассы
Шаблон для генерации внешнего идентификатора кассы https://crystals.atlassian.net/browse/SR-5991 https://crystals.atlassian.net/browse/CR-6895 10.3.21.0	Шаблон для генерации внешнего идентификатора кассы. Формат шаблона: `Kassa<pos_number>` `Kassa` - произвольный текст `<pos_number>` - автоматически подставляется номер кассы	Kassa<pos_number>

Настройки файла cft-gift-cards.json

Название настройки	Описание	Пример

Название настройки	Описание	Пример
goodsMarking https://crystals.atlassian.net/browse/SR-5846 https://crystals.atlassian.net/browse/CR-6822 10.3.21.0	Артикул плагинного товара Подарочная карта ЦФТ. Подарочная карта загружается как плагинный товар с типом `ProductSetApiEntity` и `id` плагина ЦФТ в свойствах. Начиная с версии 10.3.25.0 настройки по префиксам для магнитной ленты и длинам и префиксам штрихкодов добавляются строкой в формате JSON в импортированный товар в свойство `plugin-property` по ключу `payload.` https://crystals.atlassian.net/browse/SR-6274 https://crystals.atlassian.net/browse/CR-9452 10.3.25.0	12543212
barcodePrefixes	Префиксы карт, добавленных сканированием штрих-кода Формат: длина-префикс; длина-префикс,префикс	16-776;19-775,776
cardPrefixes	Префиксы карт, добавленных прокатыванием магнитной полосы	775,776
fixedRate	Признак фиксированного номинала подарочной карты	false
minRate	Минимальная сумма для зачисления для подарочных карт с нефиксированным номиналом	5000
maxRate	Максимальная сумма для зачисления для подарочных карт с нефиксированным номиналом	15000
saleDenied	Признак запрета продажи подарочной карты	false
requireCvcCode	Признак требования ввода CVC-кода/пин-кода перед оплатой по ПК	true
refundPrepayment	Признак возможности возврата предоплаты (оплаты по ПК)	true
refundCardMaxRate	Максимальный номинал возвратной ПК (максимальная сумма для зачисления)	100

Настройки файла default_templates.json

Название	Описание

Название	Описание
bns_hold	Операция холдирования бонусов
bns_confirm	Операция подтверждения бонусов
bns_refund	Операция возврата бонусов
giftcard_goods	Операция продажи ПК
giftcard_payment	Операция оплаты/возврата ПК

Шаблоны печати поддерживают:

Условия

    {
      "value": "{% if is_online %}"
    },
    {
      "value": "ОНЛАЙН"
    },
    {
      "value": "{% else %}"
    },
    {
      "value": "ОФЛАЙН"
    },
    {
      "value": "{% endif %}"
    }

Циклы

    {
      "value": "{% for i in items %}"
    },
    {
      "value": "ЭЛЕМЕНТ {{ i }}"
    },
    {
      "value": " {% endfor %}"
    }

Форматирование даты

   {
     "value": "Дата без форматирования: {{ date }}"
   },
   {
     "value": "Дата в формате 'YYYY/MM/dd' : {{ date.format('YYYY/MM/dd') }}"
   },
   {
    "value": "Дата в формате 'YYYY-MM-dd:hh_mm' : {{ date.format('YYYY-MM-dd:hh_mm') }}"
   },
   {
     "value": "Дата в формате 'ErrorDateFormat' : {{ date.format('ErrorDateFormat') }}"
   }

Вкладка "ОБЩИЕ" SetCentrum

https://crystals.atlassian.net/browse/SR-5849

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

10.3.20.0

Начиная с версии 10.3.20.0 можно сделать разные значения настроек для магазинов с центрального сервера.

Переключаясь по каждому магазину, на вкладке ОБЩИЕ будут отображаться только его настройки.

Вкладка "ПОДАРОЧНАЯ КАРТА ЦФТ"

Устанавливаются флажки действия при оплате подарочной картой ЦФТ.

Название настройки	Описание

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

Вкладка "ПЛАГИН КАРТ ЦФТ"

Настраиваются процессы выпуска карт.

Название настройки	Описание	Пример значения

Название настройки	Описание	Пример значения
Длины и префиксы бонусных карт ЦФТ	Длины и префиксы карт лояльности ЦФТ, по которым будет проводиться поиск на сервере	16-778;19-778
Кол-во попыток ввода проверочного кода для списания бонусных баллов *	Кол-во попыток ввода кода из СМС	3
Регистрация клиентов с выпуском виртуальной карты	Разрешить регистрацию с выпуском виртуальной карты
Регистрация клиентов с выпуском физической карты	Разрешить регистрацию с выпуском физической карты
Шаблон печати "Информация по карте лояльности"	Шаблон для печати при просмотре инфо по карте лояльности
Шаблон печати "Информация по подарочной карте"	Шаблон для печати при просмотре инфо по ПК
Поля вывода и печати "Информация по карте лояльности" (через точку с запятой: NAME - фамилия и имя, CARD_NUMBER - номер карты, PHONE - номер телефона, STATE - состояние клиента, TOTAL_ACCRUED - всего бонусов, ACTIVE - активно бонусов, INACTIVE - неактивно бонусов) https://crystals.atlassian.net/browse/SR-6818 https://crystals.atlassian.net/browse/CR-10100 10.4.0.0	Поля данных, которые будут отображаться при выводе информации по карте лояльности на кассе и при печати на чековом слипе. NAME - фамилия и имя; CARD_NUMBER - номер карты; PHONE - номер телефона; STATE - состояние клиента; TOTAL_ACCRUED - всего бонусов; ACTIVE - активно бонусов; INACTIVE - неактивно бонусов. Перечислите выбранные поля через точку с запятой без пробелов в том порядке, в котором требуется их выводить на экран или в слип.	NAME;CARD_NUMBER;PHONE;STATE;TOTAL_ACCRUED;ACTIVE;INACTIVE
Поля вывода и печати "Информация по подарочной карте" (через точку с запятой: CARD_NUMBER - номер карты, STATUS - статус, ACTIVATION_AMOUNT - номинал, BALANCE - баланс, CURRENCY - валюта, EXPIRATION_DATE - дата истечения) https://crystals.atlassian.net/browse/SR-6818 https://crystals.atlassian.net/browse/CR-10100 10.4.0.0	Поля данных, которые будут отображаться при выводе информации по подарочной карте на кассе и при печати на чековом слипе. CARD_NUMBER - номер карты; STATUS - статус; ACTIVATION_AMOUNT - номинал; BALANCE - баланс; CURRENCY - валюта; EXPIRATION_DATE - дата истечения. Перечислите выбранные поля через точку с запятой без пробелов в том порядке, в котором требуется их выводить на экран или в слип.	CARD_NUMBER;STATUS;ACTIVATION_AMOUNT;BALANCE;CURRENCY;EXPIRATION_DATE

Вкладка "ПОДАРОЧНАЯ КАРТА ЦФТ"

Настраивается работа с подарочной картой, как с товаром.

Опция “разрешен ручной ввод“ должна быть отключена.

Название настройки	Описание	Пример значения

Название настройки	Описание	Пример значения
Действия с типом товара	проверять возраст покупателя разрешить применение скидок Set10 разрешить применение бонусов как скидки или внешних скидок разрешить группировку в чеке в одну позицию разрешить возврат товара только один товар в чеке несовместимость в чеке с товарами другого типа разрешен ручной ввод Данный товар разрешено оплачивать - При активации опции "несовместимость в чеке с товарами другого типа" можно установить ограничение по допустимым типам оплаты товара выбранные способы оплаты не будут доступны на кассе, если они не разрешены в настройках шаблона кассы. В случае неактивной опции "несовместимость в чеке с товарами другого типа" список с типами оплаты не имеет эффекта. Оплата наличными Оплата наличными (купюроприемник) Оплата по банковской карте Оплата по бонусной карте Оплата по подарочной карте Внешний банковский терминал Потребительский кредит Оплата по подарочной карте ЦФТ (устаревшая интеграция) Оплата по бонусной карте Siebel Оплата по Детской карте Оплата по QR-коду Оплата в рассрочку по карте Оплата по ЭПС ЦФТ Оплата по карте Супра Зачет предоплаты Бонусы на подарок Оплата по подарочной карте Siebel Подарочная карта ЦФТ Подарочная карта Decathlon Бонусы Umico G.O.L.D Аванс юридического лица Подарочная карта BRAVO Оплата денежным сертификатом Loymax Подарочная карта RSL Социальная программа
признак способа рассчета в рамках требований ФФД	Указывается код признака расчета согласно требованиям ФФД	4
признак предмета рассчета в рамках требований ФФД	Указывается код признака предмета расчета согласно требованиям ФФД	1

SetRetail10 ◾️ Плагин ЦФТ - Подарочная и дисконтная карта

Список работ

Описание

Настройка плагина

Добавление процессинга

Список настроек

Вкладка "ОБЩИЕ"

Настройки файла cft-gift-cards.json

Настройки файла default_templates.json

Вкладка "ОБЩИЕ" SetCentrum

Вкладка "ПОДАРОЧНАЯ КАРТА ЦФТ"

Вкладка "ПЛАГИН КАРТ ЦФТ"

Вкладка "ПОДАРОЧНАЯ КАРТА ЦФТ"