PROMO - Manual de Usuario 7.0 




CONTENIDO




Capítulo 1 - Acerca del manual


Propósito y alcance


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

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


Contenido



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

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

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

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

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

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

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

Capítulo 8– Módulo de Precios
Se describe la operatoria para la creación y administración de Listas de Precios.

Capítulo 9– Módulo de Fidelidad
Se describe la operatoria para la creación, edición y administración de los elementos de Loyalty (Cupones y 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 externo 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: 

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

Si quiere ver los dos registros anteriores deberá presionar la doble flecha que se encuentra a la izquierda. El sistema automáticamente modificará el valor del campo desde el cual realiza la búsqueda. 

Cuando se esté buscando a partir de 1 la doble flecha de la izquierda estará deshabilitada (si se pasa el cursor del mouse sobre ese botón mostrará el signo prohibido). Cuando se llegue al final de la lista la doble flecha de la derecha se deshabilitará (si se pasa el cursor del mouse sobre ese botón mostrará el signo prohibido). De esta forma se podrá navegar el informe viendo en pantalla a partir del registro indicado, la cantidad de registros ingresada. Como máximo se pueden ver por pantalla 1.000 (mil) registros.

IMPORTANTE

IMPORTANTE:

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

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




Capítulo 4 - Módulo de Dashboard


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

Los Dashboards en PROMO permitirán hacer un seguimiento del grado de aplicación y alcance de las distintas promociones, cupones y 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 venta 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 otorgados desde el punto de venta impactados 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 default, al instalar la consola se carga como ejemplo la campaña "BLACK FRIDAY", la cual podrá reutilizarse o desactivarse según se requiera.

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

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

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

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


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

Se deberán ingresar los siguientes datos:

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

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


IMPORTANTE

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



Condiciones Generales

Esta opción se encuentra dentro del menú "Operación" de la consola de PROMO y la misma permite definir condiciones donde se pueda indicar qué items quedan incluidos o excluidos en la evaluación de las promociones vigentes en el mapa que las contenga.

Estas "Condiciones Generales" serán incluidas dentro del mapa de Promo y será lo primero que el motor considerará, de forma tal que al evaluarse el contexto, los elementos incluidos en dichas condiciones sean incluidos o excluidos de la evaluación de promociones.

Las Condiciones Generales serían como un pre filtro que el motor de Promo va a analizar antes de ver si analiza el mapa o no, dependiendo de lo que se haya definido en las Condiciones Generales. 

Al dar clic en el ítem "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.

Importante

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

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

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


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 ítems, ya sean definidos por SKU, marca o cualquier otro atributo del producto, de la evaluación de promociones.

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

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

Nota

Podría darse el caso en que se excluya la marca Sony de la aplicación de promociones pero que alguna de las promociones del mapa que contiene esta Condición General aplique, por ejemplo, un 10% a PlayStation (marca=Sony).

SUPUESTO: En este caso, el cliente no se llevaría el descuento por haberse aplicado en primer termino la Condición General.


  • Por Cupones:

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

> Si en la transacción se ingresa el cupón con tipo "Distinto de" 111, no 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, no 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, no 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, no 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, no se evaluarán promociones.


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

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


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

Importante

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



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, detallados en Paginado

Menú Acciones

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

Estas acciones son:

  • Editar: Desde esta opción podrá accederse a la cabecera de la promoción. Solo estará disponible en caso de que la promoción este en estado "incompleta" o "completa".
     En caso de estar en estado "Distribuida", con la habilitación de edición dada por configuracion (deployedEditable.enabled = "true") también estará disponible la opción editar;                         independientemente de su vigencia (activas o vencidas).



         

         

       

          Cuando la variable de edición está en false y la promoción está activa (deployedEditable.enabled = "false") la promoción que está activa no se puede editar; pero si la que está vencida.



          

          

           


Nota - Límites de Promoción

    Este mismo comportamiento aplica para la edición de los límites de Promoción


  • 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 configuración (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".


IMPORTANTE

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


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

    Simples: son los requisitos que deben cumplirse para la obtención de un beneficio. Las condiciones simples se definirán por medio de elementos que pueden estar presentes dentro de una transacción como ser Productos, Cupones, Clientes, Eventos, Medios de pago, 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. 


Importante

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


Alta de Nueva Promoción

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


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 será único y se utilizara como llave para las búsquedas de promociones en los distintos filtros de la consola de Promo y de los informes.

En esta versión de Promo, se incorpora la posibilidad de indicar desde la configuración de la consola si el 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”).

 > Información de configuración en el filtro “Palabra a buscar”,promo.name.code", si se utiliza el nombre concatenado, ingresando óEl valor por defecto 

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.


Si un usuario tiene asociados todos los workflows  definidos en la consola

Al crear una nueva promoción, la consola traerá por default el Workflow General

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

En el caso que el usuario no tenga asociado el workflow general, al crear una nueva promoción, la aplicación mostrará por default el primer workflow que consiga para la compañía,


Lo mismo sucederá si el workflow general no tiene habilitada la opción "Aplica a Promociones"


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


Si un usuario tiene asociados todos los workflows  definidos en la consola

Al crear una nueva promoción, la consola traerá por default el Workflow General

En el caso que el usuario no tenga asociado el workflow general, al crear una nueva promoción, la aplicación mostrará por default el primer workflow entre de los existentes, ordenados alfabéticamente


Si por el contrario, el usuario no tiene asociado ningún workflow, al crear una nueva promoción, la consola mostrará por default el workflow general


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


Recomendación

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



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

Importante

Desde Administración\ Información de Configuración, se puede configurar que sea o no obligatorio la Validación de Vigencia de tipo de Cupón Vs Vigencia de la promoción.

Valida Fecha de vigencia del tipo de cupón contra la vigencia de la promoción. (Default=false)



    • Clientes:
          • Tipo: se puede utilizar para definir el tipo de cliente que integrará el conjunto (Ej.: empleado, cliente normal, cliente frecuente, etc.).
          • Id: se utiliza para definir el id o número de cliente que se desea integren el conjunto.
          • Monto restante: para promociones especiales en las cuales se necesite limitar el importe sobre el cual aplicar un X descuento, relacionado con el cliente que se haya ingresado en el ticket.
          • Segmento: Podrá indicarse si el cliente participante de la promoción que se define pertenece a algún segmento o rango de cliente en particular.
          • Perfil del Cliente: se utiliza para definir una categoría de cliente.
          • Campaña Crediticia: se utiliza para indicar la campaña que puede utilizar el cliente.
          • 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:

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

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

            • peso (para artículos que se pueden pesar: 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
      • Clientes
        • Puntos
        • Saldo
      • Medios de Pago
        • Monto del ítem
        • 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 ítems beneficiados.


      • 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 Ítem, Prefijo, Campaña Crediticia. Y en Criterios de inequivalencia se mostrarán las siguientes opciones: [indistinto], Monto del Ítem, Plan, Tipo, Banco, Monto, Prefijo, Código, Cuotas, Campaña Crediticia. 

No estará disponible la opción "Criterio de Ordenamiento" para el elemento "Medio de Pago"


Exportación a Excel de datos cargados en las condiciones

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

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

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

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


Definir Beneficios

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

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

Los beneficios se aplican sobre todo 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 presentará la pantalla "Nuevo Beneficio" en donde se mostrarán 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á deshabilitado.
  • Tipo de beneficio: Se refiere si el beneficio es Monetario o No Monetario. De este valor dependerá el comportamiento del beneficio.

Nota:

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


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


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

 

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


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


Beneficios Monetarios:


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

  • 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 será indispensable la definición de la condición por medio del elemento Beneficio Externo para que se aplique correctamente la promoción.


  • Beneficio:

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


De esta forma, cuando el POS envíe el elemento Beneficio Externo con el Tipo definido en "a" se aplicara el monto o porcentaje de descuento informado por el POS en el elemento "Beneficio Externo".

(Para mas información sobre la integración con el POS, ver Manual de Integración, Beneficios >> Beneficio Externo)


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


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 versión 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 opción que aplique el mejor descuento al contexto de la transacción. En caso de que el cliente no elija una opción, se otorgara la o las siguientes promociones que otorguen el mejor beneficio al contexto dado.


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 ítem desde el POS.

Esto podrá indicarse colocando un tilde en "Precio informado por el POS". Al hacerlo se deshabilita 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 ítems participantes. Puede aplicarse sobre cada unidad (sobre la cantidad o sobre la magnitud) o sobre todos los elementos del conjunto. Este beneficio dará un descuento porcentual y es obligatorio la definición de un limite, que 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.). Se puede observar un ejemplo en: Promociones con Descuento por Convenio

    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

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


Una vez definido el beneficio, podrá agregarse la promoción que lo contenga a un mapa y distribuirse a las tiendas que aplique.

Deberá definirse el catalogo en donde se indique Tienda, código de producto, puntos requeridos, valor del descuento y tipo de descuento respetando este 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 Productos de la marca Sony", y en la tabla se deberán indicar SKU que correspondan con la marca 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 código de tienda se asume que dicha opción de canje aplica para todas las tiendas.

Para el ejemplo dado, cuando en la tienda B320, se ingrese en una transacción un Ítem de la marca Sony, y este sea del code="2000", y en la transacción se encuentre también una tarjeta del tipo "555" con los puntos suficientes para realizar el canje según, en este caso "80", se aplacara un descuento fijo se $27 sobre el ítem code="2000"


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

    • 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



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 ítems y Promo, en base a la aplicación de este beneficio, indicara sobre que ítems 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 puede completar a mano con lo que desee.será un campo autocompletable por lo que irá mostrando la información a medida que escribe, si no está integrado con

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


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



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

IMPORTANTE.

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


Datos para el Pos

Al momento de seleccionar la clase "Cupón" se podrá indicar en el combo "Datos para el POS" si se envía información adicional al POS al momento de informar el beneficio.

Los nombres de las dos opciones a mostrar en el combo podrán definirse desde la sección de "Administración", "Información de configuración". El POS en base a estas opciones podrá realizar acciones especificas al momento de otorgar el beneficio Cupón y dependerá de como se implemente en el retail.

El campo "Datos para el POS", mostrará por default las opciones: "Indistinto" (siempre estará presente y de seleccionarlo no se indicará información extra al POS referente a los datos), 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.


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


IMPORTANTE

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


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

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

Cupón Calculado definido por MONTO FIJO:

Al seleccionarlo, se mostrará el campo "Monto Fijo" en donde deberá de ingresarse el número que representará el monto o valor con el que se emitirá el cupón al aplicar el beneficio.


Cupón Calculado definido por MONTO EXTERNO:

Al seleccionarlo, no se propondrá definir ni un monto ni un porcentaje, ya que ese dato será 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.


Importante

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


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


En los beneficios que otorgan puntos (factor, coeficiente y puntos de fidelización)existe  el campo "Ignorar pago con puntos".

Esta funcionalidad permitirá al POS gestionar la información necesaria para identificar, en caso de aplicar, cuando se esta otorgando un beneficio de canje de puntos al mismo tiempo que se otorga un beneficio que otorga puntos, y solamente otorgar los puntos que correspondan al pago 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á destildado (false) indicando que no se deberán acumularse puntos sobre los pagos que se realizaron con puntos.

Para los beneficios No Monetarios "Puntos", "Coeficiente" y "Factor" de Fidelización podrá indicarse que los puntos otorgados serán informados en el elemento "Cliente" y que la gestión de estos puntos no 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.

Información sobre 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 el planId de los paymentPlanList que trae la respuesta de Vtol. Si no se selecciona ninguna de las opciones que sugiere el autocompletable, permite completar libremente como se hace actualmente. Traerá la información que VTol guarda en: paymentPlanList -planId. Este campo (Plan de Pago VTol) será la clave. Para una mejor identificación del plan a seleccionar por el operador, se mostrará el valor del planId del PaymentPlanList seguido del name del provider id + el valor del payment que corresponden a ese planId del paymentPlanList.

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

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

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


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


(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 (o sea 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 en PROMO podrán definirse el límite de aplicación, quedando fuera de alcance para el beneficio Monetario: Cupón Calculado, Beneficio Externo y Canje de Puntos por Catálogo y para el beneficio No Monetario: Plan de Pago y Reintegro bancario.

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


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

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

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

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

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

Podrá indicarse una Descripción del Limite, ésta no tendrá efecto alguno sobre la gestión de los limites, es solamente 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.

El periodo a contabilizar podrá ser:

  • Indefinido:  el límite se aplicará mientras dure la vigencia de la promoción.
  • Día: el limite se aplicará durante los días configurados en el campo "Cantidad de días", en caso de ingresar en este campo el valor 30 se tomará como mes calendario o sea el día 1° del mes siguiente se reiniciará el límite disponible.

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:  indica el monto de descuento que tiene disponible el cliente para recibir un beneficio. Ver ejemplo en:Ejemplo Promoción con Limite por cantidad de dinero
    • Cantidad de Aplicaciones: indica la cantidad de transacciones en las que se ha otorgado el beneficio de una promoción.
    • Cantidad de Productos beneficiados : indica la cantidad máxima de productos que pueden ser beneficiados por una promoción.
    • Cantidad de Cupones emitidos (solo disponible cuando se este definiendo un beneficio No Monetario, Cupón): Indica la cantidad máxima de cupones que se pueden emitir por cliente o por tienda.
    • Cantidad de Unidades de Fidelidad Otorgados (solo disponible cuando se este definiendo un beneficio No Monetario, Puntos/Porcentaje o Coeficiente de Fidelización): Indica la máxima cantidad de puntos de fidelidad que se pueden otorgar a un cliente.
    • Cantidad de Regalos Otorgados (solo disponible cuando se este definiendo un beneficio No Monetario, Regalo): Indica la cantidad de regalos que se pueden otorgar.


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.


Una vez definido un limite para un beneficio éste 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 modificarlos. Sólo se puede modificar la cantidad de productos beneficiados y el motivo.

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 versión de Promo 7.0.1 se habilita el campo descripción al momento de definir un limite de aplicación en los beneficios.

Este campo descripción, esta disponible para cualquiera de los limites disponibles en la definición (General, Tienda y Cliente)



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

Importante

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




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

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

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

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

Si esa configuración está en : 

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

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

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

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



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



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


Modificación de promociones en base a su vigencia

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

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

Promociones vigentes/vencida con edición inhabilitada

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


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

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

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

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

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

(Para mas información sobre el proceso del envío de Promociones Vía Rabbit MQ ver Manual de Integración Promo 7.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.


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

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


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


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




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 documentos excel 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 dichos archivos.

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

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

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

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

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


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


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 Activo) no podrán generarse archivos excel 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 documento 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.


Consideraciones Importantes

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

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

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

Se pueden completar atributos de la cabecera:

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


NOTA

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

Las sugerencias se pueden ver en detalle en SUGERENCIAS

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



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

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


























Nota

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


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

Las columnas "Workflow", "Campaña", "Canales de Publicación", "Tipo de Promociones", "Sub-Tipo de Promociones" y "Forma de aplicación de promociones", siempre estarán presente en el Excel, pero no son de carga obligatoria. Si se dejan en blanco, al procesarse el documento 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.


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



Importante

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

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


Editar plantilla

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

siendo todos los campos editables.

Importante

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


Generar plantilla en formato excel

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

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

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

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

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

                                                                                                                   

                          nombre_de_la_plantilla_año_mes_dia_hora_ninutos_segundos.xls



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.

Importante

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

  • I: Insertar
  • U: actualizar
  • R: cancelar

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

Consideraciones Importantes

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


Limitantes y Asumisiones en el Alta Masiva de Promociones

Limitaciones

  • No se podrán asignar variables a los campos que poseen validaciones (mascaras) o formatos específicos (select, numeric, boolean, entre otros) desde lado consola, por lo que se tomaran como variables en la plantilla todos aquellos campos donde el usuario indique algún dato valido, por lo que al indicar valores en las columnas que representan dicho campo los mismos serán guardados en la promoción durante la importación, en caso de no indicar algún valor en la columna del excel, se tomara el valor definido por el usuario durante la creación de la plantilla.

  • Para los campos de auto-completar, no se podrán definir variables con espacios, ejemplo: @[perfil del cliente], ya que el mecanismo de asignación de valores en un elemento auto-completar no lo permite, en ese caso se sugiere definir @[perfil_del_cliente] o utilizando cualquier otro separador.
  • Solo para casos donde el código de la promoción se repita en otras promociones, es decir que el código no sea único.
    1. El usuario deberá usar el nombre como campo clave para actualizar o cancelar las promociones por Excel, ya que es la única forma de identificar la promoción que será actualizada/cancelada, por lo que no será necesario especificar el código de la promoción en el Excel.
    2. Es importante tener en cuenta que solo podrá actualizar el nombre de la promoción por Excel especificando el código y si este código es único, es decir no se encuentre asignado ya a otra promoción existente.
  • Validación durante el proceso de importación: 
    Beneficios:
    - Para los campos dentro del beneficio que representan porcentajes, no se puede identificar para validar que el valor no sea mayor a 100.

    - Para opciones del beneficio (BenefitRedeemWithOptions) y limites del beneficio (Limit), se creo en cada entidad el método listDeclaredFields() donde se indican los detalles de cada campo (nombre, tipo, requerido), esta solución surgió como respuesta a la dificultad de mantener de forma dinámica las validaciones de campos asociados a Opciones y Limites del beneficio, ya que los tipos dispuestos para cada campo dentro de cada entidad no corresponden al tipo dado operativamente desde lado consola y no se podía determinar cual era requerido o no.
  • Edición de promociones que se hayan generado a partir de la plantilla: Como discernir entre una actualización total a una parcial (puntualizando en campos específicos), ejemplo: para el caso de condiciones simples, si se tiene definido: Marca, Proveedor y Código (SKU)Caso 1:  Se quiere actualizar solo el valor del elemento Marca y que tanto Proveedor y Código (SKU) se mantengan tal como se encuentran definidos en la promoción a editar, esos campos se dejarían vacíos dentro del excel. Caso 2: Si de lo contrario lo que se quiere es actualizar el valor del elemento Marca y que los elementos Proveedor y Código (SKU) ya no estén disponibles dentro de la condiciones simples, los valores asociados a esos campos se dejarían vacíos dentro del excel.
  • Edición/cancelación de promociones por Excel:

    Solo para casos donde el código de la promoción se repita en otras promociones, es decir que el código no sea único.

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

Asunciones

  • Las columnas asociadas a campos sobre los que no se haya definido alguna variable (@[......]) al estar vacías durante el procesamiento del documento excel, tomara el valor definido por el usuario durante la creación de la plantilla de promoción.

  • Durante el proceso de importación cada columna de la cabecera estará sujeta a las validaciones propias del campo que representa.
  • Los elementos auto-complete, que permiten la asignación de valores alfanuméricos por parte del usuario, podrán ser usados para definir variables. No se podrán definir variables con espacios en los elementos de condiciones simple o el universo de aplicación del Combos o beneficios, en ese caso se sugiere el uso de algún separador (_,-) entre cada palabra, como por ejemplo: @[perfil_del_cliente].
  • Para los campos nativos del beneficio se obtiene su nombre desde message.properties, en el caso de ser un nuevo campo insertado desde la ABM de Propiedades de beneficio, el nombre se obtiene a partir del campo nombre (name) de esa propiedad.

  • Para las operaciones Actualizar y Cancelar, se deberá indicar el código o nombre asociada a la promoción sobre la que se quiere realizar dicha acción.
  • No se podrá Actualizar o Cancelar promociones con estado Distribuido o Distribuido editable, tal como sucede desde lado consola, adicionalmente evitara problemas con la regeneración del id del beneficio, ya que se necesita mantener por su asociación con los limites.


Definir

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

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

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

Importante

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

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

En la consola:

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

Consideraciones Importantes

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

Esto es porque a efectos del proceso, basta con declarar una única variable sobre el elemento de la condición para identificarlo dentro de la plantilla de Excel.

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

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

Los siguientes campos señalados en la imagen no se mostrarán como variables dentro del Excel, ya que de ambos dependen los campos que identifican el beneficio, siendo ambos valores fijos que representan el tipo y clase beneficio y no pueden ser modificados.

  1. Tipo de beneficio 
  2. Clase de BeneficioCampos con valores fijos en el beneficio de la plantilla de promoción:

Consideraciones Importantes

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

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

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

Formato de opciones en Beneficio Canje con opciones:

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

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

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

 Limites de aplicación del beneficio

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

Formato del Limites en la plantilla ExcelResultado en pantalla. Datos en los limites de la promoción creada desde Excel

Limites con tienda especifica

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

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

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

 Promoción con limites con tiendas, importada desde Excel

Nota

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

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

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

Definición de escalones en plantilla de promoción

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

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

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


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

Importante

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

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

  • Cuenta contable
  • Mensaje en POS
  • Mensaje en impresora
  • Mensaje en TLOG


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

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

Formato del proveedor del bien y financiero

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)
Aquellos campos que no permiten el ingreso de variables y cuyos valores no hayan sido indicados en el Excel, la promoción creada tomara por defecto los valores configurados en la plantilla de promoción.

Procesamiento del Excel


Consideraciones previas al procesamiento

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

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

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

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

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

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

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

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

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

  • Importación de un archivo vacío (sin datos de las promociones a importar), se visualizara el siguiente mensaje en pantalla:

  • Se importa un archivo Excel con un formato en el nombre diferente al esperado por el importador de dicha plantilla, en este caso el usuario visualizara el siguiente mensaje de error: 

  • La cantidad de campos en el Excel no corresponde a la cantidad de datos de la plantilla, esto ocurre cuando se actualiza la plantilla pero el Excel no, por lo que el usuario podrá visualizar el siguiente mensaje de error:

Actualización  de Promociones por Alta Masiva


ACTUALIZACIÓN DE PROMOCIONES POR ALTA MASIVA

Consideraciones Importantes

  1. Se mantendrán los valores de la promoción a actualizar, reemplazando solo aquellos que sean indicados en la plantilla de Excel.
  2. Es importante que el código de la promoción a Modificar no se encuentre repetido, ya que el proceso terminara modificando la promoción que coincida con la búsqueda y esta puede o no corresponder a la promoción deseada, por ende es importante en este caso tener en cuenta que debe identificar la promoción a modificar/cancelar por su nombre ya que este es su identificador y no el código.
  3. Si la promoción es modificada manualmente o por servicio Rest y se cambia tanto la estructura de las condiciones, universo de aplicación, combos y beneficios, esta al ser actualizada a través del proceso de alta masiva por Excel, todos los elementos que se hayan insertado y que no correspondan a la estructura de la plantilla serán removidos, ya que el proceso siempre actualizara la promoción en base a la estructura de la plantilla configurada, removiendo todos aquellos datos que no sean compatibles con la misma.
  4. Los valores de una promoción basada en una plantilla pueden ser modificados manualmente, respetando la estructura heredada de la plantilla, esto para evitar problemas de compatibilidad al momento de querer actualizarla de forma masiva a través de la plantilla Excel, tal como lo plantea el punto 2.
  5. Los elementos de las condiciones simples o del universo de aplicación de los combos/beneficios, configurados desde la plantilla con valores por defecto (ver caso 2), al indicar nuevos valores para estos elementos en la promoción desde Excel, siempre mantendrá el valor(es) por defecto definidos en la plantilla, por lo que el elemento se terminara actualizando con el valor dado en el Excel mas el valor(es) por defecto indicados en la plantilla.
  6. Solo se podrán actualizar promociones no canceladas y que se encuentren asociadas a la plantilla de promoción.
  7. Todas las promociones actualizadas desde el alta masiva por Excel cambiaran su estado a Completa, salvo en el caso de promociones con Canales de Publicación Facebook o Twitter, se crearan con estado Incompleta hasta que el usuario no indique de forma manual la imagen asociada a la promoción creada.
  8. Si se crea una plantilla con valores por defecto en los elementos de las condiciones simples/universo de aplicación de combos y beneficios, estos serán heredados por la promoción creada, por lo que si se modifica el valor del elemento en el Excel se reemplazara todos los valores anteriores por los nuevos, pero seguirá heredando el valor por defecto configurado en la plantilla. Ejemplo: Dada una plantilla con una condición simple por sku igual a @[variable_sku],111. Al crear una promoción sin indicar un valor para el elemento variable_sku en el Excel, esta se creara con una condición por sku con el valor 111 configurado, por lo que al actualizar dicha promoción e indicar en la columna variable_sku el valor ABC, se actualizara la condición a ABC,111; si bien el valor 111 no se indico en el Excel este siempre se heredara de la plantilla.
  9. Al actualizar los valores de los elementos de las condiciones, los valores que tengan dichos elementos antes del cambio, serán reemplazados es su totalidad por los indicados en el Excel, heredando siempre el valor por defecto configurado en la plantilla en el caso de que así lo tenga, por lo que si lo que se desea es sumar un valor más al elemento sin perder los anteriores, se debe indicar todos los elementos actuales mas los nuevos en el Excel. Ejemplo: En el caso de actualizar los valores 222,333,444,111 del elemento Código SKU de la condición simple, siendo 111 el valor por defecto heredado de la plantilla, al actualizar desde el Excel por los valores AB,777,888 y para mantener los anteriores deberá indicar * 222,333,444,*AB,777,888, por lo que * los valores anteriores del elemento Código SKU -> 222,333,444,111 se actualizaran a 222,333,444,*AB,777,888,111, manteniendo siempre el valor por defecto 111 en el elemento heredado de la plantilla.
  10. Con respecto a la actualización de limites en la promoción, los limites indicados en el Excel reemplazaran en su totalidad a los limites anteriores.


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

Importante

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

Cancelar Promociones Por Alta Masiva

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

Importante

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

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

Importante

El campo Motivo de Cancelación es obligatorio.

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

Al procesar el archivo, éste da error:

En el detalle de error, se observa:


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

  • Operación → R
  • Motivo de la cancelación → Valor alfanumérico, texto libre.
  • Nombre o Código que identifique de forma única la promoción, por lo que los demás campos en el Excel no son requerido y podrán estar o no vacíos

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

Cancelacion de Promociones

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

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

En la consola:


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


en la consola:

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

En la consola:

Importante

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


Cancelación Masiva 

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

Se presentara la pantalla "Cancelación Masiva de Promociones", desde donde podrán seleccionarse las promociones que se deseen cancelar.




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


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, condiciones generales y listas de precios. De esta forma podrán manejarse de manera independiente los pasos para aprobar un determinado grupo de promociones, condiciones generales o lista de precios.

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

Lo mismo sucede para los Workflows de Listas de Precios y Condiciones Generales.

Los WF podrán aplicar a:

  • Promociones
  • Condiciones Generales
  • Listas de Precios


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

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

Se muestran 3 checkbox, que indican si el Workflow aplica a promociones, a condiciones generales y a listas de precios o las tres. Por default, los 3 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 y Condiciones Generales.

Si un workflows ya se encuentra utilizado en una promoción, condición general o en una lista de precios, al mismo NO se le podrá destildar el check "Aplica a promociones", "Condiciones Generales"  o "Aplica a listas de 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.


Importación de Promociones con workflow de varios pasos

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


Condiciones Generales  para Aprobar

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

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

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

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

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

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

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

  1. Historial 
  2. Aprobar/Rechazar



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

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

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

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


Workflows de solo un paso de aprobación

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

Workflows de mas de un paso de aprobacion

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

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

Cuando la promoción/Condición General  sea "APROBADA" por todos los pasos del WF al que fue asignada, la promoción/condición general  NO PODRA EDITARSE, 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/Condiciones Generales.


Ejemplo:

  1. El operador captura las promociones/Condiciones Generales y envía para su aprobación.
  2. El supervisor, valida la promoción/Condición General cargada y las aprueba o rechaza de acuerdo a su criterio.



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


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

  • "Promociones para Aprobar" o "Condiciones Generales 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"  o "Gestion de Condiciones Generales" 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/condición general
  2. El usuario que ha realizado cada uno de ellos
  3. La fecha y la hora en que fueron realizados
  4. Si han sido realizados con éxito


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

Promociones:


Condiciones Generales:




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



Menú de Distribución


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


Mapas

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

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

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

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. Más detalles de su funcionamiento en Manual de Integración - Motor, en el ítem Cuerpo, Opciones.

  • 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 ítem que cumple con la Promo-A ("111")  y otro ítem que cumple con la Promo-B ("333").

Al evaluarse los ítems con el mapa que contiene la función "Evalúa Si", se aplicara sobe el ítem "111" la Promo-A y la Promo-B, mientras que el ítem "333" no obtendrá beneficios, ya que por definición, solo se aplicara la promoción condicionada (Promo-B) sobre los ítems 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 SINO aparecerá en un segundo paso o pasos superiores pero nunca en el primer paso. Ejemplo: Si la función EVALUA SINO, está en el tercer paso, las promociones integrantes de los pasos 1 y 2 pueden ser utilizadas como condicionantes.
Al igual que en la función anterior, la promoción condicionada será la última que aparezca en la lista, mientras que las condicionantes, por lo tanto, serán todas las que se encuentren primero. Si se desea que exista más de una promoción condicionada, todas ellas deberán estar dentro de alguna función de convivencia.


Ejemplo:

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


El mapa quedara conformado de la siguiente forma:


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

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

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



Las siguientes funciones son sólo para BENEFICIOS MONETARIOS:


  • MAXIMO DESCUENTO (MAX DISCOUNT)

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


Cupon Calculado como Beneficio Monetario

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



  • 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 función de Máximo descuento combinado debe tener al menos dos promociones dentro del paso para poder aplicar la funcionalidad de competencia de promociones.




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


      • MAXIMOS PUNTOS (MAX POINTS)

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


      • MINIMOS PUNTOS (MIN POINTS)

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


NOTA

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


NOTA 2

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


NOTA 3

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

Composición de funciones de convivencia

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

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


Ejemplo:


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

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


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


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

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

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


NOTA

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



CONDICIONES GENERALES


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

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

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

El mapa que se descargue contendrá las Condiciones Generales.



Colisiones


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

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

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

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


Caso A: Creación de promoción


      1. Se da de alta una promoción PROMO_A que utiliza el artículo con código 8321.
      2. Se da de alta una nueva promoción PROMO_B, cuya fecha de vigencia intercepta 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 intercepta 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 versión 7.0.2, 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.
      • Cadena: a la que pertenece la tienda.
      • 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.
      • Opción de canje de puntos: permite ingresar en la simulación de la transacción una cantidad de puntos que Promo utilizará para otorgar la promoción de canje de puntos.

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.
      • Factor de conversión:  valor para convertir los puntos del cliente en $.


    • 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.
    • Bolsillo: para identificar el tipo de monedero utilizado.
    • Grupo de Prefijos: para identificar el grupo de prefijos 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 - Configuración de Redes Sociales).

La publicación en redes sociales tiene como finalidad solamente la comunicación de ofertas, oportunidades y/o beneficios a potenciales 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 únicamente) .

la imagen asociada es:

Una vez dada de alta la promoción con alguno de los canales de publicación de redes sociales seleccionados, en la vista gestión de promociones se visualizaran las promociones, con el logo que corresponda según canal seleccionado.


Publicación en Redes Sociales


Luego de definidas las promociones que serán publicadas en redes sociales y configurados los accesos a las redes sociales.

En el módulo de Distribución >> Redes Sociales, se mostraran la pantalla "Publicación en Redes Sociales" donde se listaran las promociones con los canales de publicación habilitados para 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


Hecho esto podrá visualizarse en la pagina seleccionada la promoción recientemente publicada, presionando en el botón .




y desde allí, se presiona en la página donde se hizo la publicación. 



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






Capítulo 8 - Módulo de Precios



El modulo tendrá por defecto las siguientes funcionalidades:

  1. Listas de precios
  2. Distribución/cancelación de listas de precios
  3. Plantillas de etiquetas
  4. Impresión de etiquetas a demanda
  5. Impresión de etiquetas pendientes

Listas de Precios

                 

Se accede desde el Menú Precios, ítem Listas de Precios

ADMINISTRACIÓN DE 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.


LISTAS CERO

LISTAS DERIVADAS

LISTAS NUEVAS O GENERADAS

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 ítems participantes se obtienen a través de una interface, para recepción y procesamiento de precios desde SAP.

Son listas que tienen como lista padre una Lista cero, sobre la cual se les aplica algún tipo de operación de cálculo que actuara sobre los precios de la lista padre (Ej. % de aumento, $ de decremento, sumar $1, restar $1, aplicar redondeo). No se definen los ítems de la misma, ya que utilizara los de la lista cero asociada. Aclaración: las listas derivadas fueron creadas para manejar los precios ofertas o aumentos de los precios.

Son listas que se crean manualmente sin necesitar la asociación con una Lista cero, sino que se crean definiendo un universo de aplicación especifico, así como el listado de ítems que se definen a partir del catálogo de ítems y cargados a la lista a través de la importación de un archivo Excel.

El usuario podrá ver por defecto los registros de la listas cero creadas por cada tienda existente a la que tenga acceso, así como realizar búsquedas de listas de precios por los siguientes filtros:

  • Tipo (cero, generada, derivada)
  • Código (código de la lista de precios)
  • Nombre (nombre de la lista de Precios)
  • Tienda (mostrará todas las tiendas que el usuario tenga vinculadas)
  • Código (SKU)
  • Estado (Incompleta, Completa, Aprobada, Distribuida, Cancelada, En distribución)
  • Vigencia (Vigente, No vigente)



De las listas de precios creadas podrá visualizar los siguientes datos:

  • Estado (Incompleta, Completa, Aprobada, Distribuida, Cancelada, En distribución)
  • Tipo (Cero, Generada, Derivada)
  • Lista cero base (para las derivadas)
  • Código (código de la lista de precios)
  • Nombre (nombre de la lista de Precios)

  • Descripción (descripción de la lista de Precios)
  • Tiendas (sólo podrá ingresar aquellas que el usuario tenga vinculadas)
  • WF (indica si el Workflow fue aprobado o no)
  • Vigencia (período de vigencia de la lista de Precios)
  • Prioridad (Indica el orden de prioridad de la lista de Precios)


Importante

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

Creación de listas Generadas/Derivadas

En esta sección podrá visualiza por lista todo los detalles, validaciones, aclaraciones y consideraciones importantes a tener en cuenta al momento de crear las listas de precios generadas o derivadas, se recomienda leer detenidamente toda la información suministrada.

> Lista Generada

Datos de cabecera

Desde la vista de Administración de Listas de Precios, podrá generar una nueva lista desde el botón "Nueva Lista" el cual lo vinculara a la ventana de creación de Listas de precios. 

Aquí el usuario podrá indicar los siguientes datos, siendo obligatorios aquellos marcados con *:

  • Código * (código de la lista de precios, es un campo requerido con un máximo de 5 caracteres)
  • Nombre * (nombre de la lista de precios, es un campo requerido con un máximo de 30 caracteres)
  • Descripción (es un campo opcional con un máximo de 50 caracteres)
  • Workflow * (elemento de selección donde podrá elegir dentro del listado de Workflows configurados para listas de precios, por defecto aplicara el Worflow general)
  • 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 *  (fecha de inicio de vigencia de la lista de precios, es requerido)
  • Fin de Vigencia *  (fecha fin o de caducidad de la lista de precios, es requerido)



Consideraciones importantes

  • Tal como se menciono en el punto inicial donde se describen los 3 tipos de listas de precios disponibles, el usuario solo podrá crear nuevas listas de tipo Generada.
  • La lista se guardará con tipo "Generada" y en estado "Incompleta", hasta que se defina correctamente su universo de aplicación, así como el detalle de productos que la componen (archivo Excel).
  • Ninguna lista de precios (ni las listas cero, ni las derivadas, ni las generadas), pueden tener precio 0 en los campos: $ (precio en efectivo), $ Crédito (precio a crédito) disponibles en el Excel

Definición de listas de precios

Al guardar los datos de cabecera de la lista de precios, el proceso lo dirigirá a la ventana de Definición donde podrá completar el Universo de aplicación y así como importar el archivo Excel con el detalle de los productos que contendrá la lista de precios.


En la sección CABECERA, el usuario podrá visualizar los datos de base de la listas de precios, configurados al momento de la creación.


Así mismo, en la sección UNIVERSO DE APLICACIÓN, se podrá completar los detalles de aplicación de la lista de precios


Universo de aplicación
ElementoDetalle
TiendasPodrá seleccionar las tiendas sobre las cuales se aplicara la lista de precios, tenga en cuanta que solo visualizara aquellas tiendas que tenga vinculadas
Rango horario

Indica el horario (inicio - fin) sobre el cual se aplicara la lista de precios mientras se encuentre vigente.

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 clientePodrá seleccionar los tipos de clientes sobre las cuales se aplicara la lista de precio
EventosPodrá seleccionar los eventos que aplicara sobre la lista de precio
ClientesPodrá seleccionar los clientes sobre las cuales se aplicara la lista de precio
Prioridad

Tal como su nombre la indica define el numero de prioridad en la que se aplicara dicha lista de precios, por lo que entre mas alto sea el numero configurado mas prioridad tendrá dicha lista de precios siempre y cuando se encuentre vigente.

Consideraciones importantes

  • Ya que la prioridad depende de las tiendas, al indicar las tiendas previamente podrá visualizar por defecto una prioridad sugerida, el cual es el siguiente numero mas alto tomado entre las listas de esas tiendas.
  • La prioridad puede ser modificada, pero se sugiere mantener la definida por defecto.
  • Si la prioridad ya se encuentra definida en otra lista de precios el usuario podría visualizar un mensaje de alerta → Ya existe la prioridad definida para la tienda test
  • La prioridad tendrá un valor máximo igual a 999.999, una vez llegado este valor, el sistema seguirá asignando para la siguientes lista este numero de prioridad, para evitar esto, el usuario podrá asignar cualquier otro numero que no haya sido usado por otra lista de precios, por lo que se recomienda usar siempre la prioridad sugerida para evitar disparidad entre los números asignados.
  • 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.

Caso practico 1:

Dado el siguiente Universo de aplicación de 3 distintas listas de precios

  • 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

Resultado:

 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.


Importación/exportación del detalle de los productos

Antes de realizar la importación tenga en cuenta lo siguiente:

  1. Exportar catalogo BASE: devolverá un archivo Excel con el catalogo de productos, por lo que dada la información podrá completar los datos correspondientes a los precios de cada producto. Es necesario que exista un catalogo de productos cargado previamente.
  2. Exportar detalle ACTUAL: exportara el archivo con el detalle y precios de los productos importados previamente.



Exportar catalogo BASE

Una vez descargado el archivo con los productos del catalogo, podra visualizar un contenido similar al siguiente:


Detalles de los campos en el Excel
CampoDetalles
CódigoCódigo del producto (SKU), valor requerido
NombreNombre del producto con una longitud de 50 caracteres, valor requerido
Departamento Código del departamento en CatalogDepatment, con una longitud de 30 caracteres, valor requerido
Marca Código de la Marca en CatalogBrand, con una longitud de 30 caracteres, valor requerido
Proveedor Código del proveedor en CatalogSupplier, con una longitud de 30 caracteres, valor opcional
Magnitud Unidad de medida por magnitud, campo numérico con decimales, valor opcional
$CostoPrecio del costo del producto, campo numérico con decimales (Ejem. 10.2), valor opcional
$Precio de venta efectivo, campo numérico con decimales (Ejem. 10.2), valor requerido
$Credito

Precio de venta a crédito, campo numérico con decimales (Ejem. 10.2), valor requerido mayor a 0

Si no tiene un precio de venta a crédito debe ingresar en este campo el mismo valor indicado en el Precio de venta efectivo

$MagnitudPrecio por magnitud del producto, campo numérico con decimales (Ejem. 10.2), valor opcional
$MayoristaPrecio mayorista del producto, campo numérico con decimales (Ejem. 10.2), valor opcional
$Lim. MayoristaCantidad a partir de la cual aplica el precio mayorista, valor opcional
P. BienCódigo del proveedor del bien en CatalogSupplier, con una longitud de 30 caracteres, valor opcional
MontoMonto de Recupero del proveedor del bien, campo numérico con decimales (Ejem. 10.2), valor opcional
P. FinanCódigo del proveedor financiero en CatalogSupplier, con una longitud de 30 caracteres, valor opcional
MontoMonto de Recupero del proveedor financiero, campo numérico con decimales (Ejem. 10.2), valor opcional
LimiteLí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, valor opcional
Ap. PromosIndica si aplica promociones, este es un valor Verdadero/Falso de 0 (NO) o 1 (SI), opcional
Ap. DescuentosIndica si aplica descuento manual, este es un valor Verdadero/Falso de 0 (NO) o 1 (SI), opcional
Vigencia desdeInicio de Vigencia del precio del producto (formato de fecha: dd/mm/aaaa, debe ser mayor o igual al inicio de la vigencia de la lista de precios), opcional
Vigencia hastaFin de Vigencia del precio del producto (formato de fecha: dd/mm/aaaa, debe ser mayor o igual al inicio de la vigencia de la lista de precios), opcional
Unidad de medidaCódigo del unidad de medida, con una longitud de 15 caracteres, valor opcional


Una vez configurado correctamente los detalles de cada producto en el archivo Excel, deberá cargarlo a través del botón Examinar y procesarlo presionando Importar Catalogo.

  • Una vez que el archivo sea procesado correctamente visualizara el siguiente mensaje 
  • De lo contrario, vera un mensaje de error indicando el numero del celda.


En la sección BUSQUEDA POR SKU, se podrá consultar todo el detalle por código (SKU) de producto, así podrá visualizar toda la información de los precios asociados al mismo, así como su vigencia en la lista de precios.

Importante

  • Desde Exportar Catalogo BASE,  podrá generar la lista a ser importada. Este archivo contendrá el catálogo completo de productos de Promo/Bridge.
  • 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 Proveedor del Bien y Monto de Recupero Proveedor Financiero, 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.

Consideración importante

Con respecto a la Lista 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, 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 en su defecto sacar ese sku de la lista Generada. Ya que el proceso no permitirá crear una Lista Generada si tiene algún ítem que no exista en catalogo de productos (catalogItem)

Con respecto a la vigencia de los ítems:

  • Tenga en cuenta que 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.

>Lista Derivada

Lista creada a partir de una lista cero, sobre la cual se les aplica algún tipo de operación de cálculo que actuara sobre los precios de la lista padre (cero).

Desde la lista de precios cero ubicada en el listado de Listas de precios, Ir a Acciones Nueva lista de precios derivada

Importante (Aclaraciones)

  • Las listas derivadas son creadas a partir de una lista cero
  • Además de los precios, para el Universo de Aplicación la lista derivada heredará la Tienda o Tiendas que tenga configurada esa lista cero, así mismo, sugerirá la Prioridad, el cual será el numero mas alto disponible.
  • Tenga en cuenta las aclaraciones expuestas abajo para los campos Incremento o Decremento, Diferencia monto y Redondear a, ya que estos son los criterios que se aplicaran sobre los precios de la lista cero en la cual esta basada esta lista.
  • Los precios que se modificarán en la nueva lista derivada son los reflejados en el Excel como: $, $Credito, $Magnitud y $Mayorista. 
  • Al igual que las otras listas, la Derivada estará en estado incompleta hasta que se complete el Universo de Aplicación, una vez listo pasara a estado Completo.
  • No se podrá crear listas derivadas sobre listas cero incompletas, por lo que para estos casos la opción "Nueva lista de precios derivada" en el menú Acciones estará deshabilitada.


Al igual que en las generadas, inicialmente deberá indicar los datos de cabecera de la lista, estos campos son los siguientes:

  • Código * (código de la lista de precios, es un campo requerido con un máximo de 5 caracteres)
  • Nombre * (nombre de la lista de precios, es un campo requerido con un máximo de 30 caracteres)
  • Descripción (es un campo opcional con un máximo de 50 caracteres)
  • Workflow * (elemento de selección donde podrá elegir dentro del listado de Workflows configurados para listas de precios, por defecto aplicara el Worflow general)
  • 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 *  (fecha de inicio de vigencia de la lista de precios, es requerido)
  • Fin de Vigencia *  (fecha fin o de caducidad de la lista de precios, es requerido)
  • Incremento o Decremento (no obligatorio)indica el porcentaje de aumento o descuento aplicado sobre los precios de la lista cero
    • Para aplicar descuentos sobre los precios coloque el símbolo - antes del monto. Ejemplo: -10 (indica 10% de descuento)
    • Para aplicar incrementos sobre los precios, deberá indicar el monto sin símbolos. Ejemplo: 15 (indica 15% de incremento)
  • Diferencia monto (no obligatorio): es el monto fijo que se aplica sobre el precio, bien sea sumándolo o restándolo.
    • Para restar un monto fijo sobre los precios, deberá indicar el símbolo - antes del monto. Ejemplo: -10
    • Para sumar un monto fijo sobre los precios, deberá indicar el monto sin símbolos. Ejemplo: 15
  • Redondear a (no obligatorio): representa el monto para el redondeo hacia abajo, por lo que si se aplica un redondeo de 99 sobre un monto 580.00, este una vez aplicado tendrá como resultado 579.99)   
    • Indique el numero entero que aparecerá como decimal.
    • El valor numérico no debe contener decimales.
    • El checkbox Redondeo en calculo sin decimales, indicara si al resultado obtenido de la aplicación del redondeo se le remueve o no los decimales resultantes (ver caso practico 2)


Casos prácticosDetalle
1

Redondear a

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

2Para precios afectados por el valor en Redondear a, se podrá determinar si al resultando 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). 


Definición

Una vez completado la información de cabecera de la lista derivada e indicado el criterio de aplicación que afectara a los precios, al guardar el proceso lo redirigirá a la ventana de Definición, aquí podrá completar el Universo de aplicación asociado a la lista (ver en la sección Lista Generada → tabla: Universo de aplicación), una vez indicado correctamente toda la información necesaria, podrá visualizar como cambia el estado de la lista de Incompleta a Completa


Para definir el UNIVERSO DE APLICACIÓN, se recomienda ver en la sección Lista Generada → tabla: Universo de aplicación, ya que aplican los mismos criterios en ambas listas.


Con respecto  a la sección DETALLE DE PRODUCTOS, podrá descargar el archivo Excel con el catalogo de productos y sus precios con los criterios aplicados a partir de los valores en los campos Incremento o Decremento, Diferencia monto y Redondear a, para ello deberá presionar el botón Exportar detalle ACTUAL

Una vez generado podrá visualizar la información con el siguiente formato, tal como lo muestra la imagen de ejemplo abajo. Asi mismo, para conocer los detalles de los campos y sus valores ver en la sección Lista Generada → tabla: Detalles de los campos en el Excel


Para consultar productos de forma concreta, deberá ubicarse en la sección BUSQUEDA POR SKU, una vez realizada la búsqueda por un código de producto (SKU), podrá visualizar toda la información de los precios asociados al mismo, así como su vigencia en la lista de precios.


Consideración importante

Con respecto a la Lista derivada, 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, 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 catalogo de productos (catalogItem) y vuelva a generar y distribuir la lista.


Procesos asociados a las listas de precios

> Aprobación de Listas de Precios

La lista de precios por defecto contacta con un workflow por defecto "Workflow general" el cual contara con un solo paso.

Si desea crear otro workflow para la autorización de listas de precios, deberá seguir los siguientes pasos:

Ir a Workflow Workflow → Nuevo

Deberá indicar de forma obligatoria los siguientes campos:

  • Nombre
  • Aplica a lista de precios

Una vez guardado correctamente los datos de cabecera, tenga en cuenta que 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.

En cada paso podrá indicar los roles y el o los usuarios que tendrá acceso a dicho workflow y serán responsables de la revisión y aprobación de dicho paso.


Proceso de aprobación
#Detalle
1

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:

2

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:

También podrá rechazar o aprobar una lista de precios, oprimiendo "Rechazar" o "Aprobar", además de indicar los motivos de dicha acción dentro del campo Nota.


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

Para distribuir una lista de precios en particular, deberá ubicarse en el menú principal Precios Listas de precios y seleccionar en la lista que se vaya a distribuir la acción Distribuir Lista, el proceso le solicitará confirmar esa opción con el siguiente mensaje: “Se distribuirán TODOS los precios de la lista seleccionada, a los motores asociados a las tiendas de la lista”.

Una vez confirmada la acción, se iniciará el proceso de distribución de todos los precios de esa lista y las etiquetas de precios asociadas.


Advertencia

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


Sobre la distribución a los motores, se tiene que tener en cuenta lo siguiente:

  • Se completara la distribución exitosamente siempre que el motor este online, de lo contrario el usuario observara en el "Monitor de Importaciones" que la distribución permanecerá en estado Pendiente hasta que el motor este online.
  • A partir de la versión EP2.1 Las listas de precios con motores offline se mantendrán con status "Completa", hasta que el motor esté online. Cuando el motor pase a online automáticamente redistribuirá la lista que pasará a estado "Distribuida".
  • A partir de la versión EP2.1. 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.
  • El estado “En Distribución”, ocurre cuando se presiona 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ó.


Consideraciones importantes

Uso de las variable priceList.distribution.print.before

Esta variable permitirá generar las etiquetas de precios para impresión de acuerdo a los siguientes criterios:

  • Valor por defecto True
  • Si la variable está en "True", indica que la listas de precios en estado “Completa” permitirán la impresión de etiquetas sin previa distribución, las cuales estarán visibles en Precios Impresión de etiquetas pendientes.
  • Si la variable está en "False”, indica que las listas de precios con estado “En Distribución" o "Distribuida” permitirán la impresión de etiquetas.

> Distribución de Listas de Precios por Contingencias

Antes de iniciar este proceso deberá habilitar la variable "priceList.distribution.force.offline" desde Administración Información de configuración

Luego, desde el listado de Listas de precios, ir a Acciones Descargar Distribución (solo estará disponible esta opción en las listas de precios que estén pendientes de distribución)

Para este proceso tengan en cuenta lo siguiente:

  1. Al presionar esta acción, visualizara una ventana con el siguiente mensaje de confirmación: "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?"
  2. Al confirmar la descarga, visualizara la siguiente información: “Se descargó correctamente la lista de Precios. La misma deberá ser enviada por mail al usuario responsable de la tienda correspondiente”. Este proceso pasara la lista de precios a Completa.
  3. Esta acción estará disponible solo si la variable de configuración "priceList.distribution.force.offline" se encuentra habilitada, ya que su valor por defecto es null.

> Cancelación de Listas de Precios

Para cancelar una Lista de precios, esta deberá estar en estado "Completa" o "Distribuida". Seguidamente, deberá ubicarse en el menú Acciones Cancelar Lista y confirmar la acción en la ventana emergente, de esta manera la lista de precios quedara inactiva y no podrá usarse en las tiendas sobre las cuales se encontraba distribuida.

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 será posible distribuirse en ninguna tienda/s.

Administración de Etiquetas de Precios


                Dadas las listas disponibles (cero, generada o derivada) se podrán generar e imprimir etiquetas en formato PDF, el cual podrá ser impreso desde impresoras de inyección de tinta.

Consideraciones previas

  • Un usuario puede tener vinculada 1 o más tiendas, para la impresión de etiquetas.
  • Una tienda puede tener asociados 1 o más plantillas 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 plantilla de impresión tiene asociada 1 categoría de producto.

> Formato de las etiquetas de precios

Los formatos de los preciadores funcionaran con la siguiente estructura:

Tipos y formatosDetalle

  • Tipo: El usuario podrá seleccionar el tipo de plantilla 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 la plantilla, 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 plantillas

Generación de Plantillas de etiquetas

> Administración de plantillas

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.


Consideraciones

  • El usuario podrá observar el listado de plantillas asociadas al cluster (formato) de la(s) tienda(s).
  • Al construir el plantillas es importante definir cuántas "Etiquetas por página" se desea entren en una página.
  • Las plantillas no podrán ser eliminadas, solo podrán deshabilitarse desmarcando la casilla "Activo".


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.

> Pasos para crear/actualizar una plantilla

#Descripción del pasoVisualización
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.

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

Imagen 2. Propiedades de la tabla.

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

8

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.

Imagen 8. Superdecimales.

9

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 9. Propiedades de la imagen.

10

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



Aclaraciones - Fuente HTML

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>

Aclaraciones - Variables del sistema

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.


Aclaraciones - Imagenes

Imágenes insertadas en las etiquetas:

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

VistaDetalles

Imagen en ruta remota

 

Imagen en servidor de Promo

  • 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

> Proceso de impresión de etiquetas pendientes

Ir a Precios Impresión de etiquetas pendientes

En esta ventana podrá visualizar el listados de precios de los productos de las listas con estado Distribuida/Completa con mayor prioridad y vigentes. Tenga en cuenta que el uso de la variable "priceList.distribution.print.before" (Ver: sección → Importante → Uso de las variable priceList.distribution.print.before) indicará si las etiquetas de precios estarán o no disponibles para imprimir con o sin distribución previa de la lista (a partir de v.6.4.19).

Adicionalmente, desde el sub-menú Impresión de etiquetas pendientes. podrá visualizar el numero de etiquetas pendientes para imprimir, este numero se actualizara en la medida en que vaya generando y guardando el registro de impresión de cada etiqueta

Importante

Uso de las variable priceList.distribution.print.before

Esta variable permitirá generar las etiquetas de precios para impresión de acuerdo a los siguientes criterios:

  • Valor por defecto True
  • Si la variable está en "True", indica que la listas de precios en estado “Completa” permitirán la impresión de etiquetas sin previa distribución, las cuales estarán visibles en Precios Impresión de etiquetas pendientes.
  • Si la variable está en "False”, indica que las listas de precios con estado “En Distribución" o "Distribuida” permitirán la impresión de etiquetas.



>Búsqueda de etiquetas

  • 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á. Es autocompletable (a medida que se escribe va sugiriendo) y mostrará para el usuario logueado las tiendas que tiene activas en Seguridad Administración de Usuarios, sección "Tiendas disponibles"; si allí no hay ninguna tienda seleccionada el filtro "Tienda" mostrará todas las tiendas que estén activas en Negocio\ Tiendas. El usuario deberá seleccionar una tienda (sólo aquellas que tiene configuradas).
  • Una vez seleccionada la tienda, considerando lo expuesto en el punto anterior, deberá indicar la "Categoría", esto habilitará el botón "Generar etiquetas" y mostrara el elemento de sección con las plantillas de etiquetas disponibles para la tienda y categoría seleccionada en elemento de selección Plantillas de etiqueta.
  • El filtro "SKU" es opcional y permitirá buscar un producto en especifico.
  • "Con stock", este filtro al habilitarse indicara que se realizará la búsqueda solo de productos disponibles (con stock) en la tienda, de lo contrario buscara los productos sin importar su stock. Este filtro por defecto se encontrara deshabilitado.

Sobre impresión de productos con Stock:

    • Para disponer de información sobre los productos con o sin stock deberá mantener actualizado el catalogo "CatalogItemStock" con los datos de la tienda, código del producto y stock (valor numérico), ir a Administración Importación de CatálogosStock
    • Los datos a indicar serán por cada producto en la tienda. Ejemplo de importación por archivo: tienda|código de sku|stock → napse|ABC001|580


Una vez ingresados los filtros seleccionar la lupa para ver en pantalla el resultado. 



Sobre las etiquetas y listas de precios aplicadas

Caso practico

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

De esta manera el sistema en este ejemplo, 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.
1111.9992.3002.100
1121.5001.8002.000
Prioridad025
Vigencia desdeindefinida08/02/201901/02/2019
Vigencia hastaindefinida15/03/201901/03/2019


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.

Notas

  • 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 (formato) 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 plantilla asociado a la tienda. De lo contrario se podrá visualizar la alerta "No hay un template asociado a la categoría".

> Generación/registro de etiquetas

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

> Proceso de impresión de etiquetas a demanda

En Precios Impresión de etiquetas a demanda, podrán generar las veces que sea necesario las lista de etiquetas que haya sido generadas y cuya impresión haya sigo guardada desde "Impresión de etiquetas Pendientes".

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


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


Hay que tener en cuenta que...

  • 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á. Este filtro 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.  
  • Al igual que en impresiones pendiente, podrá visualizar el registro de impresión registrado en la sección Impresión de etiquetas, ubicado al final de listado de etiquetas a demanda.


Consideraciones

  1. El usuario podrá realizar la consulta de precios a imprimir por: Tienda, Lista de precios, Categoría, código del SKU y Stock
  2. La opción de generación de etiquetas estará disponible al seleccionar la categoría, esta categoría estará directamente asociada al cluster (formato) de la tienda
  3. Para las impresiones con stock (Filtro "Con stock" habilitado), los ítems 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 ítems 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 ítems pendientes por impresión", indicando que deberá realizar la impresión de ítems 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 fidelización de clientes.

Desde esta opción de menú se podrán crear y administrar las plantillas y tipos de Cupones así como también gestionar los cupones ya existentes.


Plantilla de Cupón


Con las plantillas de cupones se podrán definir los formatos y diseño de los cupones que serán administrados en PROMO, los cuales luego serán utilizados para la definición de Tipos de cupones.

Cuando se dé clic en el botón "Plantillas de Cupón" del menú "Fidelidad" se mostrara el panel de "Administración de Plantillas" donde se podrán visualizar las plantillas ya generadas con su correspondiente código, nombre y formato. Se cuenta con un botón "Editar" desde el cual se podrá acceder a la sección de "Editar Plantilla". 

También se dispone un filtro de permitirá realizar una búsqueda más detallada entre las plantillas de cupones existentes ya sea por su código, nombre, formato, y/o estado (activa, inactiva o todos).


Nueva Plantillas de Cupón

Al pie de la pantalla de administración de Plantillas se el botón "Nuevo" desde el cual se podrán dar de alta nuevas plantillas de cupones.

    • Serán requeridos los siguientes campos para el alta de la Plantilla de Cupón:

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

Las variables de Sistema disponibles en cupones son:

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


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

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


                                 

Importante

  Si el tipo de cupón es electrónico; el Barcode es el código de barra, tal como se lo conoce; y el cuponid es el código de barra en forma de texto.



Tipos de Cupón


Los Tipos de Cupón permitirán definir los parámetros que manejara un cupón al momento de ser emitido así como también los parámetros que se evaluarán cuando se quiera redimir. Estos tipos de cupones serán los consultados cuando desde el punto de venta o desde la propia consola se quiera generar un cupón con su correspondiente numeración y formato.

Aquí podrán generar y administrar Tipos de Cupones a partir de los cuales se crearán los cupones que serán evaluados o dados como beneficio.

Al dar clic en el botón "Tipos de Cupones" del menú "Fidelidad" se mostrará el panel de "Administración de Tipos de Cupón" donde se podrán visualizar todos los tipos de cupones ya generadas con su correspondiente código, nombre, prefijo, plantilla de cupón, codificación, campañas de fidelidad y destino exportación.

Se cuenta con un botón "Acciones" desde el cual se podrá editar, definir pre visualizar o ver las promociones asociadas que emiten y/o redimen este tipo de cupón. A partir de la versión 7.0EP2.1 el botón "Acciones" mostrará también la opción "Exportación".

También se dispone un filtro de permitirá realizar una búsqueda más detallada entre los tipos de cupones dados de alta ya sea por su código, nombre, prefijo, plantilla de cupón, codificación, y/o estado (activa, inactiva o todos).


Nuevo Tipo de Cupón:

Al pie de la pantalla de "Administración de tipos de cupón" se encuentra el botón "Nuevo" desde el cual se podrán dar de alta nuevos tipos de cupones.



Los datos que se solicitan para el alta de un nuevo tipo de cupón son:

        • Código: Será el identificador univoco del tipo de cupón, campo alfanumérico.
        • Nombre: Identificador dentro de la consola del tipo cupón, campo alfanumérico.
        • Descripción: campo alfanumérico, describirá el tipo de cupón que se está creando.
        • Formato: es la forma en que el cupón le llega al usuario beneficiado.
          • Impreso: Cupones que se emitirán en papel físico desde la impresora de la línea de cajas.
          • Electrónico: Cupón que se enviara vía mail a un cliente determinado
          • Externo: Cupones no administrados por PROMO. Este tipo de cupón es emitido y/o redimido por un sistema externo a PROMO.
          • Pre-Impreso: Son cupones que el cajero ya tendrá impresos previamente consigo para entregar a los clientes, y para que los maneje Promo se debe crear una plantilla de cupón con formato impreso. Luego se crea el tipo de cupón pre impreso y no nominado. Y después se dan de alta en forma masiva (desde Fidelidad\ Cupones, botón "Alta Masiva") la misma cantidad de cupones que el cajero tiene a su lado.
          • Informativo: Son cupones que podrán emitirse desde Promo cuando una Promoción lo indique, pero no se realizará ningún registro de esta emisión en la base de datos de Promo, ni se le asignará ningún código de Barras, ni número de cupón. Se imprimirá o enviará por mail (de acuerdo a como se haya configurado el formato en la plantilla del cupón) la información detallada en el cupón. Este tipo se cupón solo se utiliza para informar.
        • Prefijo 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). 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.
        • 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

                                         Más información sobre codificaciones en :_Formato_de_Código

        • 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, la fecha de vigencia del tipo de cupón ingresado en la definición del beneficio incluya las fechas definidas en la condición de rango horario de la promoción (Fecha con Hora).

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

          Al presionar el botón “Guardar” muestra la siguiente pantalla:

                                                                                                                                        


  •                              

                        Con el botón el nuevo tipo de cupón se reflejará en la vista:

                                      

                                     

        

   

    

Editar Tipo de Cupón:

                   Para modificar un cupón se debe presionar desde el botón acciones en la vista Administración de Cupones el ítem "Editar":

la aplicación lo redirigirá a la vista:

Donde podrá modificar cualquier campo; excepto el código.

Tanto en los tipos de cupones electrónicos como impresos, no se podrá modificar el "Prefijo Autogenerado"

Para guardar los cambios, se debe presionar el botón  y éstos se reflejarán en la vista:

 Caso contrario, deberá presionar el botón    

Para Tipo de cupones Impresos y Electrónicos

También se puede editar un tipo de cupón, desde el botón acciones, en la vista "Administración de Tipos de cupones"

presionando el botón "Definir" la aplicación lo llevará a la pantalla:

Desde donde podrá editar la plantilla de cupón, el cupo y/o agregar variables de usuario a la plantilla.



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.

Resumen Tipo de Cupón:

Desde el botón acciones, en la vista "Administración de Tipos de cupones", se puede acceder a un resumen del tipo de cupón :

Copiar Tipo de Cupón:

Se puede copiar un Tipo de Cupón, seleccionando el ítem "Copiar" del botón acciones en la vista "Administración de Tipo de Cupones". Al presionarlo, la aplicación mostrará la vista:

Donde todos los campos son editables; excepto el prefijo autogenerado. Una vez copiado; el nuevo cupón se reflejará en la vista Administración de Tipos de Cupones:

Previsualizar Tipo de Cupón:

Para tener una vista previa del tipo de cupón, cuando se está creando, editando o se copia un cupón; se debe presionar en el botón "Acciones" el ítem "Previsualizar"

La aplicación abrirá la vista:

Promociones Asociadas:

Desde el menú "Acciones", en la vista "Administración de Tipos de Cupones", si se presiona el ítem "Promociones Asociadas"

 la aplicación muestra la vista:

donde se detallarán todas las promociones asociadas a ese tipo de cupón, independientemente de si el cupón forma parte de las condiciones simples o por composición y cualquiera sea el tipo de operador (igual o distinto) y también si la promoción otorga un beneficio no monetario: cupón o cupón calculado.

Esta vista permite buscar por una promoción en particular y por estados (Vigentes y Activas).

Exportación de Cupones a Sistemas Externos

Puede exportar cupones a Sistemas Externos a través de Colas RabbitMQ o Microsoft Dynamics (CRM), para eso debe realizar las configuraciones indicadas a continuación.

  • Configuración para exportar a Colas RabbitMQ: Para poder utilizar las Colas RabbitMQ para exportar cupones, debe configurar el nombre de la cola RabbitMQ en Administración\ Información de Configuración, en el módulo Cupones, categoría promo.promotion, en la clave "rabbitMQ.couponHistory.endpointName", en el campo valor ingresar el nombre de la cola RabbitMQ a utilizar.

  • Configuración para exportar a Microsoft Dynamics (CRM): (buscar crm):

(los valores ingresados en algunos campos solo están a modo de ejemplo)

Al seleccionar Fidelidad\ Tipos de cupones, botón "Acciones", el menú desplegado mostrará la opción "Exportación".

Al seleccionar la opción "Exportación" mostrará la siguiente pantalla:


En la sección cabecera de la pantalla "Exportación" mostrará el "Código", "Nombre" y "Formato" del tipo de cupón sobre el cual se generó la exportación. A la derecha mostrará el botón "Volver" que al seleccionarlo volverá a la pantalla "Administración de tipos de cupones". Debajo mostrará los campos seleccionables "Destinos" y "Acción" y a la derecha de estos un botón para guardar la selección realizada. Al desplegar el campo "Destinos" mostrará "Rabbit" o "CRM". Al seleccionar el campo "Acción" mostrará las acciones que serán las disparadoras de esta exportación a la cola RabbitMQ o a CRM. Las acciones que mostrará son las siguientes:

    • Emitido (al emitir cupones que tengan este tipo de cupón, dichos cupones serán enviados a la cola RabbitMQ o a CRM)
    • Redimido (al redimir cupones que tengan este tipo de cupón, esos cupones serán enviados a la cola RabbitMQ o a CRM)
    • Emitido/Redimido (al emitir/redimir cupones que tengan este tipo de cupón, los mismos será enviados a la cola RabbitMQ o a CRM)
    • Anulado (al anular cupones que tengan este tipo de cupón definido, se enviarán esos cupones a la cola RabbitMQ o a CRM)
    • Vencido (cuando venzan los cupones que tengan este tipo de cupón, los mismos serán enviados a la cola RabbitMQ o a CRM)
    • Activo (al momento de activar los cupones que tengan este tipo de cupón, esos cupones se enviarán a la cola RabbitMQ o a CRM).

Con lo cual al definir una exportación para un tipo de cupón determinado, por ejemplo para el tipo de cupón 001, se definió que se exportarán a las colas RabbitMQ los cupones que tengan este tipo, cuando (estas son las acciones) se emitan estos cupones, y cuando venzan, y cuando estos cupones sean emitido/redimido.

Una vez seleccionados el Destino y la Acción, debe presionar el botón que tiene un diskette para guardar esa exportación. Luego cuando se haga esa acción con ese tipo de cupón que tiene definida una exportación, ese cupón será enviado a la cola RabbitMQ o al CRM definido en la configuración.


Nota

  • Las exportaciones definidas no pueden modificarse. Pero sí pueden eliminarse y volver a crear.
  • Los campos Destino y Acción no son requeridos.
  • No puede cargarse dos veces la misma acción para el mismo destino. Si intenta hacerlo el sistema mostrará el siguiente mensaje:


Al seleccionar el botón "Eliminar" el sistema pedirá confirmación mostrando la siguiente pantalla: 


En la pantalla "Administración de Tipos de Cupones" se verá la columna "Destino Exportación" donde se mostrará para cada tipo de cupón el Destino y la o las Acciones guardadas. Si no se guardó ninguna exportación para ese tipo de cupón se mostrará vacío el contenido para ese registro en dicha columna.


Cupones

Desde la consola de PROMO se podrán definir, diseñar e importar cupones propios o externos que luego podrán ser emitidos y/o redimidos desde los puntos de venta.

La gestión de los cupones será responsabilidad de la consola de promociones, mientas que el motor de PROMO evaluará la aplicación de promociones que emitan y/o rediman cupones para luego informar de esto a la consola de promociones.

En esta sección se visualizarán los cupones dados de alta en la base de datos de PROMO.

Se visualizará el estado de cada uno de los cupones así como también se podrán visualizar los eventos asociados a cada cupón.

Al presionar en "Cupones" del menú "Fidelidad" se mostrará la pantalla "Gestión de Cupones" donde podrán visualizarse los cupones con su estado, identificador del cupón, tipo de cupón, identificador del cliente, cantidad de usos, fecha de emisión, fecha de redención y vencimiento.

En esta pantalla se dispone de filtros que permitirán realizar una búsqueda más detallada de los cupones ya sea por su identificador del cliente, identificador del cupón, tipo de cupón, estado, tienda o fecha de emisión desde y hasta.

Por default algunos filtros vendrán precargados a fin de limitar la búsqueda de cupones y no saturar la base de datos recuperando listas extensas de cupones. 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: Mostrará 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 pero al ingresar sugerirá en esta búsqueda la última semana.

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, los cuales estan descriptos en Paginado.

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


Al redimir un cupón, el mismo queda consumido. El cupón consumido no se puede reactivar.

       El monto beneficiado de un cupón no se puede consumir en diferentes transacciones. Si hay un remanente en un cupón, éste se pierde.


Alta Masiva de cupones

Al pie de la pantalla "Gestión de Cupones" se mostrará el botón de "Alta Masiva"

Al dar clic en este botón se presentara a pantalla "Alta Masiva de Cupones".

Solo se podrá hacer una carga masiva para tipos de cupón pre-impreso y no-nominado.


Para realizar un alta masiva de cupones se deberá seleccionar en el menú "Tipo de cupón" los tipos de cupones pre-impresos y no-nominados que se hayan creado en "Tipo de Cupón" previamente y se deberá especificar la "Cantidad" de cupones a generar.

NOTA

El máximo de cupones a generar por este medio será configurable desde Administración >> "Información de Configuración" en el parámetro "coupon.bulk".


En la pantalla "Alta Masiva de Cupones" se listara el historial de transacciones que generaron cupones desde la más reciente a la más antigua con las siguientes columnas:


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

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


Se cuenta con la opción "Ver Informe" al final de cada transacción que genero cupones de manera masiva. Al presionar en este botón se direccionara a la sección de "Informes" >> "Cupones" donde se mostrara la lista de cupones generados en ese proceso.

Los filtros que se ofrecen, de ingresar por esta sección, para visualizar los cupones Pre impresos serán: "Identificador" y "estado" y este último ya se mostrara precargado con el estado "Emitido" (al crear el cupón el estado es Inactivo, existe un proceso interno que lo pasa automáticamente de Inactivo a Emitido, hay que darle tiempo a que se ejecute ese proceso para que cambie de estado). El botón "EXCEL" permitirá obtener un archivo .xls con loas cupones que aparecen en pantalla.

El cupón debe estar Activo o sea en estado Emitido para que la promoción lo pueda utilizar.

Crear la Promoción que emita el cupón

        

     Creación de Plantilla de cupones


Al momento de dar de alta un tipo de cupón se podrá generar la plantilla de promoción que incluya entre sus elementos el tipo de cupón que se está generando,  ya sea una plantilla para la emisión de un cupón, donde el tipo de cupón es otorgado como beneficio No Monetario (Cupón), o bien para redención del cupón, en donde se evaluará la existencia del tipo de cupón generado dentro de la transacción (condición simple).


Información

 Beneficio cupón: la aplicación del beneficio es emitir cupones.

Beneficio cupón calculado: la aplicación del beneficio es emitir cupones por un determinado monto de descuento calculado en base al total de la transacción.

Para Cupón Calculado:

En el beneficio de la promoción que emite: el Tipo de Beneficio tiene que ser: No Monetario y la Clase de Beneficio: Cupón Calculado.

En el beneficio de la promoción que redime: el Tipo de Beneficio tiene que ser: Monetario, y la Clase de Beneficio: Canje de cupón calculado.


Para cupón (no calculado):

En el beneficio de la promoción que emite: el Tipo de Beneficio tiene que ser: No Monetario y la Clase de Beneficio: Cupón.

En la condición tiene que estar el tipo de cupón que fue emitido (o algo que haga referencia al cupón que fue emitido), el beneficio de la promoción que redime: va el descuento que se hace por ejemplo $2.

Se pueden ver ejemplos en: PROMO - Manual de Usuario Final 7 - Apéndices - Español#ManualdeUsuarioFinal7-Ap%C3%A9ndices-Espa%C3%B1ol-_Toc513717178%22Llevando3om%C3%A1sart%C3%ADculosdeldto.Limpieza,ganaunCup%C3%B3n%22


Se debe crear la promoción que emite el cupón y la promoción que redime el cupón

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

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 será 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 será 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: 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.
            • Días desde la activación: 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.0.20) Al momento de chequear el campo "CVV Requerido", se habilitara el combo "Canal exceptuado de CVV" desde donde se podrá indicar que "canal" quedará exceptuado de la validación de CVV al momento de realizar alguna operación con este tipo de 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án exceptuarse canales de la validación de CVV. Cuando el catalogo de canales este cargado, al desplegar el combo se mostraran los canales allí presentes y podrá seleccionarse uno para exceptuarlo de la validación de CVV; en las operaciones donde se ingrese una tarjeta de fidelidad.

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


            IMPORTANTE

            Cuando desde un punto de venta se envíe una consulta u operación con tarjeta de fidelidad, se evaluará el atributo "channel" de la cabecera del mensaje para validar si el canal allí indicado coincide con el definidos en el canal exceptuado para el tipo de 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 así 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 aquí 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. Tener en cuenta que no debe dejarse espacio entre rangos de prefijos.

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. 

Ejemplo del archivo a subir:

Nota: No debe dejarse espacio entre los rangos de prefijos.

Luego se debe seleccionar el botón "Procesar Archivo". Una vez procesados mostrará una pantalla como la siguiente:

Formato para el ingreso de rango de prefijos: desde-hasta. Ejemplo 100-140,245-280. (Si se desea ingresar un solo rango por ejemplo el 111 se deberá ingresar de la siguiente manera: 111-111). En donde los valores desde y hasta van a estar separados por un guion medio y entre rangos el separador va ser una coma. Tener en cuenta que entre rangos de prefijos no debe dejarse espacio. El tipo de archivo a ser procesado, deberá ser .CSV o .TXT en donde el nombre del archivo es indistinto mientras se respete el tipo.

El sistema va a procesar el archivo, descartando los rangos que no cumplan con las condiciones mencionadas en la Nota popUp "Ingresar Rango de Prefijos".

Todos los rangos que cumplan las condiciones se cargarán y se verán por pantalla, luego si el sistema detecta rangos que no cumplan con las condiciones descritas anteriormente mostrará un mensaje informando la situación al cliente y esos rangos no se agregarán. Mostrará una pantalla como la siguiente:

En la pantalla "Gestión de tipos de 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.

Con la opción "cardType.incrementalCode", clave "code.active" si lo configura en "true" estará indicando que desea utilizar código numérico incremental para tipos de elemento de fidelidad. Los valores posibles son "true" o "false".

De setearse "true", el rango de prefijo, se ingresará automáticamente. El sistema sugerirá rangos de prefijos. Al habilitarse esta funcionalidad no se deshabilita la posibilidad de edición del rango de prefijos, pudiéndose agregar un nuevo rango, o eliminar el rango autogenerado y colocar otro. Al presionar el botón "Nuevo rango de Prefijos", se mostrará ya definido el campo rango de prefijos.

Al seleccionar el lápiz en la sugerencia de Rangos de prefijos, o el botón "+Agregar prefijos", mostrará la siguiente pantalla:


De setearse "False" se podrá hacer ingreso manual. Podrá optarse por definir un solo prefijo a partir del cual podrán generarse 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|valid-from|valid-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.
valid-from/valid-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 restará saldo.

Si no se ingresa signo, se reemplazará el monto existente por el informado en el archivo.


Ejemplo:

55500000000000010000|2222|-2000

55500000000000010011|3333|2000

55500000000000010022|4444|+2100

55500000000000010044|7777|2100


Una vez procesado el archivo se guardará en la base con el estado "procesado", de manera que no pueda ser procesado nuevamente.


El archivo, será sujeto a las siguientes validaciones:

          • 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

1Activación
2Inactivación
3Asociación cliente
4Desasociación cliente
5Devolución
6Consulta
7Carga
8

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
9Saldo manual
10

Venta

(si trae un motivo no se muestra ese motivo que trae se muestra siempre Venta)

11

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.
12Redención parcial
13Redención total
14Transferencia
15Cancelación
16Vencimiento
17Extensión de vigencia
18Asignació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.


En el campo Monto de la pantalla anterior

El saldo se modificará de acuerdo al signo que se ingrese:

Si el signo a la izquierda del campo es positivo ( + ) sumará el saldo.

Si es negativo ( - ) se restará saldo.

Si no se ingresa signo, en esta pantalla, se sumará el monto ingresado al existente.


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


                    • Trasferir: podrá transferirse saldo entre 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

                                               

                                               Un convenio es un acuerdo establecido entre dos o más entidades con la finalidad de dar beneficios a los clientes.

Desde la consola de Promo se podrán dar de alta "Convenios", que luego podrán ser asociados a 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 (Asignar convenios 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.


Importante

Un cliente sólo podrá tener un tipo de  elemento de fidelidad asociado a un mismo convenio. Es decir un cliente no podrá poseer dos o más tarjetas de fidelidad que esten asociadas a un mismo convenio.


Clientes

A presionar en "Fidelidad" > "Clientes" se visualizara la pantalla "Gestión de Clientes" en donde podrán visualizase los clientes presentes en PROMO. 


Se podrá acceder al detalle de cada uno de los clientes y visualizar, en caso de poseer, los elementos de fidelidad, cupones asociados, así como también el estado de cada uno de estos elementos de fidelidad. Para ello se deberá presionar (en la vista Gestión de Clientes) en el menú desplegable "Acciones" y luego en "Ver". 



Más abajo se muestra el informe de “Movimientos de Límites por Cliente” donde se detallarán las promociones en las que haya participado el cliente y que tengan un límite de cliente asociado que se haya consumido para él, pudiéndose filtrar por rango de fechas las promociones aplicadas.

Importante

La sección “Movimientos de Límites por Cliente” posee dos filtros de fecha, para seleccionar un período de búsqueda que  por default mostrará un rango de los últimos 3 meses, pero se podrá filtrar el período deseado. Si se filtra por un rango de fecha mayor a tres meses se mostrar un Banner con el mensaje : "Seleccione un rango de fecha menor o igual a 3 meses"



En la parte inferior de la vista se detallarán los cupones y elementos de fidelidad asociados al cliente, con su correspondiente estado.

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 una rayita ( - ) (excepto el código), y ese cliente quedará en estado inactivo. Sólo seguirá teniendo como referencia el código. Si este cliente tenía datos de fidelidad van a seguir existiendo.



IMPORTANTE

Se pueden recuperar los datos de fidelidad del cliente que fue eliminado parcialmente; ya que se dispone de su Código.

Se debe tener en cuenta que si se agrega en el catalog.Customer (Catálogo de Clientes) datos de otro cliente utilizando el Código del cliente eliminado parcialmente, a ese cliente se le agregarán los datos de fidelidad del cliente eliminado parcialmente.


                                         En la vista Registro de auditoría se registrará la eliminación parcial:

                                         

                                         

Si se selecciona la opción "Eliminar Datos y Fidelidad del Cliente" y luego presiona el botón "Eliminar":

    El sistema mostrará un cartel pidiendo confirmación "Está seguro de eliminar los datos del cliente seleccionado?" mostrará botones: Aceptar/Cancelar. Si el usuario confirma presionando el botón "Aceptar" el sistema eliminará:

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

Si presiona el botón "Cancelar" no se eliminará ningún dato. 

El sistema mostrará un cartel pidiendo confirmación "Está seguro de eliminar los datos del cliente seleccionado?" mostrará botones: Aceptar/Cancelar.

Si el usuario confirma presionando el botón "Aceptar" el sistema eliminará, y sus datos no se verán reflejados en la vista de Gestión de Clientes. Si este cliente tenía datos de fidelidad van a ser borrados.

En el ejemplo ya no se observa el registro de código 1.


En la vista Registro de auditoría se registrará la elmininación total:




Capítulo 10 - Módulo de Informes


PROMO - Manual de Usuario 7.0 - Informes





Capítulo 11 - Módulo de Negocio


Menú de Negocio


Este menú proporciona la creación y administración de unidades departamentales, compañías  y tiendas que se disponen dentro del negocio.


Tiendas


La tienda es la unidad mínima que se tomará para la distribución de mapas. Se pueden definir diferentes métodos de distribución para cada una de las tiendas. Desde el menú Negocio > Tiendas, se accede a la Pantalla de Administración de Tiendas:



Se disponen los filtros:

        • 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 la tienda
            • 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 será enviado con un path relativo /codigo_empresa/codigo_tienda.  Con esto el motor sabrá que debe descargar el archivo en c:\mimotor\sales\codigo_empresa\codigo_tienda


Caso contrario, si la distribucion automatica se realia en un NO opera en modo "Multitienda" el mapa será enviado con un path relativo /código_empresa.  Con esto el motor sabrá que si su path de mapas es c:\mimotor\sales, deberá descargar el archivo en: c:\mimotor\sales\codigo_empresa.



Si se utiliza un tipo de distribución automática para una tienda no se podrá definir luego otra conexión, así como tampoco podrá definirse un tipo de distribución automática cuando la tienda tenga definida ya otro tipo de distribución, por lo que deberá eliminarse el tipo de definición no automático definido y luego si se podrá definir el tipo de definición automático solamente.


Motor Multitienda

Al definir las conexiones también podrá indicarse si el motor que se utiliza posee configuración Multitienda.

De no tildarse la opción "Motor Multitienda" se indicara que el motor no opera con multitienda, por lo que la consola creara el directorio \SALES al distribuir, debiendo configurar las rutas de deploy sin indicar este sub directorio. (Ej.: C:\synthesis\Promo\engine)

En caso de que se opte por operar con Motor Multitienda, deberá tildarse la opción "Motor Multienda", por los que la consola NO creara el directorio \SALES al distribuir, teniendo entonces que indicarlo explícitamente cuando se defina la ruta de distribución (Ej.: C:\synthesis\Promo\engine\sales).


Asociar Motor

Se podrá asociar una tienda determinada a uno o varios motores que operen en ella. Estos motores informaran cada una determinada cantidad de tiempo cual es el mapa activo con el que está operando.

Para ello deberá darse clic en "Asociar Motor".




IMPORTANTE

Cuando un nuevo motor se instale, este se reportará a la consola de PROMO que se haya definido (URL indicada en el archivo config.xml del motor), se reportará quedando ONLINE y a la espera de que sea asignada a una tienda y se le distribuya un mapa.

El id del motor configurado en el archivo config.xml (ese es el nombre del motor que se mostrará en la selección) tiene un límite de 100 caracteres.



Al presionar en "Asociar Motor" se presentará el siguiente pop-Up:


De los motores disponibles deberá de seleccionarse el que se desee asociar a la tienda. 

Al presionar "Guardar" se mostrará en la pantalla de edición de tiendas, el motor asociado a ella y que reportará su mapa activo a la consola.




Se podrán asociar nuevos motores a la tienda así como también eliminar la asociación realizada.

Importante

Cuando se crean nuevas compañías; si ya existe un motor asociado a una existente, la nueva no verá el estado de dicho motor en Soporte, Estado del Sistema. Cuando se distribuya manualmente un mapa vigente en una tienda de la nueva compañía ; ya se le podrá asociar el motor y esta nueva compañía podrá ver el estado del mismo en Soporte, Estado del Sistema; seleccionado el ítem motor.


 Competidores


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

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

Alta de Competidores:

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

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

Se deberán completar los campos:

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

  

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

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


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

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


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

Se deberán completar los campos:

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

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


Modificar Competidor:

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

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

El campo “Código Identificador” es editable.

El check Activo, se puede habilitar o deshabilitar

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

           

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


Publicación de precios del Competidor:


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


  

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




Nuevo Segmento

Con el botón "Nuevo" se puede crear un nuevo segmento.

Los datos a ingresar son los siguientes:

Código: campo alfanumérico, requerido y sin limitaciones de longitud. Su valor debe ser único.

Nombre: campo alfanumérico, requerido y sin limitaciones de longitud. Su valor debe ser único.

Al seleccionar “Guardar y continuar”, mostrará la pantalla “Detalle” , ahí se carga desde “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, y el tipo de dato tiene que ser texto). 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.

En la importación de clientes por catálogo se puede indicar el o los segmentos que se encuentren asociados al cliente.

Importante

Los datos que se ingresen a través del archivo que asocia a clientes a un segmento reemplazan los datos existentes.

                    

Utilización del segmento:

Al crear una nueva promoción en "Condiciones Simples" o en "Condiciones por composición", en el elemento "Clientes" al desplegarlo muestra el atributo “Segmento” al seleccionarlo muestra: Igual o distinto.



IMPORTANTE

Los segmentos se pueden administrar desde Promo como se detalla arriba o puede utilizar segmentos externos (que no administra Promo) asociándolos al cliente desde el catálogo de Clientes (catalogCustomer). Si utiliza segmentos cargados desde el catálogo de clientes esos se tomarán como prioritarios.




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


El módulo de administración permite realizar ajustes dentro de la consola tales como habilitar o des-habilitar funcionalidades, cargar catálogos entre otras.

El acceso a éste módulo será autorizado solamente para un usuario administrador con los permisos correspondiente para éste menú.


Menú de Administración


Éste menú permite administrar y configurar distintos accesos a PROMO.

        



Dashboards

Al presionar el botón de Dashboard se podrán administrar y reconfigurar los Dashboard que ya trae por default la consola de PROMO o bien se podrán generar nuevos que luego se visualizaran desde el menú de Dashboard.

Al presionarse en el botón "Dashboard" del menú Administración se visualizara la ventana "Administración de Dashboard" donde se listaran los Dashboard por default así como también los Dashboard personalizados que pudieran haberse generado.

A la izquierda de cada Dashboard se encuentra el botón "Acciones" desde el cual se podrán Editar, Definir o Ver los Dashboard existentes.

Al pie de esta ventana se encuentra el botón "Nuevo" desde el cual se podrán generar nuevos Dashboard.


Nuevo Dashboard

Al presionar en el botón "Nuevo" se mostrara la siguiente pantalla desde la cual se podrá ingresar el nombre, código y formato de visualización del nuevo Dashboard, también se cuenta con un check para habilitar o deshabilitar el Dashboard que se está generando.

Luego de cargados los datos solicitados, se deberá presionar el botón "Guardar" y se mostrara la pantalla de edición de Dashboard.


Editar Dashboard

Ya sea si se genera un nuevo Dashboard o si se está editando uno ya existente, al presionar guardar se mostrara la ventana "Edición de DASHBOARD: xxx" donde "xxx" corresponde al nombre del Dashboard que se está editando o generando.

En esta pantalla se propondrán diferentes KPI o indicadores que podrán 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").

Carga de Catálogos desde un Archivo desde las carpetas

Desde Administración \ Información de Configuración, buscando por la clave: "fileDirectory" encontrará la ruta con la descripción "Importación de catálogo: directorio donde estarán los archivos" donde podrá dejar los archivos de catálogos que desea se carguen en forma automática en la consola de Promo. El contenido de cada archivo aparecerá en el catálogo de Promo que corresponda si tiene el nombre y la información estrucutrada de acuerdo a lo esperado (ver detalle mas abajo). Los archivos se cargarán luego de que se ejecute automáticamente el proceso que importa los catálogos.


Carga de Catálogos desde un Archivo desde la consola de Promo

A continuación se proveerá la información necesaria para la administración y carga de los catálogos desde la consola de PROMO.

Si se desea realiza la carga de catálogos por intermedio de un archivo, habrá que confeccionarlo en formato de texto, separando los campos por "|" (Pipe).

Este formato podrá ser reconfigurado desde la consola en caso de ser necesario (Ver Administración >> Información de Configuración - clave: "Separator")


A modo de ejemplo, se detallará un registro perteneciente a un catálogo de carga de ítems (catalogitem.catalog). 


Ejemplo:
El catálogo de "productos", está conformado por los campos: "code", "name", "unitprice", "level1", "level2", "level3", "level4", "supplier", "brand".

El archivo catalogitem.catalog, quedará conformado de la siguiente forma: 1252|Game FIFA 10 for PS3|50|Elec|VGCo|PS3G|5|PR1|5


Para proceder a la carga, se deberá presionar el botón "Importar" en la ventana "Importación de Catálogos" que se corresponda con el catálogo que se está queriendo procesar.

Para nuestro ejemplo, deberá presionarse el botón "Importar" que se muestra en el catálogo "catalogitem".


Se presentara un pop-up desde el cual se deberá buscar el archivo catalogitem.catalog anteriormente generado y presionar el botón "Ejecutar importación del catálogo".


Luego de procesado el archivo podrá visualizarse la cantidad de registros procesados 

También podrá visualizarse un resumen de los registros importados presionando en la lupa que aparece a la derecha, en el mismo renglón de importación.


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
namestringrequerido


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|addressPostalCode|phone|isActive|segments


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

Los siguientes campos son de carga obligatoria para el correcto procesamiento del catalogo de clientes:

  • código (code)
  • nombre (name)
  • apellido (lastName)
  • tipo de cliente (customerType)
  • nro de identificador (identifier)
CampoTipo de datoObservaciones
codestringCorresponde al código que se le asignara al cliente en Promo. (requerido)
namestringNombre de cliente. (requerido)
lastNamestring
Apellido del cliente. (requerido)
genderstring
Genero del cliente (en caso de "Validar catálogos relacionados al catálogo de clientes" este en "true", el dato definido en este campo deberá coincidir con alguno de los códigos de género "catalogGender.catalog" previamente cargados.)
birthDatestring
Fecha de nacimiento del cliente. Formato: año-mes-día siendo el año de cuatro dígitos, y el mes y el día de dos dígitos
identificationTypestring
Tipo de identificación del cliente. (en caso de "Validar catálogos relacionados al catálogo de clientes" este en "true", el dato definido en este campo deberá coincidir con alguno de los códigos de tipo de identificación "catalogIdType.catalog" previamente cargados.) requerido
identifierstring
Numero de identificación del cliente. (requerido)
identificationExpirationstring
Fecha de expiración de la identificación del cliente.
nacionalitystring
Nacionalidad del cliente
emailstring
e-Mail del cliente.
customerTypestring
Tipo de cliente (requerido) / / (en caso de "Validar catálogos relacionados al catálogo de clientes" este en "true", el dato definido en este campo deberá coincidir con alguno de los códigos de tipo cliente "catalogIdType.catalog" previamente cargados.)
addressstring
Dirección del cliente.
addressCountry
string
País del cliente. (en caso de "Validar catálogos relacionados al catálogo de clientes" este en "true", el dato definido en este campo deberá coincidir con alguno de los códigos de Pais "catalogCoutry.catalog" previamente cargados.)
addressStatestring
Provincia de residencia del cliente. (en caso de "Validar catálogos relacionados al catálogo de clientes" este en "true", el dato definido en este campo deberá coincidir con alguno de los códigos de Provincia "catalogState.catalog" previamente cargados.)
addressCitystring
Ciudad de residencia del cliente. (en caso de "Validar catálogos relacionados al catálogo de clientes" este en "true", el dato definido en este campo deberá coincidir con alguno de los códigos de Ciudad "catalogCity.catalog" previamente cargados.)
addressPostalCodestring
Código Postal
phonestring
Teléfono
isActivebooleanoIndicara si al momento del alta el cliente estará Activo o Inactivo. Deberá definirse como true o false.
segmentsstring
Segmento/s asociado al cliente. Es recomendable que, previamente a ingresar nuevos clientes por catálogo que tengan indicado uno o más segmentos asociados, se creen los segmentos en la consola de Promo en Negocio/Segmentos.


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)
unitpricenuméricoPrecio Unitario del producto
level1stringDepartamento del producto
level2stringFamilia del producto
level3stringCategoría del producto
level4stringSub Categoría del producto
supplierstringProveedor del producto
brandstringMarca del producto
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

IMPORTANTE

El catálogo de items es el único catálogo que soporta por consola, es decir por archivo, la importación del mismo con atributos dinámicos para el elemento producto.

Si el usuario agregó atributos dinámicos de elementos para el elemento Producto, por ej. los atributos dinámicos: m1 y m2, el formato del catálogo de items a subir será:

el formato base ya detallado arriba + los atributos dinámicos creados:

code|name|unitprice|level1|level2|level3|level4|supplier|brand|detail|detail2|m1|m2


 Nota:

Para distinguir cuales son los atributos dinámicos que debe agregar en el catálogo de items a importar (son los que agregó el usuario) también puede distinguirlos en la página "Gestión de atributos de elementos" filtrando por elemento "Productos" y estado "Activa", serán los que muestren el botón "Editar" no grisado.

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



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

IMPORTANTE

Se puede importar un atributo de elemento sólo para el catálogo de Productos; para los otros catálogos no es posible.

Cuando se agrega un atributo de elemento; éste campo debe agregarse al archivo .catalog ( en éste caso, catalogItem.catalog), que se usará para importar dicho elemento. Puede tener un valor o puede estar vacío.

Ejemplo:

 Se agrega un atributo color al Producto:


En el archivo .catalog:

catalogItem.catalog
11020|producto 1|1050|Dto1|flia1|Cat11|SubCat12|Prov21|Marca1||Det2|verde

Al importarlo en la consola, la operación se ha realizado con éxito:


 Tareas Programadas

En esta sección se podrá configurar la frecuencia con que se ejecutaran distintos procesos que tiene como fin el mantenimiento de los datos manejados desde la consola.

Los procesos disponibles son:

  • Proceso de posteo de datos vía RabbitMQ: Por cada compañía si está activa la configuración rabbitMq.producer.enabled de esa compañía, va a buscar a la tabla PromoOutQueue registros de esa compañía que sean de tipo: alarma, alarma mapa distribuido, cupón, lista de precios, promociones, transacciones, estado de límites, histórico de trajetas, caché de promociones y envía estos registros a esas colas. Es decir, que si está activa la config de esa compañía, por cada una, verifica si hay que enviar algo a las colas configuradas, y en ese caso, las envía a esas colas en particular, dependiendo de cada uno de los elementos.
  • Importación de Catálogos: Aquí podrá ejecutarse la tarea de importación de catálogos de manera manual así como también configurar la frecuencia con la que se ejecuta el proceso de búsqueda e importación de nuevos catálogos. 
  • Eliminar registros de las tablas de importación: Aquí podrá ejecutarse la tarea de eliminación de registros de las tablas de importación, así como también podrá configurarse la frecuencia con que se limpiaran las tablas de Importación de datos externos. 
  • Actualización de Listas de Precios: Podrá ejecutarse la tarea de actualización de los registros de la tabla PriceList. Por default se ejecuta una vez al día, pero se puede configurar la frecuencia; también se puede ejecutar manualmente a demanda. Al ejecutarse este Job se lanzan siete procesos: cuatro de listas de precios y tres alarmas de listas de precios.
  • Eliminar registros de auditoria: Podrá ejecutarse de forma manual el proceso de eliminación de registros de auditoria y también podrá configurarse la frecuencia con que se limpiaran las tablas de Auditoria de manera automática. 
  • Eliminar registros de transacciones y errores en reverso: Podrá ejecutarse de forma manual el proceso de eliminación de transacciones y errores en reverso así como también podrá configurarse la frecuencia con que se limpiaran estos registros de manera automática. 
  • Generación de caché de ítems participantes en promociones: Al ejecutarse genera sugerencias, en los sitios web, cuando se realiza una transacción la aplicación informa en qué promociones se pueden encontrar los productos que se compran.
  • Generación y distribución programadas de mapas: Se configura la hora de ejecución y gestiona la distribución de los mapas (validaciones, etc.).
  • Importación de Compañías: En el caso de que se esté trabajando con una integración de PROMO con Bridge esta tarea traerá desde el servidor configurado las compañías dadas de alta en Bridge y las dará de alta en PROMO con la configuración de compañía indicada y actualiza en Promo las tiendas importadas. 
  • Realizar un Backup de la base de datos: Podrá ejecutarse de forma manual el proceso de backup de toda la base de datos de PROMO así como también podrá configurarse la frecuencia con que se corre este proceso de manera automática. 
  • Proceso para obtener los planes de pago desde : Permite configurar la hora de ejecución; obteniendose  los datos del plan de pago desde . Se debe configurar una Key de información de configuracion .url( la url es la direccion al servicio rest de ).
  • Informa el estado de la Consola y Motor: (a partir de Promo 7.0.4) Este proceso se utiliza para el posteo del status de motor y consola en las colas RabbitMQ.  


Importante

El Job sts.console.job.ConsoleStatusJob por defecto se ejecutará cada 5 minutos, pudiendo modificar el tiempo de ejecución desde Administración ->Tareas programadas.: (ingresando con el usuario principal):


Ingresando en la consola de Promo con el usuario administrador, la siguiente configuración debe ser mayor a la definida en el job (imagen anterior). Por ejemplo configurar el doble de tiempo:

  • Aplanado de Transacciones: Permite configurar el período de ejecución (gralmente 15 minutos), al ejecutarse procesa todas las transacciones de commit y rollback, descomprime (request y response) y lo transforma en información que luego puede verse en los reportes.; incluyendo el posteo a Rabbit.
  • Exportación de cupones: Permite configurar el Job que exportará los históricos de cupones a los destinos configurados (Rabbit, CRM, etc) (por lo gral. se ejecuta cada 2 min.)
  • Actualización de estados de entidades: Aquí se configura la frecuencia con que se realiza la actualización de los estados de tarjetas de fidelidad y cupones, así como correr el proceso de manera manual cuando se desee. A partir de esta versión,  permitirá el posteo de las promociones excluidas para las tiendas de la compañía, el cual enviara un mensaje con el listado con los nombres de las promociones excluidas por el día.
  • Finalización de transacciones: Aquí podrá configurarse con qué frecuencia se procesaran las transacciones provenientes del motor así como también la actualización de datos provenientes de la emisión y redención de cupones e imputación o descuento de saldos de tarjetas de fidelidad y correr el proceso de manera manual cuando se desee. 
  • Proceso de vencimiento de puntos: Aquí se configura la frecuencia con que se corre el proceso que chequea los puntos a vencen de las tarjetas de fidelidad y los pasa a "Vencidos", así como correr el proceso de manera manual cuando se desee. 
  • Proceso de actualización de Límites: Aquí se configura la frecuencia con que se ejecutara el proceso de actualización y reinicio de los límites en las promociones, así como correr el proceso de manera manual cuando se desee. 
  • Importación de entidades: Aquí se configura la frecuencia con que se ejecutara el proceso de importación de datos de externos a la consola de PROMO, así como correr el proceso de manera manual cuando se desee. 
  • Finalización de las devoluciones: Permite configurar la frecuencia (por default 47 segundos), con que se procesarán todas las transacciones de devolución.Busca procesar todas las transacciones con trxStatus = COMMIT_PENDING y trxType = RETURN.
  • Proceso para recolectar información para las Views: Aquí se configura la frecuencia con la que se procesa la información que llega a PROMO para abastecer los gráficos de los Dashboard, así como correr el proceso de manera manual cuando se desee. 

(a partir de Promo 7.0.4):


Importante

Esta funcionalidad sólo estará disponible para aquellos usuarios que tengan configurados los permisos correspondientes.



Información de configuración

Existen parámetros de configuración que pueden ser modificados para personalizar el comportamiento de PROMO.
Estos parámetros se encuentran en la Consola de PROMO, Menú "Administración" >> "Información de Configuración" y su detalle se encuentra en:

                PROMO 7.0 - Manual de Instalación 7.0 - Información de Configuración



Importación de Promociones

PROMO facilita la herramienta de importación de promociones dentro de la consola para agilizar los procesos de actualización ante alguna actualización de versiones o necesidad de regenerar datos.

Por medio de esta herramienta, podrán cargarse de manera masiva promociones que se encuentren en mapas que fueron generados con versiones de consola de PROMO anteriores, así como también generadas por una misma versión pero desde otra consola.

Al presionar el "Importación de Promociones" del menú "Administración" se presentara la siguiente pantalla:


Los mapas con las promociones que se quieren 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.

Al importar un mapa que contenga Promociones con Propiedades de Beneficios; éstas deben existir en la consola; caso contrario en la consola la promoción importada no lo mostrará.



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.

IMPORTANTE

Es importante que el usuario tenga en cuenta que cuando importa una promoción la aplicación generará un id de beneficio diferente, para que el mismo no se duplique.

Ej:

En el .xml del mapa que se va a importar el usuario puede comprobar que el id del beneficio es:

Pero al importar en la consola se puede comprobar que el id del beneficio es:


Esto se debe tener en cuenta tanto al importar por .xml o vía REST.

Al importar una promoción se debe tener en cuenta el workflow asociado al usuario que está llevando a cabo la importación.

  1. Si el usuario no tiene asociado un workflow (en la vista Administración de Usuarios/Asociación a workflows), o sea no tiene tildado ningún checkbox :

la promoción se importará con el workflow general.

2.  El usuario tiene asociado varios workflows, excepto el general

la promoción se importará con el primer workflow de la lista, ordenado alfabéticamente

3.El usuario tiene asociado todos los workflows definidos en la consola:

la promoción se importará con el workflow general




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 será necesario indicar el motivo o causal que derivo en dicha modificación, ya se de suma o de quita de saldos.

Primero será requisito dar de alta el motive de modificación de saldo, accediendo a la sección Administración>> "Motivos de Modificación de saldos" y se presentará la siguiente pantalla desde la cual podrán gestionarse los distintos motivos de modificación de saldo dados de alta.


Presionando en "Nuevo" podrá generarse un nuevo motivo, indicando los siguientes datos:


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


Importante

No se podrán importar catálogos de Clientes, Medios de Pago ni Eventos con atributos de elementos por consola; solamente catálogos de Productos.



            • 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 distribuirá el archivo entities.xml a todos los motores conectados a la consola desde la que se hace la distribución; excepto a los motores de simulación.

Para ello, una vez creado el nuevo atributo se debe descargar el archivo de definición

 

y pegarlo en la ruta del motor de simulación:

Para que el nuevo atributo sea considerado en las transacciones. Si no se realiza esto, al hacer la devolución, ésta quedará en COMMIT_PENDING.


Validación de atributo entre elementos:

Se puede definir que al momento de dar de alta una promoción, al ingresar una condición por el elemento "producto", atributo "SKU", se valide que en la estructura de éste, se encuentre definido otro atributo, Por lo que cuando se ingrese como condición el "Código - SKU" se requerirá el ingrese de el o los atributo asociados así como también se validara que el o los atributos asociados estén definidos en la estructura del "Código-SKU". Para que Promo realice esta validación deben realizarse las siguientes configuraciones:

            • 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 relacionarse con el elemento "Código-SKU".
            • Desde Administración \ Atributos de elementos, buscar el atributo "Código-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 "Código-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 "Código - 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 identificará al grupo de atributos que se esta dando de alta.
          • Nombre: campo alfanumérico, deberá indicarse el nombre que identificará 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.

Importación de promociones con los atributos de cabecera deshabilitados

Es posible insertar promociones, cuando se inactiven los atributos de cabecera, en la consola.

Si en la consola se ha definido una promoción con atributos de cabecera; éstos estarán en la vista de detalle de la misma mientras los atributos estén activos:

Para deshabilitarlos, el usuario debe,  en la vista Gestión Atributos de la Cabecera, presionar el botón 

la aplicación desplegará la vista Editar Atributos de la cabecera; en este ejemplo para el atributo "Programable"

y allí destildar el ckeck "Activa"

Al importar  la promoción que contenía este atributo, vía rest, la nueva promoción no mostrará el campo de cabecera deshabilitado en su detalle:

Si se activa nuevamente el atributo y se vuelve a importar la promoción; en la consola se reflejará el cambio. Los atributos de cabecera se crean vacíos; porque son requeridos.

Si los atributos de cabecera sólo son requeridos, pero no activos, la promoción se importa y crea correctamente, pero los atributos no se mostrarán en la cabecera de la promoción.





Capítulo 13 - Módulo de Seguridad


Menú de Seguridad


Desde esta opción de menú se podrá asignar accesos a los roles disponibles y administrar los usuarios.




Administración de usuarios

Dentro de éste módulo se podrá configurar cada uno de los usuarios que provee PROMO por default, así como también la creación de nuevos usuarios.

Se podrán configurar: nombre, contraseña, habilitación, políticas de seguridad y asignar los roles para cada uno de los usuarios.

Desde el menú Seguridad > Administración de Usuarios, se ingresa a la siguiente pantalla:

 

Desde el botón "Acciones" que se encuentra al final de cada renglón que describe un usuario, podrá editarse el perfil del usuario o realizar el cambio de contraseña.

Podrán darse de alta nuevos usuarios presionando el botón "Nuevo". Se presentará la siguiente pantalla:



                • 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 Promociones
Permite ver  y modificar el Dashboard de PromocionesAdministrador
Ventas
Permite ver  y modificar el Dashboard de VentasAdministrador
Cupones
Permite ver  y modificar el Dashboard de CuponesAdministrador
Tarjetas
Permite ver  y modificar el Dashboard de TarjetasAdministrador
OperaciónCampañas
Visualiza menú Operación > Campañas y utilización de filtros de búsquedaAdministrador, Operador
Permite crear  y editar nueva campañaAdministrador
Condiciones generales
Visualiza menú Operación > Condiciones generales, utilización de filtros de búsqueda, ver el Resumen, ver Historial WFAdministrador, Operador
Permite enviar para aprobación condiciones generalesAdministrador
Permite editar y definir condiciones generalesAdministrador
Permite crear  y cancelar condiciones generalesAdministrador
Promociones
Permite visualizar las promociones y utilizar los filtros de búsquedaAdministrador, Operador
Permite crear, y copiar promocionesAdministrador
Permite cancelar promocionesAdministrador
Permite editar y definir promociones.Administrador
Permite agregar una imagen a la promociónAdministrador, Administrador de Negocio
Permite eliminar una imagen de la promociónAdministrador, Administrador de Negocio
 Permite enviar para aprobar una promociónAdministrador
Plantillas de promoción
Permite ver el listado de plantillas de promociones, utilizar los filtros de búsqueda y ver el ResumenAdministrador, Operador
Permite crear, editar y cancelar plantillas de promocionesAdministrador
Permite generar excel de las plantillas de promocionesAdministrador, 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. Administrador de negocio.
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. Administrador de negocio.
Plantillas de etiquetas
Habilita la creación, edición y búsqueda de plantillas de etiquetasAdministrador. Administrador de negocio.
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
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 fidelidadAdministrador
Permite activar tarjetas de fidelidadAdministrador
Ver movimientos de tarjetasAdministrador, Operador
Convenio
Permite ver el listado de convenios existentes y realizar búsquedasAdministrador, Operador
Permite crear un nuevo convenio o editar uno existenteAdministrador
Clientes

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

Administrador, Operador

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

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 CuponesHabilita Informe >Cupones > Tipos de CuponesAdministrador, Administrador de Negocio, Operador
CuponesHabilita Informe >Cupones > CuponesAdministrador, Administrador de Negocio.
Cupones VencidosHabilita Informe >Cupones > Cupones VencidosAdministrador, Administrador de Negocio.
Extracto de CuponesHabilita Informe > Cupones > Extracto de cuponesAdministrador, Administrador de Negocio.
Detalle de RedenciónHabilita Informe > Cupones > Detalle de RedenciónAdministrador. Operador. Administrador de Negocio.
TarjetasTipos de Tarjetas de FidelidadHabilita Informe > Tarjetas > Tipos de Tarjetas de FidelidadAdministrador, Administrador de Negocio, Operador
Tarjetas de FidelidadHabilita Informe > Tarjetas > Tarjetas de FidelidadAdministrador, Administrador de Negocio
Puntos/ Montos VencidosHabilita Informe > Tarjetas > Puntos/Montos VencidosAdministrador, 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
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 y realizar búsquedas de segmentosAdministrador, Administrador de Negocio
Permite editar y definir y realizar búsquedas de segmentosAdministrador, Administrador de Negocio
Compañías
Permite crear, editar, definir, activar, desactivar y buscar compañíasPrincipal
AdministraciónTareas Programadas
Ejecución manual, detención y planificación de tareas 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 usuario Administrador debe configurar en la consola de Promo, la dirección de Correo electrónico correspondiente al usuario que administra las alarmas (esta será la dirección de mail que recibirá las alarmas).


Estado: Podrá filtrarse entre Alarmas que estén activas y las que  estén inactivas.



NOTA

Solo podrán editarse las Alarmas que se encuentren Inactivas.





Cada alarma dada de alta dispondrá de un botón "acciones" desde el cual podrá desactivarse, editar, activarse y/o ver el detalle de cada una de ellas. Solo en las alarmas que estén inactivas se mostrará la opción editar.

Los roles y usuarios seleccionados al crear la alarma, serán los que recibirán las notificaciones de la misma; tanto por mail como por notificación por consola.

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:

Al presionar el botón "Editar" la aplicación desplegará el alerta a modificar; donde todos los campos son editables.

Para poder eliminar un valor del campo Roles y/o Usuario se debe mantener presionada la tecla control y el valor a quitar.

Ejemplo:

si se quiere eliminar el rol Administrador

luego de presiona Ctrl + dicho valor:

Nueva Alarma:

Para dar de alta una nueva Alarma, presionar el botón "Nueva" que se encuentra en la pantalla "Configuración de Alarmas" y se presentará el siguiente formulario:

Los datos solicitados para el alta de una nueva alarma son los siguientes:

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

Para poder llevar a cabo ésta tarea; tanto con usuario administrador (siempre que exista sólo una empresa; si hay más de una empresa, el admin tiene que asociar ese permiso al rol que corresponda), como con el Usuario principal, primeramente se debe configurar en Administración, Información de Configuración, la dirección donde se encuentran almacenados los backups y la dirección donde se encuentra almacenada la aplicación que ejecutará la importación.

 

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


Una vez que se ha restaurado la base de datos, se debe bajar la consola para que se ejecute el script y se efectué totalmente la migración.

IMPORTANTE

El BACKUP / RESTORE (Por empresa), no es para migrar datos a otro ambiente,  porque tiene dependencia con los datos  del ambiente donde se genera. El backup restore  es para recuperar datos si se ha cometido un error y se quiere disponer de la información anterior; sólo afecta a la empresa que lo hace.



Estado del 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 presentará la siguiente pantalla:


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


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

En caso de que un motor asociado a la consola no se reporte cada una determinada cantidad de tiempo (sea por falla en la conexión o por estar caído), el motor aparecerá Offline, informando los últimos datos recibidos.

Nota:

Tener en cuenta que la información del estado de consola y motor se depura semanalmente (por default). Si alguna consola o motor hace mas de una semana que no se reporta desaparecerá; ya no se lo verá en la pantalla "Estado del sistema".

En Administración\ Información de Configuración, en el siguiente campo se puede configurar cada cuánto se depura la información de estado de consola y motor:

Con el filtro "[Componente]" puede seleccionar si se quiere ver en pantalla las "Consolas" o los "Motores". En la columna "Componente" se mostrará el ícono  para indicar si se está mostrando en esa línea un motor, y si es una consola mostrará .

Al ingresar mostrará todos los estatus on line y off line (no vendrá pre filtrado en el filtro que dice "[Seleccione]").

Se podrán utilizar los filtros de navegación. Ver detalles en Paginado.

Si descarga el Excel lo verá como el siguiente. La columna con el título: Consola, mostrará el contenido con true o false.


El botón "Exportación Masiva" lo llevará a la pantalla "Motor Exportación Informes" y desde la columna Descripción se podrá bajar el archivo .csv con todos los registros de la vista "Estado del Sistema".


Importante

Cuando se crean nuevas compañías; si ya existe un motor asociado a una existente, la nueva no verá el estado de dicho motor en Soporte, Estado del Sistema. Cuando se distribuya manualmente un mapa vigente en una tienda de la nueva compañía ; ya se le podrá asociar el motor y esta nueva compañía podrá ver el estado del mismo en Soporte, Estado del Sistema; seleccionado el ìtem motor.


 Monitor de Importación


Desde el menú Soporte > Monitor de importación, se accede a la pantalla de administración del monitor de Importaciones.

En esta sección se podrá visualizar el estado de las importaciones de registros de la interfaz de recepción de precios de las Listas 0 (que requieren actualización en la tienda correspondiente) así como también el estado de las importaciones y exportaciones de archivos realizados vía Colas RabbitMQ que se tengan configuradas en la consola de Promo.

Se puede ver el estado de las distintas importaciones, por ejemplo si el proceso de importación finalizo exitosamente o si se produjo algún error.

        Esta vista posee los siguientes filtros de búsqueda:

        • Tipo: Indica los procesos de importación que se han ejecutado por los diferentes medios existentes: Catalogos/Rest/RabbitMQ/Importacion de Promociones Masivas vía Rest. No es una lista pre definida, dependerá de los tipos de importación realizados..
    • Importante

      Los tipos de importación serán visibles por default, durante 30 días después de realizada la operación.


        • Estado: en el que se encuentra la importación:
            • TODOS: seleccionará todas las importaciones que se han hecho, ya sea por Rest o RabbitMQ
            • Pendiente
            • Procesado
            • Error
            • Descartado
            • Parcial
        • Fecha desde y Fecha Hasta: Período de tiempo en que se desea hacer la búsqueda.


Desde cada registro de importación, en el botón “Acciones/Contenido”, se podrá visualizar el contenido del request del servicio. Para ello se presiona el botón del ítem correspondiente y la aplicación bajará un archivo .txt :

       

{"companyId":"2","catalog":"catalogBrand","params":[],"items":[{"code":"1","name":"Nintendo","operation":"I"},{"code":"2","name":"Electronic Arts","operation":"I"},{"code":"3","name":"Activision Inc.","operation":"U"}]}


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 deberá presionar el botón "Acciones > Detalle":


Y se  mostrara la siguiente pantalla, donde indica el registro donde se produjo el error, y cual fue el error producido:


Los registros que se deban volver a procesar, podrán reprocesarse desde el botón Acciones > Reprocesar, o seleccionando el checkbox a la izquierda del ítem, y haciendo click en el botón "Reprocesar seleccionados"

                              

Importante

Al realizar una importación de catalogo vía colas rabbitmq si el mensaje a importar está vacío, cuando se ejecuta el job correspondiente, en la vista Soporte, Monitor de importación el campo Tipo tendrá el valor "Tipo invalido".                                                                  

                             

                          Al presionar Acciones, Detalle se visualiza el contenido sin traducción

                           



Configuración de Motores

(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


PROMO - Manual de Usuario 7.0 - Apéndices#_Toc471373810_Toc513717134Ap%C3%A9ndiceI





 Apéndice II

Sugerencias de Promociones


PROMO - Manual de Usuario 7.0 - Apéndices#_Toc471373810_Toc513717134Ap%C3%A9ndiceII


 Apéndice III

Promociones por medio de pago


PROMO - Manual de Usuario 7.0 - Apéndices#_Toc471373810_Toc513717134Ap%C3%A9ndiceIII


 Apéndice IV

 Consideraciones - Módulo de Fidelidad


PROMO - Manual de Usuario 7.0 - Apéndices#_Toc471373810_Toc513717134Ap%C3%A9ndiceIV



 Apéndice V

Configuración de Chequeo de Colisiones


PROMO - Manual de Usuario 7.0 - Apéndices#Ap%C3%A9ndiceV


                          

 Apéndice VI

Consideraciones - Alta Masiva de Promociones


                        PROMO - Manual de Usuario 7.0 - Apéndices#Ap%C3%A9ndiceVI



Apéndice VII

Promociones Modelo


PROMO - Manual de Usuario 7.0 - Apéndices#_Toc471373810_Toc513717134Ap%C3%A9ndiceVII-PromocionesModelo



Apéndice VIII

Caché de Promociones


PROMO - Manual de Usuario 7.0 - Apéndices#Ap%C3%A9ndiceVIII-CachedePromociones


Apéndice IX

Promociones con Devolución


PROMO - Manual de Usuario 7.0 - Apéndices#Ap%C3%A9ndiceIX-PromocionesconDevoluci%C3%B3n

Apéndice X

 Funciones de Convivencia

 

PROMO - Manual de Usuario 7.0 - Apéndices#Ap%C3%A9ndiceX-Funcionesdeconvivencia

Apéndice XI

Ejemplo de Promociones con Descuento por Convenios

PROMO - Manual de Usuario 7.0 - Apéndices#Ap%C3%A9ndiceXI-EjemplodePromocionesconDescuentoporConvenios


Apéndice XII

Ejemplo de Promociones con límite por cantidad de dinero por cliente

https://share.linx.com.br/pages/viewpage.action?pageId=262805281#PROMOManualdeUsuario7.0Ap%C3%A9ndices-Ap%C3%A9ndiceXI-EjemplodePromocionesconDescuentoporConvenios


Apéndice XIII

Ejemplo de Ignorar Pago con Puntos

PROMO - Manual de Usuario 7.0 - Apéndices#Ap%C3%A9ndiceXIII-EjemplodeIgnorarPagoconPuntos









  • Sem rótulos