advertActGUID

Integer

Не требуется заполнение поля из ERP

name

String

Наименование РА

priority

Double

Приоритет (только для схемы работы акций по приоритету, акция с приоритетом 1 более приоритетная, чем акция с приоритетом 1000). По умолчанию 1000.

При загрузке значение должно быть равным 1 и более.

Boolean

Признак игнорирования ограничений на применение скидки в данных товаров

• true – акция игнорирует ограничения
• false – акция учитывает ограничения

Признак игнорирования ограничений на применение скидки в данных товаров

• true – акция игнорирует ограничения
• false – акция учитывает ограничения

Начиная с версии     можно использовать, как новый параметр, так и предыдущий ignoreRestictions

color

String

ti

String

Идентификатор транспортного пакета, в котором пришла данная РА

Флаг-признак, указывающий на то, что на товары, на которые сработала данная РА, нельзя давать скидки типа "бонусы как скидка".

Отсутствие атрибута - распознается как FALSE

Флаг-признак "Игнорировать ограничения мягкого чека".

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

shop-indices

PositiveInteger

(разделение через пробел)

Список магазинов через пробел, в которых действует акция. По умолчанию – действует во всей торговой сети.

pricetag-type

 String

Тип ценника, который должен печататься на товары этой акции.
NONE — на акцию не надо печатать никакие ценники
ACTION — акционный ценник
ADDITIONAL — дополнительный ценник
REPLACEMENT — замещающий ценник

dependence

Блок позволяет управлять из ERP зависимостью загружаемых РА от других акций, ранее загруженных в систему. Необязательный блок данных

externalConditions

Условия применения данной РА, акция сработает только при соблюдении всех указанных в акции условий. Если условия не указаны, акция действует для всех покупателей. Необязательный блок данных, заполняется только при mode = automatic 

actionResults

Применяемые скидки в рамках данной Рекламной акции. Обязательный блок данных

pricetag-template

Коды ценников, которые должны печататься по умолчанию на товары этой акции.

value

Double

Стоимость набора целиком

wholesale-restriction

Integer

Установленное оптовое ограничение (количество наборов со скидкой за сутки для одного покупателя)

maxQuantity

Integer

Максимальное количество наборов в чеке со скидкой

calcWeightProductCountAsOne

Boolean

Принцип учета количества весовых позиций в наборе

• false – количество весового товара = равно его суммарному весу
• true – количество весового товара = равно количеству позиций вне зависимости от их веса
  По умолчанию false

isSpreadDiscounts

Boolean

Говорит о том, что скидки на подарочные позиции будут размазаны по всему набору равномерно с учетом цен компонентов

maxQuantity

Double

определяет максимальное кол-во товара в чеке, которое будет продано по акции. По умолчанию любое кол-во.

discountStart

Double

определяет количество товара, начиная с которого на этот товар будет начисляться скидка. По умолчанию с первого же товара

conditionCount

Double

определяет количество товара, при покупке которого на все количество этого товара будет дана скидка. По умолчанию при любом количестве.

wholesale-restriction

Double

Установленное оптовое ограничение (количество товара со скидкой за сутки для одного покупателя)

id

String

Код товара

maxQuantity

Double

Определяет максимальное кол-во товара в чеке, которое будет продано по акции. По умолчанию любое кол-во.

discountStart

Double

Определяет количество товара, начиная с которого на этот товар будет начисляться скидка. По умолчанию с первого же товара

conditionCount

Double

Определяет количество товара, при покупке которого на все количество этого товара будет дана скидка. По умолчанию при любом количестве.

fixedPrice

Double

Фиксированная акционная цена товара.

Wholesale-restriction

Double

Установленное оптовое ограничение (количество товара со скидкой за сутки для одного покупателя)

name

String

Название скидки

calcWeightProductCountAsOne

Boolean

Принцип учета количества весовых позиций в скидках с количественными ограничениями

• false – количество весового товара = равно его суммарному весу
• true – количество весового товара = равно количеству позиций вне зависимости от их веса По умолчанию false|

maxQuantity

Double

Определяет максимальное кол-во товара в чеке, которое будет продано по акции.

discountSum

Double

Сумма скидки на товар

goodsSum

discountStart

Double

Определяет позицию, начиная с которой на этот товар будет начисляться скидка

Предоставлять скидку только для подарков

Предоставлять скидку только для товаров из мягкого чека.

apply-count-for-each-row

Пример XML

Фильтр, определяющий множество товаров, на которые данная скидка НЕ должна сработать.

Данный фильтр имеет приоритет перед группой фильтров "goods-filterGroup" и флагом "for-all-goods": если товар удовлетворяет фильтру "exclude", то скидка на него не будет дана - не зависимо от значения флага "for-all-goods", либо значений фильтров группы "goods-filterGroup"

Ограничение по сумме скидки РА по клиенту

Условие "до истечения срока годности"

for-all-goods

Артикулы (коды товаров), на которые будут установлены скидки

manufacturer

Код производителя

department

Номер отдела

country

Код страны (по ISO 3166-1 alpha-3)

product-type

Тип товара

composite

Составной объект

Данный фильтр имеет приоритет перед группой фильтров "goods-filterGroup" и флагом "for-all-goods": если товар удовлетворяет фильтру "exclude", то в выборку он не попадает - не зависимо от значения флага "for-all-goods", либо значений фильтров группы "goods-filterGroup"

Фильтр, определяющий множество товаров, на которые данная скидка НЕ должна сработать.

Данный фильтр имеет приоритет перед группой фильтров "goods-filterGroup" и флагом "for-all-goods": если товар удовлетворяет фильтру "exclude", то скидка на него не будет дана - не зависимо от значения флаг "for-all-goods", либо значений фильтров группы "goods-filterGroup

marking-of-the-good

goodsGroup

group

Код страны (по ISO 3166-1 alpha-3)

Тип товара

exclude

Артикулы (коды товаров), на которые будут установлены скидки

Задает множество товаров, на которые воздействует РА, по списку артикулов этих товаров

• id / String / Код/артикул товара / *Обязательное;

• maxQuality / Double / Максимальное количество товара, на которое может сработать РА. Если отсутствует - без ограничений;

• fixedPrice / Double / Фиксированная цена за единицу товара (при условии срабатывания РА);

• discountStart / Double / Определяет позицию, начиная с которой на этот товар будет начисляться скидка;

• conditionCount / Double / Определяет количество (или вес) товара, при покупке которого на все количество этого товара будет дана скидка;

• wholesale-restriction / Double / Оптовое ограничение. Максимальное количество этого товара, что можно купить одному клиенту по этой акции в течение суток. 1.0 = 1 штука (или 1 кг), 0.1 = 100 грамм.

Определяет "плоский" список товаров внутри акции

Определяет список товаров внутри акции на которые воздействует РА

• goodsGroup / Комплексный / Cписок товаров

  • name

    • marking-of-the-good / Комплексный / Товар

      • id / String / Код (артикул) товара / *Обязательное;

      • maxQuality / Double / Максимальное количество товара, на которое может сработать РА. Если отсутствует - без ограничений;

      • fixedPrice / Double / Фиксированная цена за единицу товара (при условии срабатывания РА);

      • discountStart / Double / Определяет позицию, начиная с которой на этот товар будет начисляться скидка;

      • conditionCount / Double / Определяет количество (или вес) товара, при покупке которого на все количество этого товара будет дана скидка;

      • wholesale-restriction / Double / Оптовое ограничение. Максимальное количество этого товара, что можно купить одному клиенту по этой акции в течение суток. 1.0 = 1 штука (или 1 кг), 0.1 = 100 грамм.

Идентификатор товарной группы

Список идентификаторов (кодов) групп продаж, товары из которых удовлетворяют данному фильтру

Номер отдела

Номер отдела

Код страны (по ISO 3166-1 alpha-3)

Тип товара

Составной объект

Данный фильтр имеет приоритет перед группой фильтров "goods-filterGroup" и флагом "for-all-goods": если товар удовлетворяет фильтру "exclude", то в выборку он не попадает - не зависимо от значения флага "for-all-goods", либо значений фильтров группы "goods-filterGroup"

Дополнительное значение для плагинов скидок:

Только для принципа вычисления = PAYMENT_TYPE_PERCENT и содержит название типа оплаты, от размера которого и считать скидку.

Например, если значение этого атрибута BankCardPaymentEntity, и при покупке использовали 50 рублей оплаты по банковской карте и еще 800 - другие типы оплат, то скидка будет считаться только от 50 рублей)

Типы оплат:

• CashPaymentEntity - оплата наличными
• CashMachinePaymentEntity - Оплата наличными (купюроприемник)
• BankCardPaymentEntity - Оплата по банковской карте
• BonusCardPaymentEntity - Оплата по бонусной карте
• GiftCardPaymentEntity - Оплата по подарочной карте
• ExternalBankTerminalPaymentEntity - Внешний банковский терминал
• ConsumerCreditPaymentEntity - Потребительский кредит
• CFTGiftCardPaymentEntity - Оплата по подарочной карте ЦФТ
• SiebelBonusCardPaymentEntity - Оплата по бонусной карте Siebel
• ChildrenCardPaymentEntity - Оплата по Детской карте
• CFTEGCPaymentEntity - Оплата по ЭПС ЦФТ
• SupraPaymentEntity - Оплата по карте Супра
• PrepaymentEntity - Зачет предоплаты
• SiebelBonusesForGiftPaymentEntity - Бонусы на подарок
• SiebelGiftCardPaymentEntity - Оплата по подарочной карте Siebel
• KopilkaPaymentEntity - Оплата по бонусной карте Копилка

Ещё используется для хранения значения флага "Учитывать оптовое ограничение":  также применяется только если принцип вычисления = EXTERNAL_LOYALTY и
содержит имя внешнего процессинга лояльности, определяющего результат рекламной акции. Соответствующая рекламная акция создается, чтобы включить работу процессинга.

Список процессингов /standalone/configuration/modules/external-systems-manager/service-providers.xml

Правила списания за фишки на товар

Число, количественно характеризующее размер начисляемых бонусов. Смысл этого числа зависит от принципа начисления.

• для "AMOUNTPERCENT" это количество сотых долей процента от суммы чека. т.е. 1000 = 10%;
• для "MULTIPLEPERCENT" - аналогично: это количество сотых долей процента от суммы чека. т.е. 1000 = 10%;
• для "FIXBONUS" это конкретное количество "бонусо-копеек", что надо начислить;
• для остальных принципов начисления данное поле не имеет смысла.

Префикс BIN (Bank Identification Number) - номера банковской карты, по которой была проведена оплата, на основании которой надо начислить бонусы.

Используется только при принципе начисления бонусов "BANKPERCENT"

beginDate

Дата начала действия бонусов

• Атрибут beginDate является обязательным, при наличии атрибута endDate

При отсутствии атрибутов beginDate и endDate интервал дат действия бонусов будет определен как "Действует всегда".

Пример загрузки акции.

endDate

Дата окончания действия бонусов

• Атрибут endDate является обязательным, при наличии атрибута beginDate

При отсутствии атрибутов beginDate и endDate интервал дат действия бонусов будет определен как "Действует всегда".

Пример загрузки акции.

Принцип учета количества весовых позиций в наборе

• false – количество весового товара = равно его суммарному весу

• true – количество весового товара = равно количеству позиций вне зависимости от их веса
  По умолчанию false

Правила начисления бонусов в зависимости от размера оплаты по банковской карте или количества уже начисленных бонусов

Правило начисления фишек

Процент от суммы оплаты по банковской карте, что надо вернуть покупателю в виде начисления бонусов

По умолчанию = 0

Абсолютное количество бонусов (в бонусо-копейках), которое необходимо начислить по этому правилу

Пример загрузки акции

Начальная граница интервала включительно.

NULL распознается как "минус бесконечность"

Конечная граница интервала исключительно (интервал справа - открыт).

NULL распознается как "плюс бесконечность"

Тип значения, на которое смотрим в чеке:

• SUM - сумма товаров
• COUNT - количество товаров

Название списка товаров

Название списка товаров

Количество "бонусо-копеек" к начислению. Используется при типе начисления PRODUCTFIXBONUS.

Пример загрузки акции

limit

online-notification

slip-content

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

calculator

"Вычислитель" количества "преференций" (наклеек), что получит покупатель.
Все "вычислители" определяют количество "преференций" по одному и тому же правилу:

result = sum / divider * multiplier

• sum - сумма (зависит от конкретной реализации "вычислителя": например, общая сумма чека, либо количество товаров из определенной группы продаж)
• divider - делимое. Деление целочисленное!
• multiplier - множитель.

time

Момент времени (этап техпроцесса), когда это сообщение показать. По умолчанию: после "подытога" возможные значения:

• AFTER_SUBTOTAL - После "подытога"
• AFTER_FISCALIZE - После фискализации чека

message-for-customer

message-for-cashier

id

multiplier

limit

id

String

Идентификатор данного "вычислителя"/"условия" предоставления подарков/"преференций". Должен быть уникален в рамках РА.

multiplier

Integer

множитель при вычислении

limit

Integer

Максимальное количество "сообщений"/"наклеек", что можно получить в рамках ДАННОГО УСЛОВИЯ (данного вычислителя) данной РА. Отсутствие данного атрибута распознается как отсутствие лимита.

id

String

Идентификатор данного "вычислителя"/"условия" предоставления подарков/"преференций". Должен быть уникален в рамках РА.

multiplier

Integer

Множитель при вычислении

limit

Integer

Максимальное количество "сообщений"/"наклеек", что можно получить в рамках ДАННОГО УСЛОВИЯ (данного вычислителя) данной РА. Отсутствие данного атрибута распознается как отсутствие лимита.

Группа элементов, описывающая товарный фильтр

Подробнее

id

String

Идентификатор данного "вычислителя"/"условия" предоставления подарков/"преференций". Должен быть уникален в рамках РА.

multiplier

Integer

Множитель при вычислении

limit

Integer

Максимальное количество "сообщений"/"наклеек", что можно получить в рамках ДАННОГО УСЛОВИЯ (данного вычислителя) данной РА. Отсутствие данного атрибута распознается как отсутствие лимита.

Группа элементов, описывающая товарный фильтр

Подробнее

enable

Boolean

Включена или выключена валидация

Добавлять подарки в чек как товары

Запоминать результат выдачи подарков для последующих перерасчетов

Пример импорта

Подробнее о функциональности.

barcode

String

Штрихкод подарка (используется только при выключенной опции "Добавлять подарки в чек как товары")

Код (артикул) товара-подарка (используется только при включенной опции "Добавлять подарки в чек как товары")

Тип периода действия ограничения

• DAYS - Дни
• MONTHS - Месяцы
• WEEKS - Недели

Количество товара в позиции, в "граммах" (т.е., 1000 = 1 кг. (для весового товара) и 1000 = 1 шт. (для штучного товара))

InternalCardsCondition

Комплексный

Наличие внутренней карты

Условия объединяются по логическому "ИЛИ":
то есть, весь блок условий сработает, если сработает хотя бы одно из условий из этого блока.

Наличие внешней карты

Условия объединяются по логическому "ИЛИ":
то есть, весь блок условий сработает, если сработает хотя бы одно из условий из этого блока.

Часы действия

Условие срабатывания РА "Счётчик срабатывания"

Условие срабатывания РА: "определяет внешняя система".

Условие срабатывания РА: "Сумма скидки по РА"

Код (или коды через запятую) программы лояльности, передаваемый в свойствах оплаты через терминал.

Условие срабатывания РА: "Наличие внешнего купона"

anyCard

without-card

Флаг-признак: «без карты» — то есть, данное условие срабатывания рекламной акции будет выполнено/удовлетворено если в чеке не была применена никакая внутренняя карта.

Cамо значение атрибута не анализируется: достаточно самого факта, что этот атрибут есть

Идентификатор внешней системы для загрузки рекламных акций с условием "Наличие внешней плагинной карты"

Уникальный идентификатор конкретного плагина необходимо получить у разработчика этого плагина. На момент загрузки РА плагин должен быть уже подключен на сервере.

Флаг-признак: «без карты» — то есть, данное условие срабатывания рекламной акции будет выполнено/удовлетворено если в чеке не была применена никакая внутренняя карта.

Cамо значение атрибута не анализируется: достаточно самого факта, что этот атрибут есть

number

32

String

Номер купона, который нужно применить для работы акции

or

Комплексный

Или

greater-than

Double

Сумма чека, которую должен превышать чек для срабатывания условия

less-than

Double

Сумма чека, меньше которой должен быть чек для срабатывания условия

equal-to

Double

Определяет сумму чека, при которой РА может сработать

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

• true - использовать
• false - не использовать

Данная настройка соответствует флажку в карточке рекламной акции Условия → Сумма чека → ПО ЧЕКУ → Учитывать стоимость товаров, на которые запрещен расчет скидок.

Учитывать только стоимость товаров из мягкого чека

• true - учитывать 
• false - не учитывать

days-before

nonNegativeInteger

Количество дней до дня рождения клиента. По умолчанию — 0

days-after

nonNegativeInteger

Количество дней после дня рождения клиента. По умолчанию – 0

Нет

Если не указаны оба параметра, или оба = 0, акция работает только в день рождения клиента

left

Integer

Начало интервала.

Если отсутствует, то интервал открыт слева (т.е., распознается как интервал начинающийся в минус бесконечности)

right

Integer

Окончание интервала.

Если отсутствует, то интервал открыт справа (т.е., распознается как интервал заканчивающийся в плюс бесконечности)

value

String

Нет

Должен быть указан один из параметров

includes

String

Номера касс, на которых должна работать акция (перечисление через, или)
Пример: 3, 4, 7-11, 15

excludes

String

Номера касс, на которых не должна работать акция (перечисление через, или).

На остальных кассах акция будет работать
Пример: 3, 4, 7-11, 15

Нет

Должен быть указан один из параметров

Условие добавления сегментов по «или», т.е. для срабатывания клиент должен находится в любом из указанных сегментов
Примеры: для срабатывания РА держатель карты должен принадлежать сегменту «A» или «B»:

Самый простой и базовый способ определения множества сегментов: перечислением их по GUID'ам.

Сам список будет определять объединение сегментов (логическое ИЛИ).

Сегменты, вложенные в этот элемент, взаимодействуют по логическому "И" (пересечение сегментов)

<segment-condition> 
	<and> 
		<segment guid="A" /> 
		<segment guid="B" /> 
	</and> 
</segment-condition>

Условие добавления сегментов по «и», т.е. для срабатывания клиент должен находиться во всех указанных сегментах.

Самый простой и базовый способ определения множества сегментов: перечислением их по GUID'ам.

Сам список будет определять объединение сегментов (логическое ИЛИ).

Сегменты, вложенные в этот элемент, взаимодействуют по логическому "И" (пересечение сегментов)

<segment-condition> 
	<and> 
		<segment guid="A" /> 
		<segment guid="B" /> 
	</and> 
</segment-condition>

Данный элемент добавляет логическое отрицание множества сегментов в него "вложенного".
Т.е., фильтру, определенному данным элементом будут удовлетворять все картоносцы, КРОМЕ тех,
что удовлетворяют вложенному элементу.
(Вычитание сегментов)

<segment-condition> 
	<not> 
		<segment guid="A" /> 
		<segment guid="B" /> 
	</not> 
</segment-condition>

suffixes

Комплексный

Список окончаний кодов клиентов

Тип условия:

• EXCLUDE
• INCLUDE

template-guid

long

GUID шаблонов

pricetag-type

list

Типы ценников, что надо распечатать на данную акцию

Допускается только одно повторение элемента в рекламной акции. Если требуется указать два типа ценника: Акционный и Скидочный (дополнительный/замещающий), тогда они должны быть перечислены через пробел:

• ACTION - акционный ценник.
• ADDITIONAL - скидочный (Дополнительный/замещающий)

<pricetag-type>ACTION ADDITIONAL</pricetag-type>

count

PositiveInteger

Количество ценников данного шаблона, что надо распечатать в автоматическом режиме

label

String

Наименование метки рекламной акции