Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.


Информация

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

...

AdvertisingActions/AdvertisingAction

Заголовок Рекламной акции

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

Размер

Тип данных

Описание

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

advertActGUID


Integer

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

Нет

name

255

String

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

Да

active


Boolean

Для загрузки активных акций всегда передавать true

Да

mode

13

String

Тип условия применения РА.

  • automatic – автоматическое срабатывание при срабатывании всех условий, описанных в блоке условий externalConditions
  • by-condition – с условиями – срабатывание при срабатывании одного любого из условий, описанных в блоке условий externalConditions
  • manual – ручная скидка
  • unconditional – безусловное срабатывание
Да

priority

15

Double

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

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

Нет

ignoreRestictions

Информация

В данном параметре отсутствует буква r для слова restrictions




Boolean

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

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

ignoreRestrictions

Начиная с версии 

Статус
colourBlue
title10.2.75.8
 
Статус
colourBlue
title10.2.76.3
 
Статус
colourBlue
title10.2.77.0
 можно использовать, как новый параметр, так и предыдущий ignoreRestictions

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySR-3219

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySR-3563


Boolean

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

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

worksAnyTime



Boolean

  • true – скидка по данной РА суммируется со всеми остальными акциями в случае конфликтов нескольких скидок на один товар.
  • false – скидка по данной РА не суммируется с другими скидками, скидка участвует в схеме взаимодействия акции, установленной в SetRetail10
Да

color

7

String

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

Используется для визуализации акции в SetRetail10, 

  •  Blue (по-умолчанию)
  •  Yellow
  •  Orange
  •  Green
  •  Red
  •  Violet
Нет

external-code

255

String

Внешний идентификатор РА

Да

ti

255

String

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

Нет
deleted
BooleanПризнак удаления рекламной акции. Акция останавливается сразу после загрузки признака остановки.Нет
discountType255StringКод типа скидкиНет
exempt-from-bonus-discounts
Boolean

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

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

Нет
disableChargeOnBonuses
BooleanФлаг-признак, запрещающий начисление бонусных баллов на товары, на которые сработала данная РАНет
finalAction
BooleanФлаг-признак, запрещающий новые скидки после срабатывания данной акцииНет

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

Размер


Тип данных

Описание

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

shop-indices

1024

PositiveInteger

(white space separated)

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

Нет

begin-date


 DateTime

Дата начала действия акции

Да

end-date


 DateTime

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

Да

pricetag-type

255

 String

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

Нет

Блоки содержимого Рекламной акции

Блок

Описание

dependence

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

externalConditions

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

actionResults

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

pricetag-template

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

actionLablesМетки рекламной акции

...

AdvertisingActions/AdvertisingAction/actionResults/set

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

Размер

Тип данных

Описание

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

name

64

String

Название набора внутри акции

Да

valueType

64

String

Тип скидки на строки набора: 

  • percent – процент скидки
  • fixedPrice – фиксированная цена
Да

value

15

Double

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

Нет

wholesale-restriction

4294967295

Integer

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

Нет

maxQuantity

3

Integer

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

Нет

calcWeightProductCountAsOne


Boolean

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

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

isSpreadDiscounts


Boolean

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

Нет

...

AdvertisingActions/AdvertisingAction/actionResults/set/row

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

Размер

Тип данных

Описание

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

requiedQuantity

4294967295

integer

Определяет кол-во единиц товара в строке, которого достаточно чтобы набор сработал

Да

discountPercent

15

Double

% скидки на товар в данной строке (не актуально при указании стоимости набора целиком)

Нет

fixedPrice

15

Double

Фиксированная акционная цена товара в данной строке (не актуально при указании стоимости набора целиком)

Нет

groupName

32

String

Название списка товаров (используется только при создании списка товаров в строке)

Нет

...

AdvertisingActions/AdvertisingAction/actionResults/goodsDiscount/goods-filter-includeGroup/goods-filterGroup/goodsGroup

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

Тип данныхОписаниеОбязательное

name

StringНаименование списка товаровДа

marking-of-the-good

КомплексныйТовары, на которые будем устанавливать скидкиНет






Наименование атрибутаТип данныхОписаниеОбязательное
idStringКод товараДа
maxQuantityDouble

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

Если отсутствует - без ограничений.

Нет
discountStartDoubleОпределяет количество товара, начиная с которого на этот товар будет начисляться скидка. По умолчанию с первого же товараНет
conditionCountDoubleОпределяет количество товара, при покупке которого на все количество этого товара будет дана скидка. По умолчанию при любом количестве.Нет
fixedPriceDoubleФиксированная акционная цена товара.Нет
wholesale-restrictionDoubleУстановленное оптовое ограничение (количество товара со скидкой за сутки для одного покупателя)Нет
        Идентификатор товарной группы со скидкой <group>

...

AdvertisingActions/AdvertisingAction/actionResults/goodsDiscount/exclude

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

Типа данныхОписаниеОбязательное

exclude

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

goods-filterGroup

Данный атрибут не указывается в XML-сообщении. Он определяет группу элементов на схеме.

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

marking-of-the-goodКомплексныйАртикулы (коды товаров), на которые будут установлены скидкиНет

goodsGroupКомплексныйСписок товаровНет

groupКомплексныйИдентификатор отварной группыНет

sale-groupStringСписок идентификаторов (кодов) групп продаж, товары из которых удовлетворяют данному фильтруНет
Группа элементов, описывающая товарный фильтр <goods-filterGroup>

...

AdvertisingActions/AdvertisingAction/actionResults/goodsDiscount/exclude/goods-filterGroup/goodsGroup

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

Тип данныхОписаниеОбязательное

name

StringНаименование списка товаровДа

marking-of-the-good

КомплексныйТовары, на которые будем устанавливать скидкиНет






Наименование атрибутаТип данныхОписаниеОбязательное
idStringКод товараДа
maxQuantityDouble

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

Если отсутствует - без ограничений.

Нет
discountStartDoubleОпределяет количество товара, начиная с которого на этот товар будет начисляться скидка. По умолчанию с первого же товараНет
conditionCountDoubleОпределяет количество товара, при покупке которого на все количество этого товара будет дана скидка. По умолчанию при любом количестве.Нет
fixedPriceDoubleФиксированная акционная цена товара.Нет
wholesale-restrictionDoubleУстановленное оптовое ограничение (количество товара со скидкой за сутки для одного покупателя)Нет
        Идентификатор товарной группы со скидкой <group>

...

AdvertisingActions/AdvertisingAction/actionResults/notification/calculator

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

Тип данныхОписаниеОбязательное

xsi:type

String

sum-based-preferences-calculatorType

Да

id

String

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

Нет

divider

Integer

Делимое при вычислении

Да

multiplier

Integer

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

Нет

limit

Integer

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

Нет
checkDiscountableFlagBooleanПроверять или нет товарное свойство "Расчет скидок на товар запрещен" при расчете количества преференций данного типа.Нет
Наименование элементаТип данныхОписаниеОбязательное
goods-filterКомплексный

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

Подробнее

Нет
groupStringИдентификатор товарной группыНет
sale-groupStringСписок идентификаторов (кодов) групп продаж, товары из которых удовлетворяют данному фильтруНет
markingStringСписок идентификаторов (артикулов) товаров, что участвуют при вычислении количества "преференций".Нет

...

AdvertisingActions/AdvertisingAction/actionResults/notification/calculator

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

Тип данныхОписаниеОбязательное

xsi:type

String

quantity-based-preferences-calculatorType

Да

id

String

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

Нет

divider

Integer

Делимое при вычислении

Да

multiplier

Integer

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

Нет

limit

Integer

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

Нет
checkDiscountableFlagBooleanПроверять или нет товарное свойство "Расчет скидок на товар запрещен" при расчете количества преференций данного типа.Нет
Наименование элементаТип данныхОписаниеОбязательное
goods-filterКомплексный

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

Подробнее

Нет
groupStringИдентификатор товарной группыНет
sale-groupStringСписок идентификаторов (кодов) групп продаж, товары из которых удовлетворяют данному фильтруНет
markingStringСписок идентификаторов (артикулов) товаров, что участвуют при вычислении количества "преференций".Нет

...

AdvertisingActions/AdvertisingAction/actionResults/notification/validation

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

Тип данныхОписаниеОбязательное

enable

Boolean

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

Нет
adds-as-productsBoolean

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

Статус
colourBlue
title10.2.89.0

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySR-4019

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySR-4020

Нет
Наименование элементаТип данныхОписаниеОбязательное

barcode

String

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

Нет
markingString

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

Статус
colourBlue
title10.2.89.0

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySR-4019

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySR-4020

Нет


Блок кода
languagexml
titleПример импорта рекламной акции с товаром-подарком
<?xml version="1.0" encoding="UTF-8"?>
<AdvertisingActions xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <AdvertisingAction name="Подарок SR-4020"
                       active="true"
                       mode="unconditional"
                       priority="1001"
                       ignoreRestictions="true"
                       worksAnyTime="true"
                       color="violet"
                       external-code="EXTERNAL_CODE_0001-3">
        <begin-date>2013-03-13T00:00:00</begin-date>
        <end-date>2071-04-13T00:00:00</end-date>
        <actionResults>
            <notification limit="2">
                <online-notification time="SUBTOTAL">
                    <message-for-customer><![CDATA[CUSTOMER_MESSAGE]]></message-for-customer>
                    <message-for-cashier><![CDATA[CASHIER_MESSAGE]]></message-for-cashier>
                </online-notification>
  
                <calculator xsi:type="quantity-based-preferences-calculatorType" divider="3000" multiplier="1" limit="2">
                    <marking>145902</marking>
                </calculator>
  
                <validation enable="true" add-as-products="true">
                    <marking>00998</marking>
                </validation>
            </notification>
 
            <goodsDiscount name="Скидка на подарок" discountPercent="50" for-gifts-only="true">
                <marking-of-the-good id="00998"/>
            </goodsDiscount>
        </actionResults>
    </AdvertisingAction>
</AdvertisingActions>

...

AdvertisingActions/AdvertisingAction/externalConditions

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

Тип данных

Описание

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

InternalCardsCondition

Комплексный

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

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

Нет
ExternalCardsConditionКомплексный

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

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

Нет
HoursActionConditionКомплексный

Часы действи

Нет
DaysActionConditionКомплексныйДни неделиНет
CouponsConditionКомплексныйНаличие купонаНет
purchaseAmountКомплексныйСумма чекаНет
birthday-conditionКомплексныйДень рожденияНет
age-conditionКомплексныйВозраст покупателяНет
completed-profile-conditionКомплексныйСтатус заполненности анкетыНет
choose-external-systemКомплексныйРешает внешняя системаНет
payment-typeКомплексныйПо типу оплатыНет
cash-numsКомплексныйТип "номер кассы" [на которой пробивают чек]Нет
segment-conditionКомплексныйСрабатывание рекламной акции по вхождению дисконтной карты в сегментНет
client-guid-conditionКомплексныйТип "Клиентские", подтип "Код клиента".Нет
country-conditionКомплексныйТип "Товарные", подтип "Страна производитель"Нет
manufacturer-conditionКомплексныйТип "Товарные", подтип "Производитель"Нет
depart-conditionКомплексныйТип "Товарные", подтип "Отдел"Нет
goods-count-conditionКомплексныйТип "Товарные", подтип "Количество товаров"Нет
group-conditionКомплексныйТип "Товарные", подтип "Товарная группа"Нет
sale-group-conditionКомплексныйТип "Товарные", подтип "Группа продаж"Нет
action-results-quantity-conditionКомплексныйКоличество раз срабатыванияНет
cash-template-conditionКомплексныйУсловие срабатывания типа "Шаблоны касс"Нет
counter-conditionКомплексный

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

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySLS-270

Статус
colourBlue
title10.2.75.0

Нет
external-system-resolution-conditionКомплексный

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

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySR-3206

Статус
colourBlue
title10.2.72.0

Нет
discount-sum-conditionКомплексный

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

Устаревшая версия Jira
serverSystem JIRA
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySLS-369

Статус
colourBlue
title10.2.78.0

Нет
bank-loyalty-code-conditionКомлексный

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

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySR-2891

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keyCR-2003

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keyCR-2850

Статус
colourGreen
title10.2.97.0

Нет
external-coupon-conditionКомплексный

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

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySR-4758

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keyCR-5557

Статус
colourBlue
title10.2.98.0





...

AdvertisingActions/AdvertisingAction/externalConditions/ExternalCardsCondition


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

РазмерТип данныхОписаниеОбязательное

guid

128Stringguid категории карт в SetRetail10Да
providerName128String

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

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySR-3359

Статус
colourBlue
title10.2.75.0

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

Нет
without-card
Boolean

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

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

Нет

...

Счетчик <counter-condition>

Устаревшая версия Jira
serverSystem JIRA
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySLS-270

Статус
colourBlue
title10.2.75.0

...

Определяет внешняя система <external-system-resolution-condition>

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySR-3206

Статус
colourBlue
title10.2.72.0

...