Промокоды
Общая информация
Раздел “Промокоды” является частью системы лояльности, в которой можно работать с группами промокодов.

- Поиск - поиск по названию группы промокодов.
- Обновление страницы
- Найти конкретный промокод
- Добавить промокоды - создать новую группу промокодов.
- Фильтр, по которому можно искать:
a - Активные
b - Неактивные
c - Архивные группы промокодов - Фильтр, по которому можно искать группы:
a - Сначала новые
b - Сначала старые
c - По алфавиту
Список групп промокодов
Возле каждой группы можно увидеть:

- Список групп промокодов:
a - Тип группы (многоразовые, одноразовые, персональные)
b - Сколько промокодов использовано
c - Сколько всего в группе промокодов
d - Сколько промокодов выдано
e - Сколько промокодов осталось (после выдачи, а не после использования) - Если нажать на три точки у любой группы, появится меню действий с группой:
- Скачать - создание csv-файла, в котором будут находиться все промокоды группы.
- Приостановить - при приостановке группы уже выданные промокоды будут работать в акциях.
- Добавить - добавить промокоды в уже существующую группу (окно добавления промокодов похоже на окно создания, но в нем нет настроек группы, только настройки внешнего вида промокодов).
- В архив - так как удалить промокоды нельзя, ненужные группы можно перенести в архив.
- Скачать - создание csv-файла, в котором будут находиться все промокоды группы.
- Кнопка "Копировать группу" - копирование вернет переменную группы в формате
$[promo_code["название_группы"]], которую можно использовать в триггерах и коммуникациях.
Создание группы промокодов

-
Тип группы промокодов:
- Простые
- Активационные
- Простые
-
Группа промокодов - название группы промокодов.
-
Тип:
- Уникальные - один промокод можно использовать один раз.
- Многоразовые - один промокод можно использовать несколько раз.
- Уникальные - один промокод можно использовать один раз.
-
Использовать может только получатель - промокод сработает, только если его использует клиент, которому этот промокод был выдан. Выдать промокод по API можно с помощью метода
/api/v2/promocodes/issue/. -
Срок действия промокодов - при выборе этой настройки появятся варианты срока действия:
- Относительная дата - количество дней, когда будет работать промокод.
- Абсолютная дата - конкретные даты, когда будет работать промокод.
- Относительная дата - количество дней, когда будет работать промокод.

- Есть три способа создать группу промокодов
- Сгенерировать — промокоды генерируются на стороне Sailplay по заданным параметрам, описанным ниже
- Загрузить файл — если клиент создает промокоды на своей стороне, он может загрузить их в SP этой кнопки
- Вставить список — тоже используется в случаях, если клиент генерирует промокоды у себя, но переносит их списком, если, например, они находятся в файле, который не поддерживается загрузчиком.
- Символы — набор символов, который будет использоваться для генерации промокодов:
- Буквы латиницы
- Буквы кириллицы
- Цифры
- Свой набор — используется в случае, если нужны доп.символы, которых нет в первых трех наборах
- Дополнительные настройки промокодов:
- Длина — количество символов в одном промокоде
- Количество — количество промокодов, которые нужно сгенерировать (максимум — 3000000, но при условии, что указанных символов и длины хватит для генерации)
- Префикс — указывается, если нужно, чтобы промокоды начинались с одного набора символов
- Постфикс — указывается, если нужно, чтобы промокоды заканчивались одним набором символов
- Сгенерировать — после выставления всех настроек надо нажать на эту кнопку, чтобы создать группу промокодов
- Сохранить — кнопка, которая сохраняет группу
Поиск промокода

Если искать информацию о конкретном промокоде, то всплывет такое окно
- Поле, куда надо ввести промокод
- Информация о промокоде:
- Многоразовый или одноразовый
- Активный или нет
- У многоразовых промокодов есть указание, сколько раз был выдан промокод и сколько раз использован. У одноразовых промокодов такого поля нет
- Дополнительная информация:
- Группа — группа, в которую входит промокод
- Акция — если группа этого промокода используется в акции, ее название появится в информации о промокоде. Нажав на название можно открыть страницу с этой акцией
- Тип — простой или активационный
Активационные промокоды
Активационные промокоды по своей сути являются обычными промокодами, но имеют дополнительную опцию - активацию. При активации промокода клиенту автоматически присваивается автоматический тег.
Использование промокода в покупке не является активацией промокода, поэтому промокод можно стандартно использовать при оформлении покупки вне зависимости от процесса активации.
🎯 Главное правило: Тег выдается только в момент явной активации промокода (через карточку клиента в CRM или через API /api/v2/promocodes/activate/). Сама по себе отправка кода или его применение в чеке тег не генерируют.

🧪 Сценарии тестирования (Тест-кейсы)
-
Маркетинговые коммуникации
Сценарий: Отправка промокода клиенту в коммуникации (например, в email или СМС-рассылке).
Ожидаемый результат: Промокод успешно отправлен. Автоматический тег клиенту не присваивается. -
Первичная активация промокода
Сценарий: Клиент или менеджер активирует промокод в карточке клиента или через API.
Ожидаемый результат: Промокод успешно активирован, клиенту автоматически присваивается тег. -
Повторная активация многоразового промокода
Сценарий: Повторная активация промокода (свойственно для многоразовых кодов) через карточку клиента или API.
Ожидаемый результат: Промокод активируется еще раз, тег присваивается повторно.