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

Рис. Справочник купонов для продажи в ЛК
Для этого предназначены купоны для продажи в ЛК.
Для приобретения купона в личном кабинете МП или сайта участник ПЛ может использовать свои статусные бонусы. Например, участник ПЛ совершил 5 покупок и получил 5 звёзд. В его ЛК отображается количество накопленных статусных бонусов (звёзд). В МП ему предоставлен выбор купонов с разными вознаграждениями за звёзды. Участник ПЛ выбирает купон на скидку 15% за 4 звезды, они списываются с его статусного бонусного счёта, а купон после применения гасится.В интерфейсе системы Тип бонуса для покупки купона настраивается в выпуске купона «Для продажи в ЛК» в секции «Дополнительные параметры» в одноименном поле.
Подробнее с примером настройки акции можно ознакомиться здесь.
Количество доступных к покупке купонов может быть ограничено значением максимального количество купонов, которые можно купить по данному выпуску. В запросах методов GET PurchasableCouponEmission/GetAll и POST Coupon/Purchase сравнивается соотношение количества уже выпущенных купонов по выпуску и возможных для выпуска по запросу с значением параметра «Максимальное количество по выпуску» на данном выпуске купонов. По результату сравнения купоны выпускаются, либо выпуск купонов становится невозможным в связи с достижением установленного лимита по максимальному количеству с выводом ошибки: «Выпуск купонов невозможен. Достигнут установленный лимит».
Карточка выпуска купонов «Для продажи в ЛК» содержит следующую информацию:
| Поле | Описание | Обязательное поле | Редактирование | |
| Активно | Значение, определяющее действительность задания на выпуск купонов. Возможные значения:
Значение по умолчанию: Нет. | Да | Поле доступно для редактирования, заполняется вручную | |
| Ответственный | Пользователь, ответственный за создание и ведение данной записи. | Да | Поле доступно для редактирования. Заполняется из справочника пользователей. | |
| Подразделение | Подразделение, к которому относится данная запись. | Да | Поле доступно для редактирования. Заполняется из справочника подразделений. | |
| Общие сведения | ||||
| Наименование | Наименование задания на выпуск купонов. | Да | Поле доступно для редактирования, заполняется вручную | |
| Внешний идентификатор | Код интеграции с внешними системами. | Да | Поле доступно для редактирования, заполняется вручную | |
| Тип купонов | Ссылка на тип купонов, по которому будут регистрироваться персональные купоны. | Да | Поле доступно для редактирования, заполняется вручную | |
| Кампания | Ссылка на акцию программы лояльности, в рамках которой создается выпуск купонов. | Да | Поле доступно для редактирования, заполняется вручную | |
| Описание | Подробное описание выпуска персональных купонов. | Нет | Поле доступно для редактирования, заполняется вручную | |
| Основные параметры | ||||
| Маска | Поле, значение которого задаёт номерную серию. В маске возможными символами могут быть латинские буквы и цифры. Свободные символы задаются звёздочками. Последовательность свободных символов должна быть непрерывна. | Да | Поле доступно для редактирования, заполняется вручную | |
| Тип штрих-кода | Формат номера, которому будут принадлежать выпускаемые по данному шаблону купоны. Возможные значения:
Значение по умолчанию: Не использовать. | Нет | Поле доступно для редактирования, заполняется вручную | |
| Тип распределения номеров | Параметр, задающий каким образом будут присваиваться номера. Возможные значения:
Значение по умолчанию: Последовательное. | Да | Поле доступно для редактирования, заполняется вручную | |
| Способ генерации | Способ генерации, который будет применён для данного выпуска купонов. Возможные значения:
| Да | Поле доступно для редактирования, заполняется вручную | |
| Диапазон номеров от | Числовое значение, определяющее начало диапазона номеров. | Да | Поле доступно для редактирования, заполняется вручную | |
| Диапазон номеров до | Числовое значение, определяющее окончание диапазона номеров. Данное значение по длине должно соответствовать длине свободных символов маски. Например, если маска задана как: mm*****, то допустимы такие значения окончания: 10000, 99999 и т.д. Значение 99 в этом случае недопустимо. Чтобы 99 было допустимо как верхняя граница номера, маска должна быть, например, такой: n**n. | Да | Поле доступно для редактирования, заполняется вручную | |
| Параметры времени жизни | ||||
| Тип вычисления даты начала действия | Тип вычисления даты начала действия купона. Возможные значения:
| Да | Поле доступно для редактирования, заполняется вручную | |
| Дата начала действия | Поле отображается, если параметр «Тип вычисления даты начала действия» = Фиксированная дата Дата начала действия купонов. Начальное значение 1.1.2000. | Нет | Поле доступно для редактирования, заполняется вручную | |
| Период неактивности | Поле отображается, если параметр «Тип вычисления даты начала действия» = Дата начисления + период неактивности. Период неактивности купона. | Нет | Поле доступно для редактирования, заполняется вручную | |
| Тип периода неактивности | Поле отображается, если параметр «Тип вычисления даты начала действия» = Дата начисления + период неактивности. Определяет единицы измерения числа, указанного в поле «Период неактивности». Возможные значения:
| Нет | Поле доступно для редактирования, заполняется вручную | |
| Округление даты начала | Поле отображается, если параметр «Тип вычисления даты начала действия» = Дата начисления + период неактивности. Округление даты начала действия купонов. В этом случае, если установить значение поля = Да, то купоны станут активными не в момент, когда они были сформированы + период неактивности, а с округлением даты согласно установленному типу периода неактивности. Например, в случае типа периода неактивности = День, то со следующего дня после полученной даты (дата начисления + период неактивности) с 00:00. | Нет | Поле доступно для редактирования, заполняется вручную | |
| Тип вычисления даты окончания действия | Тип вычисления даты окончания действия купонов. Возможные значения:
| Да | Поле доступно для редактирования, заполняется вручную | |
| Дата окончания действия | Поле отображается, если параметр «Тип вычисления даты окончания действия» = Фиксированная дата. Дата окончания действия купонов. Начальное значение 01.01.3000. | Нет | Поле доступно для редактирования, заполняется вручную | |
| Период действия | Поле отображается, если параметр «Тип вычисления даты окончания действия» = Дата начала + период действия. Период действия купонов. | Нет | Поле доступно для редактирования, заполняется вручную | |
| Тип периода действия | Поле отображается, если параметр «Тип вычисления даты окончания действия» = Дата начала + период действия. Определяет единицы измерения числа, указанного в поле «Период действия». Возможные значения:
| Нет | Поле доступно для редактирования, заполняется вручную | |
| Округление даты окончания | Поле отображается если параметр «Тип вычисления даты окончания действия» = Дата начала + период действия. Округление даты окончания действия купонов. В этом случае, если установить значение поля = Да, то купоны перестанут быть активными не в момент, когда они начали действовать + период действия, а с округлением даты согласно установленному типу периода действия. Например, в случае типа периода действия = День, то на следующий день после полученной даты (дата начала + период действия) в 00:00. | Нет | Поле доступно для редактирования, заполняется вручную | |
| Дополнительные параметры | ||||
| Списать баллов | Поле, отображающее, какое количество баллов будет списано при выпуске данного купона | Да | Поле доступно для редактирования, заполняется вручную | |
| Тип бонуса | Значение, которое определяет, какие именно баллы будут списываться данным правилом. Возможные значения: 1 – Обычный 2 - Статусный | Нет | Поле доступно для редактирования, активируется вручную | |
| Купоны для | Объект, к которому будет привязан выпущенный купон. Возможные значения:
При использовании значения «Пусто» выпущенный купон не будет привязан к какому-либо контакту или карте. Значение по умолчанию - Контакт | Да | Поле доступно для редактирования, заполняется вручную | |
| Не использовать в кабинете Участника | Параметр, определяющий участие пользователя в выпуске купона. Возможные значения:
Параметр в значение «Да» позволяет, например, выпускать купоны в качестве извинения за отмену или возврат заказа по определенным причинам без участия пользователя. | Нет | Поле доступно для редактирования, активируется вручную | |
| Маленькая картинка. Идентификатор | Параметр передается в ответе на запросы МП и ЛК и используется для отображения картинки | Нет | Поле доступно для редактирования, заполняется вручную | |
| Большая картинка. Идентификатор | Параметр передается в ответе на запросы МП и ЛК и используется для отображения картинки. | Нет | Поле доступно для редактирования, заполняется вручную | |
| Маленькая картинка. Ссылка | Ссылка на внешний источник маленькой картинки, которая будет отображаться в ЛК клиента | Нет | Поле доступно для редактирования, заполняется вручную | |
| Большая картинка. Ссылка | Ссылка на внешний источник большой картинки, которая будет отображаться в ЛК клиента | Нет | Поле доступно для редактирования, заполняется вручную | |
| URL | Ссылка на выпуск купона для отображения в личном кабинете. | Нет | Поле доступно для редактирования, заполняется вручную | |
| Для магазинов | Назначение купонов. Возможные значения:
Используется для информационных целей. Выводится для личного кабинета. | Нет | Поле доступно для редактирования, заполняется вручную | |
| Партнер | Ссылка на партнёра. Купоны будут принадлежать данному партнёру. | Нет | Поле доступно для редактирования, заполняется вручную | |
| Тип отображения штрих-кода | Тип отображения штрих-кода. Возможные значения:
Используется для информационных целей. Отображение штрих-кода должно производиться во внешней системе. Значение по умолчанию - Нет | Нет | Поле доступно для редактирования, заполняется вручную | |
| Контрагент | Ссылка на магазин. Купоны будут привязаны к данному магазину. | Нет | Поле доступно для редактирования, заполняется вручную | |
| Название купона | Название купона, которое будет отображаться в ЛК клиента | Нет | Поле доступно для редактирования, заполняется вручную | |
| Описание механики | Описание условий использования купона | Нет | Поле доступно для редактирования, заполняется вручную | |
| Тип выгоды | Информационный настраиваемый параметр, определяющий характер поощрения: например, скидка, бонус, купон, кешбек или фиксированная цена. Можно создать из настройки купона | Нет | Поле доступно для редактирования, заполняется вручную | |
| Значение выгоды | Информационный параметр. Размер скидки, бонуса, кешбека или фиксированная стоимость по купону | Нет | Поле доступно для редактирования, заполняется вручную | |
| Категория | Определяет отношение купона к типу акции у конкретного партнера. Можно выбрать из выпадающего списка категорий или создать категорию из настройки купона | Нет | Поле доступно для редактирования, заполняется вручную | |
| Группа купона | Информационный параметр. Любая характеристика купона – по товарам, по типу поощрения (на усмотрение маркетолога). | Нет | Поле доступно для редактирования, заполняется вручную | |
| Подгруппа купона | Информационный параметр. Любая характеристика купона – по товарам, по типу поощрения (на усмотрение маркетолога). | Нет | Поле доступно для редактирования, заполняется вручную | |
| Новая цена | Новая цена товара после применения купона | Нет | Поле доступно для редактирования, заполняется вручную | |
| Старая цена | Первоначальная цена товара до применения купона | Нет | Поле доступно для редактирования, заполняется вручную | |
| Максимальное количество использований | Сколько раз можно использовать купон для получения поощрения | Нет | Поле доступно для редактирования, заполняется вручную | |
| Не погашаемый | Указывает, можно ли использовать купон без ограничений. По умолчанию поле не активировано. | Нет | Значение доступно для редактирования, активируется вручную. | |
| Максимальное количество по выпуску | Количество купонов, которые можно купить по данному выпуску | Нет | Поле доступно для редактирования, заполняется вручную | |
| Номинал купона для вывода в сообщениях Campaign | Размер поощрения по купону. Поле информационное, для формирования метапеременных в сообщениях из Campaign. | Нет | Поле доступно для редактирования, заполняется вручную | |
| Минимальная сумма для применения купона | Минимальная сумма чека, на которую купон может примениться. Поле информационное, для формирования метапеременных в сообщениях из Campaign. | Нет | Поле доступно для редактирования, заполняется вручную | |
| Купоны | ||||
| Купоны | Представление, в котором отображаются купоны, созданные данным выпуском моментальных купонов. | |||


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

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

После выбора купона/купонов партнера клиенту отображается доступное количество купонов к покупке. Остаток купонов из определенного выпуска можно отслеживать с помощью метода 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.