Карты лояльности

Редактировал(а) Татьяна Брыкова 2025/12/29 10:43

Карты в системе

Управление картами в системе позволяет создавать новые карты и управлять их жизненным циклом как вручную, так и в автоматическом режиме.

Для идентификации участников программы лояльности на кассах в магазинах партнёров используются карты программы лояльности. Каждый участник является держателем карты ПЛ. У одного участника может быть несколько карт ПЛ.

1712845343660-273.png

Рис. Справочник карт

Каждая карта имеет свой уникальный номер. Номер карты ограничен 20 символами. В качестве символов номера могут использоваться только цифры и латинские буквы. Номер несет в себе уникальную информацию о карте и служит также для учёта карт. В системе не может быть двух карт с одинаковыми номерами, даже если какие-то карты деактивированы. При этом даже если организация с несколькими партнерами, то не может быть двух карт с одинаковыми номерами и принадлежащими разным партнерам.

В системе карты лояльности – это записи базы данных, которые используются для начисления или списания баллов по правилам начисления и списания, для предоставления скидок, для изменения связанных значений счётчиков и изменения уровней клиента. 

Карта участника ПЛ является объектом, обладающим множеством параметров, определяющих поведение карты в системе. Параметры делятся на две большие группы: статические параметры и динамические. Статические параметры характеризуют саму карту как некий объект. Динамические параметры – это совокупность характеристик, отражающих текущее состояние карты в системе. Динамические параметры недоступны для непосредственного редактирования, они изменяются в зависимости от совершаемых действий с участием карты. Например, карта была предъявлена при покупке на POS-терминал. После того как выписанный чек попадёт в систему, то будут автоматически изменены поля, которые отражают балансовое состояние покупок: сумма покупки, количество покупок и т.д.

Если время покупки подпадает под действие какой-либо акции программы лояльности и в данной акции предполагается начисление бонусных баллов, или оплата этими баллами соответствующих покупок, то при записи чека в систему происходит обновление балансовых полей начисленных баллов. Все когда-либо начисленные баллы записываются в поле «Дебет», все когда-либо израсходованные – в поле «Кредит». Автоматически списанные баллы по окончанию срока действия также считаются израсходованными. Необходимо учитывать, что баллы не будут автоматически списываться по умолчанию по окончании срока действия. Для того чтобы это происходило, необходимо в системе завести специальное правило списания. Это лучше не игнорировать, потому что значения балансовых полей являются основанием для динамической фильтрации. В случае если организовано автоматическое сгорание истекших баллов, то активный баланс карты и общий баланс карты отличаются только на сумму бонусных баллов, которые ещё не начали действовать.

Изменение активного баланса происходит онлайн, по чеку - по запросу начисления/списания баллов.

Учёт бонусных баллов и статусных баллов производится отдельно.

Важно! Если есть ситуация, когда начисляются баллы, имеющие отложенное действие, то есть такие, начало действия которых установлено в будущем, то они не начинают действовать с точностью до назначенного времени. По умолчанию, настройки базы данных таковы, что отложенные баллы пересчитывается один раз в сутки по часовому поясу сервера в 02:05:30. Поэтому, если начало действия баллов наступает в 15:00 – такими баллами нельзя будет воспользоваться для оплаты до того, как отработает процедура пересчёта.

Важно! Списание истёкших баллов происходит не в момент окончания их действия. Все баллы, действие которых завершилось в данный день, будут списаны на следующий день в 02:05:30. Однако такое списание не означает, что если баллы закончили действие, например, в 14:30, то ими можно будет пользоваться до двух часов ночи следующего дня. Использование баллов для оплаты возможно до времени окончания их действия. Автоматическое списание изменяет поле «Кредит» карты и «Активный баланс», но при каждой транзакции осуществляется проверка на возможность списания, поэтому данная функциональность не влияет на списание баллов.

Разница между всеми начисленными баллами (даже если баллы не начали действие) и всеми списанными записывается и постоянно обновляется в поле «Баланс». Помимо этого, есть ещё поле «Активный баланс», в нем записано актуальное на текущую дату количество баллов, которые не завершили своё действие. Также в активном балансе не учитываются баллы, которые начислены, но ещё не начали действовать.

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

Важно! Также стоит отметить, что настройки списания баллов можно поменять для конкретной реализации версии системы. Можно установить обновление активного баланса каждый час, но стоит иметь в виду, что это будет нагружать систему и быстродействие снизится.

Оплата баллами определённых покупок также влияет на состояние балансовых полей, также как и возврат покупок во время действия акций программы лояльности. Следует иметь в виду, что возврат не влияет на обновление поля «Количество покупок», даже если это полный возврат покупки, финансовые и балансовые поля обновляются на возвращаемые значения.

Следует обратить внимание, что несколько карт могут быть объединены в мастер-счёт. Например, в мастер-счёт могут быть объединены карты, принадлежащие одной семье, тогда мастер-счёт будет общим семейным счётом бонусных баллов. Объединение карт в мастер–счёт позволяет при предъявлении карты, входящей в мастер-счёт, оплачивать покупки баллами, которые накоплены на всех картах данного мастер-счёта, даже если на активном балансе предъявленной при покупке карты нет или недостаточно баллов для оплаты покупки. Следует обратить внимание, что для оплаты покупки могут быть доступны баллы, которые являются суммой активных баллов всех карт мастер-счёта. Использование баллов определяется значением поля «Тип участия».

Также различные карты объединены в рамках одного контакта. Следует иметь в виду, что если карты объединены в рамках одного контакта или в рамках одного мастер-счёта, то для оплаты покупок автоматически доступны все активные баллы всего объединённого множества карт. Даже если на предъявленной для операции покупки нет активных баллов, но они есть на какой-то другой карте контакта, то эти баллы будут доступны для оплаты покупки.

В течение жизненного цикла карта может быть в разном статусе. Статусы карты могут быть следующими: Новая, Активная, Заблокирована, Закрыта, Завершена. При генерации записи карт создаются в статусе «Новая», но можно также при генерации карт указать, чтобы записи карт создались в статусе «Активная». В этом случае карта сразу переходит в статус «Активная».

Статусы меняются либо автоматически, либо вручную. Любая транзакция по карте со статусом «Новая» переводит запись данной карты в статус «Активная». Статусы «Заблокирована», «Закрыта», «Завершена» присваиваются автоматически, это определяется административными настройками, кроме статуса «Заблокирована». Этот статус может быть установлен оператором. Для блокировки карты в меню формы оператор должен нажать кнопку Заблокировать. Заблокированную карту вручную можно перевести в статус «Активная», либо в статус «Новая».

Следует иметь в виду, что при обработке транзакций учитываются не только актуализированные статусы карты, но также время, когда они были установлены. Например, вы можете активировать карту сегодня, и попытаться совершить транзакцию по карте вчерашним днём, когда она была заблокирована, например, провести какой-то чек, который был выписан вчера, но информация о нём пришла только сегодня. Даже если данный чек попадает в действие акции программы лояльности, при обработке чека вернётся ошибка, так как карта на момент выписки чека была заблокирована. История изменения статусов карты также хранится в системе, чтобы её посмотреть необходимо открыть в связанных записях История статусов карты.

Карточка Карты содержит следующую информацию:

ПолеОписаниеОбязательное полеРедактирование
ОтветственныйПользователь, ответственный за создание и ведение данной записи.ДаПоле доступно для редактирования. Заполняется из справочника пользователей.
ПодразделениеПодразделение, к которому относится данная запись.ДаПоле доступно для редактирования. Заполняется из справочника подразделений.
Общие сведения
НомерНомер карты.ДаПоле не доступно для редактирования, заполняется автоматически (при генерации)
Тип картыСсылка на тип карты.НетПоле доступно для редактирования, заполняется вручную
Тип начислений

Тип начислений карты. Возможные значения:

Бонус

Скидка

Бонус + скидка

Подарки

ДаПоле не доступно для редактирования, заполняется автоматически (при генерации карт)
Статус карты

Статус карты. Возможные значения:

Новая

Активный

Заблокирована

Закрыта

Завершена

ДаПоле не доступно для прямого редактирования, заполняется автоматически
Дата изменения статусаДата последнего изменения статуса карты.ДаПоле не доступно для редактирования, заполняется автоматически
Состояние

Дополнительный статус карты (в процессинге не используется). Возможные значения:

  • Новая
  • Ограничена
  • Активна
  • Временно заблокирована
  • Заблокирована по особым обстоятельствам
  • Заблокирована
  • Завершена
  • Закрыта
  • Происходит замена
  • Заблокирована по причине активного негативного счёта
  • Заблокирована по причине негативного счёта
  • Закрыта через Личный кабинет
  • Заблокирована по ФРОД (превышение лимита по количеству чеков в сутки)
  • Заблокирована по ФРОД (активность в нескольких регионах за короткий промежуток времени)
НетПоле доступно для редактирования, заполняется вручную
Принадлежность
КонтактФизическое лицо, которому принадлежит карта и идентифицирует этого человека как участника программы лояльности.НетПоле доступно для редактирования, заполняется вручную
Редактируемый уровень

Признак редактируемости уровня. Возможные значения: 

  • Да
  • Нет

В случае значения "Да" - пользователь указывает уровень вручную.

В случае значения "Нет" - система рассчитывает уровень по настройкам автоматически.

НетПоле доступно для редактирования, заполняется вручную
Тип участия

Статус участия карты в программе лояльности. Возможные значения:

только начисление

только списание

начисление и списание

ДаПоле доступно для редактирования, заполняется вручную
Мастер счётМастер счёт, в который входит карта.НетПоле доступно для редактирования, заполняется вручную
Инициатор создания мастер-счета

Признак инициатора создания мастер-счета. В значении «Да» может быть только у одной карты из входящих в мастер-счёт. При создании новой карты данный параметр всегда в значении «Нет». Возможные значения:

Да

Нет

НетПоле доступно для редактирования, заполняется вручную
Запрет на списание денег с карт мастер-счетаПризнак того, что по этой карте недоступно списание денег с карт мастер-счета, в который она входит.НетПоле доступно для редактирования, заполняется вручную
ПартнёрПартнёр, который выпустил данную карту лояльности.ДаПоле доступно для редактирования, заполняется вручную
МагазинСсылка на магазин, в котором выдана карта лояльности участнику программы лояльности.НетПоле доступно для редактирования, заполняется вручную
Период действия
Дата начала действияДата начала периода действия карты.ДаПоле не доступно для редактирования, заполняется автоматически (при генерации)
Дата окончания действияДата окончания периода действия карты.ДаПоле не доступно для редактирования, заполняется автоматически (при генерации)
Дополнительные параметры
Внешний идентификаторКод идентификации для интеграции с внешними системами.НетПоле доступно для редактирования, заполняется вручную
Задание на выпускСсылка на задание на выпуск.НетПоле не доступно для редактирования, заполняется автоматически
Новая картаКарта, на которую заменена данная карта.НетПоле не доступно для редактирования, заполняется автоматически
ПодсказкаПодсказка (кодовое слово) для идентификации клиента, которому принадлежит карта, в случае если он обращается. Подсказка генерируется вместе с картой, изменить его нельзя.НетПоле не доступно для редактирования, заполняется автоматически
Покупки
Сумма без скидокОбщая сумма покупок по карте без скидок.НетПоле не доступно для редактирования, заполняется автоматически
Сумма скидокОбщая сумма скидок, полученных при использовании карты.НетПоле не доступно для редактирования, заполняется автоматически
Сумма со скидкойОбщая сумма покупок по карте с учётом скидок.НетПоле не доступно для редактирования, заполняется автоматически
Текущая скидка (%)Текущий активный уровень скидки по карте. Не может превзойти 100%.НетПоле не доступно для редактирования, заполняется автоматически
Количество покупокОбщее количество покупок, совершённых с использованием карты.НетПоле не доступно для редактирования, заполняется автоматически
Средний чекЗначение среднего чека по карте за всю историю карты в программе лояльности. Общая сумма покупок, делённая на количество покупок. Чеки возврата в количество покупок не входят.НетПоле не доступно для редактирования, заполняется автоматически
Средний чек со скидкамиЗначение среднего чека с учётом скидок по карте за всю историю карты в программе лояльности. Общая сумма покупок со скидкой, делённая на количество покупок. Чеки возврата в количество покупок не входят.НетПоле не доступно для редактирования, заполняется автоматически
Дата последней операцииДата чека покупки с максимальной датой. Чеки возврата не учитываются для определения даты последней транзакции.НетПоле не доступно для редактирования, заполняется автоматически
Баланс бонусов
Дебет (баллы)Общее количество начисленных бонусных баллов по карте.НетПоле не доступно для редактирования, заполняется автоматически
Кредит (баллы)Общее количество списанных бонусных баллов по карте.НетПоле не доступно для редактирования, заполняется автоматически
Баланс (баллы)Разница между количеством начисленных и списанных бонусных баллов по карте.НетПоле не доступно для редактирования, заполняется автоматически
Активный баланс (баллы)Количество бонусных баллов, доступных для списания в настоящий момент.НетПоле не доступно для редактирования, заполняется автоматически
Баланс статусных бонусов
Дебет (статусные баллы)Общее количество начисленных статусных баллов по карте.НетПоле не доступно для редактирования, заполняется автоматически
Кредит (статусные баллы)Общее количество списанных статусных баллов по карте.НетПоле не доступно для редактирования, заполняется автоматически
Баланс (статусные баллы)Разница между количеством начисленных и списанных статусных баллов по карте.НетПоле не доступно для редактирования, заполняется автоматически
Активный баланс (статусные баллы)Количество статусных баллов, доступных для списания в настоящий момент.НетПоле не доступно для редактирования, заполняется автоматически
Баланс денежных средств
Дебет (деньги)Общее количество начисленных денежных средств по карте.НетПоле не доступно для редактирования, заполняется автоматически
Кредит (деньги)Общее количество списанных денежных средств по карте.НетПоле не доступно для редактирования, заполняется автоматически
Баланс (деньги)Разница между количеством начисленных и списанных денежных средств по карте.НетПоле не доступно для редактирования, заполняется автоматически
Зависимости
Покупки
ЧекиПредставление, в котором показаны связанные с текущей картой чеки
ЗаказыПредставление, в котором показаны связанные с текущей картой заказы
Счётчики картыПредставление, в котором показаны связанные с текущей картой счётчики карты
События счётчиковПредставление, в котором показаны связанные с текущей картой события счётчиков
Бонусы
Баллы начисленияПредставление, в котором показаны связанные с текущей картой балы начисления
Баллы списанияПредставление, в котором показаны связанные с текущей картой баллы списания
Бонусные счетаПредставление, в котором показаны связанные с текущей картой бонусные счета
Запросы начисления / списания балловПредставление, в котором показаны связанные с текущей картой запросы начисления/списания баллов
Купоны
КупоныПредставление, в котором показаны связанные с текущей картой купоны
Лимиты по купонамПредставление, в котором показаны связанные с текущей картой лимиты по купонам
Запросы гашения купоновПредставление, в котором показаны связанные с текущей картой запросы гашения купонов
Правила
Персональные предложенияПредставление, в котором показаны связанные с текущей картой персональные предложения
Интеграционные персональные предложенияПредставление, в котором показаны связанные с текущей картой интеграционные персональные предложения
Рекомендованные товарыПредставление, в котором показаны связанные с текущей картой рекомендованные товары
Деньги
Начисления на денежный счётПредставление, в котором показаны связанные с текущей картой начисления на денежный счёт
Списания с денежного счётаПредставление, в котором показаны связанные с текущей картой списания с денежного счёта
Денежные транзакцииПредставление, в котором показаны связанные с текущей картой денежные транзакции
Расширенные атрибутыПредставление, в котором показаны расширенные атрибуты связанные с текущей картой
Идентификаторы участникаПредставление, в котором показаны идентификаторы участника связанные с текущей картой
Списки картПредставление, в котором показаны списки карт связанные с текущей картой
Заявки на загрузку чековПредставление, в котором показаны заявки на загрузку чеков связанные с текущей картой
История уровнейПредставление, в котором показана история уровней связанных с текущей картой
История статусов картыПредставление, в котором показана история статусов карты связанных с текущей картой
История изменений РА картыПредставление, в котором показана история изменения расширенных атрибутов карты связанных с текущей картой
История ручных бонусовПредставление, в котором показана история ручных бонусов связанных с текущей картой
История ручных чековПредставление, в котором показана история ручных чеков связанных с текущей картой

1712845489728-878.png

Рис. Карточка карты (обзор) – Общие сведения, Принадлежность

1712845569513-697.png

Рис. Карточка карты (обзор) – Период действия, Покупки

1712845614008-601.png

Рис. Карточка карты (обзор) –Баланс бонусов, Баланс статусных бонусов, Баланс денежных средств

1712845658778-436.png

Рис. Карточка карты (Детализация)

Обзорное видео раздела Карты лояльности смотрите тут.

Включение карт в мастер-счета

Мастер-счёт – запись, которая объединяет произвольное количество карт в определённую группу. При этом бонусные баллы, которые начислены по всем картам данной группы, доступны для оплаты покупок, совершаемых по какой-либо одной карте из этой группы, которая и предъявлена на POS-терминал. Если карта входит в мастер-счёт и предъявляется на POS-терминал, то для оплаты покупки доступны активные баллы других карт, входящих в мастер-счёт. Однако при запросе баланса в ответ будет выдаваться активный баланс именно карты, предъявленной на терминал, общий активный баланс мастер-счёта в ответе запроса не выдаётся.

Конкретная карта может быть в составе только одного мастер-счёта. При попытке прикрепить карту, состоящую в одном мастер-счёте, к другому мастер-счёту будет возвращена ошибка.

1712845780569-134.png

Рис. Справочник мастер-счетов

Карточка Мастер-счёта содержит следующую информацию:

ПолеОписаниеОбязательное полеРедактирование
Активно

Признак активности для процессинга. Возможные значения:

Да

Нет

Значение по умолчанию Нет.

ДаПоле доступно для редактирования, заполняется вручную
ОтветственныйПользователь, ответственный за создание и ведение данной записи.ДаПоле доступно для редактирования. Заполняется из справочника пользователей.
ПодразделениеПодразделение, к которому относится данная запись.ДаПоле доступно для редактирования. Заполняется из справочника подразделений.
Общие сведения
НомерНомер мастер счёта. Используется как название и значение в представлениях. Допустимы цифры и буквенные значения.ДаПоле доступно для редактирования, заполняется вручную
Внешний идентификаторКод интеграции с внешними системами.НетПоле доступно для редактирования, заполняется вручную
ОписаниеПодробное описание мастер-счёта.НетПоле доступно для редактирования, заполняется вручную
Покупки
Сумма без скидокСумма полей «Сумма без скидок» по всем картам, относящимся к мастер-счёту.ДаПоле недоступно для редактирования. Заполняется автоматически.
Сумма скидокСумма полей «Сумма скидок» по всем картам, относящимся к мастер-счёту.ДаПоле недоступно для редактирования. Заполняется автоматически.
Сумма со скидкойСумма полей «Сумма со скидкой» по всем картам, относящимся к мастер-счёту.ДаПоле недоступно для редактирования. Заполняется автоматически.
Текущая скидка (%)Максимальная скидка по карте среди всех карт, относящихся к мастер-счёту.ДаПоле недоступно для редактирования. Заполняется автоматически.
Количество покупокСумма полей «Количество покупок» по всем картам, относящимся к мастер-счёту.ДаПоле недоступно для редактирования. Заполняется автоматически.
Средний чекСредний чек покупок по всему мастер-счёту. Общая сумма покупок, делённая на количество покупок. Чеки возврата в количество покупок не входят.ДаПоле недоступно для редактирования. Заполняется автоматически.
Средний чек со скидкамиСредний чек покупок со скидкой по всему мастер-счёту. Общая сумма покупок со скидкой, делённая на количество покупок. Чеки возврата в количество покупок не входят.ДаПоле недоступно для редактирования. Заполняется автоматически.
Дата последней транзакцииМаксимальная дата покупки среди всех покупок по мастер-счёту. Дата чека возврата не определяет дату последней транзакции.ДаПоле недоступно для редактирования. Заполняется автоматически.
Баланс бонусов
Дебет (баллы)Сумма полей «Дебет бонусных баллов» по всем картам, относящимся к мастер-счёту.ДаПоле недоступно для редактирования. Заполняется автоматически.
Кредит (баллы)Сумма полей «Кредит бонусных баллов» по всем картам, относящимся к мастер-счёту.ДаПоле недоступно для редактирования. Заполняется автоматически.
Баланс (баллы)Сумма полей «Баланс бонусных баллов» по всем картам, относящимся к мастер-счёту.ДаПоле недоступно для редактирования. Заполняется автоматически.
Активный баланс (баллы)Сумма полей «Активный баланс бонусных баллов» по всем картам, относящимся к мастер-счёту.ДаПоле недоступно для редактирования. Заполняется автоматически.
Баланс статусных бонусов
Дебет (статусные баллы)Сумма полей «Дебет статусных баллов» по всем картам, относящимся к мастер-счёту.ДаПоле недоступно для редактирования. Заполняется автоматически.
Кредит (статусные баллы)Сумма полей «Кредит статусных баллов» по всем картам, относящимся к мастер-счёту.ДаПоле недоступно для редактирования. Заполняется автоматически.
Баланс (статусные баллы)Сумма полей «Баланс статусных баллов» по всем картам, относящимся к мастер-счёту.ДаПоле недоступно для редактирования. Заполняется автоматически.
Активный баланс (статусные баллы)Сумма полей «Активный баланс статусных баллов» по всем картам, относящимся к мастер-счёту.ДаПоле недоступно для редактирования. Заполняется автоматически.
Баланс денежных средств
Дебет (деньги)Общее количество начисленных денежных средств по картам мастер-счета.ДаПоле не доступно для редактирования, заполняется автоматически
Кредит (деньги)Общее количество списанных денежных средств по картам мастер-счета.ДаПоле не доступно для редактирования, заполняется автоматически
Баланс денежных средствРазница между количеством начисленных и списанных денежных средств по картам мастер-счета.ДаПоле не доступно для редактирования, заполняется автоматически
Зависимости
КартыПредставление, в котором показаны Карты связанные с текущим мастер-счётом
Расширенные атрибутыПредставление, в котором показаны Расширенные атрибуты связанные с текущим мастер-счётом

Внешний вид карточки Мастер-счёт:

1712845986514-356.png

Рис. Карточка мастер-счета

В системе есть возможность для автоматического создания мастер-счета посредством нажатия кнопки «Создать мастер-счёт» на форме карты. Данная кнопка отображается на форме карты, если карта не входит в какой-либо мастер-счет, и при этом включена партнёрская/системная настройка Action.Create.CardMasterAccount.TurnOn (значение 1, y или Y). Партнёрская настройка задаётся через текстовый расширенный атрибут партнёра.

1712846010095-159.png

Рис. Создание мастер-счета на форме карты

При нажатии на кнопку создаётся мастер-счёт и в него включается карта, на форме которой была нажата кнопка. При этом номер и внешний идентификатор мастер-счёта генерируется автоматически: значение партнёрской настройки Action.Create.CardMasterAccount.Prefix, далее без пробела номер карты, на форме которой нажата кнопка, и затем без пробела значение партнёрской настройки Action.Create.CardMasterAccount.Suffix. Дополнительно, если включена партнёрская настройка Action.Create.CardMasterAccount.CardInitiator.TurnOn (значение 1, y или Y), то в карте проставляется признак «Инициатор создания мастер-счета» в значение Да. При прочих значениях партнёрской настройки – признак не изменяется.

1712846277124-378.png

Рис. Параметр карты «Инициатор создания мастер-счёта»

При выведении карты из мастер-счёта в текущей версии не происходит изменения параметра инициатор мастер-счёта.

Расширенные атрибуты карты

Расширенные атрибуты карты – это неограниченное количество дополнительных записей, которые связываются с записью самой карты. Расширенные атрибуты могут быть трёх типов: текстовыми (строковыми), числовыми (десятичные числа) и типа дата-время. Все расширенные атрибуты, которые связаны с картой, можно посмотреть во встроенном в форму представлении «Расширенные атрибуты»:

1712846373544-112.png

Рис. Расширенные атрибуты в карточке карты

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

1712846415517-718.png

Рис. Карточка расширенного атрибута карты

Карточка расширенного атрибута карты содержит следующие поля:

ПолеОписаниеОбязательное полеРедактирование
Активно

Признак активности атрибута.

Возможные значения:

Активно

Неактивно

Значение по умолчанию Да.

ДаПоле доступно для редактирования, заполняется вручную
ОтветственныйПользователь, ответственный за создание и ведение данной записи.ДаПоле доступно для редактирования. Заполняется из справочника пользователей.
ПодразделениеПодразделение, к которому относится данная запись.ДаПоле доступно для редактирования. Заполняется из справочника подразделений.
Общие сведения
КлючНазвание атрибута. Заполняется как текстовое значение, но должно совпадать с одним из названий определений расширенных атрибутов.ДаПоле доступно для редактирования, заполняется вручную
Внешний идентификаторКод интеграции с внешними системами.НетПоле доступно для редактирования, заполняется вручную
Тип атрибута

Тип атрибута. Возможные значения:

Число

Строка

Дата время

Значение по умолчанию: Строка.

ДаПоле доступно для редактирования, заполняется вручную
ЗначениеЗначение расширенного атрибута.НетПоле доступно для редактирования, заполняется вручную
КартаКарта, к которой относится расширенный атрибут.ДаПоле доступно для редактирования, заполняется вручную
Задание по расписаниюСсылка на задание по расписаниюНетПоле доступно для редактирования, заполняется вручную
ОписаниеПодробное описание расширенного атрибута.НетПоле доступно для редактирования, заполняется вручную

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

Использование баллов, накопленных на картах

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

Следует иметь в виду, что для оплаты покупок клиент может использовать не только активный баланс баллов по карте, предъявленной на POS-терминале, но и активный баланс всех своих карт (карт, относящихся к клиенту) и всех карт мастер-счёта, в который входит карта, предъявленная на POS-терминал. Однако не всегда списание баллов по карте будет возможно.

Запись карты имеет определённое значение Типа участия. Если на POS-терминал предъявлена карта имеющая тип участия, равный «Только начисление», то по ней операции списания невозможны, даже если на остальных картах контакта или мастер-счёта есть активные баллы. Даже если карта у клиента одна, и она не входит ни в какой мастер-счёт – списать по ней баллы нельзя.

1712846530478-904.png

Рис. Карта с типом «Только начисления»

Если на POS-терминал предъявлена карта, имеющая тип участия «Только списание» – то никакие операции начисления бонусных баллов по ней невозможны, даже если она входит в мастер-счёт или у контакта есть какие-то другие карты. Однако по этой карте возможны операции списания: по этой карте можно списывать баллы как с самой карты, так и со всех других карт клиента и со всех карт мастер-счёта, в который она входит. Если в момент покупки действуют какие-то бонусные акции – баллы на эту карту не будут начислены, ошибки или какого-то сообщения на терминал не возвращается.

1712846583781-606.png

Рис. Карта с типом «Только списания»

Если на POS-терминал предъявлена карта, имеющая тип участия «Начисления и списания», то на карту возможны начисления баллов и по этой карте можно списывать баллы как с самой карты, так и со всех других карт клиента и со всех карт мастер-счёта, в который она входит.

1712846622900-537.png

Рис. Карта с типом «Начисления и списания»

Блокировка карт по отрицательным балансам

В системе есть 2 системных настройки, в которых указывается число. Если отрицательный баланс превосходит это число (например, если в настройке указано значение 1000, а на карте -1050 баллов), то карта будет заблокирована, и в зависимости какой именно баланс превосходит минимальное количество отрицательных баллов, изменится поле состояние на «Заблокирована из-за отрицательного баланса» или «Заблокирована из-за отрицательного активного баланса».

Системная настройка Loyalty.Processing.LockCardWhenBalanceLessThan определяет значение баланса, ниже которого карта будет заблокирована. А системная настройка Loyalty.Processing.LockCardWhenActiveBalanceLessThan определяет значение, ниже какого активного баланса карта будет заблокирована.

Верификация операций с картами

В системе предусмотрена возможность верификации следующих операций:

1. Оплата покупок бонусными или статусными баллами (на основании запросов чеков). Для этой операции предусмотрена верификация проверочным кодом в SMS-сообщении (настройки для верификации задаются в карточке партнера в блоке «Верификация оплаты покупок»).

1712847042394-897.png

Рис. Настройка верификации оплаты покупок в карточке Партнёр

2. Операции с картами по запросу: активация карты, блокировка карты, замена карты запросом. Для этой операции предусмотрена верификация кодовым словом карты или SMS-кодом (настройки для верификации задаются в карточке партнера в блоке «Верификация операций с картами через запросы»).

1712847080271-224.png

Рис. Настройка верификации операций с картами в карточке Партнёр

3. Перевод баллов с одной карты на другую. Для этой операции предусмотрена верификация проверочным кодом в SMS-сообщении (настройки для верификации задаются в карточке партнера на вкладке «Верификация операций перевода баллов»).

1712847134983-248.png

Рис. Настройка верификации операций перевода баллов в карточке Партнёр

4. Проведение запроса баланса по номеру мобильного телефона. Для этой операции предусмотрена верификация проверочным кодом в SMS-сообщении (настройки для верификации задаются в карточке партнера на вкладке «Верификация прочих операций»).

1712847171256-658.png

Рис. Настройка верификации прочих операций в карточке Партнёр

Фильтрация карт при обработке алгоритмов

Также, как и для контактов, для карт в системе реализовано два вида фильтрации: динамическая и статическая. Статический способ – это создание определённого списка карт и отнесение этого списка к записям, которые являются настройками алгоритмов процессинга. Алгоритмы будут работать только для тех карт, которые входят в статические списки.

1712847886102-268.png

Рис. Справочник списков карт

Динамическая фильтрация зависит от времени выполнения алгоритмов процессинга и текущих характеристик карт. Для осуществления динамической фильтрации необходимо задать диапазоны соответствующих характеристик. Отрабатывая в какой-то момент времени, алгоритм будет выполняться только по тем картам, текущие характеристики которых укладываются в установленные диапазоны.

Динамическая фильтрация карт

Почти все параметры карты можно использовать при фильтрации алгоритмов процессинга. Для этого служат специальные записи – наборы контактов (подробнее см. в пункте Фильтрация по контактам).

1712848000759-653.png

Рис. Фильтры по контактам

Набор содержит заданные диапазоны на различные характеристики карты. Если в какой-то момент времени характеристики конкретной карты таковы, что укладываются в указанные диапазоны, то карта подпадает под условия фильтрации и к ней могут быть применены, например, правила начисления. Записи наборов могут быть отнесены к записям настройки алгоритма (правила начисления, правила списания, задания по расписанию) как включаемые, так и исключаемые.

Статическая фильтрация карт

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

Список карт содержит следующую информацию:

ПолеОписаниеОбязательное полеРедактирование
Активно

Признак активности для процессинга. Возможные значения:

Да

Нет

Значение по умолчанию Да.

ДаПоле доступно для редактирования, заполняется вручную
ОтветственныйПользователь, ответственный за создание и ведение данной записи.ДаПоле доступно для редактирования. Заполняется из справочника пользователей.
ПодразделениеПодразделение, к которому относится данная запись.ДаПоле доступно для редактирования. Заполняется из справочника подразделений.
Общие сведения
НазваниеНазвание списка карт. Поле используется для поиска и в представлениях.ДаПоле доступно для редактирования, заполняется вручную
Внешний идентификатор

Код интеграции с внешними системами.

 

НетПоле доступно для редактирования, заполняется вручную
ОписаниеПодробное описание списка карт.НетПоле доступно для редактирования, заполняется вручную
Зависимости
КартыПредставление, в котором показаны Карты связанные с текущим списком карт
Фильтры по контактамПредставление, в котором показаны Фильтры по контактам с текущим списком карт (Включено в фильтры по контактам, Исключено из фильтров по контактам)
КампанииПредставление, в котором показаны Кампании с текущим списком карт (Включено в кампании, Исключено из кампаний)

Внешний вид карточки Список карт:

1712848136713-898.png

Рис. Карточка списка карт

Дополнительные идентификаторы участника

При регистрации запросов на POS-сервисе существует возможность определения участника не только по номеру карты, но и по дополнительному идентификатору участника. Дополнительных идентификаторов для каждой карты участника может быть произвольное количество. Уникальность дополнительных идентификаторов обеспечивается в рамках одного партнёра, но в рамках разных партнёров дополнительные идентификаторы могут быть неуникальны.

Данная функциональность может применяться для дополнительной идентификации контакта. Например, идентификация по номеру социальной карты.

1712848208908-257.png

Рис. Дополнительные идентификаторы в карточке карты

По умолчанию алгоритм поиска среди записей дополнительных идентификаторов отключен. Для его включения предусмотрена партнёрская/системная настройка Loyalty.Processing.AdditionalIdentification.TurnOn (партнёрская настройка задаётся через текстовый расширенный атрибут партнёра).

При этом возможно установить алгоритм предпочтительного поиска с помощью партнёрской/системной настройки Loyalty.Processing.PreferredSearch.ParticipantIdentification: в случае значения 0 при регистрации запроса вначале происходит поиск среди карт лояльности и затем среди записей дополнительных идентификаторов, в случае значения 1 наоборот - вначале происходит поиск среди значений дополнительных идентификаторов, а затем среди карт лояльности. В партнёрской/системной настройке Loyalty.Processing.AcceptedCardIdentifier можно задать ключ расширенного атрибута чека, в который будет записан идентификатор карты лояльности, если запрос зарегистрирован не по карте лояльности (значение по умолчанию ACI_).

Карточка идентификатора участника содержит следующую информацию:

ПолеОписаниеОбязательное полеРедактирование
Активно

Признак активности для процессинга. Возможные значения:

Да

Нет

Значение по умолчанию Да.

ДаПоле доступно для редактирования, заполняется вручную
ОтветственныйПользователь, ответственный за создание и ведение данной записи.ДаПоле доступно для редактирования. Заполняется из справочника пользователей.
ПодразделениеПодразделение, к которому относится данная запись.ДаПоле доступно для редактирования. Заполняется из справочника подразделений.
Общие сведения
ИдентификаторИдентификатор участника (карты участника). Поле используется для поиска и в представлениях.ДаПоле доступно для редактирования, заполняется вручную
КартаКарта участника.ДаПоле доступно для редактирования, заполняется вручную
Тип идентификатора

Тип идентификатора.

Возможные значения:

1 – Прочее

2 – Карта банка

3 – Социальная карта

4 – Абонемент

ДаПоле доступно для редактирования, заполняется вручную
ПартнерПартнёр карты участника.ДаПоле доступно для редактирования, заполняется вручную
ОписаниеПодробное описание идентификатора.НетПоле доступно для редактирования, заполняется вручную

Внешний вид карточки Идентификатор участника:

1712848356675-885.png

Рис. Карточка дополнительного идентификатора карты

Автоматическая привязка свободных карт к контактам без карты

Система предоставляет возможность для автоматической привязки свободных карт к контактам, у которых отсутствует карта (к контактам, у которых нет ни одной карты в каком бы то ни было статусе).

Данная функциональность включается по системной настройке Loyalty.SystemJob.BindCardToContact.

Ночным джобом к контакту, не имеющему ни одной карты, привязывается одна свободная карта без покупок в статусе «Новая» или «Активная» и связанной с типом, принадлежащему региону контакта. Примечание: Для контактов без регионов привязка карты не осуществляется.

Ограничение количества активных карт у одного контакта

Система предоставляет возможность для ограничения привязки к одному контакту более одной активной карты через интерфейс ML. Другими словами, если у контакта уже есть хотя бы одна активная карта, то к нему не разрешается привязать ещё одну активную карту. Проверка осуществляется как в момент привязки активной карты, так и в момент активации карты, уже привязанной к контакту.

Данное ограничение включается по партнерской/системной настройки Loyalty.Interface.ActiveCardLimit (партнёрская настройка задаётся через текстовый расширенный атрибут партнёра). По умолчанию настройка выключена. Если включена настройка и происходит попытка привязки активной карты к контакту, у которого уже есть активная карта, то отображается в интерфейсе соответствующая ошибка.

Электронные подарочные карты

  • Поиск подарочной карты в UI по номеру телефона получателя карты
  • Отправка смс по подарочной карте
  • Системные/партнерские настройки
  • Настройка привилегии для роли

Поиск подарочной карты в интерфейсе Manzana Loyalty можно осуществлять по любому расширенному атрибуту карты, заведенному в системе.

Поиск подарочной карты в UI по номеру телефона получателя карты

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

Подарочную карту в UI можно найти по значению РА карты с наименованием «Phone» («Phone» - значение по умолчанию, берется из партнёрской настройки Loyalty.Processing.MoneyRequest.ChargeOperation.Phone.CardEAKey) и выполнить нужные операции.

При запросе изменения номера телефона получателя подарочной карты, номер меняется в этом РА карты.

1745226807468-657.png

Рис. РА с номером телефона владельца подарочной карты

Отправка смс по подарочной карте

В UI предусмотрена функция отправки смс. Для этого оператору КЦ необходимо найти подарочную карту по номеру телефона владельца карты в UI и нажать на кнопку «Отправить смс» для отправки ему сообщения о данных по карте (например номер карты и кодовое слово карты).

1745227012244-285.png

Рис. Кнопка "Отправить смс" в карточке карты

Предварительно в системе должен быть заведен шаблон сообщения с настроенными обязательными параметрами. Для информирования получателя о данных карты, в шаблоне необходимо указать:

  1. «Тип сообщения» = «SMS»
  2. «Использовать для отправки сообщений через форму» = «Показать на форме карты». При таком значении на форме карты в окне отправке смс будет доступен для выбора этот шаблон. Если параметр «Использовать для отправки сообщений через форму» = «Не показывать», такой шаблон сообщений не будет показываться при отправке смс из формы карты.
  3. «Тип операции» = «Личный кабинет»
  4. Метапеременные в тексте сообщения - %card_num% (номер карты) и %card_codeword% (код карты).

1745227491612-917.png

Рис. Шаблон сообщения для отправки смс по подарочной карте

Далее на форме карты по нажатию на кнопку «Отправить смс» открывается окно с возможностью выбора настроенного шаблона или создания нового:

1745227557233-590.png

После выбора шаблона в окне отправки смс и нажатия кнопки «Отправить» появляется окно с предупреждением:

1745227593546-498.png

При нажатии кнопки «Отправить» формируется смс для выбранного шаблона. Получатель смс определяется по идентификатору карты и РА с номером телефона. При нажатии кнопки «Отменить» происходит возврат к выбору шаблона.

1745228179086-941.png

Рис. Уведомление об успешной отправки смс

Системные/партнерские настройки

С помощью партнерской настройки Loyalty.Interface.CardEAs.As.CardFields можно добавлять расширенные атрибуты подарочной карты, которые будут отображаться как поля представления карты и дополнительные параметры фильтрации по подарочным картам. Для этого в значении партнерской настройки необходимо перечислить РА подарочной карты в формате: КлючАтрибута1"НазваниеПоля1"Txt;... 

1749466970666-199.png

Рис. Партнерская настройка для заведения РА подарочной карты

При таком значении настройки в представлении подарочной карты будут выведены  РА карты с текстовыми значениями мобильного телефона владельца карты, дарителя карты, адресом электронной почты и номиналом карты.

1749467809517-398.pngРис. Расширенные атрибуты подарочной карты

РА подарочной карты отображаются в представлении карты в виде дополнительных полей:

1749468957187-212.pngРис. Расширенные атрибуты в представлении подарочной карты

По этим РА  возможно настраивать фильтрацию по параметрам подарочных карт одного партнера.

1749469023994-584.png

Рис.  Настройка фильтра с дополнительными параметрами карты, взятыми из партнерской настройки

Настройка ролей

Для того, чтобы можно было отправлять смс по подарочной карте из формы карты, необходимо в ролевой модели на вкладке LOYALTY  в подразделе «Другие привилегии» добавить привилегию «Отправлять смс по выбранному шаблону».

Ограничения

Обрабатываются только текстовые значения РА.  Вывод РА с числовым типом  значения и типом "Дата и время" в работе.