Выпуск промо-кодов для внешних партнеров

Редактировал(а) Татьяна Брыкова 2024/10/25 11:48

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

Промо-коды на скидку или бонусы настраиваются через различные выпуски купонов»

Карточка выпуска промо-кодов содержит следующие поля:

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

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

1 – Новый

2 –Генерация

3 – Генерация завершена

4 – Генерация завершена с ошибкой

ДаПоле закрыто для редактирования. Значение по умолчанию – Новый. Если  «Статус» выпуска промокода имеет значение  2, 3 или 4 – все поля формы становятся закрытыми для редактирования.
ОписаниеПодробное описание выпуска промо-кодов.НетПоле доступно для редактирования, заполняется вручную
КоличествоКоличество промо-кодов, которое необходимо выпустить.ДаПоле доступно для редактирования, заполняется вручную
МаскаПоле, значение которого задаёт номерную серию. В Маске могут быть указаны символы и буквы. Символы отличные от символа * являются статичными и не меняются в значении и очередности в номере. Символы * являются не статичными и меняют в свое значение. Изменяемая часть уже зависит от полей Тип распределения, тип макси и бар-кодДаПоле доступно для редактирования, заполняется вручную
Тип маскиВ поле перечисляются все возможные символы, из которых допустима генерация кода. Это могут быть цифры, буквы - большие / маленькие, латиница / кириллица и другие. Если перечислены цифры - цифровой номер, если цифры и буквы - буквенно-цифровой. Если в генерации используется бар-код, то в поле указывается значение: 012345679.  Поле Тип распределения для таких выпусков устанавливается в значении – Не используется.ДаПоле доступно для редактирования, заполняется вручную
Тип Бар-кода

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

•             Не использовать

•             EAN-8

•             EAN-13

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

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

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

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

1 – Случайно

2 – Последовательно

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

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

Возможные ошибки генерации:

  • Неверная маска выпуска
  • Неверная маска выпуска для бар кодов
  • Номер промо-кода уже существует в системе 
  • Маска закончилась
  • Другие системны ошибки

1712758462145-939.png

Рис. Активированный Выпуск промо-кодов

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

1712758482040-424.png

Рис. Выпущенные промо-коды

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

ПолеОписание
НомерНомер промо-кода
Дата созданияДата, когда промо-код был сгенерирован
КампанияСсылка на сущность Кампания
КонтактСсылка на сущность Контакт
Дата началаДата начала действия промо-кода
Дата окончанияДата окончания действия промо-кода
Статус

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

1 –Активный

2 –Погашен

3 – Завершен

Выпуск промокодаСсылка на сущность Выпуск промо-кода

Промо-код передается в методе регистрации POST Identity/AdvancedPhoneEmailRegister и обновления контакта POST Contact/Update. Если он есть в системе, имеет корректные текущие даты и ни к кому не привязан, то такой промо-код привязывается к контакту в статусе "Погашен".

Примененные промо-коды находятся в карточке Контакта в табе «Правила».

1712758510238-950.png

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