Купоны для продажи в ЛК

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

Покупка партнерских купонов за баллы в МП

Система позволяет выпускать купоны с возможностью их обмена на бонусные баллы в личном кабинете участника ПЛ.

1707481988585-348.png

Рис. Справочник купонов для продажи в ЛК

Для этого предназначены купоны для продажи в ЛК.

Для приобретения купона в личном кабинете МП или сайта участник ПЛ может использовать свои статусные бонусы. Например, участник ПЛ совершил 5 покупок и получил 5 звёзд. В его ЛК отображается количество накопленных статусных бонусов (звёзд). В МП ему предоставлен выбор купонов с разными вознаграждениями за звёзды. Участник ПЛ выбирает купон на скидку 15% за 4 звезды, они списываются с его статусного бонусного счёта, а купон после применения гасится.В интерфейсе системы Тип бонуса для покупки купона настраивается в выпуске купона «Для продажи в ЛК» в секции «Дополнительные параметры» в одноименном поле.

Подробнее с примером настройки акции можно ознакомиться здесь.

Количество доступных к покупке купонов может быть ограничено значением максимального количество купонов, которые можно купить по данному выпуску. В запросах методов GET PurchasableCouponEmission/GetAll и POST Coupon/Purchase сравнивается соотношение количества уже выпущенных купонов по выпуску и возможных для выпуска по запросу с значением параметра «Максимальное количество по выпуску» на данном выпуске купонов. По результату сравнения купоны выпускаются, либо выпуск купонов становится невозможным в связи с достижением установленного лимита по максимальному количеству с выводом ошибки: «Выпуск купонов невозможен. Достигнут установленный лимит».

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

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

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

  • Да
  • Нет

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

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

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

  • Не использовать
  • EAN-8
  • EAN-13

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

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

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

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

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

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

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

  • Только цифры
  • Только латиница
  • Только кириллица
  • Латиница и цифры
  • Кириллица и цифры
  • Латиница и кириллица
  • Латиница, кириллица и цифры
ДаПоле доступно для редактирования, заполняется вручную 
Диапазон номеров отЧисловое значение, определяющее начало диапазона номеров.ДаПоле доступно для редактирования, заполняется вручную 
Диапазон номеров доЧисловое значение, определяющее окончание диапазона номеров. Данное значение по длине должно соответствовать длине свободных символов маски. Например, если маска задана как: mm*****, то допустимы такие значения окончания: 10000, 99999 и т.д. Значение 99 в этом случае недопустимо. Чтобы 99 было допустимо как верхняя граница номера, маска должна быть, например, такой: n**n.ДаПоле доступно для редактирования, заполняется вручную 
Параметры времени жизни 
Тип вычисления даты начала действия

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

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

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

Дата начала действия купонов. Начальное значение 1.1.2000.

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

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

Период неактивности купона.

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

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

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

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

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

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

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

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

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

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

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

Дата окончания действия купонов. Начальное значение 01.01.3000.

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

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

Период действия купонов.

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

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

Определяет единицы измерения числа, указанного в поле «Период действия».

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

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

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

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

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

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

1 – Обычный

2 - Статусный

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

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

  • Контакт
  • Карта
  • Не именные

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

Значение по умолчанию - Контакт

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

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

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

  • Нет
  • Да

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

НетПоле доступно для редактирования, активируется вручную 
Маленькая картинка. ИдентификаторПараметр передается в ответе на запросы МП и ЛК и используется для отображения картинкиНетПоле доступно для редактирования, заполняется вручную 
Большая картинка. ИдентификаторПараметр передается в ответе на запросы МП и ЛК и используется для отображения картинки.НетПоле доступно для редактирования, заполняется вручную 
Маленькая картинка. СсылкаСсылка на внешний источник маленькой картинки, которая будет отображаться в ЛК клиентаНетПоле доступно для редактирования, заполняется вручную 
Большая картинка. СсылкаСсылка на внешний источник большой картинки, которая будет отображаться в ЛК клиентаНетПоле доступно для редактирования, заполняется вручную 
URLСсылка на выпуск купона для отображения в личном кабинете.НетПоле доступно для редактирования, заполняется вручную 
Для магазинов

Назначение купонов. Возможные значения:

  • Оффлайн
  • Интернет-магазин

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

НетПоле доступно для редактирования, заполняется вручную 
ПартнерСсылка на партнёра. Купоны будут принадлежать данному партнёру.НетПоле доступно для редактирования, заполняется вручную 
Тип отображения штрих-кода

Тип отображения штрих-кода. Возможные значения:

  • Нет
  • EAN-13
  • Code-128
  • QR

Используется для информационных целей. Отображение штрих-кода должно производиться во внешней системе.

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

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

1763046312085-435.png1763046332852-679.png

Рис. Карточка купона «Для продажи в ЛК»

Покупка партнерских купонов за баллы в МП

Некоторые компании предлагают в своем мобильном приложении купоны партнеров, которые можно приобрести за бонусы.

Процесс обмена баллов на купон партнера в МП осуществляется так:

  • Клиент заходит в приложение, в личном кабинете отображается актуальный баланс бонусов.
  • Переходит в раздел обмена бонусов и выбирает партнера (из представленных брендов магазинов).
  • После выбора партнера ему отображаются доступные купоны от партнера и условия покупки купона за бонусы.
  • Клиент выбирает необходимое количество купонов.
  • При достаточном количестве бонусов они списываются со счета и выпускается купон.
  • При недостаточном количестве бонусов, пользователь оповещается об этом специальным уведомлением.
  • Купон отображается клиенту в приложении (и отправляется на e-mail, если он указан в ЛК).

Для идентификации партнерского купона в чеке, пул купонов с количеством свыше 10 тыс. загружается в базу системы и при выполнении метода POST Coupon/Purchase купон партнера выпускается участнику ПЛ в МП. Для того, чтобы клиенту передавался именно партнерский купон, а не создавался новый купон, в настройках выпуска «Для продажи в ЛК» используется параметр «Действие с купоном» со значением «Выбор из пула».  При выборе значения «Создавать по запросу», купон создается «на лету».

1760348491638-881.png

Небольшой пул купонов можно загружать стандартным импортом купонов.

1760348491641-533.png

После выбора купона/купонов партнера клиенту отображается доступное количество купонов к покупке. Остаток купонов из определенного выпуска можно отслеживать с помощью метода  GET PurchasableCouponEmission/Get при включенной настройке PrivateOffice.PurchasableCouponEmission.CouponsQuantity.

При покупке купона в МП клиенту выпускается купон из пула методом POST Coupon/Purchase, при этом с активного бонусного баланса списывается сумма баллов, обозначенная в условиях покупки купона.  Купон привязывается к контакту, становится именным и доступным для применения.

Приобретенный купон отображается в разделе с купонами в ЛК пользователя. Если в профиле клиента указан его email, то отправляется письмо с информацией о купоне на почту после приобретения. Для этого в методе POST Coupon/Purchase передается заполненный параметр с электронной почтой клиента  -  «E-mail».

При успешном выполнении запроса, на указанную почту  отправляются купоны по заданному шаблону при включенной настройке PrivateOffice.CouponPurchase.SendingEmail.MessageTemplate. В тексте шаблона вместо метапеременной %coupon_number% подставляются номера купонов, которые были выпущены для контакта при обработке этого метода (если было куплено несколько купонов за один раз, то вместо метапеременной подставляются номера купонов через запятую без пробелов).

При применении купона, в мягком чеке и запросе создания заказа, проверяется, к какому типу выпуска купона он относится. Если к выпуску "Для продажи в ЛК", то купон не может быть применен, если не связан с картой/контактом. Проверка обеспечивается включенной партнерской настройкой Loyalty.CouponEmission.СouponСheck.