PROMO 7.4 - Manual de Usuario








Capítulo 1 - Acerca del manual


Propósito y alcance


El presente manual de usuario tiene como finalidad capacitar al usuario que desee utilizar PROMO para la administración de sus promociones.

Provee de instrucciones detalladas paso a paso que lo ayudaran a crear y administrar promociones a través de la consola de administración de PROMO así como también detalla conceptos y definiciones de cada componente del producto.



Contenido


Capítulo 1 - Acerca del manual
Contiene descripciones generales acerca del contenido del manual.

Capítulo 2 - Introducción
Contiene una introducción del producto PROMO y su composición.

Capítulo 3 - Consola de Administración
Contiene conceptos generales sobre el uso de la consola como las conexiones y la navegación en el menú.

Capítulo 4 – Módulo de Dashboard
Se describe la operatoria para la utilización del Dashboard.

Capítulo 5 – Módulo de Operación
Se describe la operatoria para la creación y administración de Departamentos, Campañas, Promociones, Plantillas de Promociones, Alta masiva de promociones y Workflow.

Capítulo 6 – Módulo de Workflow
Se describe la operatoria para la creación y administración de Workflow, para Promociones.

Capítulo 7 – Módulo de Distribución
Se describe la operatoria para crear, modificar y distribuir mapas, simular promociones y mapas y la distribución en redes sociales.

Capítulo 8– Módulo de Fidelidad
Se describe la operatoria para la creación, edición y administración de los elementos de Loyalty (Cupones y Elementos)

Capítulo 9– Módulo de Productividad

Describe los informes gráficos y de detalles que permiten al usuario disponer de información relevante para la toma de decisiones.

Contiene Dashbord y detalles de los ítems más importantes para la toma de decisiones

Capítulo 10 – Módulo de Informes
Describe los informes que pueden generarse dentro de PROMO.

Capítulo 11 - Módulo de Negocio
Contiene aquellas configuraciones especiales que se podrán realizar a través de la consola de administración de PROMO tales como altas de Unidades departamentales, Compañías, Regiones y Tiendas.

Capítulo 12 - Módulo de Administración

Describe las configuraciones disponibles para la consola de PROMO.

Capítulo 13 – Módulo de Seguridad
Se describen la operatoria de administración y configuración de usuarios y accesos.

Capítulo 14– Módulo de Alarmas
Se describen la operatoria de configuración y notificaciones de alarmas.

Capítulo 15 – Módulo de Soporte
Se describen la operatoria de administración de las opciones de gestión de base de datos y soporte. Provee información sobre preguntas consideradas como frecuentes.

Capítulo 16 – Promociones Modelo

Se explican los pasos para el armado de promociones habituales dadas de alta en PROMO.



Referencias prácticas


Se utilizará para resaltar aclaraciones sobre el tema en curso. 


Se utilizará para indicar al usuario sobre precauciones que se deberán contemplar.


Documentación de PROMO

PROMO provee la siguiente documentación:




Capítulo 2 - Introducción

¿Qué es PROMO?


PROMO es una solución que permite separar el manejo de promociones del punto de venta. Permite definir una amplia gama de promociones y es extensible sin la necesidad de realizar modificaciones en los puntos de venta.

PROMO elimina la codificación y la dependencia del mantenimiento, reduce los tiempos de implementación y de prueba. Cuenta con una interfaz gráfica a la cual llamaremos Consola de Administración - PROMO, que facilita el alta de una promoción convirtiéndola en un proceso rápido e intuitivo. Esta cualidad acelera el proceso de salida de una promoción.
PROMO está pensado como una herramienta sumamente útil y sencilla de usar orientada a los Retailers para que administren, de forma centralizada, las promociones vigentes en las distintas regiones y locales.

En PROMO se podrán construir promociones por composición de condiciones (combos), promociones definidas por condiciones simples, crear beneficios, otorgar cupones y puntos de fidelidad, pudiendo configurar los parámetros correspondientes a cada promoción según se requiera.

También permite el armado de plantillas de Promociones que podrán ser utilizadas para la carga masiva de promociones en la consola de Promo, ahorrando tiempo de creación y mayor confianza en la coherencia de la promoción.
Se podrán definir reglas de convivencia y órdenes de aplicación entre promociones vigentes. Estos parámetros serán utilizados, mediante algoritmos de alta eficacia, para determinar el conjunto de promociones que participan de una determinada venta. Estas promociones serán informadas al punto de venta, quien será el encargado de aplicar las promociones informadas por PROMO en el ticket.

PROMO brinda la posibilidad de administrar cupones de manera centralizada, registrando las transacciones que los emiten y llevando estadísticas (KPI) de las transacciones registradas y cupones, así como también es posible administrar elementos de fidelidad de manera centralizada gestionando los distintos perfiles de elementos de fidelidad, y sus movimientos.

PROMO permite registrar reversos de elementos de fidelidad devenidos de devoluciones o notas de créditos realizados en el punto de venta donde se vean involucrados cupones y elementos de fidelidad.

Desde la consola de administración de PROMO también se podrán gestionar y configurar alarmas que servirán de aviso ante determinados eventos.


Componentes de PROMO


Herramienta WEB para la administración de promociones, cupones y elementos de fidelidad, así como también alarmas. Es el componente encargado de generar el archivo de definición de reglas de negocio (mapa de promociones) que será utilizado por el motor de promociones para la evaluación de éstas. Es el encargado de gestionar la emisión y redención de cupones de manera centralizada, encargándose de la gestión de las elementos de fidelidad, pudiendo crearlos, asociarlos a un cliente, visualizar su historial y gestionar saldos.


Es el componente de PROMO encargado de resolver e informar las promociones participantes en un Ticket según las definiciones (promociones) que se hayan generado a través de la consola. También es el nexo entre el punto de ventas y la consola de administración central para todo lo referente a la gestión de elementos de Loyalty.


Arquitectura






Funcionalidad


Las funciones que lleva a cabo PROMO:

Limitaciones


Capítulo 3 - Consola de Administración


Introducción

PROMO, a través de la Consola de Administración, permite definir promociones mediante combinación de componentes: condiciones simples, de rango horario, combos y beneficios.

Por medio de la consola de promociones se realiza la definición de los mapas en los cuales se relacionan las promociones vigentes mediante reglas de convivencia y órdenes de aplicación.

Desde PROMO se podrán generar y gestionar cupones para ser emitidos y redimidos por intermedio de una transacción.

También es posible generar elementos de fidelidad, pudiéndose dar de altas distintos perfiles de elementos de fidelidad como ser por ejemplo, GiftCard, monederos o elementos de fidelidad de puntos, podrá gestionarse el saldo, asociarlas a y permitir su participación en promociones para incrementar o disminuir su saldo según la promoción que se aplique.

Con PROMO es posible  gestionar alarmas, las cuales servirán para alertar a determinados usuarios sobre eventos relevantes que sucedan en la consola y/o transacción.

En esta nueva versión de PROMO se incorporan herramientas que mejoraran la experiencia de usuario agilizando la gestión de promociones y mapas, junto con la posibilidad de customizar la consola de una manera ágil y sencilla según los requerimientos de cada Retail.


Conexión a la consola


La consola de administración es una herramienta Web, por lo tanto la conexión podrá ser remota o local, a través del uso de un browser como Chrome, o Firefox.

Para conectarse a la consola es necesario ingresar a la página  http://IP-SERVIDOR:PORT_INSTALACION/promo donde: 




Una vez conectado a la consola, se deberá ingresar el nombre de usuario, contraseña y compañía a la que se desea conectarse.


Por default, al iniciar la consola de PROMO por primera vez, las credenciales serán (respetando mayúsculas y minúsculas):


De estar Activo, se mostrará el sistema CAPTCHA para iniciar sesión en Promo si se encuentra configurado, y luego de la cantidad de intentos que corresponda. 

Se introdujo un sistema CAPTCHA para prevenir intentos masivos de autenticación. Se activa si se excede el número configurado de intentos fallidos, definido por `maximumLoginFailedCount` y activado mediante la configuración `captcha.is.active`.

Para su configuración consultar el Manual de Instalación de Promo:  Configuración de CAPTCHA en promoplus.propertiConfiguración de CAPTCHA en promoplus.propertieses


Mostrará una pantalla como la siguiente:

Debe completar los campos como se muestra a continuación:

Luego de presionar el botón "Inicio de sesión" ingresará a Promo.



Al ingresar a la consola, la aplicación mostrará los datos del usuario:

Nombre del usuario: Ej.:admin

Compañía: Ej.; napse

Alarmas: el ícono indica las alarmas que le llegan al usuario

Tiendas: las que tiene vinculadas el usuario. Ej: Tienda1, Tienda2, etc. Las tiendas se separan con coma.

Cerrar sesión: botón para salir de la aplicación

Ayuda: se observará el ícono que al presionar, la aplicación redirigirá a la vista "Promo- Documentación" donde se encuentran todos los manuales de todas las versiones. En cada una de las vistas de la consola la ayuda dirigirá al usuario, al Manual de Usuario, de la versión en la que se encuentra logueado y en el capítulo correspondiente.

En algunas vistas también se observará un link a un video explicativo. En este ejemplo se redirigirá al usuario al video que detalla la administración de workflows).

Esta funcionalidad la encontrará también en las vistas:

Tipos de cupones: redirigirá al usuario al video "Cupones con vigencia Diferida"

Configuración de Alarmas: redirigirá al usuario al video Módulo de Alarmas

Los videos fueron realizados basándose en la versión 7.1 de Promo


Versión: indica la versión correspondiente a la aplicación. Ej: V.7.4

Integración con autenticación de Usuarios Externos (SAML2)

Por medio de la implementación en PROMO de SAML2 se lograra la integración de PROMO con un sistema de autenticación externos de usuarios.  Se deberá tomar en cuenta que dentro de la consola existen roles de usuario que permiten ingresar a las diferentes funcionalidades que deberán mantenerse dentro de la consola.  Será requerido siempre tener el usuario creado en la base de datos para poder acceder a la consola y realizar la autenticación.

Cuando Promo opere con dicha integración, la pantalla de login propuesta en este manual no se mostrará, sino que se verá el login que cada retailer haya integrado con SAML2.

Al loguearse y autenticarse correctamente, se vera la pantalla principal de PROMO de "Gestión de Promociones".

Para mas información sobre la integración de SAML2 en Promo Ver Manual de Instalación 7.4 - Autenticación de Usuarios Externos (SAML2)


Menú de Navegación PROMO



Dependiendo de los módulos adquiridos aparecerán más o menos opciones disponibles en los menús de navegación. En este documento se tratarán todas las opciones disponibles de la aplicación base.


Consideraciones generales


Habrá datos que el usuario deberá ingresar en la consola y que son comunes a todos los componentes.


Nota: Los mensajes estándar toman el lenguaje del sistema (no de Promo).


Botones


En las pantallas de la consola de PROMO podrán encontrar los siguientes botones:



Tener en cuenta que si se presiona Cancelar en cualquiera de las pantallas de un flujo lo que se hace es cancelar totalmente el flujo que se estaba ejecutando.


Paginado



En todas las pantallas en las cuales se despliegue gran cantidad de registros, se contará con el paginado de la información, para facilitar su navegación. La navegación de las mismas es la siguiente:



Debajo de los filtros de búsqueda se mostrarán dos campos para navegar los registros, son los filtros de paginación que por default al ingresar al informe o pantalla mostrarán 1 (uno) y 50 (cincuenta), de esta manera, mostrará por pantalla los primeros 50 registros partiendo del primer registro. Si quiere ver los dos registros anteriores deberá presionar la doble flecha que se encuentra a la izquierda. El sistema automáticamente modificará el valor del campo desde el cual realiza la búsqueda. Cuando se esté buscando a partir de 1 la doble flecha de la izquierda estará deshabilitada (si se pasa el cursor del mouse sobre ese botón mostrará el signo prohibido). Cuando se llegue al final de la lista la doble flecha de la derecha se deshabilitará (si se pasa el cursor del mouse sobre ese botón mostrará el signo prohibido). De esta forma se podrá navegar el informe viendo en pantalla a partir del registro indicado, la cantidad de registros ingresada. Como máximo se pueden ver por pantalla 1.000 (mil) registros.

IMPORTANTE:AL COMENZAR A UTILIZAR LOS FITLROS DE PAGINACIÓN, LUEGO DE INGRESAR LOS VALORES DESEADOS (O SI DEJA 1- 50 TAMBIÉN) DEBE PRESIONAR ENTER, LUEGO CONTINÚA NAVEGANDO CON LAS FLECHAS DOBLES.

Al ingresar por primera vez a la pantalla, desde que se logueó el usuario actual, por default no traerá información y mostrará un mensaje indicando que debe utilizar los filtros para buscar información. Una vez realizada la búsqueda (al presionar el botón "lupa"), el mensaje desaparece. Los campos de búsqueda quedarán almacenados con los filtros de búsqueda que utilizó.




Capítulo 4 - Módulo de Dashboard


Los Dashboards son representaciones gráficas de las principales métricas o KPIs que intervienen en la obtención de los objetivos de una estrategia de negocio y que está orientada a la toma de decisiones para optimizar la estrategia de la empresa.

Los Dashboards en PROMO permitirán hacer un seguimiento del grado de aplicación y alcance de las distintas promociones, cupones y elementos de fidelidad en base a los distintos indicadores predefinidos.



Menú de Dashboard

Desde este Menú se podrán visualizar los KPIs de Ventas, promociones, elementos de fidelidad y cupones.



Dashboard de Ventas

En esta sección se mostrarán los indicadores referentes a las transacciones de Ventas impactadas en la base de datos de PROMO.

Los registros se mostrarán en base al rango de fechas seleccionado y los KPIs representaran los valores de distintos aspectos de las ventas realizadas.

El gráfico de Ventas por Tienda: muestra por tienda, el total de las ventas realizadas menos los descuentos aplicados. Este gráfico mostrará sólo las tiendas vinculadas al usuario logueado y si el usuario tiene asignadas todas las tiendas también verá aquellas que no se encuentren registradas en Promo.

El gráfico de Ventas por Categoría (Ranking 5): muestra el precio total por categoría (sin aplicar el descuento).

El grafico de Ventas por hora (Ranking 5): muestra el precio de venta por hora menos el descuento aplicado.

El gráfico de Ventas por Medio de Pago: muestra el total de la venta (sin aplicar el descuento) por medio de pago.




Dashboard de Promociones

En esta sección se mostraran los indicadores referentes a las Promociones otorgadas desde el punto de ventas impactadas en la base de datos de PROMO.

Estos registros se mostraran en base a un rango de fechas seleccionado y los KPIs representaran en los diagramas el flujo de las promociones aplicadas.



Nota: Al posicionar el mouse sobre las barras de colores se mostrarán dos cifras, en el siguiente ejemplo muestra: $700,1. La primer cifra indica el valor que se quiere representar en el gráfico, la segunda cifra indica la posición de la barra que se está mirando contando desde el eje cartesiano x hacia arriba. En este ejemplo al ser la primer barra muestra 1:



Dashboard de Cupones

En esta sección se mostraran los indicadores referentes a cupones otorgadas desde el punto de ventas impactadas en la base de datos de PROMO.

Los registros se mostraran en base al rango de fechas seleccionado y los KPIs representaran en los diagramas el flujo de los cupones Emitidos y/o redimidos según se configure.




Dashboard de Elementos de Fidelidad

Se cuenta con los indicadores referentes a elementos de fidelidad activos.
Los registros se mostraran en base al rango de fechas seleccionado y los KPIs representaran los elementos de fidelidad activados en el rango indicado.


Cada uno de estos Dashboards podrá editarse tanto en su formato como así también los datos que se muestran.



Capítulo 5 - Módulo de Operación


Menú de Operación


Desde este Menú se podrán crear Campañas, definir Condiciones Generales, crear Promociones y Plantillas de promoción, aprobar promociones, Condiciones Generales, Cancelar promociones de forma masiva y/o modificar los límites de las promociones.



Campañas

Ésta opción se encuentra dentro del menú "Operación" de la consola de PROMO y la misma permite administrar distintas campañas.

Por default, al instalar la consola se carga como ejemplo la campaña "BLACK FRIDAY", la cual podrá reutilizarse o desactivarse según se requiera.

Las campañas podrán clasificarse según la finalidad u objetivo de las promociones que agrupará.

Por ejemplo, "Campaña napse", en donde podrán agruparse todas las promociones de electrodomésticos.

Otro ejemplo podría ser "Campaña Navideña" en donde las promociones agrupadas bajo esta campaña son las que estarán vigente durante la temporada navideña.

Las campañas podrán definirse según las necesidades del retailer, y solo tendrán como finalidad la organización de las promociones dentro de la consola.


Se deberá presionar el botón "Nuevo" y a parecerá la siguiente pantalla para completar los datos de la campaña: 

Se deberán ingresar los siguientes datos: 

Una vez cargados los datos se deberá presionar el botón "Guardar".


Si bien PROMO permite que cada cliente genere sus propias campañas, habrá que tener en cuenta que una vez creados, por ser condicionantes para la estructuración de las tareas que en su conjunto conforman las promociones, el sistema no permitirá borrarlos.



Condiciones Generales

Esta opción se encuentra dentro del menú "Operación" de la consola de PROMO y la misma permite definir condiciones donde se pueda indicar qué ítems quedan incluidos o excluidos en la evaluación de las promociones vigentes en el mapa que las contenga. Estas "Condiciones Generales" serán incluidas dentro del mapa de Promo y será lo primero que el motor considerará, de forma tal que al evaluarse el contexto, los elementos incluidos en dichas condiciones sean incluidos o excluidos de la evaluación de promociones. Las Condiciones Generales serían como un pre filtro que el motor de Promo va a analizar antes de ver si analiza el mapa o no, dependiendo de lo que se haya definido en las Condiciones Generales. 

Al dar clic en el ítem "Condiciones Generales" se pasará a la pantalla "Gestión de Condiciones Generales" 

Se puede buscar por los siguientes filtros:

La grilla de la pantalla "Gestión de Condiciones Generales" mostrará las condiciones generadas.

Al dar clic en el botón "Nueva Condición" se pasará a la pantalla "Nueva Condición General", donde se presentarán los siguientes datos para dar de alta una nueva condición: 

Si el workflow general está deshabilitado para el módulo de Condiciones Grales. 

la consola traerá por default el primer workflow de la lista (en la vista Administración de Usuarios/Asociación a workflows), ordenada de forma alfabética.


Workflows asociados a un usuario:

  1. Si un usuario tiene asociados todos los workflows  definidos en la consola. Al crear una nueva Condición  General, la consola traerá por default el Workflow General:

2. Lo mismo sucederá si el usuario no tiene asociado ningún workflow.

3. Un usuario verá en la vista "Gestión de Condiciones Generales" todas aquellas con workflows asociados al usuario.

y cuando cree una nueva condición; sólo verá los workflows asociados:

4. En el caso que el usuario  tenga asociado todos los workflows definidos en la consola; excepto el workflow general, al crear una nueva promoción, la aplicación mostrará por default el primer workflow de la lista, ordenados en forma alfabética.


Si no se selecciona un tipo, un subtipo y una forma de aplicación, la vista mostrará todos los registros de Condiciones Generales.

Estos tres campos se utilizan para indicar a qué tipo, subtipo y forma de aplicación pertenece la nueva condición  y de esta forma cuando coincida la tipificación con la promoción se aplicara la condición gral.  El valor por default para los tres campos será Todos; aplicando a cualquier tipificación de promociones.

Cuando se presione "Guardar" se pasará a la pantalla "Definir Condición". En caso de que se presione "Cancelar", se volverá a la pantalla "Gestión de Condiciones Generales", sin guardar ningún cambio. 

Podrán generarse Condiciones Generales con una vigencia determinada o que aplique con una frecuencia definida por medio de la definición de las condiciones de Rango Horario.

Las Condiciones Simples podrán definirse por cualquiera de los atributos definidos para los elementos, así como también podrán combinarse elementos para definir una Condición General.


El pop Up de Resumen mostrará la cabecera y condiciones definidas.


Escenarios de definición de Condiciones Generales

En una Condición General podrán definirse, por ejemplo, las siguientes condiciones simples:

> Si se define la condición simple por SKU "Igual a", por ejemplo, "111", este ítem podrá ser evaluado por las promociones que se encuentran en el mapa que contiene esta Condición General.

> Si se define la condición simple por Marca "Distinto de", por ejemplo, "Sony", los ítems pertenecientes a la marca Sony no podrán ser evaluados en ninguna de las promociones que se encuentran en el mapa que contiene esta Condición General.

Podría darse el caso en que se excluya la marca Sony de la aplicación de promociones pero que alguna de las promociones del mapa que contiene esta Condición General aplique, por ejemplo, un 10% a PlayStation (marca=Sony).SUPUESTO: En este caso, el cliente no se llevaría el descuento por haberse aplicado en primer termino la Condición General.


> Si en la transacción se ingresa el cupón con tipo "Igual a" 111, se evaluarán promociones.

> Si en la transacción se ingresa el cupón con tipo "Distinto de" 111, no se evaluarán promociones.


> Si en la transacción se ingresa un cliente con tipo "Igual a" VIP, se evaluarán promociones.

> Si en la transacción se ingresa un cliente con tipo "Distinto de" VIP, no se evaluarán promociones.


> Si en la transacción se ingresa un medio de pago con banco "Igual a" RIO, se evaluarán promociones.

> Si en la transacción se ingresa un medio de pago con banco "Distinto de" RIO, no se evaluarán promociones.


> Si en la transacción se ingresa un elemento de fidelidad con tipo "Igual a" Puntos, se evaluarán promociones.

> Si en la transacción se ingresa un elemento de fidelidad con tipo "Distinto de" Puntos, no se evaluarán promociones.


> Si en la transacción se realiza en una tienda "Igual a" 658, se evaluarán promociones.

> Si en la transacción se realiza en una tienda "Distinto de" 658, no se evaluarán promociones.


Las Condiciones Generales podrán participar de los Workflows como cualquier otra promoción.

Las Condiciones Generales podrán ser Simuladas solamente cuando participen de un mapa. Al simular un mapa que contenga una Condición General deberá mostrarse por pantalla que la Condición General aplicó, y cuál fue el resultado, ya sea si se aplicaron o no promociones. No podrán ser simuladas desde la opción de Promociones ya que no poseen beneficios.

Nota: Si en Condiciones Generales se pone un rango de fechas el mapa solo se podrá utilizar en ese rango de fechas.


Promo limita a 3000 el número de condiciones simples que se pueden agregar a una condición  general; tanto de forma manual, como por importación.


Edición de Condiciones Generales:

Una condición general puede ser editada desde el el botón "Acciones" presionando el ítem "Editar"

La consola desplegará la vista:

Donde todos los campos son editables. Los campos modificados se almacenarán con el botón "Guardar"


Si una Condición General con workflow general es modificada

Se sigue manteniendo aprobada:

Si, en cambio, la Condición General posee un workflow de pasos, al modificarla:

el workflow vuelve al primer paso para su aprobación.





Promociones


Una promoción es una herramienta de marketing utilizada para informar, persuadir y recordar la existencia de un producto o servicio a los consumidores potenciales, con la esperanza de influir en los sentimientos, creencias o comportamiento del destinatario y estimular así la demanda.

Las promociones tienen ciertas restricciones o condiciones que deben cumplirse para poder obtener los beneficios asociados a las mismas.

Para PROMO, una promoción es una función que toma un contexto (Contexto: son todos los elementos que forman parte de una transacción (producto, cupones, , eventos, medios de pago) y los datos propios de la transacción (número de tienda, terminal, fecha y hora).) como ingreso y devuelve un nuevo contexto (con los beneficios resultantes y elementos beneficiados) como salida y los informa a la aplicación del punto de venta.

Para que una promoción se considere "Completa" deberá por lo menos definirse en ella una "Condición" y un "Beneficio".


Por configuración podrá definirse que el ingreso de un cliente, una condición de Fecha con Hora y/o una condición por Transacción, son requeridas para dar por completa una promoción. Ver "Administración" >> "Información de Configuración"


Una "Condición" puede conformarse por elementos o una colección de elementos relacionados que cumplen con ciertas características definidas. Denominaremos conjuntos a la conformación de éstos elementos.

Los conjuntos también se podrán conformar con todos los elementos del tipo que se haya seleccionado, sin necesidad de configurar por algún tipo de atributo en especial.

Para acceder a la pantalla de "Gestión de Promociones" se debe seleccionar dentro del menú "Operación" la opción "Promociones".

Se presentará la siguiente pantalla, en donde se listarán las promociones ya generadas indicando su estado, así como también se podrán generar nuevas promociones desde el botón "Nueva Promoción".


La pantalla de Gestión de Promociones mostrará los siguientes filtros no obligatorios de búsqueda de promociones: Código, Nombre de promoción, Tipo de promociones, Sub-tipo de promociones, Formas de aplicación, Estado, Campaña, Vigencia y Tienda.

Al ingresar en la pantalla "Gestión de Promociones" el usuario logueado; sólo verá las promociones que tienen asociadas la/s tiendas que el tenga vinculadas. (Por migración también se verán todas las promociones que no tengan ninguna tienda o tiendas que no se encuentren registradas en la consola).

Por debajo se encuentran los filtros de búsqueda, son los filtros de paginación, descriptos en Paginado

Menú Acciones

A la derecha de cada Promoción, independientemente de si esta se encuentra en estado Incompleta, completa o distribuida, aparecerá el botón "Acciones" desde el cual podrán realizarse distintas acciones sobre una promoción.

A continuación se detallan éstas acciones:



Al distribuirse una promoción de forma individual, los mapas que la contengan en tiendas activas recibirán la actualización de la promoción distribuida individualmente. La numeración del mapa en tienda no se vera afectada por la distribución individual de promociones.




Nueva Promoción


Se deberá tener en cuenta que una promoción debe estar compuesta por al menos una condición y un beneficio para que se considere como "Completa".


Se recomienda como máximo incorporar 3.000 códigos dentro de una promoción.




Promo limita a 3000, la cantidad de condiciones simples, generales y beneficios que se pueden asignar a una promoción; tanto por creación manual, alta masiva o importación de promociones.


Alta de Nueva Promoción

Se deberá presionar el botón "Nueva Promoción" en la ventana de "Gestión de promociones" y se mostrarán las siguientes secciones:


Plantilla de Promociones


Cabecera

En esta sección se deberán ingresar los siguientes datos:


Campo Código Clave: Por default, el nombre de la promoción será único y se utilizara como llave para las búsquedas de promociones en los distintos filtros de la consola de Promo y de los informes. En esta versión de Promo, se incorpora la posibilidad de indicar desde la configuración de la consola si el “Nombre” es utilizado como campo clave o si se utilizara el campo “Código” también como clave de búsqueda de promociones. Esto hará, que al momento de generar una promoción, se valide que no exista ya una promoción con el mismo código. Un usuario con el rol de administrador podrá activar o desactivar esta configuración. Ingresando en “Administración > Información de configuración”, en el filtro “Palabra a buscar” escribir: “clave”. En “promotion.codeKey” si se ingresa “true”, indicara que el campo “código” es clave junto con el “Nombre” (Ni el código ni el nombre de la promoción podrán repetirse en la base de promo). El valor por defecto es “false”, indicando que solo el campo “Nombre” será clave. Al habilitarse esta opción, al lado del campo “Código *”, se mostrará el botón “Autogenerar código”. Si el usuario presiona este botón, el sistema mostrará en el campo “Código *” un código que fue auto generado por el sistema, el mismo será único, no será repetido con los códigos existentes. El usuario puede dejar el código sugerido por el sistema y continuar con la carga. O puede modificarlo o ingresar el código que desee. El sistema siempre validará que ese código sea único. Si el usuario lo desea puede volver a presionar el botón “Autogenerar código” y el sistema mostrará un código diferente por cada vez que se presione este botón, y siempre será un código único. Cuando el campo "Código" esté habilitado para que funcione como campo clave podrá habilitarse también la opción de que éste código será de carga automática e incremental. Con esta opción activada, es el sistema el que asigna el Código a una promoción y no el usuario. Esta opción podrá activarse desde “Administración > Información de configuración”, en el filtro “Palabra a buscar” escribir: “incrementalID” y en el campo “promotion.code.active" se ingresa el valor "true". El valor por defecto es “false Si el código de promoción está configurado como clave e incremental, no se habilitará el botón de "Autogenerar Código".


Nombre y Código de Promoción Concatenados: Promo ofrece la posibilidad de concatenar al final del Nombre de la promoción el Código único asignado a la promoción, para que de esta forma el nombre continúe siendo único. Para esto debe configurarse el Código de la promoción como auto-generado y único (desde “Administración > Información de configuración”, en el filtro “Palabra a buscar” escribir: “incrementalID”. En “promotion.code.active" se ingresa el valor "true" y En el filtro “Palabra a buscar” escribir: “clave”. En “promotion.codeKey” si se configura el valor “true”). Teniendo estas opciones activas, podrá indicarse desde la sección de “Administración > Información de configuración”, ingresando en el filtro “Palabra a buscar”,promo.name.code", si se utiliza el nombre concatenado, ingresando "true" en el campo de esta configuración. El valor por defecto es "false". Cuando se dé de alta una nueva promoción, se presentará la siguiente pantalla donde deberá colocarse el nombre de la promoción, y el código se auto-generará.


Al presionar "Guardar" el código se auto-generará y será asignado a la promoción, en ese momento, se anexará el código de la promoción al final del nombre. En el listado de Promociones se mostrará el nombre de la Promo con el código auto-generado. También se mostrará el nombre con el código en los informes que involucren el nombre de la promoción. Al editar una promoción, podrá editarse el nombre, pero al presionar guardar, al nombre editado se anexará nuevamente un nuevo código único de la promoción.

Al momento de dar de alta un beneficio, los campos "Mensaje para el POS", "Mensaje para la Impresora" y "Mensaje para el Tlog" no se anexará de manera automática el código de la promoción, solo se mostrará el nombre de la promoción.



Si el workflow general está deshabilitado para el módulo de Promociones 

la consola traerá por default el primer workflow de la lista (en la vista Administración de Usuarios/Asociación a workflows), ordenada de forma alfabética.


Workflows asociados a un usuario:

  1. Si un usuario tiene asociados todos los workflows  definidos en la consola, al crear una nueva promoción, la consola traerá por default el Workflow General

2. Lo mismo sucederá si el usuario no tiene asociado ningún workflow.

3. Un usuario sólo verá en la vista "Gestión de Promociones" todas aquellas con workflows asociados al usuario.



4. En el caso que el usuario  tenga asociado todos los workflows definidos en la consola; excepto el workflow general, al crear una nueva promoción, la aplicación mostrará por default el primer workflow de la lista, ordenados en forma alfabética.



De no haberse adquirido el módulo de Redes Sociales, solo aparecerá la opción "Punto de Venta"


Si la promoción se publicará en algunas de las redes sociales deberá cargarse de forma obligatoria una imagen para su correcta visualización.



La forma de clasificar una promoción en tipo, sub-tipo y forma de aplicación de una promoción serán utilizados al momento de dar de alta una plantilla de Mapa. De esta forma, al generarse un mapa a partir de una plantilla de mapas que utilice estas clasificaciones, las promociones se ubicarán en los pasos y funciones de convivencia que correspondan a su tipo, sub-tipo y forma de aplicación. Los combos desplegables de "Tipo de promociones", "Sub-tipo de promociones" y "Formas de aplicación de promociones" mostrarán las opciones que previamente hayan sido cargadas desde el menú principal, seleccionando la opción Administración y luego la correspondiente opción. Por default, lo combos de "Tipo de promociones", "Sub-tipo de promociones" y "Formas de aplicación de promociones" mostrarán la opción "Genérico".



Al seleccionar un "Tipo de Promoción" cuando se define una promoción, en el combo "Sub-tipo de promoción" se listarán los sub-tipos de promociones que pertenezcan al tipo de promoción seleccionado. Y al seleccionar el Sub-tipo de promociones se listarán solo las formas de aplicación asociadas a ese Tipo/Sub-tipo.


Sugerencias (Punto de Venta)

Desde esta sección se podrá configurar si la promoción realizará sugerencias al cliente o no, si considerará el stock para realizar la sugerencia, o (desde Promo 7.4) si la sugerencia será Hiperpersonalizada.


Para que las promociones Hiperpersonalizadas sean sugeridas, se tienen que cumplir las Condiciones Simples\ Clientes o \Cupones.


Se mostrarán tres Tipos de sugerencias:

Para mostrar el Tipo de Sugerencia: "Simple" se considerarán los siguientes puntos:


Configuración del elemento Cliente en la PromoCumple con las Condiciones de la PromoMostrará las sugerencias
1No tiene elemento Cliente la promoen ParteSI (dependiendo de la configuración*)
2El elemento Cliente tiene una lista de Ids
(el ID ingresado en la transacción no está en la lista)
en ParteNO
3El elemento Cliente tiene una lista de Segmentos
(el Segmento ingresado en la transacción no está en la lista)
en ParteNO
4El elemento Cliente tiene una lista de Ids
(el ID ingresado en la transacción si está en la lista)
en ParteSI
5El elemento Cliente tiene una lista de Segmentos
(el Segmento ingresado en la transacción si está en la lista)
en ParteSI


Ejemplo con Tipo de sugerencia "Simple":

Se tiene armada una promoción que tiene habilitada la opción "Habilita sugerencias" y en el "Mensaje del POS" se ingresó un mensaje. En Condiciones Simples se tiene un código de producto específico por ej. SKU=1, y Cliente Tipo=VIP. Si en la transacción llega:


(A partir de Promo 7.4 "Sujeta a stock" es una opción dentro del combo seleccionable "Tipo de sugerencia").

Promo sugerirá la promoción en caso de corresponder, si se cumplen las consideraciones mencionadas para el Tipo de sugerencia "Simple" y además si el SKU del producto indicado tiene stock en el archivo correspondiente. Promo no valida la cantidad de stock de un producto, solo sugiere la promoción si corresponde.

En la ruta donde esté instalado el motor de Promo habrá un archivo que indicará cuales son los productos que tienen stock (para mayor detalle consultar el Manual de Integración - Motor). Si la promoción beneficia a un producto que está en ese archivo y el cliente no lo está llevando, le va a sugerir esa promoción; porque al existir el producto en ese archivo, significa que tiene stock. En ese archivo no se indica la cantidad de stock que tiene cada SKU. Si el SKU beneficiado no existe en el archivo, Promo no va a sugerir esa promoción porque considera que ese SKU no tiene stock. Ese archivo se actualiza automáticamente con información que envía el POS, si tuvo cambios, se actualizará cada vez que Promo chequea los mapas.

Si se habilita esta opción, Promo controlará la existencia de stock del producto beneficiado antes de realizar la sugerencia. Si no tiene stock, no realizará la sugerencia.


Ejemplo:

Se tiene armada una promoción que tiene habilitadas las sugerencias y en "Tipo de sugerencia" seleccionó: "Sujeta a stock", y en la mapa habilita las sugerencias. En el "Mensaje del POS" se ingresó "Lleve el producto X y le damos un 20% de descuento sobre el producto J". En Condiciones Simples tiene definido que llevando el producto X da como beneficio un 20% de descuento (el universo de aplicación del beneficio) sobre el producto J. Cuando el cliente esté en la caja y no esté llevando el producto J, entonces Promo va a verificar si tiene stock del producto J y si lo tiene le va a mostrar la sugerencia "Lleve el producto X y le damos un 20% de descuento sobre el producto J".

En este ejemplo el control de stock se maneja por Universo de Aplicación, no por Condición Simple, y se maneja por SKU (no se puede poner por marca por ej. siempre es por SKU) sí se puede ingresar varios SKUs, si hay stock de alguno entonces va a sugerir la promoción.


El producto cuyo stock se está controlando debe formar parte de la promoción como producto beneficiado. Si el conjunto de aplicación contiene múltiples SKUs, y alguno tiene stock, la promoción será sugerible.


Si se genera una promoción con sugerencia por stock y cliente, se plantean dos comportamientos:
      • Si cumple la condición de stock (hay stock disponible) y no cumple la condición de cliente, no la debe sugerir.
      • Si cumple la condición de cliente, pero no la de stock (no hay stock disponible), no la debe sugerir.
Cuando conviven ambas sugerencias; éstas deben cumplir las condiciones al mismo tiempo para que se sugiera la promoción.


Las promociones que se sugieran como Hiperpersonalizadas serán prioritarias por sobre el resto de las promociones sugeridas (Simples y Sujeta a stock).

Para mostrar el Tipo de sugerencia "Hiperpersonalizada", en la promoción en las Condiciones Simples, el cliente debe pertenecer a todos los segmentos configurados en la promoción (excepto los segmentos que están bajo el comparador "Distinto"), la promo debe estar marcada como Hiperpersonalizada y el cliente que se presente en el POS debe tener asignado ese Segmento.

Cualquier promoción puede tener el Tipo de sugerencia "Hiperpersonalizada", ya sea una promo para cambiar el precio en el surtidor, o de programa de objetivos o cualquier promoción.

Los segmentos externos no se utilizan con sugerencia Hiperpersonalizada.


Si el cliente selecciona (en el POS) una Promo Hiperpersonalizada, esa promoción se otorgará acorde a como esté armado el mapa (ponerla en un primer paso para que la tome como prioritaria sobre el resto de las promociones). Se puede utilizar cualquier función. Si se está utilizando la función MDC (Máximo Descuento Combinado) se la considerará como prioritaria.

Si el cliente no selecciona ninguna de estas promociones Hiperpersonalizadas (en el POS) la venta continuará como se hace habitualmente, sin aplicar una promoción Hiperpersonalizada.

Las promociones Hiperpersonalizadas se mostrarán solo una vez en el POS. Se haya seleccionado/aplicado alguna o no, luego se podrá otorgar promociones que no sean hiperpersonalizadas en la misma transacción.



Este apartado explica los pasos necesarios para simular promociones hiperpersonalizadas en la consola de promo. Las promociones con sugerencias hiperpersonalizadas son prioritarias sobre el resto de las promociones sugeridas y se configuran para ofrecer beneficios específicos a clientes pertenecientes a segmentos determinados. Estas pueden incluir descuentos, precios especiales u otros incentivos que mejoren la experiencia del cliente.

La simulación de una promoción hiperpersonalizada se realiza en dos pasos principales. Este proceso asegura que las promociones sean correctamente asignadas según el segmento del cliente y las condiciones de la promoción.

Pasos para Simular Promociones Hiperpersonalizadas

  • Creación de Segmentos

    • Accede a la sección de "Segmentos" en la consola.

      • Crea un nuevo segmento asignándole un nombre representativo.

      • Asocia clientes al segmento recién creado via archivo o servicio.

      • Verifica que los clientes estén correctamente asignados al segmento, consultando al cliente por consola o desde el punto de venta integrado con Promo.


Los segmentos externos no se utilizan con sugerencias hiperpersonalizadas.



  • Creación de una Promoción con Sugerencia Hiperpersonalizada
    • En la sección de "Promociones", crea una nueva promoción.

      • Configura los parámetros de la promoción, asegurándote de seleccionar el Tipo de Sugerencia "Hiperpersonalizada".

      • Define las condiciones simples que deben cumplir los clientes para que se les aplique la promoción (deben pertenecer a todos los segmentos configurados).

    • Resultado esperado: La promoción queda registrada y lista para ser simulada.



Cualquier promoción puede tener el Tipo de Sugerencia "Hiperpersonalizada", ya sea una promo para cambiar el precio de artículos, o de programa de objetivos.


Paso 1: Sugerir las promociones hiperpersonalizadas

  • En la consola, accede a la funcionalidad de simulación.

  • Haz clic en el botón Simular.

  • Selecciona el mapa que contiene la promoción hiperpersonalizada. Este mapa debe estar configurado previamente para asociarse con las promociones correspondientes.

  • En la pantalla, se mostrarán todas las promociones hiperpersonalizadas disponibles para el cliente según su segmento.



Paso 2: Aplicar la promoción seleccionada

  • Editar los datos del cliente en el ticket de simulación:

    • Haz clic en el botón Editar dentro del ticket de simulación.
    • Editar el cliente.
    • En el campo “Promoción hyper”, ingresa el ID de la promoción que deseas aplicar. Este ID se obtiene del listado generado en el paso anterior.


  • Haz clic en Continuar para guardar los cambios.

  • Simula nuevamente:

    • Selecciona el mismo mapa que contiene la promoción hiperpersonalizada.
    • Haz clic en el botón Simular.
  • En esta etapa, se aplicará la promoción seleccionada al cliente, y podrás observar que el ticket muestra la promoción otorgada.




  • Errores comunes: Verifica siempre que el ID de la promoción se haya ingresado correctamente para evitar resultados inesperados durante la simulación. Un ID erróneo puede causar que la promoción no se aplique o se genere un mensaje de error.

  • Recomendaciones para pruebas: Realiza simulaciones con diversas combinaciones de clientes, segmentos y configuraciones de mapas. Esto permitirá identificar posibles inconsistencias y asegurar que el sistema responda adecuadamente a diferentes escenarios.







Al activar el check correspondiente a "Habilitar Sugerencias" y NO indicar un valor para el campo "Mensaje del POS" y guardar los cambios, Promo emite un popup con la leyenda "Si la promoción incorpora sugerencias, debe ingresar el mensaje del punto de ventas" como se muestra a continuación:



Para que se muestre la sugerencia además de habilitarla en la promoción hay que activar en la cabecera del Mapa que se muestre la sugerencia, seleccionando: "Sugerir SIEMPRE" o "Sugerir de acuerdo a la PROMOCIÓN" para cualquiera de los tres tipos de sugerencias: "Simple", "Sujeta a stock" o "Hiperpersonalizadas".

Ver detalles en: HABILITAR SUGERENCIAS EN EL MAPA.



Imagen Asociada (Formato PNG únicamente) 

La imagen no debe superar 1MB de tamaño y debe estar en formato .PNG o .JPG. La imagen subida se mostrará en Promo en la pantalla "Gestión de Promociones", en la definición de la promoción y si se utilizan los canales Facebook y Twitter se les enviará la imagen (no se enviará al POS).

Una vez cargados estos los campos según corresponda, se deberá presionar el botón "Guardar" y se pasará a la pantalla de "Definición de promoción".


Definir una Promoción

Para concluir el proceso de generación de una promoción se deberán completar los siguientes datos en la pantalla "Definir Promoción".

Cabecera:  Muestra los datos ingresados en la pantalla anterior. Los datos mostrados en el recuadro rojo serán traídos por el sistema. Se dispone de un botón "Editar" (permite volver a editar la cabecera) y un botón "Resumen".


ID de Promoción en Cabecera

Se agregó el ID de la promoción en la cabecera de la promocion en la consola de promo. Este ID es un identificador único almacenado en la base de datos MongoDB, y permite realizar simulaciones y validaciones precisas de cada promoción. Asegúrate de utilizar este número al configurar simulaciones o al verificar el comportamiento de las promociones en mapas y segmentos.






Resumen de promoción:

El Resumen mostrará los datos principales de la promoción, las condiciones y beneficios de la misma.


ID de Promoción en Resumen

Se agregó el ID de la promoción en el resumen de la promocion en la consola de promo. Este ID es un identificador único almacenado en la base de datos MongoDB, y permite realizar simulaciones y validaciones precisas de cada promoción. Asegúrate de utilizar este número al configurar simulaciones o al verificar el comportamiento de las promociones en mapas y segmentos.





Imagen asociada:  En caso de no haberse cargado una anteriormente, se podrá realizar la carga desde la opción "Agregar imagen".


Definir Condiciones por Rango Horario: 

Las condiciones del tipo Rango Horario son aquellas que evalúan sobre características propias de la transacción en curso, permitiendo crear condiciones basadas en datos propios tales como fecha con hora, hora y periodicidad. 


Desde Administración\ Información de Configuración, se puede configurar que sea o no obligatorio el ingreso de la Condición Fecha con Hora. Requiere condición Fecha con hora (default=false).



En Fecha inicio, traerá por default la fecha actual. En este campo se indicará la fecha que dará inicio a la frecuencia que se indicará a continuación. En el campo Aplica cada, debe desplegar el combo día/s para seleccionar el tipo de frecuencia deseada.

Puede seleccionar las siguientes frecuencias:


(En Días que aplica, puede seleccionar varios días presionando la tecla Ctrl y haciendo click con el mouse).


Cabe aclarar que para este caso se debe definir previamente un rango horario, en donde se le dé una fecha de inicio y fin en la cual se aplicará cada x día del mes. Si no se define rango horario se repetirá de forma indefinida la aplicación de la promoción cada x día del mes que se haya seleccionado. Por este motivo se grisa y no se puede editar la Fecha de inicio en esta pantalla.


Antes de crear este tipo de frecuencia es necesario que agregue la condición de fecha con hora. En esta pantalla no se habilitara la edición de la Fecha de inicio porque toma la de fecha con hora.

Para el caso de que el usuario seleccione el día 31 de un determinado mes, en el rango de meses que haya seleccionado no todos los meses van a tener 31 días por lo cual Promo aplicará la promoción al último día de cada mes según corresponda.

Si se selecciona por ejemplo el 31 de enero, al aplicar la promoción en febrero, como este sólo tiene 28 o 29 días, la aplicará el último día de ese mes.



Definir Condiciones simples


Elementos

Llamaremos Elementos a los distintos tipos de componentes que podrán formar parte de una promoción. Estos componentes serán parte tanto de la condición de la promoción como también del beneficio.

Se debe seleccionar el o los tipos de elementos sobre el cual se definirá la condición utilizando los siguientes botones:

Los atributos disponibles por default para cada uno de los elementos disponibles son:


La cantidad máxima recomendada a cargar en las Condiciones es de 3.000 ítems.



Desde Administración\ Información de Configuración, se puede configurar que sea o no obligatorio la Validación de Vigencia de tipo de Cupón Vs Vigencia de la promoción. Valida Fecha de vigencia del tipo de cupón contra la vigencia de la promoción. (Default=false)



Se agregaron tres atributos más al ítem de clientes en las condiciones que se usarán para definir Condiciones Generales, Plantillas de Promociones y Promociones:


  1. Cumpleaños: Podrá indicarse que en la fecha de la transacción  es o no el cumpleaños del cliente.
  2. Edad: Indica la edad del cliente
  3. Datos incompletos: Indicará si el cliente tiene incompletos uno o más datos; por ejemplo: mail, dirección, etc.



Desde Administración\ Información de Configuración, se puede configurar que sea o no obligatorio el ingreso de Cliente. Requiere condición de Cliente (default=false)






El botón "Transacción" se mostrará en color naranja porque hace referencia a atributos de la cabecera del ticket.


Desde Administración\ Información de Configuración, se puede configurar que sea o no obligatorio el ingreso de una condición definida por medio del elemento "Transacción". Requiere condición de Transacción  (default=false).


Se pueden agregar diferentes tipos de moneda, para ser utilizado como “Condición Simple” de una promoción:
  • Se pueden agregar por catálogo: Se podrá cargar por catálogo los diferentes tipos de moneda, para el caso de querer utilizar moneda extranjera.
  • Se pueden agregar directamente en las Condiciones Simples: Al editar o crear una promoción, en la sección “Condiciones Simples”, al seleccionar el elemento “Transacción” mostrará el atributo “Moneda”, que desplegará los comparadores “Igual” y “Distinto”. Al comenzar a escribir en el cuadro de diálogo de cada uno de ellos, sugerirá de acuerdo a lo cargado en el catálogo si es que tiene, si no selecciona una opción sugerida, o si desea ingresar una opción diferente la puede escribir y presionar la tecla tabulador en esta pantalla.
Al contar con el atributo “Moneda” se podrá definir promociones puntuales para determinada moneda. Si la moneda no se define como parte de la condición, aplicará la promoción para toda moneda. Para beneficios del tipo descuento de Nuevo Precio, en los casos de moneda extranjera, se deberá definir exclusión de la moneda extranjera o definir promociones puntuales, caso contrario, si la moneda no se define como parte de la condición, aplicará para toda moneda.  Para las promociones que utilizan elementos de fidelidad o cupones, se deberá considerar que si la transacción es con moneda extranjera, y debiera aplicar a esa moneda, se tendrá que resolver creando un tipo de elemento de fidelidad o cupón diferente (su monto aplicará para esa moneda, no se acumulará en ambas).

Utilizando las flechas presentes en la definición de cada elemento se desplegará el listado de atributos y dentro de cada atributo se visualizará un listado de comparadores.

Comparadores

Las opciones que se manejan para la mayoría de los atributos son:


Por ejemplo, se puede generar una condición por el elemento "Producto", seleccionando el atributo "Departamento" y el comparador "IGUAL" donde se presentará la siguiente pantalla:

Se podrá aquí también cargar los datos de la condición por medio de un archivo, presionando el botón "Seleccionar Archivo". El archivo a cargar podrá ser un .xls o un archivo de texto plano separado por el delimitador configurado.

En esta pantalla podrá seleccionarse el tipo de " entre los elementos". Con ellos se podrán relacionar elementos a través de los siguientes operadores lógicos: 

Exportación de datos de una Condición Simple o Condición por Composición a Excel:

Al momento de definir una Condición Simple o una Condición por Composición, podrá exportar los datos ingresados a un archivo Excel, seleccionando en la pantalla anterior el botón "EXCEL".  Esta opción se presentará en todos los pop ups de todos los atributos de elementos , ya sea que se defina por "Igual" o "Distinto". Al presionar el botón "EXCEL" se descargará un archivo .xlsx de una sola hoja, con los datos presentes en el pop up. Se presentarán en el mismo orden en que se ingresaron en el pop up y ubicados en la columna A, uno debajo del otro. El nombre del archivo contendrá el código de la promoción, el tipo de condición, el elemento y el atributo que se está descargando. 

Ejemplo:


IMPORTANTE: Solo se habilitará el botón "EXCEL" cuando al menos haya un dato cargado válido en el pop up.


NOTA: La posibilidad de importar datos a un Excel estará disponible tanto para atributos propios de Promo como para atributos dinámicos.
Exportación de datos cuando el pop up de edición esté bloqueado por cantidad de datos:

Cuando se suben al pop up de condiciones más de "500" posiciones se bloqueará la posibilidad de edición manual del pop up y en caso de tener que editar los datos ingresados, el sistema solicitará eliminar todos los datos y volver a cargarlos.

El botón marcado en rojo en la siguiente pantalla permitirá la descarga del Excel con los datos de la condición cuando ésta supera la cantidad de datos permitidos. Este botón sólo aparecerá cuando la opción de edición de la condición este bloqueada por exceder la cantidad de datos permitidos para la edición.


Se podrá seleccionar la cantidad de atributos que desee para definir en la condición. Por ejemplo, productos con Departamento igual a Electrónica, y que además sean de Marca igual a SONY, WHIRLPOOL, HITACHI, PANASONIC y PHILIPS.

Cada elemento tiene la opción de poder seleccionar "Aplicar a TODOS", y al hacerlo, la condición se aplicará a todo el conjunto del elemento seleccionado.


Los conjuntos resultantes también podrán ser utilizados para combinar con otros nuevos conjuntos. 


Los Atributos definen las características de los elementos con los cuales se realizará la selección de pertenencia a un determinado conjunto y los mismos dependerán del tipo de conjunto o elemento seleccionado. 


Para definir un criterio de agrupación, se deberá dar clic en el icono de "Lápiz" que se presenta a la derecha del elemento que se quiere agrupar (en este ejemplo el elemento Productos).


Se presentará el Pop-Up "Condiciones simples (agrupación)" con un menú desplegable que mostrará opciones de agrupación.

Para cada atributo de aplicación se utilizan los siguientes comparadores:


Si se selecciona, por ejemplo, "Mayor que" se desplegará el Pop-Up con las siguientes opciones:


En este ejemplo, se podrá indicar para el elemento "Producto" los criterios de agrupación por "Cantidad", "Magnitud" o "Precio Total", como se muestra en la siguiente imagen:

PROMO permite manejar conjuntos por agrupación de los siguientes elementos:


Cuando se defina una condición por medio del elemento "Medio de Pago", podrá indicarse si se desea evaluar que dicho medio de pago cubra el saldo total de los elementos beneficiados. Para ello, se presionará en el "lápiz" que esta a la derecha del elemento "Medio de Pago" y allí se presentara el PopUp de "Condiciones simples (agrupación)" y entre las opciones de agrupación propuestas estará "Pago Total Productos Beneficiados". Al seleccionarlo se estará indicando que el monto del pago ingresado en la transacción deberá cubrir en su totalidad a los ítems beneficiados.


Otros ejemplos de agrupación podrían ser:



Definir Condiciones por composición

Las promociones por composición, combo o paquetes son aquellas que se aplican al cumplirse la formación de un subtickets con los datos del contexto recibidos del POS. esta forma de definición de Promociones tendrá en consideración las iteraciones en el cumplimiento de la condición definida. Por ejemplo: "2X1 en Fanta". (Cada dos Fantas vendidas se aplicará un 100% de descuentos en una)


Un combo puede estar compuesto por N componentes.


En las promociones por composición o combo, el o los elementos a beneficiar, DEBEN estar definidos como un componente de combo.


Para poder crear éstas promociones se deberá agregar uno o varios elementos en la sección "Condiciones por composición".

Cada componente de un combo está integrado por un elemento, los cuales tendrán cada uno su propia configuración. 

Los "Combos" son agrupaciones o subtickets dentro del contexto de la transacción y los beneficios se aplicarán al cumplirse las condiciones indicadas en dichos subtickets, como si fuera un ticket completo. 

Para agregar un componente de combo se debe seleccionar el botón "Agregar" y se desplegarán los elementos con los que se podrán definir los combos como se muestra en la siguiente imagen: 


Al seleccionar uno de los elementos se mostrará el siguiente Pop-Up: (para este ejemplo se seleccionó el elemento "Productos")

En un Componente Combo se asocian los siguientes datos:


En general mínimo y máximo se van a utilizar con valores iguales.


Si el "Tipo de Elementos" seleccionado es "Producto", el combo desplegable de Unidad de medida mostrará las opciones "Cantidad", "Magnitud", "Precio Total".

Si el "Tipo de Elementos" seleccionado es "Cupones", el combo desplegable de Unidad de medida mostrará las opciones "Cantidad" y "Monto".

Si el "Tipo de Elementos" seleccionado es "Medios de pago", el combo desplegable de Unidad de medida mostrará la opción "Monto".

Si el "Tipo de Elementos" seleccionado es "", el combo desplegable de Unidad de medida mostrará las opciones "Saldo" y "Puntos".

Si el "Tipo de Elementos" seleccionado es "Elementos de fidelidad", el combo desplegable de Unidad de medida mostrará la opción "Monto".


Los criterios de selección definen de un modo más acotado la selección de elementos del contexto para la formación de las condiciones por composición (paquetes o combos).
Los mismos se podrán definir en los beneficios de la promoción y en la definición de condiciones por composición. Solo pueden aplicarse sobre conjuntos del tipo producto.


Si en en el botón  Agregar se seleccionó el elemento "Medios de pago" en Criterios de equivalencia se mostrarán las siguientes opciones:  [indistinto], Código, Tipo, Banco, Plan, Cuotas, Monto del Item, Prefijo, Campaña Crediticia. Y en Criterios de inequivalencia se mostrarán las siguientes opciones: [indistinto], Monto del Ítem, Plan, Tipo, Banco, Monto, Prefijo, Código, Cuotas, Campaña Crediticia. No estará disponible la opción "Criterio de Ordenamiento" para el elemento "Medio de Pago"


Exportación a Excel de datos cargados en las condiciones

Se podrá tanto en las definiciones de condiciones simples como en condiciones por composición, exportar a excel los datos cargados. Para ello se deberá presionar en el botón "EXCEL" que se ubica a en el margen inferior derecho de los popUps.

Este botón solo estará activo cuando haya al menos un elemento cargado en la condición. 

Al presionar el botón "EXCEL" se descargara una planilla con todos los datos contenidos en la condición.

En el nombre del archivo se detallara a que promoción y tipo de condición pertenece. Ejemplo: "10001_condicion_simple_productos_departamento.xlsx"


Definir Beneficios

Los Beneficios son parte integrante de las Promociones y los mismos son asignados para determinar la consecuencia de haber cumplido con las condiciones de una promoción.

El beneficio es una ventaja económica o material que se le otorga a un cliente ante el cumplimiento de ciertas condiciones.

Los beneficios se aplican sobre todo en el contenido del ticket o sobre los subtickets según se hayan armado por condiciones simples o condiciones por composición.

Las promociones definidas por condiciones simples, entregan el beneficio con solo el cumplimiento de la o las condiciones definidas.

Las promociones con condiciones por composición, entregan el beneficio sobre cada paquete o combo que se haya definido.

Se deberá presionar "Nuevo beneficio" para acceder a la ventana de definición del beneficio.



Se presentará la pantalla "Nuevo Beneficio" en donde se mostrarán las siguientes opciones:


Al definir el Universo de Aplicación del beneficio en el caso de que se agregue más de un atributo (atributos son por ej: Código, Precio unitario, Marca, etc.).


Aparece la posibilidad de utilizar una de estas tres funciones: si TODOS, si ALGUNO, Que NO se cumplan las siguientes condiciones:


Si utiliza la función si TODOS debe tener en cuenta no repetir atributos.

 

Seleccionando la función si TODOS, si combina por ej: Precio unitario\ Igual y Marca\ Igual si es válido:


Lo que no se debe hacer es repetir el atributo (ej: Código (SKU)). Por ej no es válido:



Beneficios Monetarios:


De seleccionarse en Tipo de Beneficio la opción Monetario, en "Clase de Beneficio" se podrán seleccionar:




Para la correcta configuración y aplicación de una promoción que aplique un beneficio externo deberá definirse lo siguiente:
  • Condición:

Seleccionando en la sección "Condiciones Simples" al elemento "Beneficio Externo", deberá indicarse si desde el POS identificara por <Tipo> o <Id> al beneficio externo a aplicar. En la promoción podrán definirse mas condiciones por mas elementos que condicionen aun mas la aplicación del beneficio, pero será indispensable la definición de la condición por medio del elemento Beneficio Externo para que se aplique correctamente la promoción:

  • Beneficio:

En la promoción, deberá agregarse un beneficio del tipo Monetario, de la clase "Beneficio Externo" donde se deberá indicar el mismo Tipo definido en la condición, o el mismo tipo al que pertenezca el ID del elemento beneficio externo definido en la condición:

De esta forma, cuando el POS envíe el elemento Beneficio Externo con el Tipo definido en "a" se aplicara el monto o porcentaje de descuento informado por el POS en el elemento "Beneficio Externo".(Para mas información sobre la integración con el POS, ver Manual de Integración, Beneficios >> Beneficio Externo)



Para la correcta configuración y aplicación de una promoción que aplique un beneficio de la clase "Canje con Opciones" deberá definirse lo siguiente: La/s condiciones definidas en la promoción serán las que defina el retailer para indicar en que momentos el cliente accederá a las opciones que se proponen en el "Canje con Opciones": Al definir un nuevo beneficio, se indicara que es del tipo "Monetario", de la clase "Canje con Opciones". Al seleccionar esta clase de beneficio se podrán ingresar "Opciones" que el POS propondrá al cliente en base a los puntos que éste posea:

En el campo "Beneficio a Aplicar", podrán seleccionar entre los beneficios monetarios que se quiera aplicar ("Descuento Fijo", "Descuento Porcentaje" o "Nuevo Precio").

Al seleccionarse uno de los beneficios, se presentaran los campos de definición propios del beneficio y de los puntos a presentar por el cliente y/o elementos de fidelidad para acceder a dicho beneficio:

Deberá presionarse "Agregar Opción" para que lo definido quede incorporado como una opción dentro de este. Para que el beneficio se considere completo deberá de ingresarse al menos una opción. Podrá ingresarse tantas opciones como sea necesario:

Una vez agregada una opción no podrá editarse, deberá eliminarse y volver a agregarse.
Al cumplirse con las condiciones definidas en la promoción, el motor evaluará si el valor en puntos del ítem ingresado está cubierto por los puntos requeridos definidos en el beneficio. Si no alcanza, el beneficio no se aplica. Si el valor en puntos del ítem es menor a los puntos requeridos en el beneficio, este no se aplica.
Asimismo, podrá indicarse si el beneficio a otorgar contempla la existencia de Puntos provenientes de elementos de Fidelidad. Al hacerlo, por ejemplo, seleccionando "Descuento por Porcentaje", se presentarán las siguientes opciones. Los campos "Tipo de Elementos de Fidelidad" y "Puntos de Elemento de Fidelidad" serán opcionales y solo cuando se carguen se validará que se haya ingresado en la transacción una tarjeta del tipo definido y con los puntos necesarios para otorgar el beneficio. En el "Tipo de Elemento de Fidelidad" deberá indicarse el código del tipo de elemento de fidelidad a evaluar para acceder al descuento. Mientras que en el campo "Puntos de Elemento de Fidelidad" deberá definirse la cantidad de puntos a presentar para obtener el beneficio.
Escenarios de definición de promociones de canje de Puntos de fidelidad:

  • Puntos de fidelidad

Ejemplo: "Presentando 10 Puntos de fidelidad Rojos" obtén 100% de descuento en gaseosas
>> La condición será la venta de al menos una gaseosa.
>> El beneficio a aplicar será un Monetario >> Canje con opciones, definido de la siguiente forma:

  • Puntos de Fidelidad + Descuento Monetario
Ejemplo: "Presentando 10 Puntos de fidelidad Rojos" obtén 50% de descuento en gaseosas

  • Puntos de Fidelidad + Descuento monetario + puntos del cliente 
Ejemplo: "Presentando 10 Puntos de fidelidad Rojos y canjeando 100 puntos obtén 50% de descuento en gaseosas
  • Puntos de fidelidad + Puntos del cliente

Ejemplo: "Presentando 10 Puntos de fidelidad Rojos y canjeando 100 puntos obtén 100% de descuento en gaseosas

NOTA: Todas las opciones podrán coexistir dentro de un mismo beneficio Canje con Opciones.
(Para mas información sobre la integración con el POS, ver Manual de Integración, Beneficios >> Canje con Opciones)

Calculo de puntos a consumir en base a productos ingresados por Magnitud: Cuando una promoción que otorgue un beneficio Canje con Opciones, sea definida en base a la unidad de medida "Magnitud" (tanto en condición Simple como por Composición), el calculo de puntos a consumir será en base a 1 (un) kilogramo. De esta forma, podrá indicarse, en base a los puntos requeridos por la opción del beneficio, cuantos puntos se requerirán para obtener el beneficio de un producto medible. Los puntos informados en la opciones, siempre serán los calculados en base a 1 (un) kilo. Al seleccionarse una de las opciones, el motor devolverá la cantidad de puntos calculados en base a la magnitud enviada para el o los productos beneficiados.
Ejemplo: Podrá adquirir con un 20% de descuento manzanas canjeando 200 Puntos. Lo definido en la promoción, será la base del calculo, es decir, la cantidad de puntos requeridos para el Kilo (un).Cuando el cliente selecciones dicha opción, el motor calculara, en base a la magnitud informada para las manzanas desde el POS, la cantidad de puntos a requerir para acceder al beneficio.

Magnitud informadaPuntos requeridos
1 (k)200 (definido)
0.80 (k)160
5 (k)1000




Existe la posibilidad de evaluar promociones que otorguen un beneficio Monetario de la clase "Canje con Opciones". Al incluir este beneficio en la evaluación de la función de convivencia "Máximo Descuento Combinado", se podrá proponer al cliente la opción que aplique el mejor descuento al contexto de la transacción. En caso de que el cliente no elija una opción, se otorgara la o las siguientes promociones que otorguen el mejor beneficio al contexto dado.

Las promociones que otorguen este beneficio, cuando se encuentren dentro de esta función de convivencia podrán tener una cantidad de opciones indefinida, pero al momento de la evaluación en el motor, solo se tomaran las dos primeras opciones para la evaluación.



Cuando en una misma transacción, se otorgue una promoción que otorga puntos (ya sean propios de Promo o externos) podrá indicarse por medio de la mensajería entre Promo y el POS, que el motor realice los cálculos correspondientes para que solamente se calculen los puntos a otorgar en base a los montos que no fueron beneficiados con la promoción de canje con opciones que redime los puntos. Solamente el calculo se realizara cuando el POS mande los datos necesarios para realizar el calculo en el elemento pago y cuando se este aplicando un beneficio de canje con opciones que redime puntos. Para mas información sobre la mensajería, ver manual de integración Promo - MOTOR >> Atributos de Comandos > Elemento "payment".



Se podrá de indicar al momento de definir el beneficio si el nuevo precio a aplicar será informado por un externo cuando se alcance una determinada cantidad de productos vendidos. Tanto la cantidad de puntos requeridos como el nuevo precio a aplicar a partir de dicha cantidad serán informado a nivel ítem desde el POS. Esto podrá indicarse colocando un tilde en "Precio informado por el POS". Al hacerlo se deshabilitará el campo de definición de nuevo precio y cantidad ya que este dato se informara desde el POS.



Deberá definirse un beneficio del tipo Monetario, "Canje de Puntos por Catalogo", allí deberá de especificarse el tipo de tarjeta que aplicara para la evaluación del canje de puntos según lo indicado en el catalogo "CatalogRedeemBenefit":

Una vez definido el beneficio, podrá agregarse la promoción que lo contenga a un mapa y distribuirse a las tiendas que aplique. Deberá definirse el catalogo en donde se indique Tienda, código de producto, puntos requeridos, valor del descuento y tipo de descuento respetando este orden de las columnas. Tener en cuenta que la condición de la promoción deberá contener la definición por alguno de los atributos de los ítems que se definen en la tabla. (ejemplo: La condición de la pomo indica "Para todos los Productos de la marca Sony", y en la tabla se deberán indicar SKU que correspondan con la marca Sony).

Store (código de la tienda donde aplica, - indica todas)code (código del producto)points(puntos requeridos)discountValue (Valor descuento)discountType (Tipo descuento)
B320100010010perc
-3000305perc
B32020006027fix
A9221001801500fix
B320100270487.89nprice
  • En el caso de que no se indique el código de tienda se asume que dicha opción de canje aplica para todas las tiendas.
Para el ejemplo dado, cuando en la tienda B320, se ingrese en una transacción un Ítem de la marca Sony, y este sea del code="2000", y en la transacción se encuentre también una tarjeta del tipo "555" con los puntos suficientes para realizar el canje según, en este caso "80", se aplacara un descuento fijo se $27 sobre el ítem code="2000"


Para cada uno de los beneficios Monetarios también deberá indicarse:




Beneficios NO Monetarios:

De seleccionarse en Tipo de Beneficio la opción No Monetario, en "Clase de Beneficio" se podrán seleccionar:


La información a mostrarse en el campo "Monedero" viene por catálogo si está integrado con Vtol será un campo autocompletable por lo que irá mostrando la información a medida que escribe, si no está integrado con Vtol puede completar a mano con lo que desee.

Para recibir la información de VTol debe configurar en Administración\ Información de Configuración, en vtol.url la url que corresponda para obtener los Monederos de VTol, siguiendo el formato del ejemplo:


Por ejemplo: Si paga con Modo y tiene 365 tiene un límite máximo de 200 (campo Límite) y le dan 10% de descuento (campo Porcentaje). Todos estos son campos informativos.



Al momento de redimir un cupón (emitido por medio de la aplicación del beneficio no monetario "Cupón"), deberá considerarse que el tipo de cupón al que pertenece el cupón que se pretende redimir deberá definirse como condición en la promoción de redención. En caso de no definirse, al momento de finalizar la transacción Promo devolverá un mensaje de error, informando que no se ha cumplido con los requisitos para el canje del cupón por el beneficio que otorga la promoción.


Al momento de seleccionar la clase "Cupón" se podrá indicar en el combo "Datos para el POS" si se envía información adicional al POS al momento de informar el beneficio. Los nombres de las dos opciones a mostrar en el combo podrán definirse desde la sección de "Administración", "Información de configuración". El POS en base a estas opciones podrá realizar acciones especificas al momento de otorgar el beneficio Cupón y dependerá de como se implemente en el retail. El campo "Datos para el POS", mostrará por default las opciones: "Indistinto" (siempre estará presente y de seleccionarlo no se indicará información extra al POS referente a los datos para el POS), Campo 1 y Campo 2. (Ver Administración >> Información de Configuración)


    Se debe crear la promoción que redime el cupón:




Al momento de seleccionar la clase "Cupón Calculado", mostrará el combo "Que aplique *", desde donde se podrá seleccionar:
  • Porcentaje
  • Monto Fijo
  • Monto Externo


Cupón Calculado definido por PORCENTAJE: Al seleccionarlo, se mostrará el campo "Porcentaje" en donde deberá de ingresarse el número que representará el porcentaje con el que se calculará el monto del cupón a emitir.
Se debe crear la promoción que redime el cupón:

Cuando se va a usar el cupón, en el POS se escanea ese cupón. El POS envía a Promo el número de cupón. Promo busca en la base de datos la info de ese cupón. Ahí si era por ej. un cupón calculado que da el 10% de descuento para la siguiente compra, levanta esa info de la base de datos y Promo hace el cálculo del 50% del ticket actual porque se está redimiendo el cupón.

El monto del cupón no se puede consumir en diferentes transacciones. Si en una transacción hay sobrante en el cupón; éste se pierde.


Con esta definición se indicará que la promoción dará como beneficio el valor que tenga cargado en la base de datos el cupón ingresado.
En caso de que se requiera acotar aún más la aplicación del beneficio podrán especificarse más datos en los campos "Método de Prorrateo", "Aplica sobre…" y "Criterio de Ordenamiento".
Cupón Calculado definido por MONTO FIJO: Al seleccionarlo, se mostrará el campo "Monto Fijo" en donde deberá de ingresarse el número que representará el monto o valor con el que se emitirá el cupón al aplicar el beneficio:



Cupón Calculado definido por MONTO EXTERNO: Al seleccionarlo, no se propondrá definir ni un monto ni un porcentaje, ya que ese dato será informado por el POS (o un externo)

Al realizarse el calculo del monto de un cupón calculado que se emitirá en el punto de venta, podrá indicarse por configuración, si el valor a asignar al cupón será calculado en base al precio beneficiado o al precio original del producto beneficiado, cuando las promociones se encuentren dentro de un mismo paso. Para ello deberá de definirse en el config.xml del motor el parámetro </adjustCalculatedCoupon> en "true" (ver PROMO - Manual de instalación) y deberá definirse el beneficio que otorga el cupón calculado para que opere con el precio beneficiado. Teniendo en cuenta que dentro de un mismo paso, los beneficios son calculados en base al valor del producto con el que entro en el paso, al activarse esta funcionalidad, para el calculo del valor del cupón calculado, se tendrán en cuenta los beneficios que hayan podido aplicar dentro del paso.



La opción "Acumular el monto de beneficios en un cupón único" indica si el beneficio aplica o no el acumulado en un único cupón. Al aplicarse un beneficio del tipo No monetario de la clase cupones calculados se debe emitir un solo cupón que acumule el valor de todos los ítems beneficiados (grupos de apply).Si se especifica mas de 1 cupón, se divide el beneficio por la cantidad de cupones a emitir, es decir si había que dar 100 pesos en beneficio y se puso 2 cupones, se emiten 2 cupones de 50 pesos cada uno. Para ello en la consola se debe tildar el checkbox "Acumular el monto de beneficios en un cupón único":


Al definir un beneficio de cupón o cupón calculado y querer validar la vigencia de la promoción vs la vigencia del tipo de cupón  las variables valid.date.couponType y dateTime.required deben ser configuradas con valor true.



Entre los beneficios que otorgan puntos (factor, coeficiente y puntos de fidelización) existe el campo "Ignorar pago con puntos". Esta funcionalidad permitirá al POS gestionar la información necesaria para identificar, en caso de aplicar, cuando se esta otorgando un beneficio de canje de puntos al mismo tiempo que se otorga un beneficio que otorga puntos, y solamente otorgar los puntos que correspondan al pago realizado y  que no corresponden al canje de puntos. Al detectarse en la transacción que existen beneficios de fidelización (“Coeficiente de fidelización”, “Porcentaje de fidelización” y “Puntos de fidelización”) que contengan el atributo "Ignorar Pago con Puntos" en false (destildado) se aplicara la lógica de calculo para obtener el numero

final de puntos a otorgar

Por defecto, el flag vendrá destildado (false) indicando que no se deberán acumularse puntos sobre los pagos que se realizaron con puntos.


Para los beneficios No Monetarios "Puntos", "Coeficiente" y "Factor" de Fidelización podrá indicarse que los puntos otorgados serán informados en el elemento "Cliente" y que la gestión de estos puntos no será responsabilidad de Promo. Para poder indicar que los saldos son informados por el elemento "Cliente" deberá tildarse en el campo "Tipo de Puntos" la opción "Puntos informados por el cliente", al hacerlo el campo "Tipo de puntos" se deshabilitará y no se permitirá indicar un tipo de elemento de fidelidad para la acumulación de los puntos. De esta forma se interpreta que será el POS quien se encargue de gestionar los saldos a el o los sistemas que corresponda.

Ejemplo:



Para los beneficios No Monetarios "Puntos", "Coeficiente" y "Factor" de Fidelización podrá indicarse el máximo de puntos a otorgar cada vez que se otorgue el beneficio en una transacción. Para ello, se disponibilidad en la definición de cada uno de estos beneficios el campo "Máximo de Puntos por Transacción".

El campo se mostrara por default en blanco, indicando que no hay un monto máximo de puntos a otorgar definido en el beneficio. Al colocarse un valor, cuando el beneficio se aplique en una transacción, se otorgaran los puntos hasta el valor definido en este campo. Es de tipo alfanumérico, No admite un 0 (cero).Ejemplo: Si el parámetro se configura en 400, cuando se aplique el beneficio en una transacción y el total de puntos a otorgar para ese beneficio sea de 500, este valor se ajustara al valor máximo definido en el beneficio de 400.


Debajo del campo "Clase de beneficio" aparecerá el campo: "Plan de Pago VTol". Este campo solo aparecerá cuando se haya completado en Administración / Información de Configuración, el campo: "URL VTol:", o sea, cuando se esté utilizando la integración de VTol. Este campo es autocompletable. Muestra planId de los paymentPlanList que trae la respuesta de Vtol. Si no se selecciona ninguna de las opciones que sugiere el autocompletable, permite completar libremente como se hace actualmente. Traerá la información que VTol guarda en: paymentPlanList - planId. Este campo (Plan de Pago VTol) será la clave. Para una mejor identificación del plan a seleccionar por el operador, se mostrará el valor del planId del PaymentPlanList seguido del name del provider id + el valor del payment que corresponden a ese planId del paymentPlanList.

Si se agrega una URL en Administración / Información de Configuración, en el campo: "URL VTol:" Promo interpretará que se van a utilizar los medios de pago informados por VTOL.

Los medios de pago informados por VTOL no modificarán los existentes en los catálogos de Promo, se guardarán por separado.

Para poder utilizarlo el Usuario Principal deberá habilitarlo en la definición de la empresa, en la sección "Beneficios No Monetarios Habilitados".

En Promo existe un proceso que actualizará los medios de pago obtenidos de VTOL.

Al agregar o editar un beneficio de una promoción, si en "Tipo de beneficio" selecciona "No Monetario", y en "Clase de beneficio" selecciona "Plan de pagos", en la sección "Definición Principal" mostrará la propiedad "Tipo de Operación Vtol" que está integrada con los Planes de Pago que vienen de Vtol.

Reintegro bancario: heredará el mismo comportamiento que el plan de pagos cuando se esté trabajando en  modo integrado con VTol.


Para mas información sobre la configuración del plan de pago y del reintegro bancario ver Administración, Información de configuración. Para mas información sobre la integración del plan de pago y del reintegro bancario ver Manual de Integración, Beneficio, plan de pago y del reintegro bancario.


El campo "Con un Porcentaje*" no admite valores negativos.



Para cada una de las clases de beneficios No Monetarios también deberá indicarse:


Deberá indicase al momento de definir el beneficio, los campos presentes en "Información de Aplicación"


En una misma transacción (en un mismo ticket) si una promoción tiene varios beneficios, las aplicaciones máximas serán por beneficio.

Este campo solo se habilitará para los beneficios “Tipo de Beneficio” = Monetario.


Para que se apliquen correctamente los Métodos de Prorrateo = "Más baratos primero" y "Más caros primero", es indispensable seleccionar la opción "Todo", del campo "Por cada unidad de:".A continuación, se adjunta un ejemplo:

De seleccionarse cualquiera otra opción en el campo "Por cada unidad de" (Cantidad o Magnitud) siempre se aplicara el beneficio de forma proporcional sobre los ítems participantes, independientemente de si se selecciona "Más baratos primero" y "Más caros primero" en el campo Método de prorrateo.


Además, PROMO permite que el prorrateo se realice sobre el precio original del artículo, es decir, antes de cualquier beneficio; o bien sobre el precio ya beneficiado.


Limites de Aplicación:

Dependiendo del tipo de beneficio que se este definiendo, podrán gestionarse desde esta sección distintos "Limites" que indicara cuando se entrega o no, un beneficio en base a un stock ya sea general del Retailer, por tienda o por Cliente, permitiendo llevar un control mas general de las veces que fue otorgado un determinado beneficio a lo largo de un determinado período.

El límite de aplicación de un beneficio puede estar definido por cantidad de Dinero, cantidad de beneficios otorgados, por cliente, día, tiendas, etc. y serán configurados en cada beneficio que aplique una promoción. 

En un mismo beneficio podrán definirse uno o más límites, pero estos deberán ser siempre distintos, es decir, que no se permitirá definir un mismo tipo de limites, por ejemplo, por tienda que acumule dinero, en un mismo beneficio. De definirse más de un límite, cuando se haya alcanzado al menos uno de ellos la promoción no aplicara más el beneficio limitado. 
Si una promoción posee varios beneficios definidos y uno solo de éstos tiene definido un límite de aplicación, alcanzado dicho límite, ese beneficio dejara de aplicarse, pero los demás beneficios de la promoción (sin límites) continuaran aplicándose mientras la promoción y/o mapa estén vigentes. 

Para cada uno de los beneficios disponibles en PROMO podrán definirse el límite de aplicación, quedando fuera de alcance para el beneficio Monetario: Canje de cupón Calculado, Beneficio Externo y Canje de Puntos por Catálogo y para el beneficio No Monetario: Contador, Plan de Pago y Reintegro bancario.

Al seleccionarse un tipo y clase de beneficio al que aplique la definición de limites, se mostrara la sección "Limites de Aplicación" en la definición del beneficio:


En el combo "Agregar" estarán disponibles las siguientes Opciones:

Seleccionado uno de los criterios de agrupación mencionados anteriormente, se mostrara el siguiente pop-Up:

Podrá indicarse una Descripción del Limite, ésta no tendrá efecto alguno sobre la gestión de los limites, es solamente informativa. 


La descripción No será informada en el beneficio ya que los limites no viajan en el mapa sino que son consultados durante la transacción.

A cada uno de los criterios de acumulación o Tipo de límite (General, Tienda o Cliente ) se les podrá definir un "Período" en el campo "Período a Contabilizar". El Periodo, indicará cada cuanto se reseteará el contador de acumulados durante la vigencia de la promoción. Ejemplo: "2x1 en termos hasta agotar Stock de 10 unidades por día". 

Aquí, ya sea que el límite sea por General, Tienda o Cliente, se evaluará que en un día no se supere el límite de 10 termos beneficiados. De alcanzarse el límite de 10 termos beneficiados por día, la promoción no se aplicará ni se sugerirá más por ese día.  Al día siguiente, el contador volverá a cero y podrá aplicarse la promoción hasta alcanzar nuevamente el límite de 10 termos diarios.

El Período a contabilizar podrá ser:

Deberá considerarse que dependiendo del beneficio que se está definiendo, podrán utilizarse distintos criterios de acumulación para la definición del límite. En el campo "Limitar por" deberá indicase este criterio de acumulación. Pudiéndose elegir entre los siguientes acumuladores:



Ya habiendo seleccionado el criterio de acumulación, deberá indicarse el valor que define el límite de aplicación del beneficio.


El ejemplo anterior, podrá interpretarse como un tipo de Limite General, que reinicia el contador diariamente, y que acumula aplicaciones del beneficio definido hasta un tope de 100. Habiéndose alcanzado el limite, el beneficio no se aplicará más hasta el próximo día. En caso de no haber alcanzado el limite al momento del reseteo del contador, este se reiniciará igualmente, volviendo a 0 para volver a acumular hasta 100 el próximo día.


Límites al Definir Cupón Calculado:


Una vez definido un límite para un beneficio no podrá editarse, teniendo que eliminar el limite y volver a crearlo en caso de requerir alguna modificación.


Una vez definido un limite para un beneficio, el tipo y clase de beneficio no podrán editarse, teniendo que eliminar el limite y volver a crearlo en caso de requerir alguna modificación.


Agregados los limites y guardado el beneficio, al volver a la pagina de definición de promoción, los limites definidos se verán de la siguiente forma:


Cuando el beneficio definido sea "Beneficio Externo" no podrá definirse ningún tipo de Límite.


Se habilita el campo descripción al momento de definir un limite de aplicación en los beneficios. Este campo descripción, esta disponible para cualquiera de los limites disponibles en la definición (General, Tienda y Cliente)

El campo no es requerido, y será informado en los servicios que reporten promociones y limites (RabbitMQ).


Al agregar o eliminar un limite en el beneficio de una promoción que ya se encuentre en estado distribuida, la misma se debe re-distribuir en un nuevo mapa, para que de esta manera se actualicen las colecciones de limites en la base de datos.
Asignación de límite de beneficios por tienda y por promoción

Se tiene la posibilidad de asignar un límite personalizado de aplicaciones de beneficios de una promoción por tienda. Esto permitirá manejar una mayor diversidad en el control de  un límite de aplicaciones y reducirá el número de configuraciones de promociones para cubrir esta necesidad.

Para ello, cuando se crea una promoción y se desea agregar límites, Promo brinda la posibilidad que sea de forma manual o a través de un archivo:

Como se observa en la imagen, el combo de tienda es autocompletable, con las que el usuario tiene vinculadas.



También se pueden insertar, a través de un archivo .xls

Si no conoce el formato del archivo puede bajarlo presionando el botón "Exportar Detalle Actual"

La aplicación descargará un archivo, donde el usuario podrá completarlo con los datos correspondientes:

El formato del archivo lo puede obtener presionando el botón "Exportar Detalle Actual"

Allí deberá completarlo con los siguientes datos:

Operación (Requerido):

                 I: inserta un/os nuevo/s límite/s

                 U; modifica el/los datos de un/os límite/s

                 R: elimina el/los límites deseados

Id del límite: es el identificador del límite. Si la operación es un Insert; este campo estará vacío, caso contrario (Modificación U o Eliminación R) su valor se puede obtener desde la vista donde se están configurando los mismos:

y para las operaciones de update y remove son obligatorios.

Tipo de Límite (Requerido):

                       Retail:

                       Tiendas:

                       Customer:

Descripción (opcional): puede tener una descripción del límite

Tienda: Código de la Tienda a la que se le desea aplicar el límite. Para obtener su valor se busca en:

Período a contabilizar (requerido): puede ser indefinido o a aplicar cada cierta cantidad de días.

Cantidad de días: es requerido si se seleccionó Días en período a contabilizar

Limitar por (requerido): criterio a limitar, dependiendo del tipo de límite escogido.

Una vez que se importó el archivo, la aplicación mostrará sólo doce (12) límites.

Si hay algún error en la importación la aplicación mostrará el error:

Se mostrarán tantos registros como errores tenga el archivo.

Desde el botón Eliminar en el borde superior derecho, se puede remover, siempre y cuando la cantidad de límites configurados sean menor que 12 (doce)

 

 y se puede modificar desde la vista Límites Promociones, siempre y cuando la cantidad de límites configurados sean menor que 12 (doce) :


Cuando superan esa cantidad, los límites se pueden modificar y/o eliminar a través del archivo .xls


Sólo se puede modificar el Valor de los límites. En el archivo de modificación sólo puede estar los registros a modificar y/o eliminar. No es necesario que contenga todos los registros del archivo original.

Definición de Escalonadas:

Existe en Promo la posibilidad de aplicar descuentos escalonados.  Se podrá indicar desde la definición del beneficio cual el es valor del descuento cuando se alcance una cantidad, magnitud o precio total determinado de los productos participantes.


Al definir un beneficio, se mostrara en el formulario la sección "Definición de Escalonadas"


Deberá definirse, sobre que tipo de unidad aplicara el escalón que se esta definiendo. Para ello, en el combo "Unidad de Escalonada" podrá seleccionarse entre "Cantidad", "Magnitud" o "Precio Total".

Se tomará como unidad de magnitud para la definición de Kilo, 1000. Pudiéndose definir los 100 gramos como 0.1 o los 10 gramos como 0.01


Al presionar "Agregar",  se propondrán los siguientes campos a fin de indicar las condiciones de aplicación del escalón que se está definiendo.


Para guardar el escalón definido, deberá presionar el botón "Continuar" mostrándolo de la siguiente forma:


De presionarse nuevamente "Agregar escalón", e incorporar un 2do escalón, se mostrará la grilla y el escalón ya definido, de la siguiente forma.


La definición de escalonadas estará disponible en los beneficios "Monetarios" de clase "Descuento fijo", "Descuento por Convenio", "Descuento porcentaje", "Nuevo precio" y "Canje de Puntos". Así como también en los beneficios "No monetarios" de clase "Monedero", "Beneficio General", "Coeficiente de fidelización", "Porcentaje de fidelización", "Puntos de fidelización", "Regalo", "Cupón" y "Cupón Calculado".


Si está definiendo una escalonada para un Tipo de beneficio "No Monetario" con Clase de beneficio "Cupón", el valor que ingrese en el campo "Otorgar cupones (cantidad)" será el valor que se tomará por defecto si no entran los escalones. Promo otorgará el valor del escalón que corresponda como prioritario. 


Consideraciones en la definición de beneficios escalonados:

(Ver también ver Apéndice VII - Promociones Modelo, para ejemplos de aplicación de promociones escalonadas)

Por último se solicitará que se completen los campos de la sección "Información Adicional" para terminar de definir el beneficio.

Se puede configurar que sea obligatorio completar los dos campos (Proveedor del bien y Proveedor financiero) si se ingresan valores en uno de ellos. Se debe configurar lo siguiente:

Si esa configuración está en : 

En los campos "Proveedor del bien" y "Proveedor financiero" se puede ingresar texto hasta 250 caracteres. Ambos campos a medida que se va escribiendo muestran sugerencias seleccionables que trae del catálogo "Proveedor".

Se pueden cargar valores con decimales; tanto en el campo "Proveedor del bien", como en el campo "Proveedor financiero" (ya sea para Monto como para Porcentaje); los cuales se van a detallar en el Universo de Aplicación. Tanto Proveedor del bien como Proveedor financiero, ya sea si se utiliza Monto como Porcentaje, el Valor trabaja con 2 decimales. En caso de ingresar 3 decimales se redondeará el valor ingresado.



La suma de los valores definidos para ambos proveedores no podrá superar el 100% cuando éstos definan por porcentaje. En caso de que ambos proveedores se definan por monto no se realizará validación sobre los montos ingresados en uno y otro proveedor. Por monto permite ingresar valores con dos decimales. Si el proveedor financiero se define por % el proveedor de crédito deberá definirse también por % y lo mismo cuando uno se defina por valor. Ambos campos son opcionales, pero de cargarse uno el otro deberá definirse aunque sea con % o $ en cero ( 0 ).

Tanto para beneficios monetarios, como no monetarios, se pueden registrar datos sobre dos proveedores extras, con los mismos atributos del identificador.porcentaje/monto y valor. Esto permitirá tener la posibilidad de manejar tres o cuatros proveedores que cubran el descuento entregado por el beneficio. Se debe tener en cuenta que estos dos actores adicionales no son obligatorios y podría ser o no parametrizados en los beneficios.                                

            

        

Para la selección del proveedor adicional se debe de recuperar del mismo catálogo que se ocupa para configurar el proveedor del bien y financiero. Los datos de los "Proveedores adicionales" debe ser retornados de la misma manera que los datos de los proveedores del bien y financiero en la estructura XML al momento de obtener el beneficio. En caso de no tener configurado estos proveedores adicionales, el comportamiento será el mismo que se tiene con el proveedor del bien y financiero en la respuesta del motor.

<p>&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot; standalone=&quot;no&quot;?&gt;</p><p>&lt;message ack=&quot;0&quot; companyld=&quot;2&quot; engine=&quot;7.0.8 #30&quot; mapversion=&quot;999&quot; messageld=&quot;0001&quot; store=&quot;251&quot; terminal=&quot;1&quot;&gt;</p><p>&lt;optional&gt;</p><p>&lt;promo code=&quot;10994&quot; id=&quot; E:PRM LONAS BIOSIL 25% 01-19 SEP 21/MMG/LS/10994&quot; nro=&quot;5fab2867daf8070e08cbc208&quot;&gt;</p><p>&lt;benefit AJUS_PVP_PC=&quot;NO&quot; COBROUNIDAD=&quot;NO&quot; ESPROMOCIONAL=&quot;NO&quot; FECHA_FIN_PROMO=&quot;</p><p>2021/09/19&quot; LPCOBRO=&quot;PVP&quot; REQDIG=&quot;NO&quot; RQDEVPREMIO=&quot;Sl&quot; TLOGMessage=&quot;PRM LONAS BIOSIL 25% 01-</p><p>19 SEP 21&quot; account=&quot;&quot; applicationMethod=&quot;resume&quot; baseAmount=&quot;8.0357&quot;</p><p>benefitType=&quot;PercentageDiscount&quot; creditProviderName=&quot;1791994531001&quot; creditProviderValue=&quot;80&quot;</p><p>creditProviderValueType=&quot;PERCENTAGE&quot; discountPercentage=&quot;5.0000&quot; displayMessage=&quot; PRM LONAS BIOSIL 25% 01-19 SEP 21&quot; financialProviderName=&quot;1791984722001&quot; financialProviderValue=&quot;10&quot; <br /> financialProviderValueType=&quot;PERCENTAGE&quot; name=&quot;5fab2867daf8070e08cbc208&quot; <br /> nro=&quot;5fab2867daf8070e08cbc202&quot; order=&quot;1&quot; printerMessage=&quot; PRM LONAS BIOSIL 25% 01-19 SEP 21&quot; <br /> prorationMethod=&quot;PROPORTIONAL&quot; tipoPromo=&quot;DV&quot; unit=&quot;qtyr additionalProvider1Name=&quot;1002003001&quot;</p><p><strong>1111</strong>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <strong>111111.11111111&bull;111&bull;1111111111111</strong>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <strong>11MNTAGE&quot;&gt;</strong></p><p>&lt;apply&gt;</p><p>&lt;item magnitude=&quot;0.0000&quot; qty=&quot;1.0000&quot; seq=&quot;2&quot; value=&quot;0.4018&quot; valueWithTaxes=&quot;0.4018&quot; xprice=&quot;8.0357&quot;/&gt;</p><p>&lt;/apply&gt;</p><p>&lt;/benefit&gt; &lt;/promo&gt; &lt;/optional&gt; &lt;suggestions&gt;</p><p>&lt;promo code=&quot;9662&quot; descriptor=&quot;[P1]-PRM UMBRELLA-COMBO SNACKS GRATIS 03 AL 31AG021 (PREMIO OBLIGATORIO: COCACOLA500mI+NACHO 0 TOSTIT045g)&quot; id=&quot;EM:PRM UMBRELLA-COMBO SNACKS GRATIS 03-31AG021/MBG/AS/9662&quot; item-seq=&quot;2&quot;/&gt;</p><p>&lt;/suggestions&gt;</p><p>&lt;/message&gt;</p>


Se podrá limitar la cantidad de caracteres a ingresar en este campo, o se podrá utilizar como viene por default que es sin límite. Si desea limitar la cantidad de caracteres a ingresar debe hacerlo desde Administración\ Información de Configuración, en el seteo: “Recortar Mensaje para la Impresora”, cuya clave será message.printer.maxLength.En el campo "Mensaje para la Impresora" del beneficio de una promoción, no habrá límite para ingresar información. Al presionar el botón Guardar, si la cantidad de caracteres ingresados en este campo supera el valor configurado en el campo “Recortar Mensaje para la Impresora”, se mostrará un mensaje informando "La cantidad de caracteres ingresados supera el valor configurado" y se mostrará un recuadro con color bordó al rededor del campo "Mensaje para la Impresora" con el signo de admiración a la derecha. El sistema no guardará los cambios, y seguirá mostrando la misma pantalla hasta que el usuario cambie el mensaje ingresado en el campo "Mensaje para la Impresora". Una vez ingresada una cantidad de caracteres menor o igual a la configurada, el mensaje se guardará luego de presionar el botón Guardar. Si el campo de configuración “Recortar Mensaje para la Impresora” se dejó vacío, el sistema guardará la información ingresada en el campo "Mensaje para la Impresora", sin considerar ningún límite. Si se edita una promoción que tenía un Mensaje para la Impresora más largo que lo configurado en el campo “Recortar Mensaje para la Impresora”, al momento de presionar el botón “Guardar”, el sistema mostrará el mensaje "La cantidad de caracteres ingresados supera el valor configurado" y se mostrará un recuadro con color bordó al rededor del campo "Mensaje para la Impresora" con el signo de admiración. No se guardarán los cambios hasta que se ingrese una cantidad igual o menor a la configurada.



Todos los atributos que contienen el símbolo son de ingreso obligatorio, una vez finalizada la carga del beneficio se deberá presionar el botón "Aceptar" para que se guarde el beneficio dentro de la promoción y en ese momento se validara que todos los campos obligatorios estén cargados.


Posteo de Promociones a RabbitMQ bajo demanda

Podrá configurarse desde la consola de Promo la posibilidad de postear las promociones en estado "completa" a las colas RabbitMQ que se haya configurado.

El proceso por default postea de manera automática a las colas RabbitMQ, las promociones que pasan a estado "Completa", y todas las modificaciones que se realizan sobre ésta, mientras que no cambie su estado de "Completa" cuando la funcionalidad este habilitada y configurada la funcionalidad. 

También podrá configurarse que este envío no sea automático, sino que el usuario sea el encargado de realizar este posteo cuando la promoción se encentre en estado automático.

Esta funcionalidad podrá habilitarse desde "Administración" >> "Información de Configuración", en la opción de configuración "rabbitMQ.producer.manual.promotion.enabled" que por defecto estará en "false". Al colocarla en "true", se pasara a la modalidad de posteo de promociones a demanda.


Si una promoción pasa a completa o distribuida, o es editada y mantiene su estado completa, se presentara el botón "Postear a RabbitMQ". Una vez presionado, los datos de la promoción editada y completa serán posteados para que se envíen vía RabbitMQ, y el botón ya no se mostrara hasta que se realice una nueva edición.


Consideraciones: 


Modificación de promociones en base a su vigencia

Podrá indicarse por configuración si una promoción puede o no ser editada luego de vencida, para esto deberá de accederse a Administración > Información de Configuración y habilitar o des-habilitar la opción "dataEditableIfActive".

También podrá indicarse por configuración que a una promoción no se le pueda editar la fecha de inicio de vigencia, cuando esta haya sido alcanzada. (Para mas información Ver Administración >> Información de Configuración)

En la grilla de "Gestión de promociones" no estarán disponibles las opciones de "Editar" y "Definir" en el menú de Acciones de las promociones cuya vigencia esté alcanzada cuando la configuración así lo indique. Podrán copiarse promociones cuya vigencia esté en curso o esté vencida, pero no se copiará la condición horaria.


Las promociones dadas de alta o editadas, cuando pasan al estado "Completas" y el WorkFlow (WF) está "Aprobado", podrán ser enviados a un sistema externo vía cola Rabbit-MQ para que esos datos puedan ser tomados por sistemas externos.

Por default esta funcionalidad estará desactivada y deberán configurarse los datos de la cola Rabbit-MQ que corresponda para activar la funcionalidad. Podrán realizarse las configuraciones necesarias para el envío de Promociones desde la Consola de Promo ingresando en el menú Administración >> Información de Configuración.

En el campo de búsqueda: "Palabra a buscar", ingresar la palabra clave: "Producer". Como resultado mostrará las variables de configuración para el envío de Promociones vía Colas Rabbit MQ.

El estado de este proceso podrá visualizarse en la sección "Monitor de Importaciones" en la consola de Promo.

(Para mas información sobre las configuraciones disponibles Ver Administración >> Información de Configuración)

(Para mas información sobre el proceso del envío de Promociones Vía Rabbit MQ ver Manual de Integración Promo)

Exclusión de promociones por fecha y tienda

A partir de esta versión, se podrán excluir promociones en determinadas fechas, ingresadas a través del servicio Post, detallado en Servicio de exclusión de Fechas para no ser ejecutada una promoción

Importación realizada exitosamente

Una vez realizada correctamente la importación masiva de las exclusiones, podrá visualizar el registro de importación con el estado Procesado dentro del listado de importaciones. 

Así mismo, podrá visualizar el detalle general que le indicará la cantidad de registros procesados.


Importación de exclusión de promociones de forma Parcial

Las importaciones con estatus Parcial ocurren al momento de tener errores de validación en algunos de los registros de exclusiones a procesar.

En el detalle de la importación podrá visualizar cuantos registros fueron procesados correctamente, así como el detalles de los registros con error, permitiéndole de esta forma identificar el problema mas fácilmente, ya que se indicara el campo con el valor invalido, así como el json asociado a ítem.


Importación de exclusión de promociones con Error

En el caso de existir errores de validación en los campos en todos los registros a procesar, podrá visualizar el estado de importación Error

En el detalle de la importación donde podrá ver de forma mas especifica los errores encontrados en cada registro.

Dentro de los posibles errores que se pueden presentar están:

A. Error en el campo promotionName → Ocurre cuando se indica un nombre de promoción que no existe.

B. Error en el campo storeCode → Ocurre cuando se indica un código de tienda inexistente.

C. Error en el campo exclusionDates → Cuando se indican fechas invalidas (fechas fuera de la vigencia de la promoción, fechas anteriores a la fecha actual o fechas con formato diferente a "año-mes-día"), o en su defecto se envía el campo vacío.

Monitor de Exportación

En el caso de existir registros de posteos a server RabbitMQ con ERROR, se mostrará un aviso (banner) en la cabecera de Promo, indicando de forma general la incidencia.


Banner con detalle de la incidencia. 
Para conocer el detalle de la incidencia, presione Ver mas detalle.




Lista de procesos de exportación fallidos.
En el campo Descripción: se podrá visualizar la causa del error

Una vez corregido el error que ocasiona el fallo en el posteo de los mensajes al server RabbitMQ, deberá presionar el botón Reprocesar



Si el procesamiento de los fallos relacionados al posteo de datos vía RabbitMQ es exitoso, la grilla deberá quedar sin registros por reprocesar.

Las promociones que no fueron incluidas en un mapa o no fueron actualizadas en un período mayor al configurado en: Información de Configuración >> cleanTransactions, serán removidas de la vista Administración de Promociones por el proceso de Depuración de Promociones.

Este proceso realiza una depuración lógica inicial (oculta de la vista) y luego de 1 año, elimina las promociones de forma física de la base de datos.
La cantidad de días a considerar está definida por el valor configurado en el parámetro cleanTransactions, y el alcance es por compañía.


Si una promoción tiene un workflow general y está en estado distribuida:

si se modifica vuelve al estado completa:

 Una promoción que tenga un workflow en pasos y esté en estado distribuida:

 

al editarse/definirse volverán al estado "Completa"



Plantillas de promociones

¿Qué es una Plantilla de Promociones?

Desde esta sección de la consola de Promo, podrán darse de alta distintos modelos de Plantillas de Promociones que permitirán luego, descargar los excels para que el usuario o sistema encargado genere, modifique o cancele promociones según lo definido en la plantilla y  así poder gestionar promociones de manera masiva al procesar los excels. También se pueden crear nuevas promociones a partir de una plantilla.

En cada plantilla, podrán indicarse criterios de definición de la cabecera, condiciones y beneficios que serán comunes para las promociones que se gestionen a partir de esta plantilla.

Por medio de esta plantilla podrá indicarse que elementos serán requeridos cargar en el Excel que luego será procesado.

Para la definición de los campos que componen una plantilla podrán utilizarse variables definidas de la siguiente forma: @[ variable ]. También podrá definirse un valor fijo para alguno de los campos de la plantilla de la promoción, y de no cargarse ningún otro dato para ese campo al definir el excel, el valor definido será el que se tome para la definición de la promoción.

Para poder acceder a la creación de una plantilla de promoción se debe de acceder a través de la opción "Plantillas de promoción"



Al acceder a "Plantillas de promociones", se mostrara la pantalla "Gestión de Plantillas de Promociones", donde se listaran las distintas plantillas de promociones ya generadas y desde donde se podrán dar de alta nuevas plantillas o editar las existentes. También podrá filtrarse aquí por el Estado o Nombre de las plantillas existentes.


En cada Plantilla presente en esta grilla, se propone el botón "Acciones", desde el cual podrá editarse o definirse una plantilla, así como también ver un resumen, cancelarla o generar un Excel a partir de ella.


Cuando una Plantilla de promociones este en estado "Cancelado", solamente se propondrá la opción "Resumen".


Para dar de alta una nueva Plantilla de Promociones, deberá darse clic en "Nueva Plantilla"

Nueva Plantilla de Promociones 

Al presionar en "Nueva Plantilla" se mostrara la pantalla "Nueva Plantilla de Promoción" donde podrá indicarse un Nombre y una Descripción a la plantilla que se desea crear.

Una vez identificada la plantilla de la promoción, se deberán cargar los campos de la Cabecera, Condiciones y Beneficios que se deseen incluir en la plantilla y que definirán la estructura de las promociones que se definan a partir de esta plantilla de promociones.

También podrá indicarse si la plantilla se encuentra activa o no. Si una plantilla de promoción se encuentra "Inactiva" (sin el check en Activa) no podrán generarse archivos excels a partir de estas plantillas



Definición de la Cabecera de Plantilla de Promoción

En la misma pantalla de definición de la cabecera de la plantilla, estará la sección de definición de la Cabecera de la Promoción. Aquí deberán ingresarse los campos requeridos para la gestión de promociones, estos campos serán las columnas que se presentaran en el excel para el proceso de alta, baja y/o modificación de promociones por archivo. 

Habrá campos de ingreso obligatorios y otros campos podrán ser reemplazados por variables a fin de ayudar al usuario final a interpretar, según necesite los datos a cargar en ese campo para una promoción.


En esta sección no se propone el ingreso de una variable para el "Nombre" y para el "Código" de las promociones a gestionar a partir de esta plantilla. Esto se debe a que son campos de ingreso obligatorio y que siempre estarán en la planilla excel para ser cargados.


  • Los campos como Nombre y Código de la promoción no se mostraran por pantalla al momento de comenzar a crear la plantilla, en su lugar serán visibles como columnas (Nombre de promoción y Código) en el Excel, dichos campos estarán sujetos a las mismas validaciones cuando se crea una promoción manualmente por consola o por Servicio Rest.
  • Evitar en el nombre de la plantilla de promoción el uso de caracteres especiales, ya que el nombre que se indique será usado para darle nombre al archivo Excel asociado a la plantilla, por lo que el uso de estos caracteres podría causar conflictos al momento de identificar si el archivo pertenece o no la plantilla durante el procesamiento en el alta masiva.
  • Las plantillas de promociones creadas para los canales Facebook y Twitter, no requerirán la asignación de una imagen para la plantilla ya que no es requerido, en su lugar todas las promociones creadas en base a una plantilla con estas características a través del Alta masiva por Excel, quedaran en estado Incompletas, para que posteriormente el usuario de forma manual seleccione la imagen para la promoción creada, esto debido a que actualmente se tiene una limitante al indicar la referencia de la imagen por el proceso del Excel, por lo que la imagen se debe indicar de forma manual a través del modulo de Promociones, acción -> Cambiar Imagen

Los campos que podrán ingresarse por variable, serán los de ingreso No obligatorio y en caso de querer definirse deberá indicarse la variable que se quiere ver en la columna donde se definirá ese campo para la promoción.

Esta definición de campos variables aplicara para los campos dinámicos de la cabecera y para la descripción de la promoción. Solo podrán definirse los campos que se encuentren habilitados por configuración, y en caso de ingresarse una variable, la columna que corresponda a  la carga de ese campo, se mostrara con la variable de usuario definida en la plantilla.

Se pueden completar atributos de la cabecera:

También podrán indicarse la tipificación que tendrá la promoción y si utiliza o no sugerencia.


La tipificación propuesta para la definición de la plantilla de la promoción, será la misma que se utiliza por default para la definición de las promociones.

Las sugerencias se pueden ver en detalle en SUGERENCIAS

Ejemplo: visualización de la pantalla completa de Alta de Nueva Plantilla.




De generarse un archivo Excel con esta definición de cabecera de Promoción se mostrara de la siguiente forma:

OperaciónMotivo de cancelaciónNombre de promociónCódigoWorkflowCampañaCanales de publicaciónTipo de promocionesSub-tipo de promocionesForma de aplicación de promocionesDescriptionsugest

























Para mas detalle de los valores aceptados al momento de definir la cabecera de una promoción Ver "Apéndice VI"


Las columnas "Operaciones", "Motivo de cancelación", "Nombre de Promoción" y "Código", siempre estarán presente en el Excel y son de carga obligatoria. (El motivo de cancelación será obligatorio si la operación es una Cancelación ).

Las columnas "Workflow", "Campaña", "Canales de Publicación", "Tipo de Promociones", "Sub-Tipo de Promociones" y "Forma de aplicación de promociones", siempre estarán presente en el Excel, pero no son de carga obligatoria. Si se dejan en blanco, al procesarse el excel, la promoción que se genere tomara los valores definidos en la plantilla de promoción, en cambio, si se ingresa algún valor en alguno de los campos, la promoción que se genere tomara este valor ingresado y no lo definido en la plantilla.

Las columnas "Description" y "sugest" corresponden a las variables  ingresadas en los campos "Descripción" y "

Estas validaciones se realizaran al momento de procesar el archivo Excel.

Habiendo cargado los datos correspondientes a la cabecera de la plantilla de la promoción, podrá presionarse "Guardar" y se pasara la definición de las condiciones y beneficios que se deseen incluir en el template de promociones.


Cada fila corresponderá  a una promoción.


Definir plantilla 

Una vez guardado correctamente podrá visualizar la pantalla de Definir Plantilla, donde podrán indicarse las condiciones por Rango Horario, Simples, por composición y los beneficios asociados a la plantilla de la promoción.

También se visualizará un detalle de la cabecera de la plantilla de promoción que se esta definiendo. En esta sección podrá accederse a un resumen de la plantilla que se esta generando, y se podrá generar el excel correspondiente cuando la plantilla este completa.

Se definen los distintos ítems de la plantilla, de la misma manera que para una promoción:


Cuando se crea una promoción a partir de una plantilla, la aplicación verificará las tiendas. Si el usuario logueado es un usuario con rol administrador o tiene asociadas todas las tiendas, el campo Tienda será un campo de texto libre, podrá ingresar tiendas inactivas e inexistentes. Si el usuario logueado tiene un rol diferente al de administrador y no tiene asociadas todas las tiendas, podrá ingresar sólo las tiendas que tiene asociadas, serán tiendas existentes y activas vinculadas al usuario logueado, no será un campo libre. Si el usuario tiene un rol diferente al administrador y no tiene todas las tiendas asociadas, el usuario deberá ingresar por lo menos una tienda en la plantilla de promociones sino quedará en estado "Incompleta" hasta que agregue  por lo menos una tienda de las que el tiene vinculadas.


Variables: en la sección "Condiciones Simples", Transacción\ Tienda, podrá ingresar una variable como se indica en la siguiente imagen: 


Editar plantilla 

Desde la vista Gestión de Clientes, ítem "Acciones" se puede modificar una plantilla seleccionando la opción "Editar"  

siendo todos los campos editables.


Cada cambio aplicado sobre la plantilla será heredado por la promociones que se creen/actualicen en base a ella. Es decir si la plantilla se actualiza incorporando una nueva condición simple por Tienda con un valor por defecto igual a napse, todas las promociones que se creen o se actualicen con esa plantilla incorporaran dentro de sus condiciones simples el elemento Tienda igual a napse. Lo mismo ocurrirá si se remueve por ejemplo algún elemento en la plantilla de promoción todas aquellas promociones que se actualicen en base a esa plantilla dejaran de tener ese elemento.


Generar plantilla en formato excel

Una vez completa la plantilla de promoción podrá descargarse en formato excel, presionando el botón Generar excel ubicado en la cabecera de la pantalla Definir.


 O bien desde el listado general de datos Acciones → Generar excel. 


Podrá indicarse, por configuración cual será la fila del archivo excel que oficiara de cabecera, en caso de que se dese que no fuese la fila uno (default). Para ella deberá de editarse el parámetro de configuración en Administración → Información de configuración y editar la variable file.xls.header.rowStart.


Una vez generado el Excel correspondiente a la plantilla seleccionada, podrá visualizar como cabecera de cada columna el nombre de los campos asociados a dicha plantilla. La cantidad y los nombres de los campos dependerá de como este configurada la plantilla de promoción, por lo que su formato no será fijo.

Se deberá respetar el tipo y el formato del nombre del archivo generado, ya que dicho nombre conserva la relación entre el Excel y la plantilla de promoción, lo cual es necesario para el correcto procesamiento desde el Alta masiva de promociones. Dicho formato contiene la siguiente estructura:

                                                                                                                   

                          nombre_de_la_plantilla_año_mes_dia_hora_ninutos_segundos.xls


Las plantillas  no se borran con el proceso de Depuración de Promociones. Las Promociones creadas a partir de una plantilla de promociones sí se borran con el proceso de Depuración de Promociones, si corresponde.

Alta Masiva de Promociones

Al ingresar al menú Operación -> Alta masiva, podrá visualizar el listado de plantillas disponibles para el proceso (generadas previamente, ver "Plantillas de promociones"). La grilla de datos mostrará el nombre de la plantilla, así como la cantidad de promociones insertadas, actualizadas, canceladas y con error, junto con fecha de ultima de ejecución del proceso de alta masiva asociado a esa plantilla.


Al presionar el botón Ver detalle, se visualizará la ventana de “Alta masiva de promociones” donde se mostraran los datos de cabecera de la plantilla y el resumen de los datos asociados. 

En esta sección podrá generarse el excel de la plantilla de la promoción que este completa y activa, así como la selección y procesamiento del archivo (Procesar archivo).


Cuando el proceso termine de forma satisfactoria se mostrara el estado Procesado a la izquierda del registro que se indica en "Ultimas Operaciones realizadas" y podrá visualizarse un informe de las promociones generadas presionando en el botón "Ver Informe".

En caso de que durante el proceso hayan surgido errores, se mostrara el estado Error a la izquierda del registro que se indica en "Ultimas Operaciones realizadas" y podrá visualizarse un informe detallado de los registros que presentaron inconvenientes en el procesamiento.


  • Las promociones creadas a partir de una plantilla de Excel podrán actualizarse por alta masiva, siempre que no estén canceladas.
  • Las promociones creadas manualmente no podrán ser actualizadas mediante el proceso de alta masiva.


Al generarse el Excel a partir de una plantilla de Promoción, junto con los campos "Nombre" y "Código" que siempre estarán como columnas, también estarán las columnas "Operación" y "Motivo de Cancelación". En el campo "Operación" se deberá indicar si la promoción que se indica en dicha fila es una promoción nueva, si se edita o si se cancela una promoción existente. Los valores aceptados para este campo son:
  • I: Insertar
  • U: actualizar
  • R: cancelar

Cuando la acción sea R (cancelar promoción), deberá indicarse de forma obligatoria el "Motivo de Cancelación", así como el código y/o nombre de la promoción la cual desea cancelar.

  1. Los espacios en el nombre de la plantilla al generar el archivo serán reemplazados por guion bajo (_).
  2. Evitar en el nombre de la plantilla el uso de caracteres especiales, de modo que no exista problemas al momento de generar el archivo .xls en base a ese nombre.
  3. El numero de fila a partir de la cual se muestran las cabeceras de cada columna es configurable desde Administración →  Información de configuración → file.xls.header.rowStart
  4. Así mismo, se podrá cambiar la posición en la que están organizados por defecto los campos en el Excel, para ello debe tener en cuenta que no se debe cambiar el nombre ya especificado para cada campo en la columna, ni eliminar alguno de los campos en el Excel, de lo contrario generara un error por pantalla que indica que "Los nombres de la cabecera del excel no corresponden al definido por la plantilla".


Workflows asociados a un usuario:

  1. Si un usuario tiene asociados todos los workflows  definidos en la consola, las promociones se importarán con el workflow general. De la misma manera que si un usuario no tiene asociado ningún workflow.
  2. Un usuario sólo verá en las vista "Gestión de Promociones", aquellas que han sido importadas con workflows que tiene asociados el usuario.



Limitaciones
  • No se podrán asignar variables a los campos que poseen validaciones (mascaras) o formatos específicos (select, numeric, boolean, entre otros) desde lado consola, por lo que se tomaran como variables en la plantilla todos aquellos campos donde el usuario indique algún dato valido, por lo que al indicar valores en las columnas que representan dicho campo los mismos serán guardados en la promoción durante la importación, en caso de no indicar algún valor en la columna del excel, se tomara el valor definido por el usuario durante la creación de la plantilla.
  • Para los campos de auto-completar, no se podrán definir variables con espacios, ejemplo: @[perfil del cliente], ya que el mecanismo de asignación de valores en un elemento auto-completar no lo permite, en ese caso se sugiere definir @[perfil_del_cliente] o utilizando cualquier otro separador.

  • Solo para casos donde el código de la promoción se repita en otras promociones, es decir que el código no sea único.
    1. El usuario deberá usar el nombre como campo clave para actualizar o cancelar las promociones por Excel, ya que es la única forma de identificar la promoción que será actualizada/cancelada, por lo que no será necesario especificar el código de la promoción en el Excel.
    2. Es importante tener en cuenta que solo podrá actualizar el nombre de la promoción por Excel especificando el código y si este código es único, es decir no se encuentre asignado ya a otra promoción existente.
  • Validación durante el proceso de importación: 
    Beneficios:
    - Para los campos dentro del beneficio que representan porcentajes, no se puede identificar para validar que el valor no sea mayor a 100.

    - Para opciones del beneficio y limites del beneficio, se creo en cada entidad el método donde se indican los detalles de cada campo (nombre, tipo, requerido), esta solución surgió como respuesta a la dificultad de mantener de forma dinámica las validaciones de campos asociados a Opciones y Limites del beneficio, ya que los tipos dispuestos para cada campo dentro de cada entidad no corresponden al tipo dado operativamente desde lado consola y no se podía determinar cual era requerido o no.

  • Edición de promociones que se hayan generado a partir de la plantilla: Como discernir entre una actualización total a una parcial (puntualizando en campos específicos), ejemplo: para el caso de condiciones simples, si se tiene definido: Marca, Proveedor y Código (SKU)
    • Caso 1:  Se quiere actualizar solo el valor del elemento Marca y que tanto Proveedor y Código (SKU) se mantengan tal como se encuentran definidos en la promoción a editar, esos campos se dejarían vacíos dentro del excel.
    • Caso 2: Si lo que se quiere es actualizar el valor del elemento Marca y que los elementos Proveedor y Código (SKU) ya no estén disponibles dentro de las condiciones simples, los valores asociados a esos campos deben eliminarse manualmente desde la promoción en la consola. Para ello, se debe acceder al menú Operación -> Promociones, buscar la promoción relacionada, editarla y borrar los valores correspondientes a Proveedor y Código (SKU).


  • Edición/cancelación de promociones por Excel:
    Solo para casos donde el código de la promoción se repita en otras promociones, es decir que el código no sea único.- El usuario deberá usar el nombre como campo clave para actualizar o cancelar las promociones por Excel, ya que es la única forma de identificar la promoción que será actualizada/cancelada, por lo que no será necesario especificar el código de la promoción en el Excel.
    - Es importante tener en cuenta que solo podrá actualizar el nombre de la promoción por Excel especificando el código y si este código es único, es decir no se encuentre asignado ya a otra promoción existente.


Asunciones
  • Las columnas asociadas a campos sobre los que no se haya definido alguna variable (@[......]) al estar vacías durante el procesamiento del excel, tomara el valor definido por el usuario durante la creación de la plantilla de promoción.
  • Durante el proceso de importación cada columna de la cabecera estará sujeta a las validaciones propias del campo que representa.

  • Los elementos auto-complete, que permiten la asignación de valores alfanuméricos por parte del usuario, podrán ser usados para definir variables. No se podrán definir variables con espacios en los elementos de condiciones simple o el universo de aplicación del Combos o beneficios, en ese caso se sugiere el uso de algún separador (_,-) entre cada palabra, como por ejemplo: @[perfil_del_cliente].

  • Para los campos nativos del beneficio se obtiene su nombre desde message.properties, en el caso de ser un nuevo campo insertado desde la ABM de Propiedades de beneficio, el nombre se obtiene a partir del campo nombre (name) de esa propiedad.
  • Para las operaciones Actualizar y Cancelar, se deberá indicar el código o nombre asociada a la promoción sobre la que se quiere realizar dicha acción.

  • No se podrá Actualizar o Cancelar promociones con estado Distribuido o Distribuido editable (DEPLOYED/DEPLOYEDEDITABLE), tal como sucede desde lado consola, adicionalmente evitara problemas con la regeneración del id del beneficio, ya que se necesita mantener por su asociación con los limites.

Definir

Se podrán indicar las condiciones por Rango Horario, Simples, por composición y los beneficios asociados a la plantilla de la promoción.


Debido a la naturaleza de los campos asociados a las Condiciones de rango horario, el usuario no podrá indicar variables (@[variable...]), por lo que al definir alguna condición del este tipo, la misma se mostrará como variable dentro del Excel, lo que significa de acuerdo a la imagen, es que se agregaran las columnas Rango de fecha con hora y Rango de hora, siendo estas las condiciones que se agregaron en la plantilla. En la consola: 

Formato de las condiciones por Rango horario en la plantilla Excel:

En el caso de que el usuario no indique algún dato en el columna correspondiente a las variables de Condición de rango horario, la promoción se creara tomando como valores configurados en la plantilla de promoción.



Para el caso de las condiciones simples, la asignación de variables aplica solo para elementos de tipo Autocompletar, debido a que permiten el ingreso libre de valores alfanuméricos. Para la definición del nombre de la variable, en el caso de que no se pueda separar con espacios, se sugiere el uso de guion o guion bajo (-, _), por ejemplo: @[variable_condition_1] o @[variable-condition-2]Para diferenciar dentro de la plantilla de Excel las variables asociadas a cada condición simple, se podrá visualizar por cada una de ellas un sufijo igual a Condición simple seguido del numero de condición y el tipo de Elemento al que pertenece.

En la consola:


Plantilla de Excel. Formato de las variables asociadas a las condiciones simples

  1. Adicionalmente, se sugiere asignar un único nombre que identifique la variable entre los elementos de la condición, para evitar ambigüedades en el proceso de creación de promociones a partir de la plantilla Excel.
  2. De las variables que se declaren en cada elemento de la condición, solo se tomara en cuenta para mostrar en el Excel la primara variable que se defina, es decir: si se indica los siguientes valores dentro de algún elemento Codigo (SKU) igual a @[code_producto], @[code_sku], solo se tomara como variable @[code_producto].
Esto es porque a efectos del proceso, basta con declarar una única variable sobre el elemento de la condición para identificarlo dentro de la plantilla de Excel.



Se tomara como variables todos los campos con valores definidos en pantalla (A), así como también todas las variables (@[variable_test]) que se definan dentro de los tipos de elementos de cada

condición (B).

Para diferenciar dentro de la plantilla de Excel las variables asociadas a cada combo, se podrá visualizar por cada campo del combo un sufijo igual a Cond. por composición seguido del numero de combo al que pertenece.


Los siguientes campos señalados en la imagen no se mostrarán como variables dentro del Excel, ya que de ambos dependen los campos que identifican el beneficio, siendo ambos valores fijos que representan el tipo y clase beneficio y no pueden ser modificados.
  1. Tipo de beneficio 
  2. Clase de BeneficioCampos con valores fijos en el beneficio de la plantilla de promoción:


  1. Solo los campos asociados a la Clase y tipo de beneficio que sean de tipo alfanuméricos permitirán la declaración de variables. Siendo la excepción aquellos campos de tipo autocomplete que no permitan el ingreso de valores que no estén dentro del catalogo, esto aplica solo si se encuentra habilitada la variable validate.autocomplete.existing.
  2. La declaración de variables dentro de los campos del beneficio es opcional, es decir que por defecto todos los campos asociados al tipo y clase de beneficio seleccionado serán visibles dentro de la plantilla de promoción, por lo que agregar variables para identificar cada campo puede resultar innecesario ya que todos los campos se visualizaran en el Excel.


Configuración de campos asociados al tipo y clase de beneficio:

El tipo de beneficio "Reintegro Bancario", el atributo "Con un Porcentaje*" no admitirá valores negativos.


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 (,).
Formato de opciones en Beneficio Canje con opciones:

Se tomarán como variables para el Excel aquellos campos donde el usuario haya indicado valores. De igual forma aquellos campos que permitan el ingreso de valores alfanuméricos permitirán la definición de variables (@[variable]). 


Al igual que las Opciones del beneficio, al definir un límite tal como se ve por pantalla, el usuario podrá visualizar en el Excel la variable Límites .., donde podrá indicar los datos correspondientes al límite entre corchetes [...], e indicar más de uno separándolo con coma (,), tal como se muestra en la siguiente estructura:
                                      

[Tipo de limite, Periodo a contabilizar, cantidad días, Limitar por, Valor]

 Limites de aplicación del beneficio


CampoDetalle
1Tipo de limiteValores disponibles:
  • retailer → General
  • store → Tienda
  • customer → Clientes
2Tienda
  • Aplica solo para limites de tipo Tienda (store)
  • Es opcional, solo es requerido para limites asociados a una tienda especifica (ver sección: Limites con tienda especifica).
  • Representa el código de la tienda existente para la compañía, esto aplica solo si se encuentra habilitada la variable validate.autocomplete.existing, de lo contrario podrá indicar cualquier valor dentro del campo. Aunque lo ideal es que se asocie el limite de tipo tienda con el código de alguna existente.
3Periodo a contabilizarValores disponibles:
  • undefined → Indefinido
  • day → Dia
4Cantidad díasNumero de días asociado al periodo a contabilizar day
5Limitar porIndica el criterio de acumulación del limite, dentro de las opciones disponibles están las siguientes, las cuales dependerán del tipo y clase de beneficio seleccionado:
  1. benefitAmount → Cantidad de dinero
  2. benefitApplicationCount → Cantidad de aplicaciones
  3. benefiedProductCount → Cantidad de productos beneficiados
  4. issuedCouponsCount → Cantidad de cupones emitidos
  5. benefitPoints → Cantidad de unidades de fidelidad otorgados
  6. giftBenefitCount → Cantidad de regalos otorgados
  7. generalBenefitCount → Beneficios generales
  8. walletBenefitCount → Beneficio Monedero otorgados
6ValorIndica la cantidad/monto asociado al criterio de aplicación seleccionado

Formato del Limites en la plantilla Excel




Resultado en pantalla. Datos en los limites de la promoción creada desde Excel

Limites con tienda especifica

En el caso de limites asociados a una tienda especifica, se suma el campo Código de tienda, este código deberá ser de alguna tienda existente asociada al usuario.

Así mismo el usuario deberá indicar los datos en el Excel, con el siguiente formato                                                               

  [Tipo de limite, Código de la tienda del usuario, Periodo a contabilizar, cantidad días, Limitar por, Valor]



En el caso de que el usuario no indique datos dentro de la columna Limites de aplicación (Beneficio N°...) del Excel, durante el alta de la promoción se tomarán como valores de los límites aquellos ya definidos en la plantilla.



Al igual que los casos anteriores, la definición de la escalonada será dentro del beneficio de la plantilla. El usuario podrá visualizar en el Excel las columnas Escalón de Escalonada y Unidad medida de Escalonada, teniendo la siguiente estructura para cada campo:

Detalle de los campos de Escalonadas

CamposDetalles
Escalón de EscalonadaLista de valores numéricos entre corchetes ([....]) separados por comas (,)Estructura:[Ocurrencias mínimas, Ocurrencias máximas, Valor]Ejemplo:[1,1,20],[2,4,30]
Unidad de medida de EscalonadaValores disponible:
  • qty → Cantidad
  • magnitude → Magnitud
  • xprice → Precio
Ejemplo:qty

Definición de escalones en plantilla de promoción


En el caso de que el usuario no indique ningún dato relacionado a las escalonadas dentro del Excel, la promoción se creara con la definición de escalonadas configurada en la plantilla de promoción.


El usuario podrá indicar los datos del escalón de acuerdo a la estructura:

[Ocurrencias mínimas, Ocurrencias máximas, Valor]


Formato del campo definición de Escalonadas en la plantilla Excel



Al igual que las secciones anteriores, se visualizaran en el Excel todos aquellos campos donde el usuario defina un valor. Con respecto a la definición de variables sobre estos campos, se consideran aquellos que permitan el ingreso libre de valores alfanuméricos como es el caso de los siguientes:
  • Cuenta contable
  • Mensaje en POS
  • Mensaje en impresora
  • Mensaje en TLOG


Proveedor del bien, proveedor financiero y proveedores adicionales: Estos campos en el beneficio representan el importe de cada proveedor tomando en cuenta el tipo (monto/porcentaje) y valor del importe, por lo que de acuerdo a la naturaleza de estos campos, se hace necesario un tratamiento particular dentro del Excel para definirlos correctamente: Código del proveedor, Tipo de importe, Valor

Detalle de los campos en Proveedor del bien y financiero

Campo
Código del proveedorCódigo del proveedor en CatalogSupplier
Tipo de importeOpciones disponibles:
  • amount → Monto
  • percentage → Porcentaje
ValorValor numérico asociado al tipo de importe indicado

Formato del proveedor del bien y financiero

Para identificar las variables que pertenecen a cada Beneficio se les agrega el sufijo con la siguiente estructura: Nombre de la variable (Beneficio #. Clase y tipo del beneficio)Ejemplo:
  1. Límites de aplicación (Beneficio 1. Canje con opciones)
  2. Límites de aplicación (Beneficio 2. Canje con opciones)
Aquellos campos que no permiten el ingreso de variables y cuyos valores no hayan sido indicados en el Excel, la promoción creada tomara por defecto los valores configurados en la plantilla de promoción.




Se deben tener en cuenta, cuando se agregan los beneficios, que excel dispone de 256 columnas. Por cada beneficio, excel genera 15 columnas.


Procesamiento del Excel


  1. Todas las promociones creadas a partir de una plantilla deberán respetar la estructura heredada de la misma, esto con el propósito de mantener la compatibilidad entre la plantilla y la promoción en futuras actualizaciones.
  2. Por lo que todos aquellos elementos incorporados manualmente o por servicio Rest y que no sean compatibles con la plantilla serán removidos.


Una vez generado el Excel e indicado los valores de cada promoción en el mismo, deberá presionar el botón Examinar y seleccionar el archivo de la plantilla, seguidamente deberá presionar el botón Procesar archivo:

 Si el proceso es exitoso, visualizara el siguiente mensaje, el cual indica la cantidad de promociones validas que fueron procesadas correctamente, con promociones con error igual a 0.

Una vez finalizado este proceso, se observara el detalle de la importación en la sección ÚLTIMAS OPERACIONES REALIZADAS, aquí podrá consultar por el Estado de las importaciones realizadas: Procesado y Error.

Así mismo, en la grilla de datos podrá visualizar el estado de la importación PROCESADO o ERROR y detalles como la cantidad de Promociones insertadas, actualizadas y canceladas, así como las promociones con error.

En cuanto a los estados de la importación se tiene lo siguiente:

PROCESADO: Asociado a las importaciones procesadas exitosamente, los registros con este estado tendrán habilitado el botón  el cual dirigirá al usuario al informe de Promociones, donde podrá visualizar detalles generales de las promociones importadas.

ERROR: Para las importaciones con error, el usuario podrá visualizar los detalles de los mismos presionando el botón  el cual lo dirigirá a la vista Detalle de promociones erróneas.

Si durante el procesamiento de los datos ocurre algún error de validación o formato en alguno de los campos de las promociones procesadas, se visualizara el siguiente mensaje por pantalla:


  • Importación de un archivo vacío (sin datos de las promociones a importar), se visualizara el siguiente mensaje en pantalla:
  • Se importa un archivo Excel con un formato en el nombre diferente al esperado por el importador de dicha plantilla, en este caso el usuario visualizara el siguiente mensaje de error: 
  • La cantidad de campos en el Excel no corresponde a la cantidad de datos de la plantilla, esto ocurre cuando se actualiza la plantilla pero el Excel no, por lo que el usuario podrá visualizar el siguiente mensaje de error:

Actualización de Promociones por Alta Masiva


Consideraciones Importantes
  1. Se mantendrán los valores de la promoción a actualizar, reemplazando solo aquellos que sean indicados en la plantilla de Excel.
  2. Es importante que el código de la promoción a Modificar no se encuentre repetido, ya que el proceso terminara modificando la promoción que coincida con la búsqueda y esta puede o no corresponder a la promoción deseada, por ende es importante en este caso tener en cuenta que debe identificar la promoción a modificar/cancelar por su nombre ya que este es su identificador y no el código.
  3. Si la promoción es modificada manualmente o por servicio Rest y se cambia tanto la estructura de las condiciones, universo de aplicación, combos y beneficios, esta al ser actualizada a través del proceso de alta masiva por Excel, todos los elementos que se hayan insertado y que no correspondan a la estructura de la plantilla serán removidos, ya que el proceso siempre actualizara la promoción en base a la estructura de la plantilla configurada, removiendo todos aquellos datos que no sean compatibles con la misma.
  4. Los valores de una promoción basada en una plantilla pueden ser modificados manualmente, respetando la estructura heredada de la plantilla, esto para evitar problemas de compatibilidad al momento de querer actualizarla de forma masiva a través de la plantilla Excel, tal como lo plantea el punto 2.
  5. Los elementos de las condiciones simples o del universo de aplicación de los combos/beneficios, configurados desde la plantilla con valores por defecto (ver caso 2), al indicar nuevos valores para estos elementos en la promoción desde Excel, siempre mantendrá el valor(es) por defecto definidos en la plantilla, por lo que el elemento se terminara actualizando con el valor dado en el Excel mas el valor(es) por defecto indicados en la plantilla.
  6. Sólo se podrán actualizar promociones que no estén canceladas y que hayan sido creadas previamente mediante la plantilla de Excel. Las promociones creadas manualmente no podrán actualizarse por este proceso.
  7. Todas las promociones actualizadas desde el alta masiva por Excel cambiaran su estado a Completa, salvo en el caso de promociones con Canales de Publicación Facebook o Twitter, se crearan con estado Incompleta hasta que el usuario no indique de forma manual la imagen asociada a la promoción creada.
  8. Si se crea una plantilla con valores por defecto en los elementos de las condiciones simples/universo de aplicación de combos y beneficios, estos serán heredados por las promociones creadas a traves de la plantilla, por lo que para indicar valores distintos por promoción a traves del Excel se debe sumar a la plantilla en los elementos una variable, ejemplo: @[variable_test], el nombre indicado entre @[....] sera visible en la plantilla de excel como una columna, por lo que los valores indicados en la celda y los que vienen fijos desde la plantilla seran los que tomen las promociones creadas.
  9. Ejemplo: Dada una plantilla con una condición simple por sku igual a @[variable_sku],111
    1. Al crear una promoción desde el excel dejando las celda vacia de la columana variable_sku, esta se creara por defecto con una condición por sku con el valor 111, por lo que al actualizar dicha promoción desde el Excel indicando el valor ABC en la celda de la columna variable_sku, al procesar el Excel se actualizara la condición de la promoción de  111 a ABC,111; si bien el valor 111 no se indico en el Excel este siempre se heredara de la plantilla.
    2. Ahora, si se actualiza nuevamente la promoción desde el Excel, sumando los valores 222,333,444, una vez procesado se actualizara la promoción donde la condición paso de ABC,111 a 222,333,444,111, por lo que si se quiere conservar el valor cargado en la actualización anterior, este se debera indicar en la celda del excel junto con los nuevos valores, Ejemplo: 222,333,444,ABC, con lo cual la promocion con condición siemple por SKU quedara con los elementos 222,333,444,ABC,111
    3. Recuerde que en el ejemplo, el valor 111 siempre sera herededo desde plantilla, por lo cual no sera necesario indicarlo en el Excel.
  10. Con respecto a la actualización de limites en la promoción, los limites indicados en el Excel reemplazaran en su totalidad a los limites anteriores.


  • Detalle de Error al intentar actualizar una promoción cancelada
  • Detalle de Error al intentar actualizar una promoción que no existe o no se encuentra asociada con la plantilla de promoción.


  • Si la plantilla de Promociones, desde la cual se va a hacer el alta masiva, posee Propiedades de Beneficios; éstos no son necesarios colocarlos en el archivo excel que intervendrá en el proceso.
  • Si durante el procesamiento del Excel alguna de las promociones presenta error, el proceso no insertara/actualizara o cancelara ninguna de las promociones hasta que el error en la promoción no sea corregido. Por lo que una vez que se detecte el error y se corrija se deberá re procesar todo el archivo.


Cancelar Promociones por Alta Masiva

Es importante que el código de la promoción a Cancelar no se encuentre repetido, ya que el proceso terminara cancelando la primera promoción que coincida con la búsqueda y esta puede o no corresponder a la promoción deseada, por ende es importante en este caso tener en cuenta que debe identificar la promoción a cancelar por su nombre ya que este es su identificador y no el código.

Para cancelar una promoción; esta no debe estar distribuida.

Cuando se quiera cancelar promociones distribuidas, el procesamiento del archivo dará error:


El campo Motivo de Cancelación es obligatorio.

Ej.: se genera el archivo con la promoción a cancelar; sin el motivo.

Al procesar el archivo, este da error:

En el detalle de error, se observa:


Para cancelar una o varias promociones desde el Excel a través del alta masiva, el usuario deberá indicar solo 3 datos sobre los siguientes campos:

Una vez procesado correctamente podría visualizar por pantalla el siguiente mensaje indicando que el proceso fue exitoso, así como el detalle de la importación.


Para cancelar una promoción a través de una archivo, no es necesario cargar todos los datos de la promoción en el mismo.

Opción 1: Informar sólo el nombre de la Promoción que se desea cancelar

En la consola:


Opción 2: Informar el nombre  y el código de la Promoción que se desea cancelar

en la consola:


Opción 3: Informar sólo el código de la Promoción que se desea cancelar

En la consola:


  • Si se desea cancelar y/o actualizar una promoción cuyo código se repite en otras promociones, se debe tener en cuenta informar el nombre de la que se desea cancelar y/o modificar.
  • Si la plantilla de Promociones, desde la cual se va a hacer el alta masiva, posee Propiedades de Beneficios; éstos no son necesarios colocarlos en el archivo Excel que intervendrá en el proceso.
  • En el caso de que origine algún error de validación durante el chequeo del excel, no se procesara ninguna de las operaciones asociadas a la promociones generadas durante ese procesamiento.


Cancelación Masiva 

Desde la consola de Promo, se podrá realizar la cancelación de muchas promociones al mismo tiempo, para ello deberá accederse, en el menú Operaciones, a la opción "Cancelación Masiva"

Se presentara la pantalla "Cancelación Masiva de Promociones", desde donde podrán seleccionarse las promociones que se deseen cancelar. En el filtro de tiendas; sólo estarán aquellas que el cliente tenga vinculadas y si el usuario 

tiene asignadas todas las tiendas, también verá las tiendas inexistentes.


En esta pantalla podrán ejecutarse los siguientes filtros a fin de poder identificar las promociones que se quieran cancelar:


El usuario sólo tendrá disponible en el registro de Tiendas; las que tenga asociadas.

En la grilla se mostraran todas las promociones, pero solo podrán cancelarse las promociones en estado "Completas" o "Incompletas". Las promociones en estado "Distribuido" no podrán ser canceladas. 

Al seleccionar una o mas promociones, deberá presionarse el botón "Cancelar Promociones Seleccionadas", y se mostrara la pantalla "Cancelar Promociones", donde deberá indicarse un motivo para la cancelación de promociones.



La cancelación de una promoción NO tiene reverso.


Límites Promociones

Desde esta opción del menú, se puede cambiar el límite (o los límites) de cualquier promoción que se encuentre en estado completa y vigente operando ya en una tienda. El POS recibirá estos límites sin necesidad de volver a distribuir un mapa. Si las promociones están en estado Incompleta, se podrá cambiar su límite editando la misma.


Para configurar los límites de una promoción Ver definición de Beneficios de promociones >> Limites.


Edición de Límites:

Desde el menú principal, al seleccionar: Operación> Límites Promociones, el sistema mostrará la pantalla “Límites Promociones”.

Debajo del título se verán los campos “Código", "Nombre de promoción”  y "Tiendas" por los que se podrán buscar promociones.

Las tiendas disponibles en el filtro son sólo aquellas que tiene vinculadas el usuario.

Debajo de los filtros se verá un listado con todas las promociones activas en un mapa que han transaccionado y que tienen un límite definido (o varios) y no están en estado Incompleta, sin importar su vigencia. Se podrá modificar tanto las promociones vigentes como las vencidas o sin vigencia definida.  

El listado mostrará las siguientes columnas:


Sólo se podrán cambiar los “Valores” para los límites ya definidos para la promoción seleccionada y que ya haya transaccionado. Desde esta sección no se podrá agregar ningun “Tipo de límite” (ej. General, Tienda, Cliente) que la promoción no tenga asociada.

No se podrá modificar el “Período a contabilizar” (ej: indefinido, x día).

No se podrá modificar la opción “Limitar por” (ej: Cantidad de dinero, Cantidad de aplicaciones, Cantidad de productos beneficiados).

En la pantalla de "Límites Promociones" a la derecha de cada promoción listada se mostrará el botón “Editar” desde el que podrá accederse a la sección de edición de limites de cada promoción.

Al seleccionar el botón “Editar” el sistema mostrará todos los límites configurados en el o los beneficio de la promoción pudiéndose desde allí modificar (aumentar o disminuir) cualquiera de los límites existentes.


Editar Límite: 




Los siguientes campos no se podrán editar:

Nombre de promoción: mostrará el nombre de la promoción.

Código: mostrará el Código de la promoción.

Clase de beneficio: mostrará la clase a la que pertenece el beneficio (por ej. Descuento porcentaje).

Beneficio: mostrará el número de beneficio (por ej. Beneficio N°1).


En la sección "Límites Configurados" mostrará: General, Tienda y Cliente y dentro de cada uno podrá mostrar: "Cantidad de dinero", "Cantidad de aplicaciones", "Cantidad de productos beneficiados", dependiendo de los campos que contengan límites configurados. Podrá haber hasta 9 límites para un beneficio. A la derecha de cada Tipo de Límite se mostrará un campo editable, donde se podrá ingresar un número sin decimales mayor o igual a 0. No se podrá ingresar un número negativo. Por default traerá el valor configurado en la promoción o el último modificado en esta pantalla.

Motivo: En este campo es obligatorio seleccionar alguna de las opciones que muestra en el combo desplegable si se modifica algún límite. Al ingresar en la pantalla "Editar Límite" para ver/modificar los límites existentes de una promoción. En el campo Motivo, siempre mostrará "[Motivo]" no mostrará el último motivo ingresado. Este campo se utiliza para llevar un registro de auditoria que se podrá ver en el Informe "Historial Límites". (ver también "Motivos de Modificación de Saldo")

Al editarse el limite, el cambio se vera reflejado tanto en la definición del beneficio en la promoción, como en el Popup de resumen de la promoción.


Al momento de realizarse alguna modificación en el o los limites de alguna promoción, el sistema podrá informar de esta acción de actualización a algún sistema externo que desee recibir esta información.

Desde la consola de Usuario de Promo, se indicar el Nombre de la cola de RabbitMQ para el posteo de datos de tipo Limites de promociones (rabbitMQ.limitstatus.endpointName), y al hacerlo quedara habilitada esta funcionalidad.

El estado de este proceso podrá visualizarse en la sección "Monitor de Importaciones" en la consola de Promo.


(Para más información sobre la configuración en consola de Promo ver Administración > Información de configuración en este mismo documento.)

(Para más información sobre el proceso y datos de la integración con las colas RabbitMQ ver PROMO 7.4 - Manual de Integración - Colas de Mensajes


Capítulo 6 - Módulo de Workflow


El Workflow describe los pasos necesarios para aprobar una promoción, mostrando la estructura y el orden correlativo de los mismos. Los pasos representan las etapas de aprobación de una promoción y el rol asociado a cada uno de ellos.

Por default se cuenta con un workflow por default (Workflow general), que posee un único paso para la aprobación de una promoción. El universo de aplicación de un workflow no podrá ser editado una vez que tenga asociado promociones.


Múltiples Workflows

En PROMO se cuenta con la posibilidad de definir más de un Workflow para la aprobación de promociones o condiciones generales. De esta forma podrán manejarse de manera independiente los pasos para aprobar un determinado grupo de promociones o condiciones generales.

Por ejemplo, las promociones que apliquen sobre un determinado rubro o de un determinado beneficio podrán ser aprobadas en el Workflow A que tiene definido 4 pasos, mientras que otro grupo de promociones que aplican sobre otro grupo o segmento de ítems o aplican otro margen de beneficio serán aprobadas por el Workflow B que tiene definidos 2 pasos.

Lo mismo sucede para los Workflows de Condiciones Generales.

Los WF podrán aplicar a:


Para la definición de estos Workflows deberá darse clic en el botón "Nuevo" de la ventana "Workflows". 

Se presentara la pantalla de "Nuevo Workflow" donde se deberá ingresar un nombre y una descripción.

Se muestran 2 checkbox's, que indican si el Workflow aplica a promociones, o a condiciones generales o a ambas. Por default, los 2 checkbox's están tildados.


Si un workflow ya se encuentra utilizado en una promoción/condicion general, al mismo NO se le podrá destildar el check "Aplica Promociones" o el check "Condiciones Generales".


 Al dar clic en "Guardar" se mostrará la pantalla con la lista de "Workflows" donde podrá indicarse los pasos que compondrán ese Workflow y que roles serán los encargados en cada paso de realizar la aprobación.

Por defecto, el paso 1 estará ya definido bajo el nombre de "Captura" y lo tendrá asignado el rol Administrador. 


Al hacer click en el botón “Nuevo”, podrán definirse nuevos pasos dentro del mismo y asociar el rol correspondiente para su aprobación. 

Al seleccionar el Rol, la aplicación desplegará un textbox con todos los usuarios que tienen asignado ese rol:

Si no se selecciona ningún usuario se verá como en el siguiente ejemplo el orden 1. Si se selecciona sólo 1 usuario se verá como en el orden 2 de la siguiente imagen. Si se seleccionan dos usuarios se verán como se muestran en el orden 3.  Si se seleccionaron todos los usuarios, se mostrarán separados por coma todos los usuarios. Al hacer click en “Guardar”, mostrara los pasos que componen el WF:

El usuario que crea el workflow tendrá disponible sólo los roles que le han sido configurados.


Pasos de un Workflow

Al crear una promoción, esta es asignada a un Workflow determinado (en la definición de cabecera de la promoción) y una vez completa puede enviarse para aprobación.

Si hemos definido mas de un paso para el workflow seleccionado, la promoción deberá ser aprobada por todos los pasos integrantes del Workflow al que pertenece para participar luego de un mapa.

Para enviar una promoción para revisión o aprobación, habrá que dar clic en el botón "Enviar para aprobación" , en el ítem Acciones, como se muestra en la imagen a continuación:


Promociones para Aprobar


Una vez enviada una promoción para aprobar, esta permanecerá en la pantalla "Gestión de promociones" con el estado "Revisión/Aprobación" y a su vez figurando en la pantalla "Promociones para Aprobar", desde donde el usuario con el rol definido para ese paso en el workflow al que pertenece la promoción, aprueba o rechaza la promoción enviada.

Para acceder a las promociones para aprobar se debe ingresar en el menú "Operación" y en el menú desplegado se debe oprimir "Promociones para Aprobar", como se muestra en la siguiente imagen:

En el caso de haber ingresado con un usuario con permisos de administrador, se visualizará a la derecha del título "Promociones para Aprobar" el contador indicando "n" cantidad de promociones enviadas para aprobar (en este caso, siguiendo con el ejemplo será "1" como se indica en la imagen).

En el caso de haber ingresado sin permisos de administrador (como con el usuario "Operador") se visualizará en el submenú el título "Promociones para Aprobar", pero con el valor de cantidad que está a la derecha, en cero "0".

Cada rol vera las promociones a aprobar de los workflows en los que participe.

Al presionar la opción "Promociones para aprobar" la vista tendrá como filtro la tienda en la que se aplicará la promoción:


El sistema lo conducirá a la siguiente pantalla, donde al oprimir el botón "Acciones" se desplegará el submenú con las siguientes opciones:

  1. Historial WF
  2. Resumen
  3. Aprobar/Rechazar


Para aprobar o rechazar una promoción se deberá oprimir la opción "Aprobar/Rechazar" y una vez hecho esto, el sistema mostrará el siguiente cuadro de diálogo:

Desde allí se podrá rechazar o aprobar una promoción, oprimiendo "Rechazar" o "Aprobar" además de poderse registrar información (texto) en el cuadro vacío "Nota" en relación a la acción realizada.

Una vez aprobada o rechazada, la promoción figurará con el estado correspondiente, en la página "Gestión de promociones" en la columna de Workflow que figura con el nombre del workflow al que pertenece

Al finalizar el ciclo de revisión, la promoción se encontrará aprobada completamente y se podrá incorporar en un mapa.

Los workflows no se importan en los mapas. Por lo que al importar una promoción que tenga un workflow en varios pasos, tomará por default el General.


 La opción de "Promociones para Aprobar" solo aparecerá cuando se haya definido más de un paso de aprobación en el alguno de los Workflow definidos.


Si una promoción es editable, está en estado "Distribuída" y tiene un workflow de varios pasos: luego de ser editada pasa a estado "Completa" y el workflow pasa de nuevo para aprobación porque la promoción fue modificada. Si el workflow que tenía asociado era de un solo paso, la promo pasa a estado "Completa" pero al no tener aprobación pendiente del workflow se aprueba automáticamente.


Condiciones Generales  para Aprobar

Cuando una condición general fue definida con un workflow de más de un paso y es enviada para aprobación, esta permanecerá en la pantalla "Gestión de Condiciones Generales" con el estado "Revisión/Aprobación" y a su vez figurando en la pantalla "Condiciones Generales para Aprobar", desde donde el usuario con el rol definido para ese paso en el workflow al que pertenece la condición, la aprueba o rechaza.

Para acceder a las condiciones para aprobar se debe ingresar en el menú "Operación" y en el menú desplegado se debe oprimir "Condiciones Generales para Aprobar", como se muestra en la siguiente imagen:

De la misma manera que Promociones para aprobar, si se ha ingresado con un usuario con permisos de administrador, se visualizará a la derecha del título "Condiciones Generales para Aprobar" el contador indicando "n" cantidad de condiciones enviadas para aprobar (en este caso, siguiendo con el ejemplo será "1" como se indica en la imagen).

En el caso de haber ingresado sin permisos de administrador (como con el usuario "Operador") se visualizará en el submenú el título "Condiciones Generales para Aprobar", pero con el valor de cantidad que está a la derecha, en cero "0".

Cada rol vera las condiciones generales a aprobar de los workflows en los que participe.

Una vez que se oprima la opción "Condiciones Generales para aprobar", un usuario perteneciente al rol definido, podrá revisar y aprobar / rechazar la condición.

El sistema lo conducirá a la siguiente pantalla, donde al oprimir el botón "Acciones" se desplegará el submenú con las siguientes opciones:

  1. Historial 
  2. Aprobar/Rechazar



Para aprobar o rechazar una condición general se deberá oprimir la opción "Aprobar/Rechazar" y una vez hecho esto, el sistema mostrará el siguiente cuadro de diálogo:

Desde allí se podrá rechazar o aprobar una condición, oprimiendo "Rechazar" o "Aprobar" además de poderse registrar información (texto) en el cuadro vacío "Nota" en relación a la acción realizada.

Una vez aprobada o rechazada, la condición figurará con el estado correspondiente, en la página "Gestión de Condiciones Generales" en la columna de WF que figura con el nombre del workflow al que pertenece

Al finalizar el ciclo de revisión, la condición se encontrará aprobada completamente y se podrá incorporar en un mapa.


Cuando una promoción/condición general sea asignada a un workflow de solamente un paso, esta quedara "Aprobada" inmediatamente una vez que pase a "Completa", podrá ser editada y se encontrara disponible para ser incluida en un mapa.


Cuando una promoción/condición general sea asignada a un workflow con mas de un paso, y sea "ENVIADA PARA APROBACION", la promoción/condición general NO PODRA EDITARSE ya que se espera la aprobación o rechazo de lo definido en ella.

En caso de que la promoción/condición general sea "rechazada" por alguno de los pasos del WF, ésta volverá al primer paso, donde podrá editarse y corregirse.

Cuando la promoción/condición general sea "APROBADA" por todos los pasos del WF al que fue asignada, la promoción NO PODRA EDITARSE, y se encontrara disponible para ser incluida en un mapa.

En la vista "Promociones para Aprobar"/ "Condiciones Generales para Aprobar", el usuario soló verá las tiendas que tiene asociadas.


Por default (si no filtra nada) al ingresar a la pantalla "Promociones para aprobar"/ "Condiciones Generales", le mostrará todas las promociones que el usuario logueado tiene pendientes de aprobación para todas las tiendas que tiene vinculadas.


Historial del Workflow

El Workflow permite definir un flujo de revisión y aprobación de las promociones.


Ejemplo:

  1. El operador captura las promociones/condiciones generales y envía para su aprobación.
  2. El supervisor, valida la promoción/condición general cargada y las aprueba o rechaza de acuerdo a su criterio.


Las promociones/condiciones generales que han sido aprobadas completamente podrán agregarse a un mapa y ser distribuidas a las tiendas.

Para acceder al historial del worflow se podrá ingresar desde:


En el historial del workflow se podrán visualizar :

  1. Los pasos realizados con cada promoción/condición general.
  2. El usuario que ha realizado cada uno de ellos
  3. La fecha y la hora en que fueron realizados
  4. Si han sido realizados con éxito


En la siguiente imagen se pueden observar los pasos detallados del Workflow en orden ascendente (de abajo hacia arriba) con la información especificada:

Promociones:


Condiciones Generales:





Capítulo 7 - Módulo de Distribución



Menú de Distribución


Desde ésta opción PROMO permite crear y distribuir mapas, simular tickets con promociones y mapas, como así también poder distribuir promociones en las distintas redes sociales.


Mapas

Un mapa es un grupo de promociones, con una vigencia y reglas que convivirán en el motor de promociones en un momento determinado.

El mapa se debe definir para poder especificar reglas de convivencia entre las promociones que lo integran y para especificar el orden de aplicación y consumo que existirá entre las mismas.

Para generar un mapa se deberá acceder a través del menú Distribución > Mapas (POS).


Las promociones no tendrán validez si las mismas no se encuentran dentro de un mapa. Solo así se podrán evaluar y aplicar según las reglas de convivencia que se les haya definido dentro del mapa. 

Donde:

Crear Mapa


Para poder crear Mapas se debe presionar el botón "Nuevo".

Cuando se defina un nuevo mapa, se puede optar por utilizar una de las Plantillas de Mapas completa, creada previamente desde el menú Administración> Plantillas de Mapa.

En la pantalla "Publicaciones Mapa (POS)" se deberán ingresar los siguientes datos requeridos:


Podrá aquí también configurarse el comportamiento de la sugerencia a nivel Mapa. Este campo también es requeridos, por default guarda "No sugerir".

Los campos a configuran serán:

Este dato permite al sistema determinar la cantidad de días que debe contemplar el uso del mapa para resolver las promociones en transacciones de devolución, a fin de conocer las promociones que se aplicaron en la en la compra original. Si no se ingresa un valor en este campo se considera que no existe limitación de días. Es opcional completar este campo.


El mapa se encontrará vigente solo después de generarse y distribuirse el archivo .XML de definición correspondiente.


Si en Administración > Plantillas de Mapas, en la pantalla "Gestión de Plantillas de Mapas" se presionó el botón "Generar Mapa", pasará a la pantalla "Publicaciones Mapa (POS)", donde el campo de "Plantilla de mapa" mostrará pre-cargado el nombre de la plantilla que se está dando de alta y no podrá editarse.

En el campo "Publicación" debe ingresar el nombre con el que se publicará el mapa.

Las fechas de inicio y fin de vigencia del mapa presentarán los valores por default y podrán editarse. El campo sugerencia, tomará los valores configurados en la plantilla y el campo días para devolución se presentará vacío como lo hace habitualmente. 


Luego, al presionar "Guardar" se mostrará la pantalla "Definir mapa (POS)", donde ya se mostrará en la composición del mapa, las promociones pertenecientes a los tipos, subtipos y formas de aplicación definidos en la plantilla de mapa que se dio de alta. 


Si se seleccionó una Plantilla de mapa

Mostrará una opción más en la parte inferior de la pantalla: "Distribución programada". Es un check que por default viene sin marcar. 

Si activó la Distribución programada: hay un proceso que se ejecuta automáticamente una vez al día para distribuir los mapas que tienen activo este check. Estos mapas deben tener una plantilla asociada y deben ser automáticos. (Ver más abajo CONFIGURACIÓN Y FUNCIONAMIENTO DE DISTRIBUCIÓN DE MAPAS AUTOMÁTICA Y PROGRAMADA).

Al presionarse "Guardar" en la pantalla "Publicación de mapa (POS)" se pasará a la pantalla de "Definir mapa (POS)", donde se mostrará en la composición del mapa, las promociones pertenecientes a los tipos, subtipos y formas de aplicación definidos en la plantilla de mapa.

Cuando se crean mapas en base a plantillas, las promociones que forman parte del mapa no serán removidas por el proceso de Depuración de Promociones



Si no se seleccionó una Plantilla de mapa:

Una vez que se hayan ingresado todos los datos del mapa, presionar el botón "Guardar".

Se mostrará la pantalla "Definir Mapa (POS)" en la cual se deberán seleccionar las promociones que integrarán el mapa.

Esta pantalla se encuentra dividida en dos sectores:


La cabecera en donde se visualizarán los datos cargados previamente junto con las opciones de Chequear colisiones, Generación Automática,  Resumen, Descargar, Distribuir, Editar y Volver.


Los datos de composición del mapa, donde se mostrarán los Pasos, Funciones, Promociones y Cond Gral (Condiciones Generales) disponibles.

En el área izquierda se podrán definir los pasos, funciones, promociones y condiciones generales seleccionando el elemento que se desea crear y arrastrándolo a la ventana derecha del panel. Se deberá crear un paso seleccionando el botón "Nuevo paso" y arrastrándolo hacia la ventana derecha.


Para hacer mas fácil la navegación entre las promociones de un mapa, se cuenta con la opción de colapsar o expandir todos los pasos del mapa, presionando el botón que se encuentra en el ángulo superior derecho sobre la definición del mapa.


Pasos

Cuando se define el mapa, cada una de las promociones integrará uno de los Pasos y de coexistir varias promociones dentro del mismo paso se combinarán mediante funciones de convivencia.

La existencia de pasos dentro del mapa permite restablecer los elementos consumidos por las promociones entre un paso y otro.

El usuario logueado verá todas las promociones que tienen asociadas sus tiendas vinculadas (o sea que el usuario admin verá todas las promociones, y otro usuario verá sólo las promociones que tengan asociadas las tiendas que el tenga vinculadas).

El usuario logueado podrá editar el mapa que llegó a su tienda, podrá ver todas las promociones del mapa, estén vinculados a sus tiendas o no. El mapa lo va a ver completo, pero sólo podrá agregar o quitar promociones que tengan asociadas tiendas que el tiene vinculadas. No podrá quitar promociones que tengan asociadas tiendas que el no tenga vinculadas.

El procedimiento de evaluación y aplicación de beneficios presentes en el mapa actuará del siguiente modo:

  1. Se evalúa la función de convivencia integrante del primer paso (recordar que la función es siempre única y que puede estar compuesta por promociones o por otras funciones).
  2. Dependiendo del tipo de función, una vez evaluada, consumidos los elementos del contexto recibido entre las promociones y aplicados los beneficios, pasa al próximo paso restableciendo los elementos del contexto que hayan sido consumidos al aplicarse las diferentes promociones y con los precios extendidos modificados por la aplicación de los beneficios.
  3. Continúa evaluando los siguientes pasos del mapa según lo explicado en los puntos 1 y 2.

Una promoción solo podrá existir dentro de un único paso, no pudiéndose encontrar la misma promoción en más de un paso.


Funciones de convivencia

Llamaremos "función de convivencia" a la expresión que determina el orden de procesamiento entre promociones dentro de un mismo paso.

También se determinará cómo será el "consumo de elementos".

Llamaremos "Consumo de elementos" cuando una promoción utiliza uno o varios elementos del contexto para aplicar un beneficio.

Los elementos que recibieron un beneficio dentro de un paso ya no se encontrarán disponibles para ser utilizados en una próxima promoción, a menos que la función de convivencia lo permita.

Las funciones de convivencia disponibles son:

Dentro de la función SECUENCIAL cada promoción integrante se procesa en el orden en el cual ha sido configurada la función.
La promoción procesada consumirá los elementos que hayan participado de la misma no pudiendo ser utilizados en las próximas promociones integrantes de esa función SECUENCIAL.
Es muy importante el orden en el cual se defina cada promoción dentro de la función, dado que este orden es el que se utilizará para realizar el consumo de elementos. Del proceso de todas las promociones de la función se obtendrá una colección de beneficios compuesta por la suma de los beneficios obtenidos de cada una de las promociones de la función.

Dentro de la función TODAS las promociones que intervienen se procesan en forma independiente en base al mismo contexto recibido por la función, generándose una colección de beneficios independientes los cuales se sumarán entre sí al finalizar el proceso. En este caso no será tan importante el orden en el cual se encuentren definidas las promociones dentro de la función TODAS ya que su proceso es independiente. Las Promociones intervinientes serán aquellas que tienen asociadas sus tiendas vinculadas (o sea que el usuario admin verá todas las promociones, y otro usuario verá sólo las promociones que tengan asociadas las tiendas que el tenga vinculadas).

En este tipo de función se procesa cada promoción en forma independiente y se genera una colección de opciones de los cuales el cliente podrá optar. De cada opción se obtendrá una colección de beneficios que se aplicarán de acuerdo a la opción seleccionada por el cliente. En el caso de la función OPCIONES, la cantidad de opciones que responderá el motor dependerá de la cantidad de promociones que la integren, apliquen o no. Más detalles de su funcionamiento en Manual de Integración - Motor, en el ítem Cuerpo, Opciones.

Con este tipo de función se evalúan en orden las promociones (según como fue definida la función), ante la primer promoción que cumpla con su condición y pueda aplicarse, se detiene la evaluación del resto de las promociones integrantes de la función, con lo cual ante la primer promoción que aplica, el resto de las promociones ya quedan excluidas de evaluación.

Esta función consta de una serie de promociones, que serán denominadas "condicionantes", y una que será la promoción "condicionada". De esta forma, sólo se aplicará la promoción condicionada sobre los artículos que hayan sido beneficiados por al menos una de las promociones condicionantes.  Las promociones condicionantes, pertenecen a pasos anteriores al paso en donde aparece la función EVALUA SI. Es por esto que la función EVALUA SI aparecerá en un segundo paso o pasos superiores pero nunca en el primer paso. La promoción condicionada será la última que aparezca en la lista, mientras que las condicionantes, por lo tanto, serán todas las que se encuentren primero. Si se desea que exista más de una promoción condicionada, todas ellas deberán estar dentro de alguna función de convivencia.


Esta función consta de una serie de promociones, que serán denominadas "condicionantes", y una que será la promoción "condicionada". De esta forma, y al contrario de la función anterior, sólo se aplicará la promoción condicionada sobre los artículos que no hayan sido beneficiados por ninguna de las promociones condicionantes.
Las promociones condicionantes, pertenecen a pasos anteriores al paso en donde aparece la función EVALUA SINO. Es por esto que la función EVALUA SINO aparecerá en un segundo paso o pasos superiores pero nunca en el primer paso. Ejemplo: Si la función EVALUA SINO, está en el tercer paso, las promociones integrantes de los pasos 1 y 2 pueden ser utilizadas como condicionantes.
Al igual que en la función anterior, la promoción condicionada será la última que aparezca en la lista, mientras que las condicionantes, por lo tanto, serán todas las que se encuentren primero. Si se desea que exista más de una promoción condicionada, todas ellas deberán estar dentro de alguna función de convivencia.


Ejemplo:


El mapa quedara conformado de la siguiente forma:


Se ingresa en la transacción 1 ítem que cumple con la Promo-A ("111")  y otro ítem que cumple con la Promo-B ("333").

Al evaluarse los ítems con el mapa que contiene la función "Evalúa Si No", se aplicara sobe el ítem "111" la Promo-A  y sobre el ítem "333" la "Promo-B".

El ítem "111" no se vera beneficiado por la Promo-B ya que por definición, solo se aplicara la promoción condicionada (Promo-B) sobre los ítems que NO hayan sido beneficiados por la promoción condicionante (Promo-A). 



Las siguientes funciones son sólo para BENEFICIOS MONETARIOS:


En este tipo de función se procesa cada promoción en forma independiente y PROMO informa cual es la promoción y correspondiente beneficio que otorgue el mayor descuento entre todas las promociones integrantes de la función. Como resultado se aplicará sólo una promoción, la que otorgue el mayor descuento al cliente.


En este tipo de función se procesa cada promoción en forma independiente y PROMO informa cual es la promoción y correspondiente beneficio que otorgue el menor descuento entre todas las promociones integrantes de la función.


En aquellos casos en los cuales la promoción integrante de la función MAX o MIN DISCOUNT, contenga más de un beneficio y alguno de ellos sea NO Monetario, la promoción se evaluara del mismo modo que el resto, pero en el caso de los beneficios NO Monetarios no contaran o sumaran importe al monto del beneficio que será el que luego se evalúe entre todas las promociones integrantes de la función que puedan aplicar.


Esta función evalúa todas las promociones incluidas en ella, en base a un contexto dado (ticket) y luego otorga el conjunto de promociones que dé el mayor monto de descuento al cliente.

Esta función de convivencia deberá ser utilizada sin ningún tipo de anidado, ni fuera ni dentro de ella ya que solo será tenida en cuenta la operatoria del máximo descuento combinado y no las demás funciones de convivencia anidadas.

Deberá considerarse también que las promociones que se incluyan dentro de la evaluación de esta función de convivencia deberán estar compuesta por un solo beneficio.

La función de Máximo descuento combinado debe tener al menos dos promociones dentro del paso para poder aplicar la funcionalidad de competencia de promociones.


Cuando una promoción otorgue un beneficio que otorgue un cupón calculado (No Monetario), es decir que tendrá un valor asociado, y esta promoción sea colocada dentro de una función de convivencia Máximo Descuento Combinado, el monto a emitirse en el cupón será evaluado en el contexto de la transacción como un beneficio Monetario y en caso de ser el mejor beneficio que aplique al contexto o forme parte del conjunto de promociones que apliquen al contexto será aplicado y se emitirá el cupón con el monto correspondiente.


Las siguientes funciones son sólo para BENEFICIOS NO MONETARIOS:

En este tipo de función se procesa cada promoción en forma independiente y PROMO informa cual es la promoción y correspondiente beneficio que otorgue la mayor cantidad de puntos entre todas las promociones integrantes de la función.

En este tipo de función se procesa cada promoción en forma independiente y PROMO informa cual es la promoción y correspondiente beneficio que otorgue la menor cantidad de puntos entre todas las promociones integrantes de la función.


En aquellos casos en los cuales la promoción integrante de la función MAX o MIN POINTS, contenga más de un beneficio y alguno de ellos sea Monetario, la promoción se evaluara del mismo modo que el resto, pero en el caso de los beneficios Monetarios no contaran o sumaran puntos al beneficio total que será el que luego se evalúe entre todas las promociones integrantes de la función que puedan aplicar.


En aquellos casos en los cuales la única promoción que aplica dentro de la función MAX o MIN POINTS sea una promoción que otorga un único beneficio Monetario, entonces, no será tenida en cuenta como aplicada. Ya que dentro de esta función, la única promoción que se retorna debe tener al menos un beneficio NO Monetario de porcentaje o de puntos de fidelización


Las promocione que otorguen un beneficio de la clase Reintegro bancario, serán ubicadas en un único y último paso, dentro de una función Todas, y no convivirán con otras promociones.



Composición de funciones de convivencia

Los argumentos de las funciones además de ser compuestas por promociones también podrán componerse con otras funciones.

Al poder combinarse las funciones se podrá obtener una variedad más amplia de relaciones entre promociones a la hora de determinar su prioridad entre ellas.


Ejemplo:


En el paso 1, mediante la función MÍNIMO DESCUENTO se evaluaría cuál de las dos promociones otorga el menor beneficio.

En el paso 2 se expresa que se informará al POS dos opciones para que el cliente pueda elegir entre dos listas de beneficios que surgen de:


En el último paso se aconseja definir las promociones a nivel medio de pago, que actúan sobre el total de aplicación de promociones.

En el paso 3 la promoción PR07 podría ser un descuento de 10% a empleados, que se aplicará sobre el último contexto restablecido del paso anterior, es decir que si un perfume de $80 recibió un descuento de $40, para la base del descuento del 10% se tomará $40 (su precio extendido).

Una vez que se hayan definido los pasos y funciones de convivencias, el sistema mostrará en pantalla como han quedado definidos cada uno de ellos con sus promociones correspondientes.


No se podrá agregar dos veces la misma promoción con el mismo operador. Por ejemplo: si el usuario desea definir una función a través del ALL y selecciona dos veces la misma promoción, el sistema solo la agregará una vez.



Condiciones Generales


En la ventana de "Definir Mapa (POS)" se cuenta con la solapa llamada "Condiciones Generales" en la sección de Composición de mapas.  Al presionar esa solapa, se mostrarán todas las condiciones generales vigentes para la fecha definida en el mapa. Las mostrará de la más nueva a la más antigua. Desde allí podrán arrastrarse a la sección de "Condiciones Generales" de la derecha, las condiciones generales que desean incluirse en el  mapa que se está generando.

Luego de agregadas las Condiciones Generales deseadas, éstas serán incorporadas al mapa al momento en que éste sea distribuido o descargado.

Todas las Condiciones Generales agregadas al mapa serán evaluadas, independientemente del orden en que se ubiquen. 

El mapa que se descargue contendrá las Condiciones Generales.



Colisiones


Las colisiones se refieren al conflicto que puede ocasionarse en momentos de evaluación de promociones o agregado de promociones en un mapa, y que vinculan a aquellas promociones que utilizan el mismo código de artículo, dejando de lado aquéllas que apliquen sobre todo un grupo de artículos o departamento o la agrupación que fuere.

Se podrán chequear colisiones con Condiciones Generales incluidas, y se informará con cuáles colisiones y/o promociones hay colisión.

A continuación se detallan los momentos en los cuales se realiza la verificación de colisiones.

Se toma como ejemplo el código de artículo con valor 111.


Caso A: Creación de promoción


      1. Se da de alta una promoción PROMO_A que utiliza el artículo con código 111.
      2. Se da de alta una nueva promoción PROMO_B, cuya fecha de vigencia intercepta con la PROMO_A, y que también utiliza el artículo con código 111.


Caso B: Agregado de promoción a un mapa.


      1. Se agrega al mapa la promoción PROMO_A, que utiliza el artículo con código 111
      2. Se agrega al mapa la promoción PROMO_B, cuya fecha de vigencia intercepta con la PROMO_A, y que también utiliza el artículo con código 111.
      3. Aparecerá un aviso de advertencia de colisión de promoción como se muestra en la siguiente imagen.




Tipo, subtipo y forma de aplicación

El Tipo, subtipo y forma de aplicación de una promoción son propiedades del mapa.



Configuración  y funcionamiento de la Distribución de Mapas Manual y Programada


Desde la sección Administración\ Información de Configuración, podrán configurarse las opciones necesarias para la ejecución del proceso de generación y distribución de mapas programada.

Se puede distribuir tanto en forma manual como automática para tiendas con configuración por archivo (FILE / FTP / SFTP) (en versiones anteriores la distribución automática estaba permitida solo para tiendas con configuración AUTO) y filtrará en el mapa las promociones que apliquen a la tienda indicada si tiene habilitada la opción scheduled.filter.enable.


Las opciones a configurar son:


La configuración scheduled.MapVersion aplica tanto para Distribución Programada de Mapas como para Distribución Manual.

Promo incrementa el número del mapa si el status del mapa es distinto de "Distribuido" o si scheduled.MapVersion está en true.




Creación de plantilla de mapa

Una vez habilitadas la variables de configuración necesarias, para ejecutar el circuito de generación y distribución automática de mapas, habrá que crear una plantilla de mapa desde Administración → Plantilla de mapas  y crear la plantilla de mapa, la cual debe quedar completa y activa.


Nuevo mapa

Luego, desde Distribución → Mapas (POS) → Nuevo al dar de alta un nuevo mapa,  deberá seleccionarse la plantilla recientemente dada de alta, y al hacerlo se mostrara una nueva opción "Distribución programada" (checkbox), al final del formulario, el cual deberá habilitarse, para indicar de esta forma que dicho mapa será utilizado por el proceso de generación y  distribución programada de mapas.




Todos los mapas que no tengan habilitado el campo Distribución programada no serán tomados por el proceso de generación y  distribución programada de mapas. Los mismos podrán ser distribuidos desde consola de forma manual.


Al crear o editar un mapa si el usuario selecciona una Plantilla de mapa mostrará el siguiente warning “En el caso de mapas basados en plantillas con estado INCOMPLETO debido a promociones que quedaron fuera por estar vencidas y que se actualizaron para pasarlas a vigentes, se deberá entrar a la ventana de Editar y presionar el botón Guardar para actualizar el estado del mapa”.

En el caso de que el mapa con distribución programada quede en estado incompleto no será tomado por el proceso programado, en este caso el usuario deberá ir a Mapas -> Editar y al presionar el botón Guardar el mapa basado en una plantilla se regenerará incluyendo las nuevas promociones o promociones que están vigentes nuevamente y sacando las que ya no estén vigentes o estén canceladas.

Ejemplo 1:

Tengo un mapa con 2 pasos y en cada paso hay 1 promo. La Promo que está en el paso 2 se venció. El proceso de distribución programada de mapas sacará el Paso 2 y la promo que está en él, quedando en este mapa solo el Paso 1 con la Promo a. Y el mapa continúa en estado completo.

Paso1

    Promo a

Paso 2

    Promo b (venció)


Ejemplo 2:

Tengo un mapa con 2 pasos y en cada paso hay 1 promo. Las 2 promos vencieron o se cancelaron o están incompletas

  • En este caso el mapa pasa a incompleto para solucionarlo: el usuario debe editar la promo y ponerla vigente y después ir a Mapas -> Editar y presionar el botón Guardar. En ese caso va a quedar en el mapa el Paso 1 con la Promo a, el paso 2 y la Promo b se van a borrar del mapa.
  • Definir en el mapa y poner promociones diferentes en esos pasos

Paso 1 

     Promo a (cancelada o vencida o incompleta)

Paso 2

      Promo b (cancelada o vencida o incompleta)

Lo importante es que el mapa quede en estado completo.


Distribución del mapa 


Consideraciones importantes:


Proceso de distribución manual de mapas basados en plantillas

  1. En este proceso el usuario podrá editar el mapa generado a partir de una plantilla, removiendo o moviendo los pasos y promociones que considere necesario, para luego distribuirlo tal cual lo diseñó.
  2. Debe tener en cuenta que si el mapa tiene habilitado la "Distribución programada", se reconstruirá en base a la plantilla asociada, perdiendo los cambios aplicados manualmente sobre el mapa.
  3. Por lo que se sugiere editar un mapa basado en la plantilla sólo en caso de contingencias.

Proceso de distribución programada basados en plantillas

  1. Este proceso se correrá de forma automática una vez al día y tomará los mapas basados en plantillas que tenga habilitado el campo de "Distribución programada".
  2. El proceso programado reconstruirá automáticamente cada mapa basándose en la plantilla asociada, sacando o insertando promociones que apliquen al mismo, bien sea por vigencia y por la tipificación usada en cada paso de la plantilla.
  3. Como contingencia, este proceso se puede correr en cualquier momento del día desde Administración  Tareas programadas → "Generación y distribución programada de mapas".

Una vez generado el mapa por medio de la plantilla seleccionada, deberá ir a la vista de distribución (presionar el botón Distribuir).



Allí se seleccionaran las tiendas (botón Seleccionar Tiendas)  que estarán asociadas al mapa y sobre las cuales se realizará la distribución programada, y presionar "Guardar"


Tanto en la solapa "Laboratorio" como en la solapa "Producción", el usuario logueado sólo verá las tiendas que tiene vinculadas.

Sólo estarán disponibles para su distribución la/s tienda/s que el usuario tengan vinculadas. De la misma manera, el usuario sólo verá los mapas que hayan sido distribuidos en la/s tienda/s que tenga vinculadas.

Una vez finalizado el proceso de asociación de las tiendas, el mapa quedara listo para ser tomado por el proceso de distribución programada, el cual realizará un filtro de las promociones que aplican a cada una de las tiendas siempre y cuando se encuentre habilitada la variable de configuración ->scheduled.filter.enable.


El usuario logueado podrá editar (editar y definir) el mapa que llegó a su tienda, podrá ver todas las promociones del mapa, estén vinculados a sus tiendas o no (esto ultimo dependiendo del campo scheduled.filter.enable, si este campo está en true no va a recibir las promociones de otras tiendas). El mapa lo va a ver completo, pero sólo podrá agregar o quitar promociones que tengan asociadas tiendas que el tiene vinculadas. No podrá sacar promociones que tengan asociadas tiendas que el no tenga vinculadas.


En la sección "Cabecera" de la pantalla Distribución, se mostrará la leyenda "Tiendas a distribuir" donde se podrá visualizar el listado de las tiendas asociadas al mapa.

Cada vez que se ejecute el proceso automático de distribución programada, se generará un registro en el Historial del mapa, el cual mostrará como máximo 25 registros de distribución.



En el caso de que el tamaño del mapa exceda el máximo permitido (16 megabytes), el mapa para la tienda no podrá ser guardado, por lo que se almacenará en el registro de distribución el detalle de error en aquellas tiendas donde no se pudo guardar el xml generado durante el proceso de distribución.


Ejecución de la tarea programada

Para ejecutar manualmente el proceso de distribución programado, deberá ingresar con el usuario Admin y en Administración → Tareas programadas y ejecutar la tarea "Generación y distribución programada de mapas".


Cuando una promo se vence o se cancela o pasa a estado incompleta, el proceso de distribución de mapas programado quitará esas promociones del mapa. Así como también incluirá las nuevas promociones. Para esto (agregar o quitar promociones) analizará el tipo, subtipo y forma de aplicación de las promociones, que deberán coincidir con el definido en la plantilla de mapa utilizado.


Si en el proceso de distribución, alguna tienda no está disponible o se pierde la conexión, el archivo .xml quedará posteado y pendiente para que al restablecerse la conexión se reintente automáticamente el envío.


En caso de desear que un mapa deje de formar parte del proceso de distribución programada, habrá que acceder a Distribución \ Mapas, y editar el mapa que se desea quitar.

Se abrirá la pantalla de Publicación del mapa y podrá destildarse el check: "Distribución Programada". En este caso el resto de los campos no estarán habilitados.


Todos los mapas que se hayan generado a partir de una plantilla de mapa, que tengan o no la distribución programada activa, podrán editarse y habilitar o deshabilitar el proceso programado.



Distribuir un Mapa


Una vez que se haya dado de alta el mapa en la consola de administración de promociones con sus respectivas promociones y funciones de convivencia, el próximo paso para que el mapa tenga vigencia será generar un archivo de definición o Mapa, lo cual podrá realizarse presionando el botón "Distribuir" que se encuentra dentro de la misma pantalla en que se crea el mapa arriba a la derecha.

El archivo de definición es un archivo con formato XML que será utilizado por el motor de PROMO para poder evaluar las promociones. El mismo contiene todos los datos de los componentes que integran el mapa.

El archivo de definición podrá ser generado y luego distribuido. Para realizar la generación debe seleccionarse el mapa deseado y el archivo de definición estará listo para ser distribuido en el momento que se desee.

Al momento de realizar la distribución a las tiendas del archivo de definición ya generado, el usuario podrá optar entre AUTO, FTP, FTP Seguro y File.



Las promociones solo se encontrarán en vigencia al integrar un mapa. A partir del mapa se generará el archivo de definición con el cual trabajará el motor de PROMO.

El proceso que permite realizarlo es: Distribuir, donde además de generar éste archivo, podrá distribuirlo a las tiendas en donde opera el motor de promociones.

Se deberá seleccionar la o las tiendas en las cuales se desea distribuir un mapa.

Al presionar "Seleccionar tiendas" aparecerá el siguiente pop-up donde se podrá seleccionar entre las tiendas de Laboratorio o Producción, según se requiera. Realizada la selección el sistema nos presentará las tiendas correspondiente y la Zona a la cual corresponde.

El sistema permite al usuario seleccionar por cada zona, una o todas las tiendas que tiene asignadas sin que se pierda la selección realizada para otras zonas. El combo Zonas recupera la información que se haya cargado por medio del catálogo, y por cada Zona se muestran todas las tiendas contenidas en la zona seleccionada.


Se deberá seleccionar las tiendas correspondientes y presionar el botón "Guardar", indicando que el mapa ya esta listo y disponible para ser publicado.

Luego, deberá presionarse "Publicar" en la pantalla de Distribución, para ejecutar el proceso manual de distribución del mapa.


Al presionar "publicar" se mostrara un pop-up confirmando la acción. 


Una vez que se presiona "Aceptar" quedará distribuido el mapa en el o los destinos seleccionados.

A continuación se visualizará un breve resumen de la distribución de ese mapa indicando la versión, la cantidad de veces distribuido, las tiendas en las que fue distribuido y si el proceso concluyo con éxito.

El archivo de definición contará con un número de versión que será único y asignado por el sistema al momento de realizarse la generación del mismo.

El nombre del archivo será el número de versión y su extensión .xml (Ej.: 1.xml)


Una vez distribuido un mapa a una tienda de Producción, este no podrá modificarse ni eliminarse.

Al presionar el botón "Acciones" en la vista Publicaciones Mapa y selecciona la opción "Editar" del menú, la aplicación mostrará al worflow con todos sus campos deshabilitados para su modificación



Las promociones que forman parte de un mapa no serán removidas por el proceso de Depuración de Promociones. Sin importar el estado de una promoción, mientras esté en un mapa no se depura.

Los mapas podrán ser redistribuidos normalmente.


Acciones

Una vez creado el mapa éste se reflejará en la vista Publicaciones Mapa

Esta vista presenta las siguientes columnas:

El último campo a la derecha es el botón Acciones que tiene el siguiente menú:

Al descargar un mapa, que contenga una promoción 0 de Programa de Objetivos, se detallará el nuevo beneficio de Programa de Objetivos como “GoalCounterBenefit” (es el beneficio contador de objetivo). El parámetro “goalsProgram” indicará el código del Programa de Objetivos.



Distribución individual de Promociones

Promo permite la distribución de promociones de forma individual en motores a los que ya se les haya distribuido dicha promoción. 

Las promociones deberán estar en estado "Distribuido" y para poder editarlas debe estar habilitada la configuración "deployedEditable.enabled" que habilita la edición de promoción con el estado Deployed.

Cumpliendo con estas precondiciones, cuando se edite una promoción, ya sea en su cabecera, condiciones y/o beneficios, se mostrará en el menú de "Acciones", a la derecha de la promoción, en la pantalla de gestión de promociones, la opción "Distribuir".

Este botón solo aparecerá cuando el parámetro de configuración indicado en el punto anterior esté en "true" y no se mostrará mientras la promoción no haya sufrido cambios, solo se habilitará cuando al menos se haya modificado alguno de sus componentes (cabecera, condición y/o beneficio).



Al presionar el botón "Distribuir" se mostrará un popUp donde se pedirá la confirmación de distribución de la promoción.


Al aceptar el popUp, la promoción quedará posteada para que sea distribuida a los mapas en tiendas que contengan la promoción editada.

Una vez distribuida la promoción de forma individual el botón "Distribuir" no se mostrará más hasta tanto se realice una nueva modificación en la promoción.


El proceso solo contempla la edición de promociones existentes en mapas activos distribuidos (en tiendas de producción). No se podrán eliminar y agregar promociones en mapas activos por medio de este proceso.


El envío de una promoción editada a los mapas que la contengan no modificará el número de versionado del mapa.


Cuando una promoción en estado "Distribuida" sea editada, y pase a estado "Incompleta" (eliminación de condiciones y/o beneficios), al volver a completarse, mantendrá su estado "Completa" pero como ha sido distribuida anteriormente, en el menú de acciones se mostrará la opción de "Distribución" para esa promoción. Al distribuirla, pasará nuevamente a estado "Distribuida".


Respecto al resultado de la distribución individual, se puede visualizar que en el menú Distribución\ Mapas, aparecerá indicada con el texto "Promoción individual" en el campo Plantilla del listado,  sin versión de mapa ya que es una promoción, y el nombre "Promoción: nombre de la promoción", como se muestra en la siguiente imagen:

Al seleccionar el botón Acciones mostrará las siguientes opciones:

image-2021-04-23-17-32-18-740.png

Si selecciona la opción "Editar promoción" lo llevará a la pantalla de definición de la promoción.

Si selecciona "Historial" mostrará el historial de mapas pero de la promoción. La pantalla se verá como la siguiente:

image-2021-04-23-17-34-00-512.png



Proceso de actualización de archivos de definición

El motor de promociones actualiza sus archivos de definición (mapas) mediante un proceso automático que trabaja a través de un índice, el cual contiene un listado con todas las versiones de mapa que se encuentran en sus directorios junto con su vigencia y con los cuales trabajará tanto para las transacciones de venta como para las transacciones de devolución.



Copiado de Mapas

Existen ocasiones en las que se desea que ciertas promociones utilizadas anteriormente formen parte de un nuevo mapa integrándose con otras nuevas promociones. 

PROMO otorga una funcionalidad que permite copiar un mapa ya distribuido y que nuevas promociones sean incluidas sin necesidad de realizar su inclusión manualmente a cada nuevo mapa, esto lo realizará siempre y cuando las promociones estén vigentes, caso contrario se copiará la estructura eliminándose las promociones vencidas. Ésta acción se encuentra dentro del combo "Acciones" del menú Distribución > Mapas.


Simulación

Dentro de "Distribución" se encuentra la opción "Simulación" en donde se podrá simular el comportamiento tanto mapas como promociones.

Creación del ticket 


Presionando el botón "Nuevo" se genera un modelo de ticket de compra que deberá contener las siguientes opciones:


Una vez cargados los datos de cabecera presionar el botón "Guardar".

El sistema mostrará la siguiente pantalla, en la cual se deberán ingresar los datos propios del ticket modelo que se desea simular.  


Para la simulación de un Ticket podrán ingresarse los siguientes elementos:


Puede también disponerse de la asistencia de catálogos para el ingreso del o los código, familia, marca, departamento y/o proveedor del artículo. Al finalizar, presionar "Aceptar" para que los datos sean cargados.




Se agregó un nuevo campo denominado "Promoción Hiper" en la sección de Cliente del Simulador. Este campo permite seleccionar promociones hiperpersonalizadas asociadas al cliente, facilitando la simulación y validación de dichas promociones en escenarios específicos. Asegúrate de completar este campo correctamente para garantizar la precisión de los resultados en el simulador.









Los atributos de cada elemento que se agrega a la simulación del ticket pueden variar dependiendo de los requerimientos de negocio de cada cliente.


Podrán ingresarse más de uno de los elementos mencionados en el ticket modelo para luego simular promociones y/o mapas.

Una vez completados los datos del ticket modelo que se desea simular, presionar "Simulación".


Simulación de Mapas:


Simulación de Promociones:

En esta pantalla, si se selecciona "Promociones" se mostrarán las promociones listas para ser usadas, o sea en estado Completo y que el rango de fechas de las promociones coincida con el que tiene definido el ticket de simulación.


Si los elementos ingresados al ticket de simulación cumplen con las condiciones definidas en la promoción o mapa que se está simulando presentarán los resultados de la simulación en la siguiente pantalla.


El resultado de la simulación, en este caso fue que se aplica la promoción "-10% de desc. en toda la compra", sobre el código (SKU) 111.

También se informa el detalle del beneficio otorgado, en este caso un Descuento porcentaje del 10% que equivale a -$1500 sobre ítem de la transacción.

El Total que se informa en esta ventana corresponde al total de la transacción con el descuento aplicado.

Cuando se aplique el monto de descuento mínimo se informará en el pupUp de simulación de la siguiente forma:


Los Beneficios Externos se mostrarán en la sección "Componentes de ticket" como se ve en la siguiente pantalla.

Al simular el ticket los beneficios externos se mostrarán de la siguiente forma:


El popup de sugerencia en la simulación de la promoción se mostrará de la siguiente forma:

       



Simular ticket preexistente


Al presentarse la pantalla de simulación se podrá acceder a las siguientes acciones:


Dentro de la cabecera se podrá visualizar el estado del ticket para poder realizar la simulación, el mismo deberá tener mínimo un elemento para poder simular la operatoria.




En caso de producirse un error en la simulación, la aplicación enviará el pop up


Redes Sociales

PROMO permite la publicación de promociones en distintas redes sociales a fin de agilizar las estrategias de marketing y mejorar la comunicación de promociones y beneficios a los potenciales .

Para publicar promociones en las redes sociales es requisito que la promoción haya sido dada de alta para tal fin, así como también que estén configurados los permisos de acceso a las distintas páginas (ver Manual de instalación Promo 7 - Configuración de Redes Sociales).

La publicación en redes sociales tiene como finalidad solamente la comunicación de ofertas, oportunidades y/o beneficios a potenciales por medio de los canales digitales configurados, no pudiendo aplicarse los beneficios por este medio.


Deberá de adquirirse el módulo de Redes Sociales para poder publicar promociones en estos medios.

Definición de promoción para Redes Sociales


Al editar la cabecera de una nueva promoción, se proponen los siguientes canales de publicación: "Punto de Venta", "Facebook" y "Twitter"

Una promoción puede estar configurada para uno o varios canales de publicación simultáneamente y en caso de seleccionarse algunas de las redes sociales habilitadas, se solicitara la carga de una imagen en la promoción (en formato .PNG únicamente) .

la imagen asociada es:


Una vez dada de alta la promoción con alguno de los canales de publicación de redes sociales seleccionados, en la vista de gestión de promociones se visualizaran las promociones, con el logo que corresponda según canal seleccionado.


Publicación en Redes Sociales


Luego de definidas las promociones que serán publicadas en redes sociales y configurados los accesos a las redes sociales.

En el módulo de Distribución >> Redes Sociales, se mostraran la pantalla "Publicación en Redes Sociales" donde se listaran las promociones con los canales de publicación habilitados para tal fin.


Los indicadores que aparecen a la derecha de cada promoción son los que deberán presionarse según la acción de que se desee realizar.
Si se desea publicar, por ejemplo, en Facebook se deberá presionar el logo de Facebook (al presentarse el logo en rojo, se solicitara autenticación del usuario para acceder a la red social desde la aplicación PROMO), y se presentaran la o las paginas habilitadas para la publicación. Se deberá que tildar la pagina en la que se desea publicar y dar clic en

Hecho esto podrá visualizarse en la pagina seleccionada la promoción recientemente publicada, presionando en el botón



y desde allí, se presiona en la página donde se hizo la publicación. 



De cada promoción que haya sido publicada en las redes sociales podrá verse un resumen de las mismas presionando el último icono de estadísticas que se muestra al final de cada promoción.







Capítulo 8 - Módulo de Fidelidad


Menú de Fidelidad

El módulo de Fidelidad de PROMO gestionará los distintos cupones y elementos de fidelidad que formaran parte de la estrategia de fidelización de .

Desde esta opción de menú se podrán crear y administrar las plantillas y tipos de Cupones así como también gestionar los cupones ya existentes.




Plantilla de Cupón


Con las plantillas de cupones se podrán definir los formatos y diseño de los cupones que serán administrados en PROMO, los cuales luego serán utilizados para la definición de Tipos de cupones.

Cuando se dé clic en el botón "Plantillas de Cupón" del menú "Fidelidad" se mostrara el panel de "Administración de Plantillas" donde se podrán visualizar las plantillas ya generadas con su correspondiente código, nombre y formato. Se cuenta con un botón "Editar" desde el cual se podrá acceder a la sección de "Editar Plantilla". 

También se dispone un filtro de permitirá realizar una búsqueda más detallada entre las plantillas de cupones existentes ya sea por su código, nombre, formato, y/o estado (activa, inactiva o todos).


Nueva Plantillas de Cupón 

Al pie de la pantalla de administración de Plantillas se el botón "Nuevo" desde el cual se podrán dar de alta nuevas plantillas de cupones.

Serán requeridos los siguientes campos para el alta de la Plantilla de Cupón:

Las variables de Sistema disponibles en cupones son:


Las variables de Sistema provenientes de los datos disponibles en la transacción son:


  Si el tipo de cupón es electrónico; el Barcode es el código de barra, tal como se lo conoce; y el cuponid es el código de barras en forma de texto.


Tipos de Cupón


Los Tipos de Cupón permitirán definir los parámetros que manejara un cupón al momento de ser emitido así como también los parámetros que se evaluarán cuando se quiera redimir. Estos tipos de cupones serán los consultados cuando desde el punto de venta o desde la propia consola se quiera generar un cupón con su correspondiente numeración y formato.

Aquí podrán generar y administrar Tipos de Cupones a partir de los cuales se crearán los cupones que serán evaluados o dados como beneficio.

Al dar clic en el botón "Tipos de Cupones" del menú "Fidelidad" se mostrará el panel de "Administración de Tipos de Cupón" donde se podrán visualizar todos los tipos de cupones ya generadas con su correspondiente código, nombre, prefijo, plantilla de cupón, codificación, campañas de fidelidad y destino exportación.

Se cuenta con un botón "Acciones" desde el cual se podrá editar, definir pre visualizar, exportar o ver las promociones asociadas que emiten y/o redimen este tipo de cupón.

También se dispone un filtro de permitirá realizar una búsqueda más detallada entre los tipos de cupones dados de alta ya sea por su código, nombre, prefijo, plantilla de cupón, codificación, y/o estado (activa, inactiva o todos).

Nuevo Tipo de Cupón: 

Al pie de la pantalla de "Administración de tipos de cupón" se encuentra el botón "Nuevo" desde el cual se podrán dar de alta nuevos tipos de cupones.



Los datos que se solicitan para el alta de un nuevo tipo de cupón son:

Mas información sobre codificaciones en: _Formato_de_Código

Como se muestra en el siguiente ejemplo puede ingresar el siguiente horario: 23:53 h.


  • En el siguiente ejemplo el cupón será válido desde las 00:00 horas del 16 Diciembre del 2022 hasta las 10:00h del mismo día.


  • En el siguiente ejemplo el cupón será válido desde la hora en que se lo emitió (por ejemplo si se emite a las 13:00hs), hasta las 18:30hs (porque a la hora de emisión se le suman las horas y minutos de vigencia definidas en el tipo de cupón, que en este ejemplo es 5:30 h.) A las 18:30hs se cortará la vigencia de ese cupón.


  • En el siguiente ejemplo el cupón estará vigente desde las 00:00 horas desde que se creó, hasta las 05:30hs de la mañana.



Si en el campo "Tipo de inicio de vigencia" se selecciona la opción "Fecha" o "Días desde la creación" se toma desde las 00:00 horas el inicio de vigencia.


                   

                   

                    

Editar Tipo de Cupón: 

                   Para modificar un cupón se debe presionar desde el botón acciones en la vista Administración de Cupones el ítem "Editar":

                   


                     la aplicación lo redirigirá a la vista:

                   

                   

Donde podrá modificar cualquier campo; excepto el código.

Tanto en los tipos de cupones electrónicos como impresos, no se podrá modificar el "Prefijo Autogenerado"

      

                   

                    Para guardar los cambios, se debe presionar el botón  y éstos se reflejarán en la vista:

Caso contrario, deberá presionar el botón   


También se puede editar un tipo de cupón, desde el botón acciones, en la vista "Administración de Tipos de cupones"

presionando el botón "Definir" la aplicación lo llevará a la pantalla:

Desde donde podrá editar la plantilla de cupón, el cupón y/o agregar variables de usuario a la plantilla.


Podrá configurarse desde la consola de Promo la edición o no de los tipos de cupones que se encuentren en estado "Distribuidos".

Un Tipo de cupón pasa a estado distribuido cuando al menos un cupón activo se ha generado a partir de éste.

Por default, los tipos de cupones distribuidos no podrán ser editados, Se disponibiliza la opción de configuración que habilita la edición de tipos de cupones distribuidos.

Esta opción de configuración es "isEditableCouponTypeDistributed"

Valor por defecto en Administración / Información de Configuración:

Cuando el parámetro "isEditableCouponTypeDistributed" se configure en "true", se habilitara la opción de "Editar" en el menú de acciones disponible a la derecha de cada tipo de cupón en estado "Distribuido" y podrán editarse solo los siguiente campos:

  • Descripción
  • Codificación: Podrá seleccionarse entre las opciones del combo.
  • Fecha de fin del cupón. Solo para los casos en que el tipo de cupón tenga definido en "Tipo de fin de vigencia", "Fecha". No podrá indicarse una fecha anterior a la fecha de inicio de vigencia.
  • Plantilla de Cupón
  • Check Activo

Al editarse un tipo de cupón, los cambios realizados en el empezaran a regir sobre los cupones que se generen a posterior de la edición del tipo de cupón.

Los cupones generados previamente no se verán afectados por los cambios hechos en el tipo de cupón.


Para aquellos usuarios que utilizan colas RabbitMQ, la creación o modificación de tipos de cupones se postea automáticamente.



Los tipos de cupones Impreso pasan de estado Habilitado a Distribuido luego de haber realizado una venta que haya otorgado una promoción que emita ese tipo de cupón y luego de que haya corrido automáticamente el proceso correspondiente.


Al imprimir tipos de cupones de formato: Electrónico, Impreso e informativo, al asignarse a un cliente, se  imprime en el cupón, sólo la cantidad de dígitos que se hayan configurado desde la consola. Cuando el usuario seleccione el @customerid y @customerin al imprimir este dato en la tirilla solo  se reflejarán los 4 últimos dígitos del identificador o del código  y los anteriores reflejados con ****. Ej. Cedula: 98708090
Visualización esperada en la tirilla: ****8090).



Por defecto el valor del campo estará vacío, esto implica que no se deberá enmascarar ningún digito del id del cliente. Al ingresarse un dato ya se habilitara la funcionalidad de enmascarado de id de cliente con la cantidad de dígitos allí informada.

Si coloca el valor 0 en la configuración, la aplicación enmascarará todo el código del cliente.

Si coloca letras en el campo valor, la aplicación no hará nada y el código del cliente se mostrará completo.


Resumen Tipo de Cupón:

Desde el botón acciones, en la vista "Administración de Tipos de cupones", se puede acceder a un resumen del tipo de cupón :


Copiar Tipo de Cupón: 

Se puede copiar un Tipo de Cupón, seleccionando el ítem "Copiar" del botón acciones en la vista "Administración de Tipo de Cupones". Al presionarlo, la aplicación mostrará la vista:

Donde todos los campos son editables; excepto el prefijo autogenerado. Una vez copiado; el nuevo cupón se reflejará en la vista Administración de Tipos de Cupones:


Previsualizar Tipo de Cupón: 

Para tener una vista previa del tipo de cupón, cuando se está creando, editando o se copia un cupón; se debe presionar en el botón "Acciones" el ítem "Previsualizar"

La aplicación abrirá la vista:


Promociones Asociadas: 

La funcionalidad Promociones asociadas a Cupones permite consultar todas las promociones vinculadas a un determinado tipo de cupón, brindando visibilidad sobre las reglas promocionales que se activarán cuando se utilice ese cupón en una transacción. Esta consulta resulta clave tanto para validar la correcta configuración de promociones como para asegurar su vigencia y estado operativo al momento de la ejecución comercial.

Para facilitar la identificación de promociones relevantes, la pantalla ofrece dos filtros opcionales: “Vigentes” y “Activas”. Estos filtros permiten limitar los resultados mostrados según la fecha de vigencia de las promociones y su estado operativo actual.

El check “Vigentes” permite restringir la búsqueda solo a aquellas promociones que se encuentren activas en la fecha actual o que no tengan una fecha de fin definida. Esto es especialmente útil para excluir promociones caducadas que ya no tienen efecto operativo.

El check “Activas”, por su parte, permite filtrar las promociones que no se encuentren canceladas. Al activar este filtro, el sistema excluirá aquellas promociones que han sido canceladas de forma manual o automática. Si se deja el filtro sin marcar, se mostrarán únicamente las promociones en estado cancelado.

Ambos filtros pueden utilizarse de forma conjunta o individual, y su combinación determina el conjunto exacto de promociones que serán visualizadas. Este comportamiento permite una consulta flexible, adaptada a distintas necesidades de revisión y control operativo.


Desde el menú "Acciones", en la vista "Administración de Tipos de Cupones", si se presiona el ítem "Promociones Asociadas":


 La aplicación muestra la vista:


Donde se detallarán todas las promociones asociadas a ese tipo de cupón, independientemente de si el cupón forma parte de las condiciones simples o por composición y cualquiera sea el tipo de operador (igual o distinto) y también si la promoción otorga un beneficio no monetario: cupón o cupón calculado.

Esta vista permite buscar por una promoción en particular y por estados (Vigentes y Activas).


Dentro del módulo Fidelidad, accediendo a la opción Tipos de Cupones, es posible consultar qué promociones están asociadas a cada tipo de cupón. Esta consulta se realiza desde el botón Acciones → Promociones asociadas.

En la pantalla de consulta, el sistema permite aplicar dos filtros adicionales mediante los checkboxes:

✅ Filtros disponibles

FiltroDescripción
VigentesMuestra solo las promociones cuya vigencia incluye la fecha actual, o aquellas que no tienen una fecha de fin definida. Si este filtro no está marcado, se incluyen también promociones vencidas.
ActivasMuestra únicamente las promociones que no se encuentren canceladas. Si este filtro no está marcado, solo se mostrarán las promociones canceladas.


🔄 Comportamiento combinado de los filtros

Ambos filtros pueden aplicarse de forma independiente o simultánea. A continuación se detallan los posibles comportamientos según la combinación seleccionada:

Check "Vigentes"Check "Activas"Resultado esperado
❌ No marcado❌ No marcadoSolo se muestran promociones canceladas, sin importar su vigencia.
✅ Marcado❌ No marcadoSe muestran promociones vigentes al día de la consulta, incluso si están canceladas.
✅ Marcado✅ MarcadoSe muestran únicamente promociones activas y vigentes al día de la consulta.
❌ No marcado✅ MarcadoSe muestran promociones activas, sin importar su vigencia.





Puede exportar cupones a Sistemas Externos a través de Colas RabbitMQ o Microsoft Dynamics (CRM), para eso debe realizar las configuraciones indicadas a continuación.

  • Configuración para exportar a Colas RabbitMQ: Para poder utilizar las Colas RabbitMQ para exportar cupones, debe configurar el nombre de la cola RabbitMQ en Administración\ Información de Configuración, en el módulo Cupones, categoría promo.promotion, en la clave "rabbitMQ.couponHistory.endpointName", en el campo valor ingresar el nombre de la cola RabbitMQ a utilizar.


  • Configuración para exportar a Microsoft Dynamics (CRM): 


Al seleccionar Fidelidad\ Tipos de cupones, botón "Acciones", el menú desplegado mostrará la opción "Exportación".

Al seleccionar la opción "Exportación" mostrará la siguiente pantalla:


En la sección cabecera de la pantalla "Exportación" mostrará el "Código", "Nombre" y "Formato" del tipo de cupón sobre el cual se generó la exportación. A la derecha mostrará el botón "Volver" que al seleccionarlo volverá a la pantalla "Administración de tipos de cupones". Debajo mostrará los campos seleccionables "Destinos" y "Acción" y a la derecha de estos un botón para guardar la selección realizada. Al desplegar el campo "Destinos" mostrará "Rabbit" o "CRM". Al seleccionar el campo "Acción" mostrará las acciones que serán las disparadoras de esta exportación a la cola RabbitMQ o a CRM. Las acciones que mostrará son las siguientes:

    • Emitido (al emitir cupones que tengan este tipo de cupón, dichos cupones serán enviados a la cola RabbitMQ o a CRM)
    • Redimido (al redimir cupones que tengan este tipo de cupón, esos cupones serán enviados a la cola RabbitMQ o a CRM)
    • Emitido/Redimido (al emitir/redimir cupones que tengan este tipo de cupón, los mismos será enviados a la cola RabbitMQ o a CRM)
    • Anulado (al anular cupones que tengan este tipo de cupón definido, se enviarán esos cupones a la cola RabbitMQ o a CRM)
    • Vencido (cuando venzan los cupones que tengan este tipo de cupón, los mismos serán enviados a la cola RabbitMQ o a CRM)
    • Activo (al momento de activar los cupones que tengan este tipo de cupón, esos cupones se enviarán a la cola RabbitMQ o a CRM).

Con lo cual al definir una exportación para un tipo de cupón determinado, por ejemplo para el tipo de cupón 001, se definió que se exportarán a las colas RabbitMQ los cupones que tengan este tipo, cuando (estas son las acciones) se emitan estos cupones, y cuando venzan, y cuando estos cupones sean emitido/redimido.

Una vez seleccionados el Destino y la Acción, debe presionar el botón que tiene un diskette  para guardar esa exportación. Luego cuando se haga esa acción con ese tipo de cupón que tiene definida una exportación, ese cupón será enviado a la cola RabbitMQ o al CRM definido en la configuración.


  • Las exportaciones definidas no pueden modificarse. Pero sí pueden eliminarse y volver a crear.
  • Los campos Destino y Acción no son requeridos.
  • No puede cargarse dos veces la misma acción para el mismo destino. Si intenta hacerlo el sistema mostrará el siguiente mensaje:


Al seleccionar el botón "Eliminar" el sistema pedirá confirmación mostrando la siguiente pantalla: 


En la pantalla "Administración de Tipos de Cupones" se verá la columna "Destino Exportación" donde se mostrará para cada tipo de cupón el Destino y la o las Acciones guardadas. Si no se guardó ninguna exportación para ese tipo de cupón se mostrará vacío el contenido para ese registro en dicha columna.

Se disponibilizará una la  funcionalidad, "Modificar Vigencia de cupones emitidos"

Al presionar este botón se presenta un cuadro emergente con:

Al presionar el botón la aplicación enviará el siguiente mensaje; en caso que sea exitosa la modificación:

Si se modifica la vigencia de cupones emitidos y no existen cupones de ese tipo y la modificación es exitosa mostrará el mensaje "Se modificaron 0 cupones".


Tanto en Condiciones Simples como en Condiciones por Composición, para el elemento "Cupones" opción "Tipo", sea que se seleccione "Igual" o "Distinto" como se muestra a continuación: 

Por ejemplo si selecciono el Tipo de Cupón "electrónico_1" como se muestra a continuación:

Y luego al ingresar en Fidelidad\ Tipos de Cupones, botón "Acciones" sobre el Tipo de Cupón utilizado en la pantalla anterior, se selecciona la opción "Promociones asociadas", como se muestra a continuación:

 En la siguiente pantalla se verán las promociones asociadas a ese tipo de cupón:

En la columna "Acción" se mostrará "REDIME" cuando el Tipo de Cupón es parte de la condición de la promoción desde Condición Simple o por Composición. Y muestra "EMITE" cuando el Tipo de Cupón es emitido como beneficio de la promoción.



Cupones


Desde la consola de PROMO se podrán definir, diseñar e importar cupones propios o externos que luego podrán ser emitidos y/o redimidos desde los puntos de venta.

La gestión de los cupones será responsabilidad de la consola de promociones, mientas que el motor de PROMO evaluará la aplicación de promociones que emitan y/o rediman cupones para luego informar de esto a la consola de promociones.

En esta sección se visualizarán los cupones dados de alta en la base de datos de PROMO.

Se visualizará el estado de cada uno de los cupones así como también se podrán visualizar los eventos asociados a cada cupón.

Al presionar en "Cupones" del menú "Fidelidad" se mostrará la pantalla "Gestión de Cupones" donde podrán visualizarse los cupones con su estado, identificador del cupón, tipo de cupón, identificador del cliente, cantidad de usos, fecha de emisión, fecha de redención y vencimiento.

En esta pantalla se dispone de filtros que permitirán realizar una búsqueda más detallada de los cupones ya sea por su identificador del cliente, identificador del cupón, tipo de cupón, estado, tienda o fecha de emisión desde y hasta.

Por default algunos filtros vendrán precargados a fin de limitar la búsqueda de cupones y no saturar la base de datos recuperando listas extensas de cupones. Al ingresar en esta pantalla por primera vez traerá algunos filtros pre cargados y si hay información que coincida con esos filtros la mostrará al ingresar. Una vez que ya se realizó una búsqueda en esta pantalla, al volver a ingresar traerá la última búsqueda realizada.

Los filtros que aparecerán ya pre-cargados serán:

Los siguientes filtros podrán ingresarse según necesidad de búsqueda:


En el filtro de tiendas, sólo estarán disponibles aquellas que el usuario tenga asociadas

Debajo de los filtros de búsqueda se mostrarán dos campos para navegar los registros, los cuales están descriptos en Paginado. Al ingresar mostrará una pantalla como la siguiente:

Si se utilizan los filtros "Identificador del cliente" y/o "Identificador del cupón" no se tendrá en cuenta los otros filtros para esa búsqueda. Por ejemplo: en la siguiente búsqueda se filtró por "Identificador del cupón" y a pesar de que el "Tipo de Cupón" y las Fechas "Desde" y "Hasta" no coinciden con el cupón buscado igual se muestra correctamente en el resultado de la búsqueda:

Búsqueda por cliente:

En esta vista se mostrarán todos los cupones que posee un cliente; aunque las tiendas que los emitieron no estén asociadas al usuario.

EJ.:

El usuario admin no tiene asociada la Tienda 2, que emitió el cupón 1050010012943; sin embargo en la vista "Gestión de Cupones" , al filtrar por cupones del cliente 7; él mismo se verá reflejado:



De editarse los filtros estos se persistirán tanto en la pantalla de gestión de cupones como en informes de cupones. Si se desea resetear los filtros deberá presionarse el botón "X" a fin de eliminar los filtros seteados y volver al default.

A  la derecha de cada cupón generado se muestra un botón "Acciones", al presionarlo se mostrará dos opciones: 

"Ver", la aplicación irá a la vista "Eventos del cupón", donde se listará la información y eventos asociados al cupón ordenados desde el más reciente hacia el más antiguo. 


Al redimir un cupón, el mismo queda consumido. El cupón consumido no se puede reactivar.

El monto beneficiado de un cupón no se puede consumir en diferentes transacciones. Si hay un remanente en un cupón, éste se pierde.

   y "Modificar Vigencia", que permitirá modificar la vigencia del cupón.

Al presionar este botón se presenta un cuadro emergente con:


Esta opción sólo estará disponible cuando no sean cupones redimidos, cancelados o de tipo sin vencimiento.

La fecha ingresada no puede ser menor a la de inicio de vigencia.

Al presionar el botón se modificará el fin de vigencia del cupón y esto se reflejará en la vista Eventos del cupón, que tendrá una columna adicional de Detalles Adicionales:


En caso de error la aplicación enviará el siguiente mensaje de error:


Alta Masiva de cupones 

Al pie de la pantalla "Gestión de Cupones" se mostrará el botón de "Alta Masiva"

Al dar clic en este botón se presentara a pantalla "Alta Masiva de Cupones".

Solo se podrá hacer una carga masiva para tipos de cupón pre-impreso y no-nominado.


Para realizar un alta masiva de cupones se deberá seleccionar en el menú "Tipo de cupón" los tipos de cupones pre-impresos y no-nominados que se hayan creado en "Tipo de Cupón" previamente y se deberá especificar la "Cantidad" de cupones a generar.

El máximo de cupones a generar por este medio será configurable desde Administración >> "Información de Configuración" en el parámetro "coupon.bulk".


En la pantalla "Alta Masiva de Cupones" se listara el historial de transacciones que generaron cupones desde la más reciente a la más antigua con las siguientes columnas:


Se cuenta con la opción "Ver Informe" al final de cada transacción que genero cupones de manera masiva. Al presionar en este botón se direccionara a la sección de "Informes" >> "Cupones" donde se mostrara la lista de cupones generados en ese proceso.

Los filtros que se ofrecen, de ingresar por esta sección, para visualizar los cupones Pre impresos serán: "Identificador" y "estado" y este último ya se mostrara precargado con el estado "Emitido" (al crear el cupón el estado es Inactivo, existe un proceso interno que lo pasa automáticamente de Inactivo a Emitido, hay que darle tiempo a que se ejecute ese proceso para que cambie de estado).

El cupón debe estar Activo o sea en estado Emitido para que la promoción lo pueda utilizar.


Crear la Promoción que emita el cupón

        

    Creación de Plantilla de cupones


Al momento de dar de alta un tipo de cupón se podrá generar la plantilla de promoción que incluya entre sus elementos el tipo de cupón que se está generando,  ya sea una plantilla para la emisión de un cupón, donde el tipo de cupón es otorgado como beneficio No Monetario (Cupón), o bien para redención del cupón, en donde se evaluará la existencia del tipo de cupón generado dentro de la transacción (condición simple).

 Beneficio cupón: la aplicación del beneficio es emitir cupones.

Beneficio cupón calculado: la aplicación del beneficio es emitir cupones por un determinado monto de descuento calculado en base al total de la transacción.

Para Cupón Calculado:

En el beneficio de la promoción que emite: el Tipo de Beneficio tiene que ser: No Monetario y la Clase de Beneficio: Cupón Calculado.

En el beneficio de la promoción que redime: el Tipo de Beneficio tiene que ser: Monetario, y la Clase de Beneficio: Canje de cupón calculado.


Para cupón (no calculado):

En el beneficio de la promoción que emite: el Tipo de Beneficio tiene que ser: No Monetario y la Clase de Beneficio: Cupón.

En la condición tiene que estar el tipo de cupón que fue emitido (o algo que haga referencia al cupón que fue emitido), el beneficio de la promoción que redime: va el descuento que se hace por ejemplo $2.

Se pueden ver ejemplos en: PROMO 7.4 - Manual del Usuario - Apéndices


Se debe crear la promoción que emite el cupón y la promoción que redime el cupón.


Cuando se va a usar el cupón, en el POS se escanea ese cupón. El POS envía a Promo el número de cupón. Promo busca en la base de datos la info de ese cupón.  Por ej. un cupón calculado que da el 10% de descuento para la siguiente compra, levanta esa info de la base de datos y Promo hace el cálculo del 10% del ticket actual porque se está redimiendo el cupón.


Para que la Promo que Redime un cupón funcione correctamente es necesario poner el Tipo de Cupón utilizado en "CONDICIONES SIMPLES" además puede estar en "Condiciones por Composición".



Tipos de elementos de Fidelidad

En esta sección se podrán generar y administrar los distintos tipos de elementos de fidelidad que administre el retailer, a partir de los cuales se podrán crear elementos que participarán de las transacciones en los distintos puntos de ventas. 

La gestión de los elementos de fidelidad será tarea de la consola de promociones, mientas que el motor de PROMO evaluará la aplicación de promociones que otorguen y/o consuman valores (puntos, dinero, etc.) para luego informar de esto a la consola de promociones. El motor se encargará de informar a la consola las solicitudes de información, consumo o carga de saldos que reciba de los diversos canales que atienda. También desde el POS podrá indicarse la carga o consumo de saldo de un elemento de fidelidad independientemente si participa o no de una promoción.

Al dar clic en Fidelidad >> Tipos de elementos de Fidelidad se visualizará la siguiente pantalla donde se encontrarán los distintos tipos de elemento de fidelidad ya generados.


Nuevo Tipo de elemento de Fidelidad

Para dar de alta un nuevo tipo de elemento de fidelidad deberá darse click en "Nuevo" y se presentará la siguiente pantalla:

 

Los Tipos de Elementos de Fidelidad permitirán definir los parámetros que manejara un elemento de fidelidad al momento de ser dado de alta así como también los parámetros que se evaluarán cuando se quiera imputar o descontar saldo de el.

Estos tipos de elementos de fidelidad, serán los consultados cuando, desde el punto de venta o desde la propia consola se quiera generar un elemento de fidelidad de un tipo específico o imputar/descontar.

Cuando se desee definir un tipo de elemento de fidelidad se deberán tener presente las siguientes opciones:



                   

Podrá seleccionarse entre:


Podrá seleccionarse entre:

Podrá seleccionarse entre:

Las opciones disponibles son:


Cuando el tipo de elemento es nominado, el sistema validará el cliente asociado. Si es no nominado, puede tener o no un cliente asociado, pero el sistema no lo validará.


Podrá indicarse por Configuración las opciones de nominación por defecto que tomaran los tipos de elemento al ser dados de alta.

Deberá buscarse la clave card.nominated.default.option en Administración >> Información de Configuración, y allí se presentara el combo donde podrá indicarse el valor por defecto que traerá el campo "Nominada" en el alta de un elemento, pudiéndose elegir entre "No" (default), "Por archivo de alta masiva" o "En canal de venta".




Podrá seleccionarse entre:

Al seleccionar esta opción la aplicación habilitará el campo obligatorio "Máximo por período de acumulación de puntos". En caso de no completarse este campo, la aplicación, enviará un mensaje de error:





En el popUp "Ingresar Rango de Prefijos" el sistema realizará las siguientes validaciones:

      1. Se validará que el rango Hasta sea mayor que el rango Desde
      2. Se validará que el rango ingresado no se encuentre entre el listado de rangos previamente ingresados para esa elemento. En este caso cuando el usuario presione Enter o Tab, el sistema no permitirá el ingreso de un valor que ya esté ingresado.
      3. Se validará que el rango ingresado no se encuentre asignado para otra elemento. En este caso el sistema validará que el rango ingresado no esté siendo utilizado en parte o en su totalidad para otro tipo de elemento. Por ejemplo si para el tipo de elemento A existe el rango 144-184 y para el elemento B queremos ingresar el rango 150-165, el sistema no permitirá ingresarlo ya que el rango está siendo utilizado para otro tipo de elemento.
      4. No se permitirá el ingreso de letras o caracteres especiales.
      5. Si todas las condiciones antes mencionadas se cumplen, se procederá a ingresar el rango.


Se permitirá la carga masiva de prefijos por archivo.

Ingreso de rango de prefijos por archivo:

Desde el popUp "Ingresar Rango de Prefijos" seleccionando el botón "Seleccionar archivo" se podrá subir un archivo con los rangos de prefijos.

Ejemplo del archivo a subir:

Nota: No debe dejarse espacio entre los rangos de prefijos.

Luego se debe seleccionar el botón "Procesar Archivo". Una vez procesados mostrará una pantalla como la siguiente:

Formato para el ingreso de rango de prefijos: desde-hasta,desde-hasta. Ejemplo 100-140,245-280. (Si se desea ingresar un solo rango por ejemplo el 111 se deberá ingresar de la siguiente manera: 111-111). En donde los valores desde y hasta van a estar separados por un guion medio y entre rangos el separador va ser una coma. Tener en cuenta que entre rangos de prefijos no debe dejarse espacio. El tipo de archivo a ser procesado, deberá ser .CSV o .TXT en donde el nombre del archivo es indistinto mientras se respete el tipo.

El sistema va a procesar el archivo, descartando los rangos que no cumplan con las condiciones mencionadas en la Nota popUp "Ingresar Rango de Prefijos".

Todos los rangos que cumplan las condiciones se cargarán y se verán por pantalla, luego si el sistema detecta rangos que no cumplan con las condiciones descritas anteriormente mostrará un mensaje informando la situación al cliente y esos rangos no se agregarán. Mostrará una pantalla como la siguiente:

En la pantalla "Gestión de tipos de elementos de fidelidad", en la columna "Rango de Prefijos" se detallarán los prefijos ingresados para ese tipo.

El campo Rango de Prefijo en la pantalla "Nuevo Tipo de Elemento de Fidelidad" puede ser auto-completado (autogenerado) por la propia consola de PROMO o bien puede ingresarse a mano, según se configure. 

La configuración de los rangos de prefijos podrá realizarse desde "Administración" >> "Información de Configuración", la opción que configura el ingreso manual o sugerido de esta opción es "cardType.incrementalPrefix" // prefix.active que pertenece al módulo de "Elementos de fidelidad" y admite dos valores "true" o "false", donde "true" indicará que el prefijo será autogenerado y sugerido por la consola y "false" indicará que el ingreso del prefijo será manual. Por default, este valor viene en false. Se validará, al ingresar un rango de prefijos que éstos no estén incluidos en los rangos de otros tipos de elemento.

Con la opción "cardType.incrementalCode", clave "code.active" si lo configura en "true" estará indicando que desea utilizar código numérico incremental para tipos de elemento de fidelidad. Los valores posibles son "true" o "false".

De setearse "true", el rango de prefijo, se ingresará automáticamente. El sistema sugerirá rangos de prefijos. Al habilitarse esta funcionalidad no se deshabilita la posibilidad de edición del rango de prefijos, pudiéndose agregar un nuevo rango, o eliminar el rango autogenerado y colocar otro. Al presionar el botón "Nuevo rango de Prefijos", se mostrará ya definido el campo rango de prefijos.

Al seleccionar el lápiz en la sugerencia de Rangos de prefijos, o el botón "+Agregar prefijos", mostrará la siguiente pantalla:


De setearse "False" se podrá hacer ingreso manual. Podrá optarse por definir un solo prefijo a partir del cual podrán generarse los elementos o bien un rango de prefijos que comprenderá el universo de elementos a dar de alta bajo este tipo de elementos de fidelidad.

Cuando el usuario ingrese el rango de prefijos y presione el botón continuar, en la pantalla nuevo tipo de elemento de fidelidad, debajo del botón "Agregar Prefijo", se mostrará el listado de prefijos ingresados.


En la pantalla "Gestión de Tipos de Elementos de Fidelidad" el "Resumen" mostrará el label "Rango de Prefijos" y mostrará los rangos de prefijos cargados para ese tipo. 


Edición de Tipo de elemento de Fidelidad


En Fidelidad\ Tipos de Elementos de Fidelidad, al seleccionar el botón “Acciones” en cualquiera de los tipos de elementos en estado: Habilitado, Inhabilitado y Distribuido, todos mostrarán las tres opciones: Editar, Copiar y Resumen.

Los posibles estados de los tipos de elementos de fidelidad pueden ser:


Edición de tipo de elemento habilitado e inhabilitado: como todavía no se generaron elementos, se puede seguir editando el tipo de elemento hasta que pase a estado distribuido. Se pueden seguir modificando todos los datos menos el código. 


Edición de tipo de elemento en estado distribuido: va a depender de la configuración del parámetro “isEditableAfterCardsGeneration”.

Si este parámetro está en false (esa es la configuración que trae por default), solo se podrán modificar los campos “Rango de Prefijo” (sólo se pueden agregar prefijos, no se puede eliminar prefijos) y “Activo”.


Si la opción “isEditableAfterCardGeneration” está en true, se pueden modificar todos los campos menos el código.                        

Para aquellos usuarios que utilizan colas RabbitMQ, la creación o modificación de tipos de elementos de fidelidad se postea automáticamente.


Elementos de Fidelidad


La gestión de los elementos de fidelidad será tarea de la consola de promociones, mientas que el motor de PROMO evaluará la aplicación de promociones que otorguen y/o consuman valores (puntos, dinero, etc.) para luego informar de esto a la consola de promociones. También se encargará de informar a la consola las solicitudes de información, consumo o carga de saldos que reciba de los diversos canales que atienda.

En esta sección se visualizaran los elementos de fidelidad dadas de alta en la base de datos de PROMO.

Al presionar en "Elementos de Fidelidad" del menú "Fidelidad" se mostrará la pantalla "Gestión de elementos de fidelidad" donde podrán visualizar los elementos con su estado, número de elemento, tipo de elemento, identificador del cliente, convenio, validez desde/hasta  y saldo disponible.


En esta vista pueden reflejarse elementos de fidelidad otorgados por tiendas, que el cliente no tenga asignadas.

Esta pantalla dispone de filtros que permitirán realizar una búsqueda más detallada de los elemento ya sea por su identificador del cliente, número de elemento, tipo de elemento, estado, vigencia desde/hasta  o convenio.

Los filtros que aparecerán ya pre-cargados serán:

Los siguientes filtros podrán ingresarse según necesidad de búsqueda:

Acciones:

Desde el botón "Acciones" se podrá ver el detalle de cada uno de los elementos de fidelidad existentes, se podrán activar elementos, modificar saldo, cancelar elementos de fidelidad o simplemente visualizar su estado e historial de acciones.

El botón Acciones mostrará opciones de acuerdo al estado del elemento de fidelidad seleccionado, como se muestra en las siguientes pantallas:

Modificar Saldo:


Si se modifica el saldo de un elemento inactivo, el elemento se pasa a Activo.


Se puede limitar el monto que se ingrese en la pantalla desde Fidelidad\ Elementos de Fidelidad, sobre el elemento deseado botón Acciones\ Modificar Saldo, campo "Monto". Dicho límite se configura en Administración\ Información de configuración en el siguiente parámetro:

El límite no es para el saldo disponible en el Elemento de Fidelidad sino para el Monto que se ingresa al modificar el saldo en la siguiente pantalla:


Si el campo changeAmountLimit queda vacío, no habrá límite para el monto a ingresar en la pantalla "Modificar saldo". Por default el campo changeAmountLimit viene vacío.

El campo changeAmountLimit acepta decimales pero tenga en cuenta que debe respetar el formato (punto o coma) establecido en su sistema operativo. Si ingresa el formato erróneo al presionar el botón "Guardar" Promo mostrará el siguiente mensaje para que lo cambie:


Ejemplo:

Si en el campo changeAmountLimit se configuró el valor 10.50 como se muestra en la siguiente pantalla:

Si al modificar el saldo intenta ingresar un monto superior a 10.50 mostrará un mensaje de error como se muestra en la siguiente pantalla:

Si por ejemplo, en Monto ingresa 10.50 o un valor inferior lo tomará correctamente:

Sumará al saldo existente de ese elemento de fidelidad 10.50 quedando el saldo como se muestra a continuación:

Si en el campo Monto ingresa el sgno - delante, restará ese valor al saldo existente en el elemento de fidelidad. Si no ingresa signo o pone + delante del monto, sumará al saldo existente.




Alta Masiva de elementos

Para la generación de elementos de fidelidad a partir de los tipos de elementos existentes, se deberá dar clic en "Alta Masiva". 

Se presentara la pantalla "Alta masiva de elementos de fidelidad"


Aquí se presentarán los procesos de alta masiva ya ejecutados ordenados desde el mas recientes al más antiguo.

Para proceder al alta de elementos, en primer lugar, deberá seleccionarse el tipo de elemento a partir del cual se desea realizar el alta. 

Dependiendo de la configuración de cada tipo de elemento, se podrán dar de alta elementos directamente desde la consola (alta manual) o realizar el alta desde un archivo. 

Dependiendo de la configuración de cada tipo de elemento, se podrán dar de alta elementos:

Alta manual

Se tendrá que seleccionar del combo “[ Tipos de elementos ]” el código de un tipo de elemento de fidelidad que permita alta manual (que no requiera CVV, o que no sea nominada o nominada desde canal de ventas o cuya vigencia no este definida por rango de fechas). Al seleccionar el tipo de elemento se deberá indicar si los elementos que se dan de alta estarán activos o inactivos, por último indicar la cantidad de elementos a generar.


En el primer campo: "Tipo de Elemento" debe seleccionar del combo desplegable el tipo al que van a pertenecer los elementos que se van a generar (podría ser por ej. tipo Visa, en este ejemplo es tp1).

En el segundo campo debe seleccionar si va a "Generar elementos activos" o "Generar elementos inactivos".

En el tercer campo "Rango Prefijos" podrá seleccionar para que rango desea generar elementos (por ej: 250-400).

En el cuarto campo "Cantidad a generar" deberá ingresar un número entero para indicar la cantidad de elementos que desea crear.

Ingresados todos los datos solicitados deberá presionar el botón de la tuerca, para comenzar el proceso de generación. El sistema validará:


Terminado el proceso, se mostrará una nueva línea en la lista de “Últimas operaciones realizadas” con los datos del proceso recientemente ejecutado.

De terminar el proceso satisfactoriamente, se mostrará el estado “Procesado” en la primer columna, y se podrá acceder al informe de los elementos de fidelidad generados desde el botón “Ver informe”.


Se tendrá que seleccionar del combo “[Tipos de elemento de fidelidad]” el código de un tipo de elemento de fidelidad que permita alta por archivo (que requiera CVV, o que sea nominado por archivo, o que sea precargado por archivo o cuya vigencia este definida por rango de fechas). Al seleccionar el tipo de elemento se deberá seleccionar el archivo card_timestamp.catalog que contenga todas los elementos que deban darse de alta en este proceso.

Una vez ingresados los datos solicitados y presionado el botón de la tuerca el sistema validará uno por uno todos los números de elementos ingresados, validará que los rangos utilizados en el archivo se correspondan con los rangos del tipo.

Formato del nombre del archivo card_timestamp.catalog:

Donde timestamp debe reemplazarse por DDMMAAAAhhmmss (que corresponde a: DD: dos dígitos para el día, MM: dos dígitos para el mes, AAAA: cuatro dígitos para el año, hh: dos dígitos para la hora, mm: dos dígitos para los minutos, y ss: dos dígitos para los segundos).

card_DDMMAAAAhhmmss.catalog


Por ejemplo el nombre del archivo para subir en alta masiva podría ser:

card_31102019095001.catalog


El archivo que se utiliza para realizar "Alta masiva de elementos de fidelidad" con tipo de elemento de fidelidad: "Nominada por archivo de alta masiva", en el campo "Status", tendrá como posibles valores a cargar: "ENABLED" o "DISABLED" que deben ir en mayúsculas o vacío (en el caso de que esté vacío tomará al elemento de fidelidad como inactivo).

En caso de que el archivo a procesar contenga un Id de Elemento existente en la base de datos, solo se realizará la actualización del Id de Cliente, en caso de ser un elemento nominado.


Terminado el proceso, se habilitara el botón “ver informe” desde el cual podrán verse los elementos dados de alta al procesarse el archivo y se mostrara el estado “Procesado” en la primer columna del registro que corresponda al archivo procesado.

En caso de haber algún error en el proceso se mostrara le mensaje “Se encontró errores en algunas de los elementos importados. Por favor, ingrese al detalle de errores.” y se habilitara el botón “Detalle de Errores” desde el cual podrán visualizarse las líneas del archivo que presentaron errores al momento del proceso. 


Y  podrá visualizarse  el error del o los registros en cuestión accediendo al informe de errores desde el botón "Detalle de errores"

Asimismo, se generara un archivo de log diario bajo el nombre “aaaamdd.log” (ej.: 2017514.log) y allí se indicara cual o cuales fueron las fallas por las cuales no se completó el proceso. El archivo de log a revisar se encuentra en la ruta synthesis\promo\LOG\

Deberá de corregirse el archivo card_timestamp.catalog para luego poder volver a ejecutarse el proceso, teniendo en cuenta que el nombre del archivo también debe cambiar ya que un mismo archivo no podrá ser procesado dos veces.


 Formato del archivo "card_timestamp.catalog"

El archivo a partir del cual se generen los elementos de fidelidad deberá tener el siguiente formato separado por pipes ( | )

      ID|Type|valid-from|valid-to|CVV|Customer|Amount|Status


ID: Corresponde al número del elemento de fidelidad que se está dando de alta. Requerido.
Type: Corresponde al código del tipo de elemento de fidelidad que se está dando de alta. Requerido.
valid-from/valid-to: deberá completarse en caso de que el tipo de elemento al que pertenece el elemento a dar de alta indique que el "tipo de vencimiento" debe especificarse por "Rango de fechas". (Formato de la fecha AAAA-MM-DD)
CVV: deberá completarse en caso de que el tipo de elemento al que pertenece el elemento a dar de alta indique "CVV requerido". (Campo numérico, largo máximo 5 dígitos)
Customer: deberá completarse con el Código, que se puede ver en la pantalla "Gestión de ".
Amount: deberá completarse en caso de que el tipo de elemento al que pertenece el elemento a dar de alta indique que la "Pre carga" debe especificarse por "Archivo".

Status: indicará el estado del elemento de fidelidad, tendrá como posibles valores a cargar: "ENABLED" o "DISABLED" que deben ir en mayúsculas o vacío (en el caso de que esté vacío tomará al elemento de fidelidad como inactivo).


Según al tipo de elemento de fidelidad al que pertenezcan el/los elementos a dar de alta, podrán tener o no completos algunos campos, mientras que los campos de ID y Type serán de carácter obligatorio.
(Ej.:  541400002201|541|2019-01-01|2019-12-31|520|9595|500|ENABLED)


Nota: Tener en cuenta que si luego del alta de un elemento por archivo y la asignación de cliente y convenio, se realiza nuevamente el proceso de ABM de elemento, informando en la interfaz algún elemento existente en la base pero sin informar cliente, el cliente asociado al elemento originalmente será borrado ya que la actualización de elementos  vía interfaz (card_timestamp.catalog) actualiza el capo cliente pudiendo desasignarse el cliente asignado, quedando sin cliente asignado o ser asignado a otro cliente.


Asignación / Actualización de Elementos

Por medio del proceso de Asignación/Actualización podrá asociarse un numero de elemento a un determinado cliente y convenio así como también podrá asignársele o actualizar un saldo.

Una vez dadas de alta los elementos, tanto para la asignación de y convenios al elemento, como para la recarga o modificación de saldo de las misma deberá de realizarse la Asignación/Actualización de los elementos.

Por medio de este proceso se podrá:

Cuando se realice la asignación de /convenio, a los elementos, los mismos pasaran a estado “activos”.

Cuando se realice un ajuste de saldo, los montos presentes en cada elemento participante del proceso serán actualizados según lo informado en la interfaz de “Asociación/Actualización”

El proceso se realizara por medio de un archivo que solo podrá ser procesado una única vez, en caso de error en el proceso, deberá corregirse el y renombrarse para volver a procesarse.


Nombre del archivo:  tipo de tarjeta_ cod convenio_timestamp.catalog

(Ej.: 111_333_201808021030.catalog)


Formato de cada Registro: Id|customer|amount


El saldo se modificará de acuerdo al signo que se indique en el campo amount.

Si el signo a la izquierda del campo amount, es positivo ( + ) sumará el saldo.

Si es negativo ( - ) se restará saldo.

Si no se ingresa signo, se reemplazará el monto existente por el informado en el archivo.


Ejemplo:

55500000000000010000|2222|-2000

55500000000000010011|3333|2000

55500000000000010022|4444|+2100

55500000000000010044|7777|2100


Una vez procesado el archivo se guardará en la base con el estado "procesado", de manera que no pueda ser procesado nuevamente.

El archivo, será sujeto a las siguientes validaciones:


Validaciones de los campos contenidos en el archivo:

Los tres campos, Id, Customer y Amount, son requeridos.  Si alguno de ellos no viene informado, no permitirá procesar el archivo y se informara por pantalla, que el campo es requerido.


Id

  • El elemento debe existir.
  • Requerido

Customer

  • Si viene informado el cliente y en la DB el elemento no tiene un cliente asociado, se verificara si el cliente informado existe en la DB, y de ser así, se actualizara el campo con el valor informado en el archivo. Si el cliente informado, no existe en la DB, informara un mensaje por pantalla, indicando que el cliente informado, no existe como tal en la DB, y no permitirá procesar el registro.
  • Si viene informado el cliente, y en la DB el elemento tiene asociado el mismo cliente, queda el campo como esta.
  • Si viene informado el cliente, y en la DB el elemento tiene asociado otro cliente, informara un mensaje por pantalla, indicando que el elemento tiene asociado otro cliente en la DB, y no permitirá procesar ese registro.
  • Si no viene informado el cliente, informara un mensaje por pantalla, indicando que el campo cliente es mandatorio, y no permitirá procesar ese registro.

Amount

  • Requerido


De presentarse algún error el proceso se abortará y se informaran los errores en la sección “ASOCIACIÓN/ASIGNACIÓN SALDO ERRORES” que se muestra al presionar el botón ver de un archivo cuyo proceso termino en error.


Para realizar el proceso de Asignación de convenio  cliente y/o actualización de Saldos, se deberá acceder a Fidelidad >> Elementos de Fidelidad. >>  "Asociación/Actualización"


Al presionarlo se mostrará la siguiente pantalla:

Una Vez seleccionado el tipo de elemento y Convenio, se deberá presionar el botón "Seleccionar Archivo" desde el cual se podrá cargar el archivo tipo de elemento_ cod convenio_timestamp.catalog  para luego presionar el icono de procesar.

Cuando el proceso termine OK, se mostrara la línea en la sección de Ultimas Operaciones con el nombre del archivo procesado, el tipo de elemento, la fecha, la cantidad de registros procesados, convenio al que pertenecen los elementos procesados y el usuario que realizo la importación en estado "Procesado".

En dicha línea, se mostrara a la derecha el botón "Ver" cuando el proceso haya terminado OK y  al presionarlo pasara a la pantalla "Actualización/Asignación Detalle". 

En caso de que el proceso termine con errores (El proceso se aborta y no guarda ningún registro), se mostrara una línea en la sección de Ultimas Operaciones con el nombre del archivo procesado, el tipo de elemento, la fecha, la cantidad de registros procesados, convenio al que pertenecen los elementos procesados y el usuario que realizo la importación en estado "ERROR".

Y al presionar el botón "Ver" se mostrara una pantalla con el detalle de las líneas que han fallado en el proceso y por qué han fallado. 

Cuando se intente procesar un archivo cuyo nombre se encuentre mal formado se mostrara el siguiente mensaje de error:

Tanto el alta masiva de elementos, como la asignación de cliente/convenio por archivo podrá ejecutarse vía Job (proceso automatizado).

Para ello deberá configurarse, como primer paso, el directorio desde el cual el Job tomara las interfaces de alta y de asociación. Esto se realiza desde la consola de Promo ingresando a Administración > Información de Configuración.

Allí, deberá buscarse la siguiente línea :

Y deberá indicarse la ruta donde se dejaran las interfaces para ser procesadas (card_timestamp.catalog y tipo de tarjeta _codigó convenio_timestamp.catalog ).

Este Job por default se ejecuta una vez al día por la noche.


Ver Detalles de los Elementos de Fidelidad 

Desde la pantalla de "Gestión de Elementos de Fidelidad", podrá accederse al detalle de movimientos de cualquiera de los elementos presentes en la consola. Al presionar el botón "Ver" que se encuentra en el combo "Acciones" a la derecha de cada elemento, se accederá a la vista de "Transacciones registradas" donde se expone un resumen de los datos del elemento y el detalle de las operaciones realizadas con el, pudiéndose filtrar por un rango de fechas determinadas y exportar los datos a un Excel.

La columna "Motivo" mostrará o no información de acuerdo a lo siguiente:

Si la transacción trae un motivo informado desde Promo en modificación de saldo o desde el POS, se mostrará ese motivo.

Si el motivo que trae desde el POS, no existe en Promo, se mostrará el código como lo trae; y ese será el indicio para el usuario para saber que debe agregar en forma manual (desde la pantalla Gestión de motivos de modificación de saldos) ese nuevo motivo que se está utilizando. 

Si no trae un motivo, se mostrará una de las opciones del siguiente cuadro, de acuerdo a la acción realizada con la tarjeta. Solo para las acciones recarga y consumo si trae un motivo lo muestra. Para las otras acciones debe mostrar el motivo que se encuentra en la siguiente tabla:


en Motivo, en español mostrar

Activación
Inactivación
Asociación cliente
Des asociación cliente
Devolución
Consulta
Carga

Al hacer una recarga:

    • si el motivo que trae es null va a mostrar: Transferencia
    • si el motivo que trae es '-', el motivo es vacío (no muestra nada en la grilla)
    • si no se dan las situaciones anteriores, se mostrará el motivo informado, si el motivo no se encuentra registrado muestra el código que trae
Saldo manual

Venta

(si trae un motivo no se muestra ese motivo que trae se muestra siempre Venta)

Al hacer un consumo:

    • si el motivo que trae es null va a mostrar: Redención
    • si el motivo que trae es '-', el motivo es vacío (no muestra nada en la grilla)
    • si no se dan las situaciones anteriores, se mostrará el motivo informado, si el motivo no se encuentra registrado muestra el código que trae.
Redención parcial
Redención total
Transferencia
Cancelación
Vencimiento
Extensión de vigencia
Asignación de convenio


Si se modificó el cvv de un elemento de fidelidad, quedará registrado en el informe "Transacciones Registradas" que se accede seleccionando Fidelidad\ Elementos de Fidelidad\ sobre el elemento deseado seleccionar el botón Acciones\ Ver, en la sección "Movimiento" mostrará en la columna Motivo "Cambio en cvv", ya sea que el cvv traiga un número o esté vacío.

También se permitirá desde esta sección realizar las siguientes acciones, (dependiendo de la configuración del tipo de elemento al que pertenece el elemento en cuestión)







El saldo se modificará de acuerdo al signo que se ingrese:

Si el signo a la izquierda del campo es positivo ( + ) sumará el saldo.

Si es negativo ( - ) se restará saldo.

Si no se ingresa signo, en esta pantalla, se sumará el monto ingresado al existente.

(Ver también "Motivos de modificación de Saldos")


Trasferir: podrá transferirse saldo entre elementos pertenecientes al mismo tipo y que acepten recarga, si es que la configuración del tipo de elemento al que pertenecen lo permite.

Asociar cliente: podrá asociarse un elemento de fidelidad a un determinado código de cliente, si es que la configuración del tipo de elemento al que pertenecen lo permite.


Extensión de Vigencia:

Desde la sección "Transacciones registradas" de un elemento, si el elemento pertenece a un tipo de elemento que tiene habilitado el vencimiento de carga, se mostrara a la derecha de cada carga vencida (se excluyen los consumos y puntos vigentes.) el botón "Extender Vigencia"


Al presionarlo, se muestra un popup donde se presentara el vencimiento actual, la cantidad de puntos a afectar y se propondrá un calendario, donde se indicara la nueva fecha de vencimiento de los puntos seleccionados.


Indicado el nuevo vencimiento, se presionara "Aceptar" y se mostraran estos puntos con su nuevo vencimiento en la grilla de movimientos de las transacciones registradas de la tarjeta.


Transferencia ante extravío.

Cuando un cliente denuncie su elemento de fidelidad como extraviada, podrá realizarse la transferencia TOTAL del los datos y saldos del elemento extraviado a un nuevo elemento.

El elemento denunciado pasara a cancelado y con saldo 0 (cero), mientras que el elemento de destino, quedara activo, con el saldo total, el cliente y convenio (en caso de tener asociado) que tenía el elemento de origen. Siempre la transferencia se realizara entre elementos de un mismo tipo y el elemento de destino deberá estar inactiva con saldo cero y sin convenio ni cliente asociado para poder recibir los datos del elemento denunciado.

Al presionar “Transferir” (cuando el tipo de tarjeta permita transferencia total), se mostrara el siguiente popUp:

El Saldo a transferir propuesto será el total que tiene el elemento denunciado y no podrá editarse.

En el campo Elemento de destino, a medida que se ingresen los dígitos del elemento de destino se propondrán los números de los elementos de ese tipo inactivas, con saldo cero, sin cliente ni convenio asociado para ser seleccionadas.

Una vez elegida el elemento de destino se presionara Aplicar y la transferencia total estará hecha

Convenios


Un convenio es un acuerdo establecido entre dos o más entidades con la finalidad de dar beneficios a los .

Desde la consola de Promo se podrán dar de alta "Convenios", que luego podrán ser asociados a elementos.

Desde la sección Fidelidad >> Convenios podrán administrarse y generarse nuevos Convenios que luego serán asociados a elementos de fidelidad de distinto tipo por medio del proceso de “Asociación/Actualización” de Elementos de Fidelidad ( Asignar Convenios Fidelidad >> Elementos de Fidelidad).

Se cuenta solo con el filtro de "Estado" con el cual podrá filtrarse entre los convenios activos E inactivos.


Para dar de alta un nuevo convenio, deberá presionarse en el botón “Nuevo” y se presentara la siguiente pantalla: 

Deberán completarse los siguientes campos para el alta del convenio:

Una vez completados todos los campos podrá presionarse en “Guardar”.

Los convenios existentes podrán ser editados, pero una que se hayan asociado elementos y estos se encuentren activos ya no podrá modificarse el código del convenio.

Un cliente sólo podrá tener un tipo de  elemento de fidelidad asociado a un mismo convenio. Es decir un cliente no podrá poseer dos o más Elementos de fidelidad que estén asociados a un mismo convenio.


Clientes

A presionar en "Fidelidad" > "Clientes" se visualizara la pantalla "Gestión de Clientes" en donde podrán visualizase los clientes presentes en PROMO. 


Se podrá acceder al detalle de cada uno de los clientes y visualizar, en caso de poseer, los elementos de fidelidad, cupones asociados y Programas de objetivos, así como también el estado de cada uno de estos elementos de fidelidad. Para ello se deberá presionar (en la vista Gestión de Clientes) en el menú desplegable "Acciones" y luego en "Ver". 


Más abajo se muestra el informe de “Movimientos de Límites por Cliente” donde se detallarán las promociones en las que haya participado el cliente y que tengan un límite de cliente asociado que se haya consumido para él, pudiéndose filtrar por rango de fechas las promociones aplicadas.


La sección “Movimientos de Límites por Cliente” posee dos filtros de fecha, para seleccionar un período de búsqueda que  por default mostrará un rango de los últimos 3 meses, pero se podrá filtrar el período deseado. Si se filtra por un rango de fecha mayor a tres meses se mostrar un Banner con el mensaje : "Seleccione un rango de fecha menor o igual a 3 meses"


En la parte inferior de la vista se detallarán los cupones, elementos de fidelidad, segmentos y Programas de Objetivos asociados al cliente, con su correspondiente estado.

En la sección "Segmentos" se visualizará un tag "Externo" donde se mostrarán los segmentos externos del cliente si es que posee. Y debajo se visualizará otro tag "Interno" donde estarán los códigos de los segmentos internos que son los que maneja Promo.

Se visualizará un máximo de 255 códigos de segmentos en el tag "Internos".  Los segmentos "Externos" no tienen límite, se mostrarán todos.

Con respecto a los segmentos internos, se visualizarán dependiendo de los permisos. Si no tiene permisos no mostrará el tag "Internos".


Eliminación de datos del cliente

Se pueden eliminar en la Consola de Promo los datos del cliente y sus datos de fidelidad relacionados.

Al seleccionar Fidelidad\ Clientes, mostrará la pantalla "Gestión de clientes". Una vez identificado el cliente que se desea borrar, se seleccionará sobre ese cliente el botón "Acciones", que mostrará las opciones: 

IMPORTANTE

La opción "Eliminar datos del cliente" sólo la verán y podrán acceder los usuarios que tengan otorgado el permiso "Eliminar datos del cliente". Por default sólo la verán los usuarios con el rol de administrador.

Al seleccionar la opción "Eliminar datos del cliente" mostrará la siguiente pantalla: 

Por default va a traer seleccionada la primer opción (Eliminar Datos Cliente).

Si se selecciona la opción "Eliminar Datos Cliente" y luego presiona el botón "Eliminar":

El sistema mostrará un cartel pidiendo confirmación "Está seguro de eliminar los datos del cliente seleccionado?" mostrará botones: Aceptar/Cancelar.

Si el usuario confirma presionando el botón "Aceptar" el sistema reemplazará todos los datos del cliente por - (excepto el código), y ese cliente quedará en estado inactivo. Sólo seguirá teniendo como referencia el código. Si este cliente tenía datos de fidelidad van a seguir existiendo.

Se pueden recuperar los datos de fidelidad del cliente que fue eliminado parcialmente; ya que se dispone de su Código.

Se debe tener en cuenta que si se agrega en el catalog.Customer (Catálogo de Clientes) datos de otro cliente utilizando el Código del cliente eliminado parcialmente, a ese cliente se le agregarán los datos de fidelidad del cliente eliminado parcialmente.


En la vista Registro de auditoría se registrará la eliminación parcial:

Si se selecciona la opción "Eliminar Datos y Fidelidad del Cliente" y luego presiona el botón "Eliminar":

El sistema mostrará un cartel pidiendo confirmación "Está seguro de eliminar los datos del cliente seleccionado?" mostrará botones: Aceptar/Cancelar. Si el usuario confirma presionando el botón "Aceptar" el sistema eliminará:

Si presiona el botón "Cancelar" no se eliminará ningún dato. 

El sistema mostrará un cartel pidiendo confirmación "Está seguro de eliminar los datos del cliente seleccionado?" mostrará botones: Aceptar/Cancelar.

Si el usuario confirma presionando el botón "Aceptar" el sistema eliminará, y sus datos no se verán reflejados en la vista de Gestión de Clientes. Si este cliente tenía datos de fidelidad van a ser borrados.

En el ejemplo ya no se observa el registro de código 1.

 En la vista Registro de auditoría se registrará la eliminación total:


Programas de Objetivos


Un Programa de objetivos es un programa de fidelidad, donde el cliente tendrá que cumplir con ciertas metas en determinadas frecuencias a fin de poder avanzar en el mismo. En dicho avance el cliente irá obteniendo mejores beneficios; por ejemplo: descuentos monetarios, cupones, regalos, etc.

 Promo posee esta funcionalidad que se puede acceder desde el menú Fidelidad/Programas de Objetivos.


                                               

   Al presionar la opción, la aplicación desplegará la vista Gestión de Programas de objetivos, que permitirá administrar los diferentes programas de objetivos creados.:

                                                                                   

    Esta vista posee los siguientes filtros:


  Las columnas que detallará son:



Nuevo programa de Objetivos

Desde la vista de gestión de programas de Objetivos, se puede crear un nuevo Programa de Objetivos, presionando el botón

La aplicación desplegará la vista Nuevo Programa de Objetivos:

En esta vista se deberán completar cada uno de los campos:

Luego se deben completar las secciones que se muestra a continuación:

La fecha Válido Desde no puede ser mayor que el valor Válido Hasta:

Luego se debe seleccionar el tipo de Programa:


  • Al seleccionar el Tipo de programa se estará limitando el formato de los datos que indicarán en el rango de los segmentos, es decir para el tipo de programa  "Cantidad de productos" deberá indicar el rango de segmentos con valores numéricos enteros; en cambio para el tipo de programa "Basado en monto de compra", los rangos podrán tener valores decimales.
  • Esta limitación del formato de acuerdo al tipo de programa definirá el tipo de valor numérico que se insertará en los segmentos, por ende para cambiar el Tipo de programa de objetivos se deberá remover todos los segmentos previamente insertados en el programa, esto con el propósito de evitar incompatibilidad en el formato de los rangos insertados previamente con un tipo de programa distinto.


A partir de la versión 7.9 de Promo se ha agregado un nuevo check en la solapa "Tipo de Programa" del Programa de Objetivos: "Acumulación fija por valor agregado".

Cuando esta opción está activada, se calculará la acumulación de puntos (o sellos) basándose en un valor fijo predeterminado, multiplicado por el factor establecido. Este valor no dependerá de las cantidades de los artículos comprados, sino que se aplicará de manera fija sobre cada transacción.

Por defecto, esta opción viene desactivada.


Al seleccionar el Tipo de Programa "Basado en puntos de fidelidad" se mostrará la siguiente pantalla:

En la sección "Tipo de Elemento de Fidelidad" podrá si lo desea, activar el check "Puntos informados por el cliente" así se considerarán los puntos informados por el cliente en el POS. Si activa esta opción se deshabilitará (quedará grisado) el campo "Tipo de Elemento de Fidelidad"

En el campo "Tipos de Elemento de Fidelidad" deberá seleccionar el tipo de elemento que se tendrá en cuenta para este programa de objetivos.

El Tipo de Elemento de fidelidad es único por Programa de Objetivos. No puede estar el mismo tipo de elemento de fidelidad en mas de un programa de objetivos.


Luego se debe completar, el campo Máximo de Acumulación, que es el máximo valor que puede adquirir un cliente por transacción. En nuestro ejemplo es =1, significa que el programa de objetivos sólo considerará un producto por cada transacción. Valor numérico con o sin decimales asociado al Tipo de Programa seleccionado, cuyo valor por defecto será 1, este campo solo será modificable para el Tipo de programa Cantidad de Productos.

Se debe completar los datos de Frecuencia, la cual puede ser:

El período Mensual se refiere a mes calendario.

                                          

El tipo de frecuencia seleccionado vale tanto para la frecuencia mínima como para la frecuencia máxima.


A partir de la versión 7.9 de Promo se incorpora en la solapa Frecuencia del Programa de Objetivos un nuevo check: "Reinicia el conteo cada Frecuencia Máxima".

Cuando esta opción está activada, el contador del Programa de Objetivos se reiniciará automáticamente al cumplirse el período definido como Frecuencia Máxima, independientemente de si el cliente realizó o no compras durante ese tiempo. Esto permite comenzar un nuevo ciclo de acumulación de objetivos cada vez que transcurre el plazo máximo establecido.

Por defecto, esta opción viene desactivada.


Se deben completar los datos correspondientes a los segmentos, que van a formar parte del programa de objetivos.

Es necesario que antes de crear un nuevo programa de Objetivos, estén cargado en la consola los segmentos que van a formar parte del mismo.


Si el cliente posee segmentos externos no podrá ser incorporado a un Programa de Objetivos


El campo Segmento es autocompletable y se debe seleccionar entre los que existen en consola. 

El Rango se completa con los valores que va a administrar cada segmento. Estos valores son numéricos y mayores a cero.

  • El Desde debe ser un número menor o igual al Hasta. 
  • El valor Desde de cada segmento debe ser igual al rango Hasta del segmento agregado anteriormente.
  • Cada uno de los segmentos que se agreguen al programa podrán ser removidos presionando el icono  
  • Los segmentos al ser removidos del programa recalcularan de forma automática su valor Desde en base al valor Hasta del segmento anterior a el.
  • No se puede agregar mas de 5 segmentos por programa.


Posibles motivos asociados a cada error:

Para el tipo de programa de objetivos "Basado en el Monto de compra"; si el cliente se fue de vacaciones o estuvo enfermo, no va a consumir en ese mes y si alcanzó la Frecuencia Máxima se le podrá agregar a ese cliente en forma manual un segmento del programa de objetivos para que pueda obtener el beneficio correspondiente a ese segmento, hasta que el programa de objetivos lo mueva de segmento.


Por último se deben asociar las promociones al nuevo programa de objetivos. Para ello se deben crear previamente las promociones y luego agregarlas al programa:

En caso que se quiera agregar una promoción relacionada a otro programa de objetivo; la aplicación enviará el siguiente mensaje de error:

   

  • La promoción debe ser única en el programa.
  • No hay limite de promociones a configurar en el programa.
  • Solo sugerirá promociones que no se encuentren incompletas o canceladas.
  • Cada una de las promociones que se agreguen al programa podrán ser removidas presionando el icono  

 Resumen del Programa de Objetivos

El propósito de esta sección es servir de guía ilustrativa para el usuario sobre el estado del programada, actualizándose en tiempo real a medida que el usuario va indicando los datos en cada una de las secciones disponibles.

Detalles:

  Luego de completar todos los ítems:

 

           

Con el botón el nuevo programa de objetivos queda almacenado en la consola.

               

Editar Programa de Objetivos 

Para editar un programa de objetivos, en la vista Gestión de Programas de Objetivos, para el programa que se quiere modificar se debe presionar en el botón "Acciones"

el ítem Editar

Un Programa de objetivos sólo se puede modificar en su totalidad (el Código no se puede modificar nunca); si no fue asignado a un cliente. Los campos a modificar son:


Una vez que el programa haya sido usado, es decir que se haya transaccionado con el, solo será posible actualizar los siguientes campos:


Debido a la complejidad inherente, el Programa de Objetivos no contempla devoluciones. Esta deberá ser actualizada manualmente fuera del Programa de Objetivos.


Eventos

Funcionalidad de Promo que permite alertar en el POS, sobre distintos eventos relacionados al cliente; y que pueden reflejarse en beneficios para el mismo.

Se puede acceder desde Fidelidad/Eventos. Al seleccionar la opción la aplicación desplegará la vista:

 Donde los filtros de búsqueda son:

 Las columnas que se detallan son:


Nuevo Evento

Desde la vista Gestión de Eventos, se puede crear un nuevo evento, presionando el botón la aplicación desplegará la vista:


En la pantalla anterior, se deberán completar los siguientes campos:

                                     

Los eventos deben tener código y nombre. El código no se puede repetir con el de otro evento.

     

Las condiciones disponibles son: 

VistaDetalles

  • Cumpleaños
    • Filtro para la búsqueda de clientes que cumplen o no años durante el día en curso.
    • Tipo de dato verdadero/falso
    • Operaciones asociadas: IGUAL, DISTINTO
  • Tipo de cliente
    • Usado para la búsqueda de clientes por tipo.
    • Es un campo autocompletable que toma los datos del catalogo catalogCustomerType.
    • Operaciones asociadas: IGUAL, DISTINTO
  • Segmentos
    • Usado para la búsqueda de clientes por segmento, es importante tener en cuenta que tanto los segmentos como los clientes del segmento deberán estar cargados previamente y los segmentos deberán ser internos de Promo, con estado activo.
    • Es un elemento autocompletable que permitirá insertar valores múltiples y no admitirá la asociación de segmentos externos.
    • Operaciones asociadas: IGUAL, DISTINTO.
  • Datos incompletos
    • Usado para identificar a los clientes que poseen datos incompletos.
    • Tipo de dato verdadero/falso
    • Operaciones asociadas: IGUAL, DISTINTO
  • Aplica a TODOS
    • Este criterio se aplicara sobre todos los clientes disponibles
    • No posee operaciones asociadas, se aplica directamente.


Para los campos autocompletables, al configurar la variable validate.autocomplete.existing = "true", evitará el ingreso de valores inexistentes.




Se puede agregar más de una condición al evento:


O inclusivas, se puede cumplir alguna de las condiciones o todas para asignar el evento al cliente:



Se pueden editar las condiciones; a través del símbolo donde se puede modificar cualquiera de los campos:

Para eliminar una condición, se utiliza el ícono

Antes de la eliminaciónLuego de la eliminación


No se pueden dar de alta nuevos eventos sin condiciones.


Tendrá una longitud máxima de 100 caracteres y se podrá visualizar por pantalla la cantidad de caracteres usados en la medida en que se escriba el mensaje.


No se puede crear un nuevo evento sin el mensaje asociado.

Para conocer la cantidad de clientes que están asociados a las condiciones del evento, deberá presionar el botón con el icono de la lupa, es importante que tenga en cuenta que este proceso puede tardar, todo dependerá de la cantidad de datos que se tenga.


Con el botón se almacenará el nuevo evento creado y éste se reflejará en la vista de Gestión de Eventos:


En esta vista se mostrarán los últimos 25 eventos generados. Cuando se supere esta cantidad de eventos, se mostrará un paginador para pasar a la/s siguiente/s páginas.

Editar Eventos

Se puede modificar un evento; para ello se clickea en el botón "Acciones" y luego en "Editar", la aplicación desplegará la vista del evento al cual se quiere hacer el cambio:


En dicho evento, se podrán modificar todos los campos, excepto el código.  Al igual que en la creación del Evento, cada vez que se editen las condiciones se refrescará el valor de la cantidad de clientes a cero (0), esto con el propósito de evitar confusiones sobre la cantidad real de clientes asociados al evento.

Activar/Desactivar Eventos

Los eventos no se eliminan; sino que se desactivan. Para ello se debe editar el evento que se quiere cambiar el estado y destildar el checkbox "Activo".

En la consola, se reflejará:

El mismo procedimiento se debe seguir si se quiere activar el evento:

En la consola se mostrará activo nuevamente:




Capítulo 9 - Productividad


PROMO 7.4 - Manual del Usuario - Productividad




Capítulo 10 - Módulo de Informes


PROMO 7.4 - Manual del Usuario - Informes






Capítulo 11 - Módulo de Negocio


Menú de Negocio


Este menú proporciona la creación y administración de unidades departamentales, compañías  y tiendas que se disponen dentro del negocio.


Tiendas


La tienda es la unidad mínima que se tomará para la distribución de mapas. Se pueden definir diferentes métodos de distribución para cada una de las tiendas. Desde el menú Negocio > Tiendas, se accede a la Pantalla de Administración de Tiendas:



Se disponen los filtros:


Los datos de las tiendas se visualizan en las columnas  Código, nombre, domicilio, email y tipo de conexión de la grilla.

El usuario logueado sólo verá las tiendas que tiene asociadas.


Nueva Tienda

Dentro del menú Tiendas presionando el botón "Nuevo" accederá a la pantalla "Crear Tienda":




Los campos a completar son:

Si se genera una Tienda y no se activa, ésta no aparecerá disponible para su selección en los distintos menús donde deba indicarse una Tienda.

Para que se muestre información en las listas desplegables, previamente el usuario deberá realizar la carga masiva por catálogo ingresando en Administración -> Importación de catálogo.

Una vez completo todos los campos, se deberá presionar "Guardar" para que la Tienda sea creada correctamente. La aplicación no permitirá guardar tiendas que el usuario no tenga configuradas.


Agregar conexiones

Generada la Tienda, podrá agregarse configurarse el o los tipos de conexiones que tendrá a fin de realizar la distribución de los mapas. Para ello se deberá de acceder a la tienda a la que se le desea agregar una conexión desde el botón "Editar".



Luego se deberá dar clic en el botón "+ Agregar Conexión"

 


Se presentara la siguiente venta donde deberá indicarse el tipo de conexión que se quiere configurara a la tienda.

Las opciones disponibles para la configuración son:


De seleccionarse la conexión "File" se mostrara la siguiente pantalla donde deberán ingresarse los datos solicitados a fin de configurar correctamente el tipo de distribución.


Se solicitaran que se detalle el "Directorio" o ruta donde se distribuirán los mapas que utilicen este tipo de conexión.

Se podrá indicar en este punto si el archivo (mapa) a distribuir será enviado en formato ZIP, para que luego el motor automáticamente lo descomprima y lo cargue, o bien se distribuya como archivo .XML como lo es habitual, indicándolo en la opción "Distribuir en ZIP SI/NO"

Si se opta por alguna de las distribuciones FTP (FTP o FTP Seguro) también podrá optarse por el envío del mapa comprimido en un archivo ZIP.

También serán requeridos los datos que se muestran en el siguientes PopUp al momento de configurar la conexión FTP:



Distribución Automática

desde la  consola de PROMO se podrá indicar los mapas que estarán disponibles para que, el o los motores de una tiendas, lo descarguen y actualicen al último mapa vigente.

En caso de optar por la distribución Automática no se solicitara ningún dato adicional ya que el o los motores asociados a la tienda serán los encargados de descargarse el mapa y colocarlo en el directorio de distribución que cada uno tenga asociado.





En caso de que la distribución automática sea a un motor que opera en modo "Multitienda" el mapa será enviado con un path relativo /codigo_empresa/codigo_tienda.  Con esto el motor sabrá que debe descargar el archivo en c:\mimotor\sales\codigo_empresa\codigo_tienda

Caso contrario, si la distribución automática se realiza en un NO opera en modo "Multitienda" el mapa será enviado con un path relativo /código_empresa.  Con esto el motor sabrá que si su path de mapas es c:\mimotor\sales, deberá descargar el archivo en: c:\mimotor\sales\codigo_empresa.



Si se utiliza un tipo de distribución automática para una tienda no se podrá definir luego otra conexión, así como tampoco podrá definirse un tipo de distribución automática cuando la tienda tenga definida ya otro tipo de distribución, por lo que deberá eliminarse el tipo de definición no automático definido y luego si se podrá definir el tipo de definición automático solamente.


Motor Multitienda

Al definir las conexiones también podrá indicarse si el motor que se utiliza posee configuración Multitienda.

De no tildarse la opción "Motor Multitienda" se indicara que el motor no opera con multitienda, por lo que la consola creara el directorio \SALES al distribuir, debiendo configurar las rutas de deploy sin indicar este sub directorio. (Ej.: C:\synthesis\Promo\engine)

En caso de que se opte por operar con Motor Multitienda, deberá tildarse la opción "Motor Multienda", por los que la consola NO creara el directorio \SALES al distribuir, teniendo entonces que indicarlo explícitamente cuando se defina la ruta de distribución (Ej.: C:\synthesis\Promo\engine\sales).


Asociar Motor

Se podrá asociar una tienda determinada a uno o varios motores que operen en ella. Estos motores informaran cada una determinada cantidad de tiempo cual es el mapa activo con el que está operando.

Para ello deberá darse clic en "Asociar Motor".


Cuando un nuevo motor se instale, este se reportará a la consola de PROMO que se haya definido (URL indicada en el archivo config.xml del motor), se reportará quedando ONLINE y a la espera de que sea asignada a una tienda y se le distribuya un mapa.

El id del motor configurado en el archivo config.xml (ese es el nombre del motor que se mostrará en la selección) tiene un límite de 100 caracteres.


Al presionar en "Asociar Motor" se presentará el siguiente pop-Up:


De los motores disponibles deberá de seleccionarse el que se desee asociar a la tienda. Al presionar "Guardar" se mostrará en la pantalla de edición de tiendas, el motor asociado a ella y que reportará su mapa activo a la consola.




Se podrán asociar nuevos motores a la tienda así como también eliminar la asociación realizada.

Cuando se crean nuevas compañías; si ya existe un motor asociado a una existente, la nueva no verá el estado de dicho motor en Soporte, Estado del Sistema. Cuando se distribuya manualmente un mapa vigente en una tienda de la nueva compañía ; ya se le podrá asociar el motor y esta nueva compañía podrá ver el estado del mismo en Soporte, Estado del Sistema; seleccionado el ítem motor.



Segmentos


Se podrá agrupar a los clientes por segmentos.

Desde el Menú Negocio/ Segmentos, se podrá crear nuevos segmentos, editar y ver segmentos existentes. Se podrá buscar por Código y/o por Nombre.

Al seleccionar el botón "Acciones" se podrá acceder a la edición o definición de los segmentos.




Nuevo Segmento

Con el botón "Nuevo" se puede crear un nuevo segmento.

Los datos a ingresar son los siguientes:

Código: campo alfanumérico, requerido y sin limitaciones de longitud. Su valor debe ser único.

 Nombre: campo alfanumérico, requerido y sin limitaciones de longitud. Su valor debe ser único.

Al seleccionar “Guardar y continuar”, mostrará la pantalla “Detalle” , ahí se carga desde “Seleccionar Archivo” el documento con los clientes que van a formar parte de ese segmento y luego se debe presionar el botón “Procesar archivo”.  

Los formatos válidos a levantar son: csv (separados por comas), txt (separados por comas), xlsx (los ítems tienen que estar uno debajo del otro, cada uno es una fila). Si se levanta un archivo con otro formato, mostrará un mensaje informando que el archivo debe tener formato csv, txt o xlsx.

El sistema valida que en el archivo no tenga códigos de clientes repetidos y si hay repetidos tomará uno solo.

Cuando se crea el registro del segmento se guarda Código, Nombre,  Fecha de creación, Usuario de creación, Fecha de actualización y Usuario que realizó la actualización. Luego de la carga de los clientes, se agregarán datos complementarios como: nombre del archivo y cantidad de clientes subidos.

Para cualquier tipo de Programa de Objetivos, si un cliente no ha consumido durante un período igual o mayor a la frecuencia máxima y por el proceso ha sido quitado del segmento en que se encontraba; puede ser restituido al mismo segmento, a través del servicio Rest.


A la derecha de cada registro se encuentra el botón "Acciones" que posee dos ítems::

Editar: permite cambiar el nombre al segmento: 

                                

Definir: Permite cargar los clientes que pertenecerán  a ese segmento de forma manual y también poder editar la cabecera del mismo,  como se explicó anteriormente 

También posee la opción que permite obtener a través de un archivo excel el listado de todos los segmentos registrados en Promo.

Al presionar la opción, la aplicación mostrará la vista del Monitor de Exportación de Informes y desde la columna descripción bajar el archivo.


                                 

Utilización del segmento:

Al crear una nueva promoción en "Condiciones Simples" o en "Condiciones por composición", en el elemento "Clientes" al desplegarlo muestra el atributo “Segmento” al seleccionarlo muestra: Igual o distinto.


Al reprocesar un archivo de asociación "clientes-segmento", todas las asociaciones previamente registradas serán eliminadas. Es decir, el sistema reemplazará completamente la información existente con la contenida en el nuevo archivo procesado. Por lo tanto, se debe asegurar de que el archivo actual contenga la totalidad de las asociaciones deseadas, ya que solo se conservarán aquellas incluidas en el último archivo cargado.


Los segmentos se pueden administrar desde Promo como se detalla arriba o puede utilizar segmentos externos (que no administra Promo) asociándolos al cliente desde el catálogo de Clientes (catalogCustomer). Si utiliza segmentos cargados desde el catálogo de clientes esos se tomarán como prioritarios.




Capítulo 12 - Módulo de Administración


El módulo de administración permite realizar ajustes dentro de la consola tales como habilitar o des-habilitar funcionalidades, cargar catálogos entre otras.

El acceso a éste módulo será autorizado solamente para un usuario administrador con los permisos correspondiente para éste menú.


Menú de Administración


Éste menú permite administrar y configurar distintos accesos a PROMO.

        

       



Dashboards

Al presionar el botón de Dashboard se podrán administrar y reconfigurar los Dashboard que ya trae por default la consola de PROMO o bien se podrán generar nuevos que luego se visualizaran desde el menú de Dashboard.

Al presionarse en el botón "Dashboard" del menú Administración se visualizara la ventana "Administración de Dashboard" donde se listaran los Dashboard por default así como también los Dashboard personalizados que pudieran haberse generado.


A la izquierda de cada Dashboard se encuentra el botón "Acciones" desde el cual se podrán Editar, Definir o Ver los Dashboard existentes.

Al pie de esta ventana se encuentra el botón "Nuevo" desde el cual se podrán generar nuevos Dashboard.


Nuevo Dashboard 

Al presionar en el botón "Nuevo" se mostrara la siguiente pantalla desde la cual se podrá ingresar el nombre, código y formato de visualización del nuevo Dashboard, también se cuenta con un check para habilitar o deshabilitar el Dashboard que se está generando.


Luego de cargados los datos solicitados, se deberá presionar el botón "Guardar" y se mostrara la pantalla de edición de Dashboard.


Editar Dashboard 

Ya sea si se genera un nuevo Dashboard o si se está editando uno ya existente, al presionar guardar se mostrará la ventana "Edición de DASHBOARD: xxx" donde "xxx" corresponde al nombre del Dashboard que se está editando o generando.

En esta pantalla se propondrán diferentes KPI o indicadores que podrán seleccionarse para diseñar su Dashboard

Se cuenta con los botones "Cancelar" desde el cual se podrá regresar a la pantalla de "Administración de Dashboard"; el botón "Editar" permitirá acceder nuevamente a la pantalla anterior de "Editar Dashboard", con el botón "Guardar" permitirá guardar los cambios y/o generar el nuevo Dashboard.

Al presionarse "Guardar" se mostrara en pantalla en Dashboard en que se estaba trabajando ya desde la opción "DASHBOARD" del menú "Opciones de Menú". Lo mismo sucederá cuando se presione el botón ver de algún Dashboard desde la ventana de "Administración de Dashboard".

Se disponen de los siguientes KPI en el producto base para la generación de los Dashboard:


Al emitirse y redimirse cupones calculados, ya sea por porcentaje, monto fijo o monto externo se verán reflejados los movimientos en los dashboards de cupones.


Importación de Catálogos

Los catálogos son repositorios de datos provistos por el cliente. Estos estarán relacionados con los atributos de los artículos de la Consola de PROMO, como ser los catálogos de códigos de artículos, departamentos, marcas, etc, así como también de clientes, tiendas y atributos de la cabecera.

PROMO cuenta con la funcionalidad de subir un archivo en formato de texto separados por "," (coma) para ser procesado e importado manualmente. Este formato podrá ser configurado desde la consola en caso de ser necesario (Ver Administración >> Información de Configuración - clave: "fileList.txt.Separator").


Carga de Catálogos desde un Archivo desde las carpetas

Desde Administración \ Información de Configuración, buscando por la clave: "fileDirectory" encontrará la ruta con la descripción "Importación de catálogo: directorio donde estarán los archivos" donde podrá dejar los archivos de catálogos que desea se carguen en forma automática en la consola de Promo. El contenido de cada archivo aparecerá en el catálogo de Promo que corresponda si tiene el nombre y la información estructurada de acuerdo a lo esperado (ver detalle mas abajo). Los archivos se cargarán luego de que se ejecute automáticamente el proceso que importa los catálogos.


Carga de Catálogos desde un Archivo desde la consola de Promo

A continuación se proveerá la información necesaria para la administración y carga de los catálogos desde la consola de PROMO.

Si se desea realiza la carga de catálogos por intermedio de un archivo, habrá que confeccionarlo en formato de texto, separando los campos por "|" (Pipe).

Este formato podrá ser reconfigurado desde la consola en caso de ser necesario (Ver Administración >> Información de Configuración - clave: "Separator")

A modo de ejemplo, se detallará un registro perteneciente a un catálogo de carga de ítems (catalogitem.catalog). 

Ejemplo:
El catálogo de "productos", está conformado por los campos: "code", "name", "unitprice", "level1", "level2", "level3", "level4", "supplier", "brand", 

El archivo catalogitem.catalog, quedará conformado de la siguiente forma: 1252|Game FIFA 10 for PS3|50|Elec|VGCo|PS3G|5|PR1|5


Para proceder a la carga, se deberá presionar el botón "Importar" en la ventana "Importación de Catálogos" que se corresponda con el catálogo que se está queriendo procesar.

Para nuestro ejemplo, deberá presionarse el botón "Importar" que se muestra en el catálogo "catalogitem".


Se presentara un pop-up desde el cual se deberá buscar el archivo catalogitem.catalog anteriormente generado y presionar el botón "Ejecutar importación del catálogo".


Luego de procesado el archivo podrá visualizarse la cantidad de registros procesados 

También podrá visualizarse un resumen de los registros importados presionando en la lupa que aparece a la derecha, en el mismo renglón de importación.


En la pantalla "Importación de catálogos" al seleccionar la lupa sobre un catálogo mostrará los primeros 25 registros del catálogo indicado. No mostrará paginado. Si hay más registros no se mostrarán en esta pantalla.


Los catálogos estándar que presenta Promo son los siguientes: 

(Pueden variar en base a si se dan de alta propiedades de los elementos que se carguen por catalogo, en este caso, se mostraran estos nuevos catálogos que apliquen para estas propiedades en la grilla para poder importar).

Se mostraran los catálogos para los 20 campos dinámicos destinados a los campos informativos de la cabecera:


Los catálogos de campos adicionales de la cabecera se presentaran con el siguiente identificador: Campo X adicional de la cabecera de la promoción (donde X representa el nro. del campo adicional que se estará importando. irán del 0 al 19)

El nombre del archivo a importar deberá tener el siguiente formato: catalogAdditionalFieldXX.catalog (donde X representa el nro. del campo adicional que se estará importando. irán del 00 al 19. Ejemplo catalogAdditionalField05.catalog )

El formato de los registros de este catálogo debe ser code|description


CampoTipo de datoObservaciones
codestringrequerido
descriptionstringrequerido


Ejemplo de registros del catalogo para los campos adicionales de la cabecera:

100|Dato A
101|Dato B
102|Dato C


Para poder visualizar correctamente los catálogos que se carguen para los atributos de la cabecera, deberán de habilitarse previamente los campos desde "Administración" >> "Atributos de la Cabecera"



El nombre del archivo a importar deberá tener el siguiente formato:  "card_timestamp.catalog" (Formato: card_DDMMAAAAhhmmss.catalog)

El formato de los registros de este catálogo debe ser Id|type|valid-from|valid-to|cvv|customer|amount|status


CampoTipo de datoObservaciones
codestringCódigo o nro. de elemento de fidelidad. Requerido
typestringTipo de elemento a la que pertenece el elemento de fidelidad. Requerido
validFromstringValido desde: Deberá completarse en caso de que el tipo de elemento al que pertenece el elemento a dar de alta indique que el "tipo de vencimiento" debe especificarse por "Rango de fechas". (Formato de la fecha AAAA-MM-DD)
validTostringValido hasta: Deberá completarse en caso de que el tipo de elemento al que pertenece el elemento a dar de alta indique que el "tipo de vencimiento" debe especificarse por "Rango de fechas". (Formato de la fecha AAAA-MM-DD)
cvvstringCódigo de validación. deberá completarse en caso de que el tipo del elemento al que pertenece el elemento a dar de alta indique "CVV requerido". (Campo numérico, largo máximo 5 dígitos)
customerstringCliente asociado al elemento. deberá completarse con el Código, que se puede ver en la pantalla "Gestión de Clientes".
amountstringMonto a asignar al elemento. Si su tipo indica que es precargada por archivo, este campo es requerido.
statusstringEstado del elemento. Los valores posibles para el status son: ENABLED (elemento activo), DISABLED (elemento inactivo). En caso que el campo sea vacío lo creará en estado inactivo.


Ejemplo de registros del catalogo para Elementos:

541400002201|541|2019-01-01|2029-12-31|520|9595|500|ENABLED
541400002202|541|2019-01-01|2029-12-31|363|9655|1500||
541400002203|541|2019-01-01|2029-12-31|218|1212|600|DISABLED



El nombre del archivo a importar deberá tener el siguiente formato: catalogBrand.catalog

El formato de los registros de este catálogo debe ser code|description


CampoTipo de datoObservaciones
codestringrequerido
descriptionstringrequerido


Ejemplo de registros del catalogo para Marca:

100|Marca A
101|Marca B
102|Marca C



El nombre del archivo a importar deberá tener el siguiente formato: catalogChannel.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Canal:

100|Canal A
101|Canal B
102|Canal C



Para la carga de los catálogos de País, Provincia y Ciudad, deberá respetarse un orden en la carga de estos tres catálogos ya que hay una dependencia entre ellos.

Primero deberá procesarse el catálogo de país (catalogCountry.catalog), después provincia/estado (catalogState.catalog), y al final ciudad (catalogCity.catalog).


El nombre del archivo a importar deberá tener el siguiente formato: catalogCountry.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para País:

100|Argentina
101|Brasil
102|Chile



El nombre del archivo a importar deberá tener el siguiente formato: catalogState.catalog

El formato de los registros de este catálogo debe ser code|name|country



CampoTipo de datoObservaciones
1codestringrequerido
2namestringrequerido
3statestring- Dependencia con el catalogo de País. Corresponderá al código definido en el catalogo de País relacionado.requerido


Ejemplo de registros del catalogo para Provincia/Estado:

200|BS.As|100
201|Neuquen|100
202|Chaco|100



El nombre del archivo a importar deberá tener el siguiente formato: catalogCity.catalog

El formato de los registros de este catálogo debe ser code|name|state


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido
statestring- Dependencia con el catalogo de Provincia. Corresponderá al código definido en el catalogo de Provincia relacionado.requerido


Ejemplo de registros del catalogo para Ciudad:

300|Ciudad A|200
301|Ciudad B|201
302|Ciudad C|201




El nombre del archivo a importar deberá tener el siguiente formato: catalogCreditCampaignCode.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Campaña Crediticia:

11|Campaña A
22|Campaña B
33|Campaña C



El nombre del archivo a importar deberá tener el siguiente formato: CatalogCurrencyCode.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Moneda:

10|Pesos
11|Dolares
12|Euros



En esta sección se detallaran las diferentes opciones disponibles para la importación del catálogo de clientes.


  • Validación de Catalogo de clientes

Para la carga del catálogo de clientes (catalogcustomer.catalog) podrá indicarse por configuración, que se valide la existencia previa de otros catálogos ya cargados para poder procesar el catálogo de clientes.

Este parámetro de configuración es:


Se validará la existencia de los catálogos relacionados al momento de la importación de clientes cuando su valor sea true. Para permitir un ingreso libre se debe especificar el valor false.

Los catálogos que se validarán al momento del procesamiento serán:

  • país (catalogCountry.catalog)
  • provincia (catalogState.catalog)
  • ciudad (catalogCity.catalog)
  • género (catalogGender.catalog)
  • tipo de identificación (catalogIdType.catalog)
  • tipo de clientes (catalogcustomertype.catalog)


Cuando el parámetro de configuración "validateRelatedEntities" esté en true, estos catálogos listados deberán estar cargados previamente, para poder realizar la carga del catálogo de clientes.


El nombre del archivo a importar deberá tener el siguiente formato: catalogGender.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Genero:

1|Fenemino
2|Masculino



El nombre del archivo a importar deberá tener el siguiente formato: catalogIdType.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Tipo de identificación de cliente:

01|CI
02|DNI
03|CPF
04|Otros



El nombre del archivo a importar deberá tener el siguiente formato: catalogCustomerType.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Tipo de cliente:

111|Consumidor Final
222|Empleado
333|Vip
444|Otros



El nombre del archivo a importar deberá tener el siguiente formato: catalogCustomer.catalog

El formato de los registros de este catálogo debe ser code|name|lastName|gender|birthDate|identificationType|identifier|identificationExpiration|nacionality|email|customerType|address|addressCcountry|addressState|addressCity|addressPostalCode|phone|isActive|segments|birthday|age|incompleteData


Los siguientes campos son de carga obligatoria para el correcto procesamiento del catalogo de clientes:

  • código (code)
  • nombre (name)
  • apellido (lastName)
  • tipo de cliente (customerType)
  • nro de identificador (identifier)
  • cumpleaños (birthday)
  • datos incompletos (incompleteData)


CampoTipo de datoObservaciones
codestringCorresponde al código que se le asignara al cliente en Promo. (requerido)
namestringNombre de cliente. (requerido)
lastNamestringApellido del cliente. (requerido)
genderstringGenero del cliente (en caso de "Validar catálogos relacionados al catálogo de clientes" este en "true", el dato definido en este campo deberá coincidir con alguno de los códigos de género "catalogGender.catalog" previamente cargados.)
birthDatestringFecha de nacimiento del cliente. Formato: año-mes-día siendo el año de cuatro dígitos, y el mes y el día de dos dígitos
identificationTypestringTipo de identificación del cliente. (en caso de "Validar catálogos relacionados al catálogo de clientes" este en "true", el dato definido en este campo deberá coincidir con alguno de los códigos de tipo de identificación "catalogIdType.catalog" previamente cargados.) requerido
identifierstringNumero de identificación del cliente. (requerido)
identificationExpirationstringFecha de expiración de la identificación del cliente.
nacionalitystringNacionalidad del cliente
emailstringe-Mail del cliente.
customerTypestringTipo de cliente (requerido) / / (en caso de "Validar catálogos relacionados al catálogo de clientes" este en "true", el dato definido en este campo deberá coincidir con alguno de los códigos de tipo cliente "catalogIdType.catalog" previamente cargados.)
addressstringDirección del cliente.
addressCountry
stringPaís del cliente. (en caso de "Validar catálogos relacionados al catálogo de clientes" este en "true", el dato definido en este campo deberá coincidir con alguno de los códigos de Pais "catalogCoutry.catalog" previamente cargados.)
addressStatestringProvincia de residencia del cliente. (en caso de "Validar catálogos relacionados al catálogo de clientes" este en "true", el dato definido en este campo deberá coincidir con alguno de los códigos de Provincia "catalogState.catalog" previamente cargados.)
addressCitystringCiudad de residencia del cliente. (en caso de "Validar catálogos relacionados al catálogo de clientes" este en "true", el dato definido en este campo deberá coincidir con alguno de los códigos de Ciudad "catalogCity.catalog" previamente cargados.)
addressPostalCodestringCódigo Postal
phonestringTeléfono
isActivebooleanoIndicara si al momento del alta el cliente estará Activo o Inactivo. Deberá definirse como true o false.
segmentsstringSegmento/s asociado al cliente
birthdaybooleano

Indica que el cliente está cumpliendo años. Valores permitidos: true o false. (requerido)

ageinteger

Indica la edad del cliente. Permite solo valores numéricos sin decimales. 

incompleteDatabooleano

Indica que los datos del cliente están incompletos. Valores permitidos: true o false. (requerido)


Ejemplo de registros del catalogo para Cliente:

1|Juan|Perez|h|1900-10-25|dni|12345|2050-10-10|arg|[email protected]|EMPLEADO|calle 1|arg|bsas|tig|1|1555555555|true||false||false
2|Sofia|Gonzalez|m|1950-05-05|le|222233|2060-06-06|br|[email protected]|FRECUENTE|calle 2|arg|bsas|tig|2|1566666666|true||false||false
3|Jose|Torres|h|1960-06-06|dni|654321|2100-04-05|arg|[email protected]|EMPLEADO|calle 7|arg|bsas|tig|3|1522222222|true||false||false
4|Lucia|Perez|m|1983-01-10|dni|222222|2054-10-10|arg|[email protected]|EMPLEADO|calle 1|arg|bsas|tig|1|1666666666|true||false||false
5|Pablo|Gomez|h|1980-01-10|dni|333333|2053-10-10|arg|[email protected]|FRECUENTE|calle 3|arg|bsas|tig|1|1777777777|true||false||false
6|Ana|Maciel|m|1970-01-10|dni|444444|2052-10-10|arg|[email protected]|EMPLEADO|calle 4|arg|bsas|tig|1|1888888888|true||false||false
7|Lucas|Di Giacomo|h|1901-01-10|dni|555555|2051-10-10|arg|[email protected]|EMPLEADO|calle 5|arg|bsas|tig|1|1999999999|true||false||false
8|Maria|Suarez|m|1970-11-27|dni|22675480|2050-10-10|arg|[email protected]|EMPLEADO|Aguero 3500|arg|bsas|caba|1540|1577668545|true||false||false


La funcionalidad de Importación de Catálogos de Clientes en PROMO permite la carga masiva de clientes desde archivos externos, lo que facilita la gestión y actualización de datos en el sistema. Con la introducción de los Clientes de registro básico, esta funcionalidad se ha adaptado para garantizar que los clientes creados con información mínima (solo DNI) sean correctamente manejados durante la importación. Ver: CONFIGURACIONES PARA EL ALTA DE CLIENTE DE REGISTRO BÁSICO (pre-fidelizado)


Consideraciones a tener en cuenta para el Registro de cliente básico:

Cuando está habilitada la funcionalidad de Clientes de registro básico, la importación de catálogos de clientes en PROMO sigue estos principios:

  • Opción de No Borrar Clientes Existentes: Es esencial activar la opción "No borrar los existentes" durante la importación de catálogos para evitar la eliminación accidental de clientes registrados previamente con datos mínimos. Ver: Información de Configuración - CONSOLA DE PROMO
  • Actualización Progresiva: Si un cliente básico aparece en el catálogo de importación con datos adicionales, PROMO actualizará solo los campos nuevos, completando la información del cliente de forma progresiva. Los campos ya existentes no se verán afectados.






El nombre del archivo a importar deberá tener el siguiente formato: catalogDepartment.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Departamento:

111|Blancos
222|Frescos
333|Limpieza
444|Almacen



El nombre del archivo a importar deberá tener el siguiente formato: catalogEventTransaction.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Evento:

50|Evento 1
51|Evento 2
52|Evento 3
53|Evento 4



El nombre del archivo a importar deberá tener el siguiente formato: catalogEventTransactionType.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Tipo de Transacción:

101|Venta
202|Devolucion



El nombre del archivo a importar deberá tener el siguiente formato: catalogFamily.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Familia:

111|Lacteos
222|verduras
333|Frutas



El nombre del archivo a importar deberá tener el siguiente formato: catalogCategory.catalog

El formato de los registros de este catálogo debe ser code|name|familyCode


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido
familyCodestring - Dependencia con el catalogo de Familia. Corresponderá al código definido en el catalogo de Familia relacionado.


Ejemplo de registros del catalogo para Categoría:

100|Categoria A|111
101|Categoria B|222
102|Categoria C|222



El nombre del archivo a importar deberá tener el siguiente formato: catalogSubCategory.catalog

El formato de los registros de este catálogo debe ser code|name|categoryCode


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido
categoryCodestring - Dependencia con el catalogo de Categoría. Podrá corresponderá al código definido en el catalogo de Categoría relacionado.


Ejemplo de registros del catalogo para Sub Categoría:

222|SubCategoria A|100
333|SubCategoria B|100
444|SubCategoria C|102



El nombre del archivo a importar deberá tener el siguiente formato: catalogFormat.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Formato:

111|Formato A
222|Formato B
333|Formato C



El nombre del archivo a importar deberá tener el siguiente formato: catalogItem.catalog

El formato de los registros de este catálogo debe ser code|name|unitprice|level1|level2|level3|level4|supplier|brand|detail|detail2


CampoTipo de datoObservaciones
codestringCódigo SKU del Producto (requerido)
namestringNombre del producto (requerido)
unitpricenuméricoPrecio Unitario del producto
level1stringDepartamento del producto
level2stringFamilia del producto
level3stringCategoría del producto
level4stringSub Categoría del producto
supplierstringProveedor del producto
brandstringMarca del producto
detail1stringDetalle
detail2stringDetalle 2


Ejemplo de registros del catalogo para Ítems:

11020|producto 1|1050|Dto1|flia1|Cat11|SubCat12|Prov21|Marca1||Det2
11021|producto 2|2000|Dto2|flia2|Cat12|SubCat13|Prov21|Marca1|Det1|
11022|producto 3|500|Dto1|flia1|Cat13|SubCat14|Prov21|Marca1|Det1|Det2
11023|producto 4|50200|Dto1|flia2|Cat14|SubCat15|Prov21|Marca1||
11025|producto 5|10540|Dto3|flia1|Cat15|SubCat11|Prov21|Marca1||Det2
25250|producto 6|980|Dto1|flia2|Cat16|SubCat12|Prov21|Marca1||
25251|producto 7|31500|Dto1|flia1|Cat17|SubCat13|Prov21|Marca1||Det2
25252|producto 8|456|Dto2|flia1|Cat18|SubCat14|Prov21|Marca1||
25253|producto 9|887|Dto1|flia1|Cat19|SubCat15|Prov21|Marca1|Det1|Det2


El catálogo de ítems es el único catálogo que soporta por consola, es decir por archivo, la importación del mismo con atributos dinámicos para el elemento producto.

Si el usuario agregó atributos dinámicos de elementos para el elemento Producto, por ej. los atributos dinámicos: m1 y m2, el formato del catálogo de ítems a subir será:

el formato base ya detallado arriba + los atributos dinámicos creados:

code|name|unitprice|level1|level2|level3|level4|supplier|brand|detail|detail2|m1|m2


 Nota:

Para distinguir cuales son los atributos dinámicos que debe agregar en el catálogo de ítems a importar (son los que agregó el usuario) también puede distinguirlos en la página "Gestión de atributos de elementos" filtrando por elemento "Productos" y estado "Activa", serán los que muestren el botón "Editar" no grisado.



El nombre del archivo a importar deberá tener el siguiente formato: catalogPaymentBank.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Banco:

10|banco A
11|banco B
12|banco C



El nombre del archivo a importar deberá tener el siguiente formato: catalogPaymentCode.catalog

El formato de los registros de este catálogo debe ser code|name|codeType


CampoTipo de datoObservaciones
codestringrequerido (no puede estar en blanco)
namestringrequerido (no puede estar en blanco)
codeTypestringno requerido


Ejemplo de registros del catalogo para Pago:

10|pago A|PA
12|pago C|PC



El nombre del archivo a importar deberá tener el siguiente formato: catalogPaymentPrefix.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Prefijo:

10|Pref A
11|Pref B
12|Pref C



El nombre del archivo a importar deberá tener el siguiente formato: catalogPaymentType.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Tipo de Pago:

10|efectivo
11|tarjeta
12|otros



El nombre del archivo a importar deberá tener el siguiente formato: catalogPocket.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Bolsillo:

10|Bolsillo 1
11|Bolsillo 2
12|Bolsillo 3



El nombre del archivo a importar deberá tener el siguiente formato: catalogProfileCode.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Perfil de Cliente:

10|Perfil 1
11|Perfil 2
12|Perfil 3



El nombre del archivo a importar deberá tener el siguiente formato: catalogStoreChain.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Cadena:

10|Cadena 1
11|Cadena 2
12|Cadena 3



El nombre del archivo a importar deberá tener el siguiente formato: catalogSupplier.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Proveedor:

10|Proveedor 1
11|Proveedor 2
12|Proveedor 3



El nombre del archivo a importar deberá tener el siguiente formato: catalogZone.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Zona:

10|Zona 1
11|Zona 2
12|Zona 3



El nombre del archivo a importar deberá tener el siguiente formato: catalogSubZone.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Sub Zona:

10|Sub Zona 1
11|Sub Zona 2
12|Sub Zona 3



El nombre del archivo a importar deberá tener el siguiente formato: catalogRedeemBenefit.catalog

El formato de los registros de este catálogo debe ser store|code|points|discountValue|discountType


CampoTipo de datoObservaciones
storestringCódigo de tienda. Requerido -  Si se aplica a todas las tiendas, el código de la tienda debe ser "-".
codestringCódigo del producto. Requerido.
pointsNumérico con decimales.Puntos requeridos.
discountValueNumérico con decimales.Valor descuento.
discountTypestringTipo descuento. Requerido. Acepta sólo los valores "perc" (porcentaje), "fix" (descuento fijo), o bien, "nprice" (nuevo precio)


Ejemplo de registros del catalogo para Canje de Puntos:

b320|1000|100|10|perc
-|3000|30|5|perc
b320|2000|60|27|fix
a922|1001|80|1500|fix
b320|1002|70|487.89|nprice



El nombre del archivo a importar deberá tener el siguiente formato: catalogProductCode.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido

Ejemplo de registros del catalogo para Código de Producto:

1|lapicera
2|lápiz
3|goma
4|televisión



El nombre del archivo a importar deberá tener el siguiente formato: catalogProductBarcode.catalog

El formato de los registros de este catálogo debe ser code|name


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido

Ejemplo de registros del catalogo para Código de Barras de Producto:

1000177|yerba 
1000178|azúcar 
1000179|café 
1000180|te




El nombre del archivo a importar deberá tener el siguiente formato: catalogBalance.catalog

El formato de los registros de este catálogo debe ser id|descripcion

CampoTipo de datoObservaciones
idnumericrequerido
descripcionstringrequerido

Ejemplo de registros del catalogo para Balance:

1|Balance1




Promo podrá recibir actualizaciones de catálogos por medio de la cola Rabbit MQ que se haya configurado para tal fin. El estado de este proceso podrá visualizarse en la sección "Monitor de Importaciones" en la consola de Promo.

(Para mas información sobre la configuración en consola de Promo ver Administración > Información de configuración en este mismo documento.)

(Para mas información sobre el proceso y datos de la integración con las colas RabbitMQ ver Manual de Integración Promo)


Se puede importar un atributo de elemento sólo para el catálogo de Productos; para los otros catálogos no es posible.

Cuando se agrega un atributo de elemento; éste campo debe agregarse al archivo .catalog ( en éste caso, catalogItem.catalog), que se usará para importar dicho elemento. Puede tener un valor o puede estar vacío.

Ejemplo:

 Se agrega un atributo color al Producto:


En el archivo .catalog:

11020|producto 1|1050|Dto1|flia1|Cat11|SubCat12|Prov21|Marca1||Det2|verde

Al importarlo en la consola, la operación se ha realizado con éxito:



Tareas Programadas

En esta sección se podrá configurar la frecuencia con que se ejecutaran distintos procesos que tiene como fin el mantenimiento de los datos manejados desde la consola.

Los procesos disponibles son:

Este job se debe ejecutar cada vez que se crea un nuevo evento.


El Job que informa el estado de la Consola y Motor, por defecto se ejecutará cada 5 minutos, pudiendo modificar el tiempo de ejecución desde Administración ->Tareas programadas.: (ingresando con el usuario principal):


Ingresando en la consola de Promo con el usuario administrador, la siguiente configuración debe ser mayor a la definida en el job (imagen anterior). Por ejemplo configurar el doble de tiempo:





Esta funcionalidad sólo estará disponible para aquellos usuarios que tengan configurados los permisos correspondientes.


Información de configuración

Existen parámetros de configuración que pueden ser modificados para personalizar el comportamiento de PROMO. Estos parámetros se encuentran en la Consola de PROMO, Menú "Administración" >> "Información de Configuración" y el detalle de los campos se encuentra en: 

                         Promo 7.4 - Manual de Instalación 7.4 - Información de Configuración


Importación de Promociones

PROMO facilita la herramienta de importación de promociones dentro de la consola para agilizar los procesos de actualización ante alguna actualización de versiones o necesidad de regenerar datos.

Por medio de esta herramienta, podrán cargarse de manera masiva promociones que se encuentren en mapas que fueron generados con versiones de consola de PROMO anteriores, así como también generadas por una misma versión pero desde otra consola.

Al presionar el "Importación de Promociones" del menú "Administración" se presentara la siguiente pantalla:


Los mapas con las promociones que se quieren importar a, por ejemplo, una nueva consola, deberán guardarse en el directorio C:\compañía\promo\import

Una vez que los mapas se encuentren en dicho directorio, se mostrara en la lista de importación de promociones, mostrándose los datos del nombre, directorio y fecha del mapa que se está por importar.

Al presionar el botón "Importar Promociones", se procesarán los mapas de la lista y se mostrará un mensaje por pantalla que informará si la operación ha sido exitosa o no.


Al importar un mapa que contenga Promociones con tipo, sub tipo y forma de aplicación, estos campos de la promoción se importarán ya que son propiedad del mapa.


Podrán verse en la solapa de "Resultados" los mapas procesados y para cada uno de ellos la cantidad de promociones importadas satisfactoriamente y la cantidad de promociones que no se importaron de ese mismo mapa por algún error de conformación.


Presionando "Ver más" a la derecha de cada mapa importado podrá visualizarse el nombre de cada promoción importada, el estado y en caso de que se diera un error en la importación de alguna promoción, el mensaje de error que deberá ser enviado a los especialistas de soporte para su interpretación, junto con el mapa que contiene la promoción que fallo.

Al importar un mapa que contenga Promociones con tipo, sub tipo y forma de aplicación, estos campos de la promoción se importaran ya que son propiedad del mapa.

Solo se pueden importar condiciones generales por archivo xml cuando se realiza la importación de promociones por xml.

Al importar un mapa que contenga Promociones con Propiedades de Beneficios; éstas deben existir en la consola; caso contrario en la consola la promoción importada no lo mostrará.


Al importar una promoción se debe tener en cuenta el workflow asociado al usuario que está llevando a cabo la importación.

  1. Si el usuario no tiene asociado un workflow (en la vista Administración de Usuarios/Asociación a workflows), o sea no tiene tildado ningún checkbox :

la promoción se importará con el workflow general.

2. El usuario tiene asociado varios workflows, excepto el general

la promoción se importará con el primer workflow de la lista, ordenado alfabéticamente

3. El usuario tiene asociado todos los workflows definidos en la consola:

la promoción se importará con el workflow general

 4. Un usuario sólo verá en la vista "Gestión de Promociones" todas las promociones importadas que contengan  workflows asociados al usuario.


Motivos de modificación de saldos

En caso de que se requiera realizar una modificación de saldo de un elemento desde la consola de Promo será necesario indicar el motivo o causal que derivo en dicha modificación, ya se de suma o de quita de saldos.

Primero será requisito dar de alta el motive de modificación de saldo, accediendo a la sección Administración>> "Motivos de Modificación de saldos" y se presentará la siguiente pantalla desde la cual podrán gestionarse los distintos motivos de modificación de saldo dados de alta.


Presionando en "Nuevo" podrá generarse un nuevo motivo, indicando los siguientes datos: 


Generado ya los motivos, al momento de realizar la modificación de saldo de una elemento de fidelidad, podrán seleccionarse del combo "Motivos" los distintos motivos de modificación de saldo dados de alta:

También será requerido el ingreso de los siguientes datos para identificar correctamente la modificación de saldo desde la consola de Promo:



Registro de Auditorías


                                              

Esta vista permite la consulta de los registros de auditoría de datos asociados a los distintos módulos de Promo; donde se indican los detalles informativos de los cambios(creación/edición/eliminación) aplicados por los usuarios. Se puede acceder a través de la sección Administración>>"Registros de Auditoría".

PROMO permite llevar un control de auditorias filtrando por:                                           

Fecha Desde: Fecha de inicio de búsqueda. Por defecto indicará 7 días hacia atrás a partir del día actual.

Fecha Hasta: Fecha final de búsqueda. Por defecto indicará el día actual.

Código: Corresponde al código del registro relacionado al módulo seleccionado.

Por ejemplo:

Si se selecciona Módulo -> Cupones, en el campo Código deberá indicar el código de algún cupón.

Si el módulo seleccionado es Promociones, se podrá filtrar por código de promoción si lo está utilizando y como resultado mostrará aquellas promociones que se hayan creado o modificado en el período de tiempo seleccionado."

Usuario: Nombre del usuario quien realizó el cambio.

Módulo: Lista de funcionalidades auditables en promo.

Operación: Listado de operaciones realizadas sobre los registros.

Para la búsqueda y navegación de la vista se debe ir a Paginado.

Tiene disponible los botones:

Cuando se ejecuta el proceso de Depuración de Promociones; este se verá reflejando como

                               

Como resultado de la búsqueda realizada se podrán visualizar las acciones ejecutadas por los distintos usuarios de la consola de promociones, pudiendo acceder al detalle de cada acción por medio del icono que se encuentra al final de cada línea. En el detalle se podrán ver los Rangos de Prefijos cargados desde Tipo de Elementos de Fidelidad.


   Detalles del registro de auditoría 

   El usuario podrá visualizar toda la información de cada registro de auditoría, presionando el botón ubicado a la derecha de cada registro en la grilla de datos. El usuario visualizará la siguiente información:


Nombre y Apellido: del usuario quien realizó el cambio sobre el registro.

Operación: acción ejecutada por el usuario (Insert, Update o Remove)

Fecha: indica fecha y hora en que se llevó a cabo la acción

Botones con Listado de Fechas: donde se aplicaron cambios, ésta sección le permitirá navegar entre las versiones de cambios realizadas en una fecha específica. 


                                                                                                        

                                       

                                  


  Ejemplo de Update:

                                      

Para los Workflows

Cuando se crea un workflow tiene que aparecer la acción como CREATE y cuando se envía a autorizar la acción será PROCESS. 

Cuando la acción es PROCESS, el detalle de que el workflow haya sido aprobado o rechazado se mostrará dentro del detalle  en "Pasos".


Para ubicar correctamente las auditorias registradas para el Programa de objetivos, deberá seleccionar en Módulos la opción "Programa de objetivos" y realizar la búsqueda. Una vez realizada la búsqueda se podrá ubicar en el registro requerido y visualizar la siguiente información:

En el detalle:

Para el tipo de Programa de objetivos "Basado en Monto de Compra", cuando un cliente es agregado a un segmento de manera manual; el log debe decir: "El cliente código (muestra código del cliente)de la compañía (muestra compañía del cliente), se eliminará del segmento code (muestra código del segmento), del prog, de obj (muestra nombre del programa de objetivos)."



Para seleccionar los registros correspondientes a Eventos, se debe seleccionar en el filtro de Módulo, el valor Eventos


La aplicación desplegará:

para ver el detalle se debe clickear y la aplicación desplegará la vista:



 El módulo "PromotionConditionBase" al entrar para ver su detalle, debajo de Código y Estado se muestran: Tipo, Subtipo y Forma de Aplicación.


Operación RABBIT_RESEND:

La operación: "RABBIT_RESEND" indica el reenvío de transacciones a las colas RabbitMQ.

En "Nombre y Apellido" muestra el usuario que realizó la operación de reenvío (desde Soporte\ Panel de Colas de Mensajes\ Transacciones).

En "Fecha de reenvío" muestra el momento en que se pidió reenviar la transacción.

En "Período de fechas elegido" muestra el rango de fechas Desde y Hasta y hora Desde y Hasta que se seleccionó en pantalla.

"Se reenviaron" muestra la cantidad de transacciones reenviadas en el período seleccionado. Si no hubo transacciones en ese período se mostrará 0.




Propiedades del Beneficios

Desde esta opción de administración se podrán crear distintos atributos informativos para cada clase de beneficio que serán informadas en el beneficio cuando este sea aplicado.

Se encuentra disponible en menú principal >> Administración> “Propiedades de Beneficios”.


Al seleccionar “Propiedades de Beneficios” mostrará una pantalla con ese nombre, donde se verán los filtros: “Nombre”, “Clase de Beneficio” y “Estado”. Debajo se verá un listado de Propiedades con las columnas: “Activa”, “Código”, “Nombre”, “Descripción”, “Clase de beneficio”, “Tipo”, “Es requerido”. 

Al ingresar a “Propiedades de Beneficios” filtra automáticamente por el primer valor que encuentre en el filtro “Clase de Beneficio”. Por ejemplo va a autofiltrar por  “Canje de Cupón Calculado” por default, porque es el primer valor que encuentra.

A la derecha de los filtros está el botón Lupa (para comenzar la búsqueda) y la x (para borrar los filtros seleccionados). Para realizar otra búsqueda presionar la x para borrar los filtros, luego seleccionar el filtro deseado y después el botón Lupa. A la derecha de cada Propiedad se encuentra el botón “Edición”.

Como el sistema va a estar autofiltrando siempre por el primer dato que encuentra, al presionar la x seguirá realizando este autofiltrado. Si se desea ver el listado completo sin filtrar por el campo "Clase de Beneficio", debe seleccionarse el combo seleccionable de este campo y seleccionar la primer opción: "[Clase de beneficio]" y luego presionar la lupa.

Debajo del listado de propiedades a la izquierda se encuentra el botón “Nuevo”, con el cual se abre la pantalla “Nueva propiedad de beneficio”, desde donde se puede crear una nueva propiedad.


Nueva Propiedad de Beneficio: 


Detalle de los campos: 




Editar Propiedad de Beneficio: 

Detalle de los campos: 


Propiedad del beneficio auto-completada por catalogo

Cuando se defina una nueva propiedad para un beneficio o se edite una existente, podrá indicarse que ésta propiedad será auto-completada por catalogo, pudiendo en ese momento, indicar si se reutilizara un catalogo existente o si se crear un nuevo catálogo dinámico (el formato del nuevo catalogo que se generará en caso de usar esta opción será, catalogbenefit[código del atributo].catalog. Por ej. catalogbenefitcolour.catalog)


> Selección del catalogo:


Aplicación de una Nueva Propiedad de Beneficio:

Al crear una Nueva Promoción, desde: “Operación”, botón “Nueva Promoción”, primero se ingresan los datos de la nueva promoción y se presiona el botón Guardar. Luego en la pantalla siguiente (Definir Promoción), en la sección “Beneficios a otorgar”, al seleccionar el botón “Nuevo Beneficio” abre la pantalla “Nuevo beneficio”. Para cargar los beneficios a otorgar en esa promoción. Si la “Clase de beneficio” seleccionada tiene asociada una nueva propiedad, al seleccionar esa clase de beneficio, en este ej: “Canje de Cupón Calculado”, mostrará debajo de ese campo los nuevos campos, en este ej: “color”.

Una vez guardado el nuevo beneficio de la promoción, si se selecciona: Operación > Promociones, botón “Acciones”, al seleccionar “Definir”. Mostrará la nueva propiedad de beneficio como parte de la "Definición Principal" del beneficio:

Las promociones existentes no se ven afectadas por los cambios en las propiedades de beneficios.

Si una nueva propiedad de un beneficio ya está siendo utilizada y se deshabilita: se mantiene en las promociones que la utilizan hasta el momento de guardar una edición del beneficio que la contenía.



Atributos de elementos

Esta opción se utiliza para gestionar desde la consola de PROMO los atributos de todos los elementos disponibles al momento de dar de alta promociones desde la consola de PROMO.


La administración de Atributos dinámicos se realiza ingresando a la consola de PROMO PRINCIPAL con el Usuario Principal.

Desde allí podrán darse de alta nuevos atributos para todas las compañías que estén presentes en la consola.

Podrá habilitarse la "Gestión de Atributos de los Elementos" para una una compañía, solo cuando ésta no comparta la instalación de Promo con otra compañía en un mismo servidor.

Si el Usuario Principal habilita la "Gestión de Atributos de Elementos", el usuario con el rol al que se le hayan asignado los permisos, podrá ver y gestionar desde la consola de Promo los "Atributos de Elementos" dentro del menú Administración.

El usuario con el rol habilitado para la gestión de atributos de los elementos podrá definir y o editar nuevos atributos para todos los el elemento presentes en Promo. Los atributos propios de Promo no podrán ser editados.


Nuevo Atributo: 

Cuando se desee dar de alta un nuevo atributo para alguno de los elementos de Promo, deberá darse hacerse clic en el botón "Nuevo" y se mostrara la siguiente pantalla:


Cuando se procesa al alta de una promoción luego del alta o edición de un atributo dinámico que es de carácter obligatorio, si este atributo no se carga a la promoción se mostrara como  incompleta y al posicionarse sobre la leyenda "Incompleta" deberá de mostrarse el mensaje que indique que atributo es requerido para dar por completa la promoción.


Desde el menú,  Administración >> Importación se mostrará, luego de dado de alta un nuevo atributo, una nueva opción que permitirá seleccionar y procesar un catálogo que asociará datos al atributo recientemente generado.

Aquí, a modo de ejemplo, se dará de alta el nuevo atributo "color". Deberá procesarse el archivo "catalogColor.catalog", dando clic en el botón "Importar".

Podrá visualizarse el detalle del catálogo procesado, dando clic en la "lupa" que aparece a la derecha, al final del renglón.


No se podrán importar catálogos de Clientes, Medios de Pago ni Eventos con atributos de elementos por consola; solamente catálogos de Productos.




Podrá procesarse el catálogo asociado a un nuevo atributo por medio del proceso de "Importación de Catálogos" (sts.console.job.CatalogJob). Para ello será requerido setear, desde la compañía en la que se está logueado, el path desde el cual deberán tomarse los archivos .catalog para ser procesados.

Esto se realiza desde Administración >> Información de configuración. por default, el path seteado será C:/synthesis/promo/catalogs/"compañía"

Podrá utilizarse el path por default o bien editarlo y colocar allí la ruta donde serán alojados los archivos .catalog a procesar.

El proceso correrá cada una determinada cantidad de tiempo y buscará en dicho directorio los archivos .catalog que se hayan dejado allí  y los procesará. Los nuevos catálogos que correspondan a nuevos atributos deberán ser procesados de la misma forma que los catálogos actuales.


Generación, distribución y descarga de archivo de definición de nuevos atributos:

Cuando al menos se haya dado de alta un nuevo atributo para alguno de los elementos de la consola se habilitará el botón "Descargar Archivo de Definición"

Este archivo contendrá la definición de todos los nuevos atributos dados de alta hasta ese momento.

También será posible desde esta ventana, distribuir el archivo de definición "entities.xml" a los motores conectados a la consola cuando se haya realizado alguna modificación en alguno de los nuevos atributos, presionando en el botón "Distribuir archivo de definición".

Para que los  motores tomen correctamente los cambios en el archivo "entities.xml" será necesario reiniciarlos.

Una vez terminado el proceso de distribución o descarga, se mostrará el mensaje habitual en verde indicando que la operación finalizó satisfactoriamente. Caso contrario, informará del error en el habitual popUp Rojo y logueará el mensaje de error en el log de la consola dando detalles de lo sucedido.


Botón distribuir archivo de definición

Este botón se habilitará cuando se edite alguno de los atributos dinámicos dados de alta. Al presionarlo se distribuirá el archivo entities.xml a todos los motores conectados a la consola desde la que se hace la distribución; excepto a los motores de simulación.

Para ello, una vez creado el nuevo atributo se debe descargar el archivo de definición

 

y pegarlo en la ruta del motor de simulación:

Para que el nuevo atributo sea considerado en las transacciones. Si no se realiza esto, al hacer la devolución, ésta quedará en COMMIT_PENDING.


Validación de atributo entre elementos:

Se puede definir que al momento de dar de alta una promoción, al ingresar una condición por el elemento "producto", atributo "SKU", se valide que en la estructura de éste, se encuentre definido otro atributo, Por lo que cuando se ingrese como condición el "Código - SKU" se requerirá el ingrese de el o los atributo asociados así como también se validara que el o los atributos asociados estén definidos en la estructura del "Código-SKU". Para que Promo realice esta validación deben realizarse las siguientes configuraciones:


Cuando se seleccione alguno de los atributos del elemento producto, quedará configurada la validación del código (SKU) contra el o los atributos indicados en el campo "Valida contra atributo".

Al presionar editar, en el atributo "Código - SKU", se mostrará la siguiente pantalla: 


Tanto el Elemento Código (SKU) como el atributo relacionado deberán estar cargados por catalogo.

El catalogo de ítems que contenga atributos dinámicos utilizados en esta validación deberán ser cargados vía Servicio Rest o Cola Rabbit MQ para que la validación sea realizada correctamente (Ver Promo - Manual de Integración - Servicios)



Tipo de Promociones

Desde la pantalla "Gestión de Tipos de promociones" que se encuentra en el menú Administración, se podrá crear un nuevo Tipo de promoción, editarla y ver Promociones Asociadas a ese tipo.

La pantalla contará con los siguientes filtros:

Las columnas que se presentarán en la pantalla serán:

Se dispondrá de un botón "Nuevo", desde el cual se accederá a la pantalla "Nuevo tipo de promociones" y se podrán dar de alta nuevos tipos de promoción. 

Para el alta de un nuevo tipo de promociones deberán completarse los siguientes campos:

Siempre existirán un solo tipo de promoción por defecto, este será "General" hasta tanto el operador no de de alta un nuevo tipo de promoción con el check "por defecto" activo.

Al presionar "Guardar" se agregará a la grilla de la pantalla de "Gestión de tipos de Promociones" una nueva línea con el tipo de promociones recién creado. En caso de presionarse "Cancelar" no se registrará ningún dato en la base y se volverá a la pantalla de "Gestión de tipos de Promociones" sin haber hecho cambios.

En la pantalla "Gestión de Tipos de Promociones" se contará con el botón "Acciones" desde el cual se podrá:

Si el Tipo de Promoción no está asociado a ninguna promoción, la opción de "Promociones Asociadas" del menú <Acciones> se mostrará deshabilitado.


Sub-tipo de promociones

Al seleccionar "Sub-Tipos de promociones" se presentará la pantalla "Gestión de Sub-Tipos de promociones"

La pantalla contará con los siguientes filtros:

Las columnas que se presentarán en la pantalla serán:

Se dispondrá de un botón "Nuevo", desde el cual se accederá a la pantalla "Nuevo sub-tipo de Promociones" y se podrán dar de alta nuevos sub-tipos de promociones. 

Cuando se dé de alta un subtipo de Promoción, se mostrará por default, en el campo "tipo de promoción" el valor indicado por defecto.

Aquí también podrá indicarse si el valor definido para el sub-tipo de promoción será el valor por defecto que se se mostrará automáticamente al momento de dar de alta una promoción.

Para el alta de un nuevo sub-tipo de promociones deberán completarse los siguientes campos:

Siempre existirán un solo Sub-tipo de promoción por defecto por tipo de promoción, hasta tanto el operador no de de alta un nuevo sub-tipo de promoción con el check "por defecto" activo.

Al presionar en "Guardar" se mostrará el sub-tipo de promoción recién creado en la grilla de la pantalla de "Gestión de Sub-Tipos de promociones"

Desde el botón de Acciones podrá:

Si el Sub-Tipo de Promoción no está asociado a ninguna promoción, la opción de "Promociones Asociadas" del menú <Acciones> se mostrará deshabilitado.

Formas de aplicación de promociones

Al dar clic en "Forma de Aplicación de promociones" se presentará la pantalla "Gestión de Forma de Aplicación"

La pantalla contará con los siguientes filtros:

Las columnas que se presentarán en la pantalla serán:

Se dispondrá de un botón "Nuevo", desde el cual se accederá a la pantalla "Nueva Forma de aplicación de Promociones" y se podrán dar de alta nueva forma de aplicación de promociones. 

Cuando se dé de alta una forma de aplicación, se mostrará por default, en los campos "tipo de promoción" y "Sub-Tipo de Promoción" los valores  indicados por defecto.

Aquí también podrá indicarse si el valor definido para la forma de aplicación será el valor por defecto que se mostrará automáticamente al momento de dar de alta una promoción.

Para el alta de una nueva forma de aplicación de promociones deberán completarse los siguientes campos:


Siempre existirán una sola forma de aplicación de la promoción por defecto por sub-tipo de promoción, hasta tanto el operador no de de alta una nueva forma de aplicaron con el check "por defecto" activo.

Al presionar en "Guardar" se mostrará la forma de aplicación de promoción recién creado en la grilla de la pantalla de "Gestión de Formas de Aplicación de promociones"

Desde el botón de "Acciones" podrá:


Plantillas de Mapas

Se dispone en Opciones de Menú, dentro de <Administración>, la opción "Plantillas de Mapas" desde la cual, podrán definirse templates, utilizando los tipos, subtipos y forma de aplicación de promociones anteriormente dados de alta. Este template deberá seleccionarse al momento de distribuir un mapa. 

Al dar clic en "Plantillas de Mapas" se presentará la pantalla "Gestión de Plantillas de Mapa".


Al presionar en "Nuevo" se mostrará la pantalla "Nueva Plantilla de Mapa" donde se definirá el Código y Nombre de la plantilla y modo en que operará la sugerencia en los mapas que se generen a partir de esa plantilla. 


En caso de Editar una plantilla de mapa existente, no podrá cambiarse el código. 

Al presionar "Guardar", se pasará a la pantalla de "Definir Plantilla de Mapa". En caso de que se presione "Cancelar" se volverá a la pantalla de "Gestión de plantillas de mapas", sin haber guardado ningún cambio. En la pantalla Definir Plantilla de Mapa  se presentarán las Formas de Aplicación de promociones definidos anteriormente y deberán poder arrastrarse para armar la estructura de pasos y funciones de convivencias, para luego agregar las formas de aplicación de promociones que se hayan definido.

Se arrastrarán primero los pasos y luego las funciones de convivencia. Luego se agregarán las Formas de Aplicación de promociones según el orden en que deban ser evaluadas.

Hasta que la plantilla no tenga al menos un paso, una función de convivencia y un sub-tipo de promoción, no estará "Completa" y no podrá ser utilizada para generar un mapa a partir de ella.

Al definir una plantilla de mapa será posible continuar desde allí con la generación del mapa a partir de la plantilla que se está dando de alta.

Cuando la plantilla de mapa se encuentre en estado "Completa", se habilitará el botón "Generar Mapa".

Al presionar el botón "Generar Mapa", pasará a la pantalla "Publicación Mapa (POS)"

Si la Plantilla de Mapa se encuentra "Incompleta" la opción "Generar Mapa" se encontrará deshabilitada.


PopUp del resumen de una plantilla de mapas.

Una vez definida la plantilla, se podrá presionar "Volver" para regresar a la pantalla de "Gestión de plantillas de mapas", y visualizar la plantilla recién creada en la grilla.

Por pantalla se mostrarán cómo máximo 25 líneas en la grilla. Si hay mas de 25 líneas a mostrar se habilitará la paginación.


Distribución de Mapas Programada

El proceso de distribución especifica y programada permitirá habilitar y configurar desde la consola de Promo la posibilidad de generar los mapas y distribuirlos a la o las tiendas que corresponda de manera automática.


Pre-condiciones del Proceso:


Proceso de distribución de mapas

    1. Cuando inicie el Job de Generación y distribución programada de mapas, buscara las tiendas definidas en la compañía y solo se les distribuirán mapas a las tiendas que estén activas, con un tipo de conexión AUTO y al menos un motor asociado.
    2. Luego, el proceso buscara la ultima plantilla de mapas editada en estado COMPLETA.
    3. Habiendo completado con éxito los pasos 1 y 2, se procederá a agregar las promociones Completas y Vigentes a la plantilla de mapa, tomando como referencia la definición de "transacción" que tenga  cada promoción, y así agrupar por mapa, las promociones que apliquen a cada una de las tiendas. Las promociones que no tengan definida una condición de "transacción" serán distribuidas a todas las tiendas. El orden de las promociones dentro del mapa dependerá de la estructura de pasos , tipos, sub-tipos y formas de aplicación dadas en la plantilla de mapas.
    4. Una vez que se tienen los mapas completos para cada una de las tiendas se procede a la distribución de los .xml.


En caso de que dos tiendas tengan asociado un mismo motor, El mapa que se genere por medio de este proceso, contendrá las promociones que apliquen a ambas tiendas.

El proceso, por default se ejecutará diariamente a las 00:00:00 h.


Los atributos del elemento "Transacción" considerados para el armado de un mapa serán los standard (zona, sub-zona, canal, cadena). Los atributos dinámicos que puedan llegar a agregarse al elemento Transacción, no serán tenidos en cuenta para este proceso.


Agrupar Atributos

Desde la consola de Promo podrá gestionarse la forma en que se visualizaran los atributos de los elementos en la consola al momento de definir las condiciones de una promoción.

Para ello, deberá accederse a la sección de "Administración", "Agrupar Atributos" y se presentara la pantalla "Agrupar Atributos".

Allí podrán darse de alta los distintas agrupaciones que contendrán los atributos seleccionados para cada elemento.


Alta de nuevo Grupo de Atributos 

Para generar un nuevo grupo de atributos deberá darse clic en "Nuevo" y se presentara la pantalla "Nuevo Grupo de Atributos"



En esta pantalla, deberá indicarse:




Al seleccionar alguno de los elementos, se mostraran debajo los atributos disponibles crear un grupo de atributos.

Ejemplo: Si se selecciona "Productos" se mostrara la siguiente pantalla:


Si no se visualiza en la lista alguno de los atributos del elemento seleccionado puede deberse a que éste ya se encuentre asignado a algún otro grupo. Un mismo atributo no podrá pertenecer a dos grupos de atributos simultáneamente.
Luego de seleccionados los atributos que se desean agregar al nuevo grupo de atributos, podrá darse clic en "Guardar", y se visualizara la agrupación creada en la pantalla "Agrupar Atributos"

A la derecha de cada grupo de atributos se mostrara el botón "Acciones" desde el cual se podrán editar o eliminar los grupos de atributos existentes.

Al momento de definir una promoción, por alguno de los atributos que fueron incorporados a un grupo de atributos, estos se verán de la siguiente forma:



Grupo de Prefijos

Al ingresar a la sección "Grupos de Prefijos" se mostrará la pantalla "Gestión de grupos de Prefijos", donde se listarán todos los grupos dados de alta. Desde allí se podrá consultar, editar, y crear grupos de prefijos.

Filtros propuestos:

El botón "Acciones" tendrá las opciones "Editar", "Resumen" y "Promociones Asociadas"


Al presionar en "Editar" se mostrará la pantalla de "Edición de Grupo de Prefijos", desde donde podrán editarse rangos de prefijos, cambiar el nombre o desactivar el grupo. El código del grupo de prefijos no podrá editarse. 


Al presionar en "Resumen" se mostrará un popUp con el resumen del grupo de prefijos seleccionado.


Al presionar en "Promociones Asociadas" se direccionará la consola a la pantalla de informe de Promociones en donde solo se mostrarán las promociones vigentes y activas que contengan al grupo de prefijos seleccionado entre sus condiciones.


Alta de Nuevo Grupo de Prefijos 

Al presionar en el botón "Nuevo" se presentará la pantalla "Nuevo grupo de prefijos".

Allí deberá indicarse:





Deberá validarse que al presionar "Guardar", el grupo de prefijos contenga al menos un rango de prefijo válido definido. Se permitirá que un mismo rango de prefijos esté presente en mas de un grupo de prefijos.


Edición de Grupo de Prefijos

Cuando se edite un grupo de prefijos, se mostrará el botón "Descargar Prefijos"; al presionarlo se descargará un archivo que contenga la definición de rangos de prefijos actual del grupo seleccionado, a fin de que el operador, en caso de ser necesario, pueda editarlo y volver a cargarlo.

El código del grupo no podrá editarse.

Si se quiere desactivar un grupo de prefijos, deberá validarse que el grupo no se encuentre entre la definición de condiciones de alguna promoción activa. En caso de que un grupo de prefijos se encuentre dentro de las condiciones de una promoción activa se mostrará un popUp indicando "El grupo de prefijos no puede desactivarse ya que se encuentra asociado a Promociones activas. Por favor, desvincule los grupos de prefijos de las promociones que los contiene y vuelva a intentar".


Deberá validarse que al presionar "Guardar", el grupo de prefijos contenga al menos un prefijo válido definido.


DEFINICIÓN DE PROMOCIÓN POR "GRUPO DE PREFIJOS"

Cuando se desee definir una promoción por medio de "Grupos de Prefijos" deberá seleccionarse el elemento "Medios de Pago", y el atributo "Grupo de Prefijos"

Podrá seleccionarse entre los comparadores "Igual" o "Distinto"


En el popUp de definición de "Grupos de prefijos" se podrán ingresar los grupos por nombre o por código, y se irán auto-completando con los grupos de prefijos que estén dados de alta en la consola y coincidan con lo que se esta escribiendo. Una vez seleccionado el grupo de prefijos, en el popUp se agregará el código del grupo de prefijos.

El atributo "Grupos de prefijos" estará disponible para la definición de condiciones simples y condiciones por composición. Solo podrán definirse grupos de prefijos que hayan sido dados de alta en la consola.


GENERACIÓN DE MAPA >> PROMOCIONES CON CONDICIÓN DEFINIDA POR "GRUPO DE PREFIJOS"

Las promociones que contengan entre sus condiciones "Grupos de Prefijos" podrán incluirse dentro de cualquier paso y función de convivencia en el mapa.


CONSULTA Y EVALUACIÓN DE "GRUPO DE PREFIJOS"

Desde el POS solo se recibirá el atributo "Prefijo" en el elemento <payment/>

El motor evaluará a qué grupo de prefijos pertenece el prefijo informado por el POS en el pago; y lo informará al POS. El POS lo deberá re-inyectar en la mensajería, para así poder hacer la consulta de promociones que apliquen a los grupos de prefijos a los que pertenezca el prefijo consultado.

El atributo "Grupo de prefijos" deberá poder evaluar lista de atributos, ya que un mismo prefijo puede pertenecer a varios grupos de prefijos.

Cuando se realice en algún cambio en un grupo de prefijos, la consola de Promo deberá distribuir a los motores las novedades sobre los grupos actualizados.


Atributos de la cabecera

Esta opción permite agregar nuevos campos informativos a nivel cabecera de la promoción, que podrán ser cargados como texto libre o por catálogo.

Al seleccionar Administración \ Atributos de la cabecera, se mostrará la pantalla "Gestión de atributos de la cabecera".

Desde allí podrán gestionarse los campos informativos que deseen agregarse a la cabecera de la promoción.

Se podrán definir hasta 20 nuevos campos en la cabecera. Por default, los 20 campos estarán inactivos y no se mostrarán en la cabecera de las promociones. 

Cuando se presione para alguno de los campos, el botón "Editar" se mostrará la pantalla "Editar Atributos de la cabecera"

Allí podrá indicarse el nombre a mostrar en el campo, el tipo de dato que aceptará, si es requerido (o sea si será obligatorio cargarlo) y se puede activar.


En el campo "Tipo" se debe seleccionar el tipo de dato que tendrá ese campo, las opciones serán: "Autocompletable por catálogo" y "Texto".

Si se le puso el check "Activa" y se guardaron los cambios; al crear una nueva promoción, o al editar la cabecera de una promoción existente, en la sección "Atributos de la cabecera" de la promoción, mostrará los atributos activos:

Al lado del nombre del atributo, mostrará un * si al crear el atributo se le activó el check "Es requerido". En ese caso deberá completarse este campo para poder guardar la cabecera de la promoción y continuar. Si no se le había activado ese check, será opcional completar ese campo.

Si el tipo de dato seleccionado para el atributo fue tipo "Texto" podrá ingresarse texto libre. Si se había seleccionado "Autocompletable por catálogo" al comenzar a escribir en ese campo, sugerirá de acuerdo al contenido del catálogo previamente cargado.

Para poder utilizar el tipo de dato "Autocompletable por catálogo" debe realizar los siguientes pasos:

Seleccionar Administración \ Importación de Catálogo

En la pantalla "Importación de catálogos" se mostrará una línea relacionada con cada uno de los atributos de la cabecera. Por ejemplo: el atributo de la cabecera con código "field00" estará relacionado con la fila "Campo 0 adicional de la cabecera de la promoción".  El formato y los pasos para importar se encuentran detallados en la sección Importación de Catálogos. 


Una vez activado el atributo de la cabecera deseado, al crear o editar una promoción, mostrará el atributo como parte de la cabecera de la promoción en la pantalla "Definir Promoción" y también en el resumen de la misma.


Importación de promociones con los atributos de cabecera deshabilitados

Es posible insertar promociones, cuando se inactiven los atributos de cabecera, en la consola:.

Si en la consola se ha definido una promoción con atributos de cabecera; éstos estarán en la vista de detalle de la misma mientras los atributos estén activos:


Para deshabilitarlos, el usuario debe,  en la vista Gestión Atributos de la Cabecera, presionar el botón "Editar".

la aplicación desplegará la vista Editar Atributos de la cabecera; en este ejemplo para el atributo "Programable".

y allí destildar el ckeck "Activa".

Al importar  la promoción que contenía este atributo, vía rest, la nueva promoción no mostrará el campo de cabecera deshabilitado en su detalle:


Si se activa nuevamente el atributo y se vuelve a importar la promoción; en la consola se reflejará el cambio. Los atributos de cabecera se crean vacíos; porque son requeridos.

Si los atributos de cabecera sólo son requeridos, pero no activos, la promoción se importa y crea correctamente, pero los atributos no se mostrarán en la cabecera de la promoción.




Capítulo 13 - Módulo de Seguridad


Menú de Seguridad


Desde esta opción de menú se podrá asignar accesos a los roles disponibles y administrar los usuarios.




Administración de usuarios

Dentro de éste módulo se podrá configurar cada uno de los usuarios que provee PROMO por default, así como también la creación de nuevos usuarios.

Se podrán configurar: nombre, contraseña, habilitación, políticas de seguridad y asignar los roles para cada uno de los usuarios.

Desde el menú Seguridad > Administración de Usuarios, se ingresa a la siguiente pantalla:

 

Desde el botón "Acciones" que se encuentra al final de cada renglón que describe un usuario, podrá editarse el perfil del usuario o realizar el cambio de contraseña.

Podrán darse de alta nuevos usuarios presionando el botón "Nuevo". Se presentará la siguiente pantalla: 



 

Los parámetros de configuración de políticas de seguridad y usuario podrán editarse desde "Administración" > "Información de Configuración". Para mas detalle dirigirse al Manual de Instalación, sección "Información de Configuración".

                                                             

También desde esta sección podrán resetearse las contraseñas de los usuarios presentes en la consola. 

Desde el botón Acciones, que se encuentra a la derecha de cada usuario en la pantalla de "Administración de usuarios" se podrá acceder a la opción de "Cambiar Contraseña" y se presentará la siguiente pantalla:

Para la definición de la nueva contraseña deberán considerarse las políticas de seguridad que rigen sobre la contraseña (Alfanumérica, mínimo establecido, mínimo un número y una mayúscula, etc.)


El permiso "Blanqueo de contraseña" puede asignarse al rol deseado. De esta forma el usuario logueado con ese rol podrá blanquear la contraseña de los usuarios que tengan roles con permisos de edición con número igual o superior al de él. En el siguiente ejemplo el usuario admin, con rol administrador, posee permisos de edición 1; y el usuario logueado: operador con rol operador posee permisos de edición 3. Por los permisos de edición que tienen el usuario operador puede cambiar su propia contraseña (seleccionando el botón Acciones\ Cambiar Contraseña) pero no puede cambiar la contraseña del usuario admin, y es por ese motivo que ve el botón Acciones de ese usuario grisado y no puede seleccionarlo.




Configuración de Roles


Al seleccionar Seguridad / Configuración de Roles, se podrán asignar los permisos para los diferentes Roles de usuarios. El usuario principal podrá crear nuevos roles desde esta pantalla (ver Manual de Usuario Principal). Dependiendo de los permisos del rol que se esté utilizando podrá o no acceder a esta pantalla. Por ejemplo, el usuario administrador verá una pantalla como la siguiente:



Configuración de accesos:

Al seleccionar "Configuración de accesos" mostrará una pantalla como la siguiente: 

En la sección "Detalle del Rol" mostrará el código, descripción y permisos de edición del rol seleccionado.

Al estar logueado en una compañía solo podrá cambiar los permisos de esa compañía en la que está logueado y si es que tiene permisos para hacerlo. El usuario principal podrá cambiar los permisos de un rol para varias compañías (ver Manual de Usuario Principal).

En la sección "Permisos asignados" mostrará el campo de búsqueda "Permiso" y los combos seleccionables: "Categoría" y "Subcategoría". A medida que se va escribiendo en el campo "Permiso", el sistema irá mostrando debajo un listado con los permisos con ese nombre. Si desea borrar la búsqueda de Permisos escrita para realizar otra,  puede presionar la X que se encuentra a la derecha en el campo de búsqueda "Permiso". Si se selecciona una Categoría, en el campo Subcategoría mostrará las contenidas en la categoría seleccionada y en el listado mostrará sólo los permisos contenidos en esa Categoría y/o Subcategoría. A la derecha de cada permiso encontrará un check seleccionable para poder habilitar o deshabilitar cada permiso. En la parte superior de la columna donde se muestran los checks estará disponible el check "Selecc. Todos" que permite marcar o desmarcar todos los permisos listados (para habilitar o deshabilitar todos los que se encuentran en el listado). Una vez seleccionados y/o desmarcados los permisos que tendrá el rol que se está editando, debe presionar el botón "Guardar" para guardar las modificaciones realizadas. Si presiona el botón "Cancelar" todas las modificaciones realizadas se perderán.


Una vez que se cambian los permisos a un usuario existente, este se debe desloguear y volver a loguear para que los permisos sean efectivos.


ABM de Atributos de Elementos:  Solo el usuario principal puede asignar los accesos de atributos de elementos a algún rol.


Al momento de habilitar permisos debe tener en cuenta los permisos de visualización. Por ejemplo, si al rol operador le quiere dar acceso al permiso "Creación de promociones" debería habilitarle también el permiso "Visualización de promociones" para que pueda ver el listado de promociones existentes.

Cada rol debe tener al menos un permiso de visualización activo. Si no selecciona ningún permiso de visualización mostrará el mensaje "Por favor, seleccione al menos un permiso de visualización".


Configuraciones de Accesos por defecto

Los accesos por usuarios estarán configurados de manera predeterminada de la siguiente forma:

Módulo (categoría)Ítem (Sub categoría)Sub ítemQué habilita?Activo en Roles por default
Dashboard Promociones
Permite ver  y modificar el Dashboard de PromocionesAdministrador
Ventas
Permite ver  y modificar el Dashboard de VentasAdministrador
Cupones
Permite ver  y modificar el Dashboard de CuponesAdministrador
Elementos de Fidelidad
Permite ver  y modificar el Dashboard de TarjetasAdministrador
OperaciónCampañas
Visualiza menú Operación > Campañas y utilización de filtros de búsquedaAdministrador, Operador
Permite crear  y editar nueva campañaAdministrador
Condiciones generales
Visualiza menú Operación > Condiciones generales, utilización de filtros de búsqueda, ver el Resumen, ver Historial WFAdministrador, Operador
Permite enviar para aprobación condiciones generalesAdministrador
Permite editar y definir condiciones generalesAdministrador
Permite crear  y cancelar condiciones generalesAdministrador
Promociones
Permite visualizar las promociones y utilizar los filtros de búsquedaAdministrador, Operador
Permite crear, y copiar promocionesAdministrador
Permite cancelar promocionesAdministrador
Permite editar y definir promociones.Administrador
Permite agregar una imagen a la promociónAdministrador, Administrador de Negocio
Permite eliminar una imagen de la promociónAdministrador, Administrador de Negocio
 Permite enviar para aprobar una promociónAdministrador
Plantillas de promoción
Permite ver el listado de plantillas de promociones, utilizar los filtros de búsqueda y ver el ResumenAdministrador, Operador
Permite crear, editar y cancelar plantillas de promocionesAdministrador
Permite generar excel de las plantillas de promocionesAdministrador
Promociones para Aprobar
Permite ver el listado, el resumen y el Historial WF de promociones pendientes de aprobación/rechazoAdministrador, Operador
Permite aprobar o rechazar promocionesAdministrador
Condiciones Generales para Aprobar
Permite ver el listado e Historial de WF de condiciones generales pendientes de aprobación/rechazoAdministrador, Operador
Permite aprobar o rechazar condiciones generalesAdministrador
Alta Masiva de Promociones
Permite ver el listado de las plantillas disponibles para dar de alta de forma masiva promociones.Administrador, Operador
Búsqueda de últimas operaciones realizadas.Administrador, Operador
Permite acceder al detalle del procesamiento del archivo de alta masiva de promocionesAdministrador, Operador
Permite subir y procesar el archivo excel. Ver el Informe y Detalle de errores luego de ser procesado.Administrador
Cancelación Masiva de Promociones
Habilita la visualización del listado de promociones disponibles para cancelar, la utilización de los filtros de búsqueda, la selección de a una o todas las promociones, motivo de cancelación y la cancelación masiva de promociones.Administrador
Límites promociones
Permite la ver el  listado de Límites de promociones y realizar búsquedasAdministrador, Operador
Habilita la edición de los límites. El guardado de una edición de límite es el guardado de una edición de una promoción, por lo tanto tiene que tener el permiso de edición de promociones.Administrador
WorkflowWorkflow
Permite ver el listado de workflowsAdministrador, Operador
Permite crear un nuevo workflow,  agregar y eliminar pasosAdministrador
Permite editar un workflowAdministrador
DistribuciónMapas (POS)
Habilita ver el  listado de mapas, realizar búsquedas, y ver el resumen.Administrador, Operador
Permite descargar el mapaAdministrador
Permite distribuir un mapa, publicarlo a las tiendasAdministrador
Permite editar , y definir.Administrador
Permite crear nuevos mapas, Copiar mapaAdministrador
Simulación
Permite visualizar la simulaciónAdministrador, Operador
Edición, definiciónAdministrador, Operador
SimularAdministrador, Operador
Permite crear, ver el listado, editar y definir simulacionesAdministrador, Operador
Redes Sociales
Permite ver el listado de promociones a ser publicadas en redes sociales.Administrador, Operador
Permite publicar la promoción en las redes sociales y ver un resumen de las publicacionesAdministrador
FidelidadPlantillas de cupón
Permite ver el listado de plantillas de cupón disponibles y utilizar los filtros de búsquedaAdministrador, Operador
Habilita la creación de nuevas plantillas de cupónAdministrador
Habilita la edición de plantillas existentesAdministrador
Tipos de cupones
Permite ver el listado con los tipos de cupones existentes, utilizar los filtros de búsqueda, ver el resumen, las promociones asociadas y previsualizar.Administrador, Operador
Permite crear tipos de cuponesAdministrador
Permite editar, copiar y definir tipos de cuponesAdministrador
Cupones
Habilita la búsqueda de cuponesAdministrador, Operador
Permite dar de alta de forma masiva cupones y ver el informe con los resultadosAdministrador
Tipos de elementos de fidelidad
Permite ver el listado de tipos de tarjetas de fidelidad, realizar las búsquedas y ver el resumenAdministrador, Operador
Habilita la creación, edición y copia de tipos de tarjetas de fidelidadAdministrador
Habilita la creación, edición y copia de tipos de tarjetas de fidelidadAdministrador
Elementos de fidelidad
Permite realizar búsquedas de tarjetas de fidelidadAdministrador, Operador
Permite dar de alta de forma masiva tarjetas y ver el informe con los resultados o el detalle de errores y permite cancelarAdministrador
Permite modificar y transferir saldo de tarjetas de fidelidadAdministrador
Permite activar tarjetas de fidelidadAdministrador
Ver movimientos de tarjetasAdministrador, Operador
Convenio
Permite ver el listado de convenios existentes y realizar búsquedasAdministrador, Operador
Permite crear un nuevo convenio o editar uno existenteAdministrador
Clientes
Permite ver el listado de cliente, realizar búsquedas, ver el detalle del cliente y los cupones y tarjetas asociados

Administrador, Operador


Eliminar datos del cliente 

Administrador

Programas de Objetivos
Permite crear un nuevo Programa de Objetivos.

Administrador

Permite editar un Programa de Objetivos. 

Administrador

Permite visualizar un Programa de Objetivos.

Administrador

Eventos
Permite crear un nuevo evento

Administrador

Permite editar un evento

Administrador

ProductividadDetalle de Transacciones por Tienda
Habilita el Informe Detalle de Transacciones por Tienda

Administrador

Supervisor

Operador

Dashboard Transacciones por Tienda
Habilita el Informe Dashboard Transacciones por Tienda

Administrador

Supervisor

Operador

Detalle de Promociones
Habilita el Informe Detalle de Promociones

Administrador

Supervisor

Operador

Dashboard de Detalle de Promociones
Habilita el Informe Dashboard de Detalle de Promociones

Administrador

Supervisor

Operador

Detalle de Puntos por Vencer
Habilita el Informe Detalle de Puntos por Vencer

Administrador

Supervisor

Operador

Dashboard de Puntos por Vencer
Habilita el Informe Dashboard de Puntos por Vencer

Administrador

Supervisor

Operador

Detalle de Puntos Vencidos
Habilita el Informe Detalle de Puntos Vencidos

Administrador

Supervisor

Operador

Dashboard de Puntos Vencidos
Habilita el Informe Dashboard de Puntos Vencidos

Administrador

Supervisor

Operador

Total Diario de Transacciones
Habilita el Informe Total Diario de Transacciones

Administrador

Supervisor

Total Mensual de Transacciones
Habilita el Informe Total Mensual de Transacciones

Administrador

Supervisor

Total Diario de Promociones
Habilita el Informe Total Diario de Promociones

Administrador

Supervisor

Total Mensual de Promociones
Habilita el Informe Total Mensual de Promociones

Administrador

Supervisor

Detalle de Cupones por Vencer
Habilita el Informe Detalle de Cupones por Vencer

Administrador

Supervisor

Operador

Dashboard de Cupones por Vencer
Habilita el Informe Dashboard de Cupones por Vencer

Administrador

Supervisor

Operador

Detalle de Cupones Vencidos
Habilita el Informe Detalle de Cupones Vencidos

Administrador

Supervisor

Operador

Dashboard de Cupones Vencidos
Habilita el Informe Dashboard de Cupones Vencidos

Administrador

Supervisor

Operador

Detalle de Clientes con Mayor Compra
Habilita el Informe Detalle de Clientes con Mayor Compra

Administrador

Supervisor

Dashboard de Clientes con Mayor Compra
Habilita el Informe Dashboard de Clientes con Mayor Compra

Administrador

Supervisor

Detalle de Tiendas con Mayor Monto en Ventas
Habilita el Informe Detalle de Tiendas con Mayor Monto en Ventas

Administrador

Dashboard de Tiendas con Mayor Monto en Ventas
Habilita el Informe Dashboard de Tiendas con Mayor Monto en Ventas

Administrador

Detalle de Elementos de Fidelidad
Habilita el Informe Detalle de Elementos de Fidelidad

Administrador

Supervisor

Operador

Dashboard de Elementos de Fidelidad
Habilita el Informe Dashboard de Elementos de Fidelidad

Administrador

Supervisor

Operador

Detalle de Tiendas con Aumento de Beneficios
Habilita el Informe Detalle de Tiendas con Aumento de Beneficios

Administrador

Dashboard de Tiendas con Aumento de Beneficios
Habilita el Informe Dashboard de Tiendas con Aumento de Beneficios

Administrador

Detalle de Productos con Aumento en Ventas
Habilita el Informe Detalle de Productos con Aumento en Ventas

Administrador

Dashboard de Productos con Aumento en Ventas
Habilita el Informe Dashboard de Productos con Aumento en Ventas

Administrador

Detalle de Promociones Activas por Tienda
Habilita el Informe Detalle de Promociones Activas por Tienda

Administrador

Supervisor

Operador

Dashboard de Promociones Activas por Tienda
Dashboard de Promociones Activas por Tienda

Administrador

Supervisor

Operador

InformesPromociones/MapasPromociones-VigentesHabilita el Informe Promociones-vigentesAdministrador, Administrador de Negocio, Operador
PromocionesHabilita el Informe PromocionesAdministrador, Administrador de Negocio, Operador
Promociones por SKUHabilita Informe Promociones por SKUAdministrador, Administrador de Negocio, Operador
Mapas (POS)Habilita Informe Mapas (POS)Administrador, Administrador de Negocio, Operador
Límites por promociónHabilita Informe > Promociones/Mapas > Limites por promocionesAdministrador, Administrador de Negocio, Operador
Historial de LímitesHabilita el Informe Historial de LímitesAdministrador, Administrador de Negocio
Distribución: Redes SocialesHabilita el Informe Distribución en redes socialesAdministrador, Administrador de Negocio, Operador
Distribución: TiendasHabilita Informe > Promociones/Mapas > Distribución: TiendasAdministrador, Administrador de Negocio
TransaccionesIndicadores OperacionalesHabilita el Informe Indicadores operacionalesAdministrador, Administrador de Negocio
Detalle de TransacciónHabilita el Informe Detalle de transacciónAdministrador, Administrador de Negocio
Ranking de ClientesHabilita el Informe Ranking de ClientesAdministrador, Administrador de Negocio
Transaccional de LímitesHabilita el Informe Transaccional de límitesAdministrador, Administrador de Negocio
Errores de DevoluciónHabilita el Informe Errores de devoluciónAdministrador, Administrador de Negocio
Reporte de TransaccionesHabilita Informe > Transacciones > Reporte de TransaccionesAdministrador, Administrador de Negocio
Reporte de PromocionesHabilita Informe > Transacciones > Reporte de PromocionesAdministrador, Administrador de Negocio, Operador
Tiendas ActivasHabilita Informe > Transacciones > Tiendas ActivasAdministrador
CuponesTipos de CuponesHabilita Informe >Cupones > Tipos de CuponesAdministrador, Administrador de Negocio, Operador
CuponesHabilita Informe >Cupones > CuponesAdministrador, Administrador de Negocio
Cupones VencidosHabilita Informe >Cupones > Cupones VencidosAdministrador, Administrador de Negocio
Extracto de CuponesHabilita Informe > Cupones > Extracto de cuponesAdministrador, Administrador de Negocio
Detalle de RedenciónHabilita Informe > Cupones> Detalle de RedenciónAdministrador
Elementos de FidelidadTipos de Elementos de FidelidadHabilita Informe > Elementos de Fidelidad > Tipos de Elementos de FidelidadAdministrador, Administrador de Negocio, Operador
Elementos de FidelidadHabilita Informe > Elementos de Fidelidad > Elementos de FidelidadAdministrador, Administrador de Negocio
Puntos/ Montos VencidosHabilita Informe > Elementos de Fidelidad > Puntos/Montos VencidosAdministrador, Administrador de Negocio
Elementos de fidelidad sin MovimientosHabilita Informe > Elementos de Fidelidad > Elementos de Fidelidad sin MovimientosAdministrador, Administrador de Negocio
Extracto de Puntos/ MontosHabilita Informe > Elementos de Fidelidad > Extracto de Puntos/MontosAdministrador, Administrador de Negocio
Monitor de Exportación
Visualización/ Creación de Exportación de InformesAdministrador
Segmentos
Habilita Informe > SegmentosAdministrador
Programas de ObjetivosResumen de PromocionesHabilita Informe > Resumen de PromocionesAdministrador
Transaccional del clienteHabilita Informe > Transaccional del ClienteAdministrador
NegocioTiendas
Habilita ver el  listado de Tiendas y realizar búsquedasAdministrador, Administrador de Negocio
Permite editar tiendas.Administrador, Administrador de Negocio
Permite crear, activar o desactivar tiendas. Agregarles, modificar o eliminar conexión y asociarles motores.Administrador, Administrador de Negocio
Segmentos
Visualización de segmentosAdministrador, Administrador de Negocio
Permite crear y realizar búsquedas de segmentosAdministrador, Administrador de Negocio
Permite editar y definir y realizar búsquedas de segmentosAdministrador, Administrador de Negocio
Compañías
Permite crear, editar, definir, activar, desactivar y buscar compañíasprincipal
AdministraciónTareas Programadas
Ejecución manual, detención y planificación de tareas programadasAdministrador
Dashboards
Permite crear dashboardsAdministrador
Permite editar, definir, activar, e inactivar  dashboardsAdministrador
Ver dashboardsAdministrador
Importación de catálogo
Habilita la visualización del listado de catálogos y ver los primeros 25 registros del contenido de los catálogos. Habilitar visualización de catálogos habilita el autocompletado por catálogo además. En caso de inhabilitar visualización, no se autocompletarán los ingresos por catálogo.Administrador, Operador
Permite importar catálogosAdministrador
Información de configuración
Habilita la visualización, búsqueda y edición de parámetros de configuraciónAdministrador, Principal
Importación de promociones
Permite importar promociones y ver el resultado de las importaciones realizadasAdministrador, Operador
Motivos de modificación de saldos
Permite crear, editar, buscar Motivos de modificación de saldos, ver el  listado y los detalles e inactivarlos.Administrador
Registro de auditorías
Habilita la visualización del listado, búsqueda y vista del detalle de los Registros de AuditoríasAdministrador, Principal
Propiedades de beneficio
Habilita la visualización del listado de Propiedades de beneficiosAdministrador, Operador
Permite crear, editar, activar y desactivar propiedades de beneficios y realizar búsquedasAdministrador
Atributos de elementos
Habilita ver el listado de atributos de elementos, realizar búsquedas y descargar el archivo de definiciónPrincipal
Permite crear, editar, activar y desactivar atributos de elementosPrincipal
Tipo de promociones
Habilita la visualización del listado de Tipo de Promociones, búsquedas y permite Ver las Promociones AsociadasAdministrador, Operador
Permite crear y editar Tipos de promocionesAdministrador
Sub-tipo de promociones
Habilita la visualización del listado de Sub-tipo de Promociones, búsquedas y permite Ver las Promociones AsociadasAdministrador, Operador
Permite crear y editar Sub-tipos de PromocionesAdministrador
Forma de aplicación de promociones
Habilita la visualización del listado de Forma de aplicación de Promociones, búsquedas y permite Ver las Promociones AsociadasAdministrador, Operador
Permite crear y editar Forma de aplicación de PromocionesAdministrador
Plantilla de mapas
Habilita la visualización del listado de Plantillas de Mapas, la búsqueda, el resumen y ver las promociones asociadasAdministrador
Permite crear, editar, definir y copiar plantillas de mapasAdministrador
Agrupar atributos
Habilita la Visualización del listado de Grupo de atributos y la búsquedaAdministrador, Operador
Permite crear, editar y eliminar grupos de atributosAdministrador
Grupo de prefijos
Habilita la Visualización del listado de Grupo de Prefijos, la búsqueda, ver el resumen y las promociones asociadas. El botón de promociones asociadas se verá si tiene permiso para visualización de promociones. También aplica a Tipo, subtipo, forma de aplicación, y plantillas de mapasAdministrador, Operador
Permite crear, editar, activar, desactivar y eliminar Grupos de Prefijos; agregar prefijos y descargar archivo de prefijos.Administrador
Atributos de la cabecera
Habilita la visualización y búsqueda de Atributos de la CabeceraAdministrador, Operador
Permite editar, activar y desactivar Atributos de la CabeceraAdministrador
SeguridadAdministración de Usuarios
Habilita la visualización y búsqueda del Listado de UsuariosPrincipal, Administrador
Permite crear y editar usuarios, cambiar contraseñas, habilitar y deshabilitar usuariosPrincipal, Administrador
Configuración de Roles
Crear, editar, eliminar.Administrador (si hay 1 sola compañía*), Principal
Listar y configurar accesos.Administrador (si hay 1 sola compañía*), Principal
AlarmasConfiguración
Habilita la visualización del listado de alarmas y búsqueda y ver el detalleAdministrador, Operador
Permite crear y desactivar alarmasAdministrador
Notificaciones
Permite ver el listado de notificaciones de alarmas, realizar búsquedas y ver el detalleAdministrador
Permite confirmar las notificaciones.Administrador
SoporteGestor de backups de BBDD
Permite generar y restaurar backupsPrincipal, Administrador
Estado del Sistema
Permite ver el estado en que se encuentran los motores configurados, realizar búsquedas y descargar un ExcelAdministrador
Permite ver el estado en que se encuentran las consolas configurados, realizar búsquedas y descargar un ExcelAdministrador
Log del Sistema
Permite ver el listado de los logs de la consola, realizar búsquedas y descarar los logsPrincipal, Administrador
Permite ver el listado de los logs del motor, realizar búsquedas y descarar los logsPrincipal, Administrador
Monitor de importación
Habilita la visualización del listado con el estado de las distintas importaciones, realizar búsquedas, ver el detalle y reprocesar registrosAdministrador
Panel de colas de Mensajes
Permite Reenviar colas RabbitMQ de Promociones, Cupones, Segmentos y Transacciones, que hayan tenido algún error.Administrador
Monitor de Exportación
Habilita la visualización del listado con el estado de las distintas exportaciones y reprocesar registros.Administrador
Monitor de Integración
Habilita la visualización del Monitor de Plugins (a partir de Promo 7.4)Administrador


*En Seguridad\ Configuración de Roles\ Listar y configurar accesos, si hay 2 o más compañías configuradas en Promo, el usuario admin no tendrá acceso por default a la pantalla "Configuración de roles".

Si hay una sola compañía configurada en Promo, el usuario admin si debe tener acceso a la pantalla "Configuración de roles".




Capítulo 14 - Módulo de Alarmas

Desde la consola de Promo podrán configurarse alarmas que supervisarán determinadas transacciones que se reporten a la consola, y en base a ellas podrán registrarse y enviarse notificaciones a distintos usuarios de Promo. 


Menú de Alarmas

Este menú proporciona la creación y configuración de las distintas Alarmas y administración de  Notificaciones disponibles en Promo.



Configuración

Al acceder al menú de "Configuración" de Alarmas, se presentará la pantalla "Configuración de Alarmas" donde se mostrarán las alarmas dadas de alta hasta el momento.

Se cuenta con los siguientes filtros que facilitarán la búsqueda de las alarmas configuradas en la consola:

Tipos de Alarmas (relativas a transacciones)

Podrán filtrarse aquí entre las siguientes opciones de alarmas a configurar:

>> Puntos Otorgados por transacción: Evalúa que, la cantidad de puntos otorgados por cada transacción registrada en la consola de PROMO no supere la cantidad de de puntos definidos en la Alarma. En caso de alcanzarse o superarse se registrará la alarma correspondiente.

>> Puntos  Otorgados por períodoEvalúa que, la cantidad de puntos otorgados en las transacciones registradas en la consola de PROMO durante un determinado período, no supere la cantidad de de puntos definidos en la Alarma. En caso de alcanzarse o superarse se registrará la alarma correspondiente.

>> Puntos  Redimidos por transacciónEvalúa que, la cantidad de puntos redimidos por cada transacción registrada en la consola de PROMO no supere la cantidad de de puntos definidos en la Alarma. En caso de alcanzarse o superarse se registrará la alarma correspondiente.

>> Puntos Redimidos por período: Evalúa que, la cantidad de puntos redimidos en las transacciones registradas en la consola de PROMO durante un determinado período, no supere la cantidad de de puntos definidos en la Alarma. En caso de alcanzarse o superarse se registrará la alarma correspondiente.

>> Modificación de saldo por período: Controla que los montos que se modifiquen desde la consola  para un elemento de fidelidad, no alcancen o superen los valores definidos en la alarma durante el período de tiempo determinado.

>> Saldo Negativo en tarjeta por transacción: Evalúa que un elemento de fidelidad luego de transaccionar no quede con saldo negativo, en caso de que esta situación se presente se generará y enviara la notificación correspondiente.

>> Venta efectuada por debajo del costo: Controla que las ventas no se realicen por debajo del costo del producto.

>> Modificación de saldo por transacción: Controla que los montos que se modifican desde la consola para un elemento de fidelidad en una sola operación, no alcancen o superen los valores definidos en la alarma.

>> Promociones distribuidas por tiendas:  Al momento de distribuir un mapa, esta alarma, enviará un informe en formato .XLS a los usuarios y/o grupos de usuarios definidos en la alarma, con las promociones que se acaban de distribuir a la tienda. En el subject del mail se informará la tienda a la que pertenecen los datos que se están incluyendo en el mail.

>> Aprobación Workflow:  Este tipo de alarma informa sobre los cambios realizados en los Workflows (WF) definidos en la consola a fin de que el o los involucrados en la aprobación de promociones sean notificados de que una promoción requiere de una acción en el workflow que tiene asociado.

>> Modificación en % de Beneficios:  Esta alarma se disparará al momento de generar una promoción en estado completa que sea igual o mayor al porcentaje de descuento establecido en la alarma. O cuando se modifique una promoción y su beneficio luego de la modificación sea igual o mayor al porcentaje de descuento establecido en la alarma.

>> Monitoreo de Límites:  Permitirá visualizar las unidades o montos ($) utilizados en las promociones donde se definieron límites, con la finalidad de llevar trazabilidad de los beneficios otorgados.

>> Transacciones que otorgan puntos por períodos:  Para evitar fraudes esta alarma alertará sobre la cantidad de transacciones que otorgan puntos, en un período determinado.

>>Alarma Promociones distribuidas por tiendas: Para evitar fraudes esta alarma alertará sobre la cantidad de transacciones que otorgan puntos, en un período determinado.

  

En caso de haberse definido la notificación solo para ser vista por pantalla, se deberá informar en el registro de la alarma, el número de mapa y la o las tiendas a las que fue distribuida.

En caso de que la notificación sea por pantalla y por mail, al activarse la alarma deberá mostrarse la notificación en la consola de Promo y también enviarse un mail a los usuarios definidos en la alarma con el siguiente formato:

A este mail se adjuntara un archivo excel con las promociones distribuidas a esa tiendas.

El nombre del archivo deberá ser "nro de mapa_tienda a la que se distribuyo_fecha y hora de distribucion.xml" y tendrá las siguientes columnas:

                 >>Alarma Aprobación Workflow: Este tipo de alarma no permitirá seleccionar los workflows de 1 solo paso (no mostrará el Workflow General).

 En el combo seleccionable Workflow mostrará todos los workflows que tengan mas de un paso. Al asociarse la alarma a un Workflow, éste quedará disponible para la generación de alertas que envíe notificaciones sobre cambios de estado en las promociones que tengan asociado ese WF.

Si en el combo "Tipo de Notificación" se indica "Registro de notificación y envío de mail" se podrá seleccionar entre los roles y usuarios que se hayan incluido entre los pasos definidos en el WF a fin de que sean notificados de los cambios de estado de una promoción asociada al WF al que se le esta generando la alerta. También se propondrán los roles y usuarios que estén activos en la consola en caso de que se requiera incluir a mas destinatarios que no se hayan incluido en la aprobación del WF.

MODIFICACIONES EN EL WORKFLOW:

De modificarse un WF, agregando o quitando pasos, los roles involucrados no se modificarán en las alarmas que se tengan asociadas a este WF. Deberá de editarse la alarma agregando o quitando los roles y/o usuarios que corresponda para el envío de la notificación.


ESTRUCTURA DEL MAIL A ENVIAR CUANDO SE ACTIVE LA ALARMA DEL WORKFLOW:

El mail que se envíe al momento de activarse una alarma contendrá los siguientes datos:


Consideraciones:

Los usuarios seleccionados para recibir la notificación deben tener el campo "Correo electrónico" cargado.

Los datos del servidor de correo electrónico deben estar debidamente configurados.


        >>Alarma Modificación en % de Beneficios: Envía una alarma cuando se ha modificado el porcentaje en beneficios de promociones.


Se la puede seleccionar en la vista Gestión de alarmas o en la  Nueva Alarma, en el filtro Tipos de alarma o en la vista Nueva Alarma.

Se podrá seleccionar el Tipo de beneficio aplicará la alarma que se está generando:


Al seleccionar el Tipo de beneficio Monetario, se propondrán los siguientes campos donde deberá indicarse a qué Clase de beneficio aplicará la alarma que se está generando:

A continuación, se mostrará el campo que permita ingresar el porcentaje a partir del cual aplicará la alarma que se está generando. Este umbral debe incluirse como Parámetro dentro de Promo para que el usuario pueda ingresar el valor deseado. Es decir, el descuento debe ser igual o mayor al porcentaje indicado:

Al seleccionar el Tipo de beneficio No monetario, se propondrán los siguientes campos donde deberá indicarse a qué Clase de beneficio aplicará la alarma que se está generando:

A continuación, se mostrará el campo que permita ingresar el Porcentaje a partir del cual aplicará la alarma que se está generando. Este umbral debe incluirse como Parámetro dentro de Promo para que el usuario pueda ingresar el valor deseado. Es decir, el descuento debe ser igual o mayor al porcentaje indicado:


      >>Alarma Monitoreo de Límites: Esta alarma deberá activarse cuando el saldo del limite alance el valor en porcentaje (%) o en monto ($) definido en la alarma. Si se define al 100% se emitirá la alarma de consumo total del límite.

Ejemplo:

En caso de que la promoción se defina por ejemplo por cantidad de aplicaciones por tienda y la alarma se defina en un 80%, si el limite definido en la promo es de 10, cuando el contador alcance 8 aplicaciones deberá emitirse una alarma.

Lo mismo sucederá en caso de que la promoción se defina  por cantidad de dinero por cliente  $1500 y la alarma se defina en un valor de $1000,  cuando el contador alcance los $1000 deberá emitirse una alarma.

Aplicara para  los scope de limites (tienda, general) y para todos los tipos de limites (Cantidad de aplicaciones, Productos beneficiados, cantidad de dinero, cupones y/o puntos otorgados, etc.).

Para ello, al crear una nueva alarma se debe seleccionar la opción Monitoreo de Límites.   

Al seleccionarse el ítem Monitoreo de límites, la aplicación desplegará el siguiente formulario:

En el campo Límite se podrá seleccionar el scope de limites (tienda, general) sobre el cual se querrá monitorear los movimientos a alertar.

En el campo "Limita por" se podrá seleccionar por tipos de limites sobre el cual se querrá monitorear los movimientos a alertar.

En el campo "Activar tipo" se podrá seleccionar si la alarma evaluara por % o por monto consumido en el limite para activar la alarma correspondiente.

En el campo "Activar Valor" se indicara el numero a evaluar en base a lo definido en el filtro "Activar tipo"

Las restantes opciones de definición del alarma continuaran operando de la misma forma en la que se operan todas las alarmas (Descripción, Prioridad, Requiere confirmación, Tipo de notificación, Roles, Usuarios y Activa):


      >>Alarma Transacciones que otorgan puntos por períodos:  Alertará sobre la cantidad de transacciones que otorgan puntos, en un período determinado.


Esta alarma deberá alertar a los usuarios, cuando se haya superado la cantidad de transacciones que otorgan puntos configuradas, en el período configurado.

La alarma sólo deberá notificar la cantidad de transacciones (que otorgan puntos) que se generen luego de la creación de la alarma, y no las preexistentes.

Al seleccionar este tipo de alarma se desplegará la siguiente vista:

donde el usuario deberá configurar la cantidad de días que se realizará la contabilidad de las transacciones que otorguen puntos de fidelidad y la cantidad de transacciones a partir de las cuales se debe disparar la alarma.

Cuando se registre una mayor cantidad de transacciones que otorguen puntos, que las configuradas, la alarma enviará un mail informando de esta situación, en el siguiente formato:

En el reporte de transacciones, se observará el detalle de las mismas.


  • Este tipo de alarmas no aplica a transacciones que acumulen puntos de fidelidad con elementos de fidelidad externos.
  • Aquellas alarmas que no han sido confirmadas, impedirán que los usuarios reciban nuevas notificaciones de transacciones del cliente. Una vez que se hayan confirmado las alarmas, las notificaciones llegarán correctamente, por cada transacción del cliente.


Aquellas alarmas que no requieran confirmación, una vez que el cliente haya llegado al número configurado de transacciones que otorgan puntos, el usuario recibirá notificaciones por cada transacción que involucre al cliente y le otorgue puntos.


Prioridad de Alarma: Filtrará si la alarma es de prioridad Alta, Media o Baja.

Tipo de Notificación:  Filtrará las alarmas que solo registrarán una notificación en la consola de Promo o las alarmas que junto con la notificación por consola enviará un mail a los usuarios registrados en la alarma.



Configuración E-Mails:

Para que los mails de notificaciones sean enviados correctamente, el usuario deberá tener configurado un mail válido y la consola de Promo deberá tener configurado el servicio de mail de salida.

Se configura desde: Administración\ Información de Configuración. En la pantalla “Información de configuración” en el filtro “Palabras a buscar” escribir: mail y luego presionar la lupa. Se debe configurar, por ejemplo, con los siguientes parámetros de acuerdo al mail que tenga:

Parámetro

Gmail

Live/hotmail

Yahoo

Exchange

default.from

[email protected]

[email protected]

[email protected] o [email protected]

[email protected]

default.insertImages

true

false

false

false

default.subject

Prueba mail

Prueba mail

Prueba mail

Prueba mail

host

smtp.gmail.com

smtp.live.com

smtp.mail.yahoo.com

pod51009.outlook.com

password

password del mail

password del mail

password del mail

password del mail

port

465

587

587

587

smtp.auth

true

true

true

true

smtp.port

587



587

smtp.socketFactory.class

javax.net.ssl.SSLSocketFactory



javax.net.ssl.SSLSocketFactory

smtp.socketFactory.fallback

false



true

smtp.socketFactory.port

465



587

smtp.starttls.enable

true

true

true

true

username

[email protected]

[email protected]

[email protected]

[email protected]
smtp.ssl.trust *


*

Luego de realizar los cambios debe guardarlos presionando el botón “Guardar”.


*Aclaración: smtp.ssl.trust:

Con este valor se indica a la consola de Promo que va a enviar el mail, que confíe en los certificados del server (por ejemplo en el caso de la compañía xx, los certificados son autofirmados y carecen de una autoridad certificadora válida) .

Se puede colocar ‘*’ (asterisco)  para que confíe en todos los certificados que vengan del server o el host que firma los certificados, por ejemplo ‘xx.com.uy'  si el depto de seguridad informática de la compañía quiere ser más específica o en algún momento decidan cambiar el certificado y coloquen otro generado en otro server.

Si utilizaran certificados válidos generado por alguna entidad autorizada, no haría falta configurar este valor, es decir dejar en blanco.


Para las cuentas de yahoo y google se deben configurar en dichas casillas que se pueda acceder de aplicaciones menos seguras, esto permite enviar los emails desde aplicaciones externas.


Para las alarmas: el usuario Administrador debe configurar en la consola de Promo, la dirección de Correo electrónico correspondiente al usuario que administra las alarmas (esta será la dirección de mail que recibirá las alarmas).



Envío de e-mails por SendGrid: 

A partir de Promo 7.4 para que los e-mails sean enviados por SendGrid se debe realizar dos configuraciones en Administración\ Información de Configuración, buscando por la palabra "mail":


1) Dirección del e-mail de envío:

Es la dirección de e-mail desde donde Promo realizará los envíos de e-mails. Se configura desde "default.from" como se muestra a continuación:

Esta configuración ya existía y si va a utilizar el envío de e-mails por smtp esta configuración no cambia. Si va a utilizar el envío de e-mails por SendGrid debe ingresar en este campo la misma dirección de e-mail que utilizó en SendGrid para generar la apikey.


2) Apikey de SendGrid:

Con esta nueva funcionalidad se agrega un nuevo parámetro de configuración:

Buscando por la palabra "mail" aparecerá la opción "sendgrid.apikey" como se muestra a continuación:

En dicha configuración se debe ingresar la apikey generada por SendGrid. Un ejemplo de la clave que podría ir en el campo apiKey sería: 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

Si se ingresa información en el nuevo campo "sendgrid.apikey", Promo enviará los e-mails por SendGrid. Si no hay nada configurado en ese campo (está vacío) los e-mails serán enviados como lo hacía antes de este cambio, o sea por smtp.


IMPORTANTE: Si va a realizar el envío por SendGrid debe estar en concordancia la apikey ingresada en "sendgrid.apikey" con el correo que lo va a enviar configurado en "default.from".


Estado: Podrá filtrarse entre Alarmas que estén activas y las que  estén inactivas.

Solo podrán editarse las Alarmas que se encuentren Inactivas.




Cada alarma dada de alta dispondrá de un botón "acciones" desde el cual podrá desactivarse, editar, activarse y/o ver el detalle de cada una de ellas. 


Los roles y usuarios seleccionados al crear la alarma, serán los que recibirán las notificaciones de las mismas; tanto por mail como por notificación por consola.

Para desactivar una alarma, se solicitará que se indique un motivo con el siguiente PopUp; luego de ingresado el motivo, presionar Continuar y la alarma quedará inactiva.

Al desactivar la alarma el botón Acciones mostrará el siguiente menú:

Al reactivar una Alarma se requerirá confirmación por medio del siguiente PopUp:


Al presionar el botón "Editar" la aplicación desplegará el alerta a modificar; donde todos los campos son editables.

Para poder eliminar un valor del campo Roles y/o Usuario se debe mantener presionada la tecla control y el valor a quitar.

Ejemplo:

si se quiere eliminar el rol Administrador

luego de presiona Ctrl + dicho valor:

   

Nueva Alarma

Para dar de alta una nueva Alarma, presionar el botón "Nueva" que se encuentra en la pantalla "Configuración de Alarmas" y se presentará el siguiente formulario:

Los datos solicitados para el alta de una nueva alarma son los siguientes:

>> "Cantidad de días": En el caso de que la alarma a configurar evalúe la ocurrencia de un evento en un determinado período, se propondrá este campo donde deberá indicarse la cantidad de días que comprenderá el período, y pasada dicha cantidad de días el contador se reseteará. En caso de que la alarma se active y no requiera confirmación, el contador se reiniciará automáticamente, en caso de requerir confirmación el contador se inicializará cuando el usuario habilitado confirme la notificación correspondiente.

>> "Cantidad de puntos": deberá indicarse la cantidad de puntos que deberán alcanzarse para activar la alarma. En caso de que la alarma se active y no requiera confirmación, el contador se reiniciará automáticamente, en caso de requerir confirmación el contador se inicializará cuando el usuario habilitado confirme la notificación correspondiente.

Notificaciones

Al acceder al menú de "Notificaciones" del modulo de Alarmas, se presentará la pantalla "Notificaciones de Alarmas" donde se mostrarán las notificaciones generadas al momento de alcanzar los límites definidos en las alarmas activas.

Se cuenta con los siguientes filtros que facilitarán la búsqueda de las notificaciones presentes en la consola:


Cada vez que se genere una notificación, de aquellas alarmas que requieran confirmación, en el ángulo superior derecho de la consola, aparecerá un ícono de campana con un signo de admiración rojo que le informará al usuario que hay notificaciones pendientes de revisión (deben ser confirmadas).


Si no se confirma una alarma que requiere confirmación; no se recibirán mails ni notificaciones hasta que no se confirme la misma.

Cada notificación tendrá a la derecha un botón de "Acciones"  desde donde podrán confirmarse las notificaciones que así lo requieran y ver un detalle de cada notificación.

Detalle:


Confirmación:





Capítulo 15 - Módulo de Soporte


Menú de Soporte


Desde esta sección se podrán reiniciar configuraciones y gestionar backups de la base de datos.





Gestor de backups de BBDD


El gestor de backups permite generar copias de seguridad de todas las acciones que se generan dentro de la consola de la compañía, estas copias se realizaran una vez por día a las 00.00h.

Para poder llevar a cabo ésta tarea, el Usuario Principal deberá configurar previamente la ruta donde se guardará el backup.

Tanto para generar, como para restaurar el backup, deberá ingresar en Soporte\ Gestor de backups de BBDD, donde se mostrará una pantalla como la siguiente:

Para generar un nuevo backup debe presionar el botón "Generar nuevo backup" y para restaurar un backup existente debe presionar el botón "Restaurar BBDD" sobre el backup deseado.


El BACKUP / RESTORE (Por empresa), no es para migrar datos a otro ambiente, porque tiene dependencia con los datos del ambiente donde se genera. El backup restore  es para recuperar datos si se ha cometido un error y se quiere disponer de la información anterior; sólo afecta a la empresa que lo hace.



Estado del Sistema

Podrá visualizarse el estado de los componentes (Consola o Motor) que se reporten a la consola de PROMO desde la sección "Estado del Sistema".

Se presentará la siguiente pantalla:

En ella podrá visualizarse el estado de la comunicación con el motor, su última comunicación, su ID, nombre, con qué mapa esta operando, y en qué tienda. Así como también la vigencia del mapa informado.

En caso de que un motor asociado a la consola no se reporte cada una determinada cantidad de tiempo (sea por falla en la conexión o por estar caído), el motor aparecerá Offline, informando los últimos datos recibidos.

Tener en cuenta que la información del estado de consola y motor se depura semanalmente (por default). Si alguna consola o motor hace mas de una semana que no se reporta desaparecerá; ya no se lo verá en la pantalla "Estado del sistema".

En Administración\ Información de Configuración, en el siguiente campo se puede configurar cada cuánto se depura la información de estado de consola y motor:

Con el filtro "[Componente]" puede seleccionar si se quiere ver en pantalla las "Consolas" o los "Motores". En la columna "Componente" se mostrará el ícono  para indicar si se está mostrando en esa línea un motor, y si es una consola mostrará .

Al ingresar mostrará todos los estatus on line y off line (no vendrá pre filtrado en el filtro que dice "[Seleccione]").

Se podrán utilizar los filtros de navegación. Ver detalles en Paginado.


Consola

Si en el combobox de componente se selecciona Consola, la aplicación mostrará la siguiente vista:

Si descarga el Excel lo verá como el siguiente. La columna con el título: Consola, mostrará el contenido con true o false.


El botón "Exportación Masiva" lo llevará a la pantalla "Motor Exportación Informes" y desde la columna Descripción se podrá bajar el archivo .csv con todos los registros de la vista "Estado del Sistema".


Motor

Si en el combobox de componente se selecciona Motor, la aplicación mostrará la siguiente vista:

Si selecciona el botón Acciones podrá descargar los logs de los motores.

Al seleccionar la opción Descargar Logs, la aplicación desplegará en la vista Logs del sistema, los logs disponibles. A través de los checkBox debe seleccionar los que desea bajar y presionando el botón descargar, en el archivo correspondiente se obtendrá el archivo .zip. con los logs indicados.

     

Cuando se crean nuevas compañías; si ya existe un motor asociado a una existente, la nueva no verá el estado de dicho motor en Soporte, Estado del Sistema. Cuando se distribuya manualmente un mapa vigente en una tienda de la nueva compañía ; ya se le podrá asociar el motor y esta nueva compañía podrá ver el estado del mismo en Soporte, Estado del Sistema; seleccionado el ítem motor.


Log del sistema

Otra forma de descargar los logs del sistema es presionando la opción desde el menú Soporte/Log del sistema. La aplicación lo direccionará a la vista:

                               

Los filtros a seleccionar son:

 Luego se debe presionar el botón  para iniciar la descarga.


                                                                                                                                                           

 Monitor de Importación


Desde el menú Soporte > Monitor de importación, se accede a la pantalla de administración del monitor de Importaciones.

En esta sección se podrá visualizar el estado de las importaciones y exportaciones de archivos realizados vía Colas RabbitMQ que se tengan configuradas en la consola de Promo.

Se puede ver el estado de las distintas importaciones, por ejemplo si el proceso de importación finalizo exitosamente o si se produjo algún error.

Esta vista posee los siguientes filtros de búsqueda:


Los tipos de importación serán visibles por default, durante 30 días después de realizada la operación.




Desde cada registro que se ve en el Monitor de Importación, si se presiona el botón Acciones, mostrará dos opciones: "Contenido" y "Detalle". Si presiona el botón "Contenido" se descargará el mismo en un archivo .txt. 

     

Si seleccionó la opción Acciones/ "Detalle”, podrá ver el detalle del resultado del proceso de importación:


Si algún elemento se encuentra CON ERROR, y alguno se encuentra OK, el resultado del archivo aparecerá como “PARCIAL”, y si todos los elementos se procesaron con error, el resultad del archivo será “ERROR”, y mostrará "PROCESADO" cuando todos los elementos del archivo se hayan procesado correctamente.


Podrá volver a procesar registros desde el botón Acciones\ Reprocesar, o seleccionando el checkbox a la izquierda del ítem, y haciendo click en el botón "Reprocesar seleccionados".

                          

Al realizar una importación de catálogo vía colas RabbitMQ, si el mensaje a importar está vacío, cuando se ejecuta el proceso correspondiente, en la vista Soporte\ Monitor de Importación, el campo "Tipo" tendrá el valor "Tipo inválido".   

Tipo inválido


Al presionar Acciones, Detalle se visualiza el contenido sin traducción

                             

Panel de Colas de Mensajes

Permitirá enviar la información de tipos de Elementos de Fidelidad, tipos de Cupones, Segmentos y Transacciones, en caso de contingencia y que se desee enviar la información nuevamente, a la cola RabbitMQ, configurada para esta funcionalidad. 

Está funcionalidad deberá estar habilitada sólo para el rol de administrador.



Cuando se deshabilita el acceso al módulo de Cupones para la compañía que se está considerando:


Se deshabilitará la opción correspondiente en la Consola:

De la misma manera, si se deshabilita el acceso al módulo de Elementos de Fidelidad, se deshabilitará la opción correspondiente en la consola:

Y si ambos accesos están deshabilitados (Cupones y Elementos de Fidelidad), en la consola también estarán deshabilitados.

Lo mismo ocurre si se deshabilita el módulo de Transacciones, quedará deshabilitado en la consola:


Ante cualquier duda debe comunicarse con el administrador del sistema.

Si en Administración/ Información de Configuración, se modifica la siguiente configuración:

cambiando true por false y borrando el nombre de la cola configurada:

No estarán habilitados los módulos correspondientes:


Transacciones:

Configuración:

Para que el botón "Transacciones" esté habilitado deben configurarse en Administración/ Información de Configuración los siguientes campos:

rabbitMQ.producer.enabled debe estar en "true":


En rabbitMQ.producer.uri debe configurar la relacionada a la cola rabbit que utilizará:


rabbitMQ.producer.SSL.enabled debe estar en "false":


En rabbitMQ.transaction.endpointName debe configurar el nombre de la cola rabbitMQ que se utilizará para tal fin:

Utilización:

Al seleccionar el botón "Transacciones" mostrará un pop up que permitirá seleccionar "Desde" que fecha y hora y "Hasta" que fecha y hora serán las transacciones que se enviarán a la cola RabbitMQ. Aquí se tendrá en cuenta la fecha y hora de la transacción original, la misma debe entrar en el rango que se indique para ser reenviada a la cola RabbitMQ.

Luego de seleccionar el rango de fechas y hora que contenga a la transacción que se desea reenviar presionar el botón "Aplicar". De esa forma se volverá a enviar todas las transacciones contenidas dentro de ese rango de fechas indicado.

Debe esperar a que se ejecute el proceso que envía las transacciones a las colas RabbitMQ para que las mismas lleguen a destino.


Monitor de Integración


Al seleccionar Soporte\ Monitor de Integración, se mostrará la siguiente pantalla (a partir de Promo 7.4):

Muestra los campos:


Cada plugin mostrará a la derecha la acción de "Detalle". Si el plugin se encuentra activo, el botón estará habilitado. (Por configuración de Visualización del Detalle del plugin consultar el Manual de Instalación de Promo: Información de Configuración\ Parámetros de Configuración de ambiente).


Al seleccionar el botón "Detalle" sobre alguno de los plugins mostrados, abrirá una pantalla como la siguiente:

Al seleccionar el botón "Acciones" y luego "Descargar" sobre alguno de los campos mostrados, permitirá descargar localmente el log seleccionado.

Si selecciona el botón "Excel" que se encuentra en la parte superior de la pantalla, descargará en un archivo Excel el listado de logs que muestra en pantalla, como se muestra a continuación:


Si se selecciona en el menú de la izquierda la opción "Transacciones emitidas" mostrará la siguiente pantalla:





Capítulo 16 - Promociones Modelo

Apéndice I

Preguntas frecuentes


PROMO 7.4 - Manual del Usuario - Apéndices: Preguntas Frecuentes


 Apéndice II

Sugerencias de Promociones


PROMO 7.4 - Manual del Usuario - Apéndices: Sugerencias de Promociones


 Apéndice III

Promociones por medio de pago


PROMO 7.4 - Manual del Usuario - Apéndices: Promociones por Medio de Pago


 Apéndice IV

 Consideraciones - Módulo de Fidelidad

                     PROMO 7.4 - Manual del Usuario - Apéndices: Consideraciones - Módulo de Fidelidad


 Apéndice V

Configuración de Chequeo de Colisiones

                     PROMO 7.4 - Manual del Usuario - Apéndices: Configuración de chequeo de Colisiones


 Apéndice VI

Consideraciones - Alta Masiva de Promociones

PROMO 7.4 - Manual del Usuario - Apéndices: Alta Masiva de Promociones


Apéndice VII

Promociones Modelo

                     PROMO 7.4 - Manual del Usuario - Apéndices: Promociones Modelo


Apéndice VIII

Caché de Promociones

                   PROMO 7.4 - Manual del Usuario - Apéndices: Caché de Promociones

                                                                                      

Apéndice IX

Alarma de Límites

         PROMO 7.4 - Manual del Usuario - Apéndices: Alarma Movimientos en Límites


Apéndice X

Promociones con Devoluciones

            PROMO 7.4 - Manual del Usuario - Apéndices: Promociones con Devolución