Introduction to Workflows

Cada workflow sigue esta lógica básica:

1. Ocurre un evento

2. Se evalúan condiciones

3. Se ejecutan acciones

4. El flujo continúa o se divide según los resultados

Todo esto se construye visualmente, sin necesidad de código.

Estructura básica de un Workflow

1. Disparador (Trigger)

El disparador define cuándo se ejecuta el workflow.

Actualmente, los disparadores más habituales son:

• Puntos añadidos
  Se activa cuando una transacción añade puntos a un cliente (por compra, bonus, importación, etc.).

• Cliente creado
  Se activa cuando se da de alta un nuevo cliente en el sistema.

Cada disparador aporta automáticamente un conjunto de datos que el workflow podrá usar después.

2. Datos disponibles en el workflow

Cuando un workflow se activa, Omniwallet recibe y expone información estructurada, entre ella:

Datos de la transacción

• ID de pedido

• Tipo de transacción

• Valor monetario

• Puntos añadidos

• Puntos totales acumulados

• Fecha de creación

• Productos incluidos (si existen)

• Categorías

• Marcas

• Cantidades y precios

Datos del cliente relacionado

• Nombre y apellidos

• Email

• Tarjeta

• Teléfono

• Fecha de nacimiento

• Fecha de alta

• Puntos actuales

Estos datos pueden usarse en condiciones, cálculos o acciones.

3. Acciones disponibles

Una vez definido el disparador, el workflow se construye añadiendo pasos. Los pasos más habituales son:

Acciones sobre puntos

• Añadir puntos
  Añade una cantidad fija de puntos.

• Añadir puntos desde valor
  Convierte un importe monetario en puntos.

• Multiplicar puntos
  Aplica un multiplicador sobre los puntos de la transacción.

Herramientas lógicas

• Condición
  Divide el flujo en dos ramas (Verdadero / Falso).

• Para cada elemento en lista
  Repite acciones sobre listas (por ejemplo, productos).

• Calcular
  Operaciones matemáticas.

• Operaciones de fecha
  Manipulación de fechas.

• Operaciones numéricas

• Operaciones de texto

• Operaciones de lista

• Variable personalizada

• Consulta de transacciones

• Moneda a puntos

Uso de condiciones (ramas)

Las condiciones permiten crear workflows inteligentes que reaccionan de forma distinta según los datos.

Ejemplos habituales:

• Si el importe de la compra supera X €

• Si un producto concreto está presente

• Si la compra pertenece a una categoría específica

• Si el cliente tiene más de X puntos

• Si el cliente cumple años

Cada condición crea dos caminos:

• Verdadero

• Falso

Y cada uno puede tener acciones independientes.

Pruebas y simulación del workflow

Antes de activar un workflow, es posible probarlo con datos reales:

• Importando una transacción existente por ID

• Editando manualmente los datos de entrada (JSON)

• Simulando distintos escenarios

Esto permite:

• Ver el resultado final

• Ajustar condiciones

• Validar cálculos

• Evitar errores en producción

Orden de ejecución

Los workflows se ejecutan en el orden definido.
Si existen varios workflows activos con el mismo disparador, Omniwallet los procesa respetando ese orden.

Esto es importante cuando:

• Hay multiplicadores

• Se encadenan bonus

• Se combinan reglas simples con workflows avanzados

Logs y control

Desde la sección Logs es posible:

• Ver qué workflows se han ejecutado

• Cuándo se han activado

• Si han finalizado correctamente

• Detectar errores o bloqueos

Esto facilita el mantenimiento y la optimización continua.

Buenas prácticas

• Empieza con workflows simples y ve añadiendo complejidad.

• Usa condiciones para evitar duplicidades de puntos.

• Testea siempre con transacciones reales.

• Documenta internamente la lógica de cada workflow.

• Evita solapamientos innecesarios con reglas estándar.

¿Para qué tipo de casos son ideales?

• Promociones avanzadas por producto o categoría

• Multiplicadores condicionales

• Bonificaciones dinámicas

• Lógicas de fidelización personalizadas

• Casos no cubiertos por campañas estándar

• Integraciones complejas con negocio