Normalizador único/matriz con nombres semánticos derivados del campo padre

Cómo funciona

1. 1.Ejecute el disparador manual; el nodo Code emite cinco cargas de prueba
2. 2.El nodo If comprueba si invoice.lines es matriz: true pasa por noOp sin cambios, false envuelve previamente los objetos únicos y registra _originalShape (single/missing/invalid)
3. 3.Un nodo Merge en modo append con dos entradas (índice 0 y 1) reúne los elementos de ambas ramas
4. 4.El motor de nombres deriva nombres semánticos dinámicamente, guarda los escalares en scalars y maneja missing/invalid con seguridad (objetos vacíos)
5. 5.El motor ordena por payloadId y un noOp entrega salida unificada ordenada de PL-001 a PL-005

Casos de uso

• Normalizar cargas de webhook que alternan entre objeto único y matriz
• Nomenclatura semántica dinámica de matrices paralelas desde la clave del campo padre
• Validación explícita de tipos con conservación de escalares y ruta segura para cargas ausentes o inválidas y orden determinista

Requisitos

• Sin credenciales; procesamiento local
• Para entrada real: elimine el nodo de muestra y conecte un Webhook con el mismo esquema invoice directamente al nodo If
• La puerta If está fijada a invoice.lines; ajuste la expresión si su ruta difiere — el motor funciona con cualquier campo dentro de invoice. La recolección de ramas usa un nodo Merge en modo append con índices válidos 0 y 1

Configuración y pruebas en n8n

1. Importe el JSON en n8n manteniendo active = false
2. Ejecute Manual Trigger y revise Unified Output Handoff: cinco elementos ordenados PL-001 a PL-005
3. Verifique PL-001 envuelto en matrices de un elemento con id en scalars, PL-002 con número 2 vía la rama de paso, PL-003 con objetos vacíos y missing, PL-004 con invalid e id retenido en scalars, PL-005 pasa customer como matriz de dos y envuelve lines único
4. Añada un campo nuevo dentro de invoice para confirmar que el nombre semántico se deriva automáticamente

Valor del servicio

Ideal como servicio de automatización operativa para conectar sistemas, reducir tareas manuales y acelerar la entrega de resultados a clientes o equipos internos.