Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Expandir
titleCondiciones por Rango Horario

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:

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


Aviso
titleDefinición de Promociones por Periodicidad

Cuando se crea una promoción que depende de la periodicidad (es decir, que ocurre de manera repetitiva en ciertos días o fechas), es importante configurar correctamente la periodicidad en la plantilla de promociones.

Existen dos tipos de periodicidad que se pueden aplicar:

1) Día/Mes

En este caso, la promoción se activa en un día específico del mes (como el "primer lunes del mes", o "segundo miércoles del mes", etc.).
El formato que se debe usar es:
<fecha> <ordinal> (<días de la semana>)

Ejemplo:
31/12/2025 2do (1,2,3)

Esto quiere decir: la promoción se activará el segundo domingo, lunes y martes de cada mes, comenzando el 31 de diciembre de 2025.

Valores válidos para los días de la semana:

  • 1 = domingo
  • 2 = lunes
  • 3 = martes
  • 4 = miércoles
  • 5 = jueves
  • 6 = viernes
  • 7 = sábado

2) Día del Mes

Si la promoción se activa en un día específico dentro de un mes, como "día 25", el formato será:
<fecha> <día>m

Ejemplo:
31/12/2025 25m

Esto quiere decir: la promoción se activará siempre el día 25 de cada mes, comenzando el 31 de diciembre de 2025.


Resumen:

  • Día/Mes: Selecciona un ordinal (1er, 2do, 3er, 4to) y los días de la semana correspondientes.
  • Día del mes: Elige un número de día entre 1 y 31 para activar la promoción en ese día de cada mes.

Si no se define la periodicidad, la promoción se configurará con los valores predeterminados de la plantilla.



Expandir
titleCondiciones Simples

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

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


...

Dica


Expandir
titlePromociones asociadas a Cupones – Uso de filtros “Vigentes” y “Activas”

Dentro del módulo Fidelidad, accediendo a la opción Tipos de Cupones, es posible consultar qué promociones están asociadas a cada tipo de cupón. Esta consulta se realiza desde el botón Acciones → Promociones asociadas.

En la pantalla de consulta, el sistema permite aplicar dos filtros adicionales mediante los checkboxes:

✅ Filtros disponibles

FiltroDescripción
VigentesMuestra solo las promociones cuya vigencia incluye la fecha actual, o aquellas que no tienen una fecha de fin definida. Si este filtro no está marcado, se incluyen también promociones vencidas.
ActivasMuestra únicamente las promociones que no se encuentren canceladas. Si este filtro no está marcado, solo se mostrarán las promociones canceladas.


🔄 Comportamiento combinado de los filtros

Ambos filtros pueden aplicarse de forma independiente o simultánea. A continuación se detallan los posibles comportamientos según la combinación seleccionada:

Check "Vigentes"Check "Activas"Resultado esperado
❌ No marcado❌ No marcadoSolo se muestran promociones canceladas, sin importar su vigencia.
✅ Marcado❌ No marcadoSe muestran promociones vigentes al día de la consulta, incluso si están canceladas.
✅ Marcado✅ MarcadoSe muestran únicamente promociones activas y vigentes al día de la consulta.
❌ No marcado✅ MarcadoSe muestran promociones activas, sin importar su vigencia.





Informações
titleExportación de Cupones a Sistemas Externos

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

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


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


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

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


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

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

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

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


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

...

Aviso

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

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

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

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

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

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

la promoción se importará con el workflow general

 4. Un usuario sólo verá en la vista "Gestión de Promociones" todas las promociones importadas que contengan  workflows asociados al usuario.


Aviso
titleImportación de Promociones con Límites de Aplicación

Al distribuir una promoción con límites de aplicación en un mapa, es importante tener en cuenta que los límites NO se transfieren directamente en el archivo XML. Sin embargo, se agregará al beneficio que tiene límites (general, tienda o cliente) el parámetro hasLimit="true", como se muestra en el siguiente fragmento del XML:

Bloco de código
<parameter key="hasLimit" value="true" />


Flujo de Importación

Cuando se realiza una transacción donde se consultan y/o aplican límites de la promoción, la comunicación entre el motor de promociones y la consola será responsable de gestionar estos límites.


Importación por XML

Al importar una promoción que tenga límites de aplicación (ya sea por tipo de cliente, tienda o general) a través de un archivo XML, los límites de la promoción NO se incluirán en el archivo XML. En su lugar, estos deben ser gestionados e importados a través de otro mecanismo, como Consola-Servicios.


Motivos de modificacion de saldos

...