| Table of Contents |
|---|
...
| Info | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Начиная с версии 10.3.2.0 файл плагина входит в состав дистрибутива сервера, а также в патчи обновления сервера и кассы. Отдельная установка не требуется. |
Платформа «ЦФТ-Лояльность» – инструмент для бизнеса любого масштаба с широкой возможностью кастомизации решений для банковского сектора, ритейла, страховых компаний и других участников рынка. В рамках SetRetail10 - это внешний бонусный процессинг.
...
Добавление процессинга
1. На сервере SetRetail/SetCentrum перейдите в Интеграция → Внешние процессинги → кликните 
.
2. Введите в строке поиска ЦФТ → кликните Внешние процессинги лояльности → установите флажок ЦФТ-Лояльность → кликните 
.
3. Кликните по процессингу ЦФТ-Лояльность.
Список настроек
| Info |
|---|
Начиная с версии 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
| Выражение для проверки адреса электронной почты на корректность | ^[^\.@]+(\.[^\.@]+)*@[^\.@]+(\.[^\.@]+)+$ | ||||||||||||||||||||||||||
| При установленном флажке внешний идентификатор кассы генерируется в соответствии с шаблоном для каждой кассы | |||||||||||||||||||||||||||
Шаблон для генерации внешнего идентификатора кассы
| Шаблон для генерации внешнего идентификатора кассы. Формат шаблона:
| Kassa<pos_number> |
...
| Название настройки | Описание | Пример | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
goodsMarking
| Артикул плагинного товара Подарочная карта ЦФТ. Подарочная карта загружается как плагинный товар с типом Начиная с версии 10.3.25.0 настройки по префиксам для магнитной ленты и длинам и префиксам штрихкодов добавляются строкой в формате JSON в импортированный товар в свойство
| 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 | Операция оплаты/возврата ПК |
Шаблоны печати поддерживают:
- Условия
| Code Block | ||
|---|---|---|
| ||
{
"value": "{% if is_online %}"
},
{
"value": "ОНЛАЙН"
},
{
"value": "{% else %}"
},
{
"value": "ОФЛАЙН"
},
{
"value": "{% endif %}"
} |
- Циклы
| Code Block | ||
|---|---|---|
| ||
{
"value": "{% for i in items %}"
},
{
"value": "ЭЛЕМЕНТ {{ i }}"
},
{
"value": " {% endfor %}"
} |
- Форматирование даты
| Code Block | ||
|---|---|---|
| ||
{
"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') }}"
} |
...
Название настройки | Описание |
|---|---|
| Определяет, следует ли при возврате возвращаемую сумму распределить равномерно по позициям чека. |
| Определяет, следует ли при возврате оплаты подарочной картой возвращать оплату наличными. |
| Определяет, следует ли при возврате оплаты подарочной картой возвращать оплату на банковскую карту. |
 частичный возврат чека запрещен | Разрешен только возврат чека полностью. |
Вкладка "ПЛАГИН КАРТ ЦФТ"
Настраиваются процессы выпуска карт.
Название настройки | Описание | Пример значения | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Длины и префиксы бонусных карт ЦФТ | Длины и префиксы карт лояльности ЦФТ, по которым будет проводиться поиск на сервере | 16-778;19-778 | ||||||||||||||||||||||||
Кол-во попыток ввода проверочного кода для списания бонусных баллов * | Кол-во попыток ввода кода из СМС | 3 | ||||||||||||||||||||||||
| Разрешить регистрацию с выпуском виртуальной карты | |||||||||||||||||||||||||
| Разрешить регистрацию с выпуском физической карты | |||||||||||||||||||||||||
Шаблон печати "Информация по карте лояльности" | Шаблон для печати при просмотре инфо по карте лояльности | |||||||||||||||||||||||||
Шаблон печати "Информация по подарочной карте" | Шаблон для печати при просмотре инфо по ПК | |||||||||||||||||||||||||
Поля вывода и печати "Информация по карте лояльности" (через точку с запятой: 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 - дата истечения)
| Поля данных, которые будут отображаться при выводе информации по подарочной карте на кассе и при печати на чековом слипе.
Перечислите выбранные поля через точку с запятой без пробелов в том порядке, в котором требуется их выводить на экран или в слип. | CARD_NUMBER;STATUS;ACTIVATION_AMOUNT;BALANCE;CURRENCY;EXPIRATION_DATE |
Вкладка "ПОДАРОЧНАЯ КАРТА ЦФТ"
...
Название настройки | Описание | Пример значения |
|---|---|---|
| Действия с типом товара |
| |
| признак способа рассчета в рамках требований ФФД | Указывается код признака расчета согласно требованиям ФФД | 4 |
| признак предмета рассчета в рамках требований ФФД | Указывается код признака предмета расчета согласно требованиям ФФД | 1 |
| мера количества предмета расчета в рамках требований ФФД | Указывается значение реквизита "мера количества предмета расчета" согласно требованиям ФФД | 0 |
| Запрет продажи подарочных карт юридическим лицам | |
Проверка пересечения префиксов
...
Откройте Шаблон кассы (Кассовый модуль → Шаблоны касс) → перейдите на вкладку ПРОЦЕСС ТОРГОВЛИ → введите в строку поиск ЦФТ → установите флажок Подарочная карта ЦФТ в секциях Типы товаров и Типы оплат → кликните .
Перезагрузите кассовый модуль.
Для клавиатурной кассы добавьте пункт меню Инфо по карте.
...
3. На сервере в шаблоне касс установлен флажок 
Информация кассира о возможности списать бонусы (Кассовый модуль → Шаблоны касс → <Шаблон кассы> → Процесс торговли → Секция Дополнительные настройки).
...
Указывается тип товара <product-type>ProductSetApiEntity</product-type>.
При импорте товара должно быть указано следующее значение плагинного свойства plugin_id:
...