Публичный ресурс
Импорт рекламных акций из ERP в SetRetail10
Для чтения визуальной составляющей схемы XSD, а также типами обязательных данных, ознакомьтесь с правилами использования.
Методы веб-сервиса для импорта рекламных акций
Без обратной связи | |
Метод | importActions |
URL | http://IP-адрес_сервера:8090/SET-ERPIntegration/AdvertisingActionsImport |
WSDL | http://IP-адрес_сервера:8090/SET-ERPIntegration/AdvertisingActionsImport?wsdl |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
xmlData | base64Binary | Рекламные акции в формате XML | Да |
Возвращаемые параметры | |||
return | boolean | Ответ об успешном прохождении валидации пакета данных и принятии его в обработку |
Описание формата рекламных акций
С обратной связью | |
Метод | importActionsWithTi |
URL | http://IP-адрес_сервера:8090/SET-ERPIntegration/AdvertisingActionsImport |
WSDL | http://IP-адрес_сервера:8090/SET-ERPIntegration/AdvertisingActionsImport?wsdl |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
xmlData | base64Binary | XML в формате данных Рекламных акций, кодированный с помощью base64Binary | Да |
ti | String |
| Нет |
Возвращаемые параметры | |||
return | boolean |
|
Описание формата рекламных акций
Важно
ti
– является уникальным идентификатором этого пакета в SetRetail10, что накладывает определённые ограничения на повторный импорт пакета и загрузку разных типов данных с одним идентификатором. Transaction Id Рекламные акции <AdvertisingActions>
AdvertisingActions |
Коллекция рекламных акций |
В данных каждой рекламной акции содержится внешний код (external-code), который служит уникальным идентификатором для управления рекламными акциями в SetRetail10 из ERP. При получении из ERP акции с уже имеющимся в системе external-code, текущая акция с данным external-code безусловно перезаписывается полученной из ERP.
Для рекламных акций, создаваемых в модуле визуализации SetRetail10, также генерируется уникальный в рамках торговой сети магазинов external_code
с префиксом SR10_.
Атрибут external-code используется в качестве кода акции в отчете о рассчитанных скидках, выгружаемом в ERP с чеками.
Данные рекламных акций выгружаются из ERP в SR10 в формате, предоставляемом Set Retail 10 в виде единой целостной сущности.
На стороне SR10 происходит валидация данных полученных из ERP рекламных акций. Рекламная акция будет отклонена, если в данных РА:
- Указана зависимость от другой акции, которой нет в SR10;
- Указан магазин, которого нет в SR10;
- Не указан один из обязательных параметров величины скидки (фиксированная цена / процент скидки и т.п.)
Отклоненные акции выкладываются в папку отклоненных акций для обеспечения обратной связи по загрузке акций с ERP
Рекламная акция <AdvertisingAction>
Зависимости <dependence>
Данный блок служит для обеспечения возможности управления из ERP зависимостью акций. Использование зависимостей позволяет строить более сложные и гибкие двухуровневые схемы построения маркетинговых программ.
В случае использования зависимых скидок расчет скидок производится в два последовательных этапа расчета, сначала рассчитываются скидки первого уровня (без установленной зависимости), а затем скидки второго уровня (с установленной зависимостью от скидки первого уровня).
Скидка второго уровня может сработать на позицию, только если на эту позицию на первом этапе уже сработала скидка первого уровня, от которой построена зависимость. Скидки второго уровня действуют от цен, полученных в результате действия скидок первого уровня.
Таким образом могут быть построены классические схемы расчета скидок, например, дополнительные скидки действуют от цен по дисконтной карте (акции на применение второй цены).
Важно:
Данный блок не является обязательным, вы не обязаны использовать зависимости в ваших маркетинговых программах.
Принцип работы суммирующихся акций остается неизменным.
Все суммирующиеся акции worksAnyTime = true
всегда действуют после последовательного применения конкурирующих worksAnyTime = false
акций первого и второго уровня.
Возможно построение зависимостей сразу от нескольких акций, тогда скидка второго уровня будет работать, если на позицию сработала хотя бы одна из скидок, от которых построена зависимость.
AdvertisingActions/AdvertisingAction/dependence | ||||
Наименование элемента | Размер | Тип данных | Описание | Обязательное |
---|---|---|---|---|
key | 255 | String | Всегда заполняется значением 'external-code' | Да |
value | 255 | String | External-code уже существующей акции, от которой должна быть установлена зависимость. | Да |
<AdvertisingActions> <AdvertisingAction name=”Скидка на количество по карте (зависит от 2й цены)” active=”true” mode=”automatic” priority=”1” ignoreRestictions=”true” worksAnyTime=”false” color=”green” external-code=”SR10_001”> <dependence key=”external-code” value=”SR10_1363”/> <dependence key=”external-code” value=”SR10_1364”/> <begin-date>2012-10-21T00:00:00Z</begin-date> <end-date>2012-11-31T00:00:00Z</end-date> <actionResults> <catalog> <marking-of-the-good id = “3850114202480” discountStart = “2.000” fixedPrice = “1000.00” maxQuantity = “43534.00”/> </catalog> </actionResults> <externalConditions> <InternalCardsCondition guid=”1359”/> </externalConditions> </AdvertisingAction> </AdvertisingActions>
Результаты рекламной акции <actionResults>
Скидка на наборы <set>
В рамках одной акции может быть задано любое количество различных наборов. В рамках одной акции нельзя комбинировать наборы с другими результатами применения скидки.
AdvertisingActions/AdvertisingAction/actionResults/set | ||||
Наименование атрибута | Размер | Тип данных | Описание | Обязательное |
---|---|---|---|---|
name | 64 | String | Название набора внутри акции | Да |
valueType | 64 | String | Тип скидки на строки набора:
| Да |
value | 15 | Double | Стоимость набора целиком | Нет |
wholesale-restriction | 4294967295 | Integer | Установленное оптовое ограничение (количество наборов со скидкой за сутки для одного покупателя) | Нет |
maxQuantity | 3 | Integer | Максимальное количество наборов в чеке со скидкой | Нет |
calcWeightProductCountAsOne | Boolean | Принцип учета количества весовых позиций в наборе
| Нет | |
isSpreadDiscounts | Boolean | Говорит о том, что скидки на подарочные позиции будут размазаны по всему набору равномерно с учетом цен компонентов | Нет |
Каждый набор должен содержать не менее одной строки набора, иначе акция с таким набором будет отклонена.
Для каждой строки набора нужно указать один элемент (товар, список товаров, группа товаров, производитель, страна), а также количество товара в строке, требуемое для составления набора в чеке. Набор считается сработавшим только при наличии всех нужных товаров (из строк) в нужном количестве в чеке.
Для всех строк внутри набора должен быть установлен одинаковый тип скидки (процентная скидки или фиксированная цена). Для строки можно не указывать скидку, эта строка в наборе продается без скидки.
Важно:
Обязательно либо указание стоимости набора целиком, либо значения скидки для одной или нескольких строк набора.
Если для одной строки набора прислать больше одного товара, для этой строки в SetRetail будет создан список товаров. Для срабатывания набора нужно будет купить требуемое в строке количество любого товара из данного списка. Для такого списка товаров можно задать название в атрибутах строки.
Важно:
<AdvertisingAction guid=”12982” name=”Пивов подарок при покупке любых 2 упаковок чипсов” active=”true” mode=”unconditional” priority=”1” ignoreRestictions=”true” worksAnyTime=”false” color=”” external-code=”BBZB01RAZB” > <shop-indices>701</shop-indices> <begin-date>2012-02-21T00:00:00Z</begin-date> <end-date>2012-02-29T00:00:00Z</end-date> <actionResults> <set name="Пиво в подарок при покупке любых 2 упаковок чипсов"> <row requiedQuantity=”1.000” fixedPrice=”100.00”> <marking-of-the-good id=”4100000200”/> </row> <row groupName=”Чипсы Lays” requiedQuantity=”3.000” fixedPrice=”30.00”> <marking-of-the-good id=”4100000100”/> <marking-of-the-good id=”4100000110”/> <marking-of-the-good id=”4100000120”/> <marking-of-the-good id=”4100000130”/> <marking-of-the-good id=”4100000140”/> </row> </set> </actionResults> </AdvertisingAction>
Список строк скидки на наборы <row>
AdvertisingActions/AdvertisingAction/actionResults/set/row | ||||
Наименование атрибута | Размер | Тип данных | Описание | Обязательное |
---|---|---|---|---|
requiedQuantity | 4294967295 | integer | Определяет кол-во единиц товара в строке, которого достаточно чтобы набор сработал | Да |
discountPercent | 15 | Double | % скидки на товар в данной строке (не актуально при указании стоимости набора целиком) | Нет |
fixedPrice | 15 | Double | Фиксированная акционная цена товара в данной строке (не актуально при указании стоимости набора целиком) | Нет |
groupName | 32 | String | Название списка товаров (используется только при создании списка товаров в строке) | Нет |
Товар в строке набора <marking-of-the-good>
Можно указать любое количество элементов.
AdvertisingActions/AdvertisingAction/actionResults/set/row/marking-of-the-good | ||||
Наименование атрибута | Размер | Тип данных | Описание | Обязательное |
---|---|---|---|---|
id | 255 | String | код товара | Да |
maxQuantity | Double | определяет максимальное кол-во товара в чеке, которое будет продано по акции. По умолчанию любое кол-во. | Нет | |
fixedPrice | Double | Фиксированная акционная цена товара. | Да | |
discountStart | Double | определяет количество товара, начиная с которого на этот товар будет начисляться скидка. По умолчанию с первого же товара | Нет | |
conditionCount | Double | определяет количество товара, при покупке которого на все количество этого товара будет дана скидка. По умолчанию при любом количестве. | Нет | |
wholesale-restriction | Double | Установленное оптовое ограничение (количество товара со скидкой за сутки для одного покупателя) | Нет |
Описание товарной группы в строке набора <group>
Можно указать только 1 элемент.
AdvertisingActions/AdvertisingAction/actionResults/set/row/group | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
---|---|---|---|
id | String | Код товарной группы | Да |
Описание производителя товаров в строке набора <manufacturer>
Можно указать только 1 элемент
AdvertisingActions/AdvertisingAction/actionResults/set/row/manufacturer | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
---|---|---|---|
id | String | Код производителя | Да |
Описание отдела в строке набора <department>
Под это условие попадают товары, имеющие активные цены в указанном отделе. Можно указать только 1 элемент.
AdvertisingActions/AdvertisingAction/actionResults/set/row/department | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
---|---|---|---|
id | String | Номер отдела | Да |
Описание производителя товаров в строке набора <country>
Можно указать только 1 элемент
AdvertisingActions/AdvertisingAction/actionResults/set/row/country | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
---|---|---|---|
id | String | Код страны | Да |
Описание группы продаж в строке набора <sale-group>
Можно указать только 1 элемент
AdvertisingActions/AdvertisingAction/actionResults/set/row/sale-group | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
---|---|---|---|
id | String | Код заранее загруженной или созданной в SR10 группы продаж | Да |
Множество товарных групп (по кодам) <groups-element>
Задает множество товарных групп (по их кодам), что ограничивают множество товаров, удовлетворяющих данному критерию. Можно указать любое количество элементов.
AdvertisingActions/AdvertisingAction/actionResults/set/row/groups-element | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
---|---|---|---|
id | String | Код товарной группы | Да |
Множество производителей (по кодам) <manufacturers-element>
Задает множество производителей (по их кодам), что ограничивают множество товаров, удовлетворяющих данному критерию. Можно указать любое количество элементов.
AdvertisingActions/AdvertisingAction/actionResults/set/row/manufacturers-element | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
---|---|---|---|
id | String | Код производителя | Да |
Множество номеров отделов <departments-element>
Множество номеров отделов, что ограничивают множество товаров, удовлетворяющих данному критерию. Под это условие попадают товары, имеющие активные цены в указанных отделах.
Можно указать любое количество элементов.
AdvertisingActions/AdvertisingAction/actionResults/set/row/departments-element | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
---|---|---|---|
id | String | Номер отдела | Да |
Множество стран (по кодам) <countries-element>
Множество стран (по их кодам), что ограничивают множество товаров, удовлетворяющих данному критерию.
Можно указать любое количество элементов.
AdvertisingActions/AdvertisingAction/actionResults/set/row/countries-element | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
---|---|---|---|
id | String | Код страны | Да |
Множество групп продаж (по кодам) <sale-groups-element>
Множество групп продаж (по их кодам), что ограничивают множество товаров, удовлетворяющих данному критерию. Можно указать любое количество элементов.
AdvertisingActions/AdvertisingAction/actionResults/set/row/sale-groups-element | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
---|---|---|---|
id | String | Код заранее загруженной или созданной в SetRetail10 группы продаж | Да |
Ограничение (при выборке товаров) по цене <price-restriction>
Можно указать только 1 элемент.
AdvertisingActions/AdvertisingAction/actionResults/set/row/price-restriction | |||
---|---|---|---|
Наименование атрибута | Тип данных | Описание | Обязательное |
condition | InequationType | Условие сравнения цены: больше, меньше.
| Да |
value | Decimal | Пороговое значение цены для сравнения, в «рублях» | Да |
Каталог фиксированных цен <catalog>
В рамках одной акции может быть задано любое количество фиксированных цен на товары. В рамках одной акции нельзя комбинировать фиксированные цены с другими результатами применения скидки.
AdvertisingActions/AdvertisingAction/actionResults/catalog | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
---|---|---|---|
id | String | Код товара | Да |
maxQuantity | Double | Определяет максимальное кол-во товара в чеке, которое будет продано по акции. По умолчанию любое кол-во. | Нет |
discountStart | Double | Определяет количество товара, начиная с которого на этот товар будет начисляться скидка. По умолчанию с первого же товара | Нет |
conditionCount | Double | Определяет количество товара, при покупке которого на все количество этого товара будет дана скидка. По умолчанию при любом количестве. | Нет |
fixedPrice | Double | Фиксированная акционная цена товара. | Нет |
Wholesale-restriction | Double | Установленное оптовое ограничение (количество товара со скидкой за сутки для одного покупателя) | Нет |
<AdvertisingAction guid=”1298” name=”BBZB01RAZB: Фиксированная цена на товар с ограничением количества” active=”true” mode=”unconditional” priority=”1” ignoreRestictions=”true” worksAnyTime=”false” color=”” external-code=” BBZB01RAZB” > <shop-indices>701</shop-indices> <begin-date>2012-02-21T00:00:00Z</begin-date> <end-date>2012-02-29T00:00:00Z</end-date> <actionResults> <catalog> <marking-of-the-good id=”4100000107” maxQuantity=”5” fixedPrice=”89”/> <!--maxQuantity определяет максимальное кол-во товара в чеке, которое будет продано по акции. 0=любое кол-во --> <marking-of-the-good id=”4100000108” maxQuantity=”5” discountStart=”4” fixedPrice=”100”/> <!--fixedPrice задаёт фиксированную цену на товар; discountStart определяет позицию, начиная с которой на этот товар будет начислять скидка --> <marking-of-the-good id=”4100000109” maxQuantity=”0” conditionCount=”10” fixedPrice=”299”/> <!--conditionCount определяет количество товара, при покупке которого на все количество этого товара будет дана скидка. --> <marking-of-the-good id=”4100000104” maxQuantity=”0” fixedPrice=”199” wholesale-restriction=”3” /> <!--wholesale-restriction определяет количество товара, которое можно купить со скидкой одному покупателю за сутки. --> </catalog> </actionResults> </AdvertisingAction>
Скидки на товары и группы продаж <goodsDiscount>
- В рамках одной акции может быть задано любое количество различных скидок на товары.
- В рамках одной акции нельзя комбинировать скидки на товары с другими результатами применения скидки.
- Скидки можно давать на товары, список товаров, товарную группу.
- Скидка задается целиком на набор элементов и может быть выражена в процентах или фиксированной скидке на единицу товара.
- В результате рекламной акции “Скидка на товары“ допускается заведение нескольких скидок только одного типа (процент, фиксированная цена и т.д.).
- При расчете производится упорядочивание по размеру скидки и в рамках такой рекламной акции сначала учитывается самая выгодная из них.
- Возможен сценарий, когда сработает только одна из таких скидок (если скидка применена на весь товар в позиции), даже если выбран принцип срабатывания акций “суммируются все сработавшие“, так как оставшиеся скидки в рамках такой рекламной акции не сработали.
AdvertisingActions/AdvertisingAction/actionResults/goodsDiscount | ||||
Наименование атрибута | Тип данных | Описание | Обязательное | |
---|---|---|---|---|
name | String | Название скидки | Нет | |
calcWeightProductCountAsOne | Boolean | Принцип учета количества весовых позиций в скидках с количественными ограничениями
| Нет | |
maxQuantity | Double | Определяет максимальное кол-во товара в чеке, которое будет продано по акции. | Нет | |
discountPercent | Double | Процент скидки на товар | Нет | |
discountSum | Double | Сумма скидки на товар | Нет | |
fixPrice | Double | Фиксированная цена каждой единицы товара из этой группы | Нет | |
goodsSum | Double | Сумма скидки при покупке товаров из этой группы. Распределяется пропорционально стоимости товаров этой группы. - CR-3655Получение подробных данных проблемы… СТАТУС - SR-3702Получение подробных данных проблемы… СТАТУС 10.2.82.0 | Нет | |
discountStart | Double | Определяет позицию, начиная с которой на этот товар будет начисляться скидка | Нет | |
conditionCount | Double | Определяет количество товара, при покупке которого на все количество этого товара будет дана скидка | Нет | |
wholesale-restriction | Double | Установленное оптовое ограничение (количество товара, групп товаров, групп продаж и пр. со скидкой за сутки для одного покупателя) | Нет | |
allowOffline | Boolean | Разрешать расчет без получения данных об ограничениях из внешней системы | Нет | |
for-gifts-only | Boolean | Предоставлять скидку только для подарков 10.2.89.0 | Нет | |
for-soft-check-only | Boolean | Предоставлять скидку только для товаров из мягкого чека. 10.3.4.0 | Нет | |
plugin-id | String | Идентификатор плагина в рамках РА | Нет | |
apply-count-for-each-row | String | Применять ограничения на каждую позицию
- SR-5218Получение подробных данных проблемы… СТАТУС - CR-6154Получение подробных данных проблемы… СТАТУС 10.3.6.0 Применяется к элементам списка и действуют на количество товара каждого объекта goods-filter-includeAndExcludeGroup):
Если элемент | Нет | |
Наименование элемента | Тип данных | Описание | Обязательное | |
goods-filter-includeAndExcludeGroup Данный атрибут не указывается в XML-сообщении. Он определяет группу элементов на схеме. | Группа элементов, описывающая фильтр, по которому отбираются товары, на которые должна сработать скидка. Только одна из двух опций валидна: либо элемент-галочка "весь товарный справочник", либо группа фильтров "goods-filterGroup". | Нет | ||
for-all-goods | Boolean | Флаг-признак, указывающий на то, что данная скидка действует на ВЕСЬ ТОВАРНЫЙ СПРАВОЧНИК (за исключением товаров, что удовлетворяют фильтру exclude) | Нет | |
goods-filterGroup | Комплексный | Группа элементов, описывающая некий товарный фильтр | Нет | |
exclude | Комплексный | Фильтр, определяющий множество товаров, на которые данная скидка НЕ должна сработать. Данный фильтр имеет приоритет перед группой фильтров "goods-filterGroup" и флагом "for-all-goods": если товар удовлетворяет фильтру "exclude", то скидка на него не будет дана - не зависимо от значения флага "for-all-goods", либо значений фильтров группы "goods-filterGroup" | Нет | |
client-restriction | Комплексный | Ограничение по сумме скидки РА по клиенту - SLS-382Получение подробных данных проблемы… СТАТУС 10.2.80.0 | Нет | |
storage-time-condition | Комплексный | Импорт скидки на товары со сроком годности, близким к истечению Условие "до истечения срока годности" - SR-3610Получение подробных данных проблемы… СТАТУС - SR-3671Получение подробных данных проблемы… СТАТУС 10.2.80.0 | Нет | |
action-label-exclude | String | Нет |
<?xml version="1.0" encoding="UTF-8"?> <AdvertisingActions> <AdvertisingAction name="Test sync with TI # 1" mode="automatic" active="true" priority="1.0" ignoreRestictions="true" worksAnyTime="true" external-code="092" shop-indices="7"> <begin-date>2020-01-19T12:23:00</begin-date> <end-date>2020-01-31T12:21:00</end-date> <actionResults> <goodsDiscount discountPercent="10.0"> <exclude> <marking-of-the-good id="00001" /> <marking-of-the-good id="00002" /> </exclude> <marking-of-the-good id="00003"/> <marking-of-the-good id="00004"/> </goodsDiscount> </actionResults> </AdvertisingAction> </AdvertisingActions>
Товары и группы товаров, на которые должна сработать акция <goods-filterIncludeAndExcludeGroup>
AdvertisingActions/AdvertisingAction/actionResults/goodsDiscount/goods-filterIncludeAndExcludeGroup | ||||
Наименование элемента | Тип данных | Описание | Обязательное | |
---|---|---|---|---|
for-all-goods | Boolean | Флаг-признак, указывающий на то, что данная скидка действует на ВЕСЬ ТОВАРНЫЙ СПРАВОЧНИК (за исключением товаров, что удовлетворяют фильтру exclude) | Нет | |
goods-filterGroup Данный атрибут не указывается в XML-сообщении. Он определяет группу элементов на схеме. | Группа элементов, описывающая товарный фильтр | Нет | ||
marking-of-the-good | Комплексный | Артикулы (коды товаров), на которые будут установлены скидки | Нет | |
goodsGroup | Комплексный | Список товаров | Нет | |
group | Комплексный | Идентификатор товарной группы | Нет | |
sale-group | String | Список идентификаторов (кодов) групп продаж, товары из которых удовлетворяют данному фильтру | Нет | |
manufacturer | String | Код производителя | Нет | |
department | String | Номер отдела | Нет | |
country | String | Код страны (по ISO 3166-1 alpha-3) | Нет | |
product-type | String | Тип товара | Нет | |
composite | String | Составной объект Данный фильтр имеет приоритет перед группой фильтров "goods-filterGroup" и флагом "for-all-goods": если товар удовлетворяет фильтру "exclude", то в выборку он не попадает - не зависимо от значения флага "for-all-goods", либо значений фильтров группы "goods-filterGroup" | Нет | |
exclude | Boolean | Фильтр, определяющий множество товаров, на которые данная скидка НЕ должна сработать. Данный фильтр имеет приоритет перед группой фильтров "goods-filterGroup" и флагом "for-all-goods": если товар удовлетворяет фильтру "exclude", то скидка на него не будет дана - не зависимо от значения флаг "for-all-goods", либо значений фильтров группы "goods-filterGroup | Нет |
Группа элементов, описывающая товарный фильтр <goods-filterGroup>
Должен быть указан один из параметров
С использованием данной секции возможно использовать список товаров внутри скидки. Это позволяет создавать акции, в которых ограничение количества (на понижение или повышение) устанавливается на ассортимент товаров, а не один товар. Например, скидка при покупке более
5 любых соков или скидка дается не более чем 10 упаковок любых чипсов.
Пример акции со скидкой 10% на список товаров и ограничением минимального и максимального количества по акции
AdvertisingActions/AdvertisingAction/actionResults/goodsDiscount/goods-filter-includeGroup/goods-filterGroup | |||
Наименование элемента | Тип данных | Описание | Обязательное |
---|---|---|---|
marking-of-the-good | Комплексный | Артикулы (коды товаров), на которые будут установлены скидки Задает множество товаров, на которые воздействует РА, по списку артикулов этих товаров
| Нет |
goodsGroup | Комплексный | Определяет "плоский" список товаров внутри акции Определяет список товаров внутри акции на которые воздействует РА
| Нет |
group | Комплексный | Идентификатор товарной группы | Нет |
sale-group | String | Список идентификаторов (кодов) групп продаж, товары из которых удовлетворяют данному фильтру | Нет |
manufacturer | String | Код производителя | Нет |
department | String | Номер отдела | Нет |
country | String | Код страны (по ISO 3166-1 alpha-3) | Нет |
product-type | String | Тип товара | Нет |
composite | String | Составной объект Данный фильтр имеет приоритет перед группой фильтров "goods-filterGroup" и флагом "for-all-goods": если товар удовлетворяет фильтру "exclude", то в выборку он не попадает - не зависимо от значения флага "for-all-goods", либо значений фильтров группы "goods-filterGroup" | Нет |
Товары и группы товаров, которые необходимо исключить из акции <exclude>
AdvertisingActions/AdvertisingAction/actionResults/goodsDiscount/exclude | ||||
Наименование элемента | Типа данных | Описание | Обязательное | |
---|---|---|---|---|
exclude | Комплексный | Группа элементов, описывающая некий товарный фильтр | Нет | |
goods-filterGroup Данный атрибут не указывается в XML-сообщении. Он определяет группу элементов на схеме. | Группа элементов, описывающая товарный фильтр | Нет | ||
marking-of-the-good | Комплексный | Артикулы (коды товаров), на которые будут установлены скидки Задает множество товаров, на которые воздействует РА, по списку артикулов этих товаров
| Нет | |
goodsGroup | Комплексный | Определяет "плоский" список товаров внутри акции Определяет список товаров внутри акции на которые воздействует РА
| Нет | |
group | Комплексный | Идентификатор товарной группы | Нет | |
sale-group | String | Список идентификаторов (кодов) групп продаж, товары из которых удовлетворяют данному фильтру | Нет | |
manufacturer | String | Номер отдела | Нет | |
department | String | Номер отдела | Нет | |
country | String | Код страны (по ISO 3166-1 alpha-3) | Нет | |
product-type | String | Тип товара | Нет | |
composite | String | Составной объект Данный фильтр имеет приоритет перед группой фильтров "goods-filterGroup" и флагом "for-all-goods": если товар удовлетворяет фильтру "exclude", то в выборку он не попадает - не зависимо от значения флага "for-all-goods", либо значений фильтров группы "goods-filterGroup" | Нет |
Ограничение по сумме скидки рекламной акции по клиенту <client-restriction>
10.2.80.0
AdvertisingActions/AdvertisingAction/actionResults/goodsDiscount/client-restriction | ||||
Наименование элемента | Тип данных | Описание | Обязательное | |
client-restriction | Комплексный | Ограничение по сумме скидки РА по клиенту | Нет | |
Наименование атрибута | Тип данных | Описание | Обязательное | |
---|---|---|---|---|
max-value | Integer | Значение ограничения | Да | |
restriction-period-type | Комплексный | Тип периода действия ограничения | Нет | |
period | Комплексный | Значение периода действия | Да |
<AdvertisingActions><AdvertisingAction name="НЕ РЕДАКТИРОВАТЬ" active="true" mode="automatic" worksAnyTime="true" external-code="SLS-382" deleted="false"priority="100000.0" ignoreRestrictions="false" color="yellow"><begin-date>2012-12-01T18:00:00</begin-date><end-date>2050-12-01T18:00:00</end-date><actionLabels><label>социальные</label></actionLabels> <actionResults> <goodsDiscount name="Штучные товары 60шт" calcWeightProductCountAsOne="false" discountPercent="10.0" allowOffline="false"> <for-all-goods>false</for-all-goods> <product-type>ProductPieceEntity</product-type> <client-restriction max-value="60" restriction-period-type="DAYS" period="30"/> </goodsDiscount> <goodsDiscount name="Весовые товары 6кг" calcWeightProductCountAsOne="false" discountPercent="10.0" allowOffline="false"> <for-all-goods>false</for-all-goods> <product-type>ProductWeightEntity</product-type> <client-restriction max-value="6" restriction-period-type="DAYS" period="30"/> </goodsDiscount> </actionResults> <externalConditions> <ExternalCardsCondition providerName="ru.crystals.gold.social.card.plugin"/> </externalConditions> </AdvertisingAction> </AdvertisingActions>
Импорт скидки на товары со сроком годности, близким к истечению <storage-time-condition>
- SR-3610Получение подробных данных проблемы… СТАТУС
- SR-3671Получение подробных данных проблемы… СТАТУС
10.2.80.0
AdvertisingActions/AdvertisingAction/actionResults/goodsDiscount/storage-time-condition | ||||
Наименование атрибута | Тип данных | Описание | Обязательное | |
exclude-manually-added-positions | Boolean | Флаг: не учитывать товары, добавленные вручную | Нет | |
Наименование элемента | Тип данных | Описание | Обязательное | |
---|---|---|---|---|
period | Комплексный | Временной период, определяющий значения "от" и "до" | Да | |
period-type | Комплексный | Тип периода
| Да | |
units-from | Integer | Значение "от" | Нет | |
units-till | Integer | Значение "до" | Да |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <AdvertisingActions> <AdvertisingAction AdvertActGUID="3434545" name="Срок годности" active="true" mode="unconditional" priority="4736.0" ignoreRestrictions="false" worksAnyTime="true" color="blue" external-code="EXT39248" deleted="false" discountType="5" disableChargeOnBonuses="false"> <begin-date>2020-04-30T00:00:00.000</begin-date> <end-date>2020-04-30T23:59:59.999</end-date> <actionResults> <goodsDiscount name="Новая скидка на товары 1" calcWeightProductCountAsOne="false" maxQuantity="1.0" discountPercent="20.0"> <for-all-goods>false</for-all-goods> <marking-of-the-good id="45034"/> <storage-time-condition exclude-manually-added-positions="true"> <period period-type="HOURS" units-from="12" units-till="24"/> </storage-time-condition> </goodsDiscount> </actionResults> <externalConditions/> </AdvertisingAction> </AdvertisingActions>
Скидки на чек <calculation>
В рамках одной рекламной акции можно использовать только одну скидку на чек в акции, сочетать этот тип скидки с остальными нельзя
AdvertisingActions/AdvertisingAction/actionResults/calculation | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
value-type | String | Тип скидки на чек из списка ниже
| Да |
value | Decimal | Значение, дополняющее тип скидки
| Да |
secondary-value | String | Дополнительное значение для плагинов скидок: Только для принципа вычисления = PAYMENT_TYPE_PERCENT и содержит название типа оплаты, от размера которого и считать скидку. Например, если значение этого атрибута BankCardPaymentEntity, и при покупке использовали 50 рублей оплаты по банковской карте и еще 800 - другие типы оплат, то скидка будет считаться только от 50 рублей) Типы оплат:
Ещё используется для хранения значения флага "Учитывать оптовое ограничение": также применяется только если принцип вычисления = EXTERNAL_LOYALTY и Список процессингов /standalone/configuration/modules/external-systems-manager/service-providers.xml | Нет |
Правила предоставления скидок в зависимости от суммы оплаты <calculation-rule>
Страница является частью статьи Импорт рекламных акций из ERP в SetRetail10 глава Правила предоставления скидок в зависимости от суммы оплаты <calculation-rule>.
- SR-5269Получение подробных данных проблемы… СТАТУС
- CR-6270Получение подробных данных проблемы… СТАТУС
10.3.6.0
AdvertisingActions/AdvertisingAction/actionResults/calculation/calculation-rule | ||||
Наименование атрибута | Тип данных | Описание | Обязательное | |
percent | Decimal | Процент от суммы оплаты соответствующим типом, что надо применить в виде скидки | Да | |
Наименование элемента | Тип данных | Описание | Обязательно | |
condition | Комплексный | Условие срабатывания данного правила | Да | |
min | Long | Начальная граница интервала включительно. NULL распознается как "минус бесконечность" | Нет | |
max | Long | Конечная граница интервала исключительно (интервал справа - открыт). NULL распознается как "плюс бесконечность" | Нет |
<?xml version="1.0" encoding="utf-8"?> <AdvertisingActions> <AdvertisingAction AdvertActGUID="6665269" name="SR-5269 скидка в размере процента от оплаты" active="true" mode="unconditional" priority="2000.0" ignoreRestrictions="false" worksAnyTime="false" color="green" external-code="SR-5269-01" deleted="false" disableChargeOnBonuses="false"> <begin-date>2021-03-13T00:00:00.000</begin-date> <end-date>2021-04-13T00:00:00.000</end-date> <actionResults> <calculation value-type="PAYMENT_TYPE_PERCENT" secondary-value="BankCardPaymentEntity"> <calculation-rule percent="6" > <condition min="10000" max="20000"/> </calculation-rule> </calculation> </actionResults> <externalConditions/> </AdvertisingAction> </AdvertisingActions>
Бонусы как скидка <bonus-discount>
Информация об этой функциональности входит в состав страницы Импорт рекламных акций из ERP в SetRetail10 глава Бонусы как скидка <bonus-discount>.
- SR-5172Получение подробных данных проблемы… СТАТУС
- CR-6207Получение подробных данных проблемы… СТАТУС
10.3.6.0
Пример XML:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <AdvertisingActions> <AdvertisingAction AdvertActGUID="77388" name="test155" active="true" mode="automatic" priority="1000077.0" ignoreRestrictions="false" worksAnyTime="true" color="blue" external-code="SR10_74787" deleted="false" discountType="30" disableChargeOnBonuses="false"> <begin-date>2021-11-23T11:20:59.626</begin-date> <end-date>2200-12-31T23:32:23.310</end-date> <actionResults> <bonus-discount max-percent="66.0" type="BONUS_SR10"> <for-all-goods>false</for-all-goods> <goodsGroup name="Список продуктов"> <marking-of-the-good id="00000"/> <marking-of-the-good id="00002"/> </goodsGroup> <marking-of-the-good>184196_ST</marking-of-the-good> <marking-of-the-good>184197_ST</marking-of-the-good> <group id="32"/> <sale-group>24</sale-group> <manufacturer>0000102305</manufacturer> <department>363</department> <country>RU</country> <product-type>ProductPieceEntity</product-type> <composite> <group id="321303"/> <manufacturer>0000100290</manufacturer> <country>RU</country> <name>Составной объект</name> </composite> <exclude> <goodsGroup name="писок продуктов"> <marking-of-the-good id="00000"/> <marking-of-the-good id="00002"/> </goodsGroup> <goodsGroup name="Хлеб (Россия)"/> <group id="32"/> <sale-group>24</sale-group> <manufacturer>0000100633</manufacturer> <department>1</department> <country>88</country> <product-type>ProductCFTGiftCardEntity</product-type> <composite> <group id="GRP_777"/> <manufacturer>0000100290</manufacturer> <country>49</country> <name>состав исключения</name> </composite> </exclude> </bonus-discount> </actionResults> <externalConditions> <InternalCardsCondition anyCard="false" guid="40122017"/> </externalConditions> </AdvertisingAction> </AdvertisingActions>
Индивидуальные потолки списания бонусов на товары <discount-restriction>
- CR-7273Получение подробных данных проблемы… СТАТУС
10.3.10.0
AdvertisingActions/AdvertisingAction/actionResults/bonus-discount/discount-restriction | ||||
Наименование атрибута | Тип данных | Описание | Обязательное | |
max-percent | Double | Максимальный процент скидки бонусами на товары, входящие в фильтр. | Да | |
Наименование элемента | Тип данных | Описание | Обязательное | |
goods-filterGroup Данный атрибут не указывается в XML-сообщении. Он определяет группу элементов на схеме. | Группа элементов, описывающая товарный фильтр. Составной объект, возможность задать в условиях сразу Страну, Производителя и Товарную группу таким образом, чтобы под условие акции попадали только товары из пересечения этих множеств, а не из объединения (описание составного объекта представлено в таблице раздела). | Нет | ||
marking-of-the-good | Комплексный | Товар Задает множество товаров, на которые воздействует РА, по списку артикулов этих товаров
| Нет | |
goodsGroup | Комплексный | Группы товаров Определяет список товаров внутри акции, на которые воздействует РА.
| Нет | |
group | String | Код товарной группы Товарная группа, на которую воздействует РА | Нет | |
sale-group | String | Код группы продаж Список идентификаторов (кодов) групп продаж, на товары из которых воздействует РА | Нет | |
manufacturer | String | Код производителя Код производителя, на товары которого воздействует РА | Нет | |
department | String | Номер отдела Номер отдела, на товары из которого воздействует РА | Нет | |
country | String | Код страны (по ISO 3166-1 alpha-3) | Нет | |
product-type | String | Тип товара Тип товара, на который воздействует РА | Нет | |
composite | Комплексный | Составной объект Данный фильтр имеет приоритет перед группой фильтров "goods-filterGroup" и флагом "for-all-goods": если товар удовлетворяет фильтру "exclude", то в выборку он не попадает - не зависимо от значения флага "for-all-goods", либо значений фильтров группы "goods-filterGroup" | Нет | |
name | Комплексный | Название составного объекта | Нет |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <AdvertisingActions> <AdvertisingAction AdvertActGUID="6665270" name="SR-5458 Индивидуальные потолки списания бонусов на товары" active="true" mode="unconditional" priority="2000.0" ignoreRestrictions="false" worksAnyTime="false" color="green" external-code="SR-5458" deleted="false" disableChargeOnBonuses="false"> <begin-date>2021-03-13T00:00:00.000</begin-date> <end-date>2021-04-13T00:00:00.000</end-date> <actionResults> <bonus-discount max-percent="95.0" position-max-percent="10.0" type="BONUS_SR10"> <for-all-goods>false</for-all-goods> <goodsGroup name="Список продуктов"> <marking-of-the-good id="00004"/> <marking-of-the-good id="22334456"/> <marking-of-the-good id="00005"/> <marking-of-the-good id="202444"/> </goodsGroup> <group id="32"/> <sale-group>24</sale-group> <manufacturer>0000102305</manufacturer> <department>363</department> <country>RU</country> <product-type>ProductPieceEntity</product-type> <composite> <group id="321303"/> <manufacturer>0000100290</manufacturer> <country>RU</country> <name>Составной объект</name> </composite> <exclude> <goodsGroup name="Список продуктов"> <marking-of-the-good id="00000"/> <marking-of-the-good id="00002"/> </goodsGroup> </exclude> <discount-restriction max-percent="33.0"> <marking-of-the-good id="202444"/> </discount-restriction> <discount-restriction max-percent="20.0"> <marking-of-the-good id="00005"/> </discount-restriction> <discount-restriction max-percent="40.0"> <marking-of-the-good id="22334456"/> </discount-restriction> <discount-restriction max-percent="55.0"> <composite> <group id="32"/> <manufacturer>0000102305</manufacturer> <country>RU</country> <name>состав исключения</name> </composite> </discount-restriction> </bonus-discount> </actionResults> <externalConditions/> </AdvertisingAction> </AdvertisingActions>
Счетчик <tokens-discount>
- CR-2932Получение подробных данных проблемы… СТАТУС
10.2.83.0
10.2.84.0
10.2.75.0
AdvertisingActions/AdvertisingAction/actionResults/tokens-discount | ||||
Наименование элемента | Тип данных | Описание | Обязательное | |
productTokensApplyRules | Комплексный | Правила списания за фишки на товар | Нет | |
Наименование атрибута | Тип данных | Описание | Обязательное | |
marking | String | Код товара | Нет | |
Наименование элемента | Тип данных | Описание | Обязательное | |
rules | Комплексный | Правила списания за фишки на товар | Нет | |
Наименование атрибута | Тип данных | Описание | Обязательное | |
tokenCount | Long | Количество фишек | Да | |
price | Double | Цена товара | Да |
Счетчик <counter>
- SLS-261Получение подробных данных проблемы… СТАТУС
-
SLS-256Получение подробных данных проблемы…
СТАТУС
- SLS-259Получение подробных данных проблемы… СТАТУС
10.2.75.0
AdvertisingActions/AdvertisingAction/actionResults/counter | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
metric | Комплексный | Метрика счётчика Возможные значения:
| Да |
indicator | Комплексный | Показатель счётчика Возможные значения:
| Да |
period-value | Integer | Значение периода действия | Да |
period-type | Комплексный | Тип периода действия ограничения Возможные значения:
| Да |
Наименование элемента | Тип данных | Описание | Обязательное |
markings | Список | Коды товаров | Нет |
<?xml version="1.0" encoding="UTF-8"?> <AdvertisingActions> <AdvertisingAction name="Счетчик по сумме чека. Обнуляется раз в 13 недель" active="true" mode="automatic" priority="10" ignoreRestictions="false" worksAnyTime="false" color="red" external-code="SUM_CHEQUE"> <begin-date>2012-12-01T18:00:00</begin-date> <end-date>2050-12-01T18:00:00</end-date> <actionResults> <counter metric="CHEQUES" indicator="SUMM" period-value="13" period-type="WEEKS" /> </actionResults> </AdvertisingAction> <AdvertisingAction name="Счетчик по количеству товаров. Обнуляется раз в 13 недель" active="true" mode="automatic" priority="10" ignoreRestictions="false" worksAnyTime="false" color="red" external-code="ITEMS_COUNT"> <begin-date>2012-12-01T18:00:00</begin-date> <end-date>2050-12-01T18:00:00</end-date> <actionResults> <counter metric="PRODUCTS" indicator="COUNT" period-value="13" period-type="MONTHS"> <markings>777 666 555</markings> </counter> </actionResults> </AdvertisingAction> </AdvertisingActions>
Печать купона <coupon>
Эта страница/секция является составной частью статьи Импорт рекламных акций из ERP в SetRetail10.
- SR-5169Получение подробных данных проблемы… СТАТУС
- CR-6133Получение подробных данных проблемы… СТАТУС
В качестве результата рекламной акции произойдет печать чекового купона (возвратного) в составе чека или в отдельном слипе с штрих-кодом или QR-кодом.
Скидка, которая будет предоставляться по предъявлению напечатанного купона
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:
<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>
Бонусы на счёт <bonus>
- SR-2221Получение подробных данных проблемы… СТАТУС
<?xml version="1.0" encoding="UTF-8"?> <AdvertisingActions> <AdvertisingAction name="SR-2221: Тип - AMOUNTPERCENT" active="true" mode="automatic" priority="10" ignoreRestictions="false" worksAnyTime="false" color="red" AdvertActGUID = "210620181" external-code="SR-2221-AMOUNTPERCENT"> <begin-date>2012-12-01T18:00:00</begin-date> <end-date>2050-12-01T18:00:00</end-date> <!-- Результат РА: AMOUNTPERCENT=процент от суммы --> <actionResults> <bonus type="AMOUNTPERCENT" bonusValue="1000" accountType="SR-2221" accountTypeId="1234" multiplier="1" startAfter="1d" timeToLive="2y"/> </actionResults> </AdvertisingAction> <AdvertisingAction name="SR-2221: Тип - MULTIPLEPERCENT" active="true" mode="automatic" priority="10" ignoreRestictions="false" worksAnyTime="false" color="red" AdvertActGUID = "210620182" external-code="SR-2221-MULTIPLEPERCENT"> <begin-date>2012-12-01T18:00:00</begin-date> <end-date>2050-12-01T18:00:00</end-date> <!-- Результат РА: MULTIPLEPERCENT=процент от кратной величины --> <actionResults> <bonus type="MULTIPLEPERCENT" bonusValue="1000" summa="3000" accountType="SR-2221" accountTypeId="1234" multiplier="1" startAfter="1d" timeToLive="2y"/> </actionResults> </AdvertisingAction> <AdvertisingAction name="SR-2221: Тип - FIXBONUS" active="true" mode="automatic" priority="10" ignoreRestictions="false" worksAnyTime="false" color="red" AdvertActGUID = "210620183" external-code="SR-2221-FIXBONUS"> <begin-date>2012-12-01T18:00:00</begin-date> <end-date>2050-12-01T18:00:00</end-date> <!-- Результат РА: FIXBONUS=фиксированная величина --> <actionResults> <bonus type="FIXBONUS" bonusValue="3000" accountType="SR-2221" accountTypeId="1234" multiplier="1" startAfter="1d" timeToLive="2y"/> </actionResults> </AdvertisingAction> </AdvertisingActions>
Правила начисления бонусов в зависимости от размера оплаты по банковской карте или количества уже начисленных бонусов <bonus-accrual-rule>
- SR-5189Получение подробных данных проблемы… СТАТУС
10.3.5.0
AdvertisingActions/AdvertisingAction/actionResults/bonus/bonus-accrual-rule | ||||
Наименование атрибута | Тип данных | Описание | Обязательное | |
percent | Decimal | Процент от суммы оплаты по банковской карте, что надо вернуть покупателю в виде начисления бонусов По умолчанию = 0 | Нет | |
value | Long | Абсолютное количество бонусов (в бонусо-копейках), которое необходимо начислить по этому правилу | Нет | |
Наименование элемента | Тип данных | Описание | Обязательное | |
condition | Комплексный | Условие срабатывания данного правила начисления бонусов | Нет | |
min | Long | Начальная граница интервала включительно. NULL распознается как "минус бесконечность" | Нет | |
max | Long | Конечная граница интервала исключительно (интервал справа - открыт). NULL распознается как "плюс бесконечность" | Нет |
Правило начисления фишек <tokens-accrual-rule>
- CR-2932Получение подробных данных проблемы… СТАТУС
10.2.83.0
10.2.84.0
AdvertisingActions/AdvertisingAction/actionResults/bonus/tokens-accrual-rule | |||||
Наименование атрибута | Тип данных | Описание | Обязательное | ||
valueType | Список | Тип значения, на которое смотрим в чеке:
| Нет | ||
value | Decimal | Проверяемое правилом значение в шт, кг или руб | Нет | ||
accrualTokens | Long | Количество фишек к начислению за выполнение правила | Нет | ||
maxTokens | Long | Максимальное количество фишек к начислению за выполнение правила | Нет | ||
forAllGoods | Boolean | Нет | |||
excludeNotDiscountable | Boolean | Флаг-признак, что данная скидка не действует на товары с запретом применения скидок. | |||
Наименование элемента | Тип данных | Описание | Обязательное | ||
products | Комплексный | Набор строк определяющий товары/группы продаж/товарные группы с которых начисляем фишки | Нет | ||
Наименование атрибута | Тип данных | Описание | Обязательное | ||
description | String | Название списка товаров | Нет | ||
Наименование атрибута | Тип данных | Описание | Обязательное | ||
group | String | Идентификатор (код) товарной группы | Нет | ||
sale-group | String | Идентификатор (код) группы продаж | Нет | ||
marking | String | Список идентификаторов (артикулов) товаров | Нет | ||
Наименование атрибута | Тип данных | Описание | Обязательное | ||
excluded | String | Набор строк определяющий товары/группы продаж/товарные группы с которых не начисляем фишки | Нет | ||
Наименование элемента | Тип данных | Описание | Обязательное | ||
group | String | Идентификатор (код) товарной группы | Нет | ||
sale-group | String | Идентификатор (код) группы продаж | Нет | ||
marking | String | Список идентификаторов (артикулов) товаров | Нет |
Набор строк определяющий товары/группы продаж/товарные группы с которых не будут начислены бонусные баллы <product-row>
AdvertisingActions/AdvertisingAction/actionResults/bonus/product-row | ||||
Наименование атрибута | Тип данных | Описание | Обязательное | |
description | String | Название списка товаров | Нет | |
Наименование элемента | Тип данных | Описание | Обязательное | |
group | String | Идентификатор (код) ТОВАРНОЙ группы | Нет | |
sale-group | String | Идентификатор (код) группы продаж | Нет | |
marking | String | Список идентификаторов (артикулов) товаров | Нет |
Набор строк, определяющий товары/группы продаж/товарные группы, на которые будут начислены бонусные баллы <accrual-product-row>
- SR-5181Получение подробных данных проблемы… СТАТУС
10.3.5.0
AdvertisingActions/AdvertisingAction/actionResults/bonus/accrual-product-row | |||
---|---|---|---|
Наименование атрибута | Тип данных | Описание | Обязательное |
description | String | Название списка товаров | Нет |
bonusValue | Long | Количество "бонусо-копеек" к начислению. Используется при типе начисления PRODUCTFIXBONUS. | Нет |
Наименование элемента | Тип данных | Описание | Обязательное |
group | String | Идентификатор (код) ТОВАРНОЙ группы | Нет |
sale-group | String | Идентификатор (код) группы продаж | Нет |
marking | String | Список идентификаторов (артикулов) товаров | Нет |
Фильтры механики начисления бонусов <goods-filter-includeAndExcludeGroup>
- CR-6236Получение подробных данных проблемы… СТАТУС
10.3.13.0
Страница является частью статьи Импорт рекламных акций из ERP в SetRetail10 глава Фильтры механики начисления бонусов <goods-filter-includeAndExcludeGroup>.
AdvertisingActions/AdvertisingAction/actionResults/bonus/goods-filter-includeAndExcludeGroup | |||
Описание атрибутов аналогично
|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <AdvertisingActions> <AdvertisingAction AdvertActGUID="210620183" name="SR-5540" active="true" mode="unconditional" priority="10.0" ignoreRestrictions="false" worksAnyTime="false" color="red" external-code="SR-5540" deleted="false"> <begin-date>2012-12-01T18:00:00.000</begin-date> <end-date>2050-12-01T18:00:00.000</end-date> <actionResults> <bonus type="AMOUNTPERCENT" sponsor="BONUS_SR10" bonusValue="1000" summa="0" accountType="SR-5540" accountTypeId="1234" multiplier="1.0" startAfter="1d" timeToLive="2y"> <for-all-goods>false</for-all-goods> <marking-of-the-good id="184195_ST"/> <group id="12346"/> <sale-group>SG4</sale-group> <sale-group>SG5</sale-group> <manufacturer>1235</manufacturer> <department>2</department> <country>AZ</country> <product-type>ProductDiscountCardEntity</product-type> <composite> <manufacturer>1237</manufacturer> <department>3</department> <name>Составной объект 1</name> </composite> <exclude> <marking-of-the-good id="184196_ST"/> <goodsGroup name="Список продуктов"> <marking-of-the-good id="00000"/> <marking-of-the-good id="00002"/> </goodsGroup> <group id="12345"/> <sale-group>SG3</sale-group> <manufacturer>1234</manufacturer> <department>1</department> <country>RU</country> <product-type>ProductSiebelGiftCardEntity</product-type> <composite> <manufacturer>1237</manufacturer> <department>3</department> <name>Составной объект 1</name> </composite> </exclude> </bonus> </actionResults> <externalConditions/> </AdvertisingAction> </AdvertisingActions>
Сообщение кассиру <message>
Страница является частью статьи Импорт рекламных акций из ERP в SetRetail10 глава Сообщение кассиру <message>.
- SR-5486Получение подробных данных проблемы… СТАТУС
- CR-7417Получение подробных данных проблемы… СТАТУС
10.3.13.0
- Хотя бы одно сообщение должно быть задано.
- Если задано "Сообщение на дисплей покупателя", то также должно быть усатановлено "Сообщение на экран кассира".
- На дисплее покупателя может быть отображено максимум две строки по 20 символов. Для разделения строк можно использовать
CDATA
и символ переноса строкиLF (U+000A)
.
AdvertisingActions/AdvertisingAction/actionResults/message | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
time | String/Комлексный | Момент времени (этап технического процесса), когда это сообщение показать. По умолчанию: после "подытога" возможные значения:
| Нет |
message-for-cashier | String | Сообщение на экран кассира (макс. 140 символов) | Нет |
message-for-customer | String | Сообщение на дисплей покупателя (макс. 2 строки по 20 символов) | Нет |
message-for-sco-customer | String | Сообщение на дисплей покупателя КСО (макс. 140 символов) | Нет |
<AdvertisingActions> <AdvertisingAction AdvertActGUID="6665222" name="SR-5486 Импорт/экспорт РА с результатом 'Сообщение кассиру'" active="true" mode="unconditional" priority="2000.0" ignoreRestrictions="false" worksAnyTime="true" color="green" external-code="SR-5486" deleted="false"> <begin-date>2021-06-13T00:00:00.000</begin-date> <end-date>2100-06-13T00:00:00.000</end-date> <actionResults> <message time="AFTER_SUBTOTAL"> <message-for-cashier><![CDATA[Сообщение кассиру]]></message-for-cashier> <message-for-customer><![CDATA[Сообщение покупателю]]></message-for-customer> <message-for-sco-customer><![CDATA[Сообщение покупателю КСО]]></message-for-sco-customer> </message> </actionResults> <externalConditions/> </AdvertisingAction> </AdvertisingActions>
Сообщение/Информирование как результат <notification>
Online-информирование: сообщения, что надо показать кассиру и покупателю <online-notification>
AdvertisingActions/AdvertisingAction/actionResults/notification/online-notification | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
time | String/Комплексный | Момент времени (этап техпроцесса), когда это сообщение показать. По умолчанию: после "подытога" возможные значения:
| Нет |
Наименование элемента | Тип данных | Описание | Обязательное |
message-for-customer | String | Сообщение на дисплей покупателя | Нет |
message-for-cashier | String | Сообщение на экран кассира | Нет |
Сообщение на чеке <slip-content>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <AdvertisingActions> <AdvertisingAction AdvertActGUID="1052744" name="TESTRA1" active="true" mode="automatic" priority="1010.0" ignoreRestictions="false" worksAnyTime="true" color="yellow" external-code="TEST_A014" deleted="false" discountType="38"> <begin-date>2018-06-19T00:00:00.000</begin-date> <end-date>2018-09-25T23:59:59.999</end-date> <actionResults> <set name="Набор-условие"> <row groupName="CD-ROMS" requiedQuantity="1.0" discountPercent="0.0"> <marking-of-the-good id="1"/> <marking-of-the-good id="2"/> <marking-of-the-good id="3"/> <marking-of-the-good id="4"/> </row> </set> <notification> <slip-content>##double_height####center##Test Message! TEST_A014 Left text ##right##Right text </slip-content> <calculator xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="receipt-sum-preferences-calculatorType" id="" divider="1" multiplier="1"/> </notification> </actionResults> <externalConditions> <purchaseAmount greater-than="1000.0"/> </externalConditions> </AdvertisingAction> </AdvertisingActions>
Вычислитель количества "преференций" (наклеек, "смурфиков", "волчков"), что получит покупатель <calculator>
AdvertisingActions/AdvertisingAction/actionResults/notification/calculator | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
type | String | Тип калькулятора: receipt-sum-preferences-calculatorType - Данный механизм "вычислитель" определяет количество "преференций" на основе суммы чека sum-based-preferences-calculatorType - Данный "вычислитель" определяет количество "преференций" на основе суммы стоимостей позиций, удовлетворяющих определенным условиям (условиям выборки): по принадлежности товарной группе, группе продаж, имеющих определенные артикулы quantity-based-preferences-calculatorType - Данный "вычислитель" определяет количество "преференций" на основе количества позиций | Да |
id | String | Идентификатор данного "вычислятора"/"условия" предоставления подарков/"преференций". Должен быть уникален в рамках РА. | Нет |
divider | Integer | Делимое при вычислении | Да |
multiplier | Integer | множитель при вычислении | Нет |
limit | Integer | Максимальное количество "сообщений"/"наклеек", что можно получить в рамках ДАННОГО УСЛОВИЯ (данного вычислителя) данной РА. Отсутствие данного атрибута распознается как отсутствие лимита. | Нет |
checkDiscountableFlag | Boolean | Проверять или нет товарное свойство "Расчет скидок на товар запрещен" при расчете количества преференций данного типа. | Нет |
Все "вычислители" определяют количество "преференций" по одному и тому же правилу result = sum / divider * multiplier
, где:
- sum - это некоторая сумма (чего-то - зависит от конкретной реализации "вычислитель": например, общая сумма чека, либо количество товаров из определенной группы продаж)
- divider - делимое. Деление целочисленное!
- multiplier - множитель.
Калькулятор Количества "преференций" на основе суммы чека (receipt-sum-preferences-calculatorType)
AdvertisingActions/AdvertisingAction/actionResults/notification/calculator | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
xsi:type | String | receipt-sum-preferences-calculatorType | Да |
id | String | Идентификатор данного "вычислителя"/"условия" предоставления подарков/"преференций". Должен быть уникален в рамках РА. | Нет |
divider | Integer | Делимое при вычислении | Да |
multiplier | Integer | множитель при вычислении | Нет |
limit | Integer | Максимальное количество "сообщений"/"наклеек", что можно получить в рамках ДАННОГО УСЛОВИЯ (данного вычислителя) данной РА. Отсутствие данного атрибута распознается как отсутствие лимита. | Нет |
checkDiscountableFlag | Boolean | Проверять или нет товарное свойство "Расчет скидок на товар запрещен" при расчете количества преференций данного типа. | Нет |
Калькулятор по сумме позиций (sum-based-preferences-calculatorType)
AdvertisingActions/AdvertisingAction/actionResults/notification/calculator | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
xsi:type | String | sum-based-preferences-calculatorType | Да |
id | String | Идентификатор данного "вычислителя"/"условия" предоставления подарков/"преференций". Должен быть уникален в рамках РА. | Нет |
divider | Integer | Делимое при вычислении | Да |
multiplier | Integer | Множитель при вычислении | Нет |
limit | Integer | Максимальное количество "сообщений"/"наклеек", что можно получить в рамках ДАННОГО УСЛОВИЯ (данного вычислителя) данной РА. Отсутствие данного атрибута распознается как отсутствие лимита. | Нет |
checkDiscountableFlag | Boolean | Проверять или нет товарное свойство "Расчет скидок на товар запрещен" при расчете количества преференций данного типа. | Нет |
Наименование элемента | Тип данных | Описание | Обязательное |
goods-filter | Комплексный | Группа элементов, описывающая товарный фильтр | Нет |
group | String | Идентификатор товарной группы | Нет |
sale-group | String | Список идентификаторов (кодов) групп продаж, товары из которых удовлетворяют данному фильтру | Нет |
marking | String | Список идентификаторов (артикулов) товаров, что участвуют при вычислении количества "преференций". | Нет |
<!-- 1 наклейка за каждые 100 руб. печенья (арт.: 026441_ST), но не более 4 --> <calculator xsi:type="sum-based-preferences-calculatorType" divider="10000" multiplier="1" limit="4"> <marking>026441_ST</marking> </calculator>
Калькулятор по количеству товаров в позициях (quantity-based-preferences-calculatorType)
AdvertisingActions/AdvertisingAction/actionResults/notification/calculator | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
xsi:type | String | quantity-based-preferences-calculatorType | Да |
id | String | Идентификатор данного "вычислителя"/"условия" предоставления подарков/"преференций". Должен быть уникален в рамках РА. | Нет |
divider | Integer | Делимое при вычислении | Да |
multiplier | Integer | Множитель при вычислении | Нет |
limit | Integer | Максимальное количество "сообщений"/"наклеек", что можно получить в рамках ДАННОГО УСЛОВИЯ (данного вычислителя) данной РА. Отсутствие данного атрибута распознается как отсутствие лимита. | Нет |
checkDiscountableFlag | Boolean | Проверять или нет товарное свойство "Расчет скидок на товар запрещен" при расчете количества преференций данного типа. | Нет |
Наименование элемента | Тип данных | Описание | Обязательное |
goods-filter | Комплексный | Группа элементов, описывающая товарный фильтр | Нет |
group | String | Идентификатор товарной группы | Нет |
sale-group | String | Список идентификаторов (кодов) групп продаж, товары из которых удовлетворяют данному фильтру | Нет |
marking | String | Список идентификаторов (артикулов) товаров, что участвуют при вычислении количества "преференций". | Нет |
<!-- 1 наклейка за каждые 8 тульских пряников (арт.: 184196_ST), но не более 3 --------------------------------------------------------------------> <calculator xsi:type="quantity-based-preferences-calculatorType" divider="8000" multiplier="1" limit="3"> <marking>184196_ST</marking> </calculator>
Необходимость сканирования на кассе штрих-кода <validation>
<?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>
Ограничение выдачи подарков по клиенту <action-restriction>
AdvertisingActions/AdvertisingAction/actionResults/notification/action-restriction | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
max-value | Integer | Значение ограничения | Да |
Ограничение выдачи подарков по акции <client-restriction>
AdvertisingActions/AdvertisingAction/actionResults/notification/client-restriction | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
max-value | Integer | Значение ограничения | Да |
restriction-period-type | String | Тип периода действия ограничения
| Нет |
period | Integer | Значение периода действия | Нет |
Предложение по добавлению товара в чек <productOffer>
AdvertisingActions/AdvertisingAction/actionResults/notification/client-restriction | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
marking | String | Артикул товара | Да |
quantity | Long | Количество товара в позиции, в "граммах" (т.е., 1000 = 1 кг. (для весового товара) и 1000 = 1 шт. (для штучного товара)) | Нет |
Условия срабатывания рекламных акций <externalConditions>
В одной рекламной акции может быть сразу несколько условий срабатывания, такая акция срабатывает в случае соблюдения всех заданных условий. Если условия не заданы – акция будет безусловной и работать для всех покупателей.
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 | Комплексный | Условие срабатывания РА "Счётчик срабатывания" - SLS-270Получение подробных данных проблемы… СТАТУС 10.2.75.0 | Нет |
external-system-resolution-condition | Комплексный | Условие срабатывания РА: "определяет внешняя система". - SR-3206Получение подробных данных проблемы… СТАТУС 10.2.72.0 | Нет |
discount-sum-condition | Комплексный | Условие срабатывания РА: "Сумма скидки по РА" - SLS-369Получение подробных данных проблемы… СТАТУС 10.2.78.0 | Нет |
bank-loyalty-code-condition | Комплексный | Код (или коды через запятую) программы лояльности, передаваемый в свойствах оплаты через терминал. - SR-2891Получение подробных данных проблемы… СТАТУС - CR-2003Получение подробных данных проблемы… СТАТУС - CR-2850Получение подробных данных проблемы… СТАТУС 10.2.97.0 | Нет |
external-coupon-condition | Комплексный | Условие срабатывания РА: "Наличие внешнего купона" - SR-4758Получение подробных данных проблемы… СТАТУС - CR-5557Получение подробных данных проблемы… СТАТУС 10.2.98.0 | |
loyalty-level-condition | Комплексный | Условие срабатывания РА: "Уровень программы лояльности клиента" для модуля "Покупатели". - SLS-1480Получение подробных данных проблемы… СТАТУС 10.3.10.0 | Нет |
<externalConditions> <country-condition> <condition country-code="GER" count-condition-type="LESS" count="44.879"/> <condition country-code="SWE"/> </country-condition> <manufacturer-condition> <condition manufacturer-code="31" /> <condition manufacturer-code="21" count-condition-type="EQUAL" count="138.63"/> </manufacturer-condition> <depart-condition> <condition depart-number="84"/> <condition depart-number="46" count-condition-type="LESS" count="66.6"/> </depart-condition> <goods-count-condition count-condition-type="MORE" count="13.49" rang="2.0"/> <group-condition with-or="false"> <condition group-code="5555" count-condition-type="EQUAL" count="1235.082" unique-goods="true" sum-condition-type="LESS" sum="14.66"/> <condition group-code="444" /> </group-condition> <sale-group-condition with-or="true"> <condition group-code="5"/> <condition group-code="4" count-condition-type="LESS" count="1.1" unique-goods="true" sum-condition-type="LESS" sum="876.68"/> </sale-group-condition> </externalConditions>
Наличие внутренней дисконтной карты из определенной категории <InternalCardsCondition>
AdvertisingActions/AdvertisingAction/externalConditions/InternalCardsCondition | ||||
Наименование атрибута | Размер | Тип данных | Описание | Обязательное |
guid | 128 | String | Guid категории карт в SR10 | Да |
anyCard | Boolean | Флаг-признак: сойдет ли любая внутренняя карта для срабатывания этой РА | ||
without-card | Boolean | Флаг-признак: «без карты» — то есть, данное условие срабатывания рекламной акции будет выполнено/удовлетворено если в чеке не была применена никакая внутренняя карта. Cамо значение атрибута не анализируется: достаточно самого факта, что этот атрибут есть |
Наличие внешней карты из определенной категории <ExternalCardsCondition>
<?xml version="1.0" encoding="UTF-8"?> <AdvertisingActions> <AdvertisingAction AdvertActGUID = "444" name="Условие - внешняя карта плагин" active="true" mode="automatic" priority="10.0" ignoreRestrictions="false" worksAnyTime="false" color="red" external-code="666" deleted="false"> <begin-date>2012-12-01T18:00:00.000</begin-date> <end-date>2050-12-01T18:00:00.000</end-date> <actionResults> <calculation value-type = "CATALOG_PRICE" value = "4.0" secondary-value=""/> </actionResults> <externalConditions> <ExternalCardsCondition providerName="ru.crystals.plugins.card.loymax"/> </externalConditions> </AdvertisingAction> </AdvertisingActions>
Период действия внутри суток <HoursActionCondition>
AdvertisingActions/AdvertisingAction/externalConditions/HoursActionCondition | ||||
Наименование атрибута | Размер | Тип данных | Описание | Обязательное |
timeStart | 5 | String | Начало периода действия в формате: | Да |
timeEnd | 5 | String | Окончание периода действия в формате: | Да |
Дни недели действия акции <DaysActionCondition>
AdvertisingActions/AdvertisingAction/externalConditions/DaysActionCondition | ||||
Наименование атрибута | Размер | Тип данных | Описание | Обязательное |
value | 20 | String | Указываются дни списком через пробел "MO TU WE TH FR SA SU» | Да |
Наличие купона из определенной категории <CouponsCondition>
AdvertisingActions/AdvertisingAction/externalConditions/CouponsCondition | ||||
Наименование атрибута | Размер | Тип данных | Описание | Обязательное |
guid | 128 | String | guid категории купонов в SetRetail10 Для того, чтобы узнать guid созданный категорий купонов, выполните скрипт в базе данных set на сервере SetRetail/SetCentrumSELECT guid, name FROM card_cardtype left outer join card_coupons ON card_cardtype.id = card_coupons.id WHERE card_coupons.id IS NOT NULL ORDER BY guid ASC Также посмотреть guid купона можно в строке адреса просомтра карточки категории через визуализацию сервера: | Да |
number | 32 | String | Номер купона, который нужно применить для работы акции | Нет |
Наличие купона из определенной категории <coupons-filter-condition>
-
SR-5925Получение подробных данных проблемы…
СТАТУС
- SR-5923Получение подробных данных проблемы… СТАТУС
- CR-8944Получение подробных данных проблемы… СТАТУС
10.3.20.0
AdvertisingActions/AdvertisingAction/externalConditions/coupons-filter-condition | ||||
Наименование элемента | Тип данных | Описание | Обязательное | |
or | Комплексный | Или | Нет | |
and | Комлексный | И | Нет | |
not | Комплексный | Кроме | Нет | |
Наименование атрибута | Тип данных | Описание | Обязательное | |
categoryId | Integer | ID-категории купона | Нет | |
number | Integer | Номер купона, который нужно применить для работы акции | Нет |
Условие суммы чека <PurchaseAmount>
AdvertisingActions/AdvertisingAction/externalConditions/PurchaseAmount | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
greater-than | Double | Сумма чека, которую должен превышать чек для срабатывания условия | Нет |
less-than | Double | Сумма чека, меньше которой должен быть чек для срабатывания условия | Нет |
equal-to | Double | Определяет сумму чека, при которой РА может сработать | Нет |
useNominalSum | Boolean | Использовать номинальную сумму чека при расчете условия, в противном случае сумма чека будет рассчитываться как сумма позиций участвующих в расчете скидок.
Данная настройка соответствует флажку в карточке рекламной акции Условия → Сумма чека → ПО ЧЕКУ → Учитывать стоимость товаров, на которые запрещен расчет скидок. | Нет |
useSoftCheckSum | Boolean | Учитывать только стоимость товаров из мягкого чека
10.3.4.0 | Нет |
plugin-id | String | Идентификатор плагина в рамках РА | Нет |
Условие на день рождения <birthday-condition>
AdvertisingActions/AdvertisingAction/externalConditions/birthday-condition | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
days-before | nonNegativeInteger | Количество дней до дня рождения клиента. По умолчанию — 0 | Нет |
days-after | nonNegativeInteger | Количество дней после дня рождения клиента. По умолчанию – 0 | Нет Если не указаны оба параметра, или оба = 0, акция работает только в день рождения клиента |
Условие на возраст покупателя <age-condition>
AdvertisingActions/AdvertisingAction/externalConditions/age-condition | ||||
Наименование элемента | Тип данных | Описание | Обязательное | |
age-conditionи | Комплексный | Список условий возрастных ограничений | Нет | |
age-interval | Комплексный | Интервалы возрастов | Да | |
Наименование атрибута | Тип данных | Описание | Обязательное | |
left | Integer | Начало интервала. Если отсутствует, то интервал открыт слева (т.е., распознается как интервал начинающийся в минус бесконечности) | Нет | |
right | Integer | Окончание интервала. Если отсутствует, то интервал открыт справа (т.е., распознается как интервал заканчивающийся в плюс бесконечности) | Нет |
Условие срабатывания РА: решает SAP CRM <choose-external-system>
AdvertisingActions/AdvertisingAction/externalConditions/choose-external-system | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
enabled | Boolean | Флаг-признак включения. Если присутствует тег, то включено даже без параметра. | Нет |
Условие заполненности анкеты покупателя <completed-profile-condition>
AdvertisingActions/AdvertisingAction/externalConditions/completed-profile-condition | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
expected-profile-status | Boolean | Ожидаемый статус заполненности анкеты для работы акции. True – анкета должна быть заполнена, False – анкета не заполнена | Да |
Условие срабатывания РА: по типу оплаты <payment-type>
Номера касс, на которых должна работать рекламная акция <cash-nums>
AdvertisingActions/AdvertisingAction/externalConditions/cash-nums | |||
Наименование элемента | Тип данных | Описание | Обязательное |
includes | String | Номера касс, на которых должна работать акция (перечисление через, или) | Нет |
excludes | String | Номера касс, на которых не должна работать акция (перечисление через, или). На остальных кассах акция будет работать | Нет Должен быть указан один из параметров |
Условие срабатывания по удовлетворению владельца карты условий вхождения в сегмент <segment-condition>
AdvertisingActions/AdvertisingAction/externalConditions/segment-condition | |||||
segment-orand-only-filterGroup Группа позволяет использование только одного условия фильтрации типа "И" или "ИЛИ" в элементе | |||||
Наименование элемента | Тип данных | Описание | Обязательное | ||
or | Комплексный | Условие добавления сегментов по «или», т.е. для срабатывания клиент должен находится в любом из указанных сегментов | Да | ||
internal-segment-conditionfilterGroup Способ описания "внутренних" ("вложенных" во внешний элемент типа ИЛИ, И, или КРОМЕ) множеств сегментов | |||||
Наименование элемента | Тип данных | Описание | Обязательное | ||
segment | Комплексный | Самый простой и базовый способ определения множества сегментов: перечислением их по GUID'ам. Сам список будет определять объединение сегментов (логическое ИЛИ). | Да | ||
guid | String | GUID сегмента | Да | ||
internal-segment-non-flat-condition-filterGroup Группа элементов, описавыющая "сегментное множество", в которое должен попадать картоносец для удовлетворения условию срабатывания рекламных акций Разрешается заполнять только один из нижеперечисленных элементов | |||||
or | Комплексный | Сегменты, вложенные в этот элемент, взаимодействуют по логическому "ИЛИ" (объединение сегментов) <segment-condition> <or> <segment guid="A" /> <segment guid="B" /> </or> </segment-condition> | Нет | ||
and | Комплексный | Сегменты, вложенные в этот элемент, взаимодействуют по логическому "И" (пересечение сегментов) <segment-condition> <and> <segment guid="A" /> <segment guid="B" /> </and> </segment-condition> | Нет | ||
not | Комплексный | Данный элемент добавляет логическое отрицание множества сегментов в него "вложенного". <segment-condition> <not> <segment guid="A" /> <segment guid="B" /> </not> </segment-condition> | Нет | ||
and | Комплексный | Условие добавления сегментов по «и», т.е. для срабатывания клиент должен находиться во всех указанных сегментах. | Да | ||
internal-segment-conditionfilterGroup Способ описания "внутренних" ("вложенных" во внешний элемент типа ИЛИ, И, или КРОМЕ) множеств сегментов | |||||
Наименование элемента | Тип данных | Описание | Обязательное | ||
segment | Комплексный | Самый простой и базовый способ определения множества сегментов: перечислением их по GUID'ам. Сам список будет определять объединение сегментов (логическое ИЛИ). | Да | ||
guid | String | GUID сегмента | Да | ||
internal-segment-non-flat-condition-filterGroup Группа элементов, описывающая "сегментное множество", в которое должен попадать картоносец для удовлетворения условию срабатывания рекламных акций Разрешается заполнять только один из ниже-перечисленных элементов | |||||
or | Комплексный | Сегменты, вложенные в этот элемент, взаимодействуют по логическому "ИЛИ" (объединение сегментов) <segment-condition> <or> <segment guid="A" /> <segment guid="B" /> </or> </segment-condition> | Нет | ||
and | Комплексный | Сегменты, вложенные в этот элемент, взаимодействуют по логическому "И" (пересечение сегментов) <segment-condition> <and> <segment guid="A" /> <segment guid="B" /> </and> </segment-condition> | Нет | ||
not | Комплексный | Данный элемент добавляет логическое отрицание множества сегментов в него "вложенного". <segment-condition> <not> <segment guid="A" /> <segment guid="B" /> </not> </segment-condition> | Нет |
<segment-condition> <or> <and> <segment guid=”A” /> <segment guid=”B” /> </and> <not> <and> <segment guid=”C” /> <segment guid=”D” /> </and> </not> </or> </segment-condition>
Клиент <client-guid-condition>
AdvertisingActions/AdvertisingAction/externalConditions/client-guid-condition | ||||
Наименование элемента | Тип данных | Описание | Обязательное | |
suffixes | Комплексный | Список окончаний кодов клиентов | Нет | |
condition | Комплексный | Тип условия:
| Нет | |
suffix | Комплексный | Окончание | Нет |
Страна производитель <country-condition>
- SR-2961Получение подробных данных проблемы… СТАТУС
AdvertisingAction/externalConditions/country-condition | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
country-code | String | Код страны | Да |
count-condition-type | Комплексный | Тип условия по кол-ву товаров
| Нет |
count | Double | Количество товаров | Нет |
Производитель <manufacturer-condition>
- SR-2962Получение подробных данных проблемы… СТАТУС
AdvertisingAction/externalConditions/manufacturer-condition | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
manufacturer-code | String | Код производителя | Да |
count-condition-type | Комплексный | Тип условия по кол-ву товаров
| Нет |
count | Double | Количество товаров | Нет |
Отдел <depart-condition>
- SR-2965Получение подробных данных проблемы… СТАТУС
AdvertisingAction/externalConditions/depart-condition | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
depart-number | Long | Номер отдела | Да |
count-condition-type | Комплексный | Тип условия по кол-ву товаров
| Нет |
count | Double | Количество товаров | Нет |
Количество товаров <goods-count-condition>
- SR-2967Получение подробных данных проблемы… СТАТУС
AdvertisingAction/externalConditions/goods-count-condition | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
count-condition-type | Комплексный | Тип условия по кол-ву товаров
| Да |
count | Double | Количество товаров | Да |
rang | Double | Кратность | Нет |
Товарная группа <group-condition>
- SR-2968Получение подробных данных проблемы… СТАТУС
AdvertisingAction/externalConditions/group-condition | ||||
Наименование атрибута | Тип данных | Описание | Обязательное | |
with-or | Boolean | Флаг: срабатывание акции при наличии в чеке любой из групп | Нет | |
Наименование элемента | Тип данных | Описание | Обязательное | |
condition | Комплексный | Условия по группам продаж | Да | |
Наименование атрибута | Тип данных | Описание | Обязательное | |
group-code | String | Код группы | Да | |
count-condition-type | Комплексный | Тип условия по кол-ву товаров
| Нет | |
count | Double | Условие по количеству товаров = число | Нет | |
unique-goods | Boolean | Количество уникальных товаров (срабатывание акции при наличии разных товаров из группы) | Нет | |
sum-condition-type | Комплексный | Условие общей стоимости товаров:
| Нет | |
sum | Double | Условие общей стоимости товаров = число | Нет |
Группа продаж <sale-group-condition>
AdvertisingAction/externalConditions/sale-group-condition | ||||
Наименование атрибута | Тип данных | Описание | Обязательное | |
with-or | Boolean | Флаг: срабатывание акции при наличии в чеке любой из групп | Нет | |
Наименование элемента | Тип данных | Описание | Обязательное | |
condition | Комплексный | Условия по группам продаж | Да | |
Наименование атрибута | Тип данных | Описание | Обязательное | |
group-code | String | Код группы | Да | |
count-condition-type | Комплексный | Тип условия по кол-ву товаров
| Нет | |
count | Double | Условие по количеству товаров = число | Нет | |
unique-goods | Boolean | Количество уникальных товаров (срабатывание акции при наличии разных товаров из группы) | Нет | |
sum-condition-type | Комплексный | Условие общей стоимости товаров:
| Нет | |
sum | Double | Условие общей стоимости товаров = число | Нет |
Импорт ограничения срабатывания рекламной акции <action-results-quantity-condition>
- SLS-218Получение подробных данных проблемы… СТАТУС
Начиная с версии 10.2.67.0 есть возможность загружать рекламные акций из внешних систем с ограничениями срабатывания
Данные для импорта:
- количество срабатывания для клиента
- период срабатывания для клиента {дней/недель/месяцев/весь период действия акции}
- максимальное количество по всей акции
AdvertisingAction/externalConditions/action-results-quantity-condition | ||||
Наименование атрибута | Тип данных | Описание | Обязательное | |
---|---|---|---|---|
allowOffline | Boolean | Предоставлять преференцию при отсутствии связи с сервером ограничений | Нет | |
plugin-id | String | Название плагина лояльности | Нет | |
Наименование элемента | Тип данных | Описание | Обязательное | |
action-restriction | Комплексный | Ограничение срабатывания РА всего | Нет | |
max-value | integer | Максимальное количество срабатывания РА всего | Да | |
client-restriction | Комплексный | Ограничение срабатывания РА по клиенту | Нет | |
max-value | integer | Максимальное количество срабатывания РА по клиенту | Да | |
restriction-period-type | Тип периода действия ограничения. Значение по умолчанию - DAYS
Параметры HOURS и MINUTES добавлены, начиная с версии 10.3.14.0. | Нет | ||
period | integer | Значение периода действия. Если это значение не указано, то считается, что ограничение по клиенту действует весь период действия акции. | Нет |
<?xml version="1.0" encoding="utf-8"?> <AdvertisingActions> <AdvertisingAction name="РА" active="true" mode="automatic" priority="1000" ignoreRestictions="true" worksAnyTime="false" сolor="Red"> <begin-date>2012-02-21T00:00:00Z</begin-date> <end-date>2025-02-20T00:00:00Z</end-date> <externalConditions> <action-results-quantity-condition allowOffline="true"> <action-restriction max-value="12"/> <client-restriction max-value="13" restriction-period-type="DAYS" period="3"/> </action-results-quantity-condition> </externalConditions> <actionResults> <calculation value-type="PERCENT" value = "10"/> </actionResults> </AdvertisingAction> </AdvertisingActions>
Шаблоны касс <cash-template-condition>
AdvertisingActions/AdvertisingAction/externalConditions/cash-template-condition | ||||
Наименование элемента | Тип данных | Описание | Обязательное | |
template-guid | long | GUID шаблонов | Нет |
Счетчик <counter-condition>
- SLS-270Получение подробных данных проблемы… СТАТУС
10.2.75.0
AdvertisingActions/AdvertisingAction/externalConditions/counter-condition | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
counter-id | String | Идентификатор счётчика
| Да |
main-value | Integer | Целевое значение, с которым будет проводиться сравнение текущего значения счётчика для клиента | Да |
second-value | Integer | Второе значение для условия BETWEEN | Если comparison-type = "BETWEEN" |
comparison-type | Комплексный | Оператор сравнения. Возможные значения:
| Да |
include-current-purchase | Boolean | Флаг: С учётом текущей покупки. Работает только для счётчиков с метриками Чеки, Товары и показателем Количество. Если есть необходимость включения этого флага, то нужно гарантировать, чтобы эта акция-условие считалась после акции-счётчиков, которые используются. Акции-счётчики - акции, в которых счётчик создался, их | Нет |
Последовательность импорта
- Акция-условие зависима от акции-счётчика (акция-счётчик является мастером для акции-условие);
- Акция-условие суммируется всегда, а акция-счётчик нет;
- Акция-условие и акция-счётчик находятся на одном уровне, то приоритет у акции-счётчик должен быть выше и они не должны между собой конкурировать по результатам.
Рекомендуется использовать вариант 1, только так гарантируется прозрачная и чёткая последовательность.
<?xml version="1.0" encoding="UTF-8"?> <AdvertisingActions> <AdvertisingAction name="Скидка. Счетчики в условиях" active="true" mode="automatic" priority="10" ignoreRestictions="false" worksAnyTime="false" color="red"> <begin-date>2012-12-01T18:00:00</begin-date> <end-date>2050-12-01T18:00:00</end-date> <externalConditions> <counter-condition counter-id="SUM_CHEQUE" main-value="20000" comparison-type="MORE"/> <counter-condition counter-id="ITEMS_COUNT" main-value="2000" second-value="5000" comparison-type="BETWEEN"/> </externalConditions> <actionResults> <calculation value-type="PERCENT" value="33"/> </actionResults> </AdvertisingAction> </AdvertisingActions>
Определяет внешняя система <external-system-resolution-condition>
- SR-3206Получение подробных данных проблемы… СТАТУС
10.2.72.0
AdvertisingActions/AdvertisingAction/externalConditions/external-system-resolution-condition | |||
Наименование элемента | Тип данных | Описание | Обязательное |
external-system-resolution-condition | Integer | Условие срабатывания РА: "определяет внешняя система". | Нет |
Наименование элемента | Тип данных | Описание | Обязательное |
providerName | String | Идентификатор внешней системы | Да |
<?xml version="1.0" encoding="utf-8"?> <AdvertisingActions> <AdvertisingAction name="SR-3206" active="true" mode="automatic" priority="10000" ignoreRestictions="true" worksAnyTime="false" сolor="Red"> <begin-date>2012-02-21T00:00:00Z</begin-date> <end-date>2025-02-20T00:00:00Z</end-date> <externalConditions> <external-system-resolution-condition> <providerName>ru.crystals.globus.sap.condition.plugin</providerName> </external-system-resolution-condition> </externalConditions> <actionResults> <goodsDiscount name = "10% скидки на бородинский" discountPercent = "10.0"> <!-- Хлеб КАРАВАЙ Бородинский 350 г --> <marking-of-the-good id = "055666_ST" /> </goodsDiscount> <bonus type="DiscountFromCheck" accountType="Глобус"/> </actionResults> </AdvertisingAction> </AdvertisingActions>
Сумма скидки по РА <discount-sum-condition>
10.2.78.0
AdvertisingActions/AdvertisingAction/externalConditions/discount-sum-condition | ||||
Наименование атрибута | Тип данных | Описание | Обязательное | |
---|---|---|---|---|
allowOffline | Boolean | Предоставлять преференцию при отсутствии связи с сервером ограничений | Нет | |
plugin-id | String | Название плагина лояльности | Нет | |
Наименование элемента | Тип данных | Описание | Обязательное | |
action-restriction | Комплексный | Ограничение суммы скидки по акции всего | Нет | |
max-value | integer | Максимальная сумма скидки всего | Да | |
client-restriction | Комплексный | Ограничение суммы скидки для каждого клиента | Нет | |
max-value | integer | Максимальная сумма скидки по клиенту | Да | |
restriction-period-type | Тип периода действия ограничения. Значение по умолчанию - DAYS
Параметры HOURS и MINUTES добавлены, начиная с версии 10.3.14.0. | Нет | ||
period | integer | Значение периода действия. Если это значение не указано, то считается, что ограничение по клиенту действует весь период действия акции. | Да |
<?xml version="1.0" encoding="utf-8"?> <AdvertisingActions> <AdvertisingAction name="Проверка вывода ошибки при применении купон42244а" active="true" mode="automatic" priority="1000" ignoreRestictions="true" worksAnyTime="false" сolor="Red"> <begin-date>2012-02-21T00:00:00Z</begin-date> <end-date>2025-02-20T00:00:00Z</end-date> <externalConditions> <discount-sum-condition allowOffline="true"> <action-restriction max-value="12"/> <client-restriction max-value="13" restriction-period-type="DAYS" period="3"/> </discount-sum-condition> </externalConditions> <actionResults> <calculation value-type="PERCENT" value = "10"/> </actionResults> </AdvertisingAction> </AdvertisingActions>
Код банковской программы лояльности <bank-loyalty-code-condition>
Эта страница/секция является составной частью статьи Импорт рекламных акций из ERP в SetRetail10.
- SR-2891Получение подробных данных проблемы… СТАТУС
- CR-2003Получение подробных данных проблемы… СТАТУС
- CR-2850Получение подробных данных проблемы… СТАТУС
10.2.97.0
Данное условие может сработать только при расчете скидок на прерывании оплаты, как и с результатом Скидка на чек с принципом вычисления процент от суммы оплаты.
AdvertisingActions/AdvertisingAction/externalConditions/bank-loyalty-code-condition | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
loyal-codes | String | Код (или коды через запятую) программы лояльности, передаваемый в свойствах оплаты через терминал. | Да |
<?xml version="1.0" encoding="UTF-8"?> <AdvertisingActions> <AdvertisingAction name="Скидка в зависимости от используемого банковского продукта" active="true" mode="automatic" priority="10" ignoreRestictions="false" worksAnyTime="false" color="red"> <begin-date>2012-12-01T18:00:00</begin-date> <end-date>2050-12-01T18:00:00</end-date> <externalConditions> <bank-loyalty-code-condition loyal-codes="LC1, LC2"/> </externalConditions> <actionResults> <calculation value-type="PAYMENT_TYPE_PERCENT" secondary-value="BankCardPaymentEntity" value="10"/> </actionResults> </AdvertisingAction> </AdvertisingActions>
Условие срабатывания РА: Наличие внешнего купона <external-coupon-condition>
Эта страница/секция является составной частью статьи Импорт рекламных акций из ERP в SetRetail10.
- SR-4758Получение подробных данных проблемы… СТАТУС
- CR-5557Получение подробных данных проблемы… СТАТУС
10.2.98.0
Данное условие позволяет срабатывать рекламной акции при добавлении купона из плагина SetAPI.
- Уникальный идентификатор конкретного плагина необходимо получить у разработчика этого плагина.
- На момент загрузки РА плагин должен быть уже загружен на сервере.
- Если уникальный идентификатор категории купона не задан, то условие будет срабатывать при добавлении любого купона этого плагина.
AdvertisingActions/AdvertisingAction/externalConditions/external-coupon-condition | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
providerName | String | Уникальный идентификатор конкретного плагина | Да |
categoryGuid | Long | Уникальный идентификатор категории купона | Нет |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <AdvertisingActions> <AdvertisingAction AdvertActGUID="69603" name="Условие - внешний купон" active="true" mode="automatic" priority="10" ignoreRestrictions="false" worksAnyTime="false" color="blue" external-code="SR10_69353" deleted="false" discountType="9" disableChargeOnBonuses="false"> <begin-date>2021-05-11T14:56:55.688</begin-date> <end-date>2200-12-31T14:55:08.998</end-date> <actionResults> <calculation value-type="PERCENT" value="50" secondary-value=""/> </actionResults> <externalConditions> <external-coupon-condition> <providerName>set6.card.plugin</providerName> <categoryGuid>101</categoryGuid> </external-coupon-condition> </externalConditions> </AdvertisingAction> </AdvertisingActions>
Условие срабатывания РА: Уровень программы лояльности клиента <loyalty-level-condition>
- SLS-1480Получение подробных данных проблемы… СТАТУС
10.3.10.0
AdvertisingActions/AdvertisingAction/externalConditions/loyalty-level-condition | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
loyalty-level-id | Long | Идентификатор уровня программы лояльности | Да |
plugin-id | String | Идентификатор плагина в рамках РА | Нет |
<AdvertisingActions> <AdvertisingAction name="SLS-1474" active="true" mode="automatic" priority="1000.0" ignoreRestrictions="false" worksAnyTime="false" color="green" external-code="1234567" AdvertActGUID="412741212" deleted="false"> <begin-date>2012-12-01T18:00:00.000</begin-date> <end-date>2050-12-01T18:00:00.000</end-date> <actionResults> <goodsDiscount name="Тест" calcWeightProductCountAsOne="false" maxQuantity="0.0" discountPercent="1.0" conditionCount="3.0"> <for-all-goods>false</for-all-goods> <goodsGroup name="Тест"> <marking-of-the-good id="5"/> </goodsGroup> </goodsDiscount> </actionResults> <externalConditions> <loyalty-level-condition loyalty-level-id="12"/> </externalConditions> </AdvertisingAction> </AdvertisingActions>
Условие срабатывания РА: По решению покупателя <client-decision-condition>
- CR-8110Получение подробных данных проблемы… СТАТУС
10.3.21.0
В случае, если акцию возможно применить к чеку, покупателю будет задан вопрос, хочет ли он воспользоваться данной акцией.
AdvertisingActions/AdvertisingAction/externalConditions/client-decision-condition | |||
Наименование элемента | Тип данных | Описание | Обязательное |
plugin-id | String | Идентификатор плагина | Да |
Наименование элемента | Тип данных | Описание | Обязательное |
messageToCashier | String | Сообщение кассиру | Да |
messageToSCO | String | Сообщение покупателю на кассе самообслуживания | Да |
<AdvertisingActions> <AdvertisingAction AdvertActGUID = "66565902" name="Условие - По решению покупателя" active="true" mode="automatic" priority="10.0" ignoreRestrictions="false" worksAnyTime="false" color="red" external-code="66565902" deleted="false"> <begin-date>2012-12-01T18:00:00.000</begin-date> <end-date>2050-12-01T18:00:00.000</end-date> <actionResults> <calculation value-type="PERCENT" value="20"/> </actionResults> <externalConditions> <client-decision-condition> <messageToCashier>Спросите покупателя, хочет ли он применить скидку.</messageToCashier> <messageToSCO>Хотите ли вы применить скидку?</messageToSCO> </client-decision-condition> </externalConditions> </AdvertisingAction> </AdvertisingActions>
Условие срабатывания РА: "Решает кассир" (ручные скидки) <cashier-condition>
- SR-5888Получение подробных данных проблемы… СТАТУС
- CR-9049Получение подробных данных проблемы… СТАТУС
10.3.21.0
Только для mode="manual"
AdvertisingActions/AdvertisingAction/externalConditions/cashier-condition | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
effect-area | Комплексный | Область применения РА кассиром (по умолчанию - на позицию).
| Нет |
plugin-id | String | Идентификатор плагина | Нет |
Наименование элемента | Тип данных | Описание | Обязательное |
cashier-role-guid | Long | Список допустимых ролей кассира. | Нет |
<AdvertisingAction name="[SR-5888] Ручная РА на чек для кассиров" external-code="SR-5888-2" mode="manual" active="true" worksAnyTime="true" priority="5888.2" ignoreRestrictions="true" color="green" deleted="false"> <begin-date>2023-01-29T12:07:55.718</begin-date> <end-date>2080-09-29T12:13:03.955</end-date> <actionResults> <calculation value-type="PERCENT" value="20"/> </actionResults> <externalConditions> <cashier-condition effect-area="PURCHASE"> <cashier-role-guid>2</cashier-role-guid> <cashier-role-guid>999</cashier-role-guid> </cashier-condition> </externalConditions> </AdvertisingAction>
Типы ценников рекламной акции <pricetag-type>
AdvertisingActions/AdvertisingAction/pricetag-type | ||||
Наименование элемента | Тип данных | Описание | Обязательное | |
pricetag-type | list | Типы ценников, что надо распечатать на данную акцию Допускается только одно повторение элемента в рекламной акции. Если требуется указать два типа ценника: Акционный и Скидочный (дополнительный/замещающий), тогда они должны быть перечислены через пробел:
| Нет |
Cписок внешних кодов шаблонов ценников <pricetag-template>
AdvertisingActions/AdvertisingAction/pricetag-template | ||||
Наименование атрибута | Тип данных | Описание | Обязательное | |
count | PositiveInteger | Количество ценников данного шаблона, что надо распечатать в автоматическом режиме | Нет |
Привязка к формату шаблона ценника из внешней системы <template-format>
10.2.38.0
Возможность импортировать рекламные акции из внешней системы с указанием кода формата шаблона ценников, чтобы напечатать ценники указанного формата на акционные товары.
AdvertisingActions/AdvertisingAction/template-format | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
template-format | String | Внешний код формата шаблона ценников | Нет |
Одна акция может быть привязана только к одному формату шаблона ценников. Если на сервере не включена работа с форматами и приходит заполненный тег template-format
, то такая акция будет отклонена
Если включена работа с форматами на сервере, то акции с заполненным тегом pricetag-template
будут отклонены
Пустой тег template-format
воспринимается как удаление привязки акции к формату. Неуказанный тег template-format
игнорируется и не затирает ранее созданную связку акции с форматом.
<AdvertisingActions> <AdvertisingAction name="Replacement for product 9988_ST with discount" active="true" mode="unconditional" priority="1000" ignoreRestictions="false" worksAnyTime="false" color="red" external-code="9988_adv_discount_rep"> <begin-date>2016-04-12T17:42:00</begin-date> <end-date>2076-04-13T16:00:00</end-date> <actionResults> <goodsDiscount name="pirogi" discountPercent="20"> <marking-of-the-good id="9988_ST"/> </goodsDiscount> </actionResults> <pricetag-type>REPLACEMENT</pricetag-type> <template-format>EXT32802</template-format> </AdvertisingAction> </AdvertisingActions>
Метки рекламных акций <actionLabels>
AdvertisingActions/AdvertisingAction/actionLabels | |||