Выпуск карт

Редактировал(а) Татьяна Брыкова 2025/08/15 11:19

Типы карт

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

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

1712911512281-672.png

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

Типы карт заводятся перед тем, как карты будут выпущены. Карточка Типа карты содержит следующую информацию:

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

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

  • Да
  • Нет

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

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

Ссылка на регион.

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

Ночным джобом к контакту, не имеющему ни одной карты, привязывается свободная карта без покупок в статусе «Новая» или «Активная» и с типом, который принадлежит региону контакта (для контактов без регионов никакой привязки не осуществляется). Данная функциональность включается по системной настройке Loyalty.SystemJob.BindCardToContact.

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

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

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

  • Да
  • Нет

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

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

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

  • Да
  • Нет

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

НетПоле доступно для редактирования, заполняется вручную
Предельное количество для контактаЛимит карт данного типа на контактаНетПоле доступно для редактирования, заполняется вручную
Начальные параметры карт
Минимальная сумма денег для активации:Минимальная сумма денежных средств для активации карты.НетПоле доступно для редактирования, заполняется вручную
Минимальная сумма начисления денег:Минимальная сумма денежных средств к начислению.НетПоле доступно для редактирования, заполняется вручную
Максимальный денежный баланс:Максимальный денежный баланс карты.НетПоле доступно для редактирования, заполняется вручную
Кратность начисления денег:Кратность суммы начислений денежных средств. Означает, что можно пополнить на карту данного типа (по запросу начисления денег) такое количество денег, которое будет кратно данному значению.НетПоле доступно для редактирования, заполняется вручную
Параметры списания
Подтверждение списания

Способ подтверждения списания баллов с конкретного типа карты.

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

0 - Не используется,

1 - Динамический QR-код.

По умолчанию: 0 - Не используется

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

1712911565993-687.png

Рис. Карточка Тип карты – Обзор

1712911592505-195.png

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

Чтобы указать период в днях, по истечению которого с момента последней активности карта блокируется (статус Заблокирована), используется поле «Период неактивности». Если поле пустое, то значение берется из системной настройки Loyalty.CardManagement.Processes.InactivityPeriod.

1712911620862-961.png

Рис. Указание периода неактивностии карты

Чтобы указать период в днях, по истечении которого с момента блокировки карта переводится в статус Закрыта, используется поле «Период блокировки». Если поле пустое, то значение берется из системной настройки Loyalty.CardManagement.Processes.BlockPeriod.

1712911643632-136.png

Рис. Указание периода блокировки карты

Чтобы указать период в днях, по истечении которого с даты установки статуса Закрыта карта переводится в статус Завершена, используется поле «Период завершения». Если поле пустое, то значение берется из системной настройки Loyalty.CardManagement.Processes.ExpirationPeriod.

1712911665299-695.png

Рис. Указание периода завершения карты

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

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

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

Наличие отдельных запросов на начисление и списание позволяет использовать Manzana Loyalty как платёжную систему.

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

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

1712912920912-610.png

Рис. Поля, регулирующие начисление денег на карту в карточке «Тип карты»

Если в карточке «Тип карты» заполнено значение поля «Минимальная сумме денег для активации», и если операция начисления происходит по карте этого типа в статусе Новая, то для начисления необходима сумма не меньше указанной; более того, при начислении карта будет активирована.

1712912959242-323.png

Рис. Поле «Минимальная сумма денег для активации» в карточке «Тип карты»

Если в карточке «Тип карты» заполнено значение поля «Минимальная сумма начисления денег» и операция начисления происходит по карте данного типа, то любая сумма денег для начисления не должна быть меньше указанного значения. В противном случае, на терминал будет возвращено сообщение об ошибке.

1712913004728-688.png

Рис. Поле «Минимальная сумма начисления денег» в карточке «Тип карты»

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

1712913032262-463.png

Рис. Поле «Максимальный денежный баланс» в карточке «Тип карты»

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

1712913055780-881.png

Рис. Поле «Кратность начисления денег» в карточке «Тип карты»

Общий лимит по типам карт

Можно устанавливать общий лимит на совокупность типов карт для контакта, чтобы он не мог привязать больше карт, чем указано в лимите. Для этого в системе необходимо завести и включить 2 партнерские настройки: Loyalty.Processing.Card.Limit.Types, Loyalty.Processing.General.Card.Limit.

1732777985474-292.png

1732778018533-742.png

Процесс привязки карты к контакту по любому каналу (через интерфейс, методами API) с учетом общего лимита состоит из проверок:

  • Настройки Loyalty.Processing.Card.Limit.Types на:
    • наличие типа привязываемой карты в перечне её значений
    • количество карт  с типами из настройки, привязанных к контакту.
  • Настройки Loyalty.Processing.General.Card.Limit:
    • карта не привязывается к контакту, если общее количество привязанных карт у контакта превышает или равно лимиту из настройки  или лимиту, указанному в типе привязываемой карты (выбирается минимальный между лимитом в типе и лимитом в настройке). Система выдает ответ о превышении лимита.
    • карта привязывается, если количество привязанных к контакту карт не превышает лимит.

Если хотя бы одна из этих настроек отсутствует или пустая, то учитывается лимит из типа карты.

В общем лимите не учитываются карты в статусе "завершена" и "закрыта".

Регистрация карт в системе

Процесс генерации карт в системе поддерживает несколько вариантов генерации номеров карт. Генерация осуществляется с использованием таких параметров, как маска номера, диапазон генерируемых номеров, количество генерируемых карт и тип генерации. Тип генерации может быть линейный, т.е. при генерации карт в выбранном диапазоне берутся номера подряд, начиная с первого в диапазоне; можно задать шаг, через который будут браться номера в диапазоне; можно задать случайное распределение номеров.

1712911770127-912.png

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

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

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

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

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

  • Да
  • Нет

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

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

Значение выбирается из выпадающего списка, определяет статус участия карты. Возможные значения:

  • Начисления и списания
  • Только списания
  • Только начисления

Значение по умолчанию: Начисления и списания.

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

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

  • Бонус
  • Скидка
  • Бонус + скидка
  • Подарки (не используется в текущей функциональности)

Значение по умолчанию Бонус + скидка.

ДаПоле доступно для редактирования, заполняется вручную
Редактируемый уровень

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

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

  • Да
  • Нет
ДаПоле доступно для редактирования, заполняется вручную
Длина подсказкиКоличество символов подсказки (кодового слова) карты. По умолчанию 10 символов.ДаПоле доступно для редактирования, заполняется вручную
Символы подсказки

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

  • Только цифры
  • Цифры и заглавные латинские буквы
  • Цифры, заглавные и строчные латинские буквы

Значение по умолчанию: Только цифры.

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

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

  • Дата начала + период неактивности
  • Фиксированная дата

Значение по умолчанию: Фиксированная дата.

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

Отображается при значении параметра «Тип вычисления даты окончания бонусов» = Дата начала + Период действия

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

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

Отображается при значении параметра «Тип вычисления даты окончания действия бонусов» = Дата начала + Период действия

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

  • Дни
  • Месяцы
  • Кварталы
  • Года
НетПоле доступно для редактирования, заполняется вручную
Срок действия бонуса

Отображается при значении параметра «Тип вычисления даты окончания бонусов» = Дата начала + Период действия

Период для вычисления даты окончания бонусов.

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

Отображается при значении параметра «Тип вычисления даты окончания бонусов» = Фиксированная дата

Дата окончания действия бонусов.

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

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

  • Постоянно
  • Дата выпуска
  • Фиксированная дата

Если значение постоянно, то дата начала действия карты будет установлена как 1.1.2000 года. Дата выпуска – карта будет действовать с момента выполнения задания на выпуск. Фиксированная дата – необходимо установить определённое значение даты начала действия.

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

Отображается при значении параметра «Способ вычисления даты начала действия» = Фиксированная дата.

Дата, с которой начнут действовать созданные по данному шаблоны карты.

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

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

  • Постоянно
  • Дата начала + период действия
  • Фиксированная дата

Если значение постоянно, то дата начала действия карты будет установлена как 1.1.3000 года. Дата начала + период неактивности – дата окончания действия будет вычислена как дата запуска задания, к которой будет добавлено количество дней, указанное в поле «Период действия». Фиксированная дата – необходимо установить определённое значение даты окончания действия.

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

Отображается при значении параметра «Способ вычисления даты окончания действия» = Фиксированная дата.

Дата, до которой будет действовать карта.

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

Отображается при значении параметра «Способ вычисления даты окончания действия» = Дата начала действия + период действия.

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

НетПоле доступно для редактирования, заполняется вручную
Формат номера карт (Для выпуска on-line) – предназначено для выпуска карт через запрос создания/изменения контакта на POS-сервисе.
МаскаЧисловое значение, определяющее формат номера карты. В маске возможными символами могут быть латинские буквы и цифры. Свободные символы задаются звёздочками. Последовательность свободных символов должна быть непрерывна. Например, такое значение возможно: nn**** и не приведёт к ошибке. Значение **nn** будет приводить к ошибке.НетПоле доступно для редактирования, заполняется вручную
Распределение

Параметр, который определяет каким образом будут присваиваться номера создаваемым картам. Возможные значения:

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

Отображается при значении параметра «Распределение номеров» = Равномерно.

Шаг, через который будет присваиваться номер следующей карты.

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

Отображается при значении параметра «Распределение номеров» = Случайно.

Верхнее значение номерной последовательности свободных символов маски.

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

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

  • Не используется
  • EAN-8
  • EAN-13

В случае EAN-8 на код отводится 7 позиций (символов), включая свободные символы; в случае EAN-13 на код отводится 12 позиций (символов), включая свободные символы.

НетПоле доступно для редактирования, заполняется вручную
Контрольная цифра по алгоритму Луна

Возможность при генерации карт добавлять к номеру контрольную цифру по алгоритму LUHN. Возможные значения:

  • Да
  • Не

Признак активируется, если в поле Тип бар-кода выбрано значение "Не использовать"

НетПоле доступно для редактирования, заполняется вручную
Зависимости
КартыПредставление, в котором показаны карты связанные с текущим шаблоном
Задания на выпуск картПредставление, в котором показаны задания на выпуск карт, связанные с текущим шаблоном

1712911853224-759.png

Рис. Карточка шаблона выпуска карт - Обзор

1712911890321-912.png

Рис. Задания на выпуск карт, связанные с текущим шаблоном выпуска карт

1712911955737-143.png

Рис. Карточка шаблона выпуска карт - Детализация

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

1712912021236-834.png

Рис. Справочник заданий выпуска карт

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

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

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

  • Да
  • Нет

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

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

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

 

МаскаЧисловое значение, определяющее формат номера карты. В маске возможными символами могут быть латинские буквы и цифры. Свободные символы задаются звёздочками. Последовательность свободных символов должна быть непрерывна. Например, такое значение возможно: nn**** и не приведёт к ошибке. Значение **nn** будет приводить к ошибке.ДаПоле доступно для редактирования, заполняется вручную
Количество картКоличество карт, которое необходимо выпустить в рамках задания. Следует иметь в виду, что маска и диапазоны должны позволять выпустить заданное количество карт.ДаПоле доступно для редактирования, заполняется вручную
Активировать карты

Параметр, указывающий необходимость перевода карт в статус Активный при выпуске.

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

*В случае если связанный с заданием на выпуск тип карты имеет признак «Виртуальный тип», то в поле по умолчанию будет значение «Нет».

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

Параметр, который определяет каким образом будут присваиваться номера создаваемым картам. Возможные значения:

  • Последовательное
  • Равномерное
  • Случайное

Значение по умолчанию: Последовательное.

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

Отображается при значении параметра «Распределение номеров» = Равномерно.

Шаг, через который будет присваиваться номер следующей карты. В случае последовательного распределения данный параметр всегда равен 1.

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

Отображается при значении параметра «Распределение номеров» = Случайно.

Верхнее значение номерной последовательности свободных символов маски.

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

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

  • Не используется
  • EAN-8
  • EAN-13

Значение по умолчанию: Не используется.

В случае EAN-8 на код отводится 7 позиций (символов), включая свободные символы; в случае EAN-13 на код отводится 12 позиций (символов), включая свободные символы.

НетПоле доступно для редактирования, заполняется вручную
Контрольная цифра по алгоритму Луна

Возможность при генерации карт добавлять к номеру контрольную цифру по алгоритму LUHN. Возможные значения:

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

1712912195353-279.png

Рис. Карточка задания на выпуск карт – Обзор

1712912236809-212.png

Рис. Карточка задания на выпуск карт – Детализация

Процесс создания карт

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

Перед созданием карт в системе должны быть заведены хотя бы один тип карт и один шаблон. Стоит иметь в виду, если карты подразумевают создание с одновременным начислением какого-то начального количества бонусных баллов, то в системе должна быть также заведена акция программы лояльности (кампания), в рамках которой будут начислены данные баллы. Следует также отметить, что записи типов и шаблонов должны быть активными, в противном случае создание карт не произойдёт. После этого можно создавать задание на выпуск. Как только задание на выпуск карт создано, активировано и сохранено, то становится доступна для нажатия кнопка «Генерация».

1712912286770-863.png

Рис. Создание нового задания на выпуск карт

Нажатие данной кнопки, после дополнительного подтверждения, запускает процесс создания карт.

1712912310351-908.png

Рис. Подтверждение запуска задания на выпуск карт

Вначале статус задания устанавливается в значение «В очереди», система при этом проверяет, если ли другие задания на генерацию и устанавливает в приоритеты выполнения.

1712912548402-448.png

Рис. Запуск генерации выпуска карт

После этого запускается процесс проверки. Данный процесс предотвращает создание карт с одинаковыми номерами.

1712912370188-491.png

Рис. Статус проверки после генерации выпуска карт

Причём, если в системе уже есть заблокированная карта, или деактивированная, или завершённая – выпустить новую карту с точно таким же номером не получится. В этом случае после проверки статус задания будет установлен в значение «Ошибка создания».

1712912428218-152.png

Рис. Ошибка генерации выпуска карт

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

Как только записи карт зарегистрированы в базе данных, статус задания устанавливается в значение «Создание завершено».

1712912595778-852.png

 Рис. Результат генерации выпуска карт

По мере выполнения задания при каждом изменении статуса происходит запись лога выполнения задания. Изменение лога сопровождается также временем изменения статуса. Лог выполнения можно просмотреть в закладке Аудит.

1712912644243-918.png

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

Задание на выпуск ограничено по времени выполнения. Ограничение записывается в системную настройку: Loyalty.CardGeneration.GenerationLifeTime. Данное значение записывается в минутах. Если по какой-то причине задание выполняется более указанного количества минут, то оно прерывается, и карты по нему не создаются. Прерванное таким образом задание уже нельзя возобновить.

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

Есть возможность выводить хэш и соль кодового слова карты на POS-сервисе в ответе на запрос баланса при включенной партнерской настройке Loyalty.Processing.BalanceRequest.CodeWordShow (партнерская настройка указывается через расширенный атрибут партнера). Это можно использовать для сверки кодового слова карты на стороне внешней системы с целью защиты от мошеннических действий (например, от подбора карт при привязке или списании бонусов).

В текущей версии не поддерживается функциональность выпуска карт с разрывами в маске. То есть свободные символы маски должны не иметь фиксированных разделителей. Например, маска AAA***WWW***D – недопустима. В качестве свободных символов маски могут быть только цифры.

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

Максимальное количество карт, которые могут быть сгенерированы одним заданием, 1000000. Если карты выпускаются со случайным распределением, а в задании указано выпустить более миллиона карт, а маска позволяет это сделать – будет выпущено только миллион карт. В случае последовательного распределения, задание будет завершено с ошибкой на стадии проверки и ни одной карты выпущено не будет.

Маска, задаваемая в шаблоне на выпуск, используется при онлайн-создании карт по запросу POS-сервиса. При генерации карт заданием используется маска, указанная в самом задании на генерацию.

Не учитывается тип бар-кода EAN в случае онлайн-создания карты по запросу POS-сервиса, а также в случае онлайн-создания карты по запросу личного кабинета.

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