MANUAL DE LENGUAJE DE PROMOCIONES

PROMO 7.1

Índice

Propósito y alcance

El presente manual pretende mostrar los pasos para definir promociones vía formato Json para luego importarlas vía Servicio REST o RabbitMQ. La información aquí presentada es válida también para el formato xml de promociones, al respecto se presenta un ejemplo operativo para que a partir de los mapas xml de Promo se puedan obtener las definiciones en formato Json de las promociones.

Introducción

La importación de las promociones se realiza a través del "Servicio de Importación Masiva de Promociones vía REST" y tiene la necesidad de recibir las promociones en formato “Json”. Para mayor información de este servicio referirse al Manual de Integración de Servicios. Aquí solo haremos referencia a la definición vía Json específicamente.

La formación del Json

El Json de promoción tiene los parámetros de la promoción y de la operación a realizar sobre el registro en cuestión. Los campos son:

Campo	Detalle
operation	Las operaciones que desea realizar. Pueden ser: ( I: Insertar / U: Actualizar / R: Cancelar )
name	Nombre de la promoción
evaluateConditionInCombo	Si la promoción tiene condición simple como parte del combo (ver en Manual de Usuario, definición de Promociones: parámetro "Evaluar condiciones en combo")
reportParticipants	Se refiere a la opción de reportar participantes de la promoción. Valores posibles: "always", "not".
code	El código de la promoción.
sets	List de las referencias a los conjuntos que definirán la condición y el beneficio de la promoción (más detalles en Json Sets).
condition	Definición de condiciones.
benefits	Definición de beneficios que otorga la promoción.

Nota: Para la operación U o R, es requerido que se ingrese al menos uno de los dos campos: name o code. Tenga en cuenta que si solo envia el Código (code) de la promoción, éste debe ser único, porque en caso contrario el sistema realizará la acción indicada (U o R) sobre la primera promoción que encuentre con ese código. Para mas detalle ver en el Manual de Usuario las Notas: "Campo Código Clave" y "Nombre y Código de Promoción Concatenados".

En el siguiente ejemplo mostramos una estructura básica, incompleta, de algunos de los campos mencionados, solo a los fines de referencia:

Ejemplo Json

{    
	"operation": "I",
	"name": "2305 Promo wal1",
	"reportParticipants": "false",
	"suggest": "not",
	"sets": {
		"set": []
	},
	"condition": {
	},
	"benefits": {
	}
 }

Definición de Sets

Hace referencia a los conjuntos de elementos que serán parte de la condición y los que formarán el conjunto de aplicación.

Los campos son:

Campo

Detalle

name

Es el identificador unívoco del set. Este id va a ser referenciado tanto en las condiciones como en el conjunto de aplicación del beneficio.

type

El code del elemento, sus valores posibles son:

Valor	Descripción
customer	Clientes
benefit	Beneficio externo
coupon	Cupones
event	Eventos
item	Productos
loyaltycard	Tarjetas de fidelidad
payment	Medios de Pago

attribute

Es el código del Atributo de los elementos. Sus valores posibles son:

Valor	Descripción	Valor de Type
code	Codigo (SKU)	item
unitprice	Precio unitario	item
brand	Marca	item
supplier	Proveedor	item
level1	Departamento	item
level2	Familia	item
level3	Categoria	item
level4	Sub Categoria	item
qty	Cantidad	item
magnitude	Magnitud	item
xprice	Precio total	item
all	Aplica a TODOS	item
discontinuous	Discontinuo	item
lowTurnover	Baja Rotacion	item
keyProduct	Producto Estrella	item
id	Id	coupon
type	Tipo	coupon
qty	Cantidad	coupon
amount	Monto	coupon
all	Aplica a TODOS	coupon
id	Id	customer
type	Tipo	customer
points	Puntos	customer
amount	Saldo	customer
remainingAmount	Monto restante	customer
segment	Segmento	customer
profileCode	Perfil de cliente	customer
creditCampaignCode	Campaña crediticia	customer
all	Aplica a TODOS	customer
redeemPointsPriceFactor	redeemPointsPriceFactor	customer
id	Numero	event
type	Tipo de Transacción	event
value	Valor	event
all	Aplica a TODOS	event
id	Codigo	payment
type	Tipo	payment
bank	Banco	payment
plan	Plan	payment
installments	Cuotas	payment
amount	Monto	payment
itemamount	Monto del Ítem	payment
prefix	Prefijo	payment
all	Aplica a TODOS	payment
payCreditCampaign	Campaña crediticia	payment
prefixGroup	Grupo de Prefijos	payment
pocket	Bolsillo	payment
id	Id	benefit
type	Tipo de beneficio	benefit
amount	Monto	benefit
benefitType	Tipo de beneficio	benefit

comparator

Es el código del comparador de los atributos de los elementos. Sus valores posibles son:

Valor	Descripción
GreaterThan	MAYOR
Distinct	DISTINTO
LessThan	MENOR
Into	IGUAL

value

El valor

A continuación se muestra un ejemplo donde el conjunto es para todos los productos con código igual a 111:

Ejemplo Json

"set": {
 	"name": "6171aabde830a52d9c434b95",
	"type": "item",
	"attribute": "code",
	"comparator": "Into",
	"value": "111"
	}

El siguiente es un ejemplo donde el conjunto es para todos los productos con level1 igual a maderas y que el tipo de pago sea tarjeta:

Ejemplo 2 Json

"set": [
                    {
                        "name": "5feaf1324b10b84760e83f37",
                        "type": "item",
                        "attribute": "level1",
                        "comparator": "Into",
                        "value": "maderas"
                    },
                    {
                        "name": "5feaf13a4b10b84760e83f3a",
                        "type": "payment",
                        "attribute": "type",
                        "comparator": "Into",
                        "value": "card"
                    }
          ]

Ejemplo con una Condición Simple:

Ejemplo Json

"condition": {
            "type": "basic",
            "name": "Exists",
            "parameter": {
              "key": "use-set",
              "value": "60f5d150e830a518e0976625"
            }
          }

Detalle de los campos:

Campo

Detalle

type

El tipo de condición. Sus valores son: (basic o composite). "Basic" es que la promoción tiene solo una condición (condición simple) y "composite" que es una condición por composición o sea un combo.

name

Es el método de la condición, sus valores son:

Valor	Descripción
Between
DayFrequence
WeekFrequence
DayMonthFrequence
DayOfTheMonthFrequence
WeekDay
DayMonth
EqualOrMoreThan
MoreThan
EqualOrLessThan
LessThan
PaymentTotalBenefitedItems
Exists
Distinct	Distinct (solamente de transacciones)
Header	IGUAL (solamente en transacciones)

parameter

Son una lista de los parámetros de la condición. Tiene dos valores “key” y “value”. El elemento “key” puede tener 2 valores:
- “use-set” que hace referencia a la lista del set y su valor es lo mismo que tiene el "name" del set.

- “attribute” con esta “Key” el “value” puede tener varios valores. Los valores de “vaule” además del valor real de la condición son los code:

Con los elementos “Distinct” y “Header” en la condición con “Transacción” sus “value” son distintas de los además.

Los de transición son:

Valor	Descripción
subZone	Sub Zone
zone	Zone
format	Format
storeChain	StoreChain
currencyCode	CurrencyCode
channel	Channel
store	Tienda
terminal	Terminal

Los demás son (cuando no son “Transacción”):

Valor	Descripción	Valor del Type
code	Codigo (SKU)	Item
unitprice	Precio unitario	Item
brand	Marca	Item
supplier	Proveedor	item
level1	Departamento	item
level2	Familia	item
level3	Categoria	item
level4	Sub Categoria	item
qty	Cantidad	item
magnitude	Magnitud	item
xprice	Precio total	item
all	Aplica a TODOS	item
discontinuous	Discontinuo	item
lowTurnover	Baja Rotacion	item
keyProduct	Producto Estrella	item
id	Id	coupon
type	Tipo	coupon
qty	Cantidad	coupon
amount	Monto	coupon
all	Aplica a TODOS	coupon
id	Id	customer
type	Tipo	customer
points	Puntos	customer
amount	Saldo	customer
remainingAmount	Monto restante	customer
segment	Segmento	customer
profileCode	Perfil de cliente	customer
creditCampaignCode	Campaña crediticia	customer
all	Aplica a TODOS	customer
redeemPointsPriceFactor	redeemPointsPriceFactor	customer
id	Numero	event
type	Tipo de Transacción	event
value	Valor	event
all	Aplica a TODOS	event
id	Codigo	payment
type	Tipo	payment
bank	Banco	payment
plan	Plan	payment
installments	Cuotas	payment
amount	Monto	payment
itemamount	Monto del Ítem	payment
prefix	Prefijo	payment
all	Aplica a TODOS	payment
payCreditCampaign	Campaña crediticia	payment
prefixGroup	Grupo de Prefijos	payment
pocket	Bolsillo	payment
id	Id	benefit
type	Tipo de beneficio	benefit
amount	Monto	benefit
benefitType	Tipo de beneficio	benefit

Algunos ejemplos cuando usamos atributo (attribute):

Observe que siempre hay que tener un set con el “type”, cuando no es condición de una “Transacción”.

Json Ejemplo con transacción

[…]

{

"type": "basic",

"name": "Header",

"parameter": [

{

"key": "attribute",

"value": "store"

},

{

"key": "value",

"value": "666"

}

]

}

[…]

Json Ejemplo sin transacción

"set": [

{

"name": "61126855e830a505e41642a3",

"type": "item"

},
[...]

"type": "basic",

"name": "EqualOrMoreThan",
"parameter": [

{

"key": "use-set",

"value": "61126855e830a505e41642a3"

},

{

"key": "attribute",

"value": "xprice"

},

{

"key": "value",

"value": "1000"

}

]

Este ejemplo muestra que hay una condición simple con el precio total de todos los items (SKU) con valor mayor o igual a 1000.

Ejemplo de una Condición Simple con dos sets relacionados mediante la función AND lógico:

Ejemplo Json

"condition": {
            "type": "composite",
            "name": "And",
            "condition": [
              {
                "type": "basic",
                "name": "Exists",
                "parameter": {
                  "key": "use-set",
                  "value": "60f58668e830a518e09765d6"
                }
              },
              {
                "type": "basic",
                "name": "Exists",
                "parameter": {
                  "key": "use-set",
                  "value": "60f58672e830a518e09765d9"
                }
              }
            ]
          }

Aquí se detallan los campos del ejemplo anterior:

Campo

Detalle

type

Tipo de condición. Sus valores son: (basic o composite).

name

Esta es la operación sobre la condición, sus posibles valores son:

Operación

SIMPLE

AND

OR

NOT

AND_NOT

OR_NOT

condition

Una lista de condiciones.

Ejemplo de un combo limitado a 1 sola instancia compuesto por 1 producto y 1 pago que vaya entre 1300 y 1500:

Ejemplo Json

"set": [
              {
                "name": "60f089dee830a518e0976217",
                "type": "payment"
              },
              {
                "name": "60f08bafe830a518e097621e ",
                "type": "item"
              }
[....]
"combo": {
            "limit": "1",
            "combo-component": [
              {
                "min": "1",
                "max": "1",
                "attribute": "qty",
                "use-set": "60f08bafe830a518e097621e"
              },
              {
                "min": "1300",
                "max": "1500",
                "attribute": "itemamount",
                "use-set": "60f089dee830a518e0976217"
              }
            ]
          }

Detalle de los campos utilizados en el ejemplo anterior:

Campo	Detalle
limit	Límite de veces que se agruparán
combo-component	Una lista de componentes de combo

Los campos dentro de combo-component son:

Campo

Detalle

min

cantidad mínima

max

cantidad máxima

attribute

Son las Unidades de medida (están diferenciadas por el tipo (type) y por el set (use-set) )

Valor	Descripción	Valor del Type
qty	Cantidad	item
magnitude	Magnitud	item
xprice	Precio total	item
qty	Cantidad	coupon
amount	Monto	coupon
points	Puntos	customer
amount	Saldo	customer
amount	Monto	payment
itemamount	Monto del Ítem	payment
amount	Monto	loyaltycard

use-set

Es la relación con la lista de sets.

order-criteria

Es el Criterio de ordenamiento. Los posibles valores son:

Valor	Nombre
OneLessExpensive	Uno mas barato por condicion
LessExpensiveFirst	Los mas baratos primero
OneMoreExpensive	Uno mas caro por condicion
MoreExpensiveFirst	Los mas caros primero

equivalence-attribute

Es el Atributo de equivalencia (si tiene). Los posibles valores son:

Valor	Descripción	Valor del Type
unitprice	Precio unitario	item
code	Codigo (SKU)	item
brand	Marca	item
supplier	Proveedor	item
level1	Departamento	item
level2	Familia	item
level3	Categoria	item
level4	Sub Categoria	item
all	Aplica a TODOS	item
discontinuous	Discontinuo	item
lowTurnover	Baja Rotacion	item
keyProduct	Producto Estrella	item
productCode	Cod. Producto	item
barcode	Cod. Barra Producto	item
id	Id	coupon
type	Tipo	coupon
qty	Cantidad	coupon
amount	Monto	coupon
all	Aplica a TODOS	coupon
type	Tipo	customer
profileCode	Perfil de cliente	customer
creditCampaignCode	Campaña crediticia	customer
id	Codigo	payment
type	Tipo	payment
bank	Banco	payment
plan	Plan	payment
installments	Cuotas	payment
itemamount	Monto del Ítem	payment
prefix	Prefijo	payment
all	Aplica a TODOS	payment
payCreditCampaign	Campaña crediticia	payment
prefixGroup	Grupo de Prefijos	payment
pocket	Bolsillo	payment
type	Tipo	loyaltycard
contract	Convenio	loyaltycard

inequivalence-attribute

Es el Atributo de inequivalencia (si tiene). Los posibles valores son:

Valor	Descripción	Valor del Type
brand	Marca	item
code	Codigo (SKU)	item
unitprice	Precio unitario	item
supplier	Proveedor	item
level1	Departamento	item
level2	Familia	item
level3	Categoria	item
level4	Sub Categoria	item
qty	Cantidad	item
magnitude	Magnitud	item
xprice	Precio total	item
all	Aplica a TODOS	item
discontinuous	Discontinuo	item
lowTurnover	Baja Rotacion	item
keyProduct	Producto Estrella	item
redeemOption	redeemOption	item
productCode	Cod. Producto	item
barcode	Cod. Barra Producto	item
id	Id	coupon
type	Tipo	coupon
qty	Cantidad	coupon
amount	Monto	coupon
all	Aplica a TODOS	coupon
type	Tipo	customer
profileCode	Perfil de cliente	customer
creditCampaignCode	Campaña crediticia	customer
id	Codigo	payment
type	Tipo	payment
bank	Banco	payment
plan	Plan	payment
installments	Cuotas	payment
amount	Monto	payment
itemamount	Monto del Ítem	payment
prefix	Prefijo	payment
all	Aplica a TODOS	payment
payCreditCampaign	Campaña crediticia	payment
prefixGroup	Grupo de Prefijos	payment
pocket	Bolsillo	payment
type	Tipo	loyaltycard
contract	Convenio	loyaltycard

Json de Beneficios

El elemento “benefits” es un objeto que tiene una lista de beneficios (“benefit”) que tiene la promoción con sus parámetros particulares. Aquí se muestra un ejemplo con dos beneficios uno con Cupón Calculado y otro con Beneficio Externo.

Ejemplo Json

"benefits": {
		"benefit": [
		    {
				"instance": "CalculatedCouponApplicationBenefit",					
				"nro": "60131bd5acb1e948c01a28a6",
				"parameter": [… Los parameros del beneficio …],
				"applied-elements": {
					"use-set": {
						"name": "60131abbacb1e948c01a2889"
					           }
				                     }
			  },
			{
				"instance": "ExternalBenefit",
				"nro": "60131bf5acb1e948c01a28a8",
				"parameter": [ … Los parameros del beneficio …],
				"applied-elements": {
					"use-set": {
						"name": "60131abbacb1e948c01a2889"
					           }
				                    }
		 	 }
                ]
         }

El siguiente es otro ejemplo con un beneficio Monedero:

Ejemplo 2 Json

"benefits": {
		  "benefit": {
			"instance": "WalletBenefit",
			"nro": "6171aaaee830a52d9c434b91",
			"parameter": [ … Los parameros del beneficio … ],
			"applied-elements": {
			  "use-set": {"name": "6171aabde830a52d9c434b95"}
			                     }
                       }
             }

Cada beneficio posee su tipo (instance), sus parámetros (parameter) y a quien aplica ese beneficio (applied-elements) este último se compone formando un único beneficio. Sus campos son:

instance

Son los códigos (code) del tipo de beneficio. Estos son los posibles valores de ese campo:

Valor	Descripción
CalculatedCouponApplicationBenefit	Aplicación de Cupón Calculado
WalletBenefit	Beneficio Monedero
ContractPercentageDiscount	Descuento por convenio
RedeemPointsBenefit	Redención de Puntos
CalculatedCouponBenefit	Cupón Calculado
CatalogRedeemBenefit	Canje de Puntos por Catálogo
RedeemWithOptionsBenefit	Canje con Opciones
ExternalBenefit	Beneficio Externo
BankRefundBenefit	Reintegro bancario
PercentLoyaltyBenefit	Porcentaje de fidelización
GeneralBenefit	Beneficio General
GiftBenefit	Regalo
PaymentPlanBenefit	Plan de pagos
CouponBenefit	Cupón
FactorLoyaltyBenefit	Coeficiente de fidelización
LoyaltyBenefit	Puntos de fidelización
PercentageDiscount	Descuento porcentaje
FixedDiscount	Descuento fijo
NewPrice	Nuevo precio

nro

Es el id de la base de datos cuando hace las operaciones (U: Actualizar / R: Cancelación) es un campo requerido.

Parameter

Es la lista de parámetros que tienen los tipos de beneficio. Aquí se muestran parámetros que tienen todos los beneficios y otros que son exclusivos. En el campo "Key code" se muestra la "key". El campo "value" son los valores (los que están en blanco son insertados por el usuario), algunos de ellos tienen valores predefinidos (Obtions values (codes)) como se ve abajo.

Parámetros generales:

Obtions value (codes)	Key code	Descripción
	displayMessage	Mensaje en POS
	TLOGMessage	Coca + Papas, lleva las papas gratis
	printerMessage	Mensaje en impresora
	account	Cuenta contable
{"code" : "cheapest-first","name" : "Mas baratos primero" }	prorationMethod	Método de prorrateo
{"code" : "most-expensive-first","name" : "Mas caros primero"}	prorationMethod	Método de prorrateo
{"code" : "proportional","name" : "Proporcional"}	prorationMethod	Método de prorrateo
{"code" : "benefited-price","name" : "Precio beneficiado" }	applicationPriceType	Aplicar sobre..
{"code" : "original-price","name" : "Precio original"}	applicationPriceType	Aplicar sobre..
{"code" : "resume","name" : "Resumen"}	applicationMethod	Método de aplicación
{"code" : "lineByLine","name" : "Linea a linea"}	applicationMethod	Método de aplicación
	name	El número de la promoción se necesita cuando se hacen las operaciones (U: Actualizar / R: Cancelar )

Parámetros exclusivos:

Obtions value (codes)	Key code	Descripción	Tipo de beneficio	Requerido
{"code":"na","name":"Todo"}	unit	Por cada unidad de	Nuevo precio	false
	externalAmount	Precio informado por el POS	Nuevo precio	false
	newprice	El siguiente precio ($)	Nuevo precio	false
{"code":"qty","name":"Cantidad"}	unit	Por cada unidad de	Nuevo precio	false
{"code":"magnitude","name":"Magnitud"}	unit	Por cada unidad de	Nuevo precio	false
	recoveryValue	Valor del Recupero	Nuevo precio	false
{"code":"p","name":"Porcentaje"}	recoveryType	Tipo de Recupero	Nuevo precio	false
{"code":"a","name":"Monto fijo"}	recoveryType	Tipo de Recupero	Nuevo precio	false
	prorateBCP	Prorratear entre participantes	Nuevo precio	false
	amount	El siguiente monto ($)	Descuento fijo	true
{"code":"qty","name":"Cantidad"}	unit	Por cada unidad de	Descuento fijo	false
{"code":"magnitude","name":"Magnitud"}	unit	Por cada unidad de	Descuento fijo	false
{"code":"na","name":"Todo"}	unit	Por cada unidad de	Descuento fijo	false
	recoveryValue	Valor del Recupero	Descuento fijo	false
{"code":"p","name":"Porcentaje"}	recoveryType	Tipo de Recupero	Descuento fijo	false
{"code":"a","name":"Monto fijo"}	recoveryType	Tipo de Recupero	Descuento fijo	false
	prorateBCP	Prorratear entre participantes	Descuento fijo	false
	percent	El siguiente porcentaje (%)	Descuento porcentaje	true
{"code":"qty","name":"Cantidad"}	unit	Por cada unidad de	Descuento porcentaje	false
{"code":"magnitude","name":"Magnitud"}	unit	Por cada unidad de	Descuento porcentaje	false
{"code":"na","name":"Todo"}	unit	Por cada unidad de	Descuento porcentaje	false
	recoveryValue	Valor del Recupero	Descuento porcentaje	false
{"code":"p","name":"Porcentaje"}	recoveryType	Tipo de Recupero	Descuento porcentaje	false
{"code":"a","name":"Monto fijo"}	recoveryType	Tipo de Recupero	Descuento porcentaje	false
	prorateBCP	Prorratear entre participantes	Descuento porcentaje	false
	value	Otorgar puntos (cantidad)	Puntos de fidelización	true
	type	De tipo	Puntos de fidelización	true
{"code":"qty","name":"Cantidad"}	unit	Por cada unidad de	Puntos de fidelización	false
{"code":"magnitude","name":"Magnitud"}	unit	Por cada unidad de	Puntos de fidelización	false
{"code":"na","name":"Todo"}	unit	Por cada unidad de	Puntos de fidelización	false
	trxPointsLimit	Máximo de puntos por transacción	Puntos de fidelización	false
	recoveryValue	Valor del Recupero	Puntos de fidelización	false
{"code":"p","name":"Porcentaje"}	recoveryType	Tipo de Recupero	Puntos de fidelización	false
{"code":"a","name":"Monto fijo"}	recoveryType	Tipo de Recupero	Puntos de fidelización	false
	ignorePaidInPoints	Ignorar Pagado con Puntos	Puntos de fidelización	false
	type	Otorgar puntos de tipo	Coeficiente de fidelización	true
	factor	Con el siguiente factor	Coeficiente de fidelización	true
	trxPointsLimit	Máximo de puntos por transacción	Coeficiente de fidelización	false
	recoveryValue	Valor del Recupero	Coeficiente de fidelización	false
{"code":"p","name":"Porcentaje"}	recoveryType	Tipo de Recupero	Coeficiente de fidelización	false
{"code":"a","name":"Monto fijo"}	recoveryType	Tipo de Recupero	Coeficiente de fidelización	false
	ignorePaidInPoints	Ignorar Pagado con Puntos	Coeficiente de fidelización	false
	qty	Otorgar cupones (cantidad)	Cupón	true
	couponid	De tipo/identificador	Cupón	true
{"code":"0","name":"nameInfoPos0"}	infoPos	Datos para el POS	Cupón	true
{"code":"1","name":"nameInfoPos1"}	infoPos	Datos para el POS	Cupón	true
{"code":"2","name":"nameInfoPos2"}	infoPos	Datos para el POS	Cupón	true
	recoveryValue	Valor del Recupero	Cupón	false
{"code":"p","name":"Porcentaje"}	recoveryType	Tipo de Recupero	Cupón	false
{"code":"a","name":"Monto fijo"}	recoveryType	Tipo de Recupero	Cupón	false

applied-elements

Es el Json de la aplicación de la promoción

Applied-elements

El applied-elements es la aplicación del beneficio. Se aplica a los mas caros primero en base a 2 elementos.

Ejemplo Json

          "applied-elements": {
            "use-set": {
              "name": "628bedd8a6c1d243c013421e",
              "order-criteria": "MoreExpensiveFirst",
              " max ": "2.0",
              "attribute": "qty",
              " min ": "2.0"
            }
          }

Sus campos son:

Campo

Detalle

name

Referencia a un set

order-criteria

Son los Criterios de ordenamento, sus posibles valores son :

Valor	Descripción
MoreExpensiveFirst	Los mas caros primero
LessExpensiveFirst	Los mas baratos primero

max

Es la Aplicación máxima (valor)

min

Es el Descuento mínimo a aplicar

attribute

Es la Aplicación máxima (medida), sus posibles valores son :

Valor	Descripción
qty	Cantidad
magnitude	Magnitud
xprice	Precio total

Escalones:

Son Escalones de la definición de promociones escalonadas de un beneficio.

Ejemplo Json

          "staggered": {
            "unit": "qty",
            "staggeredStep": {
              "nro": "629602c8a6c1d21bc8985ddb",
              "min": "1",
              "max": "1",
              "applyValue": "1"
            }
          }

Sus campos son:

unit

Es la Unidad de Escalonada. Sus posibles valores son:

Valor	Descripción
qty	Cantidad
magnitude	Magnitud
xprice	Precio total

staggeredStep

Es una lista de la definición de la Escalones, sus campos son:

Campo	Descripción
nro	Número de la base de datos cuando se hacen las operaciones (U: Actualizar / R: Cancelar ) es un dato requerido.
min	Ocurrencias mínimas
max	Ocurrencias máximas
applyValue	Es el Valor

Ejemplos

Ejemplo 1:

El siguiente es un ejemplo donde se inserta una nueva promoción con una condición simple y tiene un beneficio monedero.

Ejemplo Json

{
    "companyId": "napse",
    "promotions": [
        {
		"operation": "I",
		"name": "2305 Promo wal1",
		"reportParticipants": "false",
		"suggest": "not",
		"sets": {
		  "set": {
			"name": "6171aabde830a52d9c434b95",
			"type": "item",
			"attribute": "code",
			"comparator": "Into",
			"value": "111"
		  }
		},
		"condition": {
		  "type": "basic",
		  "name": "Exists",
		  "parameter": {
			"key": "use-set",
			"value": "6171aabde830a52d9c434b95"
		  }
		},
		"benefits": {
		  "benefit": {
			"instance": "WalletBenefit",
			"nro": "6171aaaee830a52d9c434b91",
			"parameter": [
			  {
				"key": "displayMessage",
				"value": "Promo wal1"
			  },
			  {
				"key": "printerMessage",
				"value": "Promo wal1"
			  },
			  {
				"key": "TLOGMessage",
				"value": "Promo wal1"
			  },
			  {
				"key": "applicationMethod",
				"value": "resume"
			  },
			  {
				"key": "prorationMethod",
				"value": "proportional"
			  },
			  {
				"key": "applicationPriceType",
				"value": "benefited-price"
			  },
			  {
				"key": "name",
				"value": "6171a7c5e830a52d9c434b89"
			  },
			  {
				"key": "wallet",
				"value": "w1"
			  },
			  {
				"key": "limitAmount",
				"value": "10"
			  },
			  {
				"key": "percent",
				"value": "50"
			  }
			],
			"applied-elements": {
			  "use-set": {"name": "6171aabde830a52d9c434b95"}
			}
		  }
		}
	  }
    ]
}

Ejemplo 2:

En el siguiente json se muestra como se inserta una promoción simple donde se otorga como beneficio un cupón.

Ejemplo 1 Json

{
	"companyId": "napse",
	"promotions": [
        {
         "operation": "I",
          "name": "Teste import 01",
          "reportParticipants": "false",
          "suggest": "not",
          "sets": {
            "set": {
              "name": "setCond1",
              "type": "item",
              "attribute": "code",
              "comparator": "Into",
              "value": "111"
            }
          },
          "condition": {
            "type": "basic",
            "name": "Exists",
            "parameter": {
              "key": "use-set",
              "value": "setCond1"
            }
          },
          "benefits": {
            "benefit": {
              "instance": "CouponBenefit",
              "nro": "610ae160e830a528c4383a44",
              "parameter": [
                {
                  "key": "displayMessage",
                  "value": "Teste import 01"
                },
                {
                  "key": "printerMessage",
                  "value": "Teste import 01 impreso"
                },
                {
                  "key": "TLOGMessage",
                  "value": "Teste import 01 tlog"
                },
                {
                  "key": "applicationMethod",
                  "value": "resume"
                },
                {
                  "key": "prorationMethod",
                  "value": "proportional"
                },
                {
                  "key": "applicationPriceType",
                  "value": "benefited-price"
                },
                {
                  "key": "name",
                  "value": "benefit01"
                },
                {
                  "key": "qty",
                  "value": "1"
                },
                {
                  "key": "couponid",
                  "value": "tipcupelectm1"
                },
                {
                  "key": "infoPos",
                  "value": "0"
                },
                {
                  "key": "recoveryValue",
                  "value": "0"
                },
                {
                  "key": "recoveryType",
                  "value": ""
                }
              ],
              "applied-elements": {
                "use-set": {"name": "setCond1"}
              }
            }
          }
        }
    ]
}