Clase 06 · Módulo 03
Archivos: PDF, CSV, Excel e imágenes
Archivos: PDF, CSV, Excel e imágenes
Qué logras en esta clase
Recibes un archivo, sacas sus datos, generas otro y sabes dónde quedó guardado.
- Ubicas un archivo dentro de un ítem.
- Conviertes un CSV o Excel en ítems y al revés.
- Conoces los límites con PDF e imágenes.
- Eliges dónde guarda n8n los archivos.
02
Un pasajero aparte
Para n8n un archivo no es un campo más. Viaja en la parte binary del ítem, separado de los datos de json.
03
Cómo se ve un archivo dentro de un ítem
{
"json": { "cliente": "Ana Rojas" },
"binary": {
"data": {
"fileName": "boleta-1042.pdf",
"mimeType": "application/pdf",
"fileExtension": "pdf"
}
}
}Dentro de binary hay una propiedad, aquí llamada data, que guarda el archivo junto con su nombre, su tipo y su extensión. Un ítem puede llevar varios archivos, cada uno en una propiedad con nombre distinto.
04
Verlo en el editor
- Ejecuta el nodo que trae el archivo.
- Abre el nodo y mira el panel OUTPUT.
- Ubica la parte binaria del ítem: muestra nombre, tipo y tamaño.
- Desde ahí puedes abrir el archivo o descargarlo para revisarlo.
Si el panel solo muestra campos de texto y ningún archivo, el nodo no lo descargó: revisa su configuración antes de seguir.
05
El nombre de la propiedad importa
La mayoría de los nodos llama data a la propiedad donde deja el archivo. No todos. Y los nodos que procesan archivos te preguntan en qué propiedad buscar.
06
De dónde llegan los archivos
| Origen | Nodo | Dónde se ve |
|---|---|---|
| Una dirección web | HTTP Request | Módulo 5 |
| Un formulario o un webhook | Webhook | Módulo 5 |
| Un adjunto de correo | Gmail | Módulo 6 |
| Una carpeta en la nube | Google Drive | Módulo 6 |
| El disco del equipo | Read/Write Files from Disk | Esta clase |
En todos los casos el resultado es el mismo: un ítem con el archivo en binary. Lo que aprendes aquí sirve para cualquier origen.
07
Dos direcciones
Son los dos nodos centrales. Extract From File abre un archivo y pasa su contenido a json. Convert to File hace el camino inverso: toma ítems y arma un archivo.
08
Mientras es archivo, no hay datos
Un flujo no puede filtrar, sumar ni comparar lo que está dentro de un archivo. Primero se extrae; después se trabaja.
09
Extract From File: de planilla a ítems
Con un CSV o un Excel sale un ítem por fila, con los encabezados como nombres de campo.
- Agrega Extract From File después del nodo que trae el archivo.
- Elige la operación según el formato del archivo.
- Indica la propiedad binaria donde está, normalmente
data. - Ejecuta y cuenta los ítems: tantos como filas.
Los formatos admitidos aparecen en el selector de operaciones del nodo.
10
Un CSV bien preparado
CSV es una planilla guardada como texto, con un separador entre columnas.
- Una sola fila de encabezados, cortos y sin tildes.
- Sin filas de título ni totales al final.
- El mismo separador en todo el archivo.
11
PDF: texto sí, foto no
Hay dos tipos de PDF que se ven iguales en pantalla.
| Tipo | Cómo reconocerlo | Qué puedes extraer |
|---|---|---|
| Con texto | Puedes seleccionar palabras con el cursor | El texto |
| Escaneado | Es una foto del papel | Nada, sin un paso de lectura |
Aun con texto, lo que sale es un bloque corrido, no campos ordenados. Para convertirlo en «monto», «fecha» y «proveedor» se usa un paso de IA, que se ve en el módulo 9.
12
Imágenes
Con una imagen hay dos trabajos distintos:
- Modificarla: cambiar tamaño, recortar o convertir formato. Para eso existe el nodo Edit Image.
- Entender qué muestra: leer una boleta fotografiada o describir un producto. Eso lo hace un modelo de IA que acepta imágenes, en el módulo 9.
13
Convert to File: generar un archivo
Tomas los ítems que ya tienes y armas un archivo con ellos.
El Edit Fields previo define las columnas: sus nombres serán los encabezados y su orden, el de la planilla.
14
Ponle nombre al archivo
Un archivo llamado file.csv que llega todos los viernes se pisa con el anterior y nadie sabe de cuándo es.
15
Otros nodos para archivos
| Nodo | Para qué |
|---|---|
| Compression | Comprimir o descomprimir, por ejemplo un ZIP |
| Read/Write Files from Disk | Leer o escribir en el equipo donde corre n8n |
| HTML y XML | Trabajar con esos dos formatos |
| FTP | Subir o bajar de un servidor de archivos |
No necesitas dominarlos hoy. Basta saber que existen para buscarlos cuando aparezca el caso.
16
Usar los datos del archivo en una expresión
El nombre, el tipo y la extensión del archivo se pueden leer igual que cualquier campo.
{{ $binary.data.fileName }}
{{ $('Descargar boleta').item.binary.data.mimeType }}La primera lee el archivo del ítem actual. La segunda lo trae desde un nodo anterior. Sirve para decidir según el tipo de archivo o para guardar su nombre en una planilla.
17
Dónde guarda n8n los archivos
Mientras el flujo corre, y mientras se conserva la ejecución, n8n guarda cada archivo en algún lugar. Se elige con la variable N8N_DEFAULT_BINARY_DATA_MODE.
| Modo | Dónde quedan | Conviene |
|---|---|---|
filesystem | En el disco del equipo | Una instalación propia normal |
database | Dentro de la base de datos | Pocos archivos y chicos |
s3 | En un almacenamiento externo | Volumen alto |
Desde la versión 2.0 ya no existe el modo que los dejaba solo en memoria.
18
Los archivos ocupan espacio
Cada ejecución guardada conserva sus archivos. Un flujo que procesa veinte boletas al día acumula miles de archivos en pocos meses.
19
El disco tiene una sola puerta
En n8n 2, los nodos que leen y escriben en disco solo pueden hacerlo dentro de la carpeta ~/.n8n-files.
- Si necesitas otra ruta, se autoriza con
N8N_RESTRICT_FILE_ACCESS_TO. - Con Docker, esa carpeta vive dentro del contenedor: para ver los archivos desde tu equipo hay que montarla como volumen.
Autoriza carpetas puntuales, nunca el disco completo.
20
Dos nodos que vienen apagados
Local File Trigger, que dispara un flujo cuando cambia un archivo del disco, y Execute Command, que ejecuta órdenes del sistema, vienen desactivados desde la versión 2.0.
Se habilitan modificando la variable NODES_EXCLUDE.
21
El límite al recibir
Un webhook de n8n acepta hasta 16 MB por llamada. En una instalación propia ese tope se ajusta con N8N_PAYLOAD_SIZE_MAX.
Para archivos más grandes, el patrón es otro: quien envía sube el archivo a una carpeta en la nube y al flujo solo le llega el enlace.
22
Archivo o datos: qué guardar
| Guardar | Cuándo |
|---|---|
| Solo los datos extraídos | El archivo era un medio de transporte, como un CSV de exportación |
| Datos y archivo | El original tiene valor por sí mismo: una boleta, un contrato |
Los datos van a una planilla o base; el archivo, a una carpeta en la nube, con su enlace guardado junto a los datos. No uses n8n como archivador: las ejecuciones se borran.
23
Lo que te llevas
- Un archivo viaja en
binary, en una propiedad que casi siempre se llamadata. - Extract From File pasa de archivo a ítems; Convert to File, de ítems a archivo.
- De un PDF sale texto corrido, y solo si no es una foto.
- Los archivos ocupan disco: elige el modo de guardado y vigila el espacio.
- En n8n 2 el acceso al disco está limitado a
~/.n8n-files.
24
Hazlo ahora
Quince minutos, sin conectar ningún servicio.
- Disparador manual y un Edit Fields con tres campos:
cliente,totalyfecha. - Agrega Convert to File y genera un CSV.
- En el OUTPUT, ubica la parte binaria, anota el nombre de la propiedad y descarga el archivo.
- Agrega Extract From File y vuelve a convertirlo en ítems.
- Compara ese resultado con el del Edit Fields: ¿algún número volvió como texto?
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Work with files and images (documentación de n8n)docs.n8n.io ↗
- Reference previous nodes: datos binarios (documentación de n8n)docs.n8n.io ↗
- Understand n8n's data structure (documentación de n8n)docs.n8n.io ↗
- n8n v2.0 breaking changes (documentación de n8n)docs.n8n.io ↗
- Webhook node (documentación de n8n)docs.n8n.io ↗