Купоны для персональных предложений

Редактировал(а) Маргарита Журавлева 2026/04/30 14:37

Купоны для персональных предложений

Страница описывает работу персональных предложений, применение которых требует предъявления купона на кассе. Персональные акции.

1. Описание механики

Персональное предложение (ПП) – запись, которая определяет, какое именно значение поощрения будет предоставлено для данного участника по приобретаемому товару в позиции чека. В стандартном сценарии ПП применяется автоматически при идентификации участника на кассе. Механика «Купоны для персональных предложений» расширяет этот сценарий: применение ПП ставится в зависимость от предъявления участником валидного купона.

Это позволяет:

  • разделять каналы коммуникации: предложение отправляется участнику в виде SMS, push-уведомления или печатного купона, а срабатывает только при предъявлении номера купона;
  • контролировать срок действия предложения за счёт срока действия купона;
  • управлять количеством применений ПП через лимит использования купона;
  • исключить применение ПП без фактического намерения участника его использовать.

Если купон невалиден — правило не срабатывает, поощрение не начисляется, купон не гасится. Процессинг чека не прерывается: остальные правила и акции обрабатываются в штатном режиме.

2. Настройка правила персональной акции

2.1. Поля правила персональной акции

Наименование поляТипОбязательностьОписание
Действует для купона(Да / Нет)НеобязательноеПризнак купонного правила. При значении «Да» правило применяется только при предъявлении валидного купона.
Тип купоновСправочник «Типы купонов»Обязательное при «Действует для купона» = ДаТип купонов, который автоматически выпускается при загрузке ПП и предъявляется на кассе.
Генерация купоновСправочник «Генерации купонов»НеобязательноеКонкретная генерация купонов выбранного типа. Если указана — на кассе принимается только купон из этой генерации.

2.2. Логика отображения полей

Поля «Тип купонов» и «Генерация купонов» отображаются на форме только при установленном признаке «Действует для купона». При снятом признаке оба поля скрыты.

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

3. Сценарий настройки

Шаг 1. Настройка типа купонов

В разделе «Купоны → Типы купонов» создаётся или выбирается тип, который будет использоваться для купонных ПП. На уровне типа задаются:

  • период действия типа купона;
  • характеристика типа купона (номерной, неномерной);
  • тип применения купона (дисконтный, бонусный);

Шаг 2. Настройка генерации купонов (опционально)

Если выбран номерной тип купонов, требуется настроить Выпуск купонов (либо Пул номеров, либо Персональные купоны). Создаётся новая генерация выбранного типа. В рамках настроек генерации задается:

  • срок действия купона;
  • максимальное количество использований купона;
  • маска для выпуска, параметр погашаемости;

Купоны выпускаются.

Шаг 3. Настройка правила персональной акции

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

  1. Установить признак «Действует для купона».
  2. В поле «Тип купонов» выбрать тип, настроенный на шаге 1.
  3. При необходимости в поле «Генерация купонов» выбрать генерацию с шага 2.
  4. Сохранить правило.

Шаг 4. Загрузка персональных предложений

Набор ПП загружается в созданное правило стандартным механизмом импорта.

Для каждого ПП создается связь: ПП ↔ купон ↔ участник;

Шаг 5. Применение на кассе

Участник предъявляет номер купона на кассе. POS передаёт номер в составе чека. Manzana Loyalty проверяет купон (см. раздел 4) и при успешной проверке применяет ПП и рассчитывает поощрение.

4. Поведение при процессинге чека

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

ПроверкаУсловие валидности
1Лимит использованияКоличество применений купона не превышает установленный лимит.
2Срок действияДата чека входит в срок действия купона.
3Тип купонаТип предъявленного купона совпадает со значением поля «Тип купонов» в правиле.
4Генерация купонаЕсли в правиле указана «Генерация купонов» — купон должен принадлежать этой генерации. Если поле не заполнено — генерация не проверяется.

Купон считается валидным, если выполнены все применимые условия.

4.2. Настройка Loyalty.Processing.ShowOnlyValidCoupon

Поведение при предъявлении нескольких подходящих купонов регулируется настройкой Loyalty.Processing.ShowOnlyValidCoupon (раздел документации: Процессинг: Купоны).

ЗначениеПоведение
1Валидным признаётся только один купон — с ближайшей датой окончания действия. При равном сроке — с наименьшим внутренним идентификатором.
0Валидными признаются все купоны, прошедшие проверку.

4.3. Поведение при невалидном купоне

Если купон не прошёл хотя бы одну проверку, Manzana Loyalty:

  • не применяет правило и не начисляет поощрение по связанным ПП;
  • не гасит купон (статус и счётчик использования не изменяются);
  • в ответе POS-сервиса в блоке <Coupons> возвращает причину невалидности (истёк срок, исчерпан лимит, неверный тип, неверная генерация);
  • продолжает процессинг чека — остальные правила и акции обрабатываются в штатном режиме.

5. Ограничения

  1. Изменение признака «Действует для купона». Изменение значения у правила, в которое уже загружены ПП, не поддерживается. Для смены модели создаётся новое правило.
  2. Сервис OData. Изменений в составе сущностей OData в рамках данной механики не предусмотрено. Новые поля правила ПА через OData не публикуются.
  3. Зависимость от настроек купона. Срок действия и лимит применения определяются настройками типа и генерации купонов и распространяются на все ПП, выпущенные в их рамках.
  4. Бонусная персональная акция - дисконтный купон. Не допускается регламентация применения бонусной персональной акции - дисконтным купоном и наоборот.

См. также