Clase 04 · Módulo 04
Subflujos reutilizables
Subflujos reutilizables
Qué logras en esta clase
Sacas los pasos que se repiten a un flujo aparte y lo llamas desde donde lo necesites.
- Creas un subflujo con entradas definidas.
- Lo llamas desde otro flujo y recibes su resultado.
- Conoces lo que cambió en n8n 2 y evitas sus trampas.
02
Copiar y pegar nodos sale caro
Si el mismo bloque vive en cinco flujos, cada corrección hay que hacerla cinco veces. Un subflujo se corrige en un solo lugar.
03
Qué es un subflujo
Es un flujo normal que, en vez de partir con un horario o un webhook, parte cuando otro flujo lo llama. Al flujo que llama se le dice padre.
Funciona como una pieza con entrada y salida: le pasas datos, hace algo y te devuelve el resultado.
04
Las dos piezas
| Pieza | Dónde va | Qué hace |
|---|---|---|
| Execute Sub-workflow Trigger | Primer nodo del subflujo | Recibe los datos del padre |
| Execute Sub-workflow | En el flujo padre | Llama al subflujo y espera su respuesta |
En el lienzo, el disparador aparece con el título When Executed by Another Workflow.
05
Cuándo vale la pena separar
- El mismo bloque aparece en dos o más flujos.
- Un flujo creció tanto que ya no se entiende de un vistazo.
- Una parte cambia seguido y el resto no.
- Quieres probar una parte por separado.
06
Cuándo no
- El bloque se usa en un solo flujo y es corto.
- Son dos o tres nodos sin lógica propia.
Cada subflujo suma un salto al revisar un problema: tienes que abrir otra ejecución para ver qué pasó. Si no hay reutilización ni orden que ganar, déjalo dentro del flujo.
07
Crear el subflujo, paso a paso
- Crea un flujo nuevo y ponle un nombre que diga qué hace.
- Agrega el nodo Execute Sub-workflow Trigger.
- En Input data mode elige cómo recibirá los datos.
- Agrega los nodos que hacen el trabajo.
- Deja como último nodo el que entrega lo que quieres devolver.
- Guarda y publica.
08
Tres formas de definir la entrada
| Input data mode | Qué hace |
|---|---|
| Define using fields below | Declaras cada campo con su nombre y tipo |
| Define using JSON example | Pegas un ejemplo del dato esperado |
| Accept all data | Recibe lo que le manden |
09
Un subflujo es un contrato
Define con precisión qué recibe y qué devuelve. Mientras eso no cambie, puedes rehacerlo por dentro sin tocar los flujos que lo usan.
10
Llamarlo desde el flujo padre
- Agrega el nodo Execute Sub-workflow.
- En Source deja Database y elige el subflujo con From list.
- En Workflow Inputs aparecen los campos declarados: arrastra a cada uno su dato.
- Elige el Mode.
- Ejecuta y revisa la salida del nodo.
También puedes indicarlo por su identificador: el texto que sigue a /workflow/ en su dirección.
11
Detalles de las entradas
- Si quitas un campo de Workflow Inputs, el subflujo lo recibe como
null. - Attempt to convert types intenta llevar cada dato al tipo que el subflujo declaró.
- Si el disparador está en Accept all data, los campos no aparecen en el nodo que llama.
12
Una corrida para todos o una por ítem
| Mode | Qué pasa con 20 ítems |
|---|---|
| Run once with all items | Una sola ejecución del subflujo recibe los 20 |
| Run once for each item | 20 ejecuciones, una por ítem, en orden |
La primera conviene cuando el subflujo trabaja sobre la lista, como armar un resumen. La segunda, cuando cada ítem es un caso independiente y quieres ver su ejecución por separado.
13
Qué vuelve al padre
Lo que entrega el último nodo del subflujo llega como salida del nodo Execute Sub-workflow.
14
Esperar o no al subflujo
La opción Wait for Sub-Workflow Completion define si el padre se queda esperando.
- Activada: el padre sigue cuando el subflujo termina y puede usar su resultado.
- Desactivada: el padre lo lanza y continúa de inmediato, sin resultado.
Desactívala solo para trabajo que puede correr por su cuenta, como dejar un registro, y cuando al padre le dé lo mismo si salió bien o mal.
15
Cambio en n8n 2: se publica
Desde la versión 2.0, un subflujo debe estar publicado para que otro flujo pueda llamarlo. Guardarlo no basta: lo guardado es un borrador.
16
Cambio en n8n 2: subflujos con pausa
Si el subflujo se pausa (un Wait de más de 65 segundos, un webhook, un formulario o una aprobación humana), el padre ahora recibe la salida final del subflujo. Antes recibía los datos de entrada.
Si heredas flujos de la serie 1.x que dependían del comportamiento anterior, revísalos. El nodo Start tampoco existe ya: un subflujo antiguo que partía con él necesita el disparador nuevo.
17
Los tutoriales viejos no avisan
Mucho material en internet es de la serie 1.x. Si un paso no calza con tu pantalla, vale la página de cambios de la versión 2.0, no el video.
18
Ver qué pasó dentro
- Abre la ejecución del flujo padre.
- Entra al nodo Execute Sub-workflow.
- Usa el enlace View sub-execution para saltar a la ejecución del subflujo.
Desde la ejecución del subflujo hay un enlace de vuelta al padre.
19
Quién puede llamarlo
En el subflujo, en Options > Settings, el ajuste This workflow can be called by limita qué flujos pueden invocarlo. Revisa las opciones que ofrece tu versión y elige la más restrictiva que te sirva.
Un subflujo con errores no puede ser llamado: si el padre falla al invocarlo, ábrelo y revisa que no tenga nodos mal configurados.
20
Errores comunes con subflujos
- Olvidar publicar el subflujo o su última corrección.
- Cambiar el nombre o el tipo de un campo de entrada sin revisar los padres.
- Dejar que el subflujo termine en ramas con salidas distintas.
- Un subflujo que se llama a sí mismo sin condición de salida.
- Partir todo en piezas mínimas: diez subflujos de dos nodos son peores que un flujo claro.
21
Lo que te llevas
- Un subflujo es un flujo que otro llama: disparador propio, entradas declaradas y una salida.
- Declara los campos de entrada y cierra con un nodo único.
- Elige el modo según si trabajas la lista o cada ítem.
- En n8n 2 se publica, y si se pausa devuelve su salida final.
- Separa cuando hay reutilización u orden que ganar, no por costumbre.
22
Hazlo ahora
En 15 minutos:
- Crea un subflujo que reciba
nombreytelefonoy devuelvaoky unmensajearmado con ambos. - Publícalo.
- Llámalo desde otro flujo con tres contactos ficticios en modo Run once for each item.
- Abre una de las ejecuciones con View sub-execution.
- Cambia el mensaje en el subflujo, publica y confirma que el padre recibe el nuevo.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026