Image Removed
MANUAL DE LENGUAJE DE PROMOCIONESImage Added

PROMO 7.1

...

- Manual de Lenguaje de Promociones

Painel

borderColor	#E4E3E3
titleColor	#ffffff
borderWidth	1
titleBGColor	#704581
title	CONTENIDO

Expandir

title	Expandir contenido

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

...

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
intersection	Crear un "AND" para más de una condición
union	Crear un "OR" para más de una condición

Para los "type" de "intersection" y "union" se necesita poner una lista de sets. Puede tener intersección dentro de unión y unión dentro de intersección.

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:

Bloco de código

title	Ejemplo Json

"set": {
 	"name": "6171aabde830a52d9c434b95",
	"type": "item",
	"attribute": "code",
	"comparator": "Into",
	"value": "111"
	}	"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:

Bloco de código

title	Ejemplo 2 Json

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

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 tarjetase utiliza el "type" "union":

Bloco de código

title	Ejemplo 2 3 Json

"set": [{
           "name": "6171aabde830a52d9c434b95",
            {"type": "union",
           "set" :[
            "name": "5feaf1324b10b84760e83f37",         {
                         "type": "item",
                         "attribute": "level1",
                         "comparator": "Into",
                         "value": "maderas"
                      },
                     {
                         "nametype": "5feaf13a4b10b84760e83f3apayment",
                         "typeattribute": "paymenttype",
                         "attributecomparator": "typeInto",
                         "comparatorvalue": "Intocard",
                        "value": "card"}
                   ]
 }
        }  ]

Ejemplo con una Condición Simple:

...

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.

...

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.

...

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.

...

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 (Options values (codes)) como se ve abajo.

Parámetros generales:

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

Key code	Requerido	Descripción	Tipo de beneficio	Options value (Code)	Options value (Name)
externalAmount	false	Precio informado por el POS	Nuevo precio
newprice	false	El siguiente precio ($)	Nuevo precio
unit	false	Por cada unidad de	Nuevo precio	qty	Cantidad
unit	false	Por cada unidad de	Nuevo precio	magnitude	Magnitud
unit	false	Por cada unidad de	Nuevo precio	na	Todo
recoveryValue	false	Valor del Recupero	Nuevo precio
recoveryType	false	Tipo de Recupero	Nuevo precio	p	Porcentaje
recoveryType	false	Tipo de Recupero	Nuevo precio	a	Monto fijo
prorateBCP	false	Prorratear entre participantes	Nuevo precio
amount	true	El siguiente monto ($)	Descuento fijo
unit	false	Por cada unidad de	Descuento fijo	qty	Cantidad
unit	false	Por cada unidad de	Descuento fijo	magnitude	Magnitud
unit	false	Por cada unidad de	Descuento fijo	na	Todo
recoveryValue	false	Valor del Recupero	Descuento fijo
recoveryType	false	Tipo de Recupero	Descuento fijo	p	Porcentaje
recoveryType	false	Tipo de Recupero	Descuento fijo	a	Monto fijo
prorateBCP	false	Prorratear entre participantes	Descuento fijo
percent	true	El siguiente porcentaje (%)	Descuento porcentaje
unit	false	Por cada unidad de	Descuento porcentaje	qty	Cantidad
unit	false	Por cada unidad de	Descuento porcentaje	magnitude	Magnitud
unit	false	Por cada unidad de	Descuento porcentaje	na	Todo
recoveryValue	false	Valor del Recupero	Descuento porcentaje
recoveryType	false	Tipo de Recupero	Descuento porcentaje	p	Porcentaje
recoveryType	false	Tipo de Recupero	Descuento porcentaje	a	Monto fijo
prorateBCP	false	Prorratear entre participantes	Descuento porcentaje
value	true	Otorgar puntos (cantidad)	Puntos de fidelización
type	true	De tipo	Puntos de fidelización
unit	false	Por cada unidad de	Puntos de fidelización	qty	Cantidad
unit	false	Por cada unidad de	Puntos de fidelización	magnitude	Magnitud
unit	false	Por cada unidad de	Puntos de fidelización	na	Todo
trxPointsLimit	false	Máximo de puntos por transacción	Puntos de fidelización
recoveryValue	false	Valor del Recupero	Puntos de fidelización
recoveryType	false	Tipo de Recupero	Puntos de fidelización	p	Porcentaje
recoveryType	false	Tipo de Recupero	Puntos de fidelización	a	Monto fijo
ignorePaidInPoints	false	Ignorar Pagado con Puntos	Puntos de fidelización
type	true	Otorgar puntos de tipo	Coeficiente de fidelización
factor	true	Con el siguiente factor	Coeficiente de fidelización
trxPointsLimit	false	Máximo de puntos por transacción	Coeficiente de fidelización
recoveryValue	false	Valor del Recupero	Coeficiente de fidelización
recoveryType	false	Tipo de Recupero	Coeficiente de fidelización	p	Porcentaje
recoveryType	false	Tipo de Recupero	Coeficiente de fidelización	a	Monto fijo
ignorePaidInPoints	false	Ignorar Pagado con Puntos	Coeficiente de fidelización
qty	true	Otorgar cupones (cantidad)	Cupón
couponid	true	De tipo/identificador	Cupón
infoPos	true	Datos para el POS	Cupón	0	nameInfoPos0
infoPos	true	Datos para el POS	Cupón	1	nameInfoPos1
infoPos	true	Datos para el POS	Cupón	2	nameInfoPos2
recoveryValue	false	Valor del Recupero	Cupón
recoveryType	false	Tipo de Recupero	Cupón	p	Porcentaje
recoveryType	false	Tipo de Recupero	Cupón	a	Monto fijo
paymentplanid	true	Otorgar el plan de pagos	Plan de pagos
paymentplanvtolid	false	Plan de Pago Vtol	Plan de pagos
type	true	Para tipo de pago	Plan de pagos
tender	true	Con medio de pago	Plan de pagos
installments	true	Cuotas	Plan de pagos
bank	false	Del banco	Plan de pagos
limitamount	false	Monto limite	Plan de pagos
prefixes	false	Prefijo	Plan de pagos
percent	false	Con un Porcentaje	Plan de pagos
percenttype	false	De (Descuento/Recargo)	Plan de pagos	indistinct	Indistinto
percenttype	false	De (Descuento/Recargo)	Plan de pagos	discount	Descuento
percenttype	false	De (Descuento/Recargo)	Plan de pagos	surcharge	Recargo
installmentsToDisplay	false	Cuotas a mostrar en el POS	Plan de pagos
pocket	false	Bolsillo	Plan de pagos
recoveryValue	false	Valor del Recupero	Plan de pagos
recoveryType	false	Tipo de Recupero	Plan de pagos	p	Porcentaje
recoveryType	false	Tipo de Recupero	Plan de pagos	a	Monto fijo
vtoloperationtype	false	OperationType Vtol	Plan de pagos
qty	true	Otorgar regalos (cantidad)	Regalo
giftid	true	Con ID de regalo	Regalo
gifttype	true	Y tipo de regalo	Regalo
recoveryValue	false	Valor del Recupero	Regalo
recoveryType	false	Tipo de Recupero	Regalo	p	Porcentaje
recoveryType	false	Tipo de Recupero	Regalo	a	Monto fijo
qty	true	Cantidad de beneficios generales	Beneficio General
generalid	true	Con ID	Beneficio General
generaltype	true	Y tipo	Beneficio General
recoveryValue	false	Valor del Recupero	Beneficio General
recoveryType	false	Tipo de Recupero	Beneficio General	p	Porcentaje
recoveryType	false	Tipo de Recupero	Beneficio General	a	Monto fijo
percent	true	Otorgar un porcentaje del precio en puntos	Porcentaje de fidelización
type	true	De tipo	Porcentaje de fidelización
trxPointsLimit	false	Máximo de puntos por transacción	Porcentaje de fidelización
recoveryValue	false	Valor del Recupero	Porcentaje de fidelización
recoveryType	false	Tipo de Recupero	Porcentaje de fidelización	p	Porcentaje
recoveryType	false	Tipo de Recupero	Porcentaje de fidelización	a	Monto fijo
ignorePaidInPoints	false	Ignorar Pagado con Puntos	Porcentaje de fidelización
paymentplanid	true	bankRefoundBenefit-Otorgar el plan de pagos	Reintegro bancario
paymentplanvtolid	false	Plan de Pago Vtol	Reintegro bancario
type	true	bankRefoundBenefit-Para tipo de pago	Reintegro bancario
tender	true	bankRefoundBenefit-Con medio de pago	Reintegro bancario
installments	true	bankRefoundBenefit-Cuotas	Reintegro bancario
bank	false	bankRefoundBenefit-Del banco	Reintegro bancario
limitamount	false	bankRefoundBenefit-Monto limite	Reintegro bancario
prefixes	false	bankRefoundBenefit-Prefijo	Reintegro bancario
percent	true	bankRefoundBenefit-Con un Porcentaje	Reintegro bancario
percenttype	false	bankRefoundBenefit-De (Descuento/Recargo)	Reintegro bancario	discount	Descuento
pocket	false	bankRefoundBenefit-Del bolsillo	Reintegro bancario
recoveryValue	false	Valor del Recupero	Reintegro bancario
recoveryType	false	Tipo de Recupero	Reintegro bancario	p	Porcentaje
recoveryType	false	Tipo de Recupero	Reintegro bancario	a	Monto fijo
vtoloperationtype	false	OperationType Vtol	Reintegro bancario
type	true	De tipo	Beneficio Externo
recoveryValue	false	Valor del Recupero	Beneficio Externo
recoveryType	false	Tipo de Recupero	Beneficio Externo	p	Porcentaje
recoveryType	false	Tipo de Recupero	Beneficio Externo	a	Monto fijo
prorateBCP	false	Prorratear entre participantes	Beneficio Externo
recoveryValue	false	Valor del Recupero	Canje con Opciones
recoveryType	false	Tipo de Recupero	Canje con Opciones	p	Porcentaje
recoveryType	false	Tipo de Recupero	Canje con Opciones	a	Monto fijo
type	true	Tipo tarjeta canje puntos por catalogo	Canje de Puntos por Catalogo
recoveryValue	false	Valor del Recupero	Canje de Puntos por Catalogo
recoveryType	false	Tipo de Recupero	Canje de Puntos por Catalogo	p	Porcentaje
recoveryType	false	Tipo de Recupero	Canje de Puntos por Catalogo	a	Monto fijo
prorateBCP	false	Prorratear entre participantes	Canje de Puntos por Catalogo
couponid	true	Tipo	Aplicacion de Cupón Calculado
recoveryValue	false	Valor del Recupero	Aplicacion de Cupón Calculado
recoveryType	false	Tipo de Recupero	Aplicacion de Cupón Calculado	p	Porcentaje
recoveryType	false	Tipo de Recupero	Aplicacion de Cupón Calculado	a	Monto fijo
prorateBCP	false	Prorratear entre participantes	Aplicacion de Cupón Calculado
couponid	true	Tipo	Cupón Calculado
amountApplicationType	true	Tipo de aplicacion de monto	Cupón Calculado	percentage	Cupón calculado - aplicación del monto por porcentaje
amountApplicationType	true	Tipo de aplicacion de monto	Cupón Calculado	fixedAmount	Cupón calculado - aplicación del monto por monto fijo
amountApplicationType	true	Tipo de aplicacion de monto	Cupón Calculado	externalAmount	Cupón calculado - aplicación del monto por monto externo
calculatedCouponValue	true	Valor del tipo de cupón calculado	Cupón Calculado
qty	true	Cantidad	Cupón Calculado
recoveryValue	false	Valor del Recupero	Cupón Calculado
recoveryType	false	Tipo de Recupero	Cupón Calculado	p	Porcentaje
recoveryType	false	Tipo de Recupero	Cupón Calculado	a	Monto fijo
accumulateInSingleCoupon	false	Acumular el monto de beneficios en un cupón único	Cupón Calculado
type	true	Tipo	Redención de Puntos
factor	true	Tipo	Redención de Puntos
recoveryValue	false	Valor del Recupero	Redención de Puntos
recoveryType	false	Tipo de Recupero	Redención de Puntos	p	Porcentaje
recoveryType	false	Tipo de Recupero	Redención de Puntos	a	Monto fijo
prorateBCP	false	Prorratear entre participantes	Redención de Puntos
percent	false	Con un Porcentaje	Descuento por convenio
unit	false	Por cada unidad de	Descuento por convenio	qty	Cantidad
unit	false	Por cada unidad de	Descuento por convenio	magnitude	Magnitud
unit	false	Por cada unidad de	Descuento por convenio	na	Todo
balance	false	Balance	Descuento por convenio	balance1	Balance 1
balance	false	Balance	Descuento por convenio	balance2	Balance 2
recoveryValue	false	Valor del Recupero	Descuento por convenio
recoveryType	false	Tipo de Recupero	Descuento por convenio	p	Porcentaje
recoveryType	false	Tipo de Recupero	Descuento por convenio	a	Monto fijo
prorateBCP	false	Prorratear entre participantes	Descuento por convenio
wallet	true	Monedero	Beneficio Monedero
limitAmount	true	Limite	Beneficio Monedero
percent	true	Porcentaje	Beneficio Monedero

applied-elements

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

...

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.

...

unit

Es laUnidad 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.

...

Una buena práctica cuando iniciamos en la confeccion confección del Json es tomar una promocion promoción de un mapa existente o bien definirla en consola y obtener el mapa en formato xml para convertirlo en el Json equivalente y así poder por comparación lograr una comprensión para luego ya confeccionarlos por otros medios.

...

4. Resultado

Promo importada y creada correctamente en la consola de Promo:

Importación de Promoción con tipo, subtipo y forma de aplicación:

Si se tiene una promoción con tipo, subtipo y forma de aplicación:

Image Added

Estas propiedades no son propias del mapa:

Image Added

pero se pueden agregar manualmente:

Image Added

y se importará la promoción con su tipo, subtipo y forma de aplicación.

Árvore de páginas

Versões comparadas

Versão antiga 2

Nova versão Atual

Chave

PROMO 7.1

- Manual de Lenguaje de Promociones

Propósito y alcance

Ejemplo con una Condición Simple:

Json de Beneficios

Ejemplos

Ejemplo 1:

4. Resultado

Importación de Promoción con tipo, subtipo y forma de aplicación:

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 2

Nova versão Atual

Chave

PROMO 7.1

- Manual de Lenguaje de Promociones

Propósito y alcance

Ejemplo con una Condición Simple:

Json de Beneficios

Ejemplos

Ejemplo 1:

4. Resultado

Importación de Promoción con tipo, subtipo y forma de aplicación: