MANUAL DE USUARIO FINAL


PROMO 7.0




Í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
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 Tarjetas)

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").
    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 Final" - ("MANUAL DE USUARIO FINAL - PROMO v7"). 
    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 tarjetas de fidelidad de manera centralizada gestionando los distintos perfiles de tarjeta, 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 tarjetas.

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 tarjetas 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 tarjetas 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 tarjetas 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 tarjetas de fidelidad, pudiéndose dar de altas distintos perfiles de tarjetas de fidelidad como ser por ejemplo, GiftCard, monederos o tarjetas de punto, 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"


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 Integración Promo 7.0.


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


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.

En la parte inferior de cada pantalla se mostrarán los números de las páginas que se encuentran disponibles para poder navegar entre las mismas.


A partir de Promo 7.0.3 se está cambiando de a poco ese tipo de navegación por la siguiente: 

image2021-6-22_17-3-20.png

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.


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 tarjetas en base a los distintos indicadores predefinidos.



Menú de Dashboard

Desde este Menú se podrán visualizar los KPIs de Ventas,promociones, tarjetas 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.

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 Tarjetas

Se cuenta con los indicadores referentes a tarjetas activas.
Los registros se mostraran en base al rango de fechas seleccionado y los KPIs representaran las tarjetas activadas 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.

Al dar clic en la nueva sección "Condiciones Generales" se pasará a la pantalla "Gestión de Condiciones Generales

Se puede buscar tanto por nombre como por código de la condición general.

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.

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

  • Por Producto:  
    Podrán incluirse o excluirse items, 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 item 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 items 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 Tarjetas de Fidelidad:

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

> Si en la transacción se ingresa una tarjeta 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.


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


A partir de la versión 7.0.15 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 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.


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


  • 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, Tarjetas 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ística 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 Tarjetas 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:


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

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



Sugerencia 

  • Habilita sugerencias: éste casillero se podrá activar en caso de que se quiera sugerir una promoción en especial.
  • Mensaje del POS: En caso de tildarse la opción anterior, deberá ingresarse el mensaje a mostrar en la pantalla del POS cuando se sugiera la promoción.



Imagen asociada

  • Descripción: 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 (a partir de versión 7.0). 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. Los datos mostrados en recuadro rojo los mostrará el sistema a partir de versión 7.0)


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


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


    • Tarjetas de Fidelidad:
        • Id: se utiliza para definir el id o número de la o las tarjetas de fidelidad que se desea integren el conjunto.
        • Tipo: se utiliza para definir el tipo de la o las tarjetas de fidelidad que se desea integren el conjunto.
        • Convenio: se utiliza para definir el convenio al que pertenecerá la tarjeta 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 las tarjetas 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
        • 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 tarjetas 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 tarjeta 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 "Operaciones 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
      • Tarjetas 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 tarjetas 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 "Tarjetas 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 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)
  • 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 Exteno" 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 o las 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 tarjetas 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.

Este beneficio operará con los saldos informados en el cliente siempre que estos sean incluidos en la definicion del beneficio, e informará los saldos consumidos al POS para que éste  informe a quien corresponda.

Asimismo, podrá indicarse si el beneficio a otorgar contempla la existencia de Puntos provenientes de tarjetas de Fidelidad. Al hacerlo, por ejemplo, seleccionando "Descuento por Porcentaje", se presentarán las siguientes opciones.

Los campos "Tipo de Tarjeta de Fidelidad" y "Puntos de Tarjeta 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 Tarjeta de Fidelidad" deberá indicarse el código del tipo de tarjeta de fidelidad a evaluar para acceder al descuento. Mientras que en el campo "Puntos de Tarjeta 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 de la version 7.1 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 la tarjeta 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 "Balance 1" o "Balance 2", según se haya integrado con el pos.


    (Para mas información Ver Manual de Integración Promo 7.0 - 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: (a partir de 7.0.3) 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". (Disponible a partir de Promo V7.0.3)

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

Ejemplo de mensajería donde se visualiza la distribucion del descuento entre los participantes.

Prorrateo entre participantes - INPUT
<?xml version="1.0" encoding="UTF-8"?>
<message companyId="napse" store="1" terminal="1" date-time="2021-03-01 10:35:22" init-tck="true" messageId="1" void-trx="false" response="true" limitBalances="true" status="sales" evaluate="true" map-version="7" tckpath="Y" suggest="true">
<item-add seq="1" qty="1" code="123" level1="1121" magnitude="0" brand="Kumho" xprice="150" unitprice="150" />
<item-add seq="2" qty="1" code="456" level1="1121" magnitude="0" brand="Kumho" xprice="90" unitprice="90" />
<item-add seq="4" qty="1" code="789" level1="1121" magnitude="0" brand="Kumho" xprice="75" unitprice="75" />
</message>


Prorrateo entre participantes - OUTPUT
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<message ack="0" companyId="napse" engine="7.0.0-SNAPSHOT#78" mapversion="7" messageId="1" store="1" terminal="1">
  <optional>
    <promo id="Prorratear entre Participantes" nro="603afe841082e836908173d1">
      <benefit TLOGMessage="Prorratear entre Participantes" account="" applicationMethod="resume" baseAmount="75.0000" benefitType="PercentageDiscount" discountPercentage="100.0000" displayMessage="Prorratear entre Participantes" name="603afe841082e836908173d1" nro="603afed81082e836908173e1" order="1" printerMessage="Prorratear entre Participantes" prorateBCP="true" prorationMethod="PROPORTIONAL" unit="qty">
        <apply>
          <item magnitude="0.000" qty="1.000" seq="1" value="35.71" valueWithTaxes="150.00" xprice="150.00"/>
          <item magnitude="0.000" qty="1.000" seq="2" value="21.43" valueWithTaxes="90.00" xprice="90.00"/>
          <item magnitude="0.000" qty="1.000" seq="4" value="17.86" valueWithTaxes="75.00" xprice="75.00"/>
        </apply>
      </benefit>
    </promo>
  </optional>
</message>



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 (a partir de la versión 7.0.18): 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 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 (finish) Promo devolverá un ACK de error "9101" - El cupón ingresado a la transacción no ha participado de ninguna promoción, 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)



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


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.0) 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 ítem 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 Promo 7.1.x 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 realizados 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á deltildado (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 item 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>
          <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 tarjeta 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:


A partir de Promo 7.0.2 - 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 disponibiliza 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.

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


(A partir de la versión 7.0.18) 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 sera 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 Descripcion del Limite, ésta no tendrá efecto alguno sobre la gestion de los limites, es solamete informativa.

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 nacionalizació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 "Retail", "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 "Retail", "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 "Retail", "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)

A partir de la version 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).


Definición de Escalonadas:

A partir de 7.1 se incorpora en Promo la posibilidad de aplicar descuentos escalonadas.  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 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ándose el escalón agregado 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 "Beneficio General", "Coeficiente de fidelización", "Porcentaje de fidelización", "Puntos de fidelización" y "Regalo".




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

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


  • 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

(a partir de Promo 7.1.4)

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



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.


IMPORTANTTE

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.

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.


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

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



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


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” y “Nombre de promoción” por los que se podrán buscar promociones.

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"



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


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), posee un único paso para la aprobación de una promoción o lista de precios. El universo de aplicación de un workflow o 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 aproar 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 2 checkbox, que indican si el Workflow aplica a promociones, a listas de precios o ambas. Por default, los 2 checkbox 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 workflows 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 mostrara la pantalla con la lista"Workflow" donde podrán 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, asociar el rol correspondiente para su aprobación:


Al hacer click en “Guardar”, mostrara los pasos que componen el WF:



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



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

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



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




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



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


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 la version 7.1 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.
      • 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.
      • Precio total: precio total de los artículos. Surge de multiplicar el precio unitario por la cantidad.
      • Cantidad: cantidad de artículos con el código ingresado que se están "vendiendo".
      • Magnitud: Peso, longitud o volumen del artículo.
      • 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.
      • Subcategoría: Subcategoría del artículo que se están ingresando.
      • Descontable: indica si al artículo ingresado pueden aplicársele descuentos. Default Tildado.
      • 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.

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.



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

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


  • Beneficio Externo: representa los datos relacionados con las tarjetas de fidelidad que puedan ingresarse a la transacción para su evaluación. Presionar en el botón en el botón "Tarjetas 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 retail.

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, Distribuida, Cancelada, En distribución (a partir de v6.4.21)
      • Tipo (Cero, Generada, Derivada)
      • Lista cero base (para las derivadas)
      • Código
      • Nombre
      • Descripción 
      • Tiendas
      • 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, código de tienda (mostrará todas las tiendas habilitadas), 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
      • 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

A partir de la versión 6.4.21:

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



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

A partir de la versión 6.4.21:

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.  


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


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

A partir de la versión 6.4.21:

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 tarjetas 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
              • @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



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 tipo de cupones y serán No Nominados.
          • Informativo: Son cupones que podrán emitirse desde Promo cuando una Promoción lo indique pero no se realizara ningún registro de esta emisión en la base de datos de Promo ni se le asignara ningún código de Barras. 
        • Prefijo Autogenerado: 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".
            • Sin vencimiento: Los cupones generados a partir de un tipo de cupón con este tipo de vencimiento, o vencerán nunca.


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

              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, a 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 y se ocultaran las opciones de "Crear plantillas de promoción".
        • Consumo Total: Cuando se indique que el tipo de cupón será "Calculado" se habilitara la posibilidad de indicar si, para redención del tipo de cupón calculado que se esa 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.
        • 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.


Edicion de Tipo de cupon DISTRIBUIDO (disponible a partir de PROMO 7.0.1)

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 editado. A partir de Promo 7.0.1 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.



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. A partir de la versión 7.0.15 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: Mostrara un rango de 7 días, donde el día que se ejecuta la búsqueda será la fecha tomada para el "Hasta". El "Desde" mostrará la fecha que corresponda a 7 días antes del "Hasta"). A partir de la versión 7.0.15 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 -".

A partir de Promo 7.0.15: 

Debajo de los filtros de búsqueda se mostrarán dos campos para navegar los registros, que por default al ingresar al informe 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 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.

(A partir de Promo 7.0.15) 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.




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.

Ejemplo de Promo que emite un cupón:

Ejemplo de Promo que redime un 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 tarjetas de Fidelidad

En esta sección se podrán generar y administrar los distintos tipos de tarjetas de fidelidad que administre el retailer, a partir de los cuales se podrán crear tarjetas que participarán de las transacciones en los distintos puntos de ventas. 

La gestión de las tarjetas 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 una tarjeta independientemente si participa o no de una promoción.

Al dar clic en Fidelidad >> Tipos de tarjeta de Fidelidad se visualizará la siguiente pantalla donde se encontrarán los distintos tipos de tarjeta ya generados.



Nuevo Tipo de tarjeta de Fidelidad

Para dar de alta un nuevo tipo de tarjeta de fidelidad deberá darse click en "Nuevo" y se presentará la siguiente pantalla:

 

Los Tipos de Tarjetas de Fidelidad permitirán definir los parámetros que manejara una tarjeta de fidelidad al momento de ser dada de alta así como también los parámetros que se evaluarán cuando se quiera imputar o descontar saldo de ella.

Estos tipos de tarjetas de fidelidad, serán los consultados cuando, desde el punto de venta o desde la propia consola se quiera generar una tarjeta de fidelidad de un tipo específico o imputar/descontar.

Cuando se desee definir un tipo de tarjeta de fidelidad se deberán tener presente las siguientes opciones:


          • Código: Será el identificador univoco del tipo de tarjeta de fidelidad, campo alfanumérico.
          • Nombre: Identificador dentro de la consola del tipo de tarjeta de fidelidad, campo alfanumérico.
          • Descripción: campo alfanumérico, describirá el tipo de tarjeta de fidelidad que se está creando.
          • Rangos de Prefijos: el o los valores indicados en este popUp representarán los primeros dígitos con que se asignarán al código de las tarjetas generadas a partir del tipo de tarjeta 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 tarjeta 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 tarjeta.
          • Cantidad de dígitos: aquí deberá indicarse el largo del código de la tarjeta a generarse a partir del tipo de tarjeta de fidelidad seleccionado. Se tomaran en cuenta para la generación del código de la tarjeta de fidelidad el largo del prefijo que deberá esa contemplado al momento de definir este campo. Por ejemplo, si una tarjeta tiene como prefijo "333" y el largo de la tarjeta es 13, los tres primeros dígitos de la tarjeta serán "333" y los 10 dígitos restantes corresponderán al número de la tarjeta propiamente dicho.
          • Tipo de vencimiento: se podrá definir para un tipo de tarjeta de fidelidad el vencimiento que traerá asociado la tarjeta que se genere a partir ésta.

Podrá seleccionarse entre:

              • Fechas: (Disponible a partir de Promo V7.1.4) Al seleccionarse, habilitará dos campos de carácter obligatorio, que determinaran la fecha de inicio y fin de vigencia de la tarjeta. Este dato podrá definirse en el archivo desde el cual se den de alta las tarjetas 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, las tarjetas que se generen tomaran la vigencia definida en el Tipo de tarjeta. De indicarse una fecha desde y una fecha asta en el archivo de alta, las tarjetas serán generadas con la fecha indicada en el archivo de alta. Esta operatoria tambien rige para el alta de tarjetas via Punto de Venta como para el alta de tarjetas via servicio/RabbitMq.
                  • Valido desde:  Refiere a  la fecha de inicio de vigencia de la tarjeta. (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 de la tarjeta. (La hora tomada por el sistema para el fin de vigencia será las 23:59:59).

NOTA

En versiones anteriores a Promo 7.1.4, cuando se se opte por definir la vigencia de una tarjeta por medio de "Fecha", el alta de las tarjetas de este tipo sera solo por "Archivo" y deberá indicarse la fecha desde y la fecha hasta en cada registro de tarjeta a generar.


              • Días desde la activación: la tarjeta que se genere a partir de este tipo de tarjeta 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: la tarjeta que se genere a partir de este tipo de tarjeta 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 las tarjetas dadas de alta a partir de este tipo de tarjeta de fidelidad tendrán una carga asociada o no.

Podrá seleccionarse entre:


            • No: la tarjeta que se genere a partir de este tipo de tarjeta de fidelidad no tendrá carga al momento del alta.
            • Archivo: la tarjeta que se genere a partir de este tipo de tarjeta de fidelidad deberá tener asociado un saldo en el archivo que la genere.
            • Definir pre-carga: la tarjeta que se genere a partir de este tipo de tarjeta de fidelidad tendrá el saldo definido en el campo "Definir pre carga" al momento del alta.
          • Recargable: De seleccionarse esta opción, la tarjeta dada de alta a partir de este tipo de tarjeta 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 una tarjeta 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 tarjeta. Las opciones disponibles son:

Podrá seleccionarse entre:

            • Sin vencimiento: la carga no vencerá nunca
            • Días desde la carga: la carga vencerá en una determinada cantidad de días a partir del momento de la imputación (default 365 días).
            • Fecha: Podrá indicarse, desde un calendario,  la fecha en que vencen todos los puntos de un tipo de tarjeta 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 tarjeta 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 tarjeta 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 la tarjeta vencerán el primer día de cada mes a las 00:00:00 




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

Las opciones disponibles son:

            • No (las tarjetas generadas a partir de un tipo de tarjeta con esta definición no tendrán asociado cliente)
            • Por Archivo de Alta Masiva (las tarjetas generadas a partir de un tipo de tarjeta con esta definición deberán asociársele el cliente en el archivo de alta de tarjetas)
            • En canal de Venta (las tarjetas generadas a partir de un tipo de tarjeta con esta definición podrán asociársele un cliente desde el punto de venta)
        • Nota

          Cuando el tipo de tarjeta 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 tarjeta 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 una tarjeta, pudiéndose elegir entre "No" (default), "Por archivo de alta masiva" o "En canal de venta".



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

Podrá seleccionarse entre:


            • NO: el tipo de tarjeta de fidelidad que tenga esta opción en NO, indicara que las tarjetas generadas a partir de este tipo no podrá realizar ningún tipo de transferencia a otra.
            • Total: Total: el tipo de tarjeta 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 otra tarjeta de su mismo tipo y que este en estado inactiva. Al hacerlo la tarjeta de origen (la que da el saldo) quedara cancelada y con saldo cero, mientras que la tarjeta de destino (la re recibe el saldo) pasara de inactiva a activa y tendrá como saldo la totalidad de saldo que tenía la tarjeta de origen, así como también se le asignara el convenio y cliente que tenía asociado la tarjeta de origen.
            • Parcial: el tipo de tarjeta de fidelidad que tenga la opción de transferencia en "Parcial" podrá transferir total o parcialmente a una tarjeta activa de su mismo tipo sin sufrir ninguna de las dos tarjetas alteraciones en su estado.

          • CVV requerido: De seleccionarse esta opción, la tarjeta que se dé de alta con este tipo de tarjeta deberá que tener asociado un código CVV de validación, el cual será requerido tanto para el alta de la tarjeta como para la imputación o consumo de saldo desde el punto de venta. . Las tarjetas 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: (a partir de 7.1.10) Al momento de chequear el campo "CVV Requerido", se habilitara el combo "Canal exceptuado de CVV" desde donde se podrá indicar que "canal" quedaran exceptuados de la validación de CVV al momento de realizar alguna operación con este tipo de tarjeta 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á exceptuarse un  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 una tarjeta de este tipo.

            IMPORTANTE

            Cuando desde un punto de venta se envíe una consulta u operación con tarjeta de fidelidad, se evluará 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 tarjeta de fidelidad a la que pertenece la tarjeta.

            Si hay coincidencia (el canal informado en la mensajería esta exceptuado de validación de CVV en tipo de tarjeta de fidelidad a la que pertenece la tarjeta consultada), no se validara el CVV asi haya sido enviado no en la tarjeta. (<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: A partir de Promo 7.0.2 - Al momento de dar de alta un tipo de tarjeta de fidelidad, se podrá indicar si el tipo de tarjeta controlara un máximo de otorgamiento de puntos por transacción, independientemente de los beneficios que sumen a este tipo de tarjeta en la transacción.  Se podrá en una misma transacción, aplicarse n beneficios que apliquen un mismo tipo de tarjeta 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 tarjeta 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 una tarjeta de fidelidad en la transacción ("chargeAmount"), se validara que el tipo de tarjeta 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 una tarjeta 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 las tarjetas dadas de alta a partir de este tipo de tarjeta 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, lar tarjetas generadas a partir de este tipo de tarjeta de fidelidad podrán consumir la totalidad de su saldo en más de una operación, caso contrario, de no tildarse, el saldo de la tarjeta deberá consumirse en una sola transacción. En caso de que esta única transacción sea por un valor menor al saldo de la tarjeta, esta se inactivara perdiéndose el saldo restante.

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

          • Campañas de fidelidad: podrá indicarse si las tarjetas dadas de alta a partir este tipo de tarjeta 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 Tarjeta 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 tarjeta. 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 tarjeta. En este caso el sistema validará que el rango ingresado no esté siendo utilizado en parte o en su totalidad para otro tipo de tarjeta. Por ejemplo si para el tipo de tarjeta A existe el rango 144-184 y para la tarjeta B queremos ingresar el rango 150-165, el sistema no permitirá ingresarlo ya que el rango está siendo utilizado para otro tipo de tarjeta.
      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 tarjetas 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 Tarjeta 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 "Tarjetas 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 tarjeta.

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 las tarjetas o bien un rango de prefijos que comprenderá el universo de tarjetas a dar de alta bajo este tipo de tarjetas de fidelidad.

Cuando el usuario ingrese el rango de prefijos y presione el botón continuar, en la pantalla nuevo tipo de tarjeta de fidelidad, debajo del botón "Agregar Prefijo", se mostrará el listado de prefijos ingresados.


En la pantalla "Gestión de Tipos de Tarjetas 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 tarjeta de Fidelidad


En Fidelidad\ Tipos de Tarjetas de Fidelidad, al seleccionar el botón “Acciones” en cualquiera de los tipos de tarjetas en estado: Habilitado, Inhabilitado y Distribuido, todos mostrarán las tres opciones: Editar, Copiar y Resumen.

Los posibles estados de los tipos de tarjetas de fidelidad pueden ser:

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


Edición de tipo de tarjeta habilitado e inhabilitado: como todavía no se generaron tarjetas, se puede seguir editando el tipo de tarjeta hasta que pase a estado distribuido. Se pueden seguir modificando todos los datos menos el código. 


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




Tarjetas de Fidelidad


La gestión de las tarjetas 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 las tarjetas de fidelidad dadas de alta en la base de datos de PROMO.

Al presionar en "Tarjetas de Fidelidad" del menú "Fidelidad" se mostrará la pantalla "Gestión de tarjetas de fidelidad" donde podrán visualizar las tarjetas con su estado, número de tarjeta,  tipo de tarjeta, 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 las tarjetas ya sea por su identificador del cliente, número de tarjeta, tipo de tarjeta, estado, vigencia desde/hasta  o convenio.

Los filtros que aparecerán ya pre-cargados serán:

          • Estado: Mostrara "Activa" y podrá seleccionarse Activa, Inactiva, Cancelada o Vencida. 
          • Tipo de Tarjeta:   Mostrando la primera opción de la lista. Permitirá filtrar por tipos de tarjetas de fidelidad activos en la consola.
          • Valida desde y Valida hasta: 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").

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 las tarjetas asociados a éste.
          • Número de tarjeta:  Podrá filtrarse por el número de la tarjeta determinado. Podrá ingresarse solamente el identificador de la tarjeta de fidelidad para obtener los datos de una tarjeta en particular.
          • Convenio: Podrán filtrarse las tarjetas asociadas 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 tarjetas, modificar el saldo, cancelarlas o simplemente visualizar su estado e historial de acciones.

NOTA

Si se modifica el saldo de una tarjeta inactiva, la tarjeta se pasa a Activa.


Alta Masiva de tarjetas

Para la generación de tarjetas de fidelidad a partir de los tipos de tarjetas existentes, se deberá dar clic en "Alta Masiva". 

Se presentara la pantalla "Alta masiva de tarjetas"



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 tarjetas, en primer lugar, deberá seleccionarse el tipo de tarjeta a partir del cual se desea realizar el alta. 

Dependiendo de la configuración de cada tipo de tarjeta, se podrán dar de alta tarjetas directamente desde la consola (alta manual) o realizar el alta desde un archivo

Dependiendo de la configuración de cada tipo de tarjeta, se podrán dar de alta tarjetas:

          • 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 tarjetas ]” el código de un tipo de tarjeta 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 tarjeta se deberá indicar si las tarjetas que se dan de alta estarán activas o inactivas, por último indicar la cantidad de tarjetas a generar.



En el primer campo: "Tipo de Tarjeta" debe seleccionar del combo desplegable el tipo al que van a pertenecer las tarjetas 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 tarjetas activas" o "Generar tarjetas inactivas".

En el tercer campo "Rango Prefijos" podrá seleccionar para que rango desea generar tarjetas (por ej: 250-400).

En el cuarto campo "Cantidad a generar" deberá ingresar un número entero para indicar la cantidad de tarjetas 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 tarjetas restantes a generar. Para cada rango de prefijos solo se podrán generar números de tarjetas 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 tarjetas a generar. Ejemplo de mensaje: "El máximo disponible para generar tarjetas 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 tarjetas y luego el sistema mostrará un mensaje indicando que no se pueden generar mas de x cantidad de tarjetas.
            • 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 tarjetas ]” el código de un tipo de tarjeta de fidelidad que permita alta por archivo (que requiera CVV, o que sea nominada por archivo o cuya vigencia este definida por rango de fechas). Al seleccionar el tipo de tarjeta se deberá seleccionar el archivo card_timestamp.catalog que contenga todas las tarjetas 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 tarjeta 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

Las tarjetas dadas de alta por medio de archivo serán generadas en estado “INACTIVAS”.


NOTA

En caso de que el archivo a procesar contenga un Id de Tarjeta existente en la base de datos, solo se realizará la actualización del Id de Cliente, en caso de ser una tarjeta nominada.


Terminado el proceso, se habilitara el botón “ver informe” desde el cual podrán verse las tarjetas dadas 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 las tarjetas importadas. 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 de la tarjeta de fidelidad que se está dando de alta. Requerido.
Type: Corresponde al código del tipo de tarjeta de fidelidad que se está dando de alta. Requerido.
Date-from/Date-to: deberá completarse en caso de que el tipo de tarjeta al que pertenece la tarjeta 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 tarjeta al que pertenece la tarjeta 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 tarjeta al que pertenece la tarjeta a dar de alta indique que la "Pre carga" debe especificarse por "Archivo".


Según al tipo de tarjeta de fidelidad al que pertenezcan la o las tarjetas 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 una tarjeta por archivo y la asignación de cliente y convenio, se realiza nuevamente el proceso de ABM de tarjeta, informando en la interfaz alguna tarjeta existente en la base pero sin informar cliente, el cliente asociado a la tarjeta originalmente será borrado ya que la actualización de tarjetas  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 Tarjetas

Por medio del proceso de Asignación/Actualización podrá asociarse un numero de tarjeta a un determinado cliente y convenio así como también podrá asignársele o actualizar un saldo.

Una vez dadas de alta las tarjetas, tanto para la asignación de clientes y convenios a las tarjetas, como para la recarga o modificación de saldo de las misma deberá de realizarse la Asignación/Actualización de las tarjetas.

Por medio de este proceso se podrá:

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

Cuando se realice la asignación de clientes/convenio, a las tarjetas, las mismas pasaran a estado “activas”.

Cuando se realice un ajuste de saldo, los montos presentes en cada tarjeta 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 tarjeta existente al que se le asociara cliente/convenio o al que se actualizara su saldo. 
          • customer: Cliente que se asociara a la tarjeta.
          • amount: Saldo que se asignará a la tarjeta. (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 tarjeta que no corresponde al tipo de tarjeta existente en PROMO, se mostrara un mensaje en pantalla, indicando que el tipo de tarjeta no corresponde a un tipo de tarjeta 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 la/las tarjetas que contenga, tengan asociado en la DB, se mostrara un mensaje en pantalla, indicando que la/las tarjetas 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 tarjeta,  que no corresponde a los tipos de tarjeta que las tarjetas que contenga tengan asociado en la DB, se mostrara un mensaje en pantalla, indicando que el tipo de tarjeta informado en el nombre del archivo no se corresponde con el tipo de tarjeta  de las tarjetas informadas 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 la tarjeta no tiene asignado un código de Convenio, se actualizara la tarjeta con el código de convenio, contenido en el nombre del archivo que está siendo procesado.
          • Si la tarjeta no tiene asignado un código Cliente, se actualizara la tarjeta con el código de cliente informado en el registro.
          • Si la tarjeta posee estado "Activo", el campo amount, actualizara el saldo de la tarjeta.
          • Si a tarjeta posee estado inactivo, se actualizara el saldo de la misma con el valor informado en el campo amount y la tarjeta pasara a “activa”.
          • Si se informa un cliente y la tarjeta 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 la tarjeta tiene asociado otro cliente, informara un mensaje por pantalla, indicando que la tarjeta 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

        • La tarjeta debe existir.
        • Requerido

Customer

        • Si viene informado el cliente y en la DB la tarjeta 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 la tarjeta tiene asociado el mismo cliente, queda el campo como esta.
        • Si viene informado el cliente, y en la DB la tarjeta tiene asociado otro cliente, informara un mensaje por pantalla, indicando que la tarjeta 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 >> Tarjetas de Fidelidad. >>  "Asociación/Actualización"


Al presionarlo se mostrará la siguiente pantalla:

Una Vez seleccionado el tipo de tarjeta y Convenio, se deberá presionar el botón "Seleccionar Archivo" desde el cual se podrá cargar el archivo tipo de tarjeta_ 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 tarjeta, la fecha, la cantidad de registros procesados, convenio al que pertenecen las tarjetas procesadas 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 tarjeta, la fecha, la cantidad de registros procesados, convenio al que pertenecen las tarjetas procesadas 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 tarjetas, 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 linea:

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 Tarjetas de Fidelidad", podrá accederse al detalle de movimientos de cualquiera de las tarjetas presentes en la consola. Al presionar el botón "Ver" que se encuentra en el combo "Acciones" a la derecha de cada tarjeta, se accederá a la vista de "Transacciones registradas" donde se expone un resumen de los datos de la tarjeta y el detalle de las operaciones realizadas con ella, 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

(A partir de las versiones: mayor que 6.5.13 y mayor que 7.0) Si se modificó el cvv de una tarjeta de fidelidad, quedará registrado en el informe "Transacciones Registradas" que se accede seleccionando Fidelidad\ Tarjetas de Fidelidad\ sobre la tarjeta deseada 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 tarjeta al que pertenece la tarjeta en cuestión)


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





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

(Ver también "Motivos de modificación de Saldos")


                    • Trasferir: podrá transferirse saldo entre tarjetas pertenecientes al mismo tipo y que acepten recarga, si es que la configuración del tipo de tarjeta al que pertenecen lo permite.








              • Asociar cliente: podrá asociarse una tarjeta de fidelidad a un determinado código de cliente, si es que la configuración del tipo de tarjeta al que pertenecen lo permite.


Extensión de Vigencia:

Desde la sección "Transacciones registradas" de una tarjeta, si la tarjeta pertenece a un tipo de tarjeta 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 tarjeta de fidelidad como extraviada, podrá realizarse la transferencia TOTAL del los datos y saldos de la tarjeta extraviada a una nueva tarjeta.

La tarjeta denunciada pasara a cancelada y con saldo 0 (cero), mientras que la tarjeta de destino, quedara activa, con el saldo total, el cliente y convenio (en caso de tener asociado) que tenía la tarjeta de origen. Siempre la transferencia se realizara entre tarjetas de un mismo tipo y la tarjeta de destino deberá estar inactiva con saldo cero y sin convenio ni cliente asociado para poder recibir los datos de la tarjeta denunciada.

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 la tarjeta denunciada y no podrá editarse.

En el campo Tarjeta de destino, a medida que se ingresen los dígitos de la tarjeta de destino se propondrán los números de las tarjetas de ese tipo inactivas, con saldo cero, sin cliente ni convenio asociado para ser seleccionadas.

Una vez elegida da tarjeta de destino se presionara Aplicar y la transferencia total estará hecha.


Convenios

Desde la consola de Promo se podrán dar de alta "Convenios", que luego podrán ser asociados a tarjetas.

Desde la sección Fidelidad >> Convenios podrán administrarse y generarse nuevos Convenios que luego serán asociados a tarjetas de fidelidad de distinto tipo por medio del proceso de “Asociación/Actualización” de tarjetas (Fidelidad >> Tarjetas 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 tarjetas 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 tarjetas y estas se encuentren activas ya no podrá modificarse el código del 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, las tarjetas 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".



Dentro de esta pantalla podremos observar las Tarjetas y Cupones asociados del cliente y el estado de cada una de ellas.

También se muestra aquí el informe de “Movimientos de descuentos por Promoción” donde se detallaran 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

(A partir de la v 7.0.18) 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.

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. 

(Siguiendo el ejemplo de la pantalla anterior, aquí se seleccionó la opción "Eliminar Datos y Fidelidad del Cliente" sobre el registro 2, por eso ya no se ve en esta pantalla).





Capítulo 10 - Módulo de Informes

Menú de Informes


PROMO dispone distintos tipos de informes para poder llevar un control de auditoria en caso de que así lo requiera el negocio de todos los elementos disponibles en la consola.

Se cuenta con 7 secciones que agrupan los distintos informes disponibles:

IMPORTANTE

Exportación de Informes a Excel:

Los informes exportados en formato .xls (Excel 2003) tienen un límite máximo de 65.000 filas (desde Promo 7FP1).



Informes de Promociones y Mapas


Promociones Vigentes 

Este informe listará las promociones Vigentes presentes en el o los mapas activos informados por los motores que reporten a la consola. 


Se podrá filtrar por los siguientes campos:

          • Mapa: Mapa activo reportado a la consola por los motores conectados a ésta.

            Nota

            El filtro "Mapa" listará los mapas activos de los motores que se encuentran conectados a la consola. Se entiende por mapa activo al último mapa distribuido que esté vigente. Si el último mapa distribuido está vencido el motor no podrá evaluar promociones.

          • Código: podrá filtrarse por el código de promoción presente en un mapa seleccionado.
          • Nombre de Promoción: Podrá seleccionarse de la lista desplegable una promoción presente en el mapa seleccionado

A partir de Promo 7.0.16 se dispone en el informe de Promociones vigentes, de la posibilidad de navegar los registros por medio de los dos nuevos campos presentes en el informe, que por default al ingresar al informe en mostrarán 1 (uno) y 50 (cincuenta), de esta manera, mostrará por pantalla hasta los primeros 50 registros partiendo del primer registro. Pudiéndose modificar, solicitando que se muestre un rango determinado de registros por pantalla.

Otra funcionalidad que se agrega a partir de esta version, es que al acceder al informe no se mostraran datos, sino hasta que se presione el botón "lupa" lo que ejecutara los filtros por default o los que se hayan modificado por el usuario.


También se suma, a la descarga del informe a excel (donde solo se descargaran los datos presentes por pantalla), la posibilidad de realizar una exportación masiva de promociones. Esto permitirá descargar en un .csv  con todos los datos que haya devuelto la consulta, no solo los que se muestren por pantalla. Al presionarlo, se redireccionara la pantalla al "Monitor de Exportaciones", en donde se mostrara el estado del informe requerido. Este informe sera descargado en la ruta destinada a tal fin desde la configuración central de Promo (en caso de inconvenientes para la exportación de este informe deberá contactarse al Servicio de Atención al Cliente Napse, para la revisión de las configuraciones centrales de la consola)



Promociones

Esta opción permite filtrar y obtener informes de las promociones creadas, con la opción de exportar la información a un archivo .xls.

Se podrá filtrar por los siguientes campos:

              • Código
              • Nombre de promoción
              • Estado (de la promoción)
              • Tipo de promociones
              • Sub-tipo de promociones
              • Formas de aplicación
              • Campaña (a la que está asociada la promoción)
              • Beneficio (que otorga la promoción)
              • Canal (de publicación al que esta asociado la promoción)
              • Vigencia (de la promoción)


A la derecha de estos filtros se mostrará el botón lupa. Al presionarlo se mostrará por pantalla el resultado de la búsqueda. Al lado de este botón se mostrará un botón con la x, con el cual se podrán borrar los filtros de búsqueda seleccionados. A la derecha de este se mostrará el botón EXCEL, al seleccionarlo bajará a un archivo Excel el resultado de la búsqueda indicada. Si el usuario selecciona el botón Excel sin haber seleccionado el botón lupa previamente, se bajará el archivo Excel sin mostrar por pantalla el resultado de la búsqueda. Al lado del botón "Excel" encontrará el botón "Exportación Masiva". Los botones "Excel" y "Exportación Masiva" estarán deshabilitados hasta que se realice una búsqueda presionando el botón lupa (search). Cómo máximo el sistema mostrará 1.000 registros por página, permitiendo navegar entre las mismas. El botón "Excel" descargará la información que se tiene en la pantalla que está visualizando. Si presiona el botón "Exportación Masiva" el sistema lo llevará a una nueva pantalla "Monitor de Exportación de Informes" (ver detalles en "Monitor de Exportación de Informes"). Donde podrá ver el estado del archivo que se está generando con la información completa con todas las páginas que se haya tenido como resultado.





Promociones por SKU

Esta opción permite filtrar y obtener informes de las promociones que contengan un determinado codigo SKU entre sus condiciones. con la opción de exportar la información a un archivo .xls.

Se podrá filtrar por los siguientes campos:

              • Código SKU:  Podrá ingresarse códigos SKU para efectuar la búsqueda de promociones asociadas a ese SKU y a todos sus atributos. En caso de que se trabaje con Catálogo de productos, deberán proponerse los datos por catálogo.
              • Fechas: podrá buscarse por las promociones vigentes o vencidas en una fecha determinada.
              • Vigencia: Podrá indicarse si se desea filtrar entre las promociones vigentes o No vigentes para el SKU y fechas seleccionadas.



      • Cuando una promoción este definida para todo el universo de Productos (Elemento "Productos", Atributo "Aplica a Todos", tambien se listara entre las promociones que apliquen para un SKU determinado.



Mapas (POS)

Esta opción permite filtrar y obtener informes de los mapas creados, con la opción de exportar la información a un archivo .xls.
Se podrá filtrar por los siguientes campos:

              • Estado del mapa
              • Publicación del mapa


También se mostraran los datos de Versión e inicio de Vigencia de los mapas filtrados.


Límites por Promoción

Por medio de este informe podrán visualizarse límites definidos de los beneficios de promociones vigentes en mapas activos.

Podrá filtrarse por Mapa, Código y Nombre de Promoción (luego de elegido un mapa). Por default se mostrarán las promociones con límites que se encuentren activas en el primer mapa activo disponible.


Historial Límites

Esta opción permite filtrar y obtener informes de las promociones cuyos beneficios tienen definidos "Límites", con la opción de exportar la información a un archivo .xls. 

En el Informe historial de límite solo aparecen las promociones cuyo límite fue modificado.
Se podrá filtrar por los siguientes campos:

              • Código
              • Nombre de la Promoción

IMPORTANTE

La columna "Mapa" mostrará el número del mapa en el cual se distribuyó la promoción. Esta actualización de la columna mapas se realizara con la distribución de la promoción luego de que el limite haya sido distribuido.



Distribución: Redes Sociales

Esta opción permite filtrar y obtener informes de las promociones que fueron distribuidas en las distintas redes sociales, con la opción de exportar la información a un archivo .xls.
Se podrá filtrar por los siguientes campos:

              • Código (de la promoción)
              • Nombre de la Promoción
              • Canal (Red Social en la que se distribuyó)
              • Usuario (que la distribuyó)


(Solo aparecerá este informe cuando el modulo se haya adquirido)

Distribución: Tiendas

Esta opción permite filtrar y obtener informes de a que Tienda ha sido distribuida cada mapa creado y completo, con la opción de exportar la información a un archivo .xls.
Se podrá filtrar por los siguientes campos:

              • Nombre del Mapa que se distribuyo
              • Tienda de distribución
              • Usuario que realizo la distribución




Informes de Transacciones

Indicadores operacionales

Por medio de este informe, podrá llevarse un control general diario de las operaciones que se registran en la base de PROMO. Este Informe contara con un único filtro donde deberá especificarse la fecha de la cual se desea obtener los datos.

Los indicadores a mostrar serán:

                • Transacciones: aquí se indicara el nro. de transacciones realizadas en el día seleccionado sin importar si las transacciones fueron de venta o de devolución.
                • Transacciones con descuento: aquí se indicara el nro. de transacciones que fueron beneficiadas por al menos un beneficio.
                • Transacciones: indicara el motor total de las transacciones realizadas en el día seleccionado.
                • Descuentos (valor): indicara el monto de descuentos aplicados en el día seleccionado.
                • Productos vendidos: Se informara la cantidad de items vendidos en todas las transacciones de ventas del día.
                • Ticket promedio: Mostrara el valor promedio de las transacciones realizadas en el día seleccionado.
                • Ticket medio: Mostrara el valor promedio de las transacciones realizadas en el día seleccionado.



Detalle de transacción

Este informe permitirá buscar un ID de transacción especifico de PROMO y mostrar en pantalla el detalle de los elementos y beneficios existentes en ella.

Este informe solo estará disponible cuando el modulo de transacciones esté habilitado.

Contara con el filtro "Numero de Transacción", se ingresara allí el numero de transacción de PROMO a buscar, y al presionar "Enter" se mostrara, en caso de existir, la transacción con los elementos que la componen.


Ranking de Clientes

Este informe expondrá por pantalla los movimientos de clientes en un determinado período.

Por default vendrá seteado el filtro en desde y hasta con la fecha del momento en que se accede al informe.


Se visualizaran las siguientes secciones:

                  • "Dinero Gastado por Cliente": Aquí se listaran los primeros cinco clientes que acumulen la mayor cantidad de dinero gastado en el período seleccionado, ordenados de menor a mayor por la columna "Dinero".
                  • "Puntos/Montos Ganados por Cliente": Aquí se listaran los primeros cinco clientes que acumulen la mayor cantidad de Puntos o Montos acumulados (independientemente del tipo de Puntos de fidelidad) en el período seleccionado, ordenados de menor a mayor por la columna "Puntos/Montos".
                  • "Cupones ganados por cliente": Aquí se listaran los primeros cinco clientes que acumulen la mayor cantidad de Cupones Ganados (emitidos) acumulados (independientemente del tipo de cupón) en el período seleccionado, ordenados de menor a mayor por cantidad de cupones.



Transaccional de limites

Éste reporte permitirá  visualizar el historial de movimientos de limites en una determinada transacción. Se presenta un resumen de la promoción en la sección "Detalle de la Promoción" y debajo del titulo "Movimientos" se registraran, de la mas nueva a la mas antigua todas las transacciones que generaron movimientos en el limite definido para dicha promoción. Se podrá filtrar por fechas para ver los movimientos de un determinado día o rango de fechas, así como también se deberá poder exportar la información a un archivo Excel. 



Errores de Reverso

Este informe expondrá el detalle de las transacciones de reverso donde se vieron involucrados elementos de fidelidad y que presentaron errores en el proceso.


Reporte de transacciones

En este reporte se listarán las transacciones registradas en la base de PROMO en un período seleccionado. Cuenta con los filtros fecha "Desde" y fecha "Hasta" que se presenta precargado con la fecha hasta indicando la fecha actual y la fecha desde indicando 7 días antes a la fecha actual.

Este reporte se encuentra en el menú de Promo en Informes\ Transacciones.

Al ingresar en el informe "Reporte de Transacciones" mostrará una pantalla como la siguiente:


Los filtros de búsqueda que se mostrarán son los siguientes:

                • El campo desplegable "Tienda" mostrará todas las tiendas activas.
                • Los campos "Desde" y "Hasta" desplegarán un calendario para seleccionar las fechas desde y hasta la cual se desea realizar la búsqueda. Por default mostrará un rango de fechas con los últimos 7 días. No permite buscar rangos de fechas superiores a 7 días.
                • El campo desplegable "Tipo de Transacción" mostrará las opciones "Venta" y "Devolución".

A partir de Promo v.7.0.3 estará disponible en el reporte el botón "Exportación Masiva" y el menú de Informes "Monitor de Exportación" (ver detalles mas abajo).

Debajo de los filtros de búsqueda se mostrarán dos campos para navegar los registros, son los filtros de paginación (a partir de Promo v.7.0.3), que por default al ingresar al informe mostrarán 1 (uno) y 50 (cincuenta), de esta manera, mostrará por pantalla los primeros 50 registros partiendo del primer registro. 

Aclaración

No es necesario completar los filtros de búsqueda para utilizar los campos de navegación de los registros que se encuentran debajo de ellos.

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.


En el siguiente ejemplo, a pesar de haber puesto en el filtro que se desea ver 50 registros, sólo muestra 16 porque es la cantidad máxima de registros que encontró con las características indicadas.

Una vez ingresados los filtros de búsqueda deseados, presionar el botón lupa. Si desea borrar esos filtros para realizar otra búsqueda presionar el botón x. Si presiona el botón Excel, descargará en un archivo Excel los registros mostrados en pantalla.

Si desea ver por ejemplo a partir del tercer registro, dos registros por pantalla, (o sea mostrará el 3er y 4to registros) deberá indicarlo de la siguiente manera:


Para ver los siguientes registros deberá presionar la doble flecha que se encuentra a la derecha, así el sistema mostrará en este último ejemplo los siguientes dos registros.

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.

En Simulación en Masa tomará la cantidad de registros como se muestra por pantalla, si muestra los primeros 1.000 por ej hará la simulación con esos 1.000.

De no encontrarse transacciones para el período y tipo de transacción seleccionados, se mostrará el mensaje "No hay registros".

Al listarse las transacciones, a la derecha que cada transacción se mostrara un combo de "Acciones" donde podrá seleccionarse entre "Ir al Detalle" , "Simulación" y "Generar Simulación".

Al presionar en "Ir a Detalle" se accederá al detalle de la transacción, direccionándose la página al "Informe de detalle de transacción". La emisión y redención de cupones calculados, ya sea por porcentaje, monto fijo o monto externo se verán reflejados en el "Informe de detalle de transacción".

De presionarse en "Simulación" se presentará el pop-up de simulación de promociones/mapas, donde se podrá emular el resultado de los elementos de la transacción seleccionada simulado con un mapa o promoción determinado.

En caso de  presionar "Generar Simulación", los elementos de la transacción seleccionada formarán parte de un nuevo ticket de simulación. La consola se redireccionará a la sección de Distribución >> Simulación, y se presentará la pantalla de "Definir Plantilla" con los elementos de la transacción seleccionada pre cargados para poder ser editados y simulados con un mapa o promoción según se requiera.

También, en esta pantalla se presentará el botón de "Simulación Masiva" por medio del cual se generará una simulación de una promoción o mapa en base a las transacciones filtradas y presentes en la pantalla de "Reporte de transacciones".

Nota

Ver diferencia entre los botones "Excel" y "Exportación Masiva" (desde Promo v7.0.3) y el detalle de cómo funciona la "Exportación Masiva" y el "Monitor de Exportación de Informes" (desde Promo v7.0.3) en la explicación sobre el "Reporte de Promociones".


Reporte de Promociones

En este reporte se mostrarán solo los ítems que hayan tenido algún descuento.

Si en un ticket hay por ejemplo 5 productos, y solo obtuvieron descuento 3 productos, estos 3 productos se mostrarán en el “Reporte de Promociones”, los otros 2 productos que no tuvieron descuento no se mostrarán en este reporte.

Al seleccionar Informes\ Transacciones\ Reporte de Promociones, se mostrará la pantalla “Reporte de Promociones”. Debajo del título se mostrarán los filtros de búsqueda:

                • "Código Promoción", donde se podrá ingresar el código de la Promoción.
                • "Nombre Promoción", donde se podrá ingresar el nombre de la Promoción.
                • Tienda”, donde se podrá seleccionar de un chekbox el nombre de la tienda deseada. Si no se selecciona una tienda mostrará la información de todas.
                • "Fecha Desde”, se presenta precargado con la fecha 7 días antes a la fecha actual.
                • Fecha Hasta" se presenta precargado con la fecha actual. No permite buscar rangos de fechas superiores a 7 días.
                • "Tipo de Transacción", se muestra un combo donde se podrá seleccionar una de las siguientes opciones: "Venta" "Devolución". Si se deja seleccionada la opción que viene por default que es [Tipo de Transacción], mostrará "Venta y Devolución".

Debajo de los filtros de búsqueda se mostrarán dos campos para navegar los registros, que por default al ingresar al informe 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.

A la derecha de estos filtros se mostrará el botón lupa. Al presionarlo se mostrará por pantalla el resultado de la búsqueda. Al lado de este botón se mostrará un botón con la x, con el cual se podrán borrar los filtros de búsqueda seleccionados. A la derecha de este se mostrará el botón EXCEL, al seleccionarlo bajará a un archivo Excel el resultado de la búsqueda indicada. El nombre del archivo tendrá el siguiente formato (si no se seleccionó Tipo de Transacción): Reporte de Promociones_[Fecha Desde_Fecha Hasta].xls.  Ejemplo: Reporte de Promociones_[01-10-2019_07-10-2019].xls.  Si se seleccionó el Tipo de Transacción, el formato será: Reporte de Promociones_Tipo de transacción[Fecha Desde_Fecha Hasta].xls.  Ejemplo: Reporte de Promociones_Venta[01-10-2019_07-10-2019].xls. Si el usuario selecciona el botón Excel sin haber seleccionado el botón lupa previamente, se bajará el archivo Excel sin mostrar por pantalla el resultado de la búsqueda.

Al lado del botón "Excel" encontrará el botón "Exportación Masiva".

Al ingresar en "Reporte de Promociones" por default mostrará una pantalla como la siguiente:

(Columna Offline: desde EP2.2. Botón: "Exportación Masiva" desde Promo v7.0.3).


Importante

El usuario que no tenga permisos para ingresar en la pantalla "Monitor de Exportación de Informes" (desde Promo v7.0.3) no verá en el menú de Promo la opción "Monitor de Exportación" (desde Promo v7.0.3) ni el botón "Exportación Masiva" (desde Promo v7.0.3) en los informes "Reporte de Transacciones" y "Reporte de Promociones".


Los botones "Excel" y "Exportación Masiva" estarán deshabilitados hasta que se realice una búsqueda. El usuario podrá seleccionar los filtros que desea, por ejemplo un rango de fechas desde y hasta, y luego debe presionar el botón lupa (search), lo cual traerá a la pantalla los resultados de esa búsqueda. Cómo máximo el sistema mostrará 1.000 registros por página, permitiendo navegar entre las mismas. El usuario puede presionar luego de esa búsqueda:

 Por ejemplo: si en el informe "Reporte de Transacciones", se ve en la primer pantalla 1.000 registros y en total hay 3.000 (o sea hay 3 pantallas de 1.000 registros cada una).

                • si presiona el botón "Excel": descargará en un archivo Excel la misma información que se muestra en la pantalla actual. Siguiendo el ejemplo: si en la primer pantalla presiona el botón Excel bajará esos 1.000 registros que está viendo.

                • si presiona el botón "Exportación Masiva": el sistema lo llevará a una nueva pantalla "Monitor de Exportación de Informes" (ver detalles en "Monitor de Exportación de Informes"). Donde podrá ver el estado del archivo que se está generando con la información total, siguiendo el ejemplo: el archivo tendrá los 3.000 registros.


En el Reporte de Promociones no se podrá realizar una búsqueda mayor a 7 días. 

Si se ingresa un rango de fechas mayor a 7 días mostrará el siguiente cartel: "La fecha Hasta no puede ser Mayor a 7 días de la fecha Desde".


De no encontrarse ítems con descuentos para la tienda y/o el período y/o el tipo de transacción seleccionados, se mostrará el mensaje "No hay registros".

En pantalla y en el Excel se mostrará la misma información.

Las columnas que se mostrarán son las siguientes:

                • Canales de publicación: mostrará alguna de las siguientes opciones: Punto de venta, Facebook o Twitter. (Aparecerán más o menos opciones según los módulos adquiridos por el cliente)
                • Tienda: nombre de la tienda
                • Campaña: Campaña a la que pertenece la promoción
                • ID Transacción: Código de la transacción
                • Tipo de Transacción: mostrará si la transacción es de tipo "Venta" o "Devolución".
                • Fecha y Hora: Fecha y hora de la transacción           
                • Código Promoción
                • Nombre Promoción
                • Validez Promoción: mostrará la Vigencia de la promoción. Si la promoción aplicada tiene definida la condición de rango horario “Condición de fecha con hora” la mostrará en esta columna, sino mostrará Indefinida.
                • Clase de Beneficio: Si el Tipo de Beneficio aplicado es de tipo Monetario mostrará alguna de las siguientes clases de beneficio: Canje de cupón, Calculado, Descuento Fijo, Descuento Porcentaje, Nuevo Precio, Canje de Puntos, Descuento por Convenio. Si el Tipo de Beneficio aplicado es de tipo No Monetario mostrará alguna de las siguientes clases de beneficio: Coeficiente de Fidelización, Cupón, Cupón Calculado, Plan de Pagos, Porcentaje de Fidelización, Puntos de Fidelización, Regalo, Reintegro Bancario.
                • SKU: mostrará el sku del producto que tuvo alguna clase de beneficio.
                • Precio Unitario: mostrará el precio unitario del sku
                • Descuento aplicado: mostrará el descuento que se aplicó al sku de esa fila, si se aplicó un tipo de beneficio no monetario esta columna mostrará $0.00
                • Cantidad/ Magnitud: en el caso de tener varios productos con el mismo sku, si el cajero escaneó de a uno los sku aparecerán uno en cada fila y en esta columna se verá cantidad: 1; si el cajero escaneó un sku pero ingresó para ese código una cantidad mayor a 1 (por ejemplo ingresó para el sku 111 la cantidad de 10), se mostrará una fila para ese sku pero en la columna cantidad se mostrará la cantidad ingresada por el cajero (en este ejemplo 10).
                • SubTotal: mostrará el subtotal para el sku de esa fila. Mostrará el resultado del cálculo: (Precio Unitario*Cantidad)-Descuento aplicado.
                • Offline: mostrará una x en pantalla si la transacción fué offline, en el archivo Excel mostrará true o false (desde EP2.2).


Si se aplica un descuento a todo el ticket, se mostrarán todos los ítems en el reporte con el descuento proporcional que le corresponda a cada ítem.

Ejemplo del archivo Excel:

Aclaración

La columna Comentarios, no es parte del archivo.

Canales de publicaciónTiendaCampañaID TransacciónFecha y Hora Código PromociónNombre PromociónValidez PromociónTipo de TransacciónClase de BeneficioSKUPrecio UnitarioDescuento aplicadoCantidad/ MagnitudSubTotalOfflineComentarios
Punto de VentaTienda2Black Fridaynapse_Tienda2_1_2019011016400301/10/2019 16:401452Promo 2x128/02/2019 00:00-30/10/2019 23:59VentaDescuento Porcentaje1111520.351520.3511520.35falseel cajero escaneo de a uno los sku
Punto de VentaTienda2Black Fridaynapse_Tienda2_1_2019011016400301/10/2019 16:406100Precio Especial por hoy01/10/2019 10:05-15/11/2019 23:59VentaNuevo Precio23045.0020.00125.00falseingresaron un nuevo precio de $25, el producto valía $45
Punto de VentaTienda5Black Fridaynapse_Tienda5_3_2019100216144502/10/2019 16:142970Cupón para la próxima compra01/08/2019 12:10-31/12/2019 23:59VentaCupón23045.000.00145.00trueel tipo de beneficio aplicado es no monetario. Es una transacción offline por eso muestra true en la columna Offline.
Punto de VentaTienda1Black Fridaynapse_Tienda1_1_2019100217000402/10/2019 17:001452Promo 2x128/02/2019 00:00-30/10/2019 23:59VentaDescuento Porcentaje1111520.357601.75107601.75falseel cajero escaneo un sku y le ingreso la cantidad

(Columna Offline desde EP2.2).

Informes de Cupones

Tipo de Cupones

Esta opción permite filtrar y obtener informes de los tipos de cupones presentes en la consola de promociones así como también visualizar para cada tipo de cupón, cuáles son la o las promociones que lo emiten y redimen, la cantidad de cupones emitidos, redimidos y vencidos para ese tipo de cupón/Promoción. También para cada tipo de cupón podrá visualizarse un promedio de los cupones activos y del monto que activó que representa cada uno. 

La emisión y redención de cupones calculados, ya sea por porcentaje, monto fijo o monto externo se verán reflejados en este informe.

Se permite exportar la información a un archivo .xls para su análisis.


Se podrá filtrar por los siguientes campos:

                • Tipo de Cupón: menú desplegable que mostrará los códigos de todos los tipos de cupones disponibles "activos".
                • Promo de Emisión y Promo de Redención: Al seleccionar un tipo de cupón, los filtros de la promoción de Emisión y de Redención mostrarán las promociones correspondientes dadas de alta para ese tipo de cupón activas y vigentes. De no haber seleccionado ningún tipo de cupón, los filtros mostrarán todas las promociones activas para emisión y redención respectivamente. 
                • Fecha desde y hasta: permitirá indicar un rango de fechar por el cual se desea filtrar la información a mostrar. Por default el filtro viene precargado con un rango de 7 días no pudiéndose filtrar por un rango mayor.


Cupones

Esta opción permite filtrar y obtener informes de los cupones presentes en la consola de promociones así como también visualizar su identificador, tipo y vigencia, con la opción de exportar la información a un archivo .xls.

Se podrá filtrar por los siguientes campos:

                • Identificador de cliente: podrá realizarse la búsqueda de los cupones asociados a un cliente en particular. Podrá ingresarse solamente el identificador del cliente para obtener todos los cupones asociados a éste.

                • Identificador de cupón: podrá realizarse la búsqueda por número de cupón, indicando el mismo en este campo. Podrá ingresarse solamente el identificador de cupón para obtener los datos de un cupón en particular.

                • Tipo de Cupón: menú desplegable que mostrara los tipos de cupón disponibles para el filtro, por defecto se mostrara el primer tipo de cupón dado de alta. Cuando se desee filtrar los cupones por su Tipo de Cupón, se requerirá también el ingreso del  filtro Estado y de la Fecha de Emisión Desde y Hasta. Se podrá indicar como máximo un rango de 7 días.

                • Estado: podrá seleccionarse entre "Emitido", "Redimido", "Cancelado" e "Inactivo" (la opción "Vencido" no se encuentra aquí porque hay un informe específico: "Cupones Vencidos"). Por defecto, el campo mostrará el estado "Emitido". Cuando se desee filtrar los cupones por su Estado, se requerirá también el ingreso del  filtro Tipo de Cupón y de la Fecha de Emisión Desde y Hasta. Se podrá indicar como máximo un rango de 7 días.

                • Tienda: Menú desplegable donde podrá seleccionarse entre las distintas tiendas dadas de alta en PROMO. Por defecto se mostrara la primer tienda dada de alta. Cuando se desee filtrar los cupones por el filtro Tienda, se requerirá también el ingreso del  filtro Tipo de Cupón y de la Fecha de Emisión Desde y Hasta. Se podrá indicar como máximo un rango de 7 días.

                • Emisión desde y  hasta: permitirá buscar cupones emitidos en un determinado rango de tiempo un determinado día. Cuando se desee filtrar los cupones por la Fecha de Emisión Desde y Hasta, se podrá indicar como máximo un rango de 7 días y se requerirá también el ingreso del filtro Tipo de Cupón y del Estado.

                • Filtros de paginación para navegar los registros (a partir de v7.0.14): por default al ingresar al informe mostrarán 1 (uno) y 50 (cincuenta), de esta manera, mostrará por pantalla los primeros 50 registros partiendo del primer registro. Ver detalle de navegación y de botones "Excel" y "Exportación Masiva" en el Reporte de Transacciones.

Al lado de los botones lupa (para realizar la búsqueda) y x (para borrar los datos ingresados en los filtros), mostrará el botón Excel(a partir de v7.0.14) el botón Exportación Masiva. El botón Excel ya estaba en este informe, pero cambia la funcionalidad, hasta ahora bajaba todo, pero a partir de la versión 7.0.14 baja solo lo que está en pantalla. El botón Exportación Masiva permitirá en background bajar al Monitor de Exportación de Informes, un archivo con toda la información que cumpla con los filtros ingresados, pero bajará todas las páginas. 


Al ingresar por primera vez al informe de Cupones, desde que se logueó el usuario actual, por default no traerá información (a partir de v7.0.14). Mostrará una pantalla como la siguiente:

El usuario deberá ingresar los filtros deseados y luego presionar el botón lupa. Al salir de este informe, el sistema mantendrá guardada la última búsqueda realizada y al volver a ingresar mostrará los filtros y los resultados de la última búsqueda realizada (a partir de v7.0.14).



IMPORTANTE

Si utiliza los filtros "Identificador del cliente" y/o "Identificador del cupón" no se tendrán en cuenta los otros filtros para esa búsqueda. Por ejemplo: en la siguiente pantalla se muestra que se filtró por "Identificador del cupón" y muestra correctamente el resultado a pesar de que en los filtros "Tipo de Cupón", y Fechas "Desde" y "Hasta" muestran información que no coincide con la información del cupón mostrado.



Cupones Vencidos

Por medio de este informe podrán consultarse los cupones vencidos durante un período de tiempo determinado. 

La emisión y redención de cupones calculados, ya sea por porcentaje, monto fijo o monto externo se verán reflejados en este informe.

Este informe solo se mostrara cuando el modulo de clientes y cupones este habilitado.


Extracto de Cupones

Este informe expondrá los cupones emitidos o vencidos en base a un cliente seleccionado y un rango de fechas determinado.

La emisión y redención de cupones calculados, ya sea por porcentaje, monto fijo o monto externo se verán reflejados en este informe.


Detalle de Redención

Este informe mostrará los datos de los productos en los cuales se recibieron beneficios a partir de una promo que fue disparada por la redención de un cupón.

Por default este informe mostrará resultados de la última semana. Para realizar otras búsquedas se podrá indicar como máximo un rango de 7 días.

Filtros:

                • Tipo de Cupón (Código del Tipo de Cupón), 
                • Tienda (Nombre de la Tienda),
                • SKU (es un autocompletable que muestra código y nombre del ítem, pero la búsqueda se hace por el código del ítem),
                • Fecha Desde (de la transacción),
                • Fecha Hasta (de la transacción).

Al lado de los filtros mostrará el botón Excel que permitirá bajar el resultado del informe a un archivo con formato xls.


Mostrará un registro por cada vez que aplique el cupón redimido. Mostrando los siguientes datos:

                • Tipo de Cupón (Código del Tipo de Cupón),
                • Nombre del Tipo de Cupón, 
                • Tienda (Nombre de la Tienda), 
                • Código de Tienda (Código de la Tienda), 
                • Fecha de transacción (Fecha y Hora de la transacción),
                • Id Transacción (Código de identificación de la transacción),
                • SKU (Código del ítem),
                • Cantidad
                • Magnitud,
                • Descuento aplicado,
                • Precio Unitario,
                • Monto Total.




Informes de Tarjetas

Tipos de Tarjetas de Fidelidad

Esta opción permite filtrar y obtener informes de los tipos de tarjetas de fidelidad presentes en la consola de promociones así como también visualizar de cada tipo, cuantos tarjetas se encuentran vencidas, cuantas Activas (promedio) y cuál es su Monto activo.

Se permite exportar la información a un archivo .xls para su análisis.

Se podrá filtrar por los siguientes campos:


                • Tipo (menú desplegable que mostrara los tipos de tarjetas disponibles para el filtro)
                • Fecha desde y hasta: permitirá indicar un rango de fechar por el cual se desea filtrar la información a mostrar. Por default el filtro viene precargado con un rango de 7 días no pudiéndose filtrar por un rango mayor.



Tarjetas de Fidelidad

Esta opción permite filtrar y obtener informes de las tarjetas de fidelidad presentes en la consola de promociones así como también se podrá visualizar el estado de la tarjeta, su número, la fecha de creación y activación, a qué tipo de tarjeta pertenece y su saldo, con la opción de exportar la información a un archivo .xls.


Se podrá filtrar por los siguientes campos:

                • Identificador de cliente: podrá realizarse la búsqueda de las tarjetas asociados a un cliente en particular. Podrá ingresarse solamente el identificador del cliente para obtener todas las tarjetas asociados a éste.
                • Numero de tarjeta: podrá ingresarse aquí el número de tarjeta que se desea buscar. Podrá ingresarse solamente el identificador de la tarjeta de fidelidad para obtener los datos de una tarjeta en particular.
                • Tipo de tarjeta: menú desplegable que mostrara los tipos de tarjetas disponibles para el filtro, por defecto se mostrara el primer tipo de tarjeta dado de alta. Cuando se desee filtrar las tarjetas por su Tipo de tarjeta, se requerirá también el ingreso del  filtro Estado y de la Fecha de Creación Desde y Hasta. Se podrá indicar como máximo un rango de 7 días.
                • Estado: deberá indicarse el estado de las tarjetas que se desea filtrar, las opciones propuestas son "Activa", "Inactiva", "Vencida" o "Cancelada", estando por default "Activa" ya seleccionada. Cuando se desee filtrar los cupones por su Estado, se requerirá también el ingreso del filtro Tipo de tarjeta y de la Fecha de creación Desde y Hasta.  Se podrá indicar como máximo un rango de 7 días.
                • Creación desde y hasta: permitirá indicar un rango de fechar por el cual se desea filtrar la información a mostrar. Cuando se desee filtrar las tarjetas de fidelidad por la Fecha de Emisión Desde y Hasta, se podrá indicar como máximo un rango de 7 días y se requerirá también el ingreso del filtro Tipo de Tarjeta y del Estado.
                • Convenio: Podrá filtrarse por un convenio en particular y se mostraran todas la tarjetas que pertenezcan a ese convenio. Cuando se desee filtrar las tarjetas por el filtro Convenio, se requerirá también el ingreso del  filtro Tipo de tarjeta  y de la Fecha de validez Desde y Hasta. Se podrá indicar como máximo un rango de 7 días.


A partir de la versión 7.0.15 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 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.


A partir de la versión 7.0.15 al lado del botón Excel muestra el botón Exportación Masiva. El botón Excel ya estaba en este informe, pero cambia la funcionalidad, hasta ahora bajaba todo, pero a partir de la versión 7.0.15 baja solo lo que está en pantalla. El botón Exportación Masiva permitirá en background bajar al Monitor de Exportación de Informes, un archivo con toda la información que cumpla con los filtros ingresados, bajando la información de todas las páginas. 



Puntos/Montos Vencidos 

Este informe expondrá los puntos o montos que se han vencido en un rango determinado de tiempo, indicando a que cliente pertenecían los saldos vencidos, la fecha y el monto que se venció.


Tarjetas sin Movimientos

Este informe mostrara en base a un rango de fechas determinado, las tarjetas que NO han tenido movimientos durante ese período.


Extractos de Puntos /montos

Este informe expondrá los Montos otorgados o redimidos en base a un cliente seleccionado y un rango de fechas determinado.



Informes de Reportes Programados 


Consultar al administrador del sistema.




Informes de Listas de Precios 


Informe de Listas de Precios

En este informe se podrán visualizar las listas de precios activas en las tiendas. 


Por defecto se visualizaran todas las lista de precios activas (con fecha de fin de vigencia mayor igual a la fecha actual) de solo las tiendas asociadas al usuario

Se podrá consultar solo las tiendas asociadas al usuario, en caso de no tener asociada ninguna tiendas se mostrara por defecto todas las tiendas.

Se podrá filtrar por tienda, Lista de precios, fecha desde y fecha hasta.

El informe se podrá exportar a Excel.


Informe de Precios por Producto

Este informe mostrara los  precios de los productos en la/las tiendas seleccionadas.

 Por defecto se podrá se visualizaran las lista de precios asociadas a las tiendas del usuario, que se encuentren en estado COMPLETA

Se podrá consultar solo las tiendas asociadas al usuario, en caso de no tener asociada ninguna tiendas se mostrara por defecto todas las tiendas.

El usuario podrá consultar filtrar por tienda, sku, categoría, listas de precios, rango de vigencia, y estado

El informe se podrá exportar a Excel.

El rango de fechas (desde y hasta) estará asociado a la fecha de inicio de la lista de precios.


Informe de Evolución de precios

Este informe, permitirá ver la variación del precio de un producto en una tienda a futuro, desde la lista 0.

Se deberá indicar una tienda, SKU y rango de fechas, que se quiere consultar.

 Buscara precios a futuro, solo si se indica una fecha hasta mayor al día actual.

El gráfico mostrara la evolución de precio regular y precio a crédito del ítem consultado.

El informe se podrá exportar a Excel


Informe de Recupero de Proveedores

Este informe, permitirá visualizar las transacciones que poseen monto de recupero por proveedor.

Se podrán generar informes (resumidos y detallados)de recupero de proveedores. filtrando por: tiendas, proveedor, categoría, SKU , rango de fechas, y tipo de informe .

El informe detallado mostrara todas las transacciones que se hayan realizado  para todos los SKU's, que hayan tenido un monto de recupero de algún proveedor (del bien, o financiero):

El informe resumido totalizara el monto de recupero del proveedor correspondiente por SKU:



Informes de Monitor de Exportación


El monitor de Exportación se podrá acceder desde el menú principal de Promo\ Informes, "Monitor de Exportación" (desde Promo v7.0.3).


La pantalla "Monitor de Exportación de Informes" se verá como la siguiente:

La pantalla "Monitor de Exportación de Informes" mostrará al usuario las siguientes columnas:

              • Estado: mostrará en qué estado se encuentra el archivo con el reporte solicitado. Mostrará "Procesando" cuando todavía se esté armando el archivo, "Finalizado" cuando ya esté terminado y "Error" cuando la base de datos muestre un time out o cuando se haya terminado el espacio en el disco donde se está guardando el archivo, si se pierde la conexión o no se pudo conectar. Estos errores se guardarán en los archivos de log de Promo,
              • Informe: mostrará el nombre del informe solicitado, por ejemplo Reporte de Promociones,
              • Fecha de Inicio: mostrará la fecha y hora en que se presionó el botón "Exportación Masiva",
              • Fecha de Fin: mostrará la fecha y hora de finalización de armado del archivo, mientras lo arma estará vacío,
              • Descripción: mientras se esté armando el archivo mostrará "-" y cuando haya finalizado de armar el archivo mostrará un link donde el usuario podrá hacerle click con el mouse y descargará el archivo creado.


El nombre del archivo tendrá la siguiente estructura:

iddeusuario_NombreDelInforme_FechaHoraMinutosSegundos.csv

(id de usuario sale de la tabla: secUser de la columna _id)

FechaHora: AAAAMMDDHHMMSS

Ej: 3_ReporteDePromociones_20210419132800.csv


El archivo tendrá extensión csv, se generará en background, en un proceso de baja prioridad y no tendrá un límite de espacio. El límite estará dado por el disco donde se lo guarde.

El usuario deberá ingresar cada tanto a la pantalla "Monitor de Importación de Informes" y verificar si el archivo sigue en estado "Procesando" o si ya finalizó mostrará el estado: "Finalizado". Una vez generado el archivo además de pasar su estado a "Finalizado" mostrará un banner en la parte superior de la consola de Promo (si se encuentra en una pantalla diferente a "Monitor de exportación de informes") indicando "Se encuentra/n listo/s (mostrará la cantidad de archivos que cambiaron a estado "Finalizado") reporte/s para ser descargado/s en el Monitor de exportación de Informes".

Una vez que el usuario haya presionado el botón "Exportación Masiva" sobre un informe, ese botón se deshabilitará hasta que el archivo termine de generarse. Si el usuario presiona el botón "Exportación Masiva" en otro informe, se generarán al mismo tiempo los dos archivos. Todos los archivos en estado Procesando, o en estado Finalizado solicitados por el usuario logueado que todavía no hayan sido eliminados por el job que los depura se mostrarán en la pantalla "Monitor de Exportación de Informes".

Por default una vez al día se ejecutará un proceso que eliminará todos los archivos que hayan estado en estado "Finalizado" por 24 horas (o sea la persona que solicitó el archivo lo tuvo disponible durante 24 horas). Una vez eliminados no se verán más en la pantalla "Monitor de exportación de informes". 


Importante

Si presiona el botón "Exportación Masiva" y el sistema le muestra el mensaje genérico: por favor comuníquese con el administrador, y no pasa a la pantalla "Monitor de Exportación de Informes", es porque el administrador del sistema debe configurar la ruta de exportación masiva de reportes.





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.


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.


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


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

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

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




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 arrastrarse hasta los signos MAS ("+") que se encuentran en el centro de la pantalla con el formato de visualización elegido anteriormente.

Se cuenta con los botones "Volver" 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 "Resent" se borraran las selecciones realizadas hasta el momento y por último 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 Tarjetas Activadas: Gráfico de barras donde se muestre la cantidad de Tipos de Tarjetas Activadas.
  • 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 tarjeta. Requerido
typestringTipo de tarjeta a la que pertenece la tarjeta. Requerido
valodFromstringValido desde: Deberá completarse en caso de que el tipo de tarjeta al que pertenece la tarjeta 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 tarjeta al que pertenece la tarjeta 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 de tarjeta al que pertenece la tarjeta a dar de alta indique "CVV requerido". (Campo numérico, largo máximo 5 dígitos)
customerstringCliente asociado a la tarjeta. deberá completarse con el Código, que se puede ver en la pantalla "Gestión de Clientes".
amountstringMonto a asignar a la tarjeta. Si su tipo indica que es precargada por archivo, este campo es requerido.


Ejemplo de registros del catalogo para Tarjetas:

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



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

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

9Tarjetas de fidelidadcard.nominated.default.optionNo

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

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

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

30Promovalidate.autocomplete.existing false

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

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

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

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

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

47Promocustomer.requiredfalse

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

48PromodateTime.requiredfalse

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

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

Directorio para almacenamiento de imagenes de competidores

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

Directorio para almacenamiento de imagenes de precios publicados de competidores

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

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

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

Habilita la edición de promociones vencidas

73PromodeployedEditable.enabledfalseHabilita la edición de promoción con el estado Deployed.
74PromodateEditableIfActivetrue

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

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

Recortar mensage para a impresora.

77Promopromo.name.codefalse

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

78Promopromotion.codeKeyfalse

Campo código de promoción clave

79Promopromotion.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.
80Promopromotion.images.height250Promociones: alto default de las imagenes
81Promopromotion.images.pathC:/synthesis/promo/images/promotion/Promociones: directorio para almacenamiento de imágenes
82Promopromotion.images.width250Promociones: ancho default de las imagenes
83CuponesrabbitMQ.couponHistory.endpointName

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

84PromorabbitMQ.cardhistory.endpointName

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

85PromorabbitMQ.producer.manual.promotion.enabled

Habilitar el posteo manual de datos desde la promoción

86PromorabbitMQ.SSL.enabledfalse

Activar SSL

87PromorabbitMQ.enabledtruePropiedad que indica si está habilitado rabbitMQ
88PromorabbitMQ.endpointName


Nombre de la cola de rabbitMQ

89PromorabbitMQ.host

Dirección (host) del RabbitMQ server

90PromorabbitMQ.limitstatus.endpointName

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

91PromorabbitMQ.password

Password para acceder al rabbitMQ

92PromorabbitMQ.port

Puerto del server rabbitMQ

93PromorabbitMQ.producer.SSL.enabledfalse

Activar SSL para el posteo de datos

94PromorabbitMQ.producer.enabledfalse

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

95PromorabbitMQ.producer.host

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

96PromorabbitMQ.producer.password

Password para acceder al RabbitMQ server para el posteo de datos

97PromorabbitMQ.producer.port

Puerto del RabbitMQ server para el posteo de datos

98PromorabbitMQ.producer.uri

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

99PromorabbitMQ.producer.username

Usuario para acceder a RabbitMQ server para el posteo de datos

100PromorabbitMQ.producer.virtualHost

Virtual Host RabbitMQ server para el posteo de datos

101PromorabbitMQ.promotion.endpointName

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

102PromorabbitMQ.uri

URI de conexión completa rabbitMQ

103PromorabbitMQ.username

Usuario para acceder al rabbitMQ

104PromorabbitMQ.virtualHost

virtual Host al rabbitMQ

105PromoreportParticipantsfalsePromociones: valor global que determina si la promoción informa participantes
106PromoreportParticipantsVisibletrueDetermina si se visualiza o no, la opción reportar participantes
107PromobankRefundBenefit.method.of.paymentNOTHING=No calcular promociones por medio de pago

Reintegro bancario: Opciones de cálculo de reintegro

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

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

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

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

110PromobankRefundBenefit.method.of.payment.onItemsPaid.tenderMethodPropertyKey

promo.configuration.tenderMethod.itemMethod

Reintegro bancario: Propiedad basada en items a utilizar

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

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

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

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

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

Reintegro bancario: Propiedad basada en pagos a utilizar

114Promomethod.of.paymentNOTHING=No calcular promociones por medio de pagoPromocion Codificada: NOTHING, ON_ITEMS_PAID, ON_PAYMENT_MADE
115Promomethod.of.payment.onItemsPaid.classcom.synthesis.promo.engine.partialPayment.hardcoded.promotion.PartialPaymentsGSPromotionPromocion Codificada: nombre de la promoción por medio de pago basada en ítems.
116Promomethod.of.payment.onItemsPaid.namePromociones basadas en itemsPromocion Codificada: nombre de la promoción por medio de pago basada en ítems.
117Promomethod.of.payment.onItemsPaid.tenderMethodPropertyKeypromo.configuration.tenderMethod.itemMethodPromocion Codificada: nombre de la promoción por medio de pago basada en ítems.
118Promomethod.of.payment.onPaymentMade.classPartialPaymentsSSPromotionPromocion Codificada: nombre de la promoción por medio de pago basada en ítems.
119Promomethod.of.payment.onPaymentMade.namePromociones basadas en pagosPromocion Codificada: nombre de la promoción por medio de pago basada en ítems.
120Promomethod.of.payment.onPaymentMade.tenderMethodPropertyKeypromo.configuration.tenderMethod.paymentMethodPromocion Codificada: nombre de la promoción por medio de pago basada en ítems.
121PromoldapAuthenticationfalseDetermina si se autentica contra un Directory Service


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

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

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

140PromorequestMap.catalog.channel.importationDetail - contunueOnErrortrue

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

141PromorequestMap.catalog.creditCampaignCode.importationDetail - contunueOnErrortrue

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

142PromorequestMap.catalog.customer.importationDetail - contunueOnErrortrue

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

143PromorequestMap.catalog.customerType.importationDetail - contunueOnErrortrue

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

144PromorequestMap.catalog.eventTransaction.importationDetail - contunueOnErrortrue

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

145PromorequestMap.catalog.eventTransactionType.importationDetail - contunueOnErrortrue

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

146PromorequestMap.catalog.family.importationDetail - contunueOnErrortrue

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

147PromorequestMap.catalog.format.importationDetail - contunueOnErrortrue

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

148PromorequestMap.catalog.infoFinancial.importationDetail - contunueOnErrortrue

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

149PromorequestMap.catalog.item.importationDetail - contunueOnErrortrue

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

150PromorequestMap.catalog.itemStock.importationDetail - contunueOnErrortrue

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

151PromorequestMap.catalog.level1.importationDetail - contunueOnErrortrue

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

152PromorequestMap.catalog.paymentBank.importationDetail - contunueOnErrortrue

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

153PromorequestMap.catalog.paymentCode.importationDetail - contunueOnErrortrue

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

154PromorequestMap.catalog.paymentPrefix.importationDetail - contunueOnErrortrue

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

155PromorequestMap.catalog.paymentType.importationDetail - contunueOnErrortrue

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

156PromorequestMap.catalog.profileCode.importationDetail - contunueOnErrortrue

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

157PromorequestMap.catalog.store.importationDetail - contunueOnErrortrue

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

158PromorequestMap.catalog.storeChain.importationDetail - contunueOnErrortrue

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

159PromorequestMap.catalog.subCategory.importationDetail - contunueOnErrortrue

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

160PromorequestMap.catalog.subZone.importationDetail - contunueOnErrortrue

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

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

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

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

Habilita la acción descargar contingencia en todo momento

165Lista de preciospriceList.job.cleanPriceListSchedule.time30Cantidad de días a mantener los ítems de la lista de precios futuros procesados
166Lista de preciospriceList.lockForUpate15Minutos para poder desbloquear Lista cero en el proceso rest
167Lista de preciospriceList.mongo.bulk.insertOrUpdate200Cantidad de registros a insertar por lote en el proceso rest
168Lista de preciospriceList.distribution.print.before300

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

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

10

Cantidad de hilos creados para la distribución simultánea
173Promoscheduled.enabledfalseGeneración y distribución programada de mapas
174Promoscheduled.filter.enablefalse

Filtrar promociones por tienda para la distribución programada

175Promoscheduled.mapVersiontrue

Incrementar la versión del mapa para la distribución programada


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 no se importaran ya que no 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 una tarjeta 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 tarjeta 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 AUDITORIAS

PROMO permite llevar un control de auditorias filtrando por fecha desde y hasta, por un tipo de usuario, dependiendo el módulo y la operación o acción realizada.

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 Tarjeta de Fidelidad.


(A partir de Promo 7.0.18) Si se eliminan los datos de un cliente, ya sea por pantalla, total o parcial o por servicio rest: En auditoría van a quedar registrados los datos básicos del cliente eliminado, por ej. el día 02/06/2021 (DD/MM/AAA) y la hora en que se pidió la eliminación, el usuario que la realizó, el módulo desde donde se realizó y si fué eliminación Total (DELETE) o Parcial (PARTIAL_DELETE).

Si se ingresa al detalle con el logo del libro mostrará en la Cabecera el Nombre y Apellido del usuario que realizó el borrado. Mostrará si la operación que realizó fue DELETE o PARTIAL_DELETE, la fecha y hora en que se eliminó. Debajo del título ACTUAL mostrará cómo quedaron los datos relacionados con el cliente eliminado. Se mostrará el código de Promo relacionado con el cliente eliminado y si se seleccionó el borrado Total se eliminan los datos del cliente y todos sus datos de fidelidad relacionados (todos los cupones y tarjetas asociados a ese cliente). 

El registro de auditoría se mostrará de la siguiente manera:


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:


Asociación de catálogos a nuevos atributos:

Al momento de dar de alta un nuevo atributo para un elemento, se podrá asociar un catálogo para agilizar la carga de datos para la definición de promociones.

            • El nombre del archivo será: catalog"Atributo".catalog
            • El formato del archivo será: code|description


El catálogo podrá cargarse de manera manual desde Administración >> Importación de catálogos o de manera automática por medio del job.

            • 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: Podrán asignarse las tiendas a las cuales tendrá acceso el usuario para el módulo de Listas de Precio.


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:

Módulo (categoría)Ítem (Sub categoría)Sub ítemQué habilita?Activo en Roles por default
Dashboard (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
Tarjetas
Permite ver el Dashboard de TarjetasAdministrador
Permite modificar el Dashboard de TarjetasAdministrador
Creados x usuario
Permite ver los Dashboards creados por el usuarioAdministrador
Permite modificar los Dashboards creados por el usuarioAdministrador
Operació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
WorkflowWorkflow
Permite ver el listado de workflowsAdministrador, Operador
Permite crear un nuevo workflow,  agregar y eliminar pasosAdministrador
Permite editar un workflowAdministrador
DistribuciónMapas (POS)
Habilita ver el  listado de mapas, realizar búsquedas, y ver el resumen.Administrador, Operador
Permite descargar el mapaAdministrador
Permite distribuir un mapa, publicarlo a las tiendasAdministrador
Permite editar , y definir.Administrador
Permite crear nuevos mapas, Copiar mapaAdministrador
Simulación
Permite visualizar la simulaciónAdministrador, Operador
Edición, definiciónAdministrador, Operador
SimularAdministrador, Operador
Permite crear, ver el listado, editar y definir simulacionesAdministrador, Operador
Redes Sociales
Permite ver el listado de promociones a ser publicadas en redes sociales.Administrador, Operador
Permite publicar la promoción en las redes sociales y ver un resumen de las publicacionesAdministrador
PreciosListas 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
FidelidadPlantillas de cupón
Permite ver el listado de plantillas de cupón disponibles y utilizar los filtros de búsquedaAdministrador, Operador
Habilita la creación de nuevas plantillas de cupónAdministrador
Habilita la edición de plantillas existentesAdministrador
Tipos de cupones
Permite ver el listado con los tipos de cupones existentes, utilizar los filtros de búsqueda, ver el resumen, las promociones asociadas y previsualizar.Administrador, Operador
Permite crear tipos de cuponesAdministrador
Permite editar, copiar y definir tipos de 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 tarjetas de fidelidad
Permite ver el listado de tipos de tarjetas de fidelidad, realizar las búsquedas y ver el resumenAdministrador, Operador
Habilita la creación, edición y copia de tipos de tarjetas de fidelidadAdministrador
Habilita la creación, edición y copia de tipos de tarjetas de fidelidad
Tarjetas de fidelidad
Permite realizar búsquedas de tarjetas de fidelidadAdministrador, Operador
Permite dar de alta de forma masiva tarjetas y ver el informe con los resultados o el detalle de errores y permite cancelarAdministrador
Permite modificar y transferir saldo de tarjetas de fidelidad
Permite activar tarjetas de fidelidadAdministrador
Ver movimientos de tarjetasAdministrador, Operador
Convenio
Permite ver el listado de convenios existentes y realizar búsquedasAdministrador, Operador
Permite crear un nuevo convenio o editar uno existenteAdministrador
Clientes

Permite ver el listado de cliente, realizar búsquedas, ver el detalle del cliente y los cupones y tarjetas asociados

Eliminar datos del cliente (a partir de versión 7.0.18)

Administrador, Operador


Administrador

InformesPromociones/MapasPromociones-VigentesHabilita el Informe Promociones-vigentesAdministrador, Administrador de Negocio, Operador
PromocionesHabilita el Informe PromocionesAdministrador, Administrador de Negocio, Operador
Promociones por SKUHabilita Informe Promociones por SKUAdministrador, Administrador de Negocio, Operador
Mapas (POS)Habilita Informe Mapas (POS)Administrador, Administrador de Negocio, Operador
Límites por promociónHabilita Informe > Promociones/Mapas > Limites por promocionesAdministrador, Administrador de Negocio, Operador
Historial de LímitesHabilita el Informe Historial de LímitesAdministrador, Administrador de Negocio
Distribución: Redes SocialesHabilita el Informe Distribución en redes socialesAdministrador, Administrador de Negocio, Operador
Distribución: TiendasHabilita Informe > Promociones/Mapas > Distribución: TiendasAdministrador, Administrador de Negocio
TransaccionesIndicadores OperacionalesHabilita el Informe Indicadores operacionalesAdministrador, Administrador de Negocio
Detalle de TransacciónHabilita el Informe Detalle de transacciónAdministrador, Administrador de Negocio
Ranking de ClientesHabilita el Informe Ranking de ClientesAdministrador, Administrador de Negocio
Transaccional de LímitesHabilita el Informe Transaccional de límitesAdministrador, Administrador de Negocio
Errores 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
TarjetasTipos de Tarjetas de Fidelidad
Administrador, Administrador de Negocio, Operador
Tarjetas de Fidelidad
Administrador, Administrador de Negocio
Puntos/ Montos Vencidos
Administrador, Administrador de Negocio
Tarjetas sin MovimientosHabilita Informe > Tarjetas > Tarjetas sin movimientosAdministrador, Administrador de Negocio
Extracto de Puntos/ MontosHabilita Informe > Tarjetas > 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
NegocioTiendas
Habilita ver el  listado de Tiendas y realizar búsquedasAdministrador, Administrador de Negocio
Permite editar tiendas.Administrador, Administrador de Negocio
Permite crear, activar o desactivar tiendas. Agregarles, modificar o eliminar conexión y asociarles motores.Administrador, Administrador de Negocio
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
Administració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
SeguridadAdministración de Usuarios
Habilita la visualización y búsqueda del Listado de UsuariosPrincipal, Administrador
Permite crear y editar usuarios, cambiar contraseñas, habilitar y deshabilitar usuariosPrincipal, Administrador
Configuración de Roles
Crear, editar, eliminar.Principal
Listar y configurar accesos.Administrador (si hay 1 sola compañía*), Principal
AlarmasConfiguración
Habilita la visualización del listado de alarmas y búsqueda y ver el detalleAdministrador, Operador
Permite crear y desactivar alarmasAdministrador
Notificaciones
Permite ver el listado de notificaciones de alarmas, realizar búsquedas y ver el detalleAdministrador
Permite confirmar las notificaciones.Administrador
SoporteInicializar 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
OtrosMonitor 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 transacción: Controla que los montos que se modifican desde la consola para una tarjeta de fidelidad en una sola operación, no alcancen o superen los valores definidos en la alarma.

>> Modificación de saldo por período: Controla que los montos que se modifiquen desde la consola  para una tarjeta 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  una tarjeta 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:  Evalúa e informa en caso de que en una transacción se registre la aplicación de un beneficio que deja al item beneficiado por debajo del valor de costo informado por el pos.

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

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. (a partir de Promo 7.0.2)


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 worflows 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 Super Usuario 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:


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, requiera o no 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.





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.

(a partir de Promo 7.0.11)


(a partir de Promo 7.1)


Inicializar configuraciones

Desde esta sección se podrán resetear los permisos y configuraciones de la consola.

La pantalla que se mostrara cuando se presione en "Reset de configuraciones" será la siguiente:

Se permitirá realizar el Reset de las configuraciones en la consola de PROMO, volviendo a la configuración por default de las variables de configuración del sistema.

También se podrán resetear los permisos de acceso volviendo esta configuración a default.


Gestor de backups de BBDD

El gestor de backups permite generar copias de seguridad de todas las acciones que se generan dentro de la consola de la compañía, estas copias se realizaran una vez por día a las 00.00hs.

Desde la siguiente ventana podrán restaurarse los backups generados en caso de ser necesario.


Estado del Motor o Estado del Sistema

Podrá visualizarse el estado de los motores que se reporten a la consola de PROMO desde la sección "Estado del Motor". (A partir de 7.0.11 "Estado del Motor" pasa a llamarse "Estado del Sistema").

Se presentara la siguiente pantalla:


En ella podrá visualizarse el estado de la comunicación con el motor, su ultima comunicación, su ID, nombre, con que mapa esta operando, y en que tienda. Así como también la vigencia del mapa informado.

En caso e 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.


A partir de la versión 7.0.11 "Estado del Sistema" mostrará la siguiente pantalla:

En esta versión de Promo se agrega el filtro "[Componente]" para seleccionar si se quiere ver en pantalla las "Consolas" o los "Motores". Se agrega la columna "Componente" donde 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.

El Excel mostrará esa nueva columna con el título: Consola, y el contenido será true o false.



 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"


Configuración de Motores

(Opción Configuración de Motores a partir de Promo v7.1)

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

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


No se visualiza en forma correcta PROMO en el browser

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

Internet Explorer, versión 11

Firefox, versión 1

Chrome


No puedo ingresar a la consola con mi usuario

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


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

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

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

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

Wildfly

MongoDB

PromoSimEngine


No se muestran cupones, tarjetas y puntos vencidos

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


No se pueden realizar simulaciones desde la consola

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




 Apéndice II

Sugerencias de Promociones


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

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

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


Sugerencia Inteligente

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

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

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

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

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

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



 Apéndice III


Promociones por medio de pago

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

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

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

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

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

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

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

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

NOTA

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



Codificadas de medios de pago

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

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

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

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

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

PAGO Informado por el canal (Ej.: POS)

PLAN DE PAGO definido en la promoción

Código

Medio de Pago

Cuotas

Cuotas

Tipo

Tipo

Plan

Plan

Prefijo

Prefijo



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

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

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

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

Configuración de Codificadas de medios de pago

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



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


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


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

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

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

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

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

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




 Apéndice IV

 Consideraciones - Modulo de Fidelidad


Prefijo de Cupón Autogenerado

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


Formato de Código de Barras

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

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

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


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


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

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

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


Ejemplo 1:

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

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



Ejemplo 2:

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


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

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

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


Reverso de Elementos de Fidelidad

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

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

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

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

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

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

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

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


Procesar Cupones Electrónicos

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

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


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

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



 Apéndice V

Configuración de Chequeo de Colisiones

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

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

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



 Apéndice VI


Consideraciones - Alta Masiva de Promociones


 Campos asociados a la cabecera de la promoción

Variables en la Cabecera de la promoción


Sección

Campos que admiten asignación de variables

Detalles



Cabecera de la promoción



Descripción de la promoción

Mensaje del POS

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

name

code

workflow

campaign

deploymentChannels

promotionType

promotionSubType

promotionApplicationForm



Campos asociados a la cabecera de la promoción

Nombre del campo (visible al usuario)

Nombre interno

Detalles (valores esperados/Formatos)

Nombre de la promoción

name

Alfanumérico

Código de la promoción

code

Alfanumérico

Workflow

workflow 

Nombre del workflow

Ejemplo: 

Workflow general

Campaña

campaign

Nombre de la campaña

Ejemplo: 

BLACK FRIDAY

Canales de publicación

deploymentChannels

Elemento tipo lista

Se deberá separa con coma(,) para indicar varios elementos.

Código de los canales de publicación. Opciones disponibles:

pos

twitter

facebook

Ejemplos: 

pos

twitter,facebook

Atributos de la cabecera

hdrFlds

Alfanumérico

Tipo de promociones

promotionType

Código del tipo de promoción

Sub-tipo de promociones

promotionSubType

Código del subtipo de promoción

Forma de aplicación de promociones

promotionApplicationForm

Código de forma de aplicación


Condición de Rango Horario

Variables en Condiciones por Rango horario

Sección

Campos que admiten asignación de variables

Detalles

Condiciones por rango horario

No admite asignación de variables

Solo tomará como variables las condiciones agregadas por el usuario, es decir: si el usuario agrega una condición por Hora, se agregara el excel la columna con la cabecera Condición de hora



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

Nombre del campo (visible al usuario)

Nombre interno

Detalles (valores esperados/Formato)

Condición  de fecha con hora

dateTimeRanges

Elemento tipo lista

Al indicar varias condiciones de fecha con hora se deberá separar con coma ( , )

Ejemplos:

13/05/2020 09:00

30/05/2020 10:30 - 02/07/2020 02:30, 01/07/2020 09:00 - 01/09/2020 18:15

Condición de hora

hourRanges 

Elemento tipo lista

Al indicar varias condiciones de hora se deberá separar con coma ( , )

Ejemplos:

08:00-18:00

14:00-19:15, 10:00-13:15

Condición por periodicidad

frequency

Para el caso de periodicidad por semana, se debe indicar entre paréntesis los días de la semana 1 = Domingo, 2: Lunes, 3: Martes y así sucesivamente.

Ejemplos:

Aplicada a periodicidad por días:
31/03/2020 3d

Aplicada a periodicidad por semanas:
31/03/2020 3s(1,2)



CONDICIONES SIMPLES


Variables en Condiciones simples

Sección

Campos que admiten asignación de variables

Detalles

Condiciones simples

Todos los elementos con auto-complete sin restricciones por catálogo

Excepción en el elemento tipo en Cupones y Tarjetas de fidelidad ya que valida que los tipos exista antes de insertarlo.





Condiciones por COMPOSICIÓN

Variables en Condiciones por composición

Sección

Campos que admiten asignación de variables

Detalles

Condiciones por combo

No admite asignación de variables

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

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


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

Nombre del campo (visible al usuario)

Nombre interno

Detalles (valores esperados/Formato)

Límite de aplicación         

limit

numérico entero

Ocurrencias mínimas

min

numérico entero

Ocurrencias máximas

max

numérico entero


Unidad de medida


elementSetTypeMeasureUnitAttribute

Alfanumérico.

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

qty → Cantidad

magnitude → Magnitud

xprice → Precio Total


Alfanumérico.

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

qty → Cantidad

amount → Monto

Alfanumérico.

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

points → Puntos

amount → Saldo

Alfanumérico.

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

amount → Monto

Alfanumérico.

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

amount → Monto


Criterio de ordenamiento


conditionComboCriteriaOrder

Alfanumérico.

Código asociado al criterio de ordenamiento.

MoreExpensiveFirst → Los mas caros primero

OneMoreExpensive → Uno mas caro por condición

LessExpensiveFirst → Los mas baratos primero

OneLessExpensive → Uno mas barato por condición


Criterio de equivalencia





elementSetTypeEquivalenceAttribute

Alfanumérico.

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

level3Categoría

level4 → Sub Categoría

codeCódigo (SKU)

unitprice → Precio unitario

brand → Marca

supplier → Proveedor

level1 → Departamento

level2Familia

discountableDescontable

Alfanumérico.

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

id → Id

type → Tipo

qty → Cantidad

amount → Monto

Alfanumérico.

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

type → Tipo

profileCode → Perfil de cliente

creditCampaignCode → Campaña crediticia

Alfanumérico.

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

id → Código

type → Tipo

bank → Banco

plan → Plan

installments → Cuotas

itemamount → Monto del Ítem

prefix → Prefijo

payCreditCampaign → Campaña crediticia

prefixGroup → Grupo de Prefijos

pocket → Bolsillo

Alfanumérico.

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

type → Tipo

contract → Convenio


Criterio de inequivalencia





elementSetTypeInequivalenceAttribute






Alfanumérico.

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

code → Código (SKU)

unitprice Precio unitario

brand → Marca

supplier  → Proveedor

level1 → Departamento

level2 → Familia

level3 Categoría

level4  → Sub Categoría

discountable →  Descontable

qty Cantidad

magnitude →   Magnitud

xprice → Precio total

redeemOption Opción de canje de puntos 

Alfanumérico.

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

id → Id

type → Tipo

qty → Cantidad

amount → Monto

Alfanumérico.

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

type → Tipo

profileCode → Perfil de cliente

creditCampaignCode → Campaña crediticia

Alfanumérico.

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

id → Código

type → Tipo

bank → Banco

plan → Plan

installments → Cuotas

amount → Monto

itemamount → Monto del Ítem

prefix → Prefijo

payCreditCampaign → Campaña crediticia

prefixGroup → Grupo de Prefijos

pocket → Bolsillo

Alfanumérico.

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

type → Tipo

contract → Convenio



Beneficios


Variables en Beneficios

Sección

Clase y Tipo de beneficio

Campos que admiten asignación de variables

Detalles





Beneficios

Monetario - Canje de cupón calculado

No admite asignación de variables

Tomará como variables para el excel todos los campos asociados a la clase y tipo de beneficio

Monetario - Beneficio externo

Tipo

Adicionalmente tomará como variables para el excel todos los campos asociados a la clase y tipo de beneficio

Monetario - Canje con opciones





No admite asignación de variables



Tomará como variables para el excel todos los campos asociados a la clase y tipo de beneficio

Monetario - Descuento fijo

Monetario - Descuento porcentaje

Monetario - Nuevo precio

Monetario - Canje de puntos

Monetario - Descuento por convenio

No monetario - Coeficiente de fidelización

Otorgar puntos de tipo


Adicionalmente tomará como variables para el excel todos los demás campos asociados a la clase y tipo de beneficio.


No monetario - Cupón

De tipo/identificador

No monetario - Cupón calculado

No admite asignación de variables

Tomará como variables para el excel todos los campos asociados a la clase y tipo de beneficio

No monetario - Plan de pagos

Otorgar el plan de pagos

Para tipo de pago

Con medio de pago

Cuotas

Del banco

Prefijo

Cuotas a mostrar en el POS

Bolsillo








Adicionalmente tomará como variables para el excel todos los demás campos asociados a la clase y tipo de beneficio.



No monetario - Porcentaje de fidelización

De tipo

No monetario - Puntos de fidelización

De tipo

No monetario - Regalo

Con ID de regalo

Y tipo de regalo

No monetario - Reintegro bancario

Otorgar el plan de pagos

Para tipo de pago

Con medio de pago

Cuotas

Del banco

Prefijo 

Campos genéricos del Beneficio

Cuenta contable

Mensaje en POS        

Mensaje en impresora 

Mensaje en TLOG


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

Tipo de Beneficio

Clase de beneficio

Nombre interno

Campos asociados al beneficio /Detalles (valores esperados/Formato)





Monetario

Canje de cupón calculado


Valores asociados a cada campo:

De tipo: alfanumérico. Código de cupón existente

Valor de recupero: numérico

Tipo de recupero: código del tipo de recupero. Opciones disponibles:

        • p → Porcentaje
        • → Monto fijo

Beneficio externo

ExternalBenefit

Valores asociados a cada campo:

Beneficio externo tipo: alfanumérico. Código del tipo

Valor del Recupero:  numérico

Tipo de Recupero: código del tipo de recupero. Opciones disponibles:

        • p → Porcentaje
        • a → Monto fijo


Canje con opciones


RedeemWithOptionsBenefit

Elemento tipo lista

Cada opción debe estar contenido entre corchetes ([]), separando un limite de otro con coma (,)

Valores asociados a cada campo:

Beneficio a aplicar: Opciones disponibles:

        • percentageDiscount → Descuento porcentaje
        • fixedDiscount → Descuento fijo
        • newPrices → Nuevo precio

El siguiente porcentaje/ monto/ precio: numérico

Por cada unidad de: Opciones disponibles:

        • qty → Cantidad
        • magnitude → Magnitud
        • na → Todo

Puntos cliente: numérico entero

Tipo de Tarjeta de Fidelidad: alfanumérico. Código de tarjeta de fidelidad existente (campo opcional)

Puntos de Tarjeta de Fidelidad: numérico (campo opcional)

Formato:

[beneficio a aplicar, el siguiente porcentaje/monto/precio, Por cada unidad de, puntos cliente, Tipo de tarjeta de fidelidad (opcional), Puntos de tarjeta de fidelidad(opcional)]

Ejemplos:

[fixedDiscount, 50, qty, 100]

[newPrices, 550, qty, 300],[percentageDiscount, 10, qty, 50, tipo_001, 300]

Canje de puntos por CatalogoCatalogRedeemBenefit

Valores asociados a cada campo:

Tipo de Tarjeta: alfanumérico. Código de tarjeta de fidelidad existente.

Valor del Recupero: numérico

Tipo de Recupero: código del tipo de recupero. Opciones disponibles:

          • → Porcentaje
          • a → Monto fijo

Descuento fijo

FixedDiscount

Valores asociados a cada campo:

El siguiente monto: numérico

Por cada unidad de: código de unidad de medida. Opciones disponibles:

        • qty → Cantidad
        • magnitude → Magnitud
        • na → Todo

Valor del Recupero: numérico

Tipo de Recupero: código del tipo de recupero

        • → Porcentaje
        • → Monto fijo


ContractPercentageDiscount

Valores asociados a cada campo:

El siguiente porcentaje (%): numérico

Por cada unidad de: código de unidad de medida. Opciones disponibles:

        • qty → Cantidad
        • magnitude → Magnitud
        • na → Todo

Balance:

        • balance1 → Balance 1
        • balance2 → Balance 2

Descuento por porcentaje

PercentageDiscount

Valores asociados a cada campo:

El siguiente porcentaje: numérico

Por cada unidad de: código de unidad de medida. Opciones disponibles:

        • qty → Cantidad
        • magnitude → Magnitud
        • na → Todo

Valor del Recupero: numérico

Tipo de Recupero: código del tipo de recupero. Opciones disponibles:

        • → Porcentaje
        • → Monto fijo

Nuevo precio

NewPrice

Valores asociados a cada campo:

El siguiente precio ($): numérico (entero)

Por cada unidad de: código de unidad de medida. Opciones disponibles:

        • qty → Cantidad
        • magnitude → Magnitud
        • na → Todo

Valor de Recupero: valor numérico (entero)

Tipo de Recupero: código del tipo de recupero. Opciones disponibles:

        • → Porcentaje
        • → Monto fijo

Canje de puntos


Valores asociados a cada campo:

Tipo de Tarjeta: alfanumérico. Código del tipo de tarjeta de fidelidad existente.

Factor $1 = x Puntos: numérico. Equivalente en puntos de 1 peso ($1 = factor puntos)


No monetario






Coeficiente de fidelizaciónFactorLoyaltyBenefit

Valores asociados a cada campo:

Otorgar puntos de tipo: alfanumérico. Código del tipo de tarjeta de fidelidad existente.

Con el siguiente factor: numérico.

Cupón

CouponBenefit

Valores asociados a cada campo:

Otorgar cupones (cantidad): número entero

De tipo/identificador: alfanumérico. Código del tipo de cupón existente.

Datos para el POS:  opciones disponibles:

        • → Indistinto
        • → Campo 1
        • → Campo 2

Cupón calculado

CalculatedCouponBenefit

Valores asociados a cada campo:

De tipo: alfanumérico. Código del tipo de cupón existente

Aplica a: opciones disponibles:

        • percentage → Porcentaje
        • fixedAmount → Monto fijo
        • externalAmount → Monto externo

Valor: numérico entero

Cantidad de Vouchers: numérico entero

Plan de pagosPaymentPlanBenefit

Valores asociados a cada campo:

Otorgar el plan de pagos: alfanuméricoCódigo del plan de pago.

Para tipo de pago: alfanumérico. Código del tipo de pago. Valida que el código exista en CatalogPaymentType.

Con medio de pago: alfanumérico. Código del medio de pago. Valida que el código exista en CatalogPaymentCode.

Cuotas: numérico.

Del banco: alfanumérico. Código del banco. Valida que el código exista en CatalogPaymentBank.

Monto límite: numérico

Prefijo: numérico. Rango de prefijo. Valida que el código exista en CatalogPaymentBank.

De (Descuento/Recargo): alfanumerico. Opciones disponibles:

        • na → Todo
        • discount → Descuento
        • surcharge → Recargo

Con un Porcentaje: numérico entero no mayor a 100

Del Bolsillo: Alfanumérico. Código del bolsillo. Valida que el código exista en CatalogPocket.

Porcentaje de fidelizaciónPercentLoyaltyBenefit

Valores asociados a cada campo:

Otorgar un porcentaje del precio en puntos: numérico entero

De tipo: alfanumérico. Código de tarjeta de fidelidad existente.

Puntos de fidelización

LoyaltyBenefit

Valores asociados a cada campo:

Otorgar puntos (cantidad): numérico

De tipo: alfanumérico. Código de tarjeta de fidelidad

Por cada unidad de: código de unidad de medida. Opciones disponibles:

        • qty → Cantidad
        • magnitude → Magnitud
        • na → Todo


RegaloGiftBenefit

Valores asociados a cada campo:

Otorgar regalos (cantidad): numérico

Con ID de regalo: alfanumérico. Id del regalo

Y tipo de regalo: alfanumérico. Código del tipo del regalo

Reintegro bancarioBankRefundBenefit

Valores asociados a cada campo:

Otorgar el plan de pagos: alfanuméricoCódigo del plan de pago.

Para tipo de pago: alfanumérico. Código del tipo de pago. Valida que el código exista en CatalogPaymentType

Con medio de pago: alfanumérico. Código del medio de pago. Valida que el código exista en CatalogPaymentCode

Cuotas: numérico.

Del banco: alfanumérico. Código del banco. Valida que el código exista en CatalogPaymentBank

Monto límite: numérico

Prefijo: numérico. Rango de prefijo. Valida que el código exista en CatalogPaymentBank

Con un Porcentaje: numérico entero no mayor a 100

Del Bolsillo: Alfanumérico. Código del bolsillo. Valida que el código exista en CatalogPocket


Campos genéricos del beneficio

Nombre del campo (visible al usuario)

Nombre interno

Detalles (valores esperados/Formato)

Atributos no genéricos asociados al tipo y clase de beneficio

--

Ver tabla 11

Información de aplicación

Aplicación máxima (valor)

maxApplicationValue

Numérico

Aplicación máxima (medida)          

elementSetTypeAttribute

Valores asociados:

qty → Cantidad

magnitude → Magnitud

xprice → Precio total

Descuento mínimo a aplicar

minApplicationValue

Numérico

Método de prorrateo

benefitDivisionMethod

Alfanumérico

Valores asociados:

proportional → Proporcional

most-expensive-first → Mas caros primero

cheapest-first → Mas baratos primero

Aplicar sobre...

benefitDivisionPrice


Alfanumérico

Valores asociados:

original-price → Precio original

benefited-price → Precio beneficiado

Criterio de ordenamiento

elementSetOrderCriteria

Alfanumérico

Valores asociados:

MoreExpensiveFirst → Los mas caros primero

LessExpensiveFirst → Los mas baratos primero

Limites de aplicación

Límites del beneficio

limits


Elemento tipo lista

Cada limite debe estar contenido entre corchetes ([]), separando un limite de otro con coma (,)

Valores asociados a cada campo:

Tipo de limite (limitScope): Código asociado al tipo. Opciones disponibles:

        • retailer → General
        • store → Tienda
        • customer → Cliente

Periodo a contabilizar (limitPeriod): Código asociado al periodo. Opciones disponibles:

        • undefined → indefinido

        • day → Días

Cantidad de Días (numberDays): número entero. Aplica solo si el periodo a contabilizar es Días (day).

Limitar por (limitTypeCode): Código asociado a las categorías de limites. Opciones disponibles:

        • benefitAmount → Cantidad de dinero
        • benefitApplicationCount → Cantidad de aplicaciones
        • benefiedProductCount → Cantidad de productos beneficiados

Valor (value): Numérico entero

Formato:

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

Ejemplos:

[store, day, 5, benefitAmount, 300]

[customer,undefined, 0, benefiedProductCount, 50],[retailer, day, 2, benefitAmount, 750]

Información adicional

Método de aplicación

benefitApplicationMethod

Alfanumérico

Valores asociados:

resume → Resumen

lineByLine → Linea a linea

Cuenta contable         

account

Alfanumérico



Proveedor del bien



creditProvider

Alfanumérico

Elementos separados con coma (,)

Valores asociados a cada campo:

Código: código del proveedor, valida que exista en catalogSupplier

Tipo de proporción: Código asociado al tipo. Opciones disponibles:

        • amount → Monto
        • percentage → Porcentaje

Monto/Porcentaje: numérico entero

Formato:

code, tipo de proporción, monto/porcentaje

Ejemplo:

0045,amount,50



Proveedor financiero



financialProvider

Alfanumérico

Elementos separados con coma (,)

Valores asociados a cada campo:

Código: código del proveedor, valida que exista en catalogSupplier

Tipo de proporción: Código asociado al tipo. Opciones disponibles:

        • amount → Monto
        • percentage → Porcentaje

Monto/Porcentaje: numérico

Formato:

code, tipo de proporción, monto/porcentaje

Ejemplo:

0033,amount,100

Mensaje en POS         

displayMessage

Alfanumérico

Mensaje de impresora

printerMessage

Alfanumérico

Mensaje en TLOG

tlogMessage

Alfanumérico




Casos Prácticos

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

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



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

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



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

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

code_proveedorTipo de importe (monto/proveedor) Valor numérico asociado al tipo de importe





 Apéndice VII - Promociones Modelo



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

Nueva Promoción






          • Dar clic en "Nueva Promoción".






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

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

NOTA

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


Definición de la Condición

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

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


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


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


Definición del Beneficio

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





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

NOTA

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



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


Resumen de la Promoción

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


NOTA

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


NOTA 2

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




"2 X 1 en Electrónica, todos los Jueves."

Nueva Promoción





          • Dar clic en "Nueva Promoción".






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

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


NOTA

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




Definición de la Condición

Habrá que definir una condición por rango horario, por periodicidad, para indicar que la promoción solo aplicara los días jueves.




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


          • Deberá definirse como ocurrencias mínimas y máximas, 2, indicando en unidad de medida, "Cantidad", ya que el subtiket tendrá solo 2 items del departamento de lácteos.
          • Por transacción solamente podrá cumplirse solo una vez la condición por composición por lo que el "Limite de Aplicación" se definirá en uno (1).


Luego de definir las ocurrencias, deberá de indicarse el atributo del producto que deberá considerarse para conformar la condición por composición, en este caso, "Departamento", igual a "Electrónica".


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



Definición del Beneficio

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





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



NOTA

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


 






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


Resumen de la Promoción

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


NOTA

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


NOTA

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




"Comprando una gaseosa, lleva las papas gratis"

Nueva Promoción





          • Dar clic en "Nueva Promoción"






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


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

NOTA

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



Definición de la Condición

La promoción deberá definirse por medio de dos condición por composición para que el motor genere subtickes, combinando ambos conjuntos de un ítem cada uno, a medida que se ingresen a la transacción y aplique sobre el conjunto de las papas, el beneficio que se defina.

Ambas condiciones por composición tendrán definidas sus ocurrencias mínimas y máximas en 1, indicando en unidad de medida, "Cantidad".

Para cada condición de composición deberá definirse su universo de aplicación, a la primera se le indicara el código de la gaseosa y a la segunda el código de las papas.


Presionar continua y Agregar la segunda condición por composición.



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

Definición del Beneficio

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





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


NOTA

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








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


Resumen de la Promoción

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


NOTA

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


NOTA 2

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




"Hamburguesas, Papas y Gaseosa a $15"

Nueva Promoción





          • Dar clic en "Nueva Promoción".






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


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

NOTA

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



Definición de la Condición

La promoción deberá definirse por medio de tres condiciones por composición para que el motor genere subtickes, combinando los tres conjuntos, de un ítem cada uno, a medida que se ingresen a la transacción y así se aplique sobre el conjunto de las papas el beneficio que se defina.

Las tres condiciones por composición tendrán definidas sus ocurrencias mínimas y máximas en 1, indicando en unidad de medida, "Cantidad".


Para cada condición de composición deberá definirse su universo de aplicación, a la primera se le indicara el código de la gaseosa y a la segunda el código de las papas. 


Presionar Continuar y Agregar la segunda condición por composición.



Presionar Continuar y agregar la última condición por composición.



Quedando conformada la condición de la siguiente forma:


Definición del Beneficio

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





          • Se definirá 15 como Nuevo Precio.
          • En el campo "Por Unidad de" deberá especificarse "Todo" con lo cual se estará indicando que todo el conjunto formado por las tres condiciones por composición tendrá el nuevo precio de $15.


NOTA

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


 





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


Resumen de la promoción

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


NOTA

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


NOTA 2

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



"Canje de Cupón Calculado en Perfumería"

Nueva Promoción





          • Dar clic en "Nueva Promoción".






          • La promoción aplicara en los puntos de venta.
          • En este caso la promoción no tendrá habilitadas las sugerencias.
          • La promoción Reportara Participantes a fin de que el pos identifique cual de los cupones ingresados, en caso de ser varios, participo de la promoción.


Definición de la Condición

La promoción deberá definirse por medio de Condiciones Simples que evalúen la existencia de un Cupón del tipo "Calculado" (para nuestro ejemplo será un Cupón del Tipo "3") y al menos un producto de la Familia "Perfumería".

Para ello agregaremos un elemento del tipo producto, en la condición Simple indicando que deberán de pertenecer a la Familia "Perfumería"



También se deberá indicar que en la transacción deberá ingresarse un cupón del tipo "calculado" (para nuestro ejemplo, Tipo de Cupón 3).



Quedando las condiciones definidas de la siguiente forma:

Cuando dentro del contexto de la transacción se cumpla con ambas condiciones simples, se accederá al beneficio definido en la promoción.


Definición del Beneficio

Deberá presionarse en "Nuevo Beneficio", y definirse un beneficio del tipo "Monetario", de la clase "Canje de Cupón Calculado".





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


Con esta definición se indicara que la promoción dará como beneficio el valor que tenga cargado en la base de datos el cupón ingresado.

NOTA

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




Resumen de la promoción

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

NOTA

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


NOTA 2

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




"Llevando 3 o más artículos del dto. Limpieza, gana un Cupón"

Nueva Promoción





          • Dar clic en "Nueva Promoción".





          • La promoción aplicara en los puntos de venta.
          • En este caso la promoción no tendrá habilitadas las sugerencias ni reportara participantes.


Definición de la Condición

La promoción deberá definirse por medio de una condición simple que evalúe la existencia de tres o más ítems del departamento de Limpieza.

Para ello agregaremos un elemento del tipo producto, en la condición Simple indicando que deberán de pertenecer al departamento de "Limpieza".



Sera necesario indicar un criterio de agrupación de los elementos del departamento de limpieza que se ingresen a la transacción, ya que deberá de cumplirse la condición de que haya 3 o mas items de este departamento para alcanzar a cumplir con la condición y acceder al beneficio.

Para ello, daremos clic en el icono del "Lápiz" que se encuentra a la derecha del elemento "Producto" y se nos mostrara el siguiente Pop Up.


Donde aquí se deberá de seleccionarse la opción "Mayor o Igual a" para agrupar los elementos.

Al hacerlo, se desplegaran las siguientes opciones:


En el pop up se especifica que el criterio de agrupación sera "Cantidad" "Mayor o Igual a" "3".

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


Definición del Beneficio

Deberá presionarse en "Nuevo Beneficio", y definirse un beneficio del tipo "NO Monetario", de la clase "Cupón".





          • En Otorgar Cupones (Cantidad) se deberá colocar un "1" lo que indicara que se otorgara un solo cupón cuando se cumplan las condiciones impuestas por la promoción.
          • En "De tipo/Identificador" se deberá especificar el tipo de cupón que se otorgara en este beneficio. El campo se autocompletara a medida que se vaya escribiendo, con los tipos de cupones ya cargados en la base y al seleccionarse una, en el campo se mostrara el ID del cupón seleccionado.


NOTA

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


 



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

Resumen de la promoción



          • En Otorgar Cupones (Cantidad) se deberá colocar un "1" lo que indicara que se otorgara un solo cupón cuando se cumplan las condiciones impuestas por la promoción.
          • En "De tipo/Identificador" se deberá especificar el tipo de cupón que se otorgara en este beneficio. El campo se autocompletara a medida que se vaya escribiendo, con los tipos de cupones ya cargados en la base y al seleccionarse una, en el campo se mostrara el ID del cupón seleccionado.


NOTA

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



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



"Compra 1 unidad y recibe el 10%dcto, si compras 2 recibe en la segunda unidad el 30%dcto, y si compras 3 recibe en la tercera unidad el 50%dcto aplica en la marca Coca- cola (el beneficio aplicara siempre sobre el item mas barato de la condición formada)"


Definicon de condicion 

Para este ejemplo de aplicación, deberá definirse la condición por medio de una condición por composición, ya que lo que se busca es que el beneficio escalonado itere y aplique las veces que sea posible, en base a los elementos ingresados en la transacción


Definicion de Beneficio

Deberá definirse un beneficio "Monetario" de la clase "Descuento por porcentaje". El valor a definir el el campo "El siguiente porcentaje (%) *" se indicara el valor de defecto que aplicara cuando no se cumpla con ninguno de los escalones definidos en el beneficio.



Definicion de Escalones

La "Unidad de escalonada" utilizada para este ejemplo será "Cantidad"


Al presionar "Continuar" se mostrara el primer escalón agregado de la siguiente forma:


Deberá presionarse nuevamente "Agregar" para definir el próximo.


Al presionar "Continuar" se mostrara el segundo escalón recién definido de la siguiente forma:


Deberá volver a presionarse "Agregar" para agregar el ultimo escalón de este ejemplo y se completara con los siguientes datos:

 


Al presionar "Continuar" quedaran los tres escalones definidos de la siguiente forma


En este caso, lo que se busca en esta promoción, es que al cumplirse cada uno de los escalones, se aplique el beneficio en uno solo de los ítems que componen cada escalón y que ese item sea el mas barato de los ítems que lo componen. Para ello, se deberá definir en el beneficio el campo "Aplicación máxima (valor)" en 1 y en el campo "Aplicación máxima (medida)" en cantidad, así como también indicar en el campo "Criterio de ordenamiento", "Los mas baratos primero".



" Compra 1 unidad y recibe el 10%dcto, si compras 2 recibe el 30%dcto, y si compras 3 recibe el 50%dcto aplica en la marca Coca- cola."


DEFINICON DE CONDICION 

Para este ejemplo de aplicación, deberá definirse la condición por medio de una condición por composición, ya que lo que se busca es que el beneficio escalonado itere hasta 3 veces (limites de aplicación = 3) y aplique las veces que corresponda, en base a los elementos ingresados en la transacción




DEFINICION DE BENEFICIO

La "Unidad de escalonada" utilizada para este ejemplo será "Cantidad"


Al presionar "Continuar" se mostrara el primer escalón agregado de la siguiente forma:


Deberá presionarse nuevamente "Agregar" para definir el próximo.


Al presionar "Continuar" se mostrara el segundo escalón recién definido de la siguiente forma:


Deberá volver a presionarse "Agregar" para agregar el ultimo escalón de este ejemplo y se completara con los siguientes datos:

 


Al presionar "Continuar" quedaran los tres escalones definidos de la siguiente forma


En este caso, lo que se busca en esta promoción, es que al cumplirse cada uno de los escalones, se aplique el beneficio de manera proporcional a todos los ítems que componen cada escalón, por tal motivo no se realizara ninguna restricción a nivel "Información de aplicación"



Apéndice VIII - Cache de Promociones

(desde 7.EP2)
El caché de Promociones tiene como objetivo generar información para los sitios de ecommerce donde para tener una navegación ágil se desea poseer la información de Promociones asociadas a los diferentes productos.

Para ésto Promo posee un proceso que evalúa las promociones y los productos asociados a la publicación en ecommerce.  Dicha información es generada como mensajes en una cola RabbitMQ de la cual los sitios pueden tomarlos. (mayor información en el formato de salida y configuración de la cola ver  PROMO - Manual de Integración 7.0 - Colas de Mensajes).

Configuración

Ingresando a Información de Configuración tenemos una serie de parámetros asociados a ésta funcionalidad que son:


Para el funcionamiento correcto se debe tener en cuenta que el cache es parte de la tienda (motor) que atenderá el sitio de ecommerce en la evaluación de Promociones para que exista una coherencia entre todas las instancias.  Con esto en vista debe configurarse a la tienda Web para que cuando se distribuya un mapa este también llegue al cache de Promociones para su evaluación.  Esto se realiza desde la definición de las tiendas como por ejemplo:

Operación

Una vez configurado, existe un proceso que se ejecutará automáticamente durante las primeras horas del dia para regenerar o refrescar la información del cache.  De todas formas en caso de ser necesario se puede ejecutar el proceso manualmente desde el mismo lugar donde se realiza la distribución de los mapas mediante el botón "Actualizar Cache".  Por ejemplo:








  • Sem rótulos