Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

Versão 1 Próxima »










MANUAL DE USUARIO


PROMO v7.2




Índice 




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 y Listas de Precios.

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 Precios
Se describe la operatoria para la creación y administración de Listas de Precios.

Capítulo 9– 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 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


NOTA

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


IMPORTANTE

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


Documentación de PROMO

PROMO provee la siguiente documentación:


  • "Manual de Integración" - ("MANUAL DE INTEGRACIÓN - PROMO v7.2").
    Este documento describe detalladamente los mensajes que deben ser enviados al Motor de Promociones y la forma de interpretar los mensajes de respuesta que éste dará ante un requerimiento.


  • "Manual de Usuario" - ("MANUAL DE USUARIO  - PROMO v7.2"). 
    El presente manual de usuario tiene como finalidad servir de referencia y herramienta de consulta para todo usuario que desee utilizar PROMO, para la administración de sus promociones, cupones, y listas de precios.


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 ventas, 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, así como también se cuenta con un modulo de Precios, desde el cual podrán administrarse listas de precios diferenciales para los ítems presentes en la transacción independientemente de las promociones que puedan llegar a aplicarse.


Componentes de PROMO


  • Consola de administración:

Herramienta WEB para la administración de promociones, cupones y elementos de fidelidad, así como también alarmas y listas de precios. 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 crearlas, asociarlas a clientes, visualizar su historial y gestionar saldos.


  • Motor de promociones:

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:

  • Definir y administrar promociones. Componente responsable: la consola de administración. 
  • Definir y administrar plantillas de promociones. Componente responsable: la consola de administración. 
  • Definir y administrar cupones. Componente responsable: la consola de administración. 
  • Definir y administrar elementos de fidelidad. Componente responsable: la consola de administración. 
  • Definir y administrar roles de usuario de la consola de promociones. Componente responsable: la consola de administración.
  • Definir y administrar KPI. Componente responsable: la consola de administración.
  • Publicación en Redes Sociales. Componente responsable: la consola de administración. 
  • Resolver promociones e informarlas. Componente responsable: el motor de promociones.
  • Definir y administrar Alarmas. Componente responsable: la consola de administración. 
  • Administrar listas de precios. Componente responsable: la consola de administración. 

Limitaciones

  • PROMO no aplica las promociones sino que le informa al punto de venta como tiene que aplicarlas.
  • PROMO no es un POS.
  • PROMO delega la impresión y el cálculo del IVA e impuestos al punto de venta.
  • PROMO delega la impresión de cupones al punto de venta.
  • PROMO delega la impresión de etiquetas al retailer.


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 clientes 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, así como también se cuenta con la posibilidad de administrar listas de precios y gestión de etiquetas desde la consola de promociones.

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: 


  • IP-SERVIDOR: deberá ser reemplazado por la dirección IP de la máquina en la cual se encuentre en ejecución el servidor de aplicaciones.
  • PORT_INSTALACION: es el puerto de conexión (Ej.,: 8080)



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

  • Nombre de Usuario: admin
  • Contraseña: Promo2020
  • Compañía: "Compañía"

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

Vesión: indica la versión correspondiente a la aplicación. Ej: V.7.2.3

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.  Sera 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 mostrara, 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.2.


Menú de Navegación PROMO



IMPORTANTE

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.

  • Nombre: por medio de este dato, se podrá identificar al componente que se esté creando y será el nombre que se mostrará en los diferentes listados en los cuales pueda utilizarse. El campo nombre en todos los casos es un dato del tipo string de hasta 255 caracteres.
  • Descripción: por medio de este dato, se podrá ingresar una breve explicación aclaratoria del contenido del componente que se está creando. El campo descripción es en todos los casos un dato del tipo string de hasta 255 caracteres y cuyo ingreso no es obligatorio.


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:

  • Volver: botón que permite volver a la pantalla anterior.
  • Cancelar: botón cuya funcionalidad es la de cancelar el flujo operativo que se encontraba realizando el usuario. El usuario podrá cancelar en cualquier momento el procedimiento que se encontraba en curso volviendo al inicio del menú con el cual se encontraba trabajando.
  • Nuevo: botón que permite crear un nuevo componente, dependiendo de la ubicación del botón en la pantalla será el componente que se podrá crear.
  • Editar: botón que permite editar todos los registros del componente seleccionado de la pantalla en la cual se ubique el botón.
  • Guardar: botón que permite confirmar el procedimiento que se llevó a cabo.
  • Buscar o Filtrar: botón que permite efectuar una búsqueda indicando los valores deseados para un conjunto de filtros.


IMPORTANTE

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



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

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.

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.



IMPORTANTE

 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.



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 dafault, 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 agrupara.

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:

  • Nombre: nombre mediante el cual se identificará a la campaña.
  • Descripción: este campo puede ser utilizado por el usuario para ingresar toda la información necesaria respecto de la campaña que se está definiendo, para poder extender la descripción de la misma e identificarla en forma más sencilla. Este campo no es de carácter Obligatorio.
  • Fecha de inicio: indica la fecha en que entra en Vigencia la campaña.
  • Fecha de finalización: indica la fecha en que finalizará la vigencia de la campaña.
  • Canales de publicación: Se podrán seleccionar entre los distintos canales de publicación definidos. (Aparecerán más o menos opciones según los módulos adquiridos por el cliente.)
    • Punto de venta
    • Facebook
    • Twitter
  • Activo: Por medio de este check puede indicarse si la campaña que se está creando se encuentra Activa (Tildado) o no (Destildado). Por defecto todas las campañas se crearan en estado Activa.

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


IMPORTANTE

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é items 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 la nueva sección "Condiciones Generales" se pasará a la pantalla "Gestión de Condiciones Generales

Se puede buscar por los siguientes filtros:

                                                              Código de la condición General

                                                              Nombre de la condición general

                                                              Estado de la condición gral (Todo, Incompleta, Completa y Cancelada)

                                                              Vigencia de la condición gral. (Vigente/No Vigente)

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:

  • Nombre: nombre único de la condición. No podrá repetirse. Alfanumérico máximo 200 caracteres.
  • Código:  código único de la condición. No podrá repetirse. Alfanumérico máximo 20 caracteres
  • Descripción: Alfanumérico máximo 200 caracteres. 
  • Workflow: Podrá seleccionarse entre los múltiples workflows o pasos de aprobación definidos para dar como aprobada una Condición General.

A partir de esta versión se agregan los campos:

Tipo de Promociones : Se deberá seleccionar el tipo de promoción entre las opciones propuestas.(opcional,default todos).

Subtipo de  Promociones : Se deberá seleccionar el sub tipo de promoción entre las opciones propuestas(opcional,default todos).

Forma de aplicación de las promociones : Se deberá seleccionar la forma de aplicación de las promociones entre las opciones propuestas. (opcional, default todos).

Para indicar a qué tipo, subtipo y forma de aplicación y de esta forma cuando coincida la tipificación con la promoción se aplicara la condición gral.                                                                                     Indica qué ítems quedan incluidos/excluidos en la evaluación de las promociones vigentes en el mapa que las contenga.                                                                                                                                         El valor por default para los tres ítems 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.

En la pantalla "Definir Condición" solo se mostrarán las secciones "Cabecera", "Condiciones de Rango Horario" y "Condiciones Simples".

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:

  • Por Producto:  
    Podrán incluirse o excluirse ítems, ya sean definidos por SKU, marca o cualquier otro atributo del producto, de la evaluación de promociones.

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

Nota

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.


  • Por Cupones:

> 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, se evaluarán promociones.


  • Por Clientes:

> 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, se evaluarán promociones.


  • Por Medios de Pago:

> 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, se evaluarán promociones.


  • Por Elementos de Fidelidad:

> 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, se evaluarán promociones.


  • Por Transacción:

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



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, clientes, 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".


NOTA

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

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.

Estas acciones son:

  • Editar: Desde esta opción podrá accederse a la cabecera de la promoción. Solo estará disponible en caso de que la promoción este en estado "incompleta" o "completa". En caso de estar en estado "Distribuida", con la habilitación de edición dada por configuracion (deployedEditable.enabled) también estará disponible la opción editar.
  • Definir: Desde esta opción podrá accederse al cuerpo de la promoción. Solo estará disponible en caso de que la promoción este en estado "incompleta" o "completa". En caso de estar en estado "Distribuida", con la habilitación de edición dada por configuracion (deployedEditable.enabled) también estará disponible la opción definir.
  • Cambiar imagen: Podrá subirse o cambiarse una imagen asociada a la promoción.
  • Resumen: Muestra un PopUp con el detalle de la promoción.
  • Historial WF: Podrá visualizarse el circuito de Workflow por el que ha pasado la promoción.
  • Copiar: Podrá realizarse una nueva promoción a partir de la copia de una existente.
  • Distribuir: Podrá realizarse una distribución inmediata de la promoción. Los requisitos para que esta opción aparezca en el menú son:

      • Que la promoción haya sido distribuida a una tienda de Producción
      • Que la opción de Editar promociones distribuidas este habilitada por configuración en la consola de Promo (deployedEditable.enabled).
      • Que sobre la promoción se haya realizado algún cambio en su definición (condiciones y/o beneficios)

IMPORTANTE

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


IMPORTANTE

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



  • Condiciones Simples y/o por composición: Son las restricciones definidas para una promoción. Estas restricciones deben cumplirse para poder acceder al beneficio que la promoción otorgue. 

    Simples: son los requisitos que deben cumplirse para la obtención de un beneficio. Las condiciones simples se definirán por medio de elementos que pueden estar presentes dentro de una transacción como ser Productos, Cupones, Clientes, Eventos, Medios de pago, Elementos de fidelidad, Beneficio Externo y/o datos propios de la transacción (Tienda, Terminal, Canal, Cadena, Formato, Zona, Sub Zona). Cada uno de estos elementos tendrá asignados atributos o características que deberán cumplir los elementos para hacer más específica la configuración de la condición. Los atributos indicados en este manual son los del producto base, por lo que se deberá tener en cuenta que cada cliente puede extender y adaptar los atributos según las necesidades del negocio. 

    Por composición: son formas de agrupar elementos en paquetes o "combos" dentro del contexto para que los beneficios se apliquen sobre cada uno de estos conjuntos de elementos. Una condición por composición puede estar formado por N conjuntos de Productos, Cupones, Clientes, Medios de Pago y/o Elementos de fidelidad. 

    IMPORTANTE

    En las promociones por combo, el o los elementos a beneficiar, DEBEN estar definidos dentro de la misma condición por composición o combo.

  • Beneficios: Es una ventaja económica o material que se le otorga a un cliente ante el cumplimiento de ciertas condiciones. 



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:


PLANTILLAS DE PROMOCIONES
  • Plantillas de Promociones: Permite seleccionar una plantilla de promoción. (Para más detalle ir a Plantillas de Promociones)


CABECERA

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

  • Nombre de promoción: nombre mediante el cual se identificará a la promoción (obligatorio).
  • Código: indica el código interno de la promoción (es opcional y se puede configurar que sea obligatorio).


NOTA

Campo Código Clave:

Por default, el nombre de la promoción sera ú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 Nombrees 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 sera 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".

NOTA

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 deAdministració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 configuracion. 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.

  • Descripción: este campo puede ser utilizado por el usuario para ingresar toda la información necesaria respecto de la Promoción que se está definiendo. (opcional)
  • Workflow: Podrá seleccionarse entre los múltiples workflows o pasos de aprobación definidos para dar como aprobada una promoción.
  • Campaña: se deberá seleccionar alguna de las campañas definidas para promociones.
  • Canales de publicación: se deberá seleccionar entre los distintos canales de publicación definidos.
    • Punto de venta
    • Facebook
    • Twitter

NOTA

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

IMPORTANTE

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


  • Evaluar condición en combo: al tildar esta opción, se indica que la promoción que se está definiendo tendrá al menos una condición simple y una condición compuesta (combo). Al evaluarse las promociones con esta tilde, se chequeara que cada combo conformado en la transacción cumpla con la condición simple definida. De lo contrario, si la promoción se define sin este check activo, la o las condiciones se evaluaran de manera independientes unas de otras.
  • Reportar Participantes: Al tildar este check, cuando se evalué la promoción, se informarán al punto de venta todos los elementos que participaron de la condición y beneficios.
  • Tipo de promociones: se deberá seleccionar el tipo de promoción entre las opciones propuestas. (obligatorio).
  • Sub-tipo de promociones: deberá seleccionarse el sub-tipo de la promoción entre las opciones propuestas (obligatorio).

IMPORTANTE "Tipo, Sub-tipo y Formas de aplicación de la promoció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".

  • Formas de aplicación de promociones: deberá seleccionarse la forma de aplicación de promociones entre las opciones propuestas. (obligatorio).

Validación

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 o no y si considerará el stock para realizar la sugerencia.


  • Habilita sugerencias: Si no se activa esta opción, esta promoción no se tendrá en cuenta para realizar sugerencias al cliente. Si se activa esta opción: 

    Si el cliente informado en la transacción cumple la condición configurada en Condiciones Simples\ Cliente o Condiciones por Composicion\Clientes,  se mostrará la sugerencia. Si el cliente informado en la transacción no cumple con la condición no se mostrará la sugerencia. Que cumpla con la condición significa que lo que se configure en el atributo Clientes (Id, Tipo, Monto restante, Segmento, Perfil del cliente, Campaña crediticia, Factor de Conversión) debe venir en la transacción.

            Condiciones por composición:


Para mostrar las sugerencias 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

Nota

Si están habilitadas las sugerencias en la promoción y en el mapa, mostrará las sugerencias. O sea si el mapa dice "no mostrar sugerencias" no se mostrarán, si el mapa dice mostrar sugerencias pasa a depender de la promoción.


IMPORTANTE

Una vez habilitada la sugerencia debe habilitarse también en el mapa que contendrá la promoción. Ver detalles en: HABILITAR SUGERENCIAS EN EL MAPA.

Ejemplo:

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:

    • que está llevando el producto 1 pero no tiene cliente, va a sugerir la promoción,
    • que tiene Cliente pero es de otro Tipo, no la va a sugerir porque el Tipo no es el definido en la promoción,
    • que tiene Cliente Tipo=VIP pero no está llevando el producto 1, va a sugerir esta promoción.

Importante

Al activar el ckeck correspondiente a "Habilitar Sugerencia" y NO indicar un valor para el campo "mensaje del POS" y guardar los cambios, Promo emite un popup con leyenda "si la promoción incorpora sugerencias, debe ingresar el mensaje del punto de ventas" 


  • Sujeta a Stock: Si se habillita 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.

Hay un archivo que dice cuales son los productos que tienen stock y si esta promoción beneficia a un producto que está en ese archivo si tiene stock la va a sugerir y si no tiene stock no la va a sugerir. 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.

Ejemplo:

Se tiene armada una promoción que tiene habilitadas las dos opciones:  "Habilita sugerencias" y "Sujeta a stock" ,y en la mapa habilita sugerencia, en el "Mensaje del POS" se ingresó "Llevá el producto X y te 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 X, entonces Promo va a verificar si tiene stock del producto J y si lo tiene  le va a mostrar la sugerencia "Llevá el producto X y te 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.) si se puede ingresar varios SKU, si hay stock de alguno entonces va a sugerir la promoción.

Nota

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 SKU, y alguno tiene stock, la promoción será sugerible.

Importante

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.

    • Mensaje del POS: En este campo deberá ingresarse el mensaje a mostrar en la pantalla del POS cuando se sugiera la promoción.



IMAGEN ASOCIADA (FORMATO PNG ÚNICAMENTE)
  • Descripción de la imágen: este campo puede ser utilizado por el usuario para ingresar toda la información necesaria respecto de la imagen cargada.
  • Imagen asociada: Mostrará la imagen que se seleccione.
  • Subir Imagen: Se podrá cargar una imagen desde un directorio específico.

NOTA

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


Resumen de promoción:

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


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. 


  • Condición Fecha con hora:  Dentro de ésta condición se puede definir una condición por "fecha y hora" indicando desde y hasta.

Importante

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


  • Condición de hora: 
    Aquí puede definirse una condición de horario, definiendo en los campos desde y hasta, horas y minutos.


  • Condición de periodicidad: 
    Dentro de esta condición se puede definir a partir de una fecha inicial, cada cuántos días o semanas puede aplicarse la promoción. 
    Al seleccionar el botón Agregar\ Definir periodicidad, mostrará una pantalla como la siguiente:

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:

      • Aplica cada: x día/s: permite indicar por ejemplo que la promoción aplicará cada 2 días, a partir de la fecha de inicio indicada (en este ejemplo a partir del 26 de mayo):


      • Aplica cada: x semana/s: en este ejemplo a partir del 1 de mayo, cada 3 semanas, los días jueves aplicará la promoción. O sea por primera vez se aplicará el 21 de mayo.

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


      • Aplica cada x día/mes: permite indicar frecuencias como por ejemplo: el 4to Viernes del mes. En el campo anterior a día/mes mostrará las opciones: 1er, 2do, 3er y 4to:

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.


      • Aplica cada x día del mes: Este tipo de frecuencia permite indicar por ejemplo, que la promoción se aplicará el día 27 del mes. En el campo anterior a "día del mes", mostrará como opciones todos los números desde el 1 hasta el 31.

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:

    • Productos:
        • Código (SKU): Utilizado para determinar la selección de los artículos a través de su código SKU.
        • Precio Unitario: Atributo utilizado para determinar si el ítem integra el conjunto por el precio del mismo.
        • Marca: Utilizado para determinar la selección de los artículos a través de la marca del ítem.
        • Proveedor: Utilizado para determinar la selección de los artículos a través del proveedor del ítem.
        • Departamento: Utilizado para determinar la selección de los artículos a través de su departamento, se define como el primer nivel dentro de una jerarquía de productos.
        • Familia: Utilizado para determinar la selección de los artículos a través de la familia a la cual pertenece el ítem, se define como el segundo nivel dentro de una jerarquía de productos.
        • Categoría: Utilizado para determinar la selección de los artículos a través de la categoría a la cual pertenece el ítem, se define como el tercer nivel dentro de una jerarquía de productos.
        • Sub Categoría: Utilizado para determinar la selección de los artículos a través de la subcategoría la cual pertenece el ítem, se define como el cuarto nivel dentro de una jerarquía de productos.
        • Discontinuo: se utiliza para armar promociones con productos que quedaron en stock pero ya no ingresarán nuevos para reponer.
        • Baja Rotación: se utiliza para armar promociones con productos que no son los mas vendidos.
        • Producto Estrella: se utiliza para armar promociones con los productos mas vendidos.
        • Opción de Canje de Puntos: se utiliza para armar promociones de canje de puntos.
        • C. Producto: se puede armar promociones indicando el Código del Producto del Retail.
        • Barcode: Utilizado para determinar la selección de los artículos a través de su código de barras.
        • Aplica a TODOS: De seleccionar esta opción se estará incluyendo en el conjunto de la condición a todos los ítems que puedan ingresarse a la transacción, sin considerar los atributos particulares de cada uno.


Recomendación

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



    • Cupones:
        • Tipo: se puede utilizar para definir el tipo de cupón que se desean integren el conjunto.
        • Id: se utiliza para definir el id o número de cupón que se desea integren el conjunto.
        • Aplica a TODOS: De seleccionar esta opción se estará incluyendo en el conjunto de la condición a todos los cupones que puedan ingresarse a la transacción, sin considerar los atributos particulares de cada uno.

Importante

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)



    • Clientes:
          • Tipo: se puede utilizar para definir el tipo de cliente que integrará el conjunto (Ej.: empleado, cliente normal, cliente frecuente, etc.).
          • Id: se utiliza para definir el id o número de cliente que se desea integren el conjunto.
          • Monto restante: para promociones especiales en las cuales se necesite limitar el importe sobre el cual aplicar un X descuento, relacionado con el cliente que se haya ingresado en el ticket.
          • Segmento: Podrá indicarse si el cliente participante de la promoción que se define pertenece a algún segmento o rango de cliente en particular.
          • Perfil del Cliente: se utiliza para definir una categoría de cliente.
          • Campaña Crediticia: se utiliza para indicar la campaña que puede utilizar el cliente.
          • Factor de Conversión
          • Aplica a TODOS: De seleccionar esta opción se estará incluyendo en el conjunto de la condición a todos los clientes que puedan ingresarse a la transacción, sin considerar los atributos particulares de cada uno.

  • Importante

    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)


    • Eventos: Un evento es un suceso o acontecimiento que se produce dentro de la transacción que puede determinar una acción a seguir a partir de la ocurrencia del mismo. Por Ejemplo, el cliente número 10.000. 

        • Número: se utiliza para definir el id o número de evento.
        • Tipo de transacción: se puede utilizar para definir el tipo de evento.
        • Valor: se utiliza para definir un posible valor que debiera tener el evento.
        • Aplica a TODOS: De seleccionar esta opción se estará incluyendo en el conjunto de la condición a todos los eventos que puedan ingresarse a la transacción, sin considerar los atributos particulares de cada uno.


    • Medios de Pago:
        • Código: se utiliza para definir el id o código de medio de pago que se desea integre el conjunto.
        • Tipo: se puede utilizar para definir el tipo de pago que se desea integre el conjunto.
        • Banco: se puede utilizar para definir el banco emisor del medio de pago que se desea integre el conjunto.
        • Plan: se utiliza para definir el o los planes que debiera cumplir el medio de pago para integrar el conjunto.
        • Cuotas: se utiliza para definir la cantidad de cuotas del plan.
        • Prefijo: se utiliza para definir el prefijo que deberá tener el medio de pago para integrar el conjunto.
        • Bolsillo: Podrá indicarse a que bolsillo o subtipo de tarjeta se evaluara como condición. Ejemplo, Tarjeta A, Bolsillo Combustible. Cuando se defina una condición por el atributo "Bolsillo" se requerirá la carga previa de una condición por el atributo "Prefijo" del elemento Medio de Pago.
        • Grupo de prefijos: se puede utilizar para definir el Grupo de prefijo, dado de alta en Promo, que se desea integre el conjunto.
        • Campaña Crediticia: se utiliza para definir una campaña relacionada con un medio de pago.
        • Aplica a TODOS: De seleccionar esta opción se estará incluyendo en el conjunto de la condición a todos los medios de pago que puedan ingresarse a la transacción, sin considerar los atributos particulares de cada uno.


    • Elemento de Fidelidad:
        • Id: se utiliza para definir el id o número del o los elementos de fidelidad que se desea integren el conjunto.
        • Tipo: se utiliza para definir el tipo del o los elementos de fidelidad que se desea integren el conjunto.
        • Convenio: se utiliza para definir el convenio al que pertenecerá el elemento que se desea integren el conjunto.
        • Aplica a TODOS: De seleccionar esta opción se estará incluyendo en el conjunto de la condición a todos los elementos de fidelidad que puedan ingresarse a la transacción, sin considerar los atributos particulares de cada uno.

    • Beneficio Externoes un beneficio informado por el POS y el motor de Promo lo devolverá como propio.

        • Id: se utiliza para definir el Identificador del beneficio.
        • Tipo: se utiliza para definir el Tipo de beneficio.


    • Transacción:

        • Terminal: se utiliza para definir el id o número de terminal que se desea integre el conjunto.
        • Tienda: se utiliza para definir el id o número de tienda que se desea integre el conjunto. Sólo estarán disponibles las tinedas que tenga configurado el usuario logueado.
                  

        • Canal: vía o canal desde el cual se esa realizando la venta.
        • Cadena: cadena o linea desde el cual se esa realizando la venta.
        • Formato: es un atributo que aplicará al tipo de retail que tenga que evaluar. Por ejemplo: hiper mercado, mercado, super mercado, mayorista. Estos son ejemplos, ya que cada cliente podrá utilizarlo según sus necesidades.
        • Zona: zona geográfica desde la que se hace la transacción.
        • Sub Zona: sub zona geográfica desde la que se hace la transacción.
        • Moneda: se podrá utilizar multimoneda. Permitirá seleccionar para que tipo de moneda aplicará la promoción. Al momento de hacer la transacción en el POS se podrá elegir la moneda, esa información llegará a Promo y dependiendo del tipo de moneda recibido aplicará o no la promoción.

Nota

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


Importante

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)



Multimoneda

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:

      • IGUAL
      • DISTINTO
      • MAYOR
      • MENOR


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: 


    • "Y" ADEMÁS QUE SE CUMPLA: Los elementos que se definan bajo éste operador deberán cumplirse siempre. Permite combinar dos o más condiciones en una condición compuesta que se dará como cumplida si todas las condiciones integrantes se cumplen. 

    • "O" QUE SE CUMPLA: Los elementos que se definan bajo éste operador pueden cumplirse o no. Permite combinar dos o más condiciones en una condición compuesta que se dará como cumplida si al menos una de las condiciones integrantes se cumple. 

Exportación de datos de una Condición Simple o Condición por Composición a Excel ("a partir de vEP2.2):

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:

      • Promo_2655_CondicionSimple_Producto_SKU


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 ("a partir de vEP2.2):

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.

NOTA

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



  • Condiciones Simples - Agrupación

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:

      • SIN AGRUPACIÓN
      • MENOR O IGUAL A
      • MENOR A
      • MAYOR O IGUAL A
      • MAYOR QUE


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:

Si en lugar del elemento "Producto" se había seleccionado el elemento "Clientes", los criterios de agrupación a mostrarse serán "Saldos" y "Puntos".

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

      • Producto
        • Cantidad: Se utiliza para determinar una determinada cantidad de determinado artículo.
        • Magnitud: Atributo utilizado para determinar una magnitud, como:

            • peso (para artículos pesables: alimentos, etc.)
            • longitud (para artículos que se comercializan por metro: telas, alfombras, etc.)
            • volumen (para artículos que se comercializan a granel o por volumen - metro cúbico o metro cuadrado – Ej.: arena, cerámicos, etc.).
        • Precio Total: Se utiliza para definir el precio total de todos los elementos definidos.
      • Cupón
        • Cantidad: se utiliza para definir la cantidad de cupones que se desean integren el conjunto.
        • Monto: se utiliza para definir el importe que deberán sumar los cupones que integran el conjunto
      • Medios de Pago
        • Monto


Agrupación por "Pago Total"

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 items beneficiados.


      • Clientes
        • Saldos
        • Puntos
      • Elementos de fidelidad
        • Monto


Otros ejemplos de agrupación podrían ser:


      • La cantidad de los productos en la transacción sea mayor a 10 unidades.


      • La compra mínima sea de 1500 pesos.


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)

  • Promoción es por Composición o Combo
     
    • Ejemplo: MxN, Compre A + B Gratis B o Compra A + B +C a un precio especial.


Un combo puede estar compuesto por N componentes.

IMPORTANTE

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:

  • Límite de aplicación: Indica el límite máximo de combo a formar dentro de una transacción. Este parámetro no admite como valor el 0 (cero), pero si no se define un Límite (dejando el casillero en blanco) podrán formarse cuantos combos sean posibles por transacción. El campo no es obligatorio.
  • Tipo de elementos: Elementos con los cuales se armarán los combos, y son definidos en la primera instancia de la definición de condición por composición (productos, cupones, clientes, medios de pago y elementos de fidelidad).
  • Ocurrencias Mínimas: Valor real que representa la cantidad mínima necesaria para componer la condición por composición o combo. Este parámetro no admite como valor el 0 (cero).
  • Ocurrencias Máximas: Valor real que representa la cantidad máxima necesaria para componer la condición. Este parámetro no admite como valor el 0 (cero).

NOTA

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


  • Unidad de medida: Este parámetro define el criterio con el cual se realizará la agrupación del conjunto. 

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 "Clientes", 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.

  • Criterio de ordenamiento: Indica el criterio de ordenamiento de los elementos del conjunto definido. (Los más caros primero, Uno más caro por combo, Los más baratos primero, Uno más barato por combo)
  • Criterio de equivalencia: Este tipo de parámetro indicará los atributos por los cuales podrá definirse una equivalencia o igualdad entre los elementos que conformarán el conjunto, por ejemplo, "Llevando dos jugos del mismo sabor, 2X1 en jugos de Marca X", en este caso el criterio de equivalencia seria el código de los Jugos de la marca X ya que agrupará cada dos del mismo sabor.
  • Criterio de inequivalencia: Este tipo de parámetro indicará los atributos por los cuales podrá definirse una inequivalencia o desigualdad entre los elementos que conformarán el conjunto, por ejemplo, "Llevando dos jugos de distinto sabor, 2X1 en jugos de Marca X", en este caso el criterio de inequivalencia sería el código de los Jugos de la marga X ya que agrupará cada dos jugos de distinto sabor.


NOTA

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 Item, 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 definido.

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



Se presentara la pantalla "Nuevo Beneficio" en donde se mostraran las siguientes opciones:

  • Promoción: Muestra el nombre de la promoción.
  • Aplica sobre condiciones?: Por defecto este casillero se encontrará tildado, por lo que el beneficio se aplicara sobre los mimos elementos definidos en la condición. De des-tildarse al momento de dar de alta el beneficio, el universo de aplicación del beneficio deberá definirse manualmente, pudiendo indicar otro/s elemento/s que no formen parte de la condición. En caso de optar por utilizar los mismos elementos para la definición del universo de aplicación, podrá editarse este ultimo, pero de hacerlo, el check "Aplica sobre condiciones" se destilará automáticamente, ya que el conjunto beneficiado dejara de ser el mismo que el conjunto de la condición. En la edición de los beneficio este check permanecerá grisado.
  • Tipo de beneficio: Se refiere si el beneficio es Monetario o No Monetario. De este valor dependerá el comportamiento del beneficio.


Beneficios Monetarios:


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

  • Canje de Cupón Calculado: se aplicará el monto de descuento informado por el cupón ingresado a la transacción. (Para visualizar esta opción el cliente deberá haber adquirido el módulo de fidelidad de PROMO).





Canje de cupón calculado: Acumular el monto de beneficios en un cupón único

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

Ej: se crea la promocion:

Se realiza una venta:

Al crear un mapa, si se indica en el beneficio que aplica, se generará en el mapa, en el beneficio de cupón calculado,  el siguiente atributo accumulateInSingleCoupon en true:

Realizo una venta:

Y al estar destildado, tendrá un valor false:


  • Beneficio Externo: es un beneficio informado por el POS y que el motor de Promo lo devuelve como propio. Se debe indicar el ID del beneficio externo que se aplicará.

Beneficio Externo

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 sera 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)


  • Canje con Opciones: En esta clase de Beneficio, podrá indicarse, en base a los puntos presentados por el cliente, que opciones de beneficios monetarios accederá, entre los cuales están: "Descuento Fijo", "Descuento Porcentaje" y "Nuevo Precio".  Estas opciones de beneficio serán informadas al POS, para que el cliente elija y según lo elegido, se aplicará el beneficio correspondiente.

NOTA: Canje con Opciones

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)


IMPORTANTE

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

Beneficio Canje con Opciones Evaluado en un paso Maximo Descuento Combinado

A partir esta  versión se habilita 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 opcion 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.


IMPORTANTE

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.

Calculo de puntos a otorgar cuando en la misma transacción se aplica un beneficio Canje con opciones donde se redimen puntos

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



  • Descuento Fijo: se le aplica un descuento de un monto fijo sobre el precio de los elementos del conjunto ítem que se haya seleccionado. Puede aplicarse sobre cada unidad (sobre la cantidad o sobre la magnitud) o sobre todos los elementos del conjunto.
  • Descuento Porcentaje: se le aplica un porcentaje de descuento sobre el precio de los elementos del conjunto ítem que se haya seleccionado. Puede aplicarse sobre cada unidad (sobre la cantidad o sobre la magnitud) o sobre todos los elementos del conjunto.
  • Nuevo Precio: se le asigna un Nuevo Precio a los elementos del tipo producto que se haya seleccionado y se  aplica como descuento la diferencia entre el precio original y el nuevo precio. Puede aplicarse sobre cada unidad (sobre la cantidad o sobre la magnitud) o sobre todos los elementos del conjunto. Por ejemplo: si el producto vale $10 y el nuevo precio es $8, le da un descuento de $2. Cuando debe aplicarse un nuevo precio, el motor calculara la diferencia ente el precio del producto y el nuevo precio informado por el beneficio, y aplicara como descuento o recargo, según corresponda.

Aplicacion Nuevo precio informado por Externo

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 item desde el pos.

Esto podrá indicarse colocando un tilde en "Precio informado por el POS". Al hacerlo se grisada el campo de definición de nuevo precio y cantidad ya que este dato se informara desde el pos.



  • Canje de Puntos: se aplica un descuento calculado por la promoción, en base a la cantidad de puntos, dinero, montos, etc. Ingresados a la transacción al presentar el elemento de fidelidad que los contiene. (Para visualizar esta opción el cliente deberá haber adquirido el módulo de fidelidad de PROMO)
  • Descuento por convenio: se aplicara un porcentaje de descuento sobre el precio de  los elementos del conjunto de items participantes. Puede aplicarse sobre cada unidad (sobre la cantidad o sobre la magnitud) o sobre todos los elementos del conjunto. Este beneficio operara de la misma forma que el "Descuento por porcentaje" solo que cuando se defina en él un limite, éste solo podrá ser por Clientes y acumulara solamente Dinero. En los casos en que se aplique este beneficio, y se haya identificado en la transacción un cliente, sobre él se acumulara el monto del descuento aplicado y este se ajustara el descuento al limite definido sin poseer un margen para excederse (Estos tipos de beneficio solo podrán aplicarse sobre los elementos del tipo producto.)

    Definición de "Balance" en Beneficio Monetario "Descuento por Convenio"

    Podrá indicarse, al momento de definir el beneficio Monetario, Descuento por Convenio, si el limite del cliente a considerar para el calculo del monto del descuento a aplicar en este beneficio, es el gestionado por Promo o si el saldo del cliente será informado desde el POS.

    En caso de ser informado por el pos, deberá indicarse en el campo "Balance", pudiendo seleccionarse entre la opciones que se ingresan por el catalo de Balance, según se haya integrado con el pos.

    A partir de Promo 7.2


    (Para mas información Ver Manual de Integración Promo 7.2 - Beneficios)

  • Canje de Puntos por Catálogo:   se aplica un descuento Porcentual, Fijo o Cambio de Precio acorde a una tabla predefinida para determinados productos (ver Catálogos) a cambio de una cantidad de puntos también definida en la misma tabla. 

    (Estos tipos de beneficio sólo podrán aplicarse sobre los elementos del tipo producto.)

Caso de Uso: Canje de Puntos por Catalogo

Debera 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 oren 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 table. (ejemplo: La condición de la pomo indica "Para todos los Produtos de la marca Sony", y en la tabla se deberan indicar SKU que correspondan con la maca Sony)

Store (codigo de la tienda donde aplica, - indica todas)

code (codigo del producto)

points(puntos requeridos)

discountValue (Valor descuento)

discountType (Tipo descuento)

B320

1000

100

10

perc

-3000305perc
B32020006027fix
A922

1001

80

1500

fix

B320

1002

70

487.89

nprice

  • En el caso de que no se indique el codigo de tienda se asume que dicha opcion 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 item code="2000"


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

    • Monto, Porcentaje o Precio según corresponda al beneficio monetario seleccionado.
    • Unidad de medida sobre la cual aplicar. Este parámetro permite definir sobre que se aplicará el beneficio. Pudiéndose seleccionar entre Cada unidad de cantidad, Cada unidad de magnitud Todo
    • Porcentaje, cantidad y tipo si es que se trata de un cupón calculado.
    • Tipo y Factor: De tratarse de un beneficio de canje de puntos.
    • Valor de Recupero: se utiliza para indicar el valor que va a competir con otra promoción en el análisis del mapa, si se utiliza esta promoción con una función de "Máximo descuento combinado", y si da como beneficio el mismo valor que otra promoción en ese mismo mapa bajo la misma función. Se otorgará la promoción que en este campo tenga el mayor valor. Por ej: si dos promociones dan $5 de beneficio y las dos se encuentran en un mapa bajo la función "Máximo descuento combinado", si la promo A, tiene un "Valor de recupero" de 3 y "Tipo de Recupero" es por ej. porcentaje y la promo B tiene un "Valor de recupero" de 5 y "Tipo de Recupero" también es porcentaje, se otorgará el beneficio de la promo B.
    • Tipo de Recupero: permite seleccionar si el valor indicado en el campo anterior es de tipo porcentaje o monto fijo.
    • Prorratear entre participantes: podrá indicarse si el monto del descuento otorgado por el beneficio monetario definido será prorrateado entre los participantes de la condición de la promoción. Ej.: "Comprando unas papas, una hamburguesa y una gaseosa, se beneficia el mas barato al 100% y el monto del descuento es distribuido proporcionalmente entro los 3 ítems que participan de la condición".

Caso de uso : Prorrateo entre participantes

Cuando un beneficio, tenga tildada la opción de "Prorratear entre Participantes", el monto del descuento a otorgar será distribuido proporcionalmente entre los ítems participantes de la promoción. Por Ejemplo:

En la promoción "Comprando una Hamburguesa y una Gaseosa, lleve las papas gratis", la condición se cumplirá cuando los tres ítems se encuentren en el ticket, y el beneficio se aplicara sobre las papas, por ejemplo, el monto de descuento (100% sobre las papas) es de $75. Al encontrarse tildada la opción "Prorratear entre Participantes", los $75 de descuento no se aplicara solo sobre el item de las papas, sino que cada item se llevara una parte proporcional del moto total de descuento. Quedando los ítems participantes afectados por el descuento:

Item$ VentaMonto de Descuento
Hamburguesa$150

$35,71

Gaseosa$90$21,43
Papas$75$17,86



RECUPERO en Beneficios Monetarios

Cuando se defina un beneficio monetario podrá indicarse que tipo y valor de recupero tendrá ese beneficio de cara al Retail. De esta forma el beneficio podrá ser identificado desde pos y podrá el retail detectar cual es su margen de ganancia según se definan estos campos.

Este valor del recupero será tenido en cuenta cuando el beneficio sea parte de una función de convivencia "Máximo Descuento combinado". De esta forma, cuando dos beneficios dentro de esta función de convivencia otorguen el mismo monto de descuento sobre un mismo universo de aplicación, el motor podrá detectar y aplicar el descuento que tenga definido el mayor monto de recupero.


Obligatoriedad de los campos de recupero

Cuando se cargue alguno de los campos de recupero ("Valor" o "Tipo") el otro campo será requerido como de carga obligatoria (a partir de EP2.2)




Beneficios NO Monetarios:

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

  • Beneficio General:  la aplicación del beneficio es la entrega de uno o más beneficios generales que deberán ser interpretados por el pos según corresponda la integración. (Ejemplos de integración: Devolución del IVA - Caso Éxito - El pos es quien calculará el monto del IVA de los items y Promo, en base a la aplicación de este beneficio, indicara sobre que items aplicará beneficio).
  • Monedero : para poder verlo debe ser activada la funcionalidad Monedero por el Usuario Principal. Por default la funcionalidad Monedero viene desactivada. Es un beneficio sólo informativo.


Información sobre Monedero

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  = https://demo.napse.global:8554/v1/configuration?merchantCode=65

la url para obtener los Monederos de Vtol.

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.


  • Cupón: la aplicación del beneficio es emitir cupones.

IMPORTANTE.

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.


Datos para el Pos

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:



  • 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 visualizar esta opción el cliente deberá haber adquirido el módulo de fidelidad de PROMO).


Aplicación del Cupón Calculado

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.


IMPORTANTE

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 sera informado por el POS (o un externo)


Emisión de cupones calculados considerando descuentos que modifiquen el saldo del producto beneficiado en un mismo paso (adjustCalculatedCoupon)

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 7.2) 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.






  • Coeficiente de fidelización: la aplicación del beneficio es otorgar un factor de multiplicación para la unidad utilizada para los sistemas de fidelidad.

  • Porcentaje de fidelización: se aplica el porcentaje de puntos sobre el precio de los elementos del conjunto de ítems que se haya seleccionado. Permite calcular los puntos que corresponden otorgar en base al porcentaje y al precio extendido de los artículos sobre los que aplica.

  • Puntos de fidelización: la aplicación del beneficio es otorgar puntos, millas, pesos a un monedero electrónico o la unidad utilizada para los sistemas de fidelidad. El motor de promociones calcula los puntos que otorga este beneficio, el cual, puede aplicarse sobre cada unidad (sobre la cantidad o sobre la magnitud) o sobre todos los elementos del conjunto. Es decir, que ahora será posible definir mediante este beneficio, ventajas como: otorga puntos por cada artículo del departamento X u otorga P puntos en la compra de artículos del departamento X.



A partir de esta versión, se incorpora en los beneficios que otorgan puntos (factor, coeficiente y puntos de fidelización) 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.


Caso Practico:

  • Promoción 1: Canje con Opciones (Redime puntos - "Pago Puntos")

  • Promoción 2: Coeficiente de fidelización (Otorga Puntos)

Mapa

  • Paso1:
    • Promoción 1 (bajo función Todas)
  • Paso 2:
    • Promoción 2 (bajo función Todas)


Se vende un item de $43900


El motor informara la aplicación del beneficio Canje con opciones, donde el cliente deberá de elegir consumir los 500 puntos para acceder al beneficio del -20% sobre el ítem vendido.

También el motor informara, en este punto, que se están otorgando 62 puntos por la aplicación del beneficio de coeficiente de fidelización.

<?xml version="1.0" encoding="UTF-8"?><message ack="0" channel="T" companyId="napse" engine="7.1.7-SNAPSHOT" mapversion="712" messageId="" store="0013" terminal="022">
  <optional>
    <promo code="4280468" id="Canje con opciones - Redime puntos" nro="61545e4116f79a304cced688">
      <benefit TLOGMessage="Canje con opciones" a789="1" account="" applicationMethod="lineByLine" baseAmount="43900" benefitType="RedeemWithOptionsBenefit" displayMessage="Canje con opciones" name="61545e4116f79a304cced688" nro="6154627416f79a304cced6a8" order="1" printerMessage="Canje con opciones" prorationMethod="PROPORTIONAL" usedPoints="0">
        <apply>
          <item magnitude="0.000" qty="1.000" seq="1" value="0" valueWithTaxes="0" xprice="43900"/>
        </apply>
        <redeemOptions>dfgdfgdfgdfg
          <option benefitType="percentageDiscount" cardPoints="0.0" cardType="-" id="6154627416f79a304cced6a8_0" requiredPoints="500.0" unit="qty" value="20.0"/>
        </redeemOptions>
      </benefit>
    </promo>
    <promo code="4280467" id="Otorga Puntos" nro="6153983116f79a304cced625">
      <benefit TLOGMessage="Otorga Puntos de Fidelidad" account="" applicationMethod="lineByLine" baseAmount="43900" benefitType="FactorLoyaltyBenefit" displayMessage="Otorga Puntos de Fidelidad" name="6153983116f79a304cced625" nro="61545cc816f79a304cced685" factor="0" order="2" printerMessage="Otorga Puntos de Fidelidad" totalpoints="62" type="external">
        <apply>
          <item magnitude="0.000" points="62.71" qty="1.000" seq="1" value="0" valueWithTaxes="0" xprice="43900"/>
        </apply>
      </benefit>
    </promo>
  </optional>
</message>


Al enviarse desde el pos la aplicación de la opción de canje de puntos elegida por el cliente, el motor devolverá el beneficio de canje con opciones ya con la información correspondiente al consumo de los 500 Puntos así como el valor del descuento aplicado.

En este punto, al detectarse en el motor que se realizara un "pago" con puntos correspondiente a la aplicación de canje con opciones, el beneficio que otorga puntos se vera afectado y se informara el nuevo monto de puntos, que en este caso sera de 50.

<?xml version="1.0" encoding="UTF-8"?><message ack="0" channel="T" companyId="napse" engine="7.1.7-SNAPSHOT" mapversion="712" messageId="" store="0013" terminal="022">
  <optional>
    <promo code="4280468" id="Canje con opciones - Redime puntos" nro="61545e4116f79a304cced688">
      <benefit TLOGMessage="Canje con opciones" a789="1" account="" applicationMethod="lineByLine" baseAmount="43900" benefitType="RedeemWithOptionsBenefit" displayMessage="Canje con opciones" name="61545e4116f79a304cced688" nro="6154627416f79a304cced6a8" order="1" printerMessage="Canje con opciones" prorationMethod="PROPORTIONAL" usedPoints="500">
        <apply>
          <item benefitTypeOption="percentageDiscount" benefitUnitOption="qty" cardType="-" cardUsedPoints="0" magnitude="0.000" nominalDiscount="8780" percentageDiscount="20" priceinPoints="6271" qty="1.000" redeemOption="6154627416f79a304cced6a8_0" seq="1" usedPoints="500" value="5280" valuePoints="3500" valueWithTaxes="5280" xprice="43900"/>
        </apply>
      </benefit>
    </promo>
    <promo code="4280467" id="Otorga Puntos" nro="6153983116f79a304cced625">
      <benefit TLOGMessage="Otorga Puntos de Fidelidad" account="" applicationMethod="lineByLine" baseAmount="35120" benefitType="FactorLoyaltyBenefit" displayMessage="Otorga Puntos de Fidelidad" name="6153983116f79a304cced625" nro="61545cc816f79a304cced685" factor="0" order="2" printerMessage="Otorga Puntos de Fidelidad" totalpoints="50" type="external">
        <apply>
          <item magnitude="0.000" points="50.17" qty="1.000" seq="1" value="0" valueWithTaxes="0" xprice="43900"/>
        </apply>
      </benefit>
    </promo>
  </optional>
</message>


El cliente podrá luego optar por saldar la transacción también con puntos de fidelidad, y podrá solicitar al motor que dicho pago con puntos no sea tomado en cuenta para el calculo de los puntos ya otorgados por la promoción 2.

Para esto, deberá incorporarse en la mensajería que informa el pago (<payment-add/>) el atributo pointsType=, informando allí el tipo de tarjeta que acumula los puntos o en caso de tratarse de puntos externos, la palabra "external"

<?xml version="1.0" encoding="UTF-8"?>
<message channel="T" cia="1" ciudad="58" companyId="napse" date-time="2021-08-30 18:23:17" evaluate="true" format="H" init-tck="false" limitBalances="true" localidad="1" map-version="712"
 status="sale" store="0013" storeChain="S" subZone="1" terminal="022" tipologia="hi" zonaprecio="E22" zone="1">
<payment-add amount="35120" balance="true" itemamount="35120" pointsType="external" seq="2" type="11"/>
</message>


De esta forma, el motor incorporara al mensaje enviado al POS el nuevo beneficio "PromotionPaidInPoints" donde se informaran los puntos que deberán ser descontados de los puntos ya otorgados previamente.

<?xml version="1.0" encoding="UTF-8"?><message ack="0" channel="T" companyId="napse" engine="7.1.7-SNAPSHOT" mapversion="712" messageId="" store="0013" terminal="022">
  <optional>
    <promo code="4280468" id="Canje con opciones - Redime puntos" nro="61545e4116f79a304cced688">
      <benefit TLOGMessage="Canje con opciones" a789="1" account="" applicationMethod="lineByLine" baseAmount="43900" benefitType="RedeemWithOptionsBenefit" displayMessage="Canje con opciones" name="61545e4116f79a304cced688" nro="6154627416f79a304cced6a8" order="1" printerMessage="Canje con opciones" prorationMethod="PROPORTIONAL" usedPoints="500">
        <apply>
          <item benefitTypeOption="percentageDiscount" benefitUnitOption="qty" cardType="-" cardUsedPoints="0" magnitude="0.000" nominalDiscount="8780" percentageDiscount="20" priceinPoints="6271" qty="1.000" redeemOption="6154627416f79a304cced6a8_0" seq="1" usedPoints="500" value="5280" valuePoints="3500" valueWithTaxes="5280" xprice="43900"/>
        </apply>
      </benefit>
    </promo>
    <promo code="4280467" id="Otorga Puntos" nro="6153983116f79a304cced625">
      <benefit TLOGMessage="Otorga Puntos de Fidelidad" account="" applicationMethod="lineByLine" baseAmount="35120" benefitType="FactorLoyaltyBenefit" displayMessage="Otorga Puntos de Fidelidad" name="6153983116f79a304cced625" nro="61545cc816f79a304cced685" factor="0" order="2" printerMessage="Otorga Puntos de Fidelidad" totalpoints="50" type="external">
        <apply>
          <item magnitude="0.000" points="50.17" qty="1.000" seq="1" value="0" valueWithTaxes="0" xprice="43900"/>
        </apply>
      </benefit>
    </promo>
    <promo id="PromotionPaidInPoints" nro="0">
      <benefit TLOGMessage="" account="" applicationMethod="" baseAmount="35120" benefitType="LoyaltyBenefit" displayMessage="" order="3" printerMessage="" totalpoints="-5" type="external" unit="" value="-5">
        <apply>
          <item magnitude="0.000" points="-4.99" qty="1.000" seq="1" value="0" valueWithTaxes="0" xprice="35120"/>
        </apply>
      </benefit>
    </promo>
  </optional>
</message>

Luego de que se reciba esa información del motor, el POS hará el calculo descontando de los puntos a otorgar para el type=external (el utilizado en este ejemplo) los puntos que se informen en la promoción “PromotionPaidInPoints”.

(Para mas información sobre los cálculos utilizados en la aplicación del beneficio "PromotionPaidInPoints" ver manual de integración Promo 7 - Motor)

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

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


  • Regalo: la aplicación del beneficio es otorgar un regalo de algún artículo o premio extra (generalmente son artículos o servicios no comercializados por la compañía, por ejemplo: regalar entradas para el cine, ofrecer el servicio de taxi gratis).
  • Plan de pagos: la aplicación del beneficio es otorgar planes de pago. Deberá habilitarse para la correcta aplicación del beneficio "Plan de pago" la opción de "Promoción Codificada" desde Administración >> Información de Configuración.


Plan de Pago VTol

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 id 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 - id. 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 id del PaymentPlanList seguido del name del provider id + el valor del payment que corresponden a ese id 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.


  • Reintegro Bancario: la aplicación del beneficio es otorgar un reintegro bancario. Deberá habilitarse para la correcta aplicación del beneficio "Plan de pago" la opción de "Promoción Codificada" desde Administración >> Información de Configuración.

NOTA

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.


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


    • Coeficiente de Puntos de Fidelización, indica el Tipo de Puntos y Factor.
    • Cupón, pudiendo indicar "cantidad" y "Tipo/Identificador"(Si se adquirió el Modulo de Fidelidad. se presentará para la selección un combo con los tipos de cupones activos)
    • Plan de Pago, pudiendo seleccionarse entre Plan de Pago, Tipo de Pago, Medio de Pago, Cuentas, Banco, Monto Limite, Prefijo, Porcentaje, Descuento/Recargo.
    • Porcentaje de Fidelización, pudiendo seleccionarse entre Porcentaje del precio en puntos y Tipo.
    • Puntos de Fidelización, pudiendo seleccionarse entre Cantidad, Tipo y Por cada unidad de.
    • Regalo, pudiendo seleccionarse entre Cantidad, Id y Tipo.
    • Cupón Calculado, pudiendo seleccionarse entre Porcentaje, Cantidad y Tipo.


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


  • Aplicación máxima(valor): valor máximo a aplicarse del beneficio

Nota

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

  • Aplicación máxima (medida): en aquellos casos en los cuales se desea limitar la aplicación del beneficio, se podrá seleccionar el atributo sobre el cual limitarlo. Las opciones son: Cantidad, precio y magnitud.
  • Descuento mínimo a aplicar: valor mínimo a aplicar en el beneficio. Es solo por monto y como "mínimo" se otorga ese monto, siempre que no supere el valor del producto. Ejemplos: Si el valor mínimo está definido en: 1.0. Si el beneficio es 0.5 le da 1 (osea da como mínimo el valor mínimo configurado). Si el beneficio es 1.2 le da 1.2 (da el beneficio porque como mínimo da el valor mínimo configurado, si el beneficio es mayor da el beneficio).
  • Método de prorrateo: representa la manera en que PROMO distribuirá el beneficio monetario otorgado entre todos los artículos afectados. Las opciones habilitadas son:
    • Proporcional: Refiere a distribuir el beneficio proporcionalmente entre todos los productos.
    • Más caro primero:  Refiere a ordenar de mayor a menor los productos beneficiados y en ese orden aplicar el descuento.
    • Más barato primero:  Refiere a ordenar de menor a mayor los productos beneficiados y en ese orden aplicar el descuento.

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


IMPORTANTE

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.

  • Aplicar sobre: Indica sobre qué precio del ítem se hará el cálculo del beneficio. Las opciones de precios serán:
    • Original:  Refiere a aplicar el beneficio sobre el precio original del artículo.
    • Beneficiado:  Refiere a aplicar el beneficio sobre el precio ya beneficiado del artículo.
  • Criterio de ordenamiento: permite seleccionar un criterio para ordenar los ítems sobre los cuales se les aplicará el beneficio. Se podrá elegir entre:
    • los más caros primero:  Refiere al ordenamiento de los ítems beneficiados en base a su precio. Precios de mayor a menor.
    • los más baratos primero:  Refiere al ordenamiento de los ítems beneficiados  en base a su precio. Precios de menos a mayor.
    • indistinto:  Sin ordenamiento especifico de los ítems beneficiados.  




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 el PROMO podrán definirse aplicación de un beneficio, quedando fuera de alcance el beneficio Monetario Cupón Calculado y el No Monetario, Plan de Pago.

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:

    • General: Indicara que los todas las tiendas del retailer sumaran al limite que se esta definiendo. Por Ejemplo, "2x1 en Termos, hasta agotar stock de 1000 unidades" (Independientemente de la tienda donde se venda o del cliente que lo adquiera, durante la vigencia de la promoción, podrán beneficiarse termos hasta alcanzar las 1000 unidades.)

    • Tienda: Indicara que cada tienda del retailer llevara un contador independiente del limite definido es este beneficio. De esta forma puede darse el caso en  que una tienda haya alcanzado el limite del beneficio definido y no pueda aplicar mas el beneficio, y que otra tienda aun pueda seguir operando con el ya que aun no ha alcanzado su limite. El limite definido aquí, es el que heredaran todas las tiendas por igual. Por ejemplo: "2x1 en Termos hasta agotar Stock de 100 unidades por tienda". (Durante la vigencia de la promoción, podrán beneficiarse hasta 100 termos por tienda, si la tienda A agota su stock la promoción no se aplicara ni sugerirá más, pero si la tienda B aún tiene Stock disponible podrá seguir operando con dicha promoción.)

    • Cliente: Indicara que el limite será acumulado por cada cliente informado en la transacción. Por ejemplo, "2x1 en termos hasta agotar Stock de 1000 unidades, uno por cliente". (Durante la vigencia de la promoción, podrán beneficiarse termos hasta 1000 unidades, pero solo podrá entregarse uno por cliente.)

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 solamete informativa.

       Esta descripción en los Json de listas negras que se envíen por colas RabbitMQ.  se informara debajo del "code" que se informa en los Json.                                                                                                           El campo no será requerido. en caso de no cargarse podrá informarse en blanco.

       Deberá informarse esta descripción en el Json de Promociones debajo del "code" que se informa en el los Json.

        La descripción No será informado 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 (General, Tienda o Clientes) 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 Clientes, 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 aplicara 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.


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 "Limita por" deberá indicase este criterio de acumulación. Pudiéndose elegir entre los siguientes acumuladores:


    • Cantidad de Dinero
    • Cantidad de Aplicaciones
    • Cantidad de Productos beneficiados
    • Cantidad de Cupones emitidos (solo disponible cuando se este definiendo un beneficio No Monetario, Cupón)
    • Cantidad de Unidades de Fidelidad Otorgados (solo disponible cuando se este definiendo un beneficio No Monetario, Puntos/Porcentaje o Coeficiente de Fidelización)
    • Cantidad de Regalos Otorgados (solo disponible cuando se este definiendo un beneficio No Monetario, Regalo)


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


El ejemplo anterior, podrá interpretarse como un tipo de Limite General, re 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 aplicara mas hasta el próximo día. En caso de no haber alcanzado el limite al momento del reseteo del contador, este se reiniciara igualmente, volviendo a 0 para volver a acumular hasta 100 el próximo día.


Límites al Definir Cupón Calculado:

  • Cuando se defina un beneficio No monetario, de la clase Cupón Calculado, definido por Porcentaje, podrán definirse límites por "Retailer", "Tienda" y/o "cliente" limitando por cantidad de dineroaplicaciones o productos beneficiados.

  • Cuando se defina un beneficio No monetario, de la clase Cupón Calculado, definido por Monto Fijo, podrán definirse límites por "Retailer", "Tienda" y/o "cliente" limitando por cantidad de dineroaplicaciones o productos beneficiados.

  • Cuando se defina un beneficio No monetario, de la clase Cupón Calculado, definido por Monto Externo, podrán definirse límites por "Retailer", "Tienda" y/o "cliente" limitando por cantidad de aplicaciones o productos beneficiados.


NOTA

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


NOTA 2

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:


Nota

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


Campo DESCRIPCIÓN en la definición de Limites de aplicación del beneficio (Disponible a partir de PROMO 7.0.1)

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

Importante

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

A partir de esta versió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

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:

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 cant. de días.

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

Importante

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:

A partir de esta versión, se incorpora 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".

Definicion de Escalonadas por magnitud

Se tomara 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 "Agrega",  se propondrán los siguientes campos a fin de indicar las condiciones de aplicación del escalón que se esta definiendo.


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


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




IMPORTANTE

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"




Consideraciones en la definición de beneficios escalonados:

    • En el beneficio que aplique a escalonada, debera definirse el valor de descuento por defecto, que aplicara cuando no se cumpla con alguno de los escalones definidos.
    • El valor y tipo de recupero que se definan al beneficio que opere con escalonada, aplicaran para el beneficio que otorgue el o los escalones que se cumplan en la transacción.
    • El prorrateo entre participantes, de habilitarse, regirá para todos los elementos que apliquen al cumplimiento del escalón definido.
    • Una vez definido un escalón, no podrá cambiarse el tipo y clase de beneficio. Estos aparecerán grisados. Deberán de eliminarse los escalones para poder editar estos campos.

    • Aplicación Máxima (Valor/Medida) al definir un beneficio escalonado: los valores definidos aplicaran para el beneficio que otorgue el escalón que se cumpla.
    • Descuento Mínimo a aplicar al definir un beneficio escalonadoaplicara para el beneficio que otorgue el escalón que se cumpla.
    • Método de Prorrateo al definir un beneficio escalonado: aplicara para el beneficio que otorgue el escalón que se cumpla.
    • Definición del campo "Aplica sobre" al definir un beneficio escalonado: aplicara para el beneficio que otorgue el escalón que se cumpla.
    • Criterio de ordenamiento al definir un beneficio escalonado: aplicara para los elementos sobre los que se otorgue el escalón que se cumpla.

    • Los beneficios que apliquen sobre escalones contabilizaran para los limites que pudiera tener definido el beneficio de la promoción escalonada, ya sea que se limite por cliente, tienda o general, a productos beneficiados, cantidad de dinero o cantidad de aplicaciones. 

    • Todos los campos referentes a la información de adicional de un beneficio aplicaran para el beneficio que otorgue el escalón que se cumpla.

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

  • Método de aplicación: representa la forma en la cual el POS emitirá las promociones (ya sea en pantalla o comprobante de venta). Por ejemplo, mostrar en detalle el descuento afectado a cada artículo o mostrar un resumen de todo el descuento aplicado antes del total. Las opciones que se podrán seleccionar son:
    • Resumen
    • Línea a línea

  • Cuenta contable: se ingresa la cuenta contable a la cual será imputado el beneficio en el POS. No es un campo obligatorio.
  • Proveedor del bien  y Proveedor financiero: podrá indicarse aquí a quien se le imputará el monto del descuento a aplicar, indicando el monto o porcentaje que le corresponde. 

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 : 

    • true= requiere cargar ambos (Proveedor del bien y Proveedor financiero) si se carga al menos uno.
    • false = no requiere la carga de ambos (Proveedor del bien y Proveedor financiero), se puede cargar uno solo.

      Tanto si se define en true o en false se puede no cargar ninguno (ni Proveedor del bien, ni Proveedor financiero).

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.                                

            

        

Nota

Para la seleccion 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 sera 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>
  • Mensaje en POS: este texto será enviado hacia el POS para ser visualizado en el display cuando una Promoción que incluya este Beneficio haya sido aplicada en un contexto determinado. No es un campo obligatorio.
  • Mensaje para la impresora: este texto será enviado hacia el POS para ser impreso en el comprobante de venta cuando una Promoción que incluya este Beneficio haya sido aplicada en un contexto determinado. No es un campo obligatorio.

Recortar Mensaje para la impresora

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.



  • Mensaje para el TLOG: este texto será enviado hacia el POS para ser registrado en el TLOG cuando una Promoción que incluya este Beneficio haya sido aplicada en un contexto determinado. No es un campo obligatorio.


NOTA

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 configuracion "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: 

  • Las promociones incompletas o canceladas no podrán ser posteadas de forma manual.
  • Cuando una promoción pase a estado "Cancelado" el posteo a la cola RabbitMQ correspondiente sera automático.
  • En las promociones dadas de alta de forma masiva, o vía servicio el posteo a la cola RabbitMQ correspondiente sera automático.


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)

Promociones vigentes/vencida con edición inhabilitada

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 7.2)

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.


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


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


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



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.

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 sera 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 sera 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 aqui 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.


NOTA

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.


IMPORTANTE

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.


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 configuracion, 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.


NOTA

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

Las sugerencias se puden 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


























REFERENCIAS

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 sera obligatorio se 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.


IMPORTANTE

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.


Condiciones de Rango Horario

Debido a la naturaleza de los campos asociados a las Condiciones de rango horario, no podrán indicarse variables (@[variable...]), por lo que al definir alguna condición del este tipo la misma se agregaran las columnas con las siguientes cabeceras Condición de fecha con hora, Condición de hora, Condición por periodicidad



IMPORTANTE

En el caso de que el usuario no indique ningún dato en el columna correspondiente a las variables de Condición de rango horario, durante la importación se tomará el valores definidos en la plantilla.


REFERENCIAS

Para mas detalle de los valores aceptados al momento de definir condiciones de rango horario Ver "Apéndice VI"



Condiciones Simples

En caso de que la plantilla a definir, deba contener condiciones simples, habrá que definir las variables que representaran los atributos de los elementos, por medio de los cuales se indicarán estas condiciones.

El formato de estas variables sera @[variable_condition_1], donde "variable_condition_1" deberá ser reemplazado por el valor que se desea ver en la columna correspondiente al atributo en el excel. 

Esta definición de variables sera solo para condiciones con campos tipo Auto-completar que permiten el ingreso de valores alfanuméricos.

La definición del nombre de las  variables no se pueden separar con espacios, se sugiere el uso de guión o guion bajo (-, _), por ejemplo: @[variable_condition_1]@[variable-condition-2]


En caso de que algún atributo sea definido con un valor literal y no por medio de una variable, el atributo que lo contenga no sera mostrado como una columna en el excel, sino que se tomara como una definición fija para ese atributo y sera incluido en todas las promociones que se generen a partir de esta plantilla.



brand (Condición simple 1. Productos)familia (Condición simple 1. Productos)TPago (Condición simple 2. Medios de Pago)prov (Condición simple 3. Productos)

















REFERENCIAS

Para mas detalle de los valores aceptados al momento de definir condiciones simples Ver "Apéndice VI"


Condiciones Por Composición

En caso de que se quiera definir las promociones por medio de condiciones por composición, se tomaran como variables todos los campos con valores definidos por el usuario (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 las variables asociadas a diferentes condiciones por composición dentro del excel, se le agrega a cada variable un sufijo con el numero de la condición a la que pertenece.

Ejemplo:

Variables para la condición por composición 1

  1. Límite de aplicación (Cond. por composición: 1)

  2. Unidad de medida (Cond. por composición: 1)

  3. Ocurrencias mínimas (Cond. por composición: 1)

  4. Ocurrencias máximas (Cond. por composición: 1)

  5. marca (Cond. por composición: 1. Productos)

  6. famila_en_combo (Cond. por composición: 1. Productos)


Variables para la condición por composición 2

  1. Límite de aplicación (Cond. por composición: 2)

  2. Unidad de medida (Cond. por composición: 2)

  3. Ocurrencias mínimas (Cond. por composición: 2)

  4. Ocurrencias máximas (Cond. por composición: 2)

  5. Criterio de equivalencia (Cond. por composición: 2)

  6. Criterio de inequivalencia (Cond. por composición: 2)

  7. tipo_cliente (Cond. por composición: 2. Clientes)


Ejemplo de cabeceras en la plantilla excel

Límite de aplicación (Cond. por composición: 1)Criterio de inequivalencia (Cond. por composición: 1. Productos)Ocurrencias máximas #1 (Cond. por composición: 1. Productos)Unidad de medida #1 (Cond. por composición: 1. Productos)Criterio de ordenamiento (Cond. por composición: 1. Productos)familia (Cond. por composición: 1. Productos)Ocurrencias mínimas #1 (Cond. por composición: 1. Productos)Criterio de equivalencia (Cond. por composición: 1. Productos)Ocurrencias máximas #2 (Cond. por composición: 2. Productos)Unidad de medida #2 (Cond. por composición: 2. Productos)proveedor (Cond. por composición: 2. Productos)Ocurrencias mínimas #2 (Cond. por composición: 2. Productos)


























REFERENCIAS

Para mas detalle de los valores aceptados al momento de definir condiciones por composición Ver "Apéndice VI"



Beneficio 

Al momento de definir un beneficio en la plantilla de Promociones se deberá tener en cuenta que los campos "Tipo de beneficio" y "Clase de beneficiono se mostrarán como variables dentro del excel, ya que de ambos dependen los demás campos que identifican el beneficio.


Solo los campos asociados a la"Tipo de beneficio" y "Clase de beneficio", que sean de tipo alfanuméricos, permitirán la declaración de variables  (@[variable_test]).

Tampoco sera valido el ingreso de variables (@[variable_test]) los campos de tipo auto-complete, que si bien permiten el ingreso de un dato alfanumérico no resultan válidos para el ingreso de variables ya que deberá validarse, en los casos que corresponda, contra los catálogos.


Ejemplo - Beneficio Monetario



Ejemplo - Beneficio No Monetario



> Información de aplicación

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



Las variables a tomar para mostrar en el excel serán:

  1. Aplicación máxima (valor)

  2. Aplicación máxima (medida)

  3. Método de prorrateo

  4. Aplicar sobre…



> Límites de la aplicación

Al indicar algún límite dentro del beneficio de la plantilla, el usuario podrá visualizar en el excel la variable Límites de aplicación, donde podrá indicar los datos correspondientes al límite entre corchetes ([]) o en su defecto indicar varios límites separándolos con comas ( , ).


El usuario podrá indicar los datos de cada límite de acuerdo a la estructura:

[Tipo de limite, 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 ... del excel, durante la importación se tomarán como valores de los límites los definidos en la plantilla.


> Información adicional

Se tomarán como variables todos aquellos campos donde el usuario defina un valor y en el caso de que algunos de los campos permita la definición de variables, como en Cuenta contable, Mensaje en POS, Mensaje en impresora, Mensaje en TLOG, se mostrará como cabecera de la columna el nombre indicado en dicha variable.



IMPORTANTE

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)

Solo será obligatorio la carga de datos en aquellas columnas definidas como variables (@[....]) por el usuario dentro de la plantilla, por su parte para los campos que no permiten el ingreso de variables y cuyos valores hayan sido indicados en la plantilla, el usuario podrá indicar o no valores en dichas columnas ya que en el caso de estar vacías al momento de la importación se tomará como valor final el definido en la plantilla.



REFERENCIAS

Para mas detalle de los valores aceptados al momento de definir beneficios Ver "Apéndice VI"


Casos Prácticos de definición de Beneficios

Para mas información y ejemplos sobre la forma de definición de los campos del beneficio ver "Apéndice VI - Casos Prácticos"


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 Accciones → Generar excel. 



Podrá indicarse, por configuracion cual sera 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 configuracion en Administración → Información de configuración y editar la variable file.xls.header.rowStart.



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.


Limitantes y Asumisiones en el Alta Masiva de Promociones

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 (BenefitRedeemWithOptions) y limites del beneficio (Limit), se creo en cada entidad el método listDeclaredFields() 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 de lo contrario 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 la condiciones simples, los valores asociados a esos campos se dejarían vacíos dentro del excel.


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


Importante

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: 


Luego sobre la plantilla creada al presionar el botón "Generar Excel" en el archivo que crea agrega una columna con el nombre indicado en la variable:


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.




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

  • Código 
  • Nombre de Promoción
  • Estado
  • Campaña
  • Vigencia
  • Tiendas


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.




IMPORTANTE

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



IMPORTANTE

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.



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.


NOTA

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:

  • "Estado" (estado de la promoción), 
  • "Código" (Código de la promoción), 
  • "Nombre" (nombre de la promoción), 
  • "Campaña", 
  • "Canales", 
  • "Vigencia", 
  • "Clase de Beneficio", 
  • "Beneficio"
  • "Tiendas"


Importante

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á: GeneralTienda 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.


Envío de Información de Estado de Limites vía RabbitMQ

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 Manual de Integración Promo 7.2.)


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 o lista de precios, 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 o lista de precios. El universo de aplicación de un workflow no podrá ser editado una vez que tenga asociado promociones o lista de precios.


MÚLTIPLES Workflows

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

Por ejemplo, las promociones que apliquen sobre un determinado rubro o den 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 Listas de Precios.

Los WF podrán aplicar a:

  • Promociones
  • Listas de Precios


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 3 checkbox's, que indican si el Workflow aplica a promociones, a listas de precios o ambas y si se aplicarán condiciones generales. Por default, los 3 checkbox's están tildados.


NOTA

Si una compañía no tiene habilitado el módulo de listas de precios, los workflows solo aplicaran a Promociones.

Si un workflow ya se encuentra utilizado en una promoción o en una lista de precios, al mismo NO se le podrá destildar el check "Aplica Promociones" o "Aplica Precios"


 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:

Ejemplo:

Siguiendo el ejemplo anterior, como en el Paso Captura no se seleccionó ningún usuario dentro del Rol Administrador, cualquier usuario con ese rol podrá crear una promoción utilizando ese workflow (workflow2 en el ejemplo).

Luego de creada la promoción el usuario administrador podrá enviarla para aprobación:

Nota

El usuario que crea el worflow tendrá disponible sólo los roles que tenga los permisos 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.

Una vez que se oprima la opción "Promociones para aprobar", un usuario perteneciente al rol definido, podrá revisar y aprobar / rechazar 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.


Workflows de mas de un paso de aprobacion

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

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

Cuando la promoción 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.


Workflows de solo un paso de aprobación

Cuando una promoción 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.

Promociones para Aprobar

Por default (si no filtra nada) al ingresar a la pantalla "Promociones para aprobar" 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 y envía para su aprobación.
  2. El supervisor, valida la promoción cargada y las aprueba o rechaza de acuerdo a su criterio.



Las promociones 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:

  • "Promociones para Aprobar" como se detalla en la imagen, oprimiendo en el submenú desplegado desde el botón "Acciones", la opción "Historial WF"
  • "Gestión de Promociones" oprimiendo el botón "Acciones" a la derecha de la pantalla sobre la promoción que se elija y desde el submenú desplegado, oprimiendo "Historial WF".


En el historial del workflow se podrán visualizar :

  1. Los pasos realizados con cada promoción
  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:

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

NOTA

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. 




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:

  • Publicación: nombre mediante el cual se identificará al mapa cuando el mismo sea listado para generar los archivos de definición.
  • Inicio de vigencia: indica la fecha inicial de la cual el mapa se encontrará en vigencia una vez que se encuentre distribuido. Toma como hora de inicio las 00:00 hs del día. La fecha debe ser la actual o superior.
  • Fin de vigencia: indica la fecha en la cual finalizará la vigencia del mapa. Toma como hora de fin las 23:59 hs del día.


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:

  • Sugerencias: las opciones para este campo son:
    • NO sugerir: No se realizarán sugerencias para ninguna de las promociones que integran el mapa, independientemente del valor de "sugerir" que tenga configurada cada promoción.
    • Sugerir SIEMPRE: Se evaluaran sugerencias para todas las promociones que integran el mapa, independientemente del valor de "sugerir" que tenga configurada cada promoción.
    • Sugerir de acuerdo a la PROMOCIÓN: las promociones serán sugeridas o no conforme la configuración de sugerencia que se tenga a nivel promoción.


  • Días para la devolución: indica la cantidad de días que se encontrará disponible el mapa luego de finalizada su vigencia, solo para las transacciones de devoluciones. 

Este dato permite al sistema determinar la cantidad de días que debe contemplar el uso del mapa para resolver las promociones en las transacciones de devolución así como se realizaron 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.


IMPORTANTE

El mapa se encontrará vigente solo después de generarse el archivo 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.



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, PromocionesCond 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.


NOTA

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

  • SECUENCIAL (CONSUME)

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.

  • TODAS (ALL)

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

  • OPCIONES (OPTION)

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.

  • EXCLUIR (EXCLUDE)

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.

  • EVALÚA SI (IF)

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.


Ejemplo:

    • Promo-A: evalúa la existencia de items con código 111 y que sea de la familia "Electro".
    • Promo-B: evalúa la existencia de items que sea de la familia "Electro".


El mapa quedara conformado de la siguiente forma:


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

Al evaluarse los items con el mapa que contiene la función "Evalúa Si", se aplicara sobe el item "111" la Promo-A y la Promo-B, mientras que el item "333" no obtendrá beneficios, ya que por definición, solo se aplicara la promoción condicionada (Promo-B) sobre los items que hayan sido beneficiados por la promoción condicionante (Promo-A). 


  • EVALÚA SINO (IFNOT)

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

    • Promo-A: evalúa la existencia de items con código 111 y que sea de la familia "Electro".
    • Promo-B: evalúa la existencia de items que sea de la familia "Electro".


El mapa quedara conformado de la siguiente forma:


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

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

El item "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 items que NO hayan sido beneficiados por la promoción condicionante (Promo-A). 



Las siguientes funciones son sólo para BENEFICIOS MONETARIOS:


  • MAXIMO DESCUENTO (MAX DISCOUNT)

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 solo se aplicará sólo una promoción, la que otorgue el mayor descuento al cliente.


Cupon Calculado como Beneficio Monetario

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, el monto a emitirse en el cupón sera 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 sera aplicado y se emitirá el cupón con el monto correspondiente.


  • MINIMO DESCUENTO (MIN DISCOUNT)

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.


NOTA

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.


  • MAXIMO DESCUENTO COMBINADO

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.

Nota

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 funcion de Maximo descuento combinado debe tener al menos dos promociones dentro del paso para poder aplicar la funcionalidad de competencia de promociones.



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


      • MAXIMOS PUNTOS (MAX POINTS)

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.


      • MINIMOS PUNTOS (MIN POINTS)

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.


NOTA

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.


NOTA 2

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


NOTA 3

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:


      • aplicar primero la promoción PR03 y la promoción PR04 y luego, aplicar las promociones PR05 y PR06 sobre los productos que no han participado de las promociones PR03 y PR04
      • aplicar primero la promoción PR05 y la promoción PR06 y luego, aplicar las promociones PR03 y PR04 sobre los productos que no han participado de las promociones PR05 y PR06


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.


NOTA

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


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 8321.
      2. Se da de alta una nueva promoción PROMO_B, cuya fecha de vigencia intersecta con la PROMO_A, y que también utiliza el artículo con código 8321.



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 8321
      2. Se agrega al mapa la promoción PROMO_B, cuya fecha de vigencia intersecta con la PROMO_A, y que también utiliza el artículo con código 8321.
      3. Aparecerá un aviso de advertencia de colisión de promoción como se muestra en la siguiente imagen.






CONFIGURACIÓN Y FUNCIONAMIENTO DE DISTRIBUCIÓN DE MAPAS AUTOMÁTICA Y PROGRAMADA:


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

Las opciones a configurar son:

  • Generación y distribución programada de mapas - schedule.enable: le permitirá activar el proceso de distribución programado a través de un job que se ejecutará una vez al día. Por defecto vendrá en false.
  • Filtrar promociones por tienda para la distribución programada y manual - scheduled.filter.enable: indicará si se filtra o no las promociones que aplican para la tienda dentro del mapa. Si está en false, todas las promociones seran enviadas a todas las tiendas. Si está en true, los mapas que se distribuyan, solo contendran las promociones que apliquen para la tienda a la que se distribuye y las promocione que no tengan una condicion de tienda definida. Por defecto vendrá en false.
  • Incrementar la versión del mapa para la distribución de mapas- scheduled.mapVersion: Aquí se indica que con cada distribucion, ya sea a una tienda de laboratorio o a una tienda de produccion, el nro de mapa se incrementara, y en la pantalla de “Distribucion/ Mapas” podran observar siempre la ultima distribucion realizada para el mapa. Por default vendrá en true




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.

Luego, desde Distribución \ Mapas (POS) al dar de alta un nuevo mapa deberá seleccionarse l aplantilla 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.


Importante

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.



Una vez generado el mapa por medio de la plantilla seleccionada, deberá darse clic en 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.

Importante

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.


De esta forma, el mapa quedará listo para ser tomado por el proceso de generación y  distribución programada de mapas. Este procesos realizará un filtro de las promociones que aplican a cada una de las tiendas con conexión automática  (siempre y cuando se encuentre habilitada la variable de configuración: scheduled.filter.enable.)

Info

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



Proceso detallado del Generación y Distribución de mapas programado.

  1. Cuando se inicie el proceso automático de Generación y distribución programada de mapas, buscará las tiendas definidas para cada compañía y utilizará para la distribución solo las que estén activas, con un tipo de conexión AUTO y al menos un motor asociado. 
  2. Luego, buscará la plantilla de mapa en estado COMPLETA mas reciente que tenga generada o editada.
  3. Habiendo completado con éxito los pasos 1 y 2, se procederá a agregar las promociones Completas y Vigentes al mapa en base a la plantilla de mapa elegida, 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, esto último sólo si se encuentra habilitada la variable de configuración scheduled.filter.enable.
    Las promociones que no tengan definida una condición de "transacción" serán distribuidas a todas las tiendas.
  4. Una vez que se tienen los mapas completos para cada una de las tiendas se procede a la distribución de los .xml.


Importante

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 generados 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)


IMPORTANTE

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



Distribución individual de Promociones

A partir de esta versión, 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.


NOTA

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.


IMPORTANTE

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:

image-2021-04-23-17-19-32-940.png

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:


      • Nombre: Nombre mediante el cual se identificará al ticket cuando sea listado.
      • Tienda: Tienda que se informará al momento de realizar la simulación.El usuario logueado; sólo tendrá disponible las tiendas que tenga configuradas.
      • Terminal (código): Código de la terminal que se informará al momento de realizar la simulación.
      • Canal: Vía o canal desde el cual se estaría simulando la venta. Es un campo opcional y de texto libre. El sistema no sugerirá información del catálogo relacionado con este campo.
      • Moneda: En este campo se puede ingresar el tipo de moneda con el cual se va a hacer la simulación de la compra. Es un campo opcional y de texto libre. Se mostrará vacío al ingresar. El sistema no sugerirá información del catálogo relacionado con este campo. Al simular se tendrá en cuenta la moneda ingresada.
      • Fecha de compra: Fecha y hora que se utilizará al momento de realizar la simulación.


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:


    • Productos: Presionar en el botón "Productos" y el sistema solicitará los siguientes datos:
      • Código (SKU): código que identifica el artículo.
      • Precio unitario: precio de cada unidad del artículo que se está agregando a la transacción.
      • Cantidad: cantidad de artículos con el código ingresado que se están "vendiendo".
      • Magnitud: Peso, longitud o volumen del artículo.
      • Precio total: precio total de los artículos. Surge de multiplicar el precio unitario por la cantidad.
      • Marca: marca del artículo que se está ingresando.
      • Proveedor: indica el código representativo del proveedor del artículo.
      • Departamento: departamento o sección a la que pertenece el artículo.
      • Familia: familia de artículos a la que pertenece el artículo que se está ingresando.
      • Categoría: categoría del artículo que se están ingresando.
      • Sub Categoría: Subcategoría del artículo que se están ingresando.
      • Discontinuo: para indicar si el producto es discontinuo.
      • Baja Rotación: permite indicar si el producto tiene baja rotación.
      • Producto Estrella: para indicar si el producto es estrella.
      • Opción de canje de ptos: permite ingresar en la simulación de la transacción una cantidad de puntos que Promo utilizará para otorgar la promoción de canje de puntos.
      • C. Producto: permite ingresar el Código de Producto del Retail.
      • Barcode: permite ingresar el código de barras del producto.

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.

    • Cupones: representa los cupones que se informarán en la transacción.  Presionar en el botón "Cupones" y el sistema solicitará los siguientes datos: 

      • Id: identificador único del cupón. Es mandatorio.
      • Tipo: representa el tipo de cupón. Es mandatorio.
      • Cantidad: cantidad de cupones que se están presentando. Es mandatorio.
      • Monto: valor equivalente en dinero que posee el cupón. (este atributo no se evalúa cuando se utiliza el módulo de Cupones)


    • Cliente: representa los datos relacionados con el cliente que realiza la transacción. Presionar en el botón "Clientes" y el sistema solicitará los siguientes datos: 

      • Id: identificador del cliente. Es mandatorio.
      • Tipo: representa el tipo de cliente que está realizando la transacción.
      • Puntos: cantidad de puntos (fidelidad/millas/etc.) que posee el cliente que realiza la transacción.
      • Monto restante: límite del importe sobre el cual aplicar un cierto descuento (para promociones que así lo tengan definido).
      • Segmento: indica el segmento o rango al que pertenece el cliente que realiza la transacción.
      • Perfil del cliente: permite ingresar el perfil del cliente con el que se está realizando la simulación.
      • Campaña crediticia: para indicar a la campaña que está utilizando el cliente.
      • Saldo: para indicar el saldo que posee el cliente.


    • Eventos: representa los eventos que se informarán en la transacción. Presionar en el botón "Eventos" y el sistema solicitará los siguientes datos: 

      • Número: identificador único del evento.
      • Tipo de transacción: representa el tipo de evento.
      • Valor: valor del evento que se informará.


    • Medios de pago: representa los medios de pago que se informarán en la transacción. Presionar en el botón en el botón "Medios de Pago" y el sistema solicitará los siguientes datos: 

    • Código: del medio de pago. Es mandatorio.
    • Tipo: representa el tipo de medio de pago con el que se está realizando la transacción.
    • Banco: identifica al banco asociado al plan de pago.
    • Plan: para identificar el plan de pago a utilizar.
    • Cuotas: para indicar en cuántas cuotas se realizará el pago.
    • Monto: monto que se está abonando con este medio de pago particular. Es mandatorio.
    • Monto de ítem: monto de los ítems que se desea pagar con este medio de pago particular.
    • Prefijo: para identificar el prefijo de la tarjeta utilizada.
    • Campaña crediticia: para indicar a la campaña que se está utilizando.



  • Elementos de Fidelidad: representa los datos relacionados con los elementos de fidelidad que puedan ingresarse a la transacción para su evaluación. Presionar en el botón  "Elementos de Fidelidad" y el sistema solicitará los siguientes datos: 

    • Id: identificador único de la tarjeta.
    • Tipo: representa el tipo de elemento de fidelidad que se está ingresando.
    • Monto: indica el saldo del elemento fidelidad que se está ingresando.
    • Convenio: Indica el convenio al que pertenece al elemento de fidelidad que se esta ingresando.


  • Beneficio Externo: representa los datos relacionados con los elementos de fidelidad que puedan ingresarse a la transacción para su evaluación. Presionar en el botón en el botón "Elemento de Fidelidad"

    • Id: identificador único del beneficio.
    • Tipo: representa el tipo de beneficio utilizado.
    • Monto: indica el importe correspondiente al beneficio.
    • Tipo de beneficio: puede ser Monto o Porcentaje.


NOTA

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


        • El sistema permitirá seleccionar si se desea simular una promoción o un mapa.
        • Una vez que se muestra el listado de promociones o mapas se deberá elegirse una opción y presionar "Simular"



Simulación de Mapas:


Simulación de Promociones:

Nota

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) 112.

También se informa el detalle del beneficio otorgado, en este caso un Descuento porcentaje del 10% que equivale a -$990 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:


        • Editar: Permite modificar la cabecera del ticket.
        • Definir: Permite modificar el cuerpo del ticket a simular
        • Simulación: Permite directamente realizar una simulación de mapa o promoción en caso de que el ticket se encuentre en estado "Completo"


NOTA

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.





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

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 instalacion Promo 7 - Consfiguracion de Redes Sociales).

La publicación en redes sociales tiene como finalidad solamente la comunicación de ofertas, oportunidades y/o beneficios a potenciales clientes por medio de los canales digitales configurados, no pudiendo aplicarse los beneficios por este medio.


NOTA

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 únicamete) .


Una vez dada de alta la promoción con alguno de los canales de publicación de redes sociales seleccionados, en la pantalla 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 la publicación.


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 "Publicar"

Hecho esto podrá visualizarse en la pagina seleccionada la promoción recientemente publicada.




De cada promoción que haya sido publicada en las redes sociales podrá verse un resumen de las publicaciones realizadas presionando el último icono de estadísticas que se muestra al final de cada promoción.




De la misma manera se procederá para realizar publicaciones de promociones en la red social Twiter, y luego de publicada se mostrara de la siguiente manera:


Capítulo 8 - Módulo de Precios


Listas de Precios


El módulo de Listas de  Precios, gestionará los distintos tipos de Listas de Precios, que se manejarán en las tiendas del retailer.

Existen tres tipo de listas de precios:

      1. LISTAS CERO: Estas listas se crean en forma automática, cuando se crea una nueva tienda en la compañía. No pueden ser editadas, ni se les define un Universo de aplicación. Los items participantes se obtienen a través de una interface, para recepción y procesamiento de precios desde SAP.

      2. LISTAS DERIVADAS: Son listas que tienen como lista padre una Lista 0, y se les aplica algún tipo de operación de cálculo que aplicará sobre los precios de la lista padre (Ej. % de aumento, $ de decremento, sumar $1, restar $1, aplicar redondeo). No se definen los items de la misma, ya que posee directamente la asociación, con los items de su Lista padre (Lista 0). Aclaración: las listas derivadas fueron creadas para manejar los precios ofertas o aumentos de los precios.

      3. LISTAS NUEVAS o GENERADAS: Son listas que se crean y no tienen como lista padre, una Lista 0, sino que se crean definiendo un universo de aplicación especifico. Los items participantes se definen a partir del catálogo de items del BM Central, en caso de tratarse de Promo Bridge, o a partir de catálogo de items de Promo.


Desde el menú Operación > Listas de Precios, se administrarán las listas de precios, a ser distribuidas en las tiendas del retail:



Ingresando desde el menú Operación > Precios > Listas de Precios, se desplegará la siguiente pantalla de Administración de Listas de Precios:

En la misma se listarán las listas de precios existentes que contendrán la siguiente información:

      • Estado (Incompleta, Completa,Aprobada, Distribuida, Cancelada, En distribución)
      • Tipo (Cero, Generada, Derivada)
      • Lista cero base (para las derivadas)
      • Código
      • Nombre
      • Descripción 
      • Tiendas; sólo podrá ingresar aquellas que el usuario tenga vinculadas.
      • WF (Workflow)
      • Vigencia
      • Prioridad

Se podrán realizar búsquedas de listas de precios por los siguientes filtros: tipo (cero, generada, derivada), código (de la lista), nombre, tienda (mostrará todas las tiendas que el usuario tenga vinculadas (autocompletable)), código (sku), estado y vigencia.


El filtro Vigencia, aplica solamente para las listas de precios "Generadas" y "Derivadas". Las listas 0, como su vigencia es indefinida, no se visualizaran desde esta búsqueda. Se podrá filtrar utilizando el Tipo de lista.

Importante: Al momento de indicar la prioridad de la lista de precios, se deberá tener en cuenta la manera en que el motor evaluará los precios. El motor evaluará las lista de precios según su prioridad, de mayor a menor, teniendo en cuenta el Universo de aplicación de las mismas. 

El motor evalúa el Universo de aplicación de las listas de precios (Tienda, Rango Horario, Cliente, Tipo de cliente, Evento)  si existen 3 listas con prioridad 0, 1 y 2 (la prioridad mas alta es la 2 y la mas baja es la 0, en este ejemplo). Evalúa primero la 2, de no aplicar continuará con la 1 y así sucesivamente hasta la 0.

Ejemplo:

Universo de aplicación:

Lista con prioridad 2: es para tipo de cliente vip y tienda = Unicenter

Lista con prioridad 1: es para tienda = Unicenter, Rango horario: 9:00 hs a 20:00 hs

Lista con prioridad 0: es para tienda = Unicenter

 Llegan dos clientes, a las 10:00 hs de la mañana. Uno vip y otro común. Los precios para el primero serán los de la lista con prioridad 2, y para el segundo, serán los de la prioridad 1.


IMPORTANTE

Ninguna lista de precios (ni las listas cero, ni las derivadas, ni las generadas), pueden tener precio 0 en los campos: $ (sale price, precio en efectivo), $ Crédito (precio a crédito). En ambos campos el precio debe ser superior a 0.


Listas Nuevas o Generadas


Se podrá generar una nueva lista de precios, desde el botón "Nueva Lista" de la pantalla de Administración de listas de Precios:


En la misma se deberán ingresar los siguientes campos:

      • Código (código de la lista de precios, string de hasta 5 posiciones, requerido)
      • Nombre (nombre de la lista de precios, string de hasta 30 posiciones, requerido)
      • Descripción (string de hasta 50 posiciones, opcional)
      • Workflow (combo box)
      • Aplica Promociones (Se podrá seleccionar "SI", NO", o "Por artículo de la lista") Por default, vendrá en "SI".
      • Aplica Descuentos Manuales (Se podrá seleccionar "SI", NO", o "Por ítem de la lista") Por default, vendrá en "SI".
      • Inicio de Vigencia  (Datetime, requerido)
      • Fin de Vigencia  (Datetime, requerido)

        La lista se guardará con tipo "Generada" y en estado "Incompleta", hasta tanto se defina su universo de aplicación, y el detalle de productos que la componen.
        Para esto, se deberá elegir el botón "Acciones" > "Detalle":



  Desde allí se accederá a la siguiente pantalla:




Dentro de Universo de aplicación, se podrán agregar:

      • Tiendas: para indicar en que Tiendas se aplicará esta lista de precios (sólo tendrá disponibles aquellas que el usuario tenga vinculadas).
      • Rango horario: para que la lista aplique dentro de un rango horario determinado, ej: de 17 a 20 hs. 
        NOTA: Solo podrá haber una lista con rango horario por tienda (para cada horario, no podrán solaparse varias listas con el mismo rango horario).
      • Tipos de Clientes
      • Eventos: se refiere al tipo de evento.
      • Clientes
      • Prioridad: El sistema sugerirá una prioridad que se puede modificar.

Al seleccionar del combo las opciones, aparecerán las ventanas para poder ingresar los valores de los atributos:

Si seleccionó Tiendas:


Si seleccionó Rango Horario:

Si seleccionó Tipos de Cliente:

Si seleccionó Eventos:

Si seleccionó Clientes:


Si seleccionó Prioridad:

Una vez ingresadas la/las tiendas sugerirá una prioridad para esa lista en la o las tiendas indicadas:

Una lista puede tener asociadas varias tiendas. Al momento en que se genera la lista, el sistema evaluará todas prioridades relacionadas con las tiendas asociadas a esa lista y le asignará el número siguiente a la prioridad más alta encontrada entre ellas.

Se puede modificar la prioridad. Si el valor que se ingresa ya se encuentra utilizado en esa/esas tiendas, mostrará un mensaje por pantalla, indicando que esa prioridad ya la tiene asignada otra tienda e indicará cual tienda. Y no dejará grabar la lista con esa prioridad. Deberá seleccionar otra prioridad que no esté en uso.

El valor máximo que puede tener la prioridad es 999.999. Cuando se alcanza este número, el sistema seguirá asignando y guardando el mismo valor. El usuario puede asignarle un número menor que no haya sido utilizado (si se utiliza siempre la prioridad sugerida no se generan espacios vacíos, si el usuario saltea números se da esta situación), y para la siguiente lista el sistema partirá de ese número para la búsqueda de la siguiente prioridad disponible.



Para agregar productos a la lista de precios, se deberá acceder al sector "Detalle de Productos":


Para obtener el catálogo de productos, se deberá hacer click en el botón "Exportar catálogo base". Se abrirá un archivo Excel, con el catálogo de productos para completar los precios correspondientes a la lista que se está generando.

Los campos comprendidos en el archivo, serán los siguientes:

      • Código (SKU: código del artículo, requerido)
      • Nombre (Descripción: string de 50 posiciones, requerido)
      • Departamento (string 40 posiciones)
      • Marca (string de 30 posiciones)
      • Proveedor (string 30 posiciones)
      • Magnitud
      • Precio de costo (decimal 10.2, opcional)
      • Precio de venta efectivo ($) (decimal 10.2, requerido)
      • Precio de venta de crédito ($ Credito) (decimal 10.2, requerido. Si no tiene un precio de venta a crédito debe ingresar en este campo el mismo valor que puso en el Precio de venta efectivo, sale price. No debe tener valor 0)
      • Precio de venta blanco (decimal 10.2, requerido)
      • Precio de venta de crédito (decimal 10.2, requerido)
      • Unidad de medida (string de 15 posiciones, opcional)
      • Precio por magnitud (kilo, litro, bulto, etc.) (decimal 10.2, opcional)
      • Precio mayorista (decimal 10.2, requerido)
      • Limite mayorista (cantidad a partir de la cual aplica el precio mayorista), 
      • Proveedor Bien (string de 30 posiciones, opcional)
      • Monto de Recupero PB (decimal 10.2,opcional)
      • Proveedor Financiero (string de 30 posiciones, opcional)
      • Monto de Recupero PF
      • Aplica Promociones (SI=1/NO=0, por default viene con valor 1)
      • Aplica descuento manual (SI=1/NO=0, por default viene con valor 1)
      • Limite(límite de unidades que se podrán vender a ese precio). Al llegar a ese limite, ese precio no estará mas disponible para la venta, se tomara de otra lista vigente o desde la lista 0 de la tienda, opcional)
      • Inicio de Vigencia (formato de fecha: dd/mm/aaaa, debe ser mayor o igual al inicio de la vigencia de la lista de precios, opcional)
      • Fin de vigencia (formato de fecha: dd/mm/aaaa, y, debe se menor o igual al fin de vigencia de la lista de precios, opcional)

Partiendo de ese catálogo, se podrán agregar los precios a la lista, grabar el archivo con formato Excel, y subirlo desde el botón "Seleccionar archivo".

Al subir el archivo, se mostrará un mensaje indicando si los registros se importaron correctamente, o si ocurrió algún error.

Se podrán realizar búsquedas por SKU, para buscar algún articulo en particular, y poder visualizar los precio del mismo, y se podrá generar un Excel con los datos de la grilla, haciendo click en el botón "Exportar detalle actual"



NOTAS: 

El operador, podrá descargarse el template de Excel, para poder generar la lista a ser importada, desde la opción ""Exportar catálogo base". Este contendrá el catálogo completo de Bridge, o de artículos de Promo según corresponda.

En el caso de que alguno de los precios de la lista, sea menor que el precio de costo del producto, se mostrará un mensaje por pantalla alertando de esta situación. El operador tendrá la facultad de modificarlo o no, según las reglas de negocio a aplicar en la lista de precios que está siendo definida.
La suma de los campos Monto de Recupero PB, y Monto de Recupero PF, no podrá superar el el total del monto (precio de venta).

Cada producto, podrá tener o no una vigencia. Si la tiene, la misma deberá estar dentro de la vigencia definida para la lista de precios, o podrá ser menor a la vigencia definida en la lista, pero nunca superarla.



Listas Derivadas

Se podrá crear una nueva lista de precios derivada, a partir de alguna "Lista 0" existente, para esto seleccionará una Lista 0, y en el botón  "Opciones ", se deberá seleccionar "Nueva Lista de Precios Derivada":




Se deberán ingresar los datos de la cabecera de la lista derivada.  La misma estará asociada a la Lista 0 desde la cual se generó, y este dato no podrá ser modificado.

También heredará la tienda de la Lista 0. 

Se deberán ingresar los campos requeridos, y se deberá definir entre las siguientes opciones, la que aplicará sobre el conjunto de items:

      • Incremento %/Decremento %
      • Diferencia monto
      • Redondear a (es un redondeo hacia abajo. Por ejemplo: hay un ítem que vale $100,00 y le indico que quiero redondear a: 99, entonces  ese ítem va a pasar a valer $99,99. Otro ejemplo: Play Station: precio efectivo $94,26, le indico que haga el redondeo a 99, el precio queda en $93,99).

Y se podrá determinar si al resultante obtenido, se le puede aplicar un redondeo, sin decimales (por ejemplo:  si tengo un ítem: Play Station: precio efectivo $94,26, y al generar la lista derivada le activo el check: "Redondeo en cálculo sin decimales", en la lista derivada el precio efectivo de ese ítem va a ser: $94). 

Los precios (columnas) que se modificán en la nueva lista derivada son: $, $Credito, $Magnitud y $Mayorista. 

Se guardará la nueva lista de precios "Derivada".


IMPORTANTE

Al crear la lista de precios Derivada estará en estado incompleta hasta que le agregue más información en el Universo de Aplicación, ahí la lista pasará a estado Completa.


La lista se creará en estado "incompleta", hasta que desde el botón "Acciones"> "Detalle" , se agregue el universo de aplicación de la misma:


Se deberá definir el universo de aplicación de la misma, ingresando algún otro atributo, por ej: rango horario, tipo de cliente, cliente, evento:

Le sugerirá una prioridad de acuerdo a las disponibles en la/las tiendas.

Para ver el detalle de los productos de la lista derivada, se debe ingresar en el sector "Detalle de Productos" y hacer click en el botón "Exportar detalle actual":

Se generará un Excel, con el detalle de los productos, y su precio correspondientesegún lo definido en la lista derivada:


Nota

  • Precio de venta efectivo ($) (decimal 10.2, requerido)
  • Precio de venta de crédito ($ Credito) (decimal 10.2, requerido. Si no tiene un precio de venta a crédito debe ingresar en este campo el mismo valor que puso en el Precio de venta efectivo, sale price. No debe tener valor 0)


IMPORTANTE:

NO SE PODRÁ GENERAR UNA LISTA DERIVADA A PARTIR DE UNA LISTA 0, HASTA QUE LA LISTA 0, SE ENCUENTRE EN ESTADO COMPLETA O DISTRIBUÍDA Y APROBADA.

SI LA LISTA 0, SE ENCUENTRA EN ESTADO INCOMPLETA Y SIN APROBACIÓN, LA OPCIÓN DEL BOTÓN "ACCIONES" > "NUEVA LISTA DE PRECIOS DERIVADA", APARECERÁ DESHABILITADA.


Importante:

Cuando cree una lista de precios "Derivada" o "Generada", el sistema validará que cada ítem exista en el Catálogo de ítems (catalogItem). Si algún sku no existe en el Catálogo de ítems y se está trabajando con una lista:

  • Generada: el sistema mostrará un mensaje de error al momento de subir el archivo Excel con los precios y no permitirá continuar hasta agregar el sku faltante en el Catálogo de ítems o sacar ese sku de la lista Generada. La consola de Promo no permite crear una Lista Generada si tiene algún ítem que no exista en catalogItem.
  • Derivada: el sistema informará esta diferencia en el "Monitor de Importación" (Soporte/ Monitor de Importación) (informará que quedaron fuera de la distribución de esa lista de precios la cantidad de ítems que indique). Se recomienda actualizar la lista Cero, para que esta quede actualizada ya con los ítems que existen actualmente en el catalogoItem y vuelva a generar y distribuir la lista, o modifique la lista generada y vuelva a distribuirla.

Vigencia de los ítems

La vigencia del ítem ("Vigencia Desde" y "Vigencia Hasta") ya sea que se encuentre vencido o entre en vigencia a futuro, debe estar dentro del rango de vigencia de la lista de precios. Promo no permite ítems con vigencia que esté antes o después de la definida en la Lista de precios.


Aprobación de Listas de Precios


La autorización de listas de precios, se realizará a través de un Workflow para Listas de Precios.

El Workflow, podrá ser :

      • de 1 solo paso, en el cual las listas de precios, se crean y aprueban automáticamente (si la tarea programada "Actualización de Listas de Precios" está configurada para ejecutar automáticamente).
      • de 2 pasos: un paso para la creación y otro paso para la aprobación.


Ejemplo:


Si la lista de precios posee un Workflow, con dos pasos (o sea,  un paso para la creación y otro paso para la aprobación), se deberá seleccionar la opción " Listas de precios pendientes de Aprobar".

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


Para aprobar o rechazar una Lista de Precios 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 lista de precios, oprimiendo "Rechazar" o "Aprobar" además de poder agregar información (texto), en el cuadro vacío "Nota", en relación a la acción realizada.


NOTAS:
Las listas de precios, podrán ser aprobadas por un usuario que posea el rol, definido en el paso del WF (workflow) correspondiente.
Al aprobarse una lista de precios, se generará una alarma que avisará al usuario administrador, que tiene listas de precios pendientes de ser distribuidas en una tienda. 



Distribución de Listas de Precios


Las  listas de precios se podrán distribuir, en la/las tiendas que corresponda, desde la pantalla Administración de Listas de Precios.

Se debe seleccionar una lista de precios, y dentro de "Acciones" elegir  la opción " Distribuir Lista". El sistema pedirá confirmar la acción: “Se distribuirán TODOS los precios de la lista seleccionada, a los motores asociados a las tiendas de la lista”. Y mostrará los botones “Aceptar” y “Cancelar”.

La opción priceList.distribution.print.before: no está disponible su funcionalidad.


Nota

Si ya se había distribuido a un motor y al redistribuir, ese motor no está encendido, el sistema no permite redistribuir. Muestra un cartel rojo informando que existen distribuciones pendientes. A partir de la versión EP2.1 las listas de precios con motores off line se mantienen con status "completa", hasta que el motor esté on line. Cuando el motor pase a on line automáticamente redistribuirá la lista que pasará a estado "distribuida".

Cuando se le agrega un motor a una tienda, si esa tienda tiene listas de precios distribuidas se genera la re-distribución automática de esas listas al motor (a partir de la versión EP2.1).


IMPORTANTE

Existe un  estado: “En Distribución” y se usa la variable: priceList.distribution.print.before.

Si la variable está en "True", y la lista de precios está en estado “Completa”, permite imprimir las etiquetas.

Si la variable está en "False”, la lista tiene que estar en estado “En Distribución” o en estado “Distribuida” para poder imprimir las etiquetas.

El estado “En Distribución” quiere decir que seleccionó en una lista de precios, el botón "Acciones" / "Distribuir Lista" y la lista de precios está saliendo a los motores de las tiendas. Una vez que todos los motores la reciban ahí pasa a estado “Distribuida”.

Si en la tienda algún motor estaba apagado al momento en que se distribuye la lista de precios, esta va a quedar en estado “En Distribución” hasta que se hayan prendido todos los motores de la tienda para recibir la lista, recién ahí pasará a estado “Distribuida”. Pero los motores que recibieron la lista ya la pueden usar (aunque esté en estado “En Distribución”), sin importar que haya algún motor que no la recibió.

El parámetro vendrá por default en true.



IMPORTANTE

Si la lista de precios está fuera de vigencia (Inicio de Vigencia y Fin de Vigencia de la cabecera de la lista) no se puede distribuir (en el botón "Acciones" la opción "Distribuir" no estará disponible).



Distribución de Listas de Precios por Contingencias

En el botón Acciones, se agregará la opción “Descargar Distribución” (Solo habilitará esta opción en las listas de precios que estén pendientes de distribución).

Al hacer click en esa opción, aparecerá un popup que informa:

“Esta opción, se deberá utilizar únicamente en el caso que no exista conexión con la tienda correspondiente. Se descargará un archivo con la Lista de Precios (nombre de la lista) en (la ruta del motor donde se descargará la lista).  Desea continuar S/N?”

Al aceptar, se mostrará un popup indicando:

“Se descargó correctamente la lista de Precios. La misma deberá ser enviada por mail al usuario responsable de la tienda correspondiente”.

Luego la lista de precios, volverá a quedar en estado “Completa”.

Existe un  parámetro de configuración, que permitirá, realizar la distribuirnos por contingencia.

El mismo se deberá configurar en valor "true",, para que el sistema permita realizar la operación.  Por default vendrá en "false":

Activación de Listas de Precios

La activación puede ser automática o manual.


En el menú principal, en Administración\ Información de Configuración, se encuentra el parámetro: priceList.requiresActivation. Se utilizará ese parámetro para indicar si la activación de la lista es automática o manual:


Si el parámetro está en valor "true", indica que requiere Activación manual. Si esta en "false", no lo requiere, la activación es automática. Por default, vendrá en false


Activación Automática:

Si está configurado para que la activación sea automática, una vez que las listas fueron distribuidas, activa de manera automática las listas de precios y aplica la vigencia definida en la cabecera de la Lista (generada o derivada).


Activación manual:

Si está configurado para que la activación sea manual, la activación debe hacerla un usuario responsable, una vez que las listas se hayan distribuido en las tiendas. 

Al distribuir una lista, el sistema va a distribuir todo: la cabecera y los ítems. Esa lista va a estar en estado inactiva. Una vez distribuida la lista, se habilitará la opción "Activar".

Se podrá realizar la activación manual de lista de precios, desde la pantalla: Administración de Listas de Precios. Se deberá seleccionar la lista de precios que desea activar,  y dentro del botón "Acciones", se debe elegir la opción "Activar". El sistema pedirá confirmar la acción. Una vez confirmada el sistema va a activar la lista de precios. 


Cancelación de Listas de Precios

Las listas de precios  podrán cancelarse desde la Consola. De esta manera quedaran inactivas para ser usadas en la tienda en la cual se encontraban distribuidas.

Para cancelar una Lista de Precios, la misma deberá estar en estado "Completa"  o "Distribuida".

En ese estado, se deberá selecciona el botón "Acciones" > "Cancelar lista". El sistema pedirá confirmar la acción.


Consideraciones:

      1. Si la lista ya estuviera en estado "Distribuida" en alguna/s tiendas, se guardara con el estado "Cancelada", y volverá a distribuirse en la/las tiendas correspondientes, para que se refleje su estado, y NO este mas vigente en la tienda.
      2. Si la lista estuviera en estado "Completa", y aun no se hubiese distribuido, la misma se guardara en estado "Cancelada", y en ese estado, NO sera posible distribuirse en ninguna tienda/s.




Administración de Preciadores


Se podrán generar impresiones de etiquetas desde la Lista 0, y  a demanda desde: Listas 0, Generadas, y Derivadas.

Las impresiones se realizarán desde impresoras de inyección de tinta.


Formato de Preciadores


Los formatos de los preciadores funcionaran con la siguiente estructura:


      • Tipo: El usuario podrá seleccionar el tipo de template a diseñar (genérico/oferta). Estos tipos son fijos, vienen definidos en Promo y sirven para organizar los tipos de etiquetas que se utilizarán.
      • Categoría: El usuario podrá seleccionar la categoría (departamento) bien sea: hogar, electrodomésticos, entre otros. Es importante que el usuario tenga un catálogo de Categorías (departamentos) registrados, de lo contrario no podrá visualizar elementos para seleccionar.
      • Formato: Corresponde al cluster (campo Formato, disponible en Negocio → Tiendas) que se le asigna a la(s) tienda(s) asociadas al usuario. Para ello antes deberá importar el catálogo correspondiente (CatalogFormat.catalog) en Administración Importación de catálogos. Es importante que antes de crear el template, las tiendas asociadas al usuario ya tengan un Cluster asignado (formato), de lo contrario el usuario no podrá visualizar elementos para seleccionar.
      • Contenido: El usuario podrá diseñar la etiqueta en el tamaño que desee, utilizando herramientas como tablas, inserción de imágenes, fuentes, entre otros  elementos de diseño disponibles en las barras de herramientas, así como la inserción de las variables (detalles del producto, número de cuotas, precio regular, precio a crédito, etc) las cuales serán remplazadas por los valores reales del preciador al momento de imprimir. El tamaño por defecto a imprimir es sobre A4. El usuario podrá configurar los otros tamaños de hoja, como A5, A6, A7 y A9, insertando una tabla e indicando el tamaño (ancho y alto) correspondiente en píxeles.


Modelos de Templates:


 










Impresiones de Etiquetas

    • Un usuario puede tener vinculada 1 o más tiendas, para la impresión de etiquetas.
    • Una tienda puede tener asociados 1 o más templates de etiquetas. 
    • Las tiendas se podrán agrupar en Clusters, para lo cual se podrá utilizar el atributo "Formato", de la pantalla de Administración de tiendas.
    • Un template de impresión tiene asociada 1 categoría de producto.

Ejemplo:



Generación de Templates (Plantillas de Etiquetas)


Desde el menú Precios -> Plantillas de etiquetas, el usuario podrá crear, editar y visualizar los registros de plantillas realizadas, las cuales estarán asociadas al cluster (formato) de la tienda.


Al crear un nuevo registro el usuario deberá indicar todos los campos marcados como obligatorios:

    • Código: Identificador único de la plantilla
    • Nombre: Nombre que describe brevemente la plantilla de etiqueta.
    • Tipo: Tipo predefinido Oferta o Genérico.
    • Categoría: Nombre de la categoría.
    • Formato: Formato/Cluster asociado a las tiendas que tenga el usuario.
    • Orientación: Permite seleccionar la orientación que tendrá la página al imprimir. Permite seleccionar entre Vertical y Horizontal.
    • Plantilla: Se implementa el diseño y el contenido que tendrá cada etiqueta.
    • Etiquetas por página: Cantidad de etiquetas que se visualizarán por página.
    • Activo: Permite habilitar o deshabilitar el uso de la plantilla al momento de generar las etiquetas.




Recomendaciones:

    1. Crear el modelo de plantilla dentro de una tabla, para mantener la alineación de los elementos de una etiqueta.
    2. Agregar valores fijos como legales e insertar variables antes de definir un estilo.
    3. Ajustar el ancho y alto comparando el resultado con la vista previa.
    4. Asignar un tipo de fuente y tamaño a los textos y variables insertadas, de lo contrario los mismos se visualizarán con el tamaño y fuente por defecto disponible por el navegador. Para etiquetas apaisadas A4 se recomienda el uso de fuentes con tamaño superior a 48px.
    5. Al insertar una imagen tener en cuenta que se encuentre en el mismo servidor donde está el sistema, de lo contrario puede tener problemas para acceder a la imagen al momento de imprimir por temas del CORS del servidor de origen.
    6. Al momento de generar las etiquetas es posible que el formato del documento pdf tenga predefinido márgenes que modifiquen el resultado, desplazando los elementos.
    7. El contenido que se visualiza en la Vista Previa es solo contenido de referencia para una mejor apreciación del resultado final.
    8. Para mantener la alineación de los elementos de una etiqueta, se recomienda el uso de tablas.
    9. Agregar valores fijos como legales e insertar variables antes de definir un estilo.
    10. Definir el tamaño y el tipo de fuentes en todas las variables y textos incluidos.
    11. Se recomienda el uso de fuentes con tamaño superior a 48px solo para etiquetas apaisadas A4.


Consideraciones:

      • El usuario podrá observar el listado de templates asociados al cluster de la(s) tienda(s).
      • Al construir el Template es importante definir cuántas "Etiquetas por página" se desea entren en una página.
      • Los Templates no podrán ser eliminados, solo podrán deshabilitarse desmarcando la casilla "Activo".


Pasos para crear una plantilla

  1. Para diseñar una plantilla, se sugiere insertar una tabla presionando el botón Tabla (imagen 1), indicar la cantidad de filas y columnas a conveniencia del diseño.

 Imagen 1. Barra de herramientas del editor de texto.

2. Definir el ancho, borde y espacio entre celdas accediendo a las propiedades de la tabla (imagen 2).

Imagen 2. Propiedades de la tabla.


3. Para insertar color de fondo a la tabla, ir a las Propiedades de Tabla y seleccionar la pestaña Avanzada e indicar en el campo Estilos la propiedad css background-color: código-color; 

Imagen 3. Propiedades de la tabla - Avanzada.


4. Para indicar el color de fondo o del borde de la celda acceder con botón derecho sobre la tabla, en la opción Celda y acceder a sus propiedades, allí se podrán visualizar las opciones de estilo y ajuste de contenido disponible.

Imagen 4. Propiedades de Celda.


5. Para combinar las celdas, es necesario ingresar a las propiedades y seleccionar el tipo de combinación disponible (derecha, izquierda, hacia abajo).

Imagen 5. Combinar celdas en tabla.

 

 

6. Para crear un diseño armando el código html directamente o visualizar el código html asociado a los elementos insertados previamente, acceder a la opción Fuente HTML.

Imagen 6. Opción Fuente HTML

En esta opción se podrá escribir la estructura HTML que se desee así como indicar el estilo css específico para cada etiqueta.


7. Insertar las variables (botón: "Agregar una variable de sistema") asociadas a los datos que se desea ver en la etiqueta al momento de imprimir

Imagen 7. Opción variables.

 Ubicar dentro de la tabla la variable e indicar un estilo sobre la misma utilizando las opciones disponibles para definir tipo de fuenteformato color sobre el texto.


La funcionalidad Superdecimal le permitirá dar formato a las variables de sistema que representan montos, las cuales son: @itemCreditPrice, @itemRegularPrice, @itemOfferPrice, @save. Para aplicar el formato Superdecimal (superíndice) a la variable, solo se deberá seleccionar el texto de la misma y presionar el botón Superdecimal, este quedará sombreado indicando que la variable tiene aplicado ese formato.


8. Si el diseño así lo requiere se podrá insertar una imagen en la etiqueta presionando el botón Imagen, seguidamente se visualizará la ventana con las propiedades de la Imagen, indicar la URL (dirección http de la imagen) y un Texto alternativo, así como el ancho, alto y borde en caso de que sea necesario.

Imagen 8. Propiedades de la imagen.


9. Indicar la cantidad de etiquetas por página y visualizar el resultado en la Vista Previa, ajustar la cantidad y el ancho de cada etiqueta de acuerdo a la visualización.

 Imagen 9. Vista previa del diseño de etiqueta por página.

 Nota: Al momento de generar las etiquetas es posible que el formato del documento pdf tenga predefinidos márgenes que modifiquen el resultado, desplazando los elementos a la derecha o hacia abajo.


Aclaración

Si desea diseñar el contenido de la etiqueta desde la opción Fuente HTML:


Tenga en cuenta que si desea insertar cualquier variable de sistema debe mantener el siguiente formato:

Ejemplo:

<span class="promo-variable promo-variable-itemOfferPrice" data-value="itemOfferPrice" data-variable="itemOfferPrice">@itemOfferPrice</span>


Si desea agregarle el formato Superdecimal a la misma deberá incluir en el atributo class la clase super_decimal, quedando como resultado lo siguiente:

Ejemplo:

<span class="promo-variable promo-variable-itemOfferPrice super_decimal" data-value="itemOfferPrice" data-variable="itemOfferPrice">@itemOfferPrice</span>


Nota (Variables de sistemas)

La variable @itemRegularPrice va a mostrar el contenido de la columna $ para el ítem correspondiente, teniendo en cuenta:

  • Si la lista que está tomando como prioritaria es la lista cero mostrará el contenido del campo $ de la lista cero.
  • Si la lista que esta tomando como prioritaria es una lista derivada, va a tomar el precio de la lista cero.
  • Si la lista que está tomando como prioritaria es una lista generada va a mostrar el contenido de la columna $ de esa lista generada.

La variable @itemOfferPrice aplicará las siguientes condiciones: (Aclaración: las listas derivadas fueron creadas para manejar los precios ofertas o aumentos de los precios)

  • Si la lista que está tomando como prioritaria es la lista cero mostrará el contenido del campo $ de la lista cero.
  • Si la lista que esta tomando como prioritaria es una lista derivada, va a tomar el precio de la lista cero de la columna $ y le va a aplicar el cálculo que tiene configurado la lista derivada.
  • Si la lista que está tomando como prioritaria es una lista generada va a mostrar el contenido de la columna $ de esa lista generada.


Importante

Imágenes insertadas en las etiquetas:

Debe configurar la URL, texto alternativo, anchura y altura de la imagen a insertar:


Las imágenes no pueden estar en un equipo local, deben estar en un servidor. Pueden estar en un servidor en internet (primer imagen) o en el servidor donde está instalado Promo (segunda imagen).


Es necesario que las imágenes usadas en la plantilla de etiquetas se encuentren en un dominio con redireccionamiento autorizado o en el dominio donde se encuentre Promo. Todo esto para evitar problemas con políticas de seguridad tipo -> CORS header 'Access-Control-Allow-Origin' que ocurre cuando se usan imágenes de internet desde un dominio que no autoriza su uso.

En caso de omitir esta observación el sistema al momento de imprimir las etiquetas con una plantilla que tenga una imagen de fondo de estas características, se visualizara el siguiente mensaje: "Por favor, verifique la configuración de la plantilla, es posible que no se tengan permisos de origen para acceder a la imagen usada".

 





Impresión de etiquetas Pendientes

Se podrá visualizar los precios de una lista de precios en "Impresión de etiquetas pendientes", cuando esta pase a estado "Completa" o "Distribuida" (no dependerá de la variable priceList.distribution.print.before, no tendrá en cuenta a esta variable) (a partir de v.6.4.19). En "Impresión de etiquetas Pendientes" se listarán por prioridad, todas las etiquetas de precios que entran en vigencia y están pendientes de impresión.

IMPORTANTE

Hay un nuevo estado: “En Distribución” y se va a seguir usando la variable: priceList.distribution.print.before.

Si la variable está en "True", y la lista de precios está en estado “Completa”, permite imprimir las etiquetas.

Si la variable está en "False”, la lista tiene que estar en estado “En Distribución” o en estado “Distribuida” para poder imprimir las etiquetas.

El estado “En Distribución” quiere decir que seleccionó en una lista de precios, el botón "Acciones" / "Distribuir Lista" y la lista de precios está saliendo a los motores de las tiendas. Una vez que todos los motores la reciban ahí pasa a estado “Distribuida”.

Si en la tienda algún motor estaba apagado al momento en que se distribuye la lista de precios, esta va a quedar en estado “En Distribución” hasta que se hayan prendido todos los motores de la tienda para recibir la lista, recién ahí pasará a estado “Distribuida”. Pero los motores que recibieron la lista ya la pueden usar (aunque esté en estado “En Distribución”), sin importar que haya algún motor que no la recibió.

El parámetro vendrá por default en true.


El filtro "Tienda" se mostrará si en Negocio\ Tiendas hay mas de una tienda activa, si sólo hay una tienda activa este filtro no se mostrará. 

El filtro "Tienda" es autocompletable (a medida que se escribe va sugiriendo) y mostrará para el usuario logueado las tiendas que tiene activas en Seguridad\ Administración de Usuarios, sección "Tiendas disponibles"; si allí no hay ninguna tienda seleccionada el filtro "Tienda" mostrará todas las tiendas que estén activas en Negocio\ Tiendas. El usuario deberá seleccionar una tienda (sólo aquellas que tiene configuradas).



Luego de seleccionar la "Categoría" habilitará el botón "Generar etiquetas" para lo cual debe seleccionar antes una Plantilla desde el botón "Plantillas". Una vez ingresados los filtros seleccionar la lupa para ver en pantalla el resultado. 

Al momento de generar los preciadores, el usuario no necesitará conocer desde qué lista se debe generar el precio. El sistema detectará cual es el precio que está vigente ese día, en esa tienda.

Solo existe un precio vigente por cada SKU, en el caso de existir el producto en varias listas con vigencias sobrepuestas, el sistema tomará el precio de la lista que posea mayor prioridad, y dependiendo de cada SKU, ese precio puede estar en la lista 0, lista 1, etc.


SKULista 0Lista 1Lista 2
1111.9992.3002.100
1121.5001.8002.000
Prioridad025
Vigencia desdeindefinida08/02/201901/02/2019
Vigencia hastaindefinida15/03/201901/03/2019


De esta manera el sistema en el ejemplo 1, al generarse la Lista 0, generará una alerta de impresión de etiquetas, y el preciador tomará para el artículo 111 el precio $1.999.

El 01/02, generará una alerta con cambio de precio, y el preciador tomará el precio de la Lista 2, $2.100.

El 08/02, no se generará una alerta con cambio de precio ya que la prioridad de la lista 1 es menor al de la lista 2.

El 15/03, se generará una alerta con cambio de precio y el preciador tomará el precio de la lista 1, ya que la lista 2 de mayor prioridad ya finalizó su vigencia.


Con lo cual, el sistema estará pendiente de los cambios de precios que sucedan, por cambios de precios de las Listas 0, por entrada en vigencia de nuevas listas (generadas y derivadas), tomando la de mayor prioridad si se sobrepusieran las vigencias, y de los cambios que sucedan por la finalización de la vigencia de alguna lista de precios.

En el caso de que el ítem del precio tenga asignada una vigencia ("Vigencia Desde" y "Vigencia Hasta"), el sistema evaluará la misma. Si ya está fuera de vigencia o entra en vigencia a futuro, el sistema buscará ese ítem en otra lista de precios evaluando las prioridades como se describió anteriormente.

Nota

Si luego de buscar por prioridades en todas las listas de precios Derivadas y Generadas en estado Completa o Distribuida (a partir de 6.4.19), el preciador no encuentra el ítem para asignar un precio, lo busca en la Lista Cero, si tampoco encuentra allí, entonces aplicará el precio actual aunque ese ítem esté con vigencia vencida o a futuro, ya que no hay lista válida disponible para tomar el precio. Esta situación solo se daría por alguna contingencia para no mostrar el precio en 0.



Consideraciones:

      1. En el menú se podrá visualizar el número de etiquetas pendientes.
      2. La opción de generación de etiquetas estará disponible al seleccionar la categoría, esta categoría está directamente asociada al cluster de la tienda.
      3. Para las impresiones con stock, los ítems que no posean stock disponible quedaran fuera de la generación de etiquetas.
      4. Las etiquetas generadas con error permanecerán en lista de pendientes.
      5. Al registrar la impresión, el usuario podrá visualizar los detalles asociados solo a impresiones pendientes realizadas, en la sección: "Impresiones de etiquetas".
      6. Para imprimir etiquetas de forma mas específica, seleccione los ítems en el elemento checkbox colocado a la izquierda del listado.
      7. El botón "Generar Etiquetas" permanecerá deshabilitado hasta que el usuario seleccione una categoría que posea un template asociado a la tienda. De lo contrario se podrá visualizar la alerta "No hay un template asociado a la categoría".


NOTAS:

El usuario podrá elegir si desea imprimir etiquetas de los productos "con stock" o "sin stock", en el caso de elegir la opción "con stock", aquellos productos que se encontraban en estado pendientes de impresión, y que no fueron impresos, por no disponer de stock en la tienda correspondiente, quedarán con estado "sin stock".


Generación de etiquetas:

Al generar una impresión, el usuario podrá visualizar una barra de avance que indica el progreso en la descarga del documento (PDF) con todas las etiquetas a imprimir.

Una vez que la generación se haya completado se mostrará la barra con un 100% de progreso, generando una ventana con el archivo en formato PDF a descargar.


      


Registro de impresión:

Cada impresión registrada, guardará: la fecha-hora, tienda, el estado (impresión con error, impresión ok), cantidad de ítems, observación y detalles (lista o listas de precios que aplica, categoría, cantidad de sku con stock y cantidad de sku sin stock).

En el caso de que la impresión no se realice exitosamente el usuario podrá registrar los detalles del error, chequeando la opción "impresión con error"  e indicar los detalles del problema u observaciones.

Para las etiquetas impresas con error, el usuario podrá visualizar en la grilla el listado de la etiquetas con el icono (), las mismas permanecerán en el listado de pendientes hasta que no sean impresas exitosamente.


  

Adicionalmente el usuario podrá visualizar todos los registros de impresiones realizados, en la sección "Impresiones de etiquetas".



Cada impresión efectuada, creará un registro correspondiente, guardando: la fecha-hora, tienda, el estado (impresión con error, impresión ok), cantidad de ítems, observación y detalles (lista o listas de precios que aplica, categoría, cantidad de sku con stock y cantidad de sku sin stock).


Depuración de Registros de Impresión de Listas de Precios

La lista de items pendientes de impresión se borrará una vez transcurrido el período de tiempo configurado en Administración\ Información de configuración módulo: "prices", key: "priceList.job.cleanPriceListSchedule.time", por mas que esos ítems no se hayan impreso.


Una vez generadas las etiquetas pendientes y guardada la impresión, se podrán re-imprimir las veces que sea necesario desde "Impresión de etiquetas a Demanda".


Impresión de etiquetas a Demanda

El usuario podrá consultar por tienda, categoría, sku y lista de precios (opcional) y generar etiquetas de precios impresos con anterioridad. Es importante tener en cuenta que al consultar por categoría o sku el precio que aplica será de la lista de precios vigente y con mayor prioridad. En en caso de seleccionar una lista de precios particular, las etiquetas reflejarán solo los precios asociados a la lista seleccionada. Las listas de precios de las etiquetas mostradas en esta pantalla, estarán en estado "Completa" o "Distribuida" ordenadas por prioridad.


IMPORTANTE

Hay un nuevo estado: “En Distribución” y se va a seguir usando la variable: priceList.distribution.print.before.

Si la variable está en "True", y la lista de precios está en estado “Completa”, permite imprimir las etiquetas.

Si la variable está en "False”, la lista tiene que estar en estado “En Distribución” o en estado “Distribuida” para poder imprimir las etiquetas.

El estado “En Distribución” quiere decir que seleccionó en una lista de precios, el botón "Acciones" / "Distribuir Lista" y la lista de precios está saliendo a los motores de las tiendas. Una vez que todos los motores la reciban ahí pasa a estado “Distribuida”.

Si en la tienda algún motor estaba apagado al momento en que se distribuye la lista de precios, esta va a quedar en estado “En Distribución” hasta que se hayan prendido todos los motores de la tienda para recibir la lista, recién ahí pasará a estado “Distribuida”. Pero los motores que recibieron la lista ya la pueden usar (aunque esté en estado “En Distribución”), sin importar que haya algún motor que no la recibió.

El parámetro vendrá por default en true.


Adicionalmente, podrá realizar los registro de impresiones realizadas y visualizar los detalles en la sección "Impresiones de etiquetas"


En "Impresión de etiquetas a Demanda" se podrá re-imprimir seleccionando la lista de precios que desee, siempre y cuando esta lista no tenga para la Tienda y Categoría seleccionada ítems pendientes de impresión, si ese es el caso deberá ir a "Impresión de etiquetas Pendientes" e imprimir esas etiquetas para poder re-imprimirlas desde impresiones a demanda.

El filtro "Tienda" se mostrará si en Negocio\ Tiendas hay mas de una tienda activa, si sólo hay una tienda activa este filtro no se mostrará. 

El filtro "Tienda" es autocompletable (a medida que se escribe va sugiriendo) y mostrará para el usuario logueado las tiendas que tiene activas en Seguridad\ Administración de Usuarios, sección "Tiendas disponibles"; si allí no hay ninguna tienda seleccionada el filtro "Tienda" mostrará todas las tiendas que estén activas en Negocio\ Tiendas. El usuario deberá seleccionar una tienda.  

image2021-9-28_14-4-59.png


Consideraciones:

      1. El usuario podrá realizar la consulta de precios a imprimir por: Tienda, Categoría, sku, con stock y lista de precios
      2. La opción de generación de etiquetas estará disponible al seleccionar la categoría, esta categoría estará directamente asociada al cluster de la tienda
      3. Para las impresiones con stock, los items que no posean stock disponible quedaran fuera de la generación de etiquetas
      4. Al registrar la impresión, el usuario podrá visualizar los detalles asociados solo a impresiones a demanda, en la sección: "Impresiones de etiquetas".
      5. Para imprimir etiquetas de forma mas específica, seleccione los items en el elemento checkbox colocado a la izquierda del listado.
      6. El botón "Generar Etiquetas" permanecerá deshabilitado hasta que el usuario seleccione una categoría que posea un template asociado a la tienda. De lo contrario se podrá visualizar la alerta "No hay un template asociado a la categoría".
      7. Al seleccionar una categoría, que posea precios pendientes por imprimir el usuario visualizará la siguiente alerta: "Para los filtros seleccionados, existe items pendientes por impresión", indicando que deberá realizar la impresión de items pendientes antes de continuar.




Capítulo 9 - 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 fidealización de clientes.

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:

        • Formato Impreso: Serán los tipos de cupones que puedan emitirse desde el punto de venta. De seleccionarse este formato se deberá indicar los datos del cupón en formato texto a fin de que sean enviados al punto de venta.
        • Formato Electrónico: Serán los tipos de cupones que puedan enviarse vía mail. De seleccionarse este formato se deberá indicar los datos del cupón en formato .HTML a fin de que sean enviados al cliente que sea beneficiado con la promoción que emita estos cupones.
        • Codificación: Podrá allí ingresarse un texto plano o un HTML según el formato de Plantilla de cupón a utilizar. Podrán allí ingresarse Variables de usuario y/o de sistema según se desee confeccionar la plantilla de cupón.
          • Variables de Usuario: Son variables que luego serán editables desde la definición del Tipo de Cupón. Se propone para la definición de estas variables ingresar un "Nombre" y un "Tipo" de dato (Texto o Texto grande)
          • Variables de Sistema: son datos que serán reemplazados por la variable que informe el punto de venta al momento de emitir el cupón.

Las variables de Sistema disponibles en cupones son:

              • @couponid: código de identificación del cupón
              • @validfrom: Fecha de validez definida como DDMMYYYYHHmm
              • @validto: Fecha de expiración definida como DDMMYYYYHHmm
              • @amount: Monto calculado del cupón (aplica para los cupones que tengan monto)
              • @barcode: Código de Barras generado
              • @issueddate: Fecha de emisión del cupón


Las variables de Sistema provenientes de los datos disponibles en la transacción son:

              • @customer: Nombre del Cliente asociado a la transacción, si existe
              • @customerid: Identificación del cliente asociado a la transacción, si existe
              • @customerin: Número de Identidad del cliente asociado a la transacción.
              • @store: Identificación de la tienda asociado a la transacción
              • @storename: Nombre de la tienda que emite el cupón.
              • @terminal: Identificación del terminal asociado a la transacción
              • @promotionname: Nombre de la promoción que otorga el cupón
              • @raffleData: Números a imprimir en el voucher destinado a sorteo
              • @usedPoints: Cantidad de puntos usados por el Cliente para Sorteo y/o Alianza


Importante

  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 codigo de barra 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 o ver las promociones asociadas que emiten y/o redimen este tipo de cupón. A partir de la versión 7.0EP2.1 el botón "Acciones" mostrará también la opción "Exportació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:

        • Código: Será el identificador univoco del tipo de cupón, campo alfanumérico.
        • Nombre: Identificador dentro de la consola del tipo cupón, campo alfanumérico.
        • Descripción: campo alfanumérico, describirá el tipo de cupón que se está creando.
        • Formato: es la forma en que el cupón le llega al usuario beneficiado.
          • Impreso: Cupones que se emitirán en papel físico desde la impresora de la línea de cajas.
          • Electrónico: Cupón que se enviara vía mail a un cliente determinado
          • Externo: Cupones no administrados por PROMO. Este tipo de cupón es emitido y/o redimido por un sistema externo a PROMO.
          • Pre-Impreso: Son cupones que el motor solo informará pero de los que no va a generar nada al momento de la emisión en el POS dado que se entiende que el cajero ya lo tendrá consigo para entregarlos, no podrá indicarse una plantilla de cupón para este y serán No Nominados.
          • Informativo: Son cupones que podrán emitirse desde Promo cuando una Promoción lo indique, pero no se realizará ningún registro de esta emisión en la base de datos de Promo, ni se le asignará ningún código de Barras, ni número de cupón. Se imprimirá o enviará por mail (de acuerdo a como se haya configurado el formato en la plantilla del cupón) la información detallada en el cupón. Este tipo se cupón solo se utiliza para informar.
        • Prefijo: Son los primeros tres dígitos con que se generara el código de barras de un cupón a emitir. Este campo puede ser auto-completado por la propia consola de PROMO o bien puede ingresarse a mano según se configure. (Ver Administración > Información de configuración para mas información de como configurar los prefijos de cupones)
        • Codificación: Deberá indicarse qué tipo de código de barras se informara en el cupón que se emitirá a partir del tipo de cupón que se está definiendo.
        • Las codificaciones soportadas por PROMO son
            • EAN13: Numérico, 12 dígitos más 1 digito verificador.  Ej.: 1040010010131
            • UPC-A: Numérico, 11 dígitos más 1 digito verificador.  Ej.: 108001010171
            • CODE-128: Alfanumérico, de largo variable.  Ej.: 10800100100000000000000000000087
            • Personalizado: Campo Alfanumérico de carácter obligatorio, con longitud  variable. El dato ingresado, no puede ser nulo ni 0 (cero). 
              Los cupones que se emitan, se conformaran por lotes de 999 cuyo máximo será 1.000.000.
              En cuanto a la nomenclatura, la misma se conformará por la concatenación del campo personalizado + la numeración secuencial del cupón (6 dígitos). 
              Ej.: "Navideño + 123658".→ Navideño123658

        • Tipo de Inicio de vigencia: se podrá definir para un tipo de cupón cuando comenzara a estar vigente (Valido para su uso) el o los cupones que se generen a partir éste. Mostrará las siguientes opciones:
          • Fecha: al seleccionarlo desplegará el campo “Válido desde”, donde se podrá seleccionar el día, mes y año especifico en que comenzara a estar vigente un cupón. (La hora tomada por el sistema para el inicio de vigencia será las 00:00:00)
            Días desde la creación: Se podrá indicar la cantidad de días desde el momento de la creación, que deberán pasar para que el cupón generado a partir del tipo de cupón comience a estar vigente.

          • Desde la emisión: Al seleccionarlo, se estará indicando que el cupón generado a partir del tipo de cupón comenzara a estar vigente desde el mismo momento que es generado.
        • Valido Desde: Indicará la fecha a contemplarse de inicio de vigencia. Por default se carga fecha actual.
        • Tipo de Fin de vigencia:  se podrá definir para un tipo de cupón cuando vencerá (ya no podrá ser redimido ni canjeado por ningún beneficio) el o los cupones que se generen a partir éste. Mostrará las siguientes opciones:
            • Fecha:  al seleccionarlo desplegará el campo “Válido hasta”, donde se podrá seleccionar el día, mes y año especifico en que vencerá un cupón. (La hora tomada por el sistema para el fin de vigencia será las 23:59:59)
            • Días Luego de la Activación: Se podrá indicar la cantidad de días que deberán pasar desde el momento que el cupón se ha activado y ha entrado en vigencia, para que el cupón generado a partir del tipo de cupón pase a estado "Vencido".
            • Horas de vigencia: al seleccionar esta opción se mostrará debajo el campo "Horas de vigencia" y dos campos que permitirán ingresar la hora en el campo de la izquierda y los minutos en el campo de la derecha.

Como se muestra en el siguiente ejemplo puede ingresar el siguiente horario: 23:53 hs.


Ejemplos casos de uso Horas de vigencia:

  • En el siguiente ejemplo el cupón será válido desde las 00:00 horas del 1ro de octubre del 2022 hasta las 10:00hs 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 hs.) 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.


Importante

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.



            • Sin vencimiento: Los cupones generados a partir de un tipo de cupón con este tipo de vencimiento, o vencerán nunca.


              Podrá indicarse, por medio de la configuración en la consola de Promo si se validará que la vigencia de la promoción esta contemplada dentro de la vigencia del tipo de cupón.

              Para esto deberá habilitarse la opción "valid.date.couponType". También será requerida la configuración que marca como obligatoria el ingreso de la condición de Rango horario de Fecha con Hora para dar por completa la promoción, y que el tipo de cupón a validar este definido con un tipo de vigencia definido por fecha de inicio y fecha de fin.


              De no cumplirse con alguna de las 3 pre-condiciones no se realizara la validación entre las fechas de vigencia del tipo de cupón y la vigencia de la promoción.

              Al habilitarse esta configuración se validara que al momento de definir una promoción de Redención de cupones, la fecha de vigencia del tipo de cupón ingresado en la definición de la condición de la promoción incluya las fechas definidas en la condición de rango horario de la promoción (Fecha con Hora).

              También se validara que al momento de definir una promoción de Emisión de cupones, la fecha de vigencia del tipo de cupón ingresado en la definición del beneficio incluya las fechas definidas en la condición de rango horario de la promoción (Fecha con Hora).

        • Valido Hasta: Indicará la fecha a contemplarse de finde vigencia. Por default se carga fecha actual.
        • Plantilla de cupón: en este menú se propondrán las plantillas de cupón generadas anteriormente, y dependiendo de si se eligió formato electrónico o formato impreso, el menú mostrara las plantillas generadas para tal formato, evitando de esta forma que se asigne erróneamente por ejemplo una plantilla impresa a un formato de tipo de cupón electrónico.
        • Nominado: De seleccionarse esta opción, para otorgar este tipo de cupón se requerirá que exista un cliente asociado a la venta. En la redención de un cupón Nominado, se validara que el cliente asociado al cupón sea el mismo que el presente en la transacción para habilitar el consumo del cupón.
        • Cupón calculado: Al seleccionar esta opción se indicara que la plantilla será utilizada para generar cupones calculados.
        • Consumo Total: Cuando se indique que el tipo de cupón será "Calculado" se habilitará la posibilidad de indicar si, para redención del tipo de cupón calculado que se está dando de alta, deberá validarse que el monto de los elementos beneficiados por el cupón calculado de este tipo, sea igual o mayor al valor del cupón. Una vez redimido este cupón no se podrá volver a utilizar aunque lo haya redimido por un monto menor a su valor.
        • Límite de usos: Indicara la cantidad de veces que un cupón puede ser canjeado por el beneficio que otorga, siempre debe existir una promoción que evalúe como condición la existencia de este tipo de cupón y que otorgue como beneficio lo indicado en el cupón que se emite.


        • Campañas de Fidelidad: Podrá indicarse si el tipo de cupón aplica a una campaña. Esta definición no altera ni modifica la operatoria y funcionalidad del tipo de cupón.
        • Activo: podrá indicarse si la plantilla que se está generando o editando esta activa para su uso o no.
          Al presionar el botón “Guardar” muestra la siguiente pantalla:


    • Seleccione Editar Plantilla:

                   

                   

                   

Al presionar el botón guardar:

                   

Se verá el tipo de cupón:

      

                   


Edicion de Tipo de cupon DISTRIBUIDO

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



IMPORTANTE

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.


Nota

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.


Información

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.

Importante

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.

Exportación de Cupones a Sistemas Externos

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.


Nota

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



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:

          • Tipo de Cupón:  Mostrará la primera opción del listado de tipo de cupones que se encuentren en estado activo (distribuido o habilitado) y podrá seleccionar uno de esos tipos. (Los tipos de cupones "Externos" no se presentaran en el filtro ya que no son gestionados por Promo.)
          • Estado: Mostrara "Emitido" y podrá seleccionarse emitido, redimido, cancelado, inactivo o vencido.
          • Emisión Desde y emisión Hasta: Mostrará el día "Desde" y "Hasta" que se ejecuta la búsqueda. Al ingresar sugerirá la última semana; pero se podrán filtrar rangos superiores a 7 días. No habrá límite con el rango de fechas a filtrar.

Los siguientes filtros podrán ingresarse según necesidad de búsqueda:

          • Identificador de cliente: podrá realizarse la búsqueda de cupones ingresando un identificador de cliente determinado. Podrá ingresarse solamente el identificador del cliente para obtener todos los cupones asociados a éste.
          • Identificador de cupón: podrá filtrarse por el código de barras o código de un cupón. Podrá ingresarse solamente el identificador de cupón para obtener los datos de un cupón en particular.
          • Tienda: podrá filtrarse por las tiendas activas en la consola. Aquí también podrá indicarse si la búsqueda se realizara para los cupones dados de alta masivamente seleccionando la opción "- Cupones Masivos -".


Debajo de los filtros de búsqueda se mostrarán dos campos para navegar los registros, los cuales estan descriptos en Paginado

                      Al ingresar mostrará una pantalla como la siguiente:

IMPORTANTE

Si utiliza 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:



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 mostrará un botón "Ver", al presionarlo se mostrará la pantalla "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.


Importante

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.




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.

NOTA

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:


          • Estado (Procesado [ Verde ], en proceso [ Celeste ], Error [ Rojo ] )

          • Fecha (Fecha y hora en que se inició el proceso)
          • Cantidad de Cupones generados


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

Información

 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 - Manual de Usuario Final 7 - Apéndices - Español#ManualdeUsuarioFinal7-Ap%C3%A9ndices-Espa%C3%B1ol-_Toc513717178%22Llevando3om%C3%A1sart%C3%ADculosdeldto.Limpieza,ganaunCup%C3%B3n%22

Se debe crear la promocion 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.

IMPORTANTE

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:


          • Código: Será el identificador univoco del tipo de elemento de fidelidad, campo alfanumérico.
            Este puede ser autogenerado; para ello se debe configurar en: Administración >> Información de configuración, cardtype.IncrementalCode = true



            Al habilitarse la opción de código auto-generado e incremental, al dar de alta un nuevo tipo de elemento, el código no podrá ingresarse mas de forma manual, sino que el sistema ya propondrá un numero a asignar al tipo de elemento.

                             
          • Nombre: Identificador dentro de la consola del tipo de elemento de fidelidad, campo alfanumérico.
          • Descripción: campo alfanumérico, describirá el tipo de elemento de fidelidad que se está creando.
          • Rangos de Prefijos: el/los valores indicados en este popUp representarán los primeros dígitos con que se asignarán al código de los elementos generados a partir del tipo de elemento de fidelidad que se está definiendo. Este valor se puede ingresar manualmente o puede ser auto-generado. (Ver más detalle debajo).
          • Externa: Podrá indicarse que el tipo de elemento que se esta dando de alta en Promo sera gestionada por un tercero, es decir, no serán gestionadas por Promo. Solo se darán de alta con el fin de poder participar de promociones, ya sea de otorgamiento de puntos como de redención, pero estas acciones no serán registradas en Promo, sino que serán informadas al POS, quien sera el encargado de informar estos movimientos a quien corresponda. Al tildarse esta opción solo podrá indicarse si esta activa y si participa de alguna campaña de fidelidad, las demás opciones no aplican para la definición de este tipo de elemento.
          • Cantidad de dígitos: aquí deberá indicarse el largo del código del elemento a generarse a partir del tipo de elemento de fidelidad seleccionado. Se tomaran en cuenta para la generación del código del elemento de fidelidad el largo del prefijo que deberá esa contemplado al momento de definir este campo. Por ejemplo, si un elemento tiene como prefijo "333" y el largo del elemento es 13, los tres primeros dígitos del elemento serán "333" y los 10 dígitos restantes corresponderán al número del elemento propiamente dicho.
          • Tipo de vencimiento: se podrá definir para un tipo de elemento de fidelidad el vencimiento que traerá asociado el elemento que se genere a partir ésta.

Podrá seleccionarse entre:

              • Fechas: Al seleccionarse, habilitará dos campos de carácter obligatorio, que determinaran la fecha de inicio y fin de vigencia del elemento. Este dato podrá definirse en el archivo desde el cual se den de alta los elementos de fidelidad, si es que se opta por el alta masiva desde la consola. En caso de que no se indique una vigencia en el archivo de alta, los elementos que se generen tomarán la vigencia definida en el Tipo de elemento. De indicarse una fecha desde y una fecha hasta en el archivo de alta, los elementos serán generados con la fecha indicada en el archivo de alta. Esta operatoria también rige para el alta de elementos via Punto de Venta como para el alta de elementos via servicio/RabbitMq.

                  • Valido desde:  Refiere a la fecha de inicio de vigencia del elemento. (La hora tomada por el sistema para el inicio de vigencia será las 00:00:00).
                  • Valido hasta:  Refiere a la fecha de fin de vigencia del elemento. (La hora tomada por el sistema para el fin de vigencia será las 23:59:59).




              • Días desde la activación: el elemento que se genere a partir de este tipo de elemento de fidelidad estará vigente una x cantidad de días desde el momento de su activación. Esta cantidad de días deberá definirse en el campo "días de activación" que figurara debajo del campo "tipo de vencimiento" cuando se seleccione esta opción (default 365 días).

            • N/A: el elemento que se genere a partir de este tipo de elemento de fidelidad no tendrá vencimiento y estará vigente desde el día de su activación.

          • Pre-cargada: en este menú se podrá indicar si los elementos dados de alta a partir de este tipo de elemento de fidelidad tendrán una carga asociada o no.

Podrá seleccionarse entre:


            • No: el elemento que se genere a partir de este tipo de elemento de fidelidad no tendrá carga al momento del alta.
            • Archivo: el elemento que se genere a partir de este tipo de elemento de fidelidad deberá tener asociado un saldo en el archivo que la genere.
            • Definir pre-carga: el elemento que se genere a partir de este tipo de elemento de fidelidad tendrá el saldo definido en el campo "Definir pre carga" al momento del alta.
          • Recargable: De seleccionarse esta opción, el elemento dada de alta a partir de este tipo de elemento de fidelidad podrá recibir carga ya sea desde la consola como de promociones aplicadas.
          • Vencimiento de carga: en este menú podrá indicarse si la o las carga asociada a un elemento de fidelidad tienen un vencimiento asociado en este campo podrá definirse la política de vencimiento de saldo de las tarjetas que se definan a partir de este tipo de elemento. Las opciones disponibles son:

Podrá seleccionarse entre:

            • Sin vencimientoIndica que los saldos asignados al elemento de fidelidad nunca vecen.
            • Días desde la carga: Indica que los puntos asignados al elemento de fidelidad podrán tener fechas de vencimiento diferentes, en base a la fecha en que fueron asignados.(por default 365 días).
            • Fecha: Podrá indicarse, desde un calendario,  la fecha en que vencen todos los puntos de un tipo de elemento de fidelidad, independientemente de la fecha en que fueron asignados.
            • Dias desde la activacion: Podrá indicarse, en cantidad de días, el vencimiento de todos los puntos de un tipo de elemento de fidelidad, independientemente de la fecha en que fueron asignados.  Los días comenzaran a contar desde el momento de la activación.
            • Frecuencia: Podrá indicarse en base a opciones predefinidas cuando vencen todos los puntos de un tipo de elemento de fidelidad, independientemente de la fecha en que fueron asignados. Al seleccionar Frecuencia se mostrara la opción "Mensual", y al seleccionarlo se estará indicando que los puntos cargados en el elemento vencerán el primer día de cada mes a las 00:00:00 




          • Nominada: En el menú desplegable, podrá indicarse si el elemento a dar de alta con el tipo de elemento que se está definiendo puede tener asociado un cliente o no.

Las opciones disponibles son:

            • No (los elementos generados a partir de un tipo de elemento con esta definición no tendrán asociado cliente)
            • Por Archivo de Alta Masiva (los elementos generados a partir de un tipo de elemento con esta definición deberán asociársele el cliente en el archivo de alta de elementos)
            • En canal de Venta (los elementos generados a partir de un tipo de elemento con esta definición podrán asociársele un cliente desde el punto de venta). Valor por default.
        • Nota

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

          Configuración disponible

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




          • Transferible: En este menú se podrá indicar si un elemento de fidelidad puede transferir todo o parte de saldo a otro elemento del mismo tipo.

Podrá seleccionarse entre:


            • NO: el tipo de elemento de fidelidad que tenga esta opción en NO, indicara que los elementos generados a partir de este tipo no podrá realizar ningún tipo de transferencia a otro.
            • Total: Total: el tipo de elemento de fidelidad que tenga la opción de transferencia en "Total" solo podrá transferir en una sola acción la totalidad de su saldo a otro elemento de su mismo tipo y que este en estado inactivo. Al hacerlo el elemento de origen ( que da el saldo) quedara cancelado y con saldo cero, mientras que el elemento de destino (recibe el saldo) pasara de inactivo a activo y tendrá como saldo la totalidad de saldo que tenía el elemento de origen, así como también se le asignara el convenio y cliente que tenía asociado el elemento de origen.
            • Parcial: el tipo de elemento de fidelidad que tenga la opción de transferencia en "Parcial" podrá transferir total o parcialmente a un elemento activo de su mismo tipo sin sufrir ninguna de los dos elementos alteraciones en su estado.

          • CVV requerido: De seleccionarse esta opción, el elemento que se dé de alta con este tipo de elemento deberá que tener asociado un código CVV de validación, el cual será requerido tanto para el alta del elemento como para la imputación o consumo de saldo desde el punto de venta. . Los elementos que se den de alta a partir de un tipo de tarjeta que tenga el check de CVV requerido activo, deberá realizarse por medio de archivo. El CVV no puede tener un largo mayor de 5 posiciones, ni debe ser nulo si se tilda el check.

          • Canal Exceptuado de CVV:  Al momento de chequear el campo "CVV Requerido", se habilitara el combo "Canal exceptuado de CVV" desde donde se podrá indicar que "canal" quedará exceptuado de la validación de CVV al momento de realizar alguna operación con este tipo de elemento de fidelidad. Este campo solo podrá cargarse vía catalogo. Si no se encuentra cargado el catalogo de canales (catalogChannel.catalog), el combo se mostrara vacío y no podrán exceptuarse canales de la validación de CVV. Cuando el catalogo de canales este cargado, al desplegar el combo se mostraran los canales allí presentes y podrá seleccionarse uno para exceptuarlo de la validación de CVV; en las operaciones donde se ingrese un elemento de este tipo.

            Ante el caso de ser un canal excluído de CVV, y requerir la validacion del CustomerID, se debe configurar la variable correspondiente, descripta en el manual de Instalación.


            IMPORTANTE

            Cuando desde un punto de venta se envíe una consulta u operación con elemento de fidelidad, se evaluará el atributo "channel" de la cabecera del mensaje para validar si el canal allí indicado coincide con el definidos en el canal exceptuado para el tipo de elemento de fidelidad al que pertenece el elemento.

            Si hay coincidencia (el canal informado en la mensajería esta exceptuado de validación de CVV en tipo de elemento de fidelidad al que pertenece el elemento consultado), no se validara el CVV asi haya sido enviado no en el elemento. (<loyaltycard-add />)

            Las validaciones de CVV según canal se realizan en los siguientes status reservados: 

            • LoyaltyValidation
            • LoyaltyActivation
            • FINISH
            • ReturnFinish


            No se realiza Validación de CVV en los siguientes status reservados (para mantener compatibilidad con versiones anteriores donde tampoco se validaba CVV)

            • LoyaltyTransfer
            • LoyaltyVoid
            • LoyaltyAssign

          • Máximo de puntos a otorgar por transacción: Al momento de dar de alta un tipo de elemento de fidelidad, se podrá indicar si el tipo de elemento controlara un máximo de otorgamiento de puntos por transacción, independientemente de los beneficios que sumen a este tipo de elemento en la transacción.  Se podrá en una misma transacción, aplicarse n beneficios que apliquen un mismo tipo de elemento de fidelidad, pero de estar cargado un valor en este campo, se recortara la cantidad de puntos a otorgar al valor aqui definido. Si el tipo de elemento tiene definido un valor en el campo "Máximo de puntos a otorgar por transacción", este prevalecerá por sobre el  definido en el beneficio que otorgue los puntos.

            IMPORTANTE

            En caso que el POS informe una carga directa sobre un elemento de fidelidad en la transacción ("chargeAmount"), se validara que el tipo de elemento al que pertenece ésta, tenga definido un valor en "Máximo de puntos a otorgar por transacción". En caso de tenerlo, la carga se realizara hasta el valor indicado en el campo "Máximo de puntos a otorgar por transacción".

            Cuando un elemento de fidelidad se encuentre en estado "Distribuido" solo se permitirse la edición del campo "Máximo de puntos a otorgar por transacción", todos los demás campos y checks estarán des-habilitados.

          • Tope de saldo: en este campo deberá indicarse un valor en caso de que se requiera que los elementos dadas de alta a partir de este tipo de elemento de fidelidad no puedan tener un saldo superior a lo indicado aquí. De no completarse este campo, la recarga de saldo no tendrán límite.

          • Consumo parcial: En caso de tildarse esta opción, los elementos generados a partir de este tipo de elemento de fidelidad podrán consumir la totalidad de su saldo en más de una operación, caso contrario, de no tildarse, el saldo del elemento deberá consumirse en una sola transacción. En caso de que esta única transacción sea por un valor menor al saldo del elemento, este se inactivara perdiéndose el saldo restante.

          • Activo: De no tildarse esta opción el tipo de elemento de fidelidad no estará disponible para la generación del elemento. Por defecto el check está marcado para que todos los tipos de elemento generados se encuentren habilitados para la generación de elementos.

          • Campañas de fidelidad: podrá indicarse si los elementos dados de alta a partir este tipo de elemento estarán asociadas a una campaña. Se mostraran las mismas campañas que al momento de dar de alta una promoción.


        • Rangos de Prefijos: Al presionar el botón Agregar Prefijos, en la pantalla "Nuevo Tipo de Elemento de Fidelidad" el sistema mostrará el siguiente modal para la carga de rango de prefijos. El usuario podrá ingresar los prefijos como se muestra en la siguiente pantalla.

NOTA

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, luego se debe seleccionar el botón "Procesar Archivo".

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. 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 al cliente que rangos no cumplen con las condiciones y mostrará por pantalla el listado de la siguiente manera:

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. 

NOTA: Configuración de Rangos de Tipos de Prefijo

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 validara, al ingresar un rango de prefijos que éstos no estén incluidos en los rangos de otros tipos de elemento.

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:

          • Habilitado: el tipo de elemento está disponible para la generación de elementos. Los tipos de elementos en estado habilitado pasan a estado distribuido cuando se genera un elemento ya sea en estado activo o inactivo. Si se generaron con alta masiva de elementos, pero la generación por algún motivo dio error, el tipo de elemento no pasa a estado distribuido (si es que antes no estaba ya en estado distribuido), queda en estado habilitado.
          • Distribuido: se han creado elementos de este tipo, pueden estar activos o inactivos.
          • Inhabilitado: tipo de elemento de fidelidad cuyo check "Activo" está destildado.


Edición de tipo deelemento 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.




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.



Esta pantalla dispone de filtros que permitirán realizar una búsqueda más detallada de los elementoa 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:

          • Estado: Mostrara "Activo" y podrá seleccionarse Activo, Inactivo, Cancelado o Vencido. 
          • Tipo de Tarjeta:   Mostrando la primera opción de la lista. Permitirá filtrar por tipos de elementos de fidelidad activos en la consola.
          • Valida desde y Valida hasta: Por Default,mostrara un rango de 7 días, donde el día que se ejecuta la búsqueda sera la fecha tomada para el "Hasta". El "Desde" mostrara la fecha que corresponda a 7 días antes del "Hasta"). Se pueden elegir rangos más grandes que 7 dias.

Los siguientes filtros podrán ingresarse según necesidad de búsqueda:

          • Identificador de cliente:  Podrá filtrarse por un identificador de cliente determinado. Podrá ingresarse solamente el identificador del cliente para obtener todas los elementos asociados a éste.
          • Número de tarjeta:  Podrá filtrarse por el número del elemento determinado. Podrá ingresarse solamente el identificador del elemento de fidelidad para obtener los datos de un elemento en particular.
          • Convenio: Podrán filtrarse los elementos asociados a un determinado convenio.

Desde el botón "Acciones" se podrá ver el detalle de cada una de las tarjetas existentes, y se podrán activar elementos, modificar el saldo, cancelarlas o simplemente visualizar su estado e historial de acciones.

NOTA

Si se modifica el saldo de un elemento inactivo, el elemento se pasa a Activo.


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:

          • desde la consola (alta manual) o
          • desde un archivo .catalog (si el tipo es: nominado, o requiere cvv, o fecha). 

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

            • Si se ha ingresado una cantidad que sobrepase la cantidad de elementos restantes a generar. Para cada rango de prefijos solo se podrán generar números de elementos hasta completar el máximo de rangos. Una vez sobrepasado el límite el sistema mostrará un mensaje indicando que se ha excedido la cantidad de elementos a generar. Ejemplo de mensaje: "El máximo disponible para generar elementos es de 90".
              Ejemplo de escenario: si se definió un rango en donde el máximo posible de prefijos es de 30 y se generaron previamente 10 rangos. La próxima vez que se requiera generar nuevos, y se ingrese una cantidad mayor a  20, solo se podrán generar hasta 20 elementos y luego el sistema mostrará un mensaje indicando que no se pueden generar mas de x cantidad de elementos.
            • Que no se supere el alta de mas de 999 registros.


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 las tarjetas generadas desde el botón “Ver informe”.



          • Alta por archivo (o automática):

Se tendrá que seleccionar del combo “[ Tipos de elemento ]” 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 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.

Nota

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

Los elementos dados de alta por medio de archivo serán generados en estado “INACTIVOS”.


NOTA

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\


IMPORTANTE

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 las tarjetas de fidelidad deberá tener el siguiente formato separado por pipes ( | )

      ID|Type|Date-from|Date-to|CVV|Customer|Amount


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.
Date-from/Date-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 Clientes".
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".


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)

NOTA

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 algun 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 clientes 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á:

          • Asociar los elementos, con los clientes, los convenios, y asignarles un saldo inicial
          • Ajustar saldos en los elementos (Incrementar, disminuir o reemplazar el saldo en un elemento de fidelidad)

Cuando se realice la asignación de clientes/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


          • Id: Número de elemento existente al que se le asociara cliente/convenio o al que se actualizara su saldo. 
          • customer: Cliente que se asociara al elemento.
          • amount: Saldo que se asignará al elemento. (numérico con decimales)


Suma, Resta o Reemplazo de saldo

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

          • Si se intenta procesar un archivo que ya fue procesado previamente, no se permitirá procesar el archivo y se informara por pantalla un mensaje indicando que el archivo ya fue procesado previamente.
          •  Si el nombre o la extensión del archivo, no corresponde con el formato indicado, no se permitirá procesar el archivo y se informara por pantalla, un mensaje indicando que el nombre o extensión del archivo a procesar es incorrecto.
          • Si el archivo posee en su nombre un tipo de elemento que no corresponde al tipo de elemento existente en PROMO, se mostrara un mensaje en pantalla, indicando que el tipo de elemento no corresponde a un tipo de elemento valido, y no permitirá procesar el archivo.
          • Si el archivo posee en su nombre un código de convenio,  que no corresponde a los códigos de convenio que el/los elementos que contenga, tengan asociado en la DB, se mostrara un mensaje en pantalla, indicando que el/los elementos ya se encuentran asociadas en la DB a otro convenio y no permitirá procesar el archivo.
          • Si el archivo posee en su nombre un tipo de elemento,  que no corresponde a los tipos de elemento que los elementos que contenga tengan asociado en la DB, se mostrara un mensaje en pantalla, indicando que el tipo de elemento informado en el nombre del archivo no se corresponde con el tipo de elemento  de los elementos informados en el archivo y no permitirá procesar el archivo.
          • Si el archivo posee en su nombre un código de convenio, que no existe dentro de los convenios dados de alta por PROMOse mostrara un mensaje en pantalla, indicando que el convenio no corresponde a un código de convenio valido y no permitirá procesar el archivo.
          • Si el elemento no tiene asignado un código de Convenio, se actualizara el elemento con el código de convenio, contenido en el nombre del archivo que está siendo procesado.
          • Si el elemento no tiene asignado un código Cliente, se actualizara el elemento con el código de cliente informado en el registro.
          • Si el elemento posee estado "Activo", el campo amount, actualizara el saldo del elemento.
          • Si el elemento posee estado inactivo, se actualizara el saldo del mismo con el valor informado en el campo amount y el elemento pasara a “activa”.
          • Si se informa un cliente y el elemento no tiene un cliente asociado, se verificara si el cliente informado existe en la base de clientes, y de ser así, se actualizara el campo con el valor informado en el archivo. Si el cliente informado, no existe, informara un mensaje por pantalla, indicando que el cliente informado, no existe, y no permitirá procesar el archivo.
          • Si se informa un cliente y el elemento tiene asociado otro cliente, informara un mensaje por pantalla, indicando que el elemento tiene asociado otro cliente y no permitirá procesar el archivo.
          • Si no se informa el cliente, se informara un mensaje por pantalla, indicando que el campo cliente es requerido, y no permitirá procesar ese archivo


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



NOTA

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:




IMPORTANTE

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 tarjetas

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.

(En versiones posteriores a 7.EP2.1) 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
Desasociació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)


                    • Activar/Cancelar: Podrá activarse un elemento que se encuentre inactiva o bien cancelar un elemento que se encuentre activa, Esta acción de cancelación no podrá deshacerse.







                • Modificar Saldo: Se permitirá incrementar y/o disminuir el saldo de un elemento según la configuración del tipo de elemento al que pertenece.

(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 extravió.

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

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 tarjetas ( 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:



            • Código: Identificador univoco del convenio (Requerido)
            • Nombre: Nombre asignado al convenio a dar de alta (Requerido)
            • Descripción: datos extras que apliquen al convenio a dar de alta (Opcional)
            • Activo: Check que indicara si el convenio a dar de alta se encuentra activo para ser asociado a elementos de fidelidad.

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.

Importante

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 tarjetas de fidelidad que esten asociadas 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 y cupones asociados, así cual es el estado de cada uno de estos elementos de fidelidad.

Para ello se deberá dar click en el menú desplegable "Acciones" y luego en "Ver".Por Default la aplicación devuelve los datos de los tres últimos meses.



Cuando se requiere un informe con fechas superiores a las que la aplicación trae por default; ésta hará una autocorrección de las fecha y mostrará el mensaje correspondiente.

Dentro de esta pantalla podremos observar los elementos y Cupones asociados del cliente y el estado de cada uno de ellos.

También se muestra aquí 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.


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: 

              • Ver 
              • Eliminar Datos Cliente

IMPORTANTE

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.

IMPORTANTE

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

              • el registro del cliente en catalog.customer (el cliente ya no se verá en la pantalla "Gestión de clientes", ni siquiera se verá el código), 
              • cupones,  
              • tarjetas relacionadas 
              • históricos de tarjetas y cupones (Los puntos están en la tarjeta, si se borra la tarjeta ya no se tiene mas los puntos). 

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 elmininación total:


Capítulo 10 - Módulo de Informes


PROMO - Manual de Usuario Final 7 - Informes - Español





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:

        • Código: Podrá buscarse una tienda en particular por medio de su código.
        • Nombre: Podrá buscarse una tienda en particular por medio de su código. 


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


Nueva Tienda

Dentro del menú Tiendas presionando el botón "Nuevo" accederá a la pantalla "Crear Tienda":




          • Los campos a completar son:
            • Código: Deberá asignarse un código identificador.
            • Nombre: Nombre que identifique a la tienda. Podrá tener de 3 a 150 caracteres.
            • Domicilio: Domicilio propio de la tienda
            • Email: dirección de email con el cual se encuentra registrada.
            • CIA: a la cual pertenece la Tienda
            • Zona: la zona a la cual pertenece la tienda.
            • Subzona: la subzona a la cual pertenece la tienda
            • Canal: el canal de a tiend
            • Cadena: la cadena de la tienda
            • Formato: el formato de la tienda
            • Tienda de Laboratorio: se debe consignar si la tienda es de producción o de laboratorio para la confección de pruebas en caso que se lo requiera.
            • Activo: Indica si la Tienda a que se crea esta Activa o no.

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.

Importante

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 configuracion son:

              • AUTO: el mapa a distribuir sera posteado para uno o varios motores quienes se lo descargaran en sus directorios de manera automática.
              • FILE: podrá distribuirse en algún directorio especifico.
              • FTP  Seguro: podrán indicarse las credenciales correspondiente para poder distribuir via FTP.
              • FTP: podrán indicarse las credenciales correspondiente para poder distribuir via FTP.


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.




IMPORTANTE


En caso de que la distribución automática sea a un motor que opera en modo "Multitienda" el mapa sera 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 distribucion automatica se realia en un NO opera en modo "Multitienda" el mapa sera 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".




IMPORTANTE

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.

Importante

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.


 Competidores


Desde el Menú Negocio/Competidores, se accederá a la siguiente pantalla, desde donde se registrarán los Competidores, con sus respectivas tiendas, y los precios que los mismos publiquen para los artículos.

Se podrán buscar competidores filtrando por Código, y Nombre.

Alta de Competidores:

El usuario operador accede al menú "Competidores" y selecciona el botón "Nuevo"

Desde este menú se creará la cabecera del competidor.

Se deberán completar los campos:

          • Código (alfanumérico de hasta 15 posiciones, requerido)
          • Nombre (alfanumérico de hasta 30 posiciones, requerido)
          • Código Identificador (alfanumérico de 15 posiciones, opcional) (ej. en Argentina sería el CUIT)
          • Activo (Check)
          • Descripción de la imagen (alfanumérico de hasta 50 caracteres, opcional)
          • Imagen asociada, subir imagen (imagen del competidor, opcional)

  

El usuario graba el nuevo Competidor seleccionando el botón “Guardar y continuar”

Una vez creada la cabecera del competidor, el usuario debe crear las tiendas asociadas a ese competidor ingresando en Negocio\ Competidores\ Competidores, seleccionar el botón Acciones\ Definir sobre el competidor al cual se le van a agregar las tiendas.


Se desplegará una pantalla como la siguiente. Donde el usuario podrá editar la cabecera. O presionando el botón “Agregar Tiendas”, se podrán agregar tiendas que quedarán asociadas a ese competidor.

El filtro "Tienda" permite buscar por nombre de tienda del competidor que se está creando o definiendo.


Al seleccionar el botón “Agregar Tiendas” mostrará un pop up solicitando los datos de la nueva tienda.

Se deberán completar los campos:

          • Código (alfanumérico de hasta 15 posiciones, requerido)
          • Nombre (alfanumérico de hasta 30 posiciones, requerido)
          • Dirección (alfanumérico de hasta 50 caracteres, opcional)
          • Activo (check para Habilitar o Deshabilitar tienda)

Al seleccionar el botón “Guardar” se guardarán los cambios y se cerrará el pop up. Si se selecciona el botón x se cerrará la ventana sin guardar los cambios realizados.


Modificar Competidor:

La imagen asociada puede cambiarse o puede quedar sin imagen asociada.

Los campos “Código” y “Nombre” no pueden ser modificados.

El campo “Código Identificador” es editable.

El check Activo, se puede habilitar o deshabilitar

Desde el menú Competidores > Acciones  > Editar, se podrá editar el competidor:

           

           Se podrán modificar los datos del Competidor y se podrá grabar, haciendo click en el botón "Guardar"


Publicación de precios del Competidor:


Desde el Menú Competidores > Publicaciones de Precios, se accederá a la pantalla desde la cual se podrán registrar las publicaciones de los competidores:

Al presionar el ítem "Selecciones Tienda", la aplicación desplegará aquellas tiendas que el usuario tiene configuradas.
  

Al seleccionar el botón “Nuevo”, se podrá crear la cabecera de publicación de precios de competidores, mostrará una pantalla como la siguiente:

Seleccionar en los combos desplegables el Competidor y Tienda correspondientes (sólo las que tiene configuradas el cliente).

Guardar los cambios seleccionando el botón “Guardar y Continuar”.


Abrirá la pantalla Detalles donde se mostrará por unos segundos un cartel verde indicando “La operación ha sido exitosa”. En la parte superior muestra los detalles de la “Cabecera”, que se pueden editar si se desea. Y debajo muestra “Publicaciones de precios”.

 

En el campo Artículo se puede ingresar el código de un producto (SKU), o se puede escribir el nombre del artículo, si encontró coincidencias se va a desplegar una ventana con todas las coincidencias encontradas para los caracteres ingresados.


Seleccionar el artículo.

El sistema mostrará el producto seleccionado y permitirá cargar los precios de las publicaciones de los competidores:

El usuario ingresara los campos: precio publicado (requerido), fecha de publicación (requerido) e imagen (opcional). Debe presionar el botón “Guardar” para guardar datos ingresados.


 


Modificación de Publicaciones de Precios:

 Desde el menú Competidores\ Publicaciones de Precios, seleccionar botón Acciones sobre el competidor, luego seleccionar “Definir”.

En esta vista sólo estarán detalladas las tiendas que el usuario tiene configuradas; de la misma manera que en el combo para seleccionar una tienda.

Se puede ver la imagen asociada al producto ingresado seleccionando el botón “Imagen Asociada”

Se puede modificar la publicación seleccionando el botón Editar.


Se puede eliminar el producto seleccionando el botón Eliminar.

 

Filtros Publicaciones de Precios:

Desde Negocio\ Competidores\ Publicaciones de Precios, se puede filtrar por Competidor o por Tienda (el usuario tendrá disponible sólo las que tiene configuradas), seleccionando en el combo correspondiente y luego en el botón lupa.

Los filtros se borran con el botón x.


Consultar variaciones de precios:

Se puede consultar la variación de precios de un producto determinado, en un competidor y una tienda específicos, seleccionando el botón “Consultar Publicaciones”, “Variación de Precios”.

Abre una ventana como la siguiente.

 El usuario debe ingresar el Sku, competidor y tienda (sólo estarán disponibles las que tiene configuradas el usuario). Los tres campos son requeridos para esta búsqueda. Una vez ingresados los filtros presionar el botón lupa.

Muestra los diferentes precios de un Sku determinado en una tienda y competidor determinados, dentro de un rango de tiempo determinado.

El rango de tiempo se configura en Administración\ Información de Configuración (Módulo: Negocio, Categoría: promo.common.security.policies, Clave: publishedDays), campo: Cantidad de días de antigüedad de precios publicados de competidores.


Consulta Comparar con Competencia:

Se podrán consultar los últimos precios publicados  por la competencia para un artículo ingresando en Negocio\ Competidores\ Publicaciones de Precios, en el filtro “Consultar Publicaciones” seleccionar la opción: “Comparar con competencia”.

Abre una ventana como la siguiente.

Ingresar en el filtro el Sku o descripción del artículo que se desea comparar con la competencia y presionar el botón lupa.

Muestra todos los competidores, con sus respectivas tiendas, precios publicados y fecha de visualización, que tengan el Sku ingresado en el filtro y con fecha de visualización dentro del rango de tiempo que fue configurado previamente.



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.




Con el botón "Nuevo" se puede crear un nuevo segmento. Los datos a ingresar son los siguientes:

Código y Nombre, son los dos requeridos y tienen que ser únicos, ambos son alfanuméricos.

Al seleccionar “Guardar y continuar”, mostrará la pantalla “Detalle” , ahí se carga desde “Examinar” el archivo con los segmentos y luego 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 y Fecha de actualización. Luego de la carga de los clientes, se agregarán datos complementarios como: nombre del archivo y cantidad de clientes subidos.


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.



IMPORTANTE:

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

  • Tipos de Elementos Activados: Gráfico de barras donde se muestre la cantidad de Tipos de Elementos de Fidelidad Activados.
  • Cantidad de cupones emitidos por tipo de cupón: Gráfico de barras con emisiones por tipo de cupón.
  • Porcentaje total de cupones emitidos: Gráfico de torta con distribución de emisiones por tipo de cupón.
  • Cantidad de cupones redimidos por tipo de cupón: Gráfico de barras con redenciones por tipo de cupón.
  • Porcentaje total de cupones redimidos: Gráfico de torta con distribución de redenciones por tipo de cupón.
  • Ranking de beneficios (Ranking 10): Aplicación de promociones por beneficio monetario.
  • Ranking de promociones (Ranking 10): Aplicación de promociones.
  • Ventas por categoría (Ranking 5): Ventas por categoría.
  • Ventas por hora (Ranking 5): Ventas por hora.
  • Ventas por tienda (Ranking 5): Ventas por tienda.
  • Ventas por medio de pago: Ventas por medio de pago.


Cupón Calculado

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 reconfigurado desde la consola en caso de ser necesario (Ver Administración >> Información de Configuración - clave: "fileList.txt.Separator")

Este capítulo proveerá la información necesaria para la administración y carga de los catálogos desde la consola de PROMO.


Carga de Catálogos desde un Archivo

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.


Contenido del catálogo

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

IMPORTANTE

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

El formato de los registros de este catálogo debe ser code|description


CampoTipo de datoObservaciones
codestringCódigo o nro. de elemento de fidelidad. Requerido
typestringTipo de elemento a la que pertenece el elemento de fidelidad. Requerido
valodFromstringValido 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.


Ejemplo de registros del catalogo para Elementos:

541400002201|541|2019-01-01|2029-12-31|520|9595|500
541400002202|541|2019-01-01|2029-12-31|363|9655|1500
541400002203|541|2019-01-01|2029-12-31|218|1212|600

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
codestringrequerido
namestringrequerido
statestring- 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


IMPORTANTE - Campos requeridos para la importación de catalogo de cliente

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)
CampoTipo de datoObservaciones
codestringCorresponde al código que se le asignara al cliente en Promo. (requerido)
namestringNombre de cliente. (requerido)
lastNamestring
Apellido del cliente. (requerido)
genderstring
Genero 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.)
birthDatestring
Fecha 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
identificationTypestring
Tipo 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
identifierstring
Numero de identificación del cliente. (requerido)
identificationExpirationstring
Fecha de expiración de la identificación del cliente.
nacionalitystring
Nacionalidad del cliente
emailstring
e-Mail del cliente.
customerTypestring
Tipo 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.)
addressstring
Dirección del cliente.
addressCountry
string
Paí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.)
addressStatestring
Provincia 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.)
addressCitystring
Ciudad 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.)
addressPostalCodestring
Código Postal
phonestring
Teléfono
isActivebooleanoIndicara si al momento del alta el cliente estará Activo o Inactivo. Deberá definirse como true o false.
segmentsstring
Segmento/s asociado al cliente


Ejemplo de registros del catalogo para Cliente:

1001|juan|perez|2|03-05-1959|01|11552266||Arg|[email protected]|111|Av.Livertad 123|100|200|300|2321|1566558222|true|5500
1002|pablo|gonsalez|2|03-05-1970|02|10002565||Arg|[email protected]|111|Roca 555|100|200|300|2213|156632545|true|5500
1003|raul|fernandez|2|03-05-1983|02|50363221||Arg|[email protected]|111|Nuñez 111|100|200|300|2001|46613232|true|5500
1004|John|Promo|2|03-05-1950|01|527748512||Arg|[email protected]|111|Callao 999|100|200|300|7453|49872000|false|5500
1005|maria|gutierrez|1|03-05-1999|01|123456789||Arg|[email protected]|111|entre rios 656|100|200|300|4456|11548970701|true|5500
1006|ana|gomez|1|03-05-1998|03|951753000||Arg|[email protected]|222|aguero 540|100|200|300|6675|1145600000|true|5500
1007|laura|lopez|1|03-05-1981|01|55421957||Arg|[email protected]|333|palestina 333|100|200|300|6642|1174788884|true|5500
1008|carlos|martinez|2|03-05-1987|01|38546200||Arg|[email protected]|222|Av. Directorio 1587|100|200|300|1122|1166532032|true|5500
1009|roberto|garcia|2|03-05-1979|01|20159987||Arg|[email protected]|333|ramallo 3456|100|200|300|3346|46258130|true|2244
1010|jose|montes|2|03-05-1949|01|30665448||Arg|[email protected]|111|9 de Julio 754|100|200|300|8864|123654789|true|2244

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)
unitepricenumé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
detailstringDetalle
detail2stringDetalle 2


Ejemplo de registros del catalogo para Items:

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 nombre del archivo a importar deberá tener el siguiente formato: catalogStore.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:

10|Tienda A
11|Tienda B
12|Tienda C

El nombre del archivo a importar deberá tener el siguiente formato: catalogItemStock.catalog

El formato de los registros de este catálogo debe ser store|code|name


CampoTipo de datoObservaciones
storetienda - Dependencia con el catalogo de tienda. Corresponderá al código definido en el catalogo de tienda relacionado.requerido
codestringrequerido
stocknumérico - stock en tienda


Ejemplo de registros del catalogo para Stock:

10|778|10000
11|aaa|600
12|788|3000

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


CampoTipo de datoObservaciones
codestringrequerido
namestringrequerido


Ejemplo de registros del catalogo para Pago:

10|pago A
11|pago B
12|pago C

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 "-".
codestring
Código del producto. Requerido.
pointsNumérico con decimales.Puntos requeridos.
discountValueNumérico con decimales.Valor descuento.
discountTypestring
Tipo 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:

Balance
1|Empleado


El directorio en donde se alojarán los archivos de catálogo que serán tomados e importados automáticamente por el proceso de importación de catálogos automática, es C:\synthesis\promo\catalog. (Ver Capítulo de Administración > Información de configuración. Promo.catalog >> fileDirectory). Este directorio deberá utilizarse cuando los archivos de catálogos sean de mas de 1Mb.


Recepción de catalogos vía RabbitMQ

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 7.1.)



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



ModuloClaveValorDescripción
1CuponesbarcodePathC:/synthesis/promo/images/barcode/Directorio imágenes de códigos de barra
2CuponesbarcodeUrlhttp://localhost:8080/promo/assets/barcode/Url imágenes de códigos de barra
3Cuponescustomermask5
4



5PromofileDirectoryC:/synthesis/promo/catalogs/napse\Importación de catálogo: directorio donde estarán los archivos
6NegociomoneySymbol$Símbolo de moneda
7Elementos de fidelidadmax.qty999Cantidad máxima de tarjetas a generar por cada operación de alta masiva
8Elementos de fidelidadisEditableAfterCardsGenerationfalsePermitir la edición del tipo de tarjeta luego de haber generado una tarjeta activa
9Elementos de fidelidadprefix.activefalseUtilizar prefijo numérico incremental para tipos de tarjeta
10Elementos de fidelidadcode.activefalse

Utilizar código numérico incremental para tipos de tarjeta

11Elementos de fidelidadcard.nominated.default.optionNo

Tipo de tarjetas: Crear por defecto nominadas (default: false = no)

12CuponesCODE128PPPSSSTTTnnnnnnnnnnnnnnnnnnFormato de código de barras CODE128
13CuponesEAN13PPPSSSTTTnnncFormato de código de barras EAN13
14CuponesUPCAPPPSSSTTTnncFormato de código de barras UPCA
15Cuponesmax.qty999Cantidad máxima de generación Masiva de Cupones por transacción
16Cuponesprefix.activetrueUtilizar prefijo numérico incremental para tipos de cupón
17CuponesamountFormat%.02fFormato en el que se imprimen los montos de los cupones
18PromoapplicationMethodresumePromociones: valor por defecto en el método de aplicación
19PromodivisionMethodproportionalPromociones: valor por defecto en el método de división
20PromodivisionPricebenefited-pricePromociones: valor por defecto el tipo de precio beneficiado
21PromonameInfoPos0IndistintoNombre del campo de información adicional para el pos en el beneficio de cupones.
22PromonameInfoPos1Campo 1Nombre del campo de información adicional para el pos en el beneficio de cupones.
23PromonameInfoPos2Campo 2Nombre del campo de información adicional para el pos en el beneficio de cupones.
24PromorequiredBothSuppliersfalsePromociones: valor por defecto si requiere ambos proveedores del beneficio
25PromofileList.txt.Separator,Importación de catálogo: separador
26PromofileList.xls.ColStart0Importación de catálogo: columna de comienzo de la importación de catálogo
27PromofileList.xls.DirectionverticalImportación de catálogo: forma de importación
28PromofileList.xls.RowStart0Importación de catálogo: fila de comienzo de la importación de catálogo
29Promoseparator|Importación de catálogo: separador de columnas
30PromoupdateSize100Importación de catálogo: tamaño de subida
31Promovalid.date.couponTypetrue

Valida si la vigencia de la promoción esta contemplada dentro de la vigencia del cupon

32Promovalidate.autocomplete.existing false

Valida que los campos autocomplete de catálogos SOLO permita valores existentes

33PromoisEditableCouponTypeDistributedfalseHabilita la edición de tipos de cupones en estado "Distribuidos"
34NegociocharsMaximumAlphabetical 20Cantidad máxima de caracteres alfabéticos
35NegociocharsMaximumNumerical 20Cantidad máxima de caracteres numéricos
36NegociocharsMaximumQuantity 20Cantidad máxima de caracteres totales
37NegociocharsMaximumSpecial 20Cantidad máxima de caracteres especiales
38NegociocharsMinimumQuantity 7Cantidad mínima de caracteres totales
39NegociocharsMinimumUser 3Cantidad minima de caracteres en el nombre de usuario
40NegociomaximumLoginFailedCount 3Cantidad máxima de reintentos de login fallidos sucesivos
41NegocionumberQuantity 1Cantidad mínima de caracteres numéricos
42NegociopasswordExpirationDays 30Días de expiración de la contraseña del usuario
43NegociopublishedDays 7

Cantidad de diás de antiguedad de precios publicados de competidores

44NegociospecialCharsQuantity 0Cantidad mínima de caracteres especiales
45NegociostringQuantity 1Cantidad mínima de caracteres alfabéticos
46NegociouserBlockDays 90Bloqueo de usuario - días de inactividad
47NegociouserLockTime 30Periodo de bloqueo de la cuenta de usuario (en minutos)
48Promoattribute.relationship.validation.requiredfalse

Requiere validación de datos de atributos de ítem en la condición de promociones

49Promocustomer.requiredfalse

La promoción requiere condición de Cliente para considerarse completa

50PromodateTime.requiredfalse

La promoción requiere condición de Fecha con hora para considerarse completa

51Promotransaction.requiredfalseLa promoción requiere condición de Transacción para considerarse completa
52Negociocompetitors.images.pathC:\synthesis\promo\images\custom\competitors\

Directorio para almacenamiento de imagenes de competidores

53NegociocompetitorsPricesItems.images.pathC:\synthesis\promo\images\custom\competitorsPricesItems\

Directorio para almacenamiento de imagenes de precios publicados de competidores

54PromopathC:/synthesis/promo/import/Directorio para la importacion de Mapas de Promociones.
55Promobenefit.activefalseUtilizar campo numérico incremental para beneficios
56Promopromotion.code.activefalseUtilizar campo numérico incremental para promociones
57PromoredeemedPoints0

Determina el mínimo de puntos para beneficios de redención

58Cuponesdefault.from[email protected]Email por defecto con el que se enviaran los correos
59Cuponesdefault.insertImagesfalseIndica si acepta o no barcodes
60Cuponesdefault.subjectPromo Test MailAsunto por default
61Cuponeshostsmtp.gmail.comHost del proveedor de email
62Cuponespassword**************Contraseña de la cuenta de email
63Cuponesport
Puerto de conexión
64Cuponessmtp.authtrueHabilitar Auth SMTP
65Cuponessmtp.port587Puerto SMTP
66Cuponessmtp.socketFactory.classjavax.net.ssl.SSLSocketFactorynombre de la clase SSLSocketFactory
67Cuponessmtp.socketFactory.fallbackfalseFallback de socketFactory
68Cuponessmtp.socketFactory.port465Puerto SMTP de socketFactory
69Cuponessmtp.starttls.enabletrueHabilitar Start TLS
70Cuponessmtp.ssl.trust*Nombre de host de certif de confianza (* todos)
71Cuponesusername[email protected]Usuario o nombre de la cuenta de email
72Promouse.item.catalog1Mapas: algoritmo de cálculo de colisiones
73PromocleanEngineStatusHistory7Tiempo en días que la consola mantendrá el historial de estados del motor
74PromodefeatedEditable.enabled
true

Habilita la edición de promociones vencidas

75PromodeployedEditable.enabledfalseHabilita la edición de promoción con el estado Deployed.
76PromodateEditableIfActivetrue

Habilita la edición de la fecha de inicio de vigencia de la promocion

77Promofile.xls.header.rowStart1Alta masiva de promociones: número de fila donde se va a ubicar la cabecera de la plantilla de promoción
78Promomessage.printer.maxLength

Recortar mensage para a impresora.

79Promopromo.name.codefalse

Indica si el código de una promoción, debe ser concatenado al nombre de la misma

80Promopromotion.codeKeyfalse

Campo código de promoción clave

81Promopromotion.enginestatus.communication600Tiempo que transcurre desde el último informe de estatus del motor o consola, para considerarlo offline. Si en ese tiempo no informó se lo considera offline.
82Promopromotion.images.height250Promociones: alto default de las imagenes
83Promopromotion.images.pathC:/synthesis/promo/images/promotion/Promociones: directorio para almacenamiento de imágenes
84Promopromotion.images.width250Promociones: ancho default de las imagenes
85CuponesrabbitMQ.couponHistory.endpointNameNombre de la cola rabbitMQ para exportar cupones

Nombre de la cola de RabbitMQ para el posteo de datos de movimientos de cupones

86PromorabbitMQ.cardhistory.endpointName

Nombre de la cola de RabbitMQ para el posteo de datos de movimientos de tarjetas

87PromorabbitMQ.producer.manual.promotion.enabled

Habilitar el posteo manual de datos desde la promoción

88PromorabbitMQ.SSL.enabledfalse

Activar SSL

89PromorabbitMQ.enabledtruePropiedad que indica si está habilitado rabbitMQ
90Promo

rabbitMQ.date.UTC

enabledPermite que los datos del tipo fecha sea con el uso horario del server y no GMT (default).
91PromorabbitMQ.endpointName


Nombre de la cola de rabbitMQ

92PromorabbitMQ.host

Dirección (host) del RabbitMQ server

93PromorabbitMQ.limitstatus.endpointName

Nombre de la cola de RabbitMQ para el posteo de datos de tipo LimitStatus

94PromorabbitMQ.password

Password para acceder al rabbitMQ

95PromorabbitMQ.port

Puerto del server rabbitMQ

96PromorabbitMQ.producer.SSL.enabledfalse

Activar SSL para el posteo de datos

97PromorabbitMQ.producer.enabledfalse

Propiedad que indica si esta habilitado rabbitMQ para el posteo de datos

98PromorabbitMQ.producer.host

Dirección (host) de RabbitMQ server para el posteo de datos

99PromorabbitMQ.producer.password

Password para acceder al RabbitMQ server para el posteo de datos

100PromorabbitMQ.producer.port

Puerto del RabbitMQ server para el posteo de datos

101PromorabbitMQ.producer.uri

URI de conexión completa RabbitMQ server para el posteo de datos

102PromorabbitMQ.producer.username

Usuario para acceder a RabbitMQ server para el posteo de datos

103PromorabbitMQ.producer.virtualHost

Virtual Host RabbitMQ server para el posteo de datos

104PromorabbitMQ.promotion.endpointName

Nombre de la cola de RabbitMQ para el posteo de datos de tipo Promotion

105PromorabbitMQ.uri

URI de conexión completa rabbitMQ

106PromorabbitMQ.username

Usuario para acceder al rabbitMQ

107PromorabbitMQ.virtualHost

virtual Host al rabbitMQ

108PromoreportParticipantsfalsePromociones: valor global que determina si la promoción informa participantes
109PromoreportParticipantsVisibletrueDetermina si se visualiza o no, la opción reportar participantes
110PromobankRefundBenefit.method.of.payment

ON_ITEMS_PAID = calcular promociones sobre items pagados


ON_PAYMENT_MADE = Calcular promociones sobre pago realizado

Reintegro bancario: Opciones de cálculo de reintegro

111PromobankRefundBenefit.method.of.payment.onItemsPaid.classcom.synthesis.promo.engine.partialPayment.hardcoded.promotion.BankRefundPartialPaymentGSPromotion

Reintegro bancario: Clase de la promoción basada en items

112PromobankRefundBenefit.method.of.payment.onItemsPaid.namePromociones basadas en items - Reintegro bancario

Reintegro bancario: Nombre de la promoción basada en items

113PromobankRefundBenefit.method.of.payment.onItemsPaid.tenderMethodPropertyKey

promo.configuration.tenderMethod.itemMethod

Reintegro bancario: Propiedad basada en items a utilizar

114PromobankRefundBenefit.method.of.payment.onPaymentMade.classcom.synthesis.promo.engine.partialPayment.hardcoded.promotion.BankRefundPartialPaymentSSPromotion

Reintegro bancario: Clase de la promoción basada en pagos

115PromobankRefundBenefit.method.of.payment.onPaymentMade.namePromociones basadas en pagos - Reintegro bancario

Reintegro bancario: Nombre de la promoción basada en pagos

116PromobankRefundBenefit.method.of.payment.onPaymentMade.tenderMethodPropertyKeypromo.configuration.tenderMethod.paymentMethod

Reintegro bancario: Propiedad basada en pagos a utilizar

117Promomethod.of.payment

ON_ITEMS_PAID = calcular promociones sobre items pagados


ON_PAYMENT_MADE = Calcular promociones sobre pago realizado

Promocion Codificada: NOTHING, ON_ITEMS_PAID, ON_PAYMENT_MADE
118Promomethod.of.payment.onItemsPaid.classcom.synthesis.promo.engine.partialPayment.hardcoded.promotion.PartialPaymentsGSPromotionPromocion Codificada: nombre de la promoción por medio de pago basada en ítems.
119Promomethod.of.payment.onItemsPaid.namePromociones basadas en itemsPromocion Codificada: nombre de la promoción por medio de pago basada en ítems.
120Promomethod.of.payment.onItemsPaid.tenderMethodPropertyKeypromo.configuration.tenderMethod.itemMethodPromocion Codificada: nombre de la promoción por medio de pago basada en ítems.
121Promomethod.of.payment.onPaymentMade.classPartialPaymentsSSPromotionPromocion Codificada: nombre de la promoción por medio de pago basada en ítems.
122Promomethod.of.payment.onPaymentMade.namePromociones basadas en pagosPromocion Codificada: nombre de la promoción por medio de pago basada en ítems.
123Promomethod.of.payment.onPaymentMade.tenderMethodPropertyKeypromo.configuration.tenderMethod.paymentMethodPromocion Codificada: nombre de la promoción por medio de pago basada en ítems.
124PromoldapAuthenticationfalseDetermina si se autentica contra un Directory Service


125PromoldapAuthentication.autheticationModeDIGEST-MD5

Es el modo de seguridad que se autentica, usar "DIGEST-MD5" como valor default dado que este modo encripta la información contra el Directory Service.

126PromoldapAuthentication.urlServer
URL del server contra el que se autentica.
127PromotestEnginePORT3001Simulación: puerto en el que corre el motor para simulación
128PromotestEngineRetries2Simulación: reintentos de conexión al motor
129PromotestEngineSalesPathC:/synthesis/promo/engine/sales/Simulación: ruta del motor
130PromotestEngineTimeout8000Simulación: timeout de conexión al motor
131Redes socialesfacebook.appId1068803576479010Id de la aplicación de facebook
132Redes socialesfacebook.permissions[publish_actions, manage_pages]Permisos de la aplicación de facebook
133Redes socialesfacebook.secretdfa5ffe6aa6306fc49472dbcba3c16a9Clave secreta de la aplicación de facebook
134Redes socialesfacebook.securehttpsProtocolo de conexión segura a la aplicación de facebook
135Redes socialestwitter.accessToken2848331890-D2geAfGVL9u2bD6TrD1LxH5fUsXlBnHLa3FOziKToken de acceso a twitter
136Redes socialestwitter.accessTokenSecretNHd6JbcoLaBK5QEfrKgmOaQwwxmbwlEtOYlQni3Fx6H3yToken secreto de acceso a twitter
137Redes socialestwitter.consumerKeyHTPKOHdatasoDsm2Ud7ULnUapAKFXoCClave consumer key de twitter
138Redes socialestwitter.consumerSecretX1plqdQWK0nRCGz6KFxm37IZTzp4O7w9BjLSspIr4mYWLZsrOyClave consumer secret de twitter
139PromorequestMap.catalog.brand.importationDetail - contunueOnErrortruePermitir continuar la importación de catálogo de marcas ante un error
140Elementos de fidelidadrequestMap.catalog.card.importationDetail - contunueOnErrortruePermitir continuar la importación de catálogo de tarjetas ante un error
141Elementos de fidelidadrequestMap.catalog.card.importationDetail - insertionOptionINSERT_OR_UPDATEDescribe la opción de inserción para la importación del catálogo de tarjetas
142PromorequestMap.catalog.category.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de categorías ante un error

143PromorequestMap.catalog.channel.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de canales ante un error

144PromorequestMap.catalog.creditCampaignCode.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de compañía crediticia ante un error

145PromorequestMap.catalog.customer.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de clientes ante un error

146PromorequestMap.catalog.customerType.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de tipos de clientes ante un error

147PromorequestMap.catalog.eventTransaction.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de transacciones ante un error

148PromorequestMap.catalog.eventTransactionType.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de tipos de transacción ante un error

149PromorequestMap.catalog.family.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de familia ante un error

150PromorequestMap.catalog.format.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de formatos ante un error

151PromorequestMap.catalog.infoFinancial.importationDetail - contunueOnErrortrue

Permitir continuar la importación del catálogo de información financiera de lista de precios ante un error

152PromorequestMap.catalog.item.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de ítems ante un error

153PromorequestMap.catalog.itemStock.importationDetail - contunueOnErrortrue

Permitir continuar la importación del catálogo de stock ante un error

154PromorequestMap.catalog.level1.importationDetail - contunueOnErrortrue

Permitir continuar la importación del catálogo de level1 ante un error

155PromorequestMap.catalog.paymentBank.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de bancos ante un error

156PromorequestMap.catalog.paymentCode.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de pagos (Código) ante un error

157PromorequestMap.catalog.paymentPrefix.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de prefijos ante un error

158PromorequestMap.catalog.paymentType.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de tipos de pagos ante un error

159PromorequestMap.catalog.profileCode.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de perfil de cliente ante un error

160PromorequestMap.catalog.store.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de tiendas ante un error

161PromorequestMap.catalog.storeChain.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de cadenas ante un error

162PromorequestMap.catalog.subCategory.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de sub categorías ante un error

163PromorequestMap.catalog.subZone.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de subzonas ante un error

164PromorequestMap.catalog.supplier.importationDetail - contunueOnErrortruePermitir continuar la importación de catálogo de proveedores ante un error
165PromorequestMap.catalog.zone.importationDetail - contunueOnErrortrue

Permitir continuar la importación de catálogo de zonas ante un error

166TransaccionescleanTransactions90Cantidad de días que permanecerán los registros de transacciones en la base de datos
167Lista de preciospriceList.distribution.force.offlinefalse

Habilita la acción descargar contingencia en todo momento

168Lista de preciospriceList.job.cleanPriceListSchedule.time90Cantidad de días a mantener los ítems en la lista de precios pendientes de impresión
169Lista de preciospriceList.lockForUpate15Minutos para poder desbloquear Lista cero en el proceso rest
170Lista de preciospriceList.mongo.bulk.insertOrUpdate200Cantidad de registros a insertar por lote en el proceso rest
171Lista de preciospriceList.distribution.print.before300

Cantidad de días a mantener los ítems de la lista de precios futuros procesados

172Lista de preciospriceList.requiresActivationfalseParámetro para configurar si requiere activación de listas de precios
173Cuponespromo.benefit.calculatedCoupon.externalAmountexternalAmountAttributeCodeOfitemAddAtributo que se utilizará en la etiqueta item-add para indicar el monto externo del cupón
174Promopromo.catalog.customervalidateRelatedEntitiesValidar catálogos relacionados al catálogo de clientes
175PromodistributionThreadPool

10

Cantidad de hilos creados para la distribución simultánea
176Promoscheduled.enabledfalseGeneración y distribución programada de mapas
177Promoscheduled.filter.enablefalse

Filtrar promociones por tienda para la distribución programada

178Promoscheduled.mapVersiontrue

Incrementar la versión del mapa para la distribución programada

179PromodecimalSeparator.Separador de decimales, solo para Lista de precios y para PromoLite. Para el resto lo toma de la configuración de la máquina.
180

Promo







groupingSeparator







,







Separador de miles, solo para Lista de precios y para PromoLite. Para el resto lo toma de la configuración de la máquina.

181Promodate.UTC.enabledtruePropiedad que indica si están habilitadas las conversiones de fecha al formato UTC en las interfaces de exportación.
182PromoengineLog.FileDirectoryEngine Log: Directorio donde estarán los archivos. C:\user\mxxxdxxxx\Desktop\ftp
183PromotestEngineADDRlocalhost. Simulación:Direccion del motor de simulación
184Promomicrosoft.crm.clientIdClientId de Microsoft Dynamics CRMIde del cliente de Microsoft Dynamics CRM
185Promomicrosoft.crm.clientSecretClient Secret de Microsoft Dynamics CRMClient Secret de Microsoft Dynamics CRM
186Promomicrosoft.crm.coupon.batch.size1000Cantidad de Cupones a enviar por lote a Microsoft Dynamics CRM (Máximo 1000)
187Promomicrosoft.crm.coupon.endpoint/api/data/VxxxEndpoint de cupones de Microsoft Dynamics CRM
188Promomicrosoft.crm.coupon.url.batc.create
configurationData.Microsoft.crm.coupon.url.batch.create.promo.exportation.label
189Promomicrosoft.crm.coupon.url.post
Url del payload del mensaje post de exportaciòn de cupones de Microsoft Dynamics CRM (se envìa dentro del mensaje (web api)).
190Promomicrosoft.crm.enabledfalseHabilita la funcionalidad de exportación a Microsoft Dynamics CRM
191Promomicrosoft.crm.hosthttps://te-xza-pepe.comUrl de host de Microsoft Dynamics CRM
192Promomicrosoft.crm.tentantId
TenantId de Microsoft Dynamics CRM
193Promomicrosoft.crm.urlAuthhttps://login.microsoftonline.com/



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 importa a, por ejemplo, una nueva consola, deberán guardarse en el directorio C:\synthesis\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.



Nota

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.




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.


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


            • Código: identificador interno del motivo de modificación de saldo, alfanumérico, largo 3 posiciones.
            • Nombre: Nombre del motivo de modificación de saldo,  alfanumérico, largo 10 posiciones.
            • Descripción: datos adicionales, opcional.
            • Activo: Check desde el que se podrá indicar si el motivo a dar de alta se encontrara activo o inactivo.



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 sera requerido el ingreso de los siguientes datos para identificar correctamente la modificación de saldo desde la consola de Promo:


            • Tienda: Tienda desde la que se realiza la modificación de saldo. Se presentara en un combo las tiendas presentes en la consola de Promo.
            • Terminal: Terminal desde la que se realiza la modificación de saldo. campo Numérico
            • Transacción: Nro de transacción a la que se le asocia la modificación de saldo
            • Motivo Se presentara el combo con los motivos de modificación de saldo dados de alta previamente.
            • Monto:  Valor que se sumara o restara a la tarjeta, campo Numérico  (el valor resultante nunca podrá ser menor a cero)


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

                                                Asimismo, si el módulo seleccionado es Promociones, se deberá indicar el código de la promo., por un tipo de usuario, dependiendo el módulo y la operación o acción 

                                                realizada.

                                             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

También se agregaron los botones:

  • Excel: permite extraer la informacion que aparece en pantalla, en la vista Registros de Auditoria, en formato .xls, 

    de nombre Auditoria.xls, donde se informarán los siguientes datos:

  • Fecha
  • Rol
  • Usuario
  • Módulo
  • Código
  • Acción

                                           


  • Exportación Masiva: permite extraer información de todos los Registros de Auditoria que existen.

Desde esta sección 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 informeción:


                                             Cabecera: Indica los siguientes datos:

                                                                                                           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 realizados en una fecha específica.

                                                    

                                             Anterior: Detalles del dato antes de la acción. 

                                             Actual: Detalles del dato luego de ejecutarse acción.

                                       

                                           


                                           

Información

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 mostará dentro del detalle  en "Pasos".


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: 

          • “Código”: es requerido, alfanumérico de 200 caracteres.
          • “Nombre”: es requerido, alfanumérico de 200 caracteres.
          • “Descripción”: no es requerido, alfanumérico de 500 caracteres.
          • “Tipo de dato”: es requerido, combo seleccionable, muestra las opciones: Número con decimales, Número entero, Autocompletado por catálogo, Alfanumérico y Verdadero/Falso.


          • Clase de beneficio”: es requerido, combo seleccionable.
          • Es requerido”: check box, para indicar si esa propiedad es mandatoria o no.
          • “Activa”: check box, para indicar si esa propiedad se encuentra activa o no.


Editar Propiedad de Beneficio:

Detalle de los campos: 

          • “Código”: este campo estará grisado y no se podrá modificar.
          • “Nombre”: será editable y es un campo requerido.
          • “Descripción”: será editable, no es requerido.
          • “Tipo de dato”: se podrá seleccionar de un combo, es requerido, mostrara las opciones Número con decimales, Número entero, Autocompletado por catálogo, Alfanumérico y Verdadero/Falso.
          • Clase de beneficio”: este campo estará grisado y no se podrá modificar, es requerido.
          • Es requerido”: es un ckeck, se puede activar o desactivar.
          • “Activo”: Las propiedades de los beneficios no podrán eliminarse. Se pueden activar o desactivar con este check.


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



Importante

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.


IMPORTANTE

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" dento del menú Administracion.


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 podran ser editados.


Nuevo Atributo:

Cuando se desee dar de alta un nuevo atributo para alguno de los elementos de Promo, debera darse hacerse clic en el boton "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.


            • Alta manual

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.


            • Alta vía Job > "Importación de Catálogos" (sts.console.job.CatalogJob)


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.


Importante

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 distribuida el archivo entities.xml a todos los motores conectados a la consola desde la que se hace la distribución.


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 condicion el "Codigo - SKU" se requerira el ingrese de el o los atributo asociados asi omo tambien se validara que el o los atributos asociados esten definidos en la estructura del "Codigo-SKU". Para que Promo realice esta validación deben realizarse las siguientes configuraciones:

            • Desde Administración \ Información de Configuración, buscar la palabra clave "attribute", a la clave: "attribute.relationship.validation.required" asignarle valor "true".
            • Desde Administración \ Atributos de elementos, crear el o los atributos que desean realacionarse con el elemento "Codigo-SKU".
            • Desde Administración \ Atributos de elementos, buscar el atributo "Codigo-SKU", seleccionar el botón Editar sobre la compañía que corresponda y en el campo "Valida contra Atributo" seleccionar el atributo o los atributos contra los que se desea validar el "Codigo-SKU"


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 "Codigo - SKU", se mostrará la siguiente pantalla:

            • Al momento de dar de alta una condición simple o por composición, por medio del elemento "Producto", se validara que el sku ingresado tenga definido en su estructura el o los atributos relacionados a éste. No dandose por completa la promocion hasta que no se hayan definido el o los atributos relacionados.

              En caso de que los datos ingresados en el o los atributo relacionados no se correspondan con el "Codigo-SKU" ingresado, se mostrara el mensaje "El valor "levelX" ingresado no se corresponde con lo definido en "levelY"" donde LevelX y LevelY son los atributos definidos para la validación interna. Es decir que LevelX debe existir dentro de la definición del item que se definió en el atributo LevelY.

            • Nota: Deberá seleccionarse la linea de definición del Código (SKU) y Agregar luego la condición del atributo relacionado para que se realice correctamente la validación del conjunto.



IMPORTANTE

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:

              • Código: Podrá filtrarse por el código del tipo de promociones.
              • Nombre: Podrá filtrarse por el Nombre del tipo de promociones.
              • Estado: Podrá filtrarse por el estado del tipo de promociones Activo/Inactivos

Las columnas que se presentarán en la pantalla serán:

              • Código
              • Nombre
              • Descripción
              • Valor por defecto
              • Estado

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:

              • Código: Código único de identificación del tipo de promociones. 
              • Nombre: Nombre único de identificación del tipo de promociones.
              • Descripción: Detalles u observaciones del tipo de promociones.
              • Por defecto: Si se activa este check se estará indicando que éste sera el tipo de promoción asignado automáticamente al momento de dar de alta una promoción.
              • Activo: Se indicará si el tipo de promociones estará activo o no para ser asociado a una promoción.




NOTA

Siempre existirán un solo tipo de promoción por defecto, este sera "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á:

              • Editar un tipo de promociones. Al cliquear en Editar, se mostrará la pantalla de "Editar Tipo de promociones",  donde se podrá modificar el nombre, descripción y estado de un tipo de promoción. Podrá editarse un tipo de promoción, siempre y cuando ésta no esté asociado a una promoción distribuida. El campo código no podrá editarse. 
              • Ver Promociones Asociadas al tipo de promociones seleccionado.  De seleccionarlo se redireccionará la pantalla a la la sección de Informes >> "Promociones/Mapas" >> "promociones".  Allí se mostrarán las promociones asociadas al tipo de promoción seleccionado, sin discriminar por sub-Tipo de promoción, los filtros no podrán editarse. Podrá descargarse el informe a un Excel.

Si el Tipo de Promoción no está asociado a ninguna promoción, la opción de "Promociones Asociadas" del menú <Acciones> se mostrará grisado.



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:

              • Código: Podrá filtrarse por el código del sub-tipo de promociones.
              • Nombre: Podrá filtrarse por el Nombre del sub-tipo de promociones.
              • Tipo de Promoción: Podrá filtrarse entre los tipos de promociones activos, estén o no asociados a un sub-Tipo de promoción.
              • Estado: Podrá filtrarse por el estado del sub-tipo de promociones Activo/Inactivos.

Las columnas que se presentarán en la pantalla serán:

              • Código
              • Nombre
              • Tipo de Promoción
              • Estado

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:

              • Código: Código único de identificación del sub-tipo de promociones
              • Nombre: Nombre único de identificación del sub-tipo de promociones
              • Descripción: Detalles u observaciones del sub-tipo de promociones.
              • Tipo de promoción: Podrá indicarse por medio de un combo a que Tipo de Promoción estará asociado el sub-tipo de promoción que se está dando de alta.
              • Valor por defecto: Si se activa este check se estará indicando que si el usuario no selecciona el sub-tipo de promoción al crear la promoción, por default se mostrará esta opción.
              • Activo: Se indicará si el sub-tipo de promoción estará activo o no para ser asociado a una promoción.



NOTA

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

              • Editar un Sub-Tipo de promoción: Al cliquear en Editar, se mostrará la pantalla de "Editar Sub-Tipo de promociones",  donde se podrá modificar el nombre, descripción y estado de un Sub-tipo de promoción. Podrá editarse un Sub-tipo de promoción, siempre y cuando ésta no este asociado a una promoción distribuida. El campo código no podrá editarse. 
              • Desactivar un Sub-Tipo de promoción: Los Sub-Tipos de promociones inactivos no estarán disponibles para ser asociados en promociones.
              • Ver Promociones Asociadas al sub-tipo de promociones seleccionado. De seleccionarlo se redireccionará la pantalla a la sección de Informes >> "Promociones/Mapas" >> "promociones". Allí se mostrarán las promociones asociadas al Sub-tipo de promoción seleccionado, sin discriminar por Tipo de promoción, los filtros no podrán editarse. Podrá descargarse el informe a un Excel.

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á grisado.



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:

              • Código: Podrá filtrarse por el código de la forma de aplicación de promociones.
              • Nombre: Podrá filtrarse por el Nombre de la forma de aplicación de promociones.
              • Tipo de Promoción: Podrá filtrarse entre los tipos de promociones activos, estén o no asociados a un sub-Tipo de promoción.
              • Sub-Tipo de Promoción: Podrá filtrarse entre los sub-tipos de promociones activos que pertenezcan al Tipo de Promoción seleccionado en el combo anterior.
              • Estado: Podrá filtrarse por el estado de la forma de aplicación de promociones Activo/Inactivos.

Las columnas que se presentarán en la pantalla serán:

              • Código
              • Nombre
              • Tipo de Promoción
              • Sub-Tipo de Promoción
              • Estado

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:

              • Código: Código único de identificación la forma de aplicación de promociones
              • Nombre: Nombre único de identificación de la forma de aplicación de promociones
              • Descripción: Detalles u observaciones de la forma de aplicación de promociones.
              • Tipo de promoción: Podrá indicarse por medio de un combo a que Tipo de Promoción estará asociado la forma de aplicación de promoción que se esta dando de alta.
              • Sub-Tipo de promoción: Si se activa este check se estará indicando que éste sera la forma de aplicación de la promoción asignado automáticamente al momento de dar de alta una promoción, el cual dependerá del Sub-tipo de promoción por defecto seleccionado
              • Por defecto: Si se activa este check se estará indicando que si el usuario no selecciona la Forma de Aplicación de la promoción al crear la promoción, por default se mostrará esta opción.
              • Activo: Se indicara si  la forma de aplicación de promoción estará activo o no para ser asociado a una promoción.





NOTA

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

              • Editar una forma de aplicación de promoción: Al cliquear en Editar, se mostrara la pantalla de "Editar forma de aplicación de promociones",  donde se podrá modificar el nombre, descripción y estado de una forma de aplicación de promoción. Podrá editarse una forma de aplicación de promoción, siempre y cuando ésta no este asociado a una promoción, en caso de intentar desactivarse se mostrara un mensaje de error informando que no es posible deshabilitar. El campo código no podrá editarse. 
              • Desactivar una forma de aplicación de promoción: Las formas de aplicación de promociones inactivos no estarán disponibles para ser asociados en promociones.
              • Ver Promociones Asociadas a la forma de aplicación de promociones seleccionado. De seleccionarlo se redireccionará la pantalla a la la sección de Informes >> "Promociones/Mapas" >> "promociones". Allí se mostraran las promociones asociadas a la forma de aplicación de promoción seleccionado, sin discriminar por Tipo o Sub-Tipo de promoción, los filtros no podrán editarse. Podrá descargarse el informe a un Excel.

Si la forma de aplicación de Promoción no esta asociada a ninguna promoción, la opción de "Promociones Asociadas" del menú <Acciones> se mostrará grisada.


Plantillas de Mapas

Se disponibilizará 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:

            • Los mapas serán distribuidos automáticamente solo a las tiendas que tengan al menos un motor asociado y la distribución configurada sea AUTO.

            • En el armado automático de mapas solo se tomaran en consideración las promociones en estado "COMPLETAS".
            • Para el proceso se tomara la ultima plantilla de mapas editada en estado completa y activa.


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.
            1. Luego, el proceso buscara la ultima plantilla de mapas editada en estado COMPLETA.
            2. 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.
            3. Una vez que se tienen los mapas completos para cada una de las tiendas se procede a la distribución de los .xml.


NOTA

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


IMPORTANTE

Los atributos del elemento "Transacción" considerados para el armado de un mapa serán los standars (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:

          • Código: campo alfanumérico, deberá indicarse el código único que identificara al grupo de atributos que se esta dando de alta.
          • Nombre: campo alfanumérico, deberá indicarse el nombre único que identificara al grupo de atributos que se esta dando de alta.
          • Elemento: Deberá indicarse del combo uno de los elementos por los que se define una condición.



            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:

              • Código: Podrá buscarse grupos de prefijos por su código. 
              • Nombre: Podrá buscarse grupos de prefijos por su nombre. 
              • Nro. de prefijos: podrá buscarse e base a un rango de prefijo, que grupos lo contienen.
              • Estado: podrá filtrarse entre grupos de prefijos activos o no activos.

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:

              • Código: Será el código identificador del grupo de prefijos que se está dando de alta. El código será alfanumérico (Promo Bridge, Numérico) de ingreso manual y deberá validarse que el código no haya sido dado de alta previamente.
              • Nombre: Será el nombre que represente el grupo de prefijos que se está dando de alta. El nombre será alfanumérico.
              • Descripción: Podrá ingresarse algún detalle o información adicional del grupo de prefijos que se está creando.
              • Botón "Agregar Prefijos": En el popUp que se despliega podrán definirse de manera manual rangos de prefijos que formarán parte del grupo de prefijos que se está dando de alta. Se deberá validar que el número ingresado para identificar a un prefijo no sea menor que 6 posiciones ni mayor que 9 posiciones. (Limitaciones por configuración).




            • Botón "Seleccionar Archivo": Los grupos de prefijos podrán darse de alta de manera masiva importando un archivo que contenga dicha definición. Cuando se importe un archivo que contenga rangos de prefijos, los datos anteriores se pisarán con los nuevos rangos de prefijos importados. Los rangos de prefijos podrán editarse manualmente luego de importados (quitar rango de prefijo importados o sumar nuevos). En caso de que la cantidad de datos importados supere el máximo permitido para la edición manual, se mostrará el mensaje de que en caso de haber algún error en la carga deberá recargarse el archivo con las correcciones pertinentes. Los formatos posibles para importar archivo serán excel (.xlsx), donde los rangos de prefijos se encontrarán definidos uno debajo del otro, y los prefijos separados por un guion ( - ); y texto (.txt), donde los rangos de prefijos se separarán por comas ( , ) y los prefijos serán separados por un guión ( - ). Se deberá también validar el largo de los prefijos cuando éstos se suban por archivo.

            • Activo: Indicará si el grupo de prefijos que se está dando de alta se encontrará activo o no. Por default, los grupos de prefijos se darán de alta "Activos".


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. 


Nota:

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.





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:

                • Nombre de Usuario: será el usuario de login para acceder a la consola.
                • Password: Será la contraseña que deberá de ingresarse para acceder a la consola. Deberá ingresarse una contraseña entre 6 y 16 caracteres de longitud, y que contenga al menos una letra minúscula, una mayúscula y un número.
                • Confirmar password: repetir contraseña ingresada en el paso anterior.
                • Nombre y Apellido: Se deberá indicar nombre y apellido real del usuario que se esta dando de alta.
                • Correo Electrónico: Se podrá ingresar un mail valido para el usuario que se esta dando de alta.
                • Expira Contraseña: aquí podrá indicarse si la contraseña vence luego de un determinado período de tiempo, configurable, contabilizado desde la primera vez que accedió a la consola.
                • ¿Bloquea sin actividad? : Indica si el usuario se bloquea luego de un determinado periodo de tiempo configurable, y luego deberá volver a loguearse.
                • ¿Debe cambiar clave?: Indica si el usuario debe cambiar la clave al primer ingreso a la consola.
                • Habilitado: deberá de tildarse para que el usuario que se esta creando pueda acceder en la consola de PROMO.
                • Deshabilitar a partir del: se podrá indicar aquí a partir de que fecha el usuario no podrá acceder mas a la consola de PROMO.
                • Roles disponibles: Podrán asignarse uno de los siguientes roles disponibles:
                • Administrador: tiene accesos y permisos para todos los módulos de la consola adquiridos.
                • Operador: podrá visualizar promociones, mapas, cupones. (deberán de habilitarse los accesos de creación edición y definición de promociones y beneficios para que el perfil operador pueda realizar estas acciones - Contactar al administrador.)
                • Administrador de  negocios: podrá acceder al módulo de negocios e informes.
                • TicketSender: usuario exclusivo de comunicación Motor <> Consola de PROMO.
                • Asociación a Workflows: Podrán asignarse los Workflows a los cuales tendrá acceso el usuario.
                • Tiendas disponibles:A la izquierda mostrará las tiendas disponibles y a la derecha se reflejarán las tiendas que el usuario al que se está dando de alta o editando tendrá asociadas. El usuario administrador (que está creando o modificando) podrá asignar o desasignar tiendas, que se verán a la derecha.

                   

                                                                                          

                                                                                 



NOTA

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



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.


IMPORTANTE

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.


Nota

ABM de Atributos de Elementos:  Solo el usuario principal puede asignar los accesos de atributos de elementos a algún rol.


Tener en cuenta

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:

1Módulo (categoría)Ítem (Sub categoría)Sub ítemQué habilita?Activo en Roles por default
2Dashboard (se encuentra en la categoría Administración)Promociones
Permite ver el Dashboard de PromocionesAdministrador
Permite modificar el Dashboard de PromocionesAdministrador
Ventas
Permite ver el Dashboard de VentasAdministrador
Permite modificar el Dashboard de VentasAdministrador
Cupones
Permite ver el Dashboard de CuponesAdministrador
Permite modificar el Dashboard de CuponesAdministrador
Elementos
Permite ver el Dashboard de Elementos de FidelidadAdministrador
Permite modificar el Dashboard de Elementos de FidelidadAdministrador
Creados x usuario
Permite ver los Dashboards creados por el usuarioAdministrador
Permite modificar los Dashboards creados por el usuarioAdministrador
3OperaciónCampañas
Visualiza menú Operación > Campañas y utilización de filtros de búsquedaAdministrador, Operador
Permite crear nueva campañaAdministrador
Permite editar una 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 condiciones generalesAdministrador
Permite 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 editar plantillas de promocionesAdministrador
Permite crear plantillas de promocionesAdministrador
Permite cancelar plantillas de promocionesAdministrador
Permite generar excel de las plantillas de promocionesAdministrador, Operador
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
4WorkflowWorkflow
Permite ver el listado de workflowsAdministrador, Operador
Permite crear un nuevo workflow,  agregar y eliminar pasosAdministrador
Permite editar un workflowAdministrador
5Distribució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
6PreciosListas de precios
Visualiza listado de listas de precios, detalles e Historial de WF. Habilita las búsquedasAdministrador, Operador
Permite Crear listas de precios Generadas y Derivadas; editarlas, distribuirlas, descargar distribución, cancelar listasAdministrador
Listas de precios para aprobar
Permite ver el listado de listas de precios pendientes de aprobación, permite ver el Historial del WF y aprobar o rechazar la lista.Administrador
Plantillas de etiquetas
Habilita la creación, edición y búsqueda de plantillas de etiquetasAdministrador
Impresión de etiquetas pendientes
Permite generar y seleccionar etiquetas para imprimir, realizar las buquedas y ver detalle de impresiones realizadasAdministrador, Operador
Impresión de etiquetas a demanda
Permite generar y seleccionar etiquetas para imprimir, realizar las buquedas y ver detalle de impresiones realizadasAdministrador, Operador
7FidelidadPlantillas 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 cupones
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 elementos de fidelidad, realizar las búsquedas y ver el resumenAdministrador, Operador
Habilita la creación, edición y copia de tipos de elementos de fidelidadAdministrador
Habilita la creación, edición y copia de tipos de elementos de fidelidad
Elementos de fidelidad
Permite realizar búsquedas de elementos de fidelidadAdministrador, Operador
Permite dar de alta de forma masiva elementos de fidelidad y ver el informe con los resultados o el detalle de errores y permite cancelarAdministrador
Permite modificar y transferir saldo de elementos de fidelidad
Permite activar elementos de fidelidadAdministrador
Ver movimientos de elementos de fidelidadAdministrador, 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

Eliminar datos del cliente (a partir de versión 7.0.18)

Administrador, Operador


Administrador

8InformesPromociones/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 en ReversosHabilita el Informe Errores en ReversosAdministrador, 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
CuponesTipos de Cupones
Administrador, Administrador de Negocio, Operador
Cupones
Administrador, Administrador de Negocio
Cupones Vencidos
Administrador, Administrador de Negocio
Extracto de CuponesHabilita Informe > Cupones > Extracto de cuponesAdministrador, Administrador de Negocio
ElementosTipos de Elementos de Fidelidad
Administrador, Administrador de Negocio, Operador
Elementos de Fidelidad
Administrador, Administrador de Negocio
Puntos/ Montos Vencidos
Administrador, 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
Reportes programados
Habilita Informe > Reportes programadosAdministrador, Administrador de Negocio, Prinicipal
Lista de preciosLista de Precios ActivasHabilita Informe > Lista de precios >Lista de precios activasAdministrador, Administrador de Negocio, Operador
Lista de Precios por ProductoHabilita Informe > Lista de precios >Lista de precios por productoAdministrador, Administrador de Negocio, Operador
Evolución de PreciosHabilita Informe > Lista de precios > Evolución de preciosAdministrador, Administrador de Negocio
Recupero de ProveedoresHabilita Informe > Lista de precios > Recupero de proveedoresAdministrador, Administrador de Negocio
Monitor de Exportación (a partir de v7.0.3)
Visualización/ Creación de Exportación de InformesAdministrador
9NegocioTiendas
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
CompetidoresCompetidoresHabilita ver el listado de Competidores, realizar búsquedas, crear, editar y definir competidoresAdministrador, Administrador de Negocio
Publicaciones de PreciosHabilita la creación, edición y búsqueda de Publicaciones de PreciosAdministrador, Administrador de Negocio
Segmentos
Visualización de segmentosAdministrador, Administrador de Negocio
Permite crear segmentos y realizar búsquedasAdministrador, Administrador de Negocio
Permite editar y definir segmentos y realizar búsquedasAdministrador, Administrador de Negocio
Compañías
Permite crear, editar, definir, activar, desactivar y buscar compañíasPrincipal
10AdministraciónTareas Programadas
Ejecución manual, detención y planificación de tareas programadasPrincipal
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
11SeguridadAdministració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.Principal
Listar y configurar accesos.Administrador (si hay 1 sola compañía*), Principal
12AlarmasConfiguració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
13SoporteInicializar configuraciones
Permite inicializar las configuraciones de la consola y de los permisosPrincipal
Gestor de backups de BBDD
Permite generar y restaurar backupsPrincipal, Administrador
Estado del motor
Permite ver el estado en que se encuentran los motores configurados, realizar búsquedas y descargar un ExcelAdministrador
Log de la consola
Permite ver el listado de los logs de la consola, 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
14OtrosMonitor de exportación
Habilita la visualización del listado con el estado de las distintas exportaciones y reprocesar registrosAdministrador


Aclaración

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

También se podrán configurar alarmas, relativas al Módulo de precios, que permitirán  dar avisos a los usuarios, de las tareas que tienen pendientes, en relación a las listas de precios:

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.

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

Alarma Modificación en % de Beneficios

En esta versión se agrega el tipo de Alarma, Modificación en % de Beneficios,al crear una nueva alarma y seleccionar este tipo de beneficio:



Se podrá seleccionar el Tipo de beneficio aplicará la alarma que se está generando:


  • Monetario
  • No monetario


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:

  • Descuento por convenio
  • Descuento porcentaje

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:

  • Cupón calculado/Porcentaje
  • Porcentaje fidelización

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:

También podrá agregarse una descripción, establecer la prioridad de la alarma y si requiere o no confirmación.

Por último, deberá indicarse el Tipo de Notificación, Roles y Usuarios en caso que la notificación sea por mail y si la alarma se encuentra Activa.


En la pantalla "Configuración de Alarmas" el combo de "Tipo de Alarmas", deberá mostrar la alarma "Modificación en % de beneficios"

>> 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:  Alertará sobre la cantidad de transacciones que otorgan puntos, en un período determinado.

Alarma: Transacciones que otorgan puntos por período

Para evitar fraudes, en esta versión se agrega la alarma Transacciones que otorgan puntos por períodos, la cual 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.

Importante

Este tipo de alarmas no aplica a transacciones que acumulen puntos de fidelidad con tarjetas externas.

Importante

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.

Nota

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 transaccion que involucre al cliente y le otorgue puntos.



Nota Promociones Distribuidas por Tiendas

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:

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


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

  • Nombre de la alarma que se está informando
  • Descripción dada al momento de dar de alta la alarma
  • Resumen de la promoción que activa la alarma
  • Link a la página de "Promociones a aprobar" (Una vez que se recibe el mail podrá darse click en el link para acceder a la sección "Promociones para aprobar")


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.




          • Tipos de Alarmas (relativas a Listas de Precios)

Podrán filtrarse aquí entre las siguientes opciones de alarmas a configurar:

>> Impresiones de precios pendientes:

Evalúa si existen productos que hayan cambiado de precio por interface rest. En caso de existir alguno en esta situación, se disparará la notificación correspondiente.

>> Distribuciones de Listas de precios pendientes:

Evalúa que existan Listas de Precios del tipo Generadas o Derivadas (no del tipo Cero) aprobadas y completas, que aun no se hayan distribuido a la/las tiendas correspondientes. En caso de existir alguna que cumpla con esas condiciones, se disparará la notificación correspondiente.

>> Listas de precios próximas a expirar:

Una vez al día el sistema evaluará si existen Listas de Precios del tipo Generadas o Derivadas (no del tipo Cero), y que esté en estado Completa, que finalicen su vigencia en el día de la fecha. En caso de existir alguna que cumpla con esa condición, se disparará la notificación correspondiente.

>> Listas de precios próximas a estar vigentes:

Evalúa que existan  Listas de Precios del tipo Generadas o Derivadas (no del tipo Cero)  que estén completas, que entran en vigencia en el día de la fecha. En caso de existir alguna que cumpla con esa condición, se disparará la notificación correspondiente.

>> Listas de precios a redistribuir luego de su modificación:

Evalúa si existe alguna lista de precios del tipo Generada o Derivada (no del tipo Cero) que fue modificada, está en estado Completa y tiene que ser distribuida, se disparará la notificación correspondiente.

>>Lista de precio base importada que tuvo fallos:

Evalúa si ocurrieron errores en la interface de actualización de precios de la Lista 0. En caso de existir esta situación, se disparara la notificación correspondiente.


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.



NOTA

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ñia 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).


Estado: Podrá filtrarse entre Alarmas que estén activas y las que  estén inactivas.



NOTA

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. Solo en las alarmas que estén inactivas se mostrará la opción editar.

Al presionar en "Detalle" se mostrará el siguiente mensaje:


En caso de desear 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 reactivar una Alarma se requerirá confirmación por medio del siguiente PopUp:

                           

                           

              • Alarma Movimientos en LímitesA partir de esta versión se agrega esta nueva alarma que permitirá  visualizar las unidades o montos ($) utilizados en las promociones donde se definieron limites, con la finalidad de llevar trazabilidad de los beneficios otorgados.

                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.

                Ej:

                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 y Activa)

                                                             

                                                            

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:

                • Nombre: Campo requerido, deberá indicarse un nombre para la nueva alarma que se está definiendo. (campo alfanumérico). 
                • Tipo de alarma: Deberá seleccionarse alguno de los tipos de alarmas propuestas por Promo. Dependiendo del tipo de alarma que se esté generando, se propondrán los campos:

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

                • Descripción: Campo opcional, podrá ingresarse algún dato adicional de la alarma que se está definiendo.
                • Prioridad: Deberá indicarse si la alarma que se está definiendo tiene prioridad Alta, Media o Baja. 
                • Requiere confirmación: podrá indicarse si la alarma que se está definiendo requiere o no confirmación de un usuario. Por default siempre se requerirá confirmación.
                • Tipo de notificación: Deberá seleccionarse si la notificación que se generará cuando se cumpla con las condiciones de la alarma, solo será registrada en la consola o si también se enviará un mail a los usuarios involucrados para informar de dicho acontecimiento.
                • Roles: Se pueden seleccionar los roles que recibirán la alarma.
                • Usuarios: Se pueden seleccionar los usuarios que recibirán la alarma.
                • Activa: indicará si la alarma que se está creando estará activa o no.



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:

              • Fecha desde y Fecha hasta: podrá filtrarse por las notificaciones surgidas en un determinado rango de fechas.
              • Tipos de alarmas: Podrá indicarse cuáles de los tipos de alarmas presentes en Promo desea filtrarse.
              • Prioridad de Alarma: Podrá indicarse si se desea filtrar por las notificaciones de prioridad Alta, media, o Baja.
              • Confirmación: Podrá filtrarse entre las notificaciones, confirmadas, no confirmadas o que no quieren notificación.
              • Descripción: podrá filtrarse por el detalle definido en cada alarma.




IMPORTANTE

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





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

IMPORTANTE

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.

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.00hs.

Para poder llevar a cabo ésta tarea; tanto con usuario administrador (siempre que exista sólo una empresa; si hay más de una empresa, el admin tiene que asociar ese permiso al rol que corresponda), como con el Súper Usuario, primeramente se deben configurar en Administracion, Información de Configuración,la dirección donde se encuentran almacenados los backups y la dirección donde se encuentra almacenada la aplicación que ejecutará la importación.

Desde la siguiente ventana podrán restaurarse los backups generados en caso de ser necesario.

IMPORTANTE

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.

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 correpondiente se obtendrá el archivo .zip. con los logs indicados.

                 

Importante

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.

 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 de registros de la interfaz de recepción de precios de las Listas 0 (que requieren actualización en la tienda correspondiente) así como también 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.


Desde cada registro de importación, en el botón “Acciones/Contenido”, se podrá visualizar el contenido del request del servicio:


Desde la opción “Acciones/Detalle”, se podrá ver el detalle del resultado del proceso de cada elemento del request:


Si algún elemento del request, se encuentra CON ERROR, y alguno se encuentra OK, el resultado del archivo aparecerá como “PARCIAL”, y si todos se procesaron con error, el resultad del archivo será “ERROR”:


Para ver el resultado, se debera hacer click en "Accciones > Detalle":


Y se  mostrara la siguiente pantalla, donde indica el registro donde se produjo el error, y cual fue el error producido:


Los registros que se deban volver a procesar, podrán reprocesarse desde el botón Acciones > Reprocesar, o seleccionando el checkbox a la izquierda del ítem, y haciendo click en el botón "Reprocesar seleccionados"

                              

                              

Importante

Al realizar una importación de catalogo vía colas rabbitmq si el mensaje a importar está vacío, cuando se ejecuta el job correspondiente, en la vista Soporte, Monitor de importación el campo Tipo tendrá el valor "Tipo invalido".       

                             

                             

                             Al presionar Acciones, Detalle se visualiza el contenido sin traducción

                            

Configuración de Motores

Importante

IMPORTANTE

La Configuración de Motores se realiza ingresando a la consola de PROMO PRINCIPAL con el Usuario Principal.

Desde allí podrán configurarse todas las configuraciones necesarias de los distintos motores que interacturan con la consola.


Muestra un listado de las opciones que pueden ser cambiadas en masa y se encuentran en el archivo config.xml.

Al ingresar mostrará una pantalla como la siguiente:

Si despliega el combo para seleccionar mostrará las siguientes opciones:


Si al realizar un cambio se ingresa un valor que no corresponde, mostrará un cartel rojo indicando el campo del error:

image2021-5-3_12-26-40.png

Una vez realizado algún cambio y presionado el botón Guardar, mostrará un cartel verde indicando la cantidad de parámetros modificados exitosamente. El sistema va a postear sólo los cambios realizados (no va a volver a mandar toda la información) y los deja listos para que el motor los levante. 

image2021-5-3_12-32-17.png

En el log de la consola se guardará por ejemplo que se generó una notificación para un motor para estas 3 propiedades. (No se mandan alarmas). 

Hasta que se mande al motor se van acumulando los cambios realizados. Luego aplica los cambios en el orden realizado.

IMPORTANTE

Hay que ir guardando cada página donde se hacen cambios.

Al utilizar esta funcionalidad (o sea al realizar un cambio desde esta pantalla y guardarlo) se crea automáticamente un nuevo archivo: config.properties que se guarda en la misma ruta donde está el config.xml del motor.

Este nuevo archivo es autogenerado por Promo y pisa las propiedades del config.xml, o sea sobreescribe lo indicado en el config.xml. Entonces por ejemplo si el motor quiere saber a cuántos decimales tiene que redondear, primero levanta el config.xml y luego lee el config.properties y si ahí tiene otra configuración toma esta última. No es requerido reiniciar el o los motores para que los cambios sean tomados. 





 Apéndice I

Preguntas frecuentes


https://share.linx.com.br/pages/viewpage.action?pageId=262805281#PROMO-ManualdeUsuario7-Ap%C3%A9ndices-Espa%C3%B1ol-_Toc103590049_Toc471373811_Toc513717135Preguntasfrecuentes


 Apéndice II

Sugerencias de Promociones


PROMO - Manual de Usuario 7 - Apéndices - Español#ManualdeUsuario7-Ap%C3%A9ndices-Espa%C3%B1ol-_Sugerencias_Ref232232521_Ref232232529_Ref232232711_Ref232232714_Ref232232778_Ref232232785_Ref232232823_Ref232232825_Ref232232853_Ref232232855_Ref232232886_Ref232232888_Toc471373814_Sugerencias_de_Promociones_Toc51


 Apéndice III

Promociones por medio de pago


PROMO - Manual de Usuario 7 - Apéndices - Español#ManualdeUsuario7-Ap%C3%A9ndices-Espa%C3%B1ol-_Ref240274964_Ref240274970_Toc471373713_Toc513717142Promocionespormediodepago


 Apéndice IV

 Consideraciones - Módulo de Fidelidad

                       PROMO - Manual de Usuario 7 - Apéndices - Español#ManualdeUsuario7-Ap%C3%A9ndices-Espa%C3%B1ol-_Toc513717146Consideraciones-ModulodeFidelidad


 Apéndice V

Configuración de Chequeo de Colisiones

                        PROMO - Manual de Usuario 7 - Apéndices - Español#ManualdeUsuario7-Ap%C3%A9ndices-Espa%C3%B1ol-_Configuraci%C3%B3n_de_Chequeo_Toc513717151Configuraci%C3%B3ndeChequeodeColisiones


 Apéndice VI

Consideraciones - Alta Masiva de Promociones

PROMO - Manual de Usuario 7 - Apéndices - Español#ManualdeUsuario7-Ap%C3%A9ndices-Espa%C3%B1ol-Consideraciones-AltaMasivadePromociones

Apéndice VII

Promociones Modelo

                       PROMO - Manual de Usuario 7 - Apéndices - Español#ManualdeUsuario7-Ap%C3%A9ndices-Espa%C3%B1ol-_Toc471373810_Toc513717134Ap%C3%A9ndiceVII-PromocionesModelo

Apéndice VIII

Caché de Promociones

                       PROMO - Manual de Usuario 7 - Apéndices - Español#ManualdeUsuario7-Ap%C3%A9ndices-Espa%C3%B1ol-Ap%C3%A9ndiceVIII-CachedePromociones

                                                                                                                                

  • Apéndice IX

    Alarma de Límites

          PROMO - Manual de Usuario 7 - Apéndices - Español#Ap%C3%A9ndiceIX-AlarmaMovimientosenL%C3%ADmites




  • Sem rótulos