...
В качестве результата рекламной акции произойдет печать чекового купона (возвратного) в составе чека или в отдельном слипе с штрих-кодом или QR-кодом.
AdvertisingActions/AdvertisingAction/actionResults/coupon |
---|
Наименование элемента | Тип данных | Описание | Обязательное | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
plugin-id | String | Идентификатор плагина в рамках РА | Нет | ||||||||||||||||||||||||||
print-slip-inside-receipt | Boolean | Флаг-признак: печатать слип в составе чека | Нет | ||||||||||||||||||||||||||
force-printing | Boolean | Флаг, определяющий необходимость печати слипа, даже если печать самого чека отключена
| Нет | ||||||||||||||||||||||||||
priority | Long | Приоритет печати купона | Нет | ||||||||||||||||||||||||||
discount | Комплексный | Скидка, которая будет предоставляться по предъявлению напечатанного купона | Нет | ||||||||||||||||||||||||||
period | Комплексный | Период действия купона | Нет | ||||||||||||||||||||||||||
barcode | String | Номер штрихкода чекового (серийного) купона. | Нет | ||||||||||||||||||||||||||
coupon-type-guid | Long | GUID категории уникальных купонов, номер экземпляра которой нужно сгенерировать и распечатать. | Нет | ||||||||||||||||||||||||||
barcode-type | Комплексный | Тип штрих-кода, который нужно распечатать Возможные значения:
| Нет | ||||||||||||||||||||||||||
required-client-card | Boolean | Флаг-признак: для применения купона потребуется применение карты постоянного покупателя. | Нет | ||||||||||||||||||||||||||
only-one-time | Boolean | Флаг-признак: только одноразовое применение купона | Нет | ||||||||||||||||||||||||||
allow-offline | Boolean | Флаг-признак: разрешать расчет без получения данных об ограничениях из внешней системы | Нет | ||||||||||||||||||||||||||
action-restriction | Комплексный | Ограничения по рекламной акции | Нет | ||||||||||||||||||||||||||
client-restriction | Комплексный | Ограничения по клиенту | Нет | ||||||||||||||||||||||||||
text | String | Текст купона.
Кроме него возможно использовать следующие подстановки:
Допустимые форматы дат:
Форматирование текста:
| Да | ||||||||||||||||||||||||||
single-slip-print | Boolean | Если в результате РА выдается несколько купонов, то выводить их одним слипом
| Нет | ||||||||||||||||||||||||||
rule | Комплексный | Правила формирования купонов (даже нескольких)
| Нет |
Скидка, которая будет предоставляться по предъявлению напечатанного купона
AdvertisingActions/AdvertisingAction/actionResults/coupon/discount | |||
---|---|---|---|
Наименование элемента | Тип данных | Описание | Обязательное |
discount-type | Комплексный | Тип скидки - какой тип рассчитанной скидки будет предоставлен при предъявлении напечатанного купона Возможные значения:
| Нет |
discount-value | Double | Значение скидки по данному купону | Нет |
max-discount | Double | Максимальный размер скидки (что можно получить при применении в будущем чеке покупки) по данному купону | Нет |
Период действия купона
AdvertisingActions/AdvertisingAction/actionResults/coupon/period | |||
---|---|---|---|
Наименование элемента | Тип данных | Описание | Обязательное |
starts-after-period-type | Комплексный | Определяет единицы времени, в которых указано startsAfter (количество времени, через которое купон Возможные значения:
| Нет |
starts-after | Integer | Количество времени, через которое купон начнет действовать, в соответствующих единицах времени | Нет |
works-period-type | Комплексный | Определяет единицы времени, в которых указано worksPeriod (количество времени, которое купон будет действовать) Возможные значения:
| Нет |
works-period | Integer | Количество времени, которое купон будет действовать, в соответствующих единицах времени | Нет |
Ограничения по рекламной акции
AdvertisingActions/AdvertisingAction/actionResults/coupon/action-restriction | |||
---|---|---|---|
Наименование атрибута | Тип данных | Описание | Обязательное |
max-value | Integer | Указывается общее количество раз печати купона за всю рекламную акцию | Да |
Ограничения по клиенту
AdvertisingActions/AdvertisingAction/actionResults/coupon/client-restriction | |||
---|---|---|---|
Наименование атрибута | Тип данных | Описание | Обязательное |
max-value | Integer | Максимальное количество печати купона у одного клиента | Да |
restriction-period-type | Комплексный | Тип периодичности печати купона Возможные значения:
| Нет |
period | Integer | Значение периодичности печати купона для покупателя | Нет |
Пример XML:
Code Block | ||
---|---|---|
| ||
<AdvertisingActions> <AdvertisingAction name="Акция с результатом печать купона" active="true" mode="unconditional" priority="50.0" ignoreRestrictions="false" worksAnyTime="true" color="red" external-code="Акция с результатом печать купона"> <begin-date>2021-10-16T18:00:00</begin-date> <end-date>2022-12-01T18:00:00</end-date> <actionResults> <coupon> <force-printing>true</force-printing> <print-slip-inside-receipt>true</print-slip-inside-receipt> <priority>1</priority> <discount> <discount-type>PERCENT</discount-type> <discount-value>10.0</discount-value> <max-discount>1000.0</max-discount> </discount> <period> <starts-after-period-type>DAYS</starts-after-period-type> <starts-after>1</starts-after> <works-period-type>MONTHES</works-period-type> <works-period>1</works-period> </period> <required-client-card>true</required-client-card> <only-one-time>true</only-one-time> <allow-offline>false</allow-offline> <action-restriction max-value="1"/> <client-restriction max-value="1"/> <text> Название купона %CouponName % Скидка по купону %CouponDiscount % Описание преференций по купону %CouponDescription % Номер дисконтной карты %InternalCard % Общий (суммарный) размер скидки по чеку %TotalDiscount % Размер скидки по РА на чеке %DiscountSum % Дата покупки %PurchaseDate_D_MMMM_YY % Начало действия купона %CouponStartDate_D_MMMM_YY % Конец действия купона %CouponEndDate_DD_MM_YY % где формат D_MMMM_YYYY Пример 10 октября 1997 D_MMMM_YY Пример 10 октября 97 DD_MM_YYYY Пример 10.10.1997 DD_MM_YY Пример 10.10.97 Имя покупателя на чеке %Customer alternative: , format: F_M_, width: 20% L_F_M - Фамилия Имя Отчество; F_M - Имя Отчество; F_L - Имя Фамилия; F_ - Имя alternative: альтернатива для имени. Пример "alternative: Клиент", width размер текста ##center## ##double_height##Текст в центре + большой шрифт ##right## ##small## Текст справа + маленький шрифт ##left## ##double_width## Текст слева + жирный шрифт ШК - обязательный атрибут. Печатается в конце %CouponBarcode% </text> </coupon> </actionResults> </AdvertisingAction> </AdvertisingActions> |
...