PROMO 7.2 - Manual del Usuario - Apéndices

CONTENIDO

Expandir contenido

Apéndice I

Preguntas frecuentes

A continuación se listarán algunas preguntas que podrán surgirle mientras utilice la consola administradora.

No se visualiza en forma correcta PROMO en el browser

Para una correcta visualización, verificar que la versión del browser o navegador utilizada sea igual o superior a las listadas a continuación:

Internet Explorer, versión 11

Firefox, versión 1

Chrome

No puedo ingresar a la consola con mi usuario

Tanto el usuario como la clave del mismo deben ser ingresados del mismo modo que se encuentre registrado. Si el usuario se registró con mayúsculas también deberá ingresarse en la consola de igual modo.

No inicia la consola de PROMO, el error 404 – Pagina No Encontrada

De presentarse una pantalla de error en conexión al momento de intentar loguarse a la consola de PROMO, deberá como primera medida chequearse la URL por la que se intenta acceder a la consola, así como también las conexiones de red del equipo desde el cual se está queriendo acceder.

Si los puntos anteriores se encuentran correctos, beberá de contactarse al administrador de sistemas a fin de chequee que los servicios que se ejecutan cuando inicia PROMO estén corriendo correctamente.

Los servicios que deberán estar ejecutándose son:

Wildfly

MongoDB

PromoSimEngine

No se muestran cupones, tarjetas y puntos vencidos

Deberá chequearse que la tarea programada "Proceso de vencimiento de puntos" este corriendo correctamente.

No se pueden realizar simulaciones desde la consola

Deberá chequearse que el servicio PromoSimEngine este ejecutándose correctamente.

Apéndice II

Sugerencias de Promociones

Para que el Motor de Promociones realice una sugerencia sobre una promoción primero y antes que nada, el mensaje que llega al motor de promociones debe solicitarlo mediante los atributos del encabezado destinados a tal fin.

A nivel promoción, será necesario indicar cuáles serán las promociones sugeridas, esto se realiza al momento de dar de alta una Promoción, así como también será necesario que a nivel mapa esté configurado el comportamiento del mismo ante la solicitud de sugerencias por parte del POS.

No hay ninguna propiedad en la configuración de las sugerencia que les dé un orden en cómo se muestran. El motor de Promo resuelve cada sugerencia a medida que le van llegando los items desde el POS.

Sugerencia Inteligente

En Promo, podra indicarse, por medio de la sugerencia inteligente, el valor sugerido pago para otorgar la promoción, es decir que al cumplir parcialmente con la condición de medios de pago que tiene agrupación por “Pago total productos beneficiados”, se debe generar la sugerencia con el valor que debe de abonarse para acceder a la promoción.

Esto podrá indicarse definiendo en el mensaje de la sugerencia la variable " @totalPaymentAmount "

Por ejemplo, colocando en el campo "Mensaje del POS": "Descuento 20% si paga el total @totalPaymentAmount con tarjeta ZetaCard"

En caso que no se haya agregado ningún medio de pago parcial para la condicion pago total, el motor responderá: "Descuento 20% si paga el total con tarjeta ZetaCard"

Si la condición para Pago Total fuera por ejemplo $ 15620, y se agrega un importe parcial del medio de pago, por ejemplo $5000 para el medio de pago de la condición, el motor responderá:

"Descuento 20% si paga el total 15620 con tarjeta ZetaCard"

Apéndice III

Promociones por medio de pago

Las promociones por medio de pago son promociones que otorgan un descuento o recargo basados en la presentación de algún medio de pago en el punto de venta.

Si bien esto parecería un problema trivial, no lo es tanto. Ejemplo: Si el cliente paga con tarjeta de crédito Visa los artículos comprados y supongamos que los mismos suman $100, y por la utilización de dicho medio de pago tiene un 10% de descuento, en realidad ya no deberá pagar $100 sino $90 en el punto de venta. Es decir, que la promoción afecta el monto pagado.

Entonces, la idea básica de este concepto, es poder manejar descuentos/recargos monetarios calculados sobre el importe del pago. Esto incluye que los descuentos monetarios no solo apliquen sobre el total del ticket sino también sobre los pagos parciales que se realicen con el medio de pago condicionante de la promoción. Además es importante destacar en este punto que la idea no solo recae sobre un determinado medio de pago sino también sobre un plan de pagos asociado al mismo, por ejemplo: plan de 12 cuotas con Visa.

Para definir este tipo de promociones hay que definir por un lado las promociones correspondientes a los planes de pago de los distintos medios de pago (Promoción que da como beneficio No monetario - plan de pago).

Por otro lado, habrá que indicar en el mapa cuál será el método de cálculo que se utilizará para dichas promociones (Configuración de codificada de medio de pago que realizara el cálculo sobre los ítems o sobre los pagos).

Con esto el motor será capaz de calcular los descuentos o recargos que surjan de los distintos pagos y según los distintos planes.

Existen dos métodos para calcular los descuentos o recargos en base a los pagos que realice el cliente en el punto de venta:

- - - - Calculo del descuento o recargo sobre el precio de los artículos participantes.
      - Calculo del descuento o recargo sobre lo que el cliente realmente paga en el punto de venta.

NOTA

Para la definición de promociones cuyo beneficio sea un descuento o recargo aplicado por un determinado medio de pago, no será necesario configurar como condición al medio de pago, sino que se utilizará en el beneficio el medio de pago, su plan y su porcentaje de descuento.

Codificadas de medios de pago

La promoción "codificada" de medios de pagos se encarga de calcular los beneficios/recargos obtenidos de la aplicación de los pagos a los planes de pago generando Promociones basadas en pagos, donde se detalla el monto final del pago, así como los beneficios/recargos para cada ítem, dependiendo del atributo "Tipo de Descuento" definido en el beneficio (descuento/recargo).

Esta promoción recorrerá cada uno de los pagos del ticket e irá aplicando cada uno de los planes de pagos que se encuentren disponibles para el mismo.

Para que un plan de pago se considere disponible para un pago, se comparan cada uno de los atributos enviados en el pago con los atributos correspondientes al plan de pagos definido en la promoción.

Si el valor del atributo del pago se encuentra definido en el plan de pago se dará como válida la comparación, así como también si el atributo del pago no se envió o si es vacía.

La correspondencia entre los atributos del pago y los del plan de pago es la siguiente:

*PAGO Informado por el canal (Ej.: POS)*	*PLAN DE PAGO definido en la promoción*
Código	Medio de Pago
Cuotas	Cuotas
Tipo	Tipo
Plan	Plan
Prefijo	Prefijo

Por ejemplo, si el pago tiene plan=1, y el plan de pago definido en la promoción es 1,2,3 el pago será válido, de igual manera, si no se envió el plan, o si plan de pago definido está vacío, pero no será válido si, por ejemplo el valor del plan es 4.

Para la asignación de pagos a ítems se utiliza un cálculo interno que trata de obtener el mejor beneficio para el cliente, y para ello, a cada uno de los pagos, según el orden de ingreso, recorre todos los planes correspondientes a dicho pago, en orden descendente del porcentaje, y los trata de aplicar.

El monto del pago que se puede aplicar a un plan tiene en cuenta que:

- - - - No puede superar el valor del pago que aún no se encuentra asignado a ningún otro plan
      - No puede superar el valor del ítem
      - Si el plan tiene un monto máximo, no puede superarlo
      - El plan podría haber sido usado total o parcialmente por un pago anterior.

Configuración de Codificadas de medios de pago

Desde el menú Administración, en la opción "Información de configuración" se podrá seleccionar si se utiliza o no, para el cálculo de las promociones de planes de pago, la "Codificada de medios de pago".

Se podrá seleccionar entre "No calcular promociones por medio de pago" (NOTHING), "Calcular promociones sobre Ítems Pagados" (ON_ITEMS_PAID) o "Calcular promociones sobre pago realizado" (ON_PAYMENT_MADE).

Dependiendo de la opción seleccionada serán las formas de cálculo a implementar, descritas en el apartado anterior.

Medio de pago como condición Vs Beneficio de plan de pago

Desde la consola de PROMO se permite ingresar un medio de pago como condición y dar un plan de pago como beneficio; si bien a simple vista pueden parecer similares, el comportamiento de una y otro son diferentes.

Cuando se define una promoción con un elemento "Medio de pago" como condición, esta promoción evaluara la existencia de este elemento dentro de la transacción sin evaluar el monto y aplicara el beneficio en caso de cumplirse con lo definido.

Es habitual la utilización de esta condición para otorgar beneficios no monetarios en una transacción ya que este tipo de promociones no modifican el monto del pago.

Un ejemplo de esta promoción seria "10% de descuento pagando con tarjetas Visa", donde la condición simple sería un medio de pago tarjeta del tipo Visa, y el beneficio sería un porcentaje de descuento. Pero en esta situación, ya sea que se abone el total de la transacción con este medio de pago o que se abone una parte el beneficio, se otorga de igual manera y quedará del lado del POS el cálculo del pago con los descuentos aplicados devenidos de este beneficio.

Al definirse una promoción que como beneficio otorgue un plan de pagos (beneficio No Monetario) el cálculo del monto final del pago se informara con el beneficio devuelto por el motor y se calculara en base al monto que se está abonando (pago parcial o el total de la transacción)

Apéndice IV

Consideraciones - Modulo de Fidelidad

Prefijo de Cupón Autogenerado

Esta configuración podrá realizarse desde "Administración" >> "Información de Configuración", la opción que setea el ingreso manual o automático de esta opción es "coupon.incrementalPrefix" que pertenece al módulo de "Cupones" y admite dos valores "True" o "False", donde "True" indicara que el prefijo será autogenerado por la consola y "False" indicara que el ingreso del prefijo será manual, debiendo ingresarse en este caso un dato numérico de largo 3.

Formato de Código de Barras

El formato de código de barras de cada tipo de cupón es configurable. Se ha asociado una opción de configuración por cada tipo de código de barras soportado (EAN13, UPCA, Code128).

Al momento de emitir un cupón PROMO buscará el tipo de código de barras base asociado al tipo de cupón y su formato asociado. Acto seguido se realizará el reemplazo del formato por los valores que conforman el código de barras acorde al formato.

La conformación del formato es acorde a una secuencia de letras o códigos donde:

- - - - "P" = Prefijo para este tipo de cupón.
      - "S" = Código de Tienda
      - "T" = Código de Terminal
      - "n" = Numero secuencial interno
      - "c" = Digito verificador
      - "D" = Fecha de emisión en formato "YYYYmmDD"
      - "H" = Hora de emisión del cupón en formato "HHMMss"
      - "V" = Fecha de Inicio de Validez
      - "E" = Fecha de vencimiento.

El tamaño de cada uno de estos códigos se realiza por repetición. En los siguientes ejemplos se clarifica este concepto.

En todos los ejemplos tomaremos los siguientes valores para los campos:

- - - - "P" = 987.
      - "S" = 001
      - "T" = 125
      - "n" = 123456789012345…..
      - "c" = 7
      - "D" = 20170302
      - "H" = 225501
      - "V" = 20170308
      - "E" = 20270308

Ejemplo 1:

- - - Tipo de código de barras base: EAN13
    - Formato de código de barras: PPPSSSTTTnnnc
    - El código de barras resultante será: 9870011258907

Indica que se usaran 3 posiciones para el prefijo (987), luego 3 posiciones para el código de tienda (001) y 3 posiciones para el código de terminal (125). Además el barcode contendrá un numero autogenerado de 3 dígitos (890) y por último se debe calcular el dígito verificador del EAN13 (7).

Ejemplo 2:

- - - Tipo de código de barras base: EAN13
    - Formato de código de barras: PSTDDDDHHnnnn
    - El código de barras resultante será: 7150302017890

Indica que se usara 1 posición para el prefijo (7), luego 1 posición para el código de tienda (1) y 1 posición para el código de terminal (5). Además el barcode contendrá 4 posiciones de la fecha de emisión (0302); a continuación los segundos de la hora de emisión (01) y un número autogenerado de 4 dígitos (7890). En este caso no se adjunta el digito verificador del EAN13.

Anteriormente el numero secuencial era mantenido para cada combinación de "store-terminal", como ahora no se puede garantizar que sea univoco el contador, se ha pasado al esquema de llevar un contador por cada

Prefijo de cupón, con lo cual se ha creado una clave para identificar el contador que es "P"+Prefijo, lo cual lo hará único en la base existente de TransactionCounter y por lo tanto se asociara un contador por cada prefijo de cupón a ser generado.

Reverso de Elementos de Fidelidad

PROMO llevará el control de los elementos de fidelidad que el administre. Es decir que ante una devolución informada por el punto de ventas, PROMO evaluara en base al número de transacción y elementos que se van a devolver, si es que deben reversarse cupones o saldos de tarjetas que intervinieron en la venta.

Este proceso será background, quedando los cupones y tarjetas involucradas en el reverso bloqueadas hasta que se procese la transacción de devolución.

Al procesarse la transacción de devolución se analizara el ticket devuelto contra devoluciones parciales previas, si las hubo, y contra el ticket original, se evaluara el contexto contra el mismo mapa que se evaluó la venta y en caso de aplicar se darán de baja cupones y corrigiendo saldos de tarjetas en caso de que los elementos devueltos hayan participado de la emisión de estos en la transacción original.

Al momento, cualquier error durante el proceso de la transacción de devolución será informado en el log de PROMO (...\Server.log) y la tarjeta o cupón involucrado en la devolución no sufrirá cambio alguno.

Para el caso de los cupones, de querer cancelarse, durante el proceso de la devolución, un cupón cuyo estado es "Consumido" (Es decir que el cliente ya uso el cupón en otra transacción), éste no sufrirá ningún cambio en su estado y será informado en el log que no ha podido reversarse el cupón por estar ya consumido. Lo mismo sucederá cuando el cupón a reversar este ya vencido o cancelado.

En cuanto a las tarjetas, en caso de querer restituir o quitar saldo, durante el proceso de devolución, y la tarjeta estar cancelada, vencida o no tener saldo en caso de que deba quitarse, se informara de dicha situación en el log de PROMO y el estado de la tarjeta no sufrirá cambios.

Este proceso background de proceso de devoluciones será realizado por el motor de Simulación que opera en la consola por lo que es requerido que esté disponible cuando se realicen las devoluciones así como también deberá de contar con los mimos mapas que se posee en la tienda.

Este proceso también aplica para los procesos de cambio, ya que el ítem devuelto será tratado como una devolución, realizando los pasos y evaluaciones descriptos anteriormente. Los elementos que se informen al motor serán responsabilidad del pos.

Procesar Cupones Electrónicos

Dentro de la sección de "Información de Configuración" se dispone del botón "Procesar Cupones Electrónicos" por medio del cual se podrá re-procesar todos aquellos mails que hayan quedado en error en la base de PROMO y por lo cual no han sido enviados a sus correspondientes destinatarios.

Cando uno o más cupones se encuentre en error de envío, se mostrara al acceder a la consola, en la parte superior la leyenda en rojo de "No se han podido envían "n" cupones electrónicos. Contacte a su administrador para validar la configuración del servidor de e-mail"

En el mismo banner, se presenta el link de "Ver Detalle", con el cual, podrá accederse a la pantalla donde se encontrara el botón "Procesar Cupones Electrónicos", así como también el código y tipo de cupón y código de error que deberá informarse al administrador para que chequee lo sucedido.

Luego de contactado al administrador y chequeado las correctas configuraciones podrá presionarse el botón "Procesar cupones electrónicos" para re-procesar los cupones y proceder al correcto envío de los mismos a sus destinatarios de mail.

Apéndice V

Configuración de Chequeo de Colisiones

Dependiendo de la utilización de catálogos para la carga de datos en la consola de promociones, el chequeo de colisiones podrá realizarse de dos maneras diferentes según se configure o no la utilización de los catalogo para evaluar la colisión.

La utilización o no de los catálogos para la evaluación de colisiones podrá definirse desde Administración >> Información de configuración >> Modulo: PROMO >> Categoría: promo.map.collision use.item.catalog
Donde los valores aceptados son:

- - - - 0 >> chequea colisiones sin catálogos
      - 1 >> chequea colisiones utilizando catálogo

Apéndice VI

Consideraciones - Alta Masiva de Promociones

Campos asociados a la cabecera de la promoción

Variables en la Cabecera de la promoción

Sección

Campos que admiten asignación de variables

Detalles

Cabecera de la promoción

Descripción de la promoción

Mensaje del POS

Adicional a los campos que admiten la asignación de variables, se agregan como variables por defecto los siguientes campos:

name

code

workflow

campaign

deploymentChannels

promotionType

promotionSubType

promotionApplicationForm

Campos asociados a la cabecera de la promoción

Nombre del campo (visible al usuario)	Nombre interno	Detalles (valores esperados/Formatos)
Nombre de la promoción	name	Alfanumérico
Código de la promoción	code	Alfanumérico
Workflow	workflow	Nombre del workflow Ejemplo: Workflow general
Campaña	campaign	Nombre de la campaña Ejemplo: BLACK FRIDAY
Canales de publicación	deploymentChannels	Elemento tipo lista Se deberá separa con coma(,) para indicar varios elementos. Código de los canales de publicación. Opciones disponibles: pos twitter facebook Ejemplos: pos twitter,facebook
Atributos de la cabecera	hdrFlds	Alfanumérico
Tipo de promociones	promotionType	Código del tipo de promoción
Sub-tipo de promociones	promotionSubType	Código del subtipo de promoción
Forma de aplicación de promociones	promotionApplicationForm	Código de forma de aplicación

Condición de Rango Horario

Variables en Condiciones por Rango horario

Sección	Campos que admiten asignación de variables	Detalles
Condiciones por rango horario	No admite asignación de variables	Solo tomará como variables las condiciones agregadas por el usuario, es decir: si el usuario agrega una condición por Hora, se agregara el excel la columna con la cabecera Condición de hora

Detalle de los campos a definir en las Condiciones de rango horario

Nombre del campo (visible al usuario)	Nombre interno	Detalles (valores esperados/Formato)
Condición de fecha con hora	dateTimeRanges	Elemento tipo lista Al indicar varias condiciones de fecha con hora se deberá separar con coma ( , ) Ejemplos: 13/05/2020 09:00 30/05/2020 10:30 - 02/07/2020 02:30, 01/07/2020 09:00 - 01/09/2020 18:15
Condición de hora	hourRanges	Elemento tipo lista Al indicar varias condiciones de hora se deberá separar con coma ( , ) Ejemplos: 08:00-18:00 14:00-19:15, 10:00-13:15
Condición por periodicidad	frequency	Para el caso de periodicidad por semana, se debe indicar entre paréntesis los días de la semana 1 = Domingo, 2: Lunes, 3: Martes y así sucesivamente. Ejemplos: Aplicada a periodicidad por días: 31/03/2020 3d Aplicada a periodicidad por semanas: 31/03/2020 3s(1,2)

CONDICIONES SIMPLES

Variables en Condiciones simples

Sección	Campos que admiten asignación de variables	Detalles
Condiciones simples	Todos los elementos con auto-complete sin restricciones por catálogo	Excepción en el elemento tipo en Cupones y Tarjetas de fidelidad ya que valida que los tipos exista antes de insertarlo.

Condiciones por COMPOSICIÓN

Variables en Condiciones por composición

Sección

Campos que admiten asignación de variables

Detalles

Condiciones por combo

No admite asignación de variables

Tomará como variables para el excel los campos con valores definidos por el usuario (ver sección del documento: Operación en Consola > Condiciones por combo)

Nota: El campo Tipo de Elementos, no se mostrara en el excel como cabecera de alguna columna, ya que dicho valor identifica el universo de aplicación dentro de la condición y no puede ser modificado.

Detalle de los campos a definir en la condición por composición

Nombre del campo (visible al usuario)

Nombre interno

Detalles (valores esperados/Formato)

Límite de aplicación

limit

numérico entero

Ocurrencias mínimas

min

numérico entero

Ocurrencias máximas

max

numérico entero

Unidad de medida

elementSetTypeMeasureUnitAttribute

Alfanumérico.

Código asociado al tipo de elemento Productos (item):

qty → Cantidad

magnitude → Magnitud

xprice → Precio Total

Alfanumérico.

Código asociado al tipo de elemento Cupones (coupon):

qty → Cantidad

amount → Monto

Alfanumérico.

Código asociado al tipo de elemento Clientes (customer):

points → Puntos

amount → Saldo

Alfanumérico.

Código asociado al tipo de elemento Medios de pago (payment):

amount → Monto

Alfanumérico.

Código asociado al tipo de elemento Tarjeta de fidelidad (loyaltycard):

amount → Monto

Criterio de ordenamiento

conditionComboCriteriaOrder

Alfanumérico.

Código asociado al criterio de ordenamiento.

MoreExpensiveFirst → Los mas caros primero

OneMoreExpensive → Uno mas caro por condición

LessExpensiveFirst → Los mas baratos primero

OneLessExpensive → Uno mas barato por condición

Criterio de equivalencia

elementSetTypeEquivalenceAttribute

Alfanumérico.

Código asociado al tipo de elemento Productos (item):

level3 → Categoría

level4 → Sub Categoría

code → Código (SKU)

unitprice → Precio unitario

brand → Marca

supplier → Proveedor

level1 → Departamento

level2 → Familia

discountable → Descontable

Alfanumérico.

Código asociado al criterio de equivalencia por el tipo de elemento Cupones (coupon):

id → Id

type → Tipo

qty → Cantidad

amount → Monto

Alfanumérico.

Código asociado al criterio de equivalencia por el tipo de elemento Clientes (customer):

type → Tipo

profileCode → Perfil de cliente

creditCampaignCode → Campaña crediticia

Alfanumérico.

Código asociado al criterio de equivalencia por el tipo de elemento Medios de pago (payment):

id → Código

type → Tipo

bank → Banco

plan → Plan

installments → Cuotas

itemamount → Monto del Ítem

prefix → Prefijo

payCreditCampaign → Campaña crediticia

prefixGroup → Grupo de Prefijos

pocket → Bolsillo

Alfanumérico.

Código asociado al criterio de equivalencia por el tipo de elemento Tarjeta de fidelidad (loyaltycard):

type → Tipo

contract → Convenio

Criterio de inequivalencia

elementSetTypeInequivalenceAttribute

Alfanumérico.

Código asociado al criterio de inequivalencia por el tipo de elemento Productos (item):

code → Código (SKU)

unitprice → Precio unitario

brand → Marca

supplier → Proveedor

level1 → Departamento

level2 → Familia

level3 → Categoría

level4 → Sub Categoría

discountable → Descontable

qty → Cantidad

magnitude → Magnitud

xprice → Precio total

redeemOption → Opción de canje de puntos

Alfanumérico.

Código asociado al criterio de inequivalencia por el tipo de elemento Cupones (coupon):

id → Id

type → Tipo

qty → Cantidad

amount → Monto

Alfanumérico.

Código asociado al criterio de inequivalencia por el tipo de elemento Clientes (customer):

type → Tipo

profileCode → Perfil de cliente

creditCampaignCode → Campaña crediticia

Alfanumérico.

Código asociado al criterio de inequivalencia por el tipo de elemento Medios de pago (payment):

id → Código

type → Tipo

bank → Banco

plan → Plan

installments → Cuotas

amount → Monto

itemamount → Monto del Ítem

prefix → Prefijo

payCreditCampaign → Campaña crediticia

prefixGroup → Grupo de Prefijos

pocket → Bolsillo

Alfanumérico.

Código asociado al criterio de inequivalencia por el tipo de elemento Tarjeta de fidelidad (loyaltycard):

type → Tipo

contract → Convenio

Beneficios

Variables en Beneficios

Sección	Clase y Tipo de beneficio	Campos que admiten asignación de variables	Detalles
Beneficios	Monetario - Canje de cupón calculado	No admite asignación de variables	Tomará como variables para el excel todos los campos asociados a la clase y tipo de beneficio
	Monetario - Beneficio externo	Tipo	Adicionalmente tomará como variables para el excel todos los campos asociados a la clase y tipo de beneficio
	Monetario - Canje con opciones	No admite asignación de variables	Tomará como variables para el excel todos los campos asociados a la clase y tipo de beneficio
	Monetario - Descuento fijo
	Monetario - Descuento porcentaje
	Monetario - Nuevo precio
	Monetario - Canje de puntos
	Monetario - Descuento por convenio
	No monetario - Coeficiente de fidelización	Otorgar puntos de tipo	Adicionalmente tomará como variables para el excel todos los demás campos asociados a la clase y tipo de beneficio.
	No monetario - Cupón	De tipo/identificador
	No monetario - Cupón calculado	No admite asignación de variables	Tomará como variables para el excel todos los campos asociados a la clase y tipo de beneficio
	No monetario - Plan de pagos	Otorgar el plan de pagos Para tipo de pago Con medio de pago Cuotas Del banco Prefijo Cuotas a mostrar en el POS Bolsillo	Adicionalmente tomará como variables para el excel todos los demás campos asociados a la clase y tipo de beneficio.
	No monetario - Porcentaje de fidelización	De tipo
	No monetario - Puntos de fidelización	De tipo
	No monetario - Regalo	Con ID de regalo Y tipo de regalo
	No monetario - Reintegro bancario	Otorgar el plan de pagos Para tipo de pago Con medio de pago Cuotas Del banco Prefijo
	Campos genéricos del Beneficio	Cuenta contable Mensaje en POS Mensaje en impresora Mensaje en TLOG

Campos no genéricos asociados al tipo y clase del Beneficio

Tipo de Beneficio	Clase de beneficio	Nombre interno	Campos asociados al beneficio /Detalles (valores esperados/Formato)
Monetario	Canje de cupón calculado		Valores asociados a cada campo: De tipo: alfanumérico. Código de cupón existente Valor de recupero: numérico Tipo de recupero: código del tipo de recupero. Opciones disponibles: p → Porcentaje a → Monto fijo
	Beneficio externo	ExternalBenefit	Valores asociados a cada campo: Beneficio externo tipo: alfanumérico. Código del tipo Valor del Recupero: numérico Tipo de Recupero: código del tipo de recupero. Opciones disponibles: p → Porcentaje a → Monto fijo
	Canje con opciones	RedeemWithOptionsBenefit	Elemento tipo lista Cada opción debe estar contenido entre corchetes ([]), separando un limite de otro con coma (,) Valores asociados a cada campo: Beneficio a aplicar: Opciones disponibles: percentageDiscount → Descuento porcentaje fixedDiscount → Descuento fijo newPrices → Nuevo precio El siguiente porcentaje/ monto/ precio: numérico Por cada unidad de: Opciones disponibles: qty → Cantidad magnitude → Magnitud na → Todo Puntos cliente: numérico entero Tipo de Tarjeta de Fidelidad: alfanumérico. Código de tarjeta de fidelidad existente (campo opcional) Puntos de Tarjeta de Fidelidad: numérico (campo opcional) Formato: [beneficio a aplicar, el siguiente porcentaje/monto/precio, Por cada unidad de, puntos cliente, Tipo de tarjeta de fidelidad (opcional), Puntos de tarjeta de fidelidad(opcional)] Ejemplos: [fixedDiscount, 50, qty, 100] [newPrices, 550, qty, 300],[percentageDiscount, 10, qty, 50, tipo_001, 300]
	Canje de puntos por Catalogo	CatalogRedeemBenefit	Valores asociados a cada campo: Tipo de Tarjeta: alfanumérico. Código de tarjeta de fidelidad existente. Valor del Recupero: numérico Tipo de Recupero: código del tipo de recupero. Opciones disponibles: p → Porcentaje a → Monto fijo
	Descuento fijo	FixedDiscount	Valores asociados a cada campo: El siguiente monto: numérico Por cada unidad de: código de unidad de medida. Opciones disponibles: qty → Cantidad magnitude → Magnitud na → Todo Valor del Recupero: numérico Tipo de Recupero: código del tipo de recupero p → Porcentaje a → Monto fijo
		ContractPercentageDiscount	Valores asociados a cada campo: El siguiente porcentaje (%): numérico Por cada unidad de: código de unidad de medida. Opciones disponibles: qty → Cantidad magnitude → Magnitud na → Todo Balance: balance1 → Balance 1 balance2 → Balance 2
	Descuento por porcentaje	PercentageDiscount	Valores asociados a cada campo: El siguiente porcentaje: numérico Por cada unidad de: código de unidad de medida. Opciones disponibles: qty → Cantidad magnitude → Magnitud na → Todo Valor del Recupero: numérico Tipo de Recupero: código del tipo de recupero. Opciones disponibles: p → Porcentaje a → Monto fijo
	Nuevo precio	NewPrice	Valores asociados a cada campo: El siguiente precio ($): numérico (entero) Por cada unidad de: código de unidad de medida. Opciones disponibles: qty → Cantidad magnitude → Magnitud na → Todo Valor de Recupero: valor numérico (entero) Tipo de Recupero: código del tipo de recupero. Opciones disponibles: p → Porcentaje a → Monto fijo
	Canje de puntos		Valores asociados a cada campo: Tipo de Tarjeta: alfanumérico. Código del tipo de tarjeta de fidelidad existente. Factor $1 = x Puntos: numérico. Equivalente en puntos de 1 peso ($1 = factor puntos)
No monetario	Coeficiente de fidelización	FactorLoyaltyBenefit	Valores asociados a cada campo: Otorgar puntos de tipo: alfanumérico. Código del tipo de tarjeta de fidelidad existente. Con el siguiente factor: numérico.
	Cupón	CouponBenefit	Valores asociados a cada campo: Otorgar cupones (cantidad): número entero De tipo/identificador: alfanumérico. Código del tipo de cupón existente. Datos para el POS: opciones disponibles: 0 → Indistinto 1 → Campo 1 2 → Campo 2
	Cupón calculado	CalculatedCouponBenefit	Valores asociados a cada campo: De tipo: alfanumérico. Código del tipo de cupón existente Aplica a: opciones disponibles: percentage → Porcentaje fixedAmount → Monto fijo externalAmount → Monto externo Valor: numérico entero Cantidad de Vouchers: numérico entero
	Plan de pagos	PaymentPlanBenefit	Valores asociados a cada campo: Otorgar el plan de pagos: alfanumérico. Código del plan de pago. Para tipo de pago: alfanumérico. Código del tipo de pago. Valida que el código exista en CatalogPaymentType. Con medio de pago: alfanumérico. Código del medio de pago. Valida que el código exista en CatalogPaymentCode. Cuotas: numérico. Del banco: alfanumérico. Código del banco. Valida que el código exista en CatalogPaymentBank. Monto límite: numérico Prefijo: numérico. Rango de prefijo. Valida que el código exista en CatalogPaymentBank. De (Descuento/Recargo): alfanumerico. Opciones disponibles: na → Todo discount → Descuento surcharge → Recargo Con un Porcentaje: numérico entero no mayor a 100 Del Bolsillo: Alfanumérico. Código del bolsillo. Valida que el código exista en CatalogPocket.
	Porcentaje de fidelización	PercentLoyaltyBenefit	Valores asociados a cada campo: Otorgar un porcentaje del precio en puntos: numérico entero De tipo: alfanumérico. Código de tarjeta de fidelidad existente.
	Puntos de fidelización	LoyaltyBenefit	Valores asociados a cada campo: Otorgar puntos (cantidad): numérico De tipo: alfanumérico. Código de tarjeta de fidelidad Por cada unidad de: código de unidad de medida. Opciones disponibles: qty → Cantidad magnitude → Magnitud na → Todo
	Regalo	GiftBenefit	Valores asociados a cada campo: Otorgar regalos (cantidad): numérico Con ID de regalo: alfanumérico. Id del regalo Y tipo de regalo: alfanumérico. Código del tipo del regalo
	Reintegro bancario	BankRefundBenefit	Valores asociados a cada campo: Otorgar el plan de pagos: alfanumérico. Código del plan de pago. Para tipo de pago: alfanumérico. Código del tipo de pago. Valida que el código exista en CatalogPaymentType Con medio de pago: alfanumérico. Código del medio de pago. Valida que el código exista en CatalogPaymentCode Cuotas: numérico. Del banco: alfanumérico. Código del banco. Valida que el código exista en CatalogPaymentBank Monto límite: numérico Prefijo: numérico. Rango de prefijo. Valida que el código exista en CatalogPaymentBank Con un Porcentaje: numérico entero no mayor a 100 Del Bolsillo: Alfanumérico. Código del bolsillo. Valida que el código exista en CatalogPocket

Campos genéricos del beneficio

Nombre del campo (visible al usuario)	Nombre interno	Detalles (valores esperados/Formato)
Atributos no genéricos asociados al tipo y clase de beneficio	--	Ver tabla 11
Información de aplicación
Aplicación máxima (valor)	maxApplicationValue	Numérico
Aplicación máxima (medida)	elementSetTypeAttribute	Valores asociados: qty → Cantidad magnitude → Magnitud xprice → Precio total
Descuento mínimo a aplicar	minApplicationValue	Numérico
Método de prorrateo	benefitDivisionMethod	Alfanumérico Valores asociados: proportional → Proporcional most-expensive-first → Mas caros primero cheapest-first → Mas baratos primero
Aplicar sobre...	benefitDivisionPrice	Alfanumérico Valores asociados: original-price → Precio original benefited-price → Precio beneficiado
Criterio de ordenamiento	elementSetOrderCriteria	Alfanumérico Valores asociados: MoreExpensiveFirst → Los mas caros primero LessExpensiveFirst → Los mas baratos primero
Limites de aplicación
Límites del beneficio	limits	Elemento tipo lista Cada limite debe estar contenido entre corchetes ([]), separando un limite de otro con coma (,) Valores asociados a cada campo: Tipo de limite (limitScope): Código asociado al tipo. Opciones disponibles: retailer → General store → Tienda customer → Cliente Periodo a contabilizar (limitPeriod): Código asociado al periodo. Opciones disponibles: undefined → indefinido day → Días Cantidad de Días (numberDays): número entero. Aplica solo si el periodo a contabilizar es Días (day). Limitar por (limitTypeCode): Código asociado a las categorías de limites. Opciones disponibles: benefitAmount → Cantidad de dinero benefitApplicationCount → Cantidad de aplicaciones benefiedProductCount → Cantidad de productos beneficiados Valor (value): Numérico entero Formato: [Tipo de limite, Periodo a contabilizar, cantidad días, limitar por, Valor] Ejemplos: [store, day, 5, benefitAmount, 300] [customer,undefined, 0, benefiedProductCount, 50],[retailer, day, 2, benefitAmount, 750]
Información adicional
Método de aplicación	benefitApplicationMethod	Alfanumérico Valores asociados: resume → Resumen lineByLine → Linea a linea
Cuenta contable	account	Alfanumérico
Proveedor del bien	creditProvider	Alfanumérico Elementos separados con coma (,) Valores asociados a cada campo: Código: código del proveedor, valida que exista en catalogSupplier Tipo de proporción: Código asociado al tipo. Opciones disponibles: amount → Monto percentage → Porcentaje Monto/Porcentaje: numérico entero Formato: code, tipo de proporción, monto/porcentaje Ejemplo: 0045,amount,50
Proveedor financiero	financialProvider	Alfanumérico Elementos separados con coma (,) Valores asociados a cada campo: Código: código del proveedor, valida que exista en catalogSupplier Tipo de proporción: Código asociado al tipo. Opciones disponibles: amount → Monto percentage → Porcentaje Monto/Porcentaje: numérico Formato: code, tipo de proporción, monto/porcentaje Ejemplo: 0033,amount,100
Mensaje en POS	displayMessage	Alfanumérico
Mensaje de impresora	printerMessage	Alfanumérico
Mensaje en TLOG	tlogMessage	Alfanumérico

***Casos* *Prácticos***

Caso práctico 1. Canje con opciones (proceso sugerido)

Para beneficios con lista de opciones, el usuario deberá indicar los datos en el excel de cada opción entre corchetes ([]), en el caso de indicar una lista de opciones deberá separar cada opción con coma ( , ).

El usuario podrá indicar los datos de cada opción siguiendo la presente estructura:

[Beneficio a aplicar, El siguiente (precio,monto,porcentaje), por cada unidad de, Puntos Cliente, Tipo de tarjeta de fidelidad (opcional), Puntos de tarjeta de fidelidad(opcional)]

**Caso práctico 2. Proveedor del bien y proveedor financiero *(proceso sugerido)***

Ambos campos informativos representan el importe de cada proveedor tomando en cuenta el tipo (monto/porcentaje) y valor del importe, por lo que dentro del beneficio debera definirse con el siguiente formato:

code_proveedor, Tipo de importe (monto/proveedor), Valor numérico asociado al tipo de importe

Apéndice VII - Promociones Modelo

"-50% de Descuento en la Segunda Unidad en el Departamento de Lácteos"

Nueva Promoción

- - - - Dar clic en "Nueva Promoción".

- - - - La promoción aplicara en los puntos de venta.
      - La promoción Reportara participantes, por lo que el motor informara al punto de venta que elementos de la transacción ovacionaron la aplicación del beneficio.

La promoción será sugerida cuando en la transacción se ingrese un ítem de los definidos en la condición por composición y se cumpla parcialmente la condición.

NOTA

Para que la promoción sea sugerida correctamente el mapa que la contenga también deberá estar configurado para sugerir "Siempre" o "De acuerdo a la promoción".

Definición de la Condición

La promoción deberá definirse por medio de una condición por composición para que el motor genere subtickes cada dos elementos del departamento de lacteos que se ingresen a la transacción y aplicar sobre él el beneficio que se defina.

Deberá definirse como ocurrencias mínimas y máximas, 2, indicando en unidad de medida, "Cantidad", ya que el subtiket tendrá solo 2 items del departamento de lácteos.

Luego de definir las ocurrencias, debera de indicarse el atributo del producto que deberá considerarse para conformar la condicion por composicion, en este caso, "Departamento", igual a "Lacteos".

Presionar "Continuar" y la condición quedara definida de la siguiente forma:

Definición del Beneficio

Deberá presionarse en "Nuevo Beneficio", y definirse un beneficio del tipo "Monetario", de la clase "Descuento por Porcentaje".

- - - - Se definirá el porcentaje de 50 por cada unidad de cantidad.
      - Sera necesario limitar la aplicación del beneficio a uno item (1) para que solo uno de los dos items que componen el subticket sea alcanzado por el beneficio.

NOTA

En caso de que se requiera acotar aun mas la aplicación del beneficio podrán especificarse mas datos en los campos "Método de Prorrateo", "Aplica sobre…" y "Criterio de Ordenamiento".

Presionar en "Guardar" para completar la carga del beneficio.

Resumen de la Promoción

Deberá chequearse que la promoción aparezca como "Completa" ya que de esta forma podrá ser incluida en un mapa.

NOTA

En caso de tener mas de un paso de Workflow habilitado deberá primero ser aprobada por el o los roles correspondientes para poder ser luego incluida en un mapa.

NOTA 2

La promoción en estado "Completa" podrá también ser simulada desde la sección "Distribución" > "Simulación".