Clase 01 · Módulo 03
Cómo viajan los datos entre nodos
Cómo viajan los datos entre nodos
Qué logras en esta clase
Lees lo que entra y sale de cualquier nodo y sabes cuántas veces va a trabajar antes de ejecutarlo.
- Reconoces un ítem y sus dos partes.
- Lees JSON sin saber programar.
- Predices cuántos ítems salen de un nodo.
02
La única cosa que pasa de un nodo a otro
Entre dos nodos no viaja «el correo» ni «la planilla». Viaja una lista de ítems, siempre con la misma forma.
03
Qué es un ítem
Un ítem es una unidad de trabajo: un pedido, una fila, un mensaje, un cliente.
Piensa en una cafetería que recibe pedidos por un formulario. Cada pedido es un ítem. Si en la mañana llegaron tres pedidos, el nodo que los lee entrega una lista de tres ítems.
El nodo siguiente recibe esa lista completa y trabaja sobre ella.
04
JSON en un minuto
JSON es un formato de texto para anotar datos como pares «nombre: valor». Es lo que n8n usa por dentro.
{
"cliente": "Ana Rojas",
"total": 7500,
"pagado": true
}Las llaves { } encierran un objeto. A la izquierda de los dos puntos va el nombre del campo; a la derecha, su valor.
05
Los valores que puede tener un campo
| Tipo | Ejemplo | Cómo lo reconoces |
|---|---|---|
| Texto | "Ana Rojas" | Va entre comillas |
| Número | 7500 | Sin comillas |
| Verdadero o falso | true | Sin comillas |
| Lista | ["latte", "queque"] | Entre corchetes |
| Objeto | { "calle": "Lira 12" } | Entre llaves |
| Vacío | null | La palabra null |
Fíjate en las comillas: "7500" es un texto, 7500 es un número. Esa diferencia causa problemas que verás en la clase 4.
06
Cómo se ve la lista completa
[
{ "json": { "cliente": "Ana Rojas", "total": 7500 } },
{ "json": { "cliente": "Luis Vera", "total": 4200 } }
]Los corchetes de afuera son la lista. Cada bloque es un ítem. Los datos de cada ítem van dentro de una parte llamada json.
El editor casi nunca te muestra este envoltorio: te muestra directamente los campos. Pero conviene saber que existe.
07
Las dos partes de un ítem
| Parte | Qué lleva | Obligatoria |
|---|---|---|
json | Los datos: campos y valores | Sí |
binary | Archivos: un PDF, una foto, una planilla | No |
Casi todo el módulo trabaja con json. La parte binary aparece cuando un nodo descarga o recibe un archivo, y tiene su propia clase: la 6.
08
Un nodo repite su trabajo
Un nodo no se ejecuta «una vez». Repite su operación por cada ítem que recibe, sin que tú armes un bucle.
09
Tres pedidos entran, tres correos salen
No le dices al nodo de correo «hazlo tres veces». Recibe tres ítems y hace su operación sobre cada uno por separado.
10
Dónde mirar los datos
- Ejecuta el flujo o el nodo que quieres revisar.
- Abre el nodo con doble clic.
- A la izquierda queda el panel INPUT: lo que le llegó.
- A la derecha queda el panel OUTPUT: lo que entregó.
- Arriba de cada panel aparece cuántos ítems hay.
Ese número de ítems es el primer dato que debes mirar, antes que los campos.
11
Tres vistas para los mismos datos
| Vista | Qué muestra | Úsala para |
|---|---|---|
| Schema | Los campos y un valor de ejemplo | Ver qué campos existen y arrastrarlos |
| Table | Una fila por ítem | Comparar varios ítems de un vistazo |
| JSON | El texto tal cual | Copiar una muestra o ver la estructura exacta |
Las tres muestran lo mismo. Cambias de una a otra con el selector que está sobre los datos.
12
Datos dentro de datos
Un campo puede contener un objeto con más campos adentro. Eso se llama dato anidado.
{
"cliente": "Ana Rojas",
"despacho": { "comuna": "Ñuñoa", "calle": "Lira 12" }
}Aquí comuna vive dentro de despacho. Para nombrarlo se escribe el camino con puntos: despacho.comuna. En la vista Table, los campos que contienen más datos aparecen destacados en negrita.
13
Una lista adentro no es muchos ítems
{ "cliente": "Ana Rojas", "productos": ["latte", "queque", "jugo"] }Esto es un ítem con una lista de tres productos. El nodo siguiente corre una vez, no tres.
14
La pregunta antes de configurar
Antes de tocar un nodo, cuenta: ¿cuántos ítems le están llegando? De eso depende cuántas veces va a actuar.
15
Cuántos ítems salen, según el nodo
| Nodo | Entran | Salen normalmente |
|---|---|---|
| Disparador manual | — | 1 |
| Leer filas de una planilla | 1 | Uno por fila |
| Enviar un mensaje | 5 | 5 |
| Filtrar | 5 | Entre 0 y 5 |
| Resumir o agrupar | 5 | Menos de 5 |
No lo memorices: después de cada ejecución, compruébalo en el panel OUTPUT.
16
Cuando salen cero ítems
Si un nodo no entrega ningún ítem, los que siguen no tienen sobre qué trabajar.
Pasa más de lo que crees: una búsqueda sin resultados, un filtro que nadie cumple, una planilla vacía. El flujo no da error, simplemente no hace nada en esa rama.
17
Buscar dentro de los datos
Con muchos ítems, revisar a ojo no sirve. Los paneles INPUT y OUTPUT tienen un ícono de búsqueda.
- Escribes un texto y el panel muestra solo lo que coincide.
- Es solo visual: no cambia ni borra datos.
- Está en instalaciones propias y en los planes Pro y Enterprise de n8n Cloud.
18
Mirar solo el primer ítem
La vista Schema te muestra los campos con un valor de muestra. Es cómoda, pero esconde lo que cambia entre ítems.
19
El registro de la ejecución
n8n guarda un registro de cada ejecución, con lo que entró y salió en cada paso. Sirve cuando el flujo corrió solo.
- Abre la pestaña Executions del flujo.
- Elige la corrida que quieres revisar.
- Abre los nodos de izquierda a derecha.
20
Lo que te llevas
- Entre nodos viaja una lista de ítems; cada ítem tiene
jsony, a veces,binary. - JSON son pares de nombre y valor; las comillas distinguen texto de número.
- Un nodo repite su operación por cada ítem que recibe.
- Un ítem con una lista adentro sigue siendo un solo ítem.
- El número de ítems en INPUT y OUTPUT es lo primero que se revisa.
21
Hazlo ahora
Diez minutos, con el flujo que publicaste en el módulo 2.
- Ejecútalo a mano desde el editor.
- Abre cada nodo y anota cuántos ítems hay en INPUT y en OUTPUT.
- Mira el OUTPUT del último nodo en las vistas Schema, Table y JSON.
- En la vista JSON, identifica un texto, un número y, si hay, un dato anidado.
- Escribe en una frase qué representa un ítem en ese flujo.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026