Выпуск промо-кодов для внешних партнеров
В некоторых случаях требуется создать такие промо-коды, которые никак не влияют на начисление баллов или скидок, а просто учитываются в системе. Например, чтобы фиксировать регистрацию в программе лояльности таких клиентов, которые пришли от партнеров, и при этом за такой промо-код не должны начисляться никакие поощрения. Сценарий редкий, но его можно реализовать через раздел «Приложения» => «Выпуск промо-кодов».
Промо-коды на скидку или бонусы настраиваются через различные выпуски купонов»
Карточка выпуска промо-кодов содержит следующие поля:
| Поле | Описание | Обязательное поле | Редактирование |
| Наименование | Наименование выпуска промо-кодов | Да | Поле доступно для редактирования, заполняется вручную |
| Внешний идентификатор | Код интеграции с внешними системами. | Нет | Поле доступно для редактирования, заполняется вручную |
| Партнер | Ссылка на партнёра. Промо-коды будут принадлежать данному партнёру. | Нет | Поле доступно для редактирования. Заполняется из справочника партнеров. |
| Кампания | Ссылка на акцию программы лояльности (кампанию), в рамках которой создается выпуск промо-кодов. | Да | Поле доступно для редактирования. Заполняется из справочника кампаний. |
| Дата начала | Дата начала действия промо-кодов. | Да | Поле доступно для редактирования, заполняется вручную |
| Дата окончания | Дата окончания действия промо-кодов. | Да | Поле доступно для редактирования, заполняется вручную |
| Статус | Возможные значения: 1 – Новый 2 –Генерация 3 – Генерация завершена 4 – Генерация завершена с ошибкой | Да | Поле закрыто для редактирования. Значение по умолчанию – Новый. Если «Статус» выпуска промокода имеет значение 2, 3 или 4 – все поля формы становятся закрытыми для редактирования. |
| Описание | Подробное описание выпуска промо-кодов. | Нет | Поле доступно для редактирования, заполняется вручную |
| Количество | Количество промо-кодов, которое необходимо выпустить. | Да | Поле доступно для редактирования, заполняется вручную |
| Маска | Поле, значение которого задаёт номерную серию. В Маске могут быть указаны символы и буквы. Символы отличные от символа * являются статичными и не меняются в значении и очередности в номере. Символы * являются не статичными и меняют в свое значение. Изменяемая часть уже зависит от полей Тип распределения, тип макси и бар-код | Да | Поле доступно для редактирования, заполняется вручную |
| Тип маски | В поле перечисляются все возможные символы, из которых допустима генерация кода. Это могут быть цифры, буквы - большие / маленькие, латиница / кириллица и другие. Если перечислены цифры - цифровой номер, если цифры и буквы - буквенно-цифровой. Если в генерации используется бар-код, то в поле указывается значение: 012345679. Поле Тип распределения для таких выпусков устанавливается в значении – Не используется. | Да | Поле доступно для редактирования, заполняется вручную |
| Тип Бар-кода | Формат номера, которому будут принадлежать выпускаемые промо-коды. Возможные значения: • Не использовать • EAN-8 • EAN-13 Значение по умолчанию: Не использовать. | Нет | Поле доступно для редактирования, заполняется вручную |
| Тип распределения | Параметр, задающий каким образом будут присваиваться номера. Возможные значения: 0 – Не используется 1 – Случайно 2 – Последовательно | Да | Поле доступно для редактирования, заполняется вручную. По умолчанию значение - Последовательно |
Процедура генерации активированного выпуска запускается по джобу ночью. При завершении генерации статус в выпуске промо-кодов меняется на «Генерация завершена» или «Генерация завершена с ошибкой» в зависимости от результата. Для генерации промо-кодов пользователь должен иметь в правах доступа роль Менеджера программы лояльности, права на создание всех сущностей и редактирование генерации промо-кода.
Возможные ошибки генерации:
- Неверная маска выпуска
- Неверная маска выпуска для бар кодов
- Номер промо-кода уже существует в системе
- Маска закончилась
- Другие системны ошибки

Рис. Активированный Выпуск промо-кодов
Номера промо-кодов расположены в Выпуске промо-кодов в закладке Промо-коды после закладки Параметры. Если при генерации номера промо-кодов пересекается с теми, что уже есть в системе, весь выпуск падает в ошибку. Промо-код генерируется в статусе «Активный».

Рис. Выпущенные промо-коды
Промо-коды - эта процессинговая сущность, пользователем не изменяется. В промо-кодах содержатся следующие поля:
| Поле | Описание |
| Номер | Номер промо-кода |
| Дата создания | Дата, когда промо-код был сгенерирован |
| Кампания | Ссылка на сущность Кампания |
| Контакт | Ссылка на сущность Контакт |
| Дата начала | Дата начала действия промо-кода |
| Дата окончания | Дата окончания действия промо-кода |
| Статус | Возможные значения: 1 –Активный 2 –Погашен 3 – Завершен |
| Выпуск промокода | Ссылка на сущность Выпуск промо-кода |
Промо-код передается в методе регистрации POST Identity/AdvancedPhoneEmailRegister и обновления контакта POST Contact/Update. Если он есть в системе, имеет корректные текущие даты и ни к кому не привязан, то такой промо-код привязывается к контакту в статусе "Погашен".
Примененные промо-коды находятся в карточке Контакта в табе «Правила».

Рис. Промо-код в карточке Контакта.