Процессинг: Купоны

Редактировал(а) Ксения Худякова 2026/04/30 05:52

Тип настройкиНазвание настройкиОписание настройки
ПартнерскаяLoyalty.Processing.CouponCreateByConvertBonuses.ConfirmWithout.TurnOnВключение функциональности выпуска купонов шеринга без подтверждения. При значениях 1, y или Y доступна функциональность метода выпуска купонов без подтверждения, при прочих значениях, а также при отсутствии настройки – недоступна.
Принимаемые значения для включения – 1, y, Y
ПартнерскаяLoyalty.Processing.CouponApplication.TurnOnПри включенной настройке заполняется таблица применимости купонов: loyalty.coupons_application_cur
Партнерская Loyalty.Processing.CouponCreateByConvertBonuses.Limits.ApplyCouponLimit Максимальное количество подарочных купонов на скидку для применения рефералом за один календарный год. Значение по умолчанию – 10. 
Партнерская Loyalty.Processing.CouponCreateByConvertBonuses.Award.TurnOn Включение функциональности начисления бонусных баллов рефереру в случае, если реферал применил подарочный купон от реферера при оплате своего первого чека. При значениях настройки 1, y или Y – функциональность включена, при прочих значениях, а также при отсутствии настройки – выключена. Значение по умолчанию - 0. 
Партнерская Loyalty.Processing.CouponCreateByConvertBonuses.Award.BonusAmount Количество бонусных баллов, которые начисляются рефереру в случае, если реферал применил подарочный купон от реферера при оплате своего первого чека. Значение по умолчанию – 0. 
Партнерская Loyalty.Processing.CouponCreateByConvertBonuses.Award.BonusCampaign Внешний идентификатор кампании для бонусных баллов, которые начисляются рефереру в случае, если реферал применил подарочный купон от реферера при оплате своего первого чека. 
Партнерская Loyalty.Processing.CouponCreateByConvertBonuses.Award.BonusValidityPeriod Период действия (в днях) бонусных баллов, которые начисляются рефереру в случае, если реферал применил подарочный купон от реферера при оплате своего первого чека. Значение по умолчанию – 365. 
Партнерская Loyalty.Processing.CouponCreateByConvertBonuses.EmailTemplateExternalID Внешний идентификатор шаблона Email сообщения, отправляемого рефереру за использование его подарочного купона рефералом при первой покупке.
Партнерская Loyalty.Processing.CouponApplication.AdditionalInfo.IsVisible Настройка вывод в ответ на запрос дополнительной информации о применимости купонов. Дополнительные теги выводятся при значениях 1, y или Y. При иных значениях, а также при отсутствии настройки – дополнительные теги не выводятся. Значение по умолчанию ПУСТО. 
Партнерская  Loyalty.Processing.CouponApplication.DescriptionKind Настройка, регламентирующая содержание описания купона для ответа о его применимости. При значении 1, описание применимости совпадает с описанием выпуска купонов, при значении 2 – с описанием типа купонов. Значение по умолчанию 1. 
Партнерская  Loyalty.Processing.CouponApplication.TurnOn Включение функциональности заполнения таблицы применения купонов по чекам или заказам loyalty.coupons_application_cur. При значениях 1, y или Y – записи таблицы создаются, при прочих значениях, а также при отсутствии настройки – нет. Значение по умолчанию ПУСТО. 
Партнерская Loyalty.Processing.ShowOnlyValidCoupon

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

Настройка применяется в двух сценариях:

  1. Стандартные правила с купонами — определяет, сколько купонов одного выпуска считаются применёнными по одному правилу.
  2. Правила с персональными предложениями (usePersonalCampaign = 1, usecertificate = 1) — определяет, сколько купонов признаются валидными при валидации персональных предложений.

При значении 1: если к одному правилу в чеке подходят несколько купонов (относящихся к одному выпуску), валидным признаётся только один — с ближайшей датой окончания действия; при одинаковой дате окончания — с наименьшим coupon_id. Только номер данного купона вносится в расширенный атрибут.

При значении 0 (или при отсутствии настройки): все подходящие купоны признаются валидными.

Партнерская CouponsEmission.WriteOff.DecrementRule.ExternalIDНастройка, в которой задается «Внешний идентификатор» правила списания, в рамках которого осуществляется списание баллов за покупку купонов. Если настройка не заполнена или заполнена значением отличным, от Внешнего идентификатора существующего правила списания с типом операции «Выпуск купона», то купон за баллы приобрести невозможно.
ПартнерскаяLoyalty.Interface.BlockingCouponsWhenCardBlocked.TurnOn
 
Включение функциональности блокировки купонов карты и контакта, в случае, когда карта блокируется по ФРОДу через интерфейс системы. Функциональность включена, если значение настройки 1, y или Y. При прочих значениях, а также при отсутствии настройки – функциональность отключена. Значение по умолчанию: ПУСТО (NULL).
Партнерская Loyalty.Processing.Coupon.LimitRowcountКоличество возвращаемых записей типов неномерных купонов. Отдаём М записей.
Допустимые значения целые числа, больше нуля. Значение по умолчанию - 100
Партнерская Loyalty.Processing.DayCouponLimitByContactСогласно данной настройке, по одному контакту в течение календарных суток может быть выпущено не более N извинительных купонов. При этом выпуск может осуществляться несколькими отдельными операциями (разными выпусками), но суммарное количество купонов, созданных методом POST Coupon/Create и
выданных одному клиенту за сутки, не должно превышать установленный лимит N.
Партнерская Loyalty.Processing.IsActiveCampaignFilter.TurnOn При включении данной настройке в ответе метода GET Coupon/GetAllByContactAndStatus исключаются из ответа купоны, правила применения которых связанны с неактивными кампаниями и правилами.
Функциональность включена, если настройка установлена в значение 1, y или Y.  При прочих значениях или при отсутствии настройки – функциональность считается выключенной. Значение по умолчанию - ПУСТО.