Nodo Merge de n8n: combina dos ramas sin duplicados
Un tutorial sobre el nodo Merge de n8n para combinar dos ramas sin elementos duplicados ni faltantes, cubriendo campos coincidentes y colisiones de campos.
Comprobado con las fuentes citadas el .
Requisitos previos: qué necesitas antes de combinar dos ramas
Antes de conectar dos ramas en una sola, asegúrate de que el nodo Merge de n8n tenga las entradas correctas para reconciliar. La documentación oficial de n8n describe el nodo Merge como la forma estándar de combinar datos de ramas o nodos separados de nuevo en un único flujo, ya sea que esa división haya ocurrido antes en el flujo de trabajo o que los dos nodos nunca hayan formado parte de la misma rama.
Sources: Merge data | Build | n8n Docs
El objetivo: reunir dos ramas en un único flujo preciso
El objetivo es fácil de enunciar y fácil de hacer mal: tomar dos ramas de un flujo de trabajo y producir un único flujo de elementos donde nada esté duplicado y nada de ninguna de las dos ramas desaparezca silenciosamente. El nodo Merge de n8n está construido exactamente para esta tarea, pero la configuración que elijas determina si obtienes una reunión limpia o un flujo lleno de elementos duplicados o faltantes.
Sources: Merge data | Build | n8n Docs
Pasos: configurar el nodo Merge de n8n
Comienza decidiendo cómo deben relacionarse las dos ramas entre sí. El nodo Merge de n8n ofrece una configuración de Modo con varios comportamientos distintos, y el modo que elijas determina si obtienes elementos duplicados, elementos faltantes o una reunión limpia de las dos ramas.
| Modo | Qué hace | Mejor uso cuando |
|---|---|---|
| Append | Coloca cada elemento de ambas ramas en una sola lista, uno tras otro | Solo quieres todo de ambas ramas, sin reconciliar por clave o posición |
| Combine by Matching Fields | Empareja elementos de cada rama que comparten el mismo valor en un campo elegido | Ambas ramas representan los mismos registros, por ejemplo por ID o correo electrónico, y quieres un registro combinado por coincidencia |
| Combine by Position | Empareja el primer elemento de la Entrada 1 con el primer elemento de la Entrada 2, el segundo con el segundo, y así sucesivamente | Ambas ramas emiten de forma confiable la misma cantidad de elementos en el mismo orden |
Una vez que hayas elegido Combine, configúralo de forma deliberada en lugar de aceptar la primera opción que veas.
Cómo configurar el nodo Merge paso a paso
- Elegir el modo: Decide si necesitas Append, Combine by Matching Fields o Combine by Position según cómo se relacionen las dos ramas.
- Configurar campos coincidentes: Para Combine by Matching Fields, elige el campo o campos que identifican el mismo registro en ambas ramas.
- Elegir la configuración de Multiple Matches: Decide entre incluir todas las coincidencias o solo la primera coincidencia de cada par emparejado.
- Revisar colisiones de nombres de campos: Busca campos con el mismo nombre en ambas ramas antes de combinar.
Sources: Merge | Nodes | n8n Docs, Merge data | Build | n8n Docs, Merge Node Only Outputting 1 Instead of 2 Items - Questions - n8n Community
Resultados esperados: cómo se ve una salida combinada correctamente
Cuando el nodo Merge de n8n está configurado correctamente, la cantidad de elementos de salida coincide con lo que esperarías del modo elegido: Append te da la suma de las cantidades de elementos de ambas ramas, Combine by Matching Fields te da un elemento por cada par emparejado, y Combine by Position te da un elemento por posición. Los valores de los campos deben provenir de la entrada que hayas previsto, y ningún registro debería aparecer más de una vez a menos que hayas elegido deliberadamente una configuración de todas las coincidencias.
Sources: Merge | Nodes | n8n Docs, Merge data | Build | n8n Docs, Merge Node Only Outputting 1 Instead of 2 Items - Questions - n8n Community
Solución de problemas: elementos duplicados
Si tu salida combinada tiene más elementos de los esperados, revisa primero la configuración de Multiple Matches. Include All Matches está diseñado para generar un elemento separado por cada coincidencia encontrada, por lo que un valor de campo repetido en cualquiera de las ramas produce múltiples elementos de salida a propósito, no por accidente.
Los duplicados también aparecen cuando los propios datos de entrada ya contienen registros duplicados antes de llegar siquiera a Merge. En un caso reportado en un flujo de trabajo de n8n Cloud ejecutando la versión 1.67.1, un usuario combinó datos por Matching Fields después de un paso de Split Out y HTTP Request y encontró que salían más elementos de los que entraban; un moderador de la comunidad rastreó la causa hasta registros duplicados ya presentes en ambas ramas de entrada, ya que el nodo Merge no deduplica sus entradas por diseño. Antes de asumir que el nodo tiene la culpa, inspecciona lo que cada rama está enviando realmente.
Sources: Merge | Nodes | n8n Docs, Merge node creating duplicate records - Questions - n8n Community
Solución de problemas: salida faltante o estancada
Los elementos faltantes generalmente se deben a cantidades de entrada desiguales. Cuando las dos ramas que alimentan Merge envían cantidades diferentes de elementos, n8n solo procesa elementos hasta la cantidad de la Entrada 1 en el modo Combine, por lo que cualquier elemento adicional en la Entrada 2 más allá de esa cantidad se descarta. Un hilo de la comunidad de 2023 señaló un riesgo relacionado: si cada rama solo tiene garantizado generar un elemento, Combine by Position los empareja de forma limpia, pero cualquier discrepancia en esa cantidad descarta un elemento silenciosamente.
Un fallo distinto se parece a un flujo de trabajo que nunca termina, en lugar de uno que pierde datos. El mismo hilo de 2023 describe un diseño donde dos disparadores separados activan cada uno su propia ejecución, de modo que una sola ejecución del flujo de trabajo solo llega a Merge con datos en una rama, dejando al nodo esperando una entrada que nunca recibirá.
Un blog técnico independiente informa, sin corroboración en la propia documentación de n8n, que por defecto el nodo Merge espera ambas entradas y puede quedarse colgado indefinidamente si una rama legítimamente produce cero elementos. Esa fuente describe una opción de estilo 'Only One Input' como una forma de permitir que la ejecución continúe con solo una entrada presente, aunque la etiqueta exacta de la opción no está confirmada en la documentación oficial proporcionada aquí.
Sources: Merge | Nodes | n8n Docs, Merge Node Only Outputting 1 Instead of 2 Items - Questions - n8n Community, n8n Merge Node: Combine, Multiplex, Pass-Through Explained | Emil Ingemar Karlsson
Recomendaciones para flujos de trabajo gestionados por equipos
Algunos hábitos mantienen predecible al nodo Merge de n8n una vez que más de una persona mantiene el flujo de trabajo.
- Comienza con Combine by Matching Fields cuando las ramas comparten una clave como un ID o correo electrónico; reserva Combine by Position para ramas que garantizan emitir la misma cantidad y orden de elementos
- Antes de asumir que el nodo tiene errores, revisa la cantidad y el contenido de los elementos de entrada de cada rama, ya que varios informes reales de duplicados y elementos faltantes se remontaron a los datos previos en lugar de al propio nodo
- Si una rama puede legítimamente devolver cero elementos, diséñalo explícitamente en lugar de dejar que Merge espere indefinidamente
- Renombra los nombres de campos en conflicto con un nodo Set o Edit Fields antes de combinar si necesitas conservar los valores de ambas ramas, ya que Merge sobrescribe por defecto los campos con el mismo nombre de la Entrada 1 con el valor de la Entrada 2
- Documenta qué modo y opciones de Merge usa un flujo de trabajo para que la siguiente persona entienda las cantidades de elementos esperadas
Un detalle que vale la pena confirmar por ti mismo: la referencia oficial del nodo Merge no indica, en el material revisado aquí, cuál configuración de Multiple Matches es la predeterminada, así que revisa tu propia instancia del nodo antes de confiar en ella.
Sources: Merge | Nodes | n8n Docs, Merge node creating duplicate records - Questions - n8n Community, Merge Node Only Outputting 1 Instead of 2 Items - Questions - n8n Community, n8n Merge Node: Combine, Multiplex, Pass-Through Explained | Emil Ingemar Karlsson
