Карты лояльности
- Карты в системе
- Статусы карт
- Изменение статусов и замена карт
- Включение карт в мастер-счета
- Расширенные атрибуты карты
- Использование баллов, накопленных на картах
- Блокировка карт по отрицательным балансам
- Верификация операций с картами
- Фильтрация карт при обработке алгоритмов
- Дополнительные идентификаторы участника
- Автоматическая привязка свободных карт к контактам без карты
- Ограничение количества активных карт у одного контакта
- Электронные подарочные карты
Карты в системе
Управление картами в системе позволяет создавать новые карты и управлять их жизненным циклом как вручную, так и в автоматическом режиме.
Для идентификации участников программы лояльности на кассах в магазинах партнёров используются карты программы лояльности. Каждый участник является держателем карты ПЛ. У одного участника может быть несколько карт ПЛ.

Рис. Справочник карт
Каждая карта имеет свой уникальный номер. Номер карты ограничен 20 символами. В качестве символов номера могут использоваться только цифры и латинские буквы. Номер несет в себе уникальную информацию о карте и служит также для учёта карт. В системе не может быть двух карт с одинаковыми номерами, даже если какие-то карты деактивированы. При этом даже если организация с несколькими партнерами, то не может быть двух карт с одинаковыми номерами и принадлежащими разным партнерам.
В системе карты лояльности – это записи базы данных, которые используются для начисления или списания баллов по правилам начисления и списания, для предоставления скидок, для изменения связанных значений счётчиков и изменения уровней клиента.
Карта участника ПЛ является объектом, обладающим множеством параметров, определяющих поведение карты в системе. Параметры делятся на две большие группы: статические параметры и динамические. Статические параметры характеризуют саму карту как некий объект. Динамические параметры – это совокупность характеристик, отражающих текущее состояние карты в системе. Динамические параметры недоступны для непосредственного редактирования, они изменяются в зависимости от совершаемых действий с участием карты. Например, карта была предъявлена при покупке на POS-терминал. После того как выписанный чек попадёт в систему, то будут автоматически изменены поля, которые отражают балансовое состояние покупок: сумма покупки, количество покупок и т.д.
Если время покупки подпадает под действие какой-либо акции программы лояльности и в данной акции предполагается начисление бонусных баллов, или оплата этими баллами соответствующих покупок, то при записи чека в систему происходит обновление балансовых полей начисленных баллов. Все когда-либо начисленные баллы записываются в поле «Дебет», все когда-либо израсходованные – в поле «Кредит». Автоматически списанные баллы по окончанию срока действия также считаются израсходованными. Необходимо учитывать, что баллы не будут автоматически списываться по умолчанию по окончании срока действия. Для того чтобы это происходило, необходимо в системе завести специальное правило списания. Это лучше не игнорировать, потому что значения балансовых полей являются основанием для динамической фильтрации. В случае если организовано автоматическое сгорание истекших баллов, то активный баланс карты и общий баланс карты отличаются только на сумму бонусных баллов, которые ещё не начали действовать.
Изменение активного баланса происходит онлайн, по чеку - по запросу начисления/списания баллов.
Учёт бонусных баллов и статусных баллов производится отдельно.
Важно! Если есть ситуация, когда начисляются баллы, имеющие отложенное действие, то есть такие, начало действия которых установлено в будущем, то они не начинают действовать с точностью до назначенного времени. По умолчанию, настройки базы данных таковы, что отложенные баллы пересчитывается один раз в сутки по часовому поясу сервера в 02:05:30. Поэтому, если начало действия баллов наступает в 15:00 – такими баллами нельзя будет воспользоваться для оплаты до того, как отработает процедура пересчёта.
Важно! Списание истёкших баллов происходит не в момент окончания их действия. Все баллы, действие которых завершилось в данный день, будут списаны на следующий день в 02:05:30. Однако такое списание не означает, что если баллы закончили действие, например, в 14:30, то ими можно будет пользоваться до двух часов ночи следующего дня. Использование баллов для оплаты возможно до времени окончания их действия. Автоматическое списание изменяет поле «Кредит» карты и «Активный баланс», но при каждой транзакции осуществляется проверка на возможность списания, поэтому данная функциональность не влияет на списание баллов.
Разница между всеми начисленными баллами (даже если баллы не начали действие) и всеми списанными записывается и постоянно обновляется в поле «Баланс». Помимо этого, есть ещё поле «Активный баланс», в нем записано актуальное на текущую дату количество баллов, которые не завершили своё действие. Также в активном балансе не учитываются баллы, которые начислены, но ещё не начали действовать.
Важно! Следует также иметь в виду, что в ответах чека передаются активные балансы, поэтому даже если баллы закончили действие, но балансы ещё не пересчитаны, то в ответах эти баллы передаются как годные для оплаты.
Важно! Также стоит отметить, что настройки списания баллов можно поменять для конкретной реализации версии системы. Можно установить обновление активного баланса каждый час, но стоит иметь в виду, что это будет нагружать систему и быстродействие снизится.
Оплата баллами определённых покупок также влияет на состояние балансовых полей, также как и возврат покупок во время действия акций программы лояльности. Следует иметь в виду, что возврат не влияет на обновление поля «Количество покупок», даже если это полный возврат покупки, финансовые и балансовые поля обновляются на возвращаемые значения.
Следует обратить внимание, что несколько карт могут быть объединены в мастер-счёт. Например, в мастер-счёт могут быть объединены карты, принадлежащие одной семье, тогда мастер-счёт будет общим семейным счётом бонусных баллов. Объединение карт в мастер–счёт позволяет при предъявлении карты, входящей в мастер-счёт, оплачивать покупки баллами, которые накоплены на всех картах данного мастер-счёта, даже если на активном балансе предъявленной при покупке карты нет или недостаточно баллов для оплаты покупки. Следует обратить внимание, что для оплаты покупки могут быть доступны баллы, которые являются суммой активных баллов всех карт мастер-счёта. Использование баллов определяется значением поля «Тип участия».
Также различные карты объединены в рамках одного контакта. Следует иметь в виду, что если карты объединены в рамках одного контакта или в рамках одного мастер-счёта, то для оплаты покупок автоматически доступны все активные баллы всего объединённого множества карт. Даже если на предъявленной для операции покупки нет активных баллов, но они есть на какой-то другой карте контакта, то эти баллы будут доступны для оплаты покупки.
В течение жизненного цикла карта может быть в разном статусе. Статусы карты могут быть следующими: Новая, Активная, Заблокирована, Закрыта, Завершена. При генерации записи карт создаются в статусе «Новая», но можно также при генерации карт указать, чтобы записи карт создались в статусе «Активная». В этом случае карта сразу переходит в статус «Активная».
Статусы меняются либо автоматически, либо вручную. Любая транзакция по карте со статусом «Новая» переводит запись данной карты в статус «Активная». Статусы «Заблокирована», «Закрыта», «Завершена» присваиваются автоматически, это определяется административными настройками, кроме статуса «Заблокирована». Этот статус может быть установлен оператором. Для блокировки карты в меню формы оператор должен нажать кнопку Заблокировать. Заблокированную карту вручную можно перевести в статус «Активная», либо в статус «Новая».
Следует иметь в виду, что при обработке транзакций учитываются не только актуализированные статусы карты, но также время, когда они были установлены. Например, вы можете активировать карту сегодня, и попытаться совершить транзакцию по карте вчерашним днём, когда она была заблокирована, например, провести какой-то чек, который был выписан вчера, но информация о нём пришла только сегодня. Даже если данный чек попадает в действие акции программы лояльности, при обработке чека вернётся ошибка, так как карта на момент выписки чека была заблокирована. История изменения статусов карты также хранится в системе, чтобы её посмотреть необходимо открыть в связанных записях История статусов карты.
Карточка Карты содержит следующую информацию:
| Поле | Описание | Обязательное поле | Редактирование |
| Ответственный | Пользователь, ответственный за создание и ведение данной записи. | Да | Поле доступно для редактирования. Заполняется из справочника пользователей. |
| Подразделение | Подразделение, к которому относится данная запись. | Да | Поле доступно для редактирования. Заполняется из справочника подразделений. |
| Общие сведения | |||
| Номер | Номер карты. | Да | Поле не доступно для редактирования, заполняется автоматически (при генерации) |
| Тип карты | Ссылка на тип карты. | Нет | Поле доступно для редактирования, заполняется вручную |
| Тип начислений | Тип начислений карты. Возможные значения: Бонус Скидка Бонус + скидка Подарки | Да | Поле не доступно для редактирования, заполняется автоматически (при генерации карт) |
| Статус карты | Статус карты. Возможные значения: Новая Активный Заблокирована Закрыта Завершена | Да | Поле не доступно для прямого редактирования, заполняется автоматически |
| Дата изменения статуса | Дата последнего изменения статуса карты. | Да | Поле не доступно для редактирования, заполняется автоматически |
| Состояние | Дополнительный статус карты (в процессинге не используется). Возможные значения:
| Нет | Поле доступно для редактирования, заполняется вручную |
| Принадлежность | |||
| Контакт | Физическое лицо, которому принадлежит карта и идентифицирует этого человека как участника программы лояльности. | Нет | Поле доступно для редактирования, заполняется вручную |
| Редактируемый уровень | Признак редактируемости уровня. Возможные значения:
В случае значения "Да" - пользователь указывает уровень вручную. В случае значения "Нет" - система рассчитывает уровень по настройкам автоматически. | Нет | Поле доступно для редактирования, заполняется вручную |
| Тип участия | Статус участия карты в программе лояльности. Возможные значения: только начисление только списание начисление и списание | Да | Поле доступно для редактирования, заполняется вручную |
| Мастер счёт | Мастер счёт, в который входит карта. | Нет | Поле доступно для редактирования, заполняется вручную |
| Инициатор создания мастер-счета | Признак инициатора создания мастер-счета. В значении «Да» может быть только у одной карты из входящих в мастер-счёт. При создании новой карты данный параметр всегда в значении «Нет». Возможные значения: Да Нет | Нет | Поле доступно для редактирования, заполняется вручную |
| Запрет на списание денег с карт мастер-счета | Признак того, что по этой карте недоступно списание денег с карт мастер-счета, в который она входит. | Нет | Поле доступно для редактирования, заполняется вручную |
| Партнёр | Партнёр, который выпустил данную карту лояльности. | Да | Поле доступно для редактирования, заполняется вручную |
| Магазин | Ссылка на магазин, в котором выдана карта лояльности участнику программы лояльности. | Нет | Поле доступно для редактирования, заполняется вручную |
| Период действия | |||
| Дата начала действия | Дата начала периода действия карты. | Да | Поле не доступно для редактирования, заполняется автоматически (при генерации) |
| Дата окончания действия | Дата окончания периода действия карты. | Да | Поле не доступно для редактирования, заполняется автоматически (при генерации) |
| Дополнительные параметры | |||
| Внешний идентификатор | Код идентификации для интеграции с внешними системами. | Нет | Поле доступно для редактирования, заполняется вручную |
| Задание на выпуск | Ссылка на задание на выпуск. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Новая карта | Карта, на которую заменена данная карта. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Подсказка | Подсказка (кодовое слово) для идентификации клиента, которому принадлежит карта, в случае если он обращается. Подсказка генерируется вместе с картой, изменить его нельзя. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Покупки | |||
| Сумма без скидок | Общая сумма покупок по карте без скидок. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Сумма скидок | Общая сумма скидок, полученных при использовании карты. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Сумма со скидкой | Общая сумма покупок по карте с учётом скидок. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Текущая скидка (%) | Текущий активный уровень скидки по карте. Не может превзойти 100%. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Количество покупок | Общее количество покупок, совершённых с использованием карты. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Средний чек | Значение среднего чека по карте за всю историю карты в программе лояльности. Общая сумма покупок, делённая на количество покупок. Чеки возврата в количество покупок не входят. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Средний чек со скидками | Значение среднего чека с учётом скидок по карте за всю историю карты в программе лояльности. Общая сумма покупок со скидкой, делённая на количество покупок. Чеки возврата в количество покупок не входят. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Дата последней операции | Дата чека покупки с максимальной датой. Чеки возврата не учитываются для определения даты последней транзакции. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Баланс бонусов | |||
| Дебет (баллы) | Общее количество начисленных бонусных баллов по карте. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Кредит (баллы) | Общее количество списанных бонусных баллов по карте. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Баланс (баллы) | Разница между количеством начисленных и списанных бонусных баллов по карте. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Активный баланс (баллы) | Количество бонусных баллов, доступных для списания в настоящий момент. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Баланс статусных бонусов | |||
| Дебет (статусные баллы) | Общее количество начисленных статусных баллов по карте. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Кредит (статусные баллы) | Общее количество списанных статусных баллов по карте. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Баланс (статусные баллы) | Разница между количеством начисленных и списанных статусных баллов по карте. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Активный баланс (статусные баллы) | Количество статусных баллов, доступных для списания в настоящий момент. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Баланс денежных средств | |||
| Дебет (деньги) | Общее количество начисленных денежных средств по карте. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Кредит (деньги) | Общее количество списанных денежных средств по карте. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Баланс (деньги) | Разница между количеством начисленных и списанных денежных средств по карте. | Нет | Поле не доступно для редактирования, заполняется автоматически |
| Зависимости | |||
| Покупки | |||
| Чеки | Представление, в котором показаны связанные с текущей картой чеки | ||
| Заказы | Представление, в котором показаны связанные с текущей картой заказы | ||
| Счётчики карты | Представление, в котором показаны связанные с текущей картой счётчики карты | ||
| События счётчиков | Представление, в котором показаны связанные с текущей картой события счётчиков | ||
| Бонусы | |||
| Баллы начисления | Представление, в котором показаны связанные с текущей картой балы начисления | ||
| Баллы списания | Представление, в котором показаны связанные с текущей картой баллы списания | ||
| Бонусные счета | Представление, в котором показаны связанные с текущей картой бонусные счета | ||
| Запросы начисления / списания баллов | Представление, в котором показаны связанные с текущей картой запросы начисления/списания баллов | ||
| Купоны | |||
| Купоны | Представление, в котором показаны связанные с текущей картой купоны | ||
| Лимиты по купонам | Представление, в котором показаны связанные с текущей картой лимиты по купонам | ||
| Запросы гашения купонов | Представление, в котором показаны связанные с текущей картой запросы гашения купонов | ||
| Правила | |||
| Персональные предложения | Представление, в котором показаны связанные с текущей картой персональные предложения | ||
| Интеграционные персональные предложения | Представление, в котором показаны связанные с текущей картой интеграционные персональные предложения | ||
| Рекомендованные товары | Представление, в котором показаны связанные с текущей картой рекомендованные товары | ||
| Деньги | |||
| Начисления на денежный счёт | Представление, в котором показаны связанные с текущей картой начисления на денежный счёт | ||
| Списания с денежного счёта | Представление, в котором показаны связанные с текущей картой списания с денежного счёта | ||
| Денежные транзакции | Представление, в котором показаны связанные с текущей картой денежные транзакции | ||
| Расширенные атрибуты | Представление, в котором показаны расширенные атрибуты связанные с текущей картой | ||
| Идентификаторы участника | Представление, в котором показаны идентификаторы участника связанные с текущей картой | ||
| Списки карт | Представление, в котором показаны списки карт связанные с текущей картой | ||
| Заявки на загрузку чеков | Представление, в котором показаны заявки на загрузку чеков связанные с текущей картой | ||
| История уровней | Представление, в котором показана история уровней связанных с текущей картой | ||
| История статусов карты | Представление, в котором показана история статусов карты связанных с текущей картой | ||
| История изменений РА карты | Представление, в котором показана история изменения расширенных атрибутов карты связанных с текущей картой | ||
| История ручных бонусов | Представление, в котором показана история ручных бонусов связанных с текущей картой | ||
| История ручных чеков | Представление, в котором показана история ручных чеков связанных с текущей картой | ||

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

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

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

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

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

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

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

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

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

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

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

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

Рис. Карта с типом «Начисления и списания»
Блокировка карт по отрицательным балансам
В системе есть 2 системных настройки, в которых указывается число. Если отрицательный баланс превосходит это число (например, если в настройке указано значение 1000, а на карте -1050 баллов), то карта будет заблокирована, и в зависимости какой именно баланс превосходит минимальное количество отрицательных баллов, изменится поле состояние на «Заблокирована из-за отрицательного баланса» или «Заблокирована из-за отрицательного активного баланса».
Системная настройка Loyalty.Processing.LockCardWhenBalanceLessThan определяет значение баланса, ниже которого карта будет заблокирована. А системная настройка Loyalty.Processing.LockCardWhenActiveBalanceLessThan определяет значение, ниже какого активного баланса карта будет заблокирована.
Верификация операций с картами
В системе предусмотрена возможность верификации следующих операций:
1. Оплата покупок бонусными или статусными баллами (на основании запросов чеков). Для этой операции предусмотрена верификация проверочным кодом в SMS-сообщении (настройки для верификации задаются в карточке партнера в блоке «Верификация оплаты покупок»).

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

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

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

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

Рис. Справочник списков карт
Динамическая фильтрация зависит от времени выполнения алгоритмов процессинга и текущих характеристик карт. Для осуществления динамической фильтрации необходимо задать диапазоны соответствующих характеристик. Отрабатывая в какой-то момент времени, алгоритм будет выполняться только по тем картам, текущие характеристики которых укладываются в установленные диапазоны.
Динамическая фильтрация карт
Почти все параметры карты можно использовать при фильтрации алгоритмов процессинга. Для этого служат специальные записи – наборы контактов (подробнее см. в пункте Фильтрация по контактам).

Рис. Фильтры по контактам
Набор содержит заданные диапазоны на различные характеристики карты. Если в какой-то момент времени характеристики конкретной карты таковы, что укладываются в указанные диапазоны, то карта подпадает под условия фильтрации и к ней могут быть применены, например, правила начисления. Записи наборов могут быть отнесены к записям настройки алгоритма (правила начисления, правила списания, задания по расписанию) как включаемые, так и исключаемые.
Статическая фильтрация карт
Статическая фильтрация осуществляется с помощью списков карт, каждый из которых представляет собой отдельную запись в системе.
Список карт содержит следующую информацию:
| Поле | Описание | Обязательное поле | Редактирование |
| Активно | Признак активности для процессинга. Возможные значения: Да Нет Значение по умолчанию Да. | Да | Поле доступно для редактирования, заполняется вручную |
| Ответственный | Пользователь, ответственный за создание и ведение данной записи. | Да | Поле доступно для редактирования. Заполняется из справочника пользователей. |
| Подразделение | Подразделение, к которому относится данная запись. | Да | Поле доступно для редактирования. Заполняется из справочника подразделений. |
| Общие сведения | |||
| Название | Название списка карт. Поле используется для поиска и в представлениях. | Да | Поле доступно для редактирования, заполняется вручную |
| Внешний идентификатор | Код интеграции с внешними системами.
| Нет | Поле доступно для редактирования, заполняется вручную |
| Описание | Подробное описание списка карт. | Нет | Поле доступно для редактирования, заполняется вручную |
| Зависимости | |||
| Карты | Представление, в котором показаны Карты связанные с текущим списком карт | ||
| Фильтры по контактам | Представление, в котором показаны Фильтры по контактам с текущим списком карт (Включено в фильтры по контактам, Исключено из фильтров по контактам) | ||
| Кампании | Представление, в котором показаны Кампании с текущим списком карт (Включено в кампании, Исключено из кампаний) | ||
Внешний вид карточки Список карт:

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

Рис. Дополнительные идентификаторы в карточке карты
По умолчанию алгоритм поиска среди записей дополнительных идентификаторов отключен. Для его включения предусмотрена партнёрская/системная настройка Loyalty.Processing.AdditionalIdentification.TurnOn (партнёрская настройка задаётся через текстовый расширенный атрибут партнёра).
При этом возможно установить алгоритм предпочтительного поиска с помощью партнёрской/системной настройки Loyalty.Processing.PreferredSearch.ParticipantIdentification: в случае значения 0 при регистрации запроса вначале происходит поиск среди карт лояльности и затем среди записей дополнительных идентификаторов, в случае значения 1 наоборот - вначале происходит поиск среди значений дополнительных идентификаторов, а затем среди карт лояльности. В партнёрской/системной настройке Loyalty.Processing.AcceptedCardIdentifier можно задать ключ расширенного атрибута чека, в который будет записан идентификатор карты лояльности, если запрос зарегистрирован не по карте лояльности (значение по умолчанию ACI_).
Карточка идентификатора участника содержит следующую информацию:
| Поле | Описание | Обязательное поле | Редактирование |
| Активно | Признак активности для процессинга. Возможные значения: Да Нет Значение по умолчанию Да. | Да | Поле доступно для редактирования, заполняется вручную |
| Ответственный | Пользователь, ответственный за создание и ведение данной записи. | Да | Поле доступно для редактирования. Заполняется из справочника пользователей. |
| Подразделение | Подразделение, к которому относится данная запись. | Да | Поле доступно для редактирования. Заполняется из справочника подразделений. |
| Общие сведения | |||
| Идентификатор | Идентификатор участника (карты участника). Поле используется для поиска и в представлениях. | Да | Поле доступно для редактирования, заполняется вручную |
| Карта | Карта участника. | Да | Поле доступно для редактирования, заполняется вручную |
| Тип идентификатора | Тип идентификатора. Возможные значения: 1 – Прочее 2 – Карта банка 3 – Социальная карта 4 – Абонемент | Да | Поле доступно для редактирования, заполняется вручную |
| Партнер | Партнёр карты участника. | Да | Поле доступно для редактирования, заполняется вручную |
| Описание | Подробное описание идентификатора. | Нет | Поле доступно для редактирования, заполняется вручную |
Внешний вид карточки Идентификатор участника:

Рис. Карточка дополнительного идентификатора карты
Автоматическая привязка свободных карт к контактам без карты
Система предоставляет возможность для автоматической привязки свободных карт к контактам, у которых отсутствует карта (к контактам, у которых нет ни одной карты в каком бы то ни было статусе).
Данная функциональность включается по системной настройке Loyalty.SystemJob.BindCardToContact.
Ночным джобом к контакту, не имеющему ни одной карты, привязывается одна свободная карта без покупок в статусе «Новая» или «Активная» и связанной с типом, принадлежащему региону контакта. Примечание: Для контактов без регионов привязка карты не осуществляется.
Ограничение количества активных карт у одного контакта
Система предоставляет возможность для ограничения привязки к одному контакту более одной активной карты через интерфейс ML. Другими словами, если у контакта уже есть хотя бы одна активная карта, то к нему не разрешается привязать ещё одну активную карту. Проверка осуществляется как в момент привязки активной карты, так и в момент активации карты, уже привязанной к контакту.
Данное ограничение включается по партнерской/системной настройки Loyalty.Interface.ActiveCardLimit (партнёрская настройка задаётся через текстовый расширенный атрибут партнёра). По умолчанию настройка выключена. Если включена настройка и происходит попытка привязки активной карты к контакту, у которого уже есть активная карта, то отображается в интерфейсе соответствующая ошибка.
Электронные подарочные карты
- Поиск подарочной карты в UI по номеру телефона получателя карты
- Отправка смс по подарочной карте
- Системные/партнерские настройки
- Настройка привилегии для роли
Поиск подарочной карты в интерфейсе Manzana Loyalty можно осуществлять по любому расширенному атрибуту карты, заведенному в системе.
Поиск подарочной карты в UI по номеру телефона получателя карты
Клиент, который приобрел и подарил карту, может обратиться в Контакт центр с разными запросами, например если необходимо заблокировать подарочную карту, получить данные по карте (номер карты и кодовое слово) или изменить номер телефона получателя карты.
Подарочную карту в UI можно найти по значению РА карты с наименованием «Phone» («Phone» - значение по умолчанию, берется из партнёрской настройки Loyalty.Processing.MoneyRequest.ChargeOperation.Phone.CardEAKey) и выполнить нужные операции.
При запросе изменения номера телефона получателя подарочной карты, номер меняется в этом РА карты.

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

Рис. Кнопка "Отправить смс" в карточке карты
Предварительно в системе должен быть заведен шаблон сообщения с настроенными обязательными параметрами. Для информирования получателя о данных карты, в шаблоне необходимо указать:
- «Тип сообщения» = «SMS»
- «Использовать для отправки сообщений через форму» = «Показать на форме карты». При таком значении на форме карты в окне отправке смс будет доступен для выбора этот шаблон. Если параметр «Использовать для отправки сообщений через форму» = «Не показывать», такой шаблон сообщений не будет показываться при отправке смс из формы карты.
- «Тип операции» = «Личный кабинет»
- Метапеременные в тексте сообщения - %card_num% (номер карты) и %card_codeword% (код карты).

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

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

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

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

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

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