Cómo crear un flujo

Para que un flujo funcione bien, necesitas tener preparados:

✔ 1. Conexiones

Accesos válidos a los sistemas que participarán en el flujo.

✔ 2. APIs importadas

Para que nubyhub conozca entidades y operaciones.

✔ 3. Claridad sobre el proceso

Qué quieres sincronizar y en qué dirección.

Ejemplo:

• “Traer pedidos de Shopify y crearlos en un ERP”
• “Actualizar stock entre sistemas”
• “Enviar clientes de un CRM a una app interna”

✔ 4. Conocer las reglas de negocio

Ej.:

• Crear solo pedidos con estado “paid”
• Ignorar productos sin stock
• Actualizar clientes solo si su email existe

Aunque la interfaz pueda representarse con bloques o nodos, el proceso siempre sigue la misma lógica:

Ejemplos:

• GET /orders de Shopify
• GET /customers de un CRM
• GET /items de un ERP

Esto determina de dónde vendrán los datos

La respuesta de la API se convierte automáticamente en una entidad interna:

   Order {
   id: string,
   total: number,
   customer_id: string,
   items: […]
   }

Esto permite transformarla sin riesgo de romper estructuras.

Transformaciones típicas:

• Convertir formatos
• Limpiar campos
• Unir datos
• Cambiar nombres
• Crear valores nuevos
• Normalizar textos
• Aplicar reglas IF/ELSE
• Ejecutar funciones JavaScript pequeñas

Ejemplo:
full_name = first_name + » » + last_name

El siguiente paso suele ser crear o actualizar el dato en otro sistema.

Ejemplo:

• Traer pedido → Crear cliente → Crear pedido → Crear líneas del pedido

En esta fase decides qué campos de la entidad origen corresponden a los campos del destino.

Un flujo puede contener múltiples pasos:

Ejemplo real:

1. GET Orders (origen)
2. Transformar datos del pedido
3. POST Customer (ERP)
4. POST Order (ERP)
5. POST OrderLines (ERP)
6. Registrar respuesta
7. Enviar logs o notificaciones

Los flujos pueden ser simples o complejos.

Un flujo real rara vez es lineal.

Puedes aplicar condiciones como:

• Procesar solo pedidos con estado “completed”
• Saltar creación de cliente si ya existe
• Repetir una operación si la API externa devuelve error temporal
• Crear bifurcaciones (si sucede X → hacer A, si no → hacer B)

Esto convierte un flujo en una automatización inteligente.

El cierre puede incluir:

• Guardar datos en logs internos
• Retornar información
• Notificar a sistemas externos
• Registrar errores parcialmente procesados
• Guardar estadísticas

Así se mantiene trazabilidad completa.

Los flujos pueden ejecutarse de tres maneras:

✔ Manual (modo prueba o ejecución puntual)

Para validar que todo funciona antes de activarlo.

✔ Automática (cuando la API lo permita)

Ej.: eventos, cambios de estado, webhooks, etc.

✔ Programada

Ej.: cada 5 minutos, cada hora, cada noche, cada lunes…

La programación depende del tipo de integración y del volumen de datos.

❌ Crear operaciones en un orden incorrecto

Ej.: crear un pedido antes del cliente.

❌ No validar estados o campos vacíos

Solución: usar condiciones y defaults.

❌ No contemplar errores temporales de la API externa

Solución: reintentos o bloque de manejo de errores.

❌ Payload mal mapeado

Solución: revisar entidades y tipos.

❌ No controlar duplicidades

Ej.: crear el mismo cliente varias veces.

✔ Diseñar primero el proceso en papel

Qué datos entran → Qué reglas se aplican → Qué datos salen.

✔ Dividir flujos complejos en subflujos

Más mantenible y escalable.

✔ Crear logs detallados

Te ayudará en soporte.

✔ Controlar errores paso a paso

No esperes al final para detectar fallos.

✔ Crear validaciones internas

Ej.: verificar que un email existe antes de crearlo.

✔ Reutilizar transformaciones

Evita duplicar lógica.

Un flujo en nubyhub es la combinación de:

• Una fuente de datos
• Transformaciones
• Mapeos
• Lógica de negocio
• Operaciones encadenadas
• Manejo de errores

La plataforma abstrae toda la complejidad de las APIs para que tú te centres en el proceso, no en el código.

El resultado: automatizaciones robustas, replicables y fáciles de mantener.