Histórico da Página

• No se podrán asignar variables a los campos que poseen validaciones (mascaras) o formatos específicos (select, numeric, boolean, entre otros) desde lado consola, por lo que se tomaran como variables en la plantilla todos aquellos campos donde el usuario indique algún dato valido, por lo que al indicar valores en las columnas que representan dicho campo los mismos serán guardados en la promoción durante la importación, en caso de no indicar algún valor en la columna del excel, se tomara el valor definido por el usuario durante la creación de la plantilla.
  
• Para los campos de auto-completar, no se podrán definir variables con espacios, ejemplo: @[perfil del cliente], ya que el mecanismo de asignación de valores en un elemento auto-completar no lo permite, en ese caso se sugiere definir @[perfil_del_cliente] o utilizando cualquier otro separador.
  
  
• Solo para casos donde el código de la promoción se repita en otras promociones, es decir que el código no sea único.
  1. El usuario deberá usar el nombre como campo clave para actualizar o cancelar las promociones por Excel, ya que es la única forma de identificar la promoción que será actualizada/cancelada, por lo que no será necesario especificar el código de la promoción en el Excel.
  2. Es importante tener en cuenta que solo podrá actualizar el nombre de la promoción por Excel especificando el código y si este código es único, es decir no se encuentre asignado ya a otra promoción existente.

• Validación durante el proceso de importación: 
  Beneficios:
  - Para los campos dentro del beneficio que representan porcentajes, no se puede identificar para validar que el valor no sea mayor a 100.
  - Para opciones del beneficio y limites del beneficio, se creo en cada entidad el método donde se indican los detalles de cada campo (nombre, tipo, requerido), esta solución surgió como respuesta a la dificultad de mantener de forma dinámica las validaciones de campos asociados a Opciones y Limites del beneficio, ya que los tipos dispuestos para cada campo dentro de cada entidad no corresponden al tipo dado operativamente desde lado consola y no se podía determinar cual era requerido o no.
  
  
• Edición de promociones que se hayan generado a partir de la plantilla: Como discernir entre una actualización total a una parcial (puntualizando en campos específicos), ejemplo: para el caso de condiciones simples, si se tiene definido: Marca, Proveedor y Código (SKU)
  • Caso 1:  Se quiere actualizar solo el valor del elemento Marca y que tanto Proveedor y Código (SKU) se mantengan tal como se encuentran definidos en la promoción a editar, esos campos se dejarían vacíos dentro del excel.
  • Caso 2: Si lo que se quiere es actualizar el valor del elemento Marca y que los elementos Proveedor y Código (SKU) ya no estén disponibles dentro de las condiciones simples, los valores asociados a esos campos deben eliminarse manualmente desde la promoción en la consola. Para ello, se debe acceder al menú Operación -> Promociones, buscar la promoción relacionada, editarla y borrar los valores correspondientes a Proveedor y Código (SKU).

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

• Las columnas asociadas a campos sobre los que no se haya definido alguna variable (@[......]) al estar vacías durante el procesamiento del excel, tomara el valor definido por el usuario durante la creación de la plantilla de promoción.
  
• Durante el proceso de importación cada columna de la cabecera estará sujeta a las validaciones propias del campo que representa.
  
  
• Los elementos auto-complete, que permiten la asignación de valores alfanuméricos por parte del usuario, podrán ser usados para definir variables. No se podrán definir variables con espacios en los elementos de condiciones simple o el universo de aplicación del Combos o beneficios, en ese caso se sugiere el uso de algún separador (_,-) entre cada palabra, como por ejemplo: @[perfil_del_cliente].
  
  
• Para los campos nativos del beneficio se obtiene su nombre desde message.properties, en el caso de ser un nuevo campo insertado desde la ABM de Propiedades de beneficio, el nombre se obtiene a partir del campo nombre (name) de esa propiedad.
  
• Para las operaciones Actualizar y Cancelar, se deberá indicar el código o nombre asociada a la promoción sobre la que se quiere realizar dicha acción.
  
  
• No se podrá Actualizar o Cancelar promociones con estado Distribuido o Distribuido editable (DEPLOYED/DEPLOYEDEDITABLE), tal como sucede desde lado consola, adicionalmente evitara problemas con la regeneración del id del beneficio, ya que se necesita mantener por su asociación con los limites.

Incorporación de Variables en la Alta Masiva de Promociones

A partir de las versiones 7.2.20, 7.8.5, 7.3.9, 7.4.9 y 7.9.3, se han implementado cambios significativos en el proceso de alta masiva de promociones y en las plantillas de promociones. Estos cambios permiten una mayor flexibilidad al trabajar con variables dentro de las promociones, especialmente para condiciones simples, condiciones por composición y universo de aplicación. A continuación se detallan los aspectos clave de estos cambios.

Definición y Uso de Variables en Plantillas de Promociones

Ahora es posible incluir variables dentro de las plantillas de promociones para los siguientes tipos de datos:

• Numéricos
• Numéricos decimales
• Booleanos

Estas variables pueden aplicarse a atributos base de la promoción o a atributos dinámicos.

• Ejemplo para condiciones simples: Si el atributo "precio unitario" es de tipo numérico decimal, se podrá asignar una variable en formato @[variableEj]. Esto permitirá que el valor de esta variable se cargue automáticamente cuando se use la plantilla en el archivo Excel para la alta masiva de promociones.
• Para datos booleanos: Si el tipo de dato es booleano (como una condición simple para un atributo de tipo verdadero/falso), el campo de la variable se preformateará automáticamente con el formato @[ ], y se podrá completar con el nombre de la variable correspondiente (por ejemplo, @[variableBool]).

Image Added

Este cambio se aplica en los siguientes elementos de la plantilla:

• Condiciones simples: Permitiendo el uso de variables en campos como precio unitario, cantidad y monto.
• Condiciones por composición: Las mismas variables pueden ser usadas para definir los beneficios o condiciones basadas en la composición de la promoción.
• Universo de aplicación: Se pueden agregar variables relacionadas con los atributos que se apliquen a todos los productos o condiciones dentro del universo de la promoción.

Es importante resaltar que el campo "Transacción" no aplica el uso de variables en condiciones simples.

Generación de Excel y Reglas para la Alta Masiva

Una vez que la plantilla esté definida con las variables correspondientes, se generará un archivo Excel que incluirá las siguientescolumnas de variables para cada promoción:

• Para condiciones simples y universo de aplicación: Las columnas estarán predefinidas con las variables asociadas, permitiendo su edición desde el Excel.

Al intentar dar de alta una promoción mediante el archivo Excel, deben seguirse reglas estrictas para los tipos de datos:

• Si la variable es de tipo numérico, el valor deberá ser un número.
• Si la variable es booleano, el valor deberá ser true o false, y debe estar en minúsculas.

Es obligatorio completar todas las variables en el archivo Excel. En caso contrario, al procesar el archivo durante la alta masiva de promociones, se mostrará un mensaje de error indicando que faltan datos en alguna de las variables.

Una vez que el archivo se haya cargado correctamente, la promoción será visible en la gestión de promociones, reflejando los valores de las variables cargados desde el Excel.

Ej de columnas en excel:

Image Added

Variables de Agrupamiento en Condiciones Simples

Se ha habilitado el uso de variables de agrupamiento en las condiciones simples, aplicando el formato @[campo1,campo2,campo3], donde:

• campo1: Es el atributo sobre el cual se realiza la agrupación, como qty (cantidad), magnitude (magnitud), xprice (precio unitario).
• campo2: Es el operador de comparación, como EqualOrLessThan, LessThan, EqualOrMoreThan, MoreThan.
• campo3: Es la variable que será cargada desde el Excel en formato @[variable].

Ejemplo de uso en Excel:

• Si la condición es sobre el precio unitario y la cantidad de productos, la estructura del archivo Excel debería tener:
• Campo 1: qty (cantidad).
• Campo 2: EqualOrMoreThan.
• Campo 3: @[variable] (una variable previamente definida).

Campos y valores permitidos para las variables de agrupamiento:

• Productos: Se puede usar qty, magnitude, xprice en el primer campo; operadores (EqualOrLessThan, LessThan, EqualOrMoreThan, MoreThan) en el segundo campo; y variables en el tercer campo, como @[variable].
• Cupones: qty, amount en el primer campo; operadores en el segundo campo (EqualOrLessThan, LessThan, EqualOrMoreThan, MoreThan); y variables en el tercer campo.
• Clientes: points, amount en el primer campo; operadores en el segundo campo (EqualOrLessThan, LessThan, EqualOrMoreThan, MoreThan); y variables en el tercer campo.
• Elementos de fidelidad: amount en el primer campo; operadores en el segundo campo (EqualOrLessThan, LessThan, EqualOrMoreThan, MoreThan); y variables en el tercer campo.
• Medios de pago: itemamount, amount en el primer campo; operadores en el segundo campo (EqualOrLessThan, LessThan, EqualOrMoreThan, MoreThan); y variables en el tercer campo.
• Eventos: no aplica
• Beneficio externo: no aplica
• Transacción: no aplica

Ej de columnas en excel:

Image Added

Eventos, Beneficio Externo y Transacción no permiten el uso de variables en los campos de agrupamiento.

Escalonadas

En el caso de las condiciones escalonadas, no se manejarán variables. Sin embargo, al generar el archivo Excel, se podrá definir escalones distintos a los de la plantilla de promoción.

La estructura para los escalones será la siguiente:

• Formato para escalonadas: @[campo1,campo2,campo3], donde:
• Campo 1: Unidad de medida mínima (ej., 1).
• Campo 2: Rango de unidades máxima  (ej., 5).
• Campo 3: Valor del beneficio o descuento (ej., 3500).

Ejemplo de escalón:
Si se tiene un escalón con los valores @[1,5,3500], esto indicará que cuando el número de unidades esté entre 1 y 5, el valor del beneficio será 3500.

A partir de la versión7.2 de Promo, se incorporó el check “Incluye promociones a futuro” en la distribución de mapas y en las plantillas de mapas. 

Image Added

Cuando esta opción está activada, el mapa incluye también las promociones cuya vigencia comienza más adelante. Si está desactivada, se consideran solo las promociones vigentes (o sin fecha). Si el mapa se crea desde una plantilla, tomará el valor definido allí y se podrá cambiar en el mapa de ser necesario.

Por defecto, esta opción viene activada.

Aclaración sobre condiciones de rango horario para promociones con vigencia futura:

• Condición por hora: No se filtra, ya que no se considera futura.
• Periodicidad: días/semanas: Se filtra, ya que se considera futura.
• Periodicidad: día-mes / día del mes: No se filtra.
• Periodicidad: desde día/hasta día: No se filtra.