Публичный ресурс

Загрузка рекламной акции с результатом Печать купона

Эта страница/секция является составной частью статьи Импорт рекламных акций из ERP в SetRetail10.

https://crystals.atlassian.net/browse/SR-5169

https://crystals.atlassian.net/browse/CR-6133

В качестве результата рекламной акции произойдет печать чекового купона (возвратного) в составе чека или в отдельном слипе с штрих-кодом или QR-кодом.

AdvertisingActions/AdvertisingAction/actionResults/coupon

AdvertisingActions/AdvertisingAction/actionResults/coupon

Наименование элемента

Тип данных

Описание

Обязательное

plugin-id

String

Идентификатор плагина в рамках РА

Нет

print-slip-inside-receipt

Boolean

Флаг-признак: печатать слип в составе чека

Нет

force-printing

Boolean

Флаг, определяющий необходимость печати слипа, даже если печать самого чека отключена

https://crystals.atlassian.net/browse/SR-5523

10.3.13.0

Нет

priority

Long

Приоритет печати купона

Нет

discount

Комплексный

Скидка, которая будет предоставляться по предъявлению напечатанного купона

Нет

period

Комплексный

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

Нет

barcode

String

Номер штрихкода чекового (серийного) купона.

Нет

coupon-type-guid

Long

GUID категории уникальных купонов, номер экземпляра которой нужно сгенерировать и распечатать.

Нет

barcode-type

Комплексный

Тип штрих-кода, который нужно распечатать

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

  • BARCODE (по умолчанию)

  • QR

Нет

required-client-card

Boolean

Флаг-признак: для применения купона потребуется применение карты постоянного покупателя.

Нет

only-one-time

Boolean

Флаг-признак: только одноразовое применение купона

Нет

allow-offline

Boolean

Флаг-признак: разрешать расчет без получения данных об ограничениях из внешней системы

Нет

action-restriction

Комплексный

Ограничения по рекламной акции

Нет

client-restriction

Комплексный

Ограничения по клиенту

Нет

text

String

Текст купона.

  • Штрихкод - обязательный атрибут. Печатается в конце %CouponBarcode%

Кроме него возможно использовать следующие подстановки:

  • Название купона %CouponName %

  • Скидка по купону %CouponDiscount %

  • Описание преференций по купону %CouponDescription %

  • Номер дисконтной карты %InternalCard %

  • Общий (суммарный) размер скидки по чеку %TotalDiscount %

  • Размер скидки по РА на чеке %DiscountSum %

  • Дата покупки %PurchaseDate_D_MMMM_YY %

  • Начало действия купона %CouponStartDate_D_MMMM_YY %

  • Конец действия купона %CouponEndDate_DD_MM_YY %

  • Имя покупателя на чеке %Customer alternative: , format: F_M_, width: 20%

    • L_F_M - Фамилия Имя Отчество;

    • F_M - Имя Отчество;

    • F_L - Имя Фамилия;

    • F_ - Имя

    • alternative: - альтернатива для имени. Пример "alternative: Клиент"

    • width - размер текста

Допустимые форматы дат:

  • D_MMMM_YYYY Пример: 10 октября 1997

  • D_MMMM_YY Пример: 10 октября 97

  • DD_MM_YYYY Пример: 10.10.1997

  • DD_MM_YY Пример: 10.10.97

Форматирование текста:

  • ##center## Текст в центре

  • ##right## Текст справа

  • ##left## Текст слева

  • ##double_height## Большой шрифт

  • ##small## Маленький шрифт

  • ##double_width## Жирный шрифт

Да

single-slip-print

Boolean

Если в результате РА выдается несколько купонов, то выводить их одним слипом

10.3.27.0

Нет

rule

Комплексный

Правила формирования купонов (даже нескольких)

10.3.27.0

Нет

Скидка, которая будет предоставляться по предъявлению напечатанного купона

AdvertisingActions/AdvertisingAction/actionResults/coupon/discount

AdvertisingActions/AdvertisingAction/actionResults/coupon/discount

Наименование элемента

Тип данных

Описание

Обязательное

discount-type

Комплексный

Тип скидки - какой тип рассчитанной скидки будет предоставлен при предъявлении напечатанного купона

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

  • CALCULATE - предоставленная скидка по напечатанному купону
    будет рассчитываться от скидки, предоставленной в рамках результата этой акции

  • FIXSUMM - предоставленная скидка по напечатанному купону будет рассчитываться в пределах установленной суммы

  • PERCENT - предоставленная скидка по напечатанному купону будет рассчитываться в процентах

Нет

discount-value

Double

Значение скидки по данному купону

Нет

max-discount

Double

Максимальный размер скидки (что можно получить при применении в будущем чеке покупки) по данному купону

Нет

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

AdvertisingActions/AdvertisingAction/actionResults/coupon/period

AdvertisingActions/AdvertisingAction/actionResults/coupon/period

Наименование элемента

Тип данных

Описание

Обязательное

starts-after-period-type

Комплексный

Определяет единицы времени, в которых указано startsAfter (количество времени, через которое купон
начнет действовать)

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

  • DAYS - Дни

  • HOURS - Часы

  • MINUTES - Минуты

  • MONTHES - Месяцы

  • NOW - Сейчас

  • WEEKS - Недели

  • YEARS - Годы

Нет

starts-after

Integer

Количество времени, через которое купон начнет действовать, в соответствующих единицах времени

Нет

works-period-type

Комплексный

Определяет единицы времени, в которых указано worksPeriod (количество времени, которое купон будет действовать)

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

  • DAYS - Дни

  • HOURS - Часы

  • MINUTES - Минуты

  • MONTHES - Месяцы

  • NOW - Сейчас

  • WEEKS - Недели

  • YEARS - Годы

Нет

works-period

Integer

Количество времени, которое купон будет действовать, в соответствующих единицах времени

Нет

Ограничения по рекламной акции

AdvertisingActions/AdvertisingAction/actionResults/coupon/action-restriction

AdvertisingActions/AdvertisingAction/actionResults/coupon/action-restriction

Наименование атрибута

Тип данных

Описание

Обязательное

max-value

Integer

Указывается общее количество раз печати купона за всю рекламную акцию

Да

Ограничения по клиенту

AdvertisingActions/AdvertisingAction/actionResults/coupon/client-restriction

AdvertisingActions/AdvertisingAction/actionResults/coupon/client-restriction

Наименование атрибута

Тип данных

Описание

Обязательное

max-value

Integer

Максимальное количество печати купона у одного клиента

Да

restriction-period-type

Комплексный

Тип периодичности печати купона

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

  • DAYS - Дни

  • MONTHS - Месяцы

  • WEEKS - Недели

Нет

period

Integer

Значение периодичности печати купона для покупателя

Нет

Пример XML:

<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>

 

© 1994-2024, ООО "Кристалл Сервис Интеграция".
Все права защищены.

Политика обработки персональных данных