Recopilar documentos en n8n: pide los archivos que cada caso necesita
Recopila documentos en n8n: crea el formulario desde una lista en la solicitud, para pedir a cada persona solo lo que su caso necesita, y guarda cada archivo.
Por Onur Hakbilen, fundador de Formstep · Publicado · Actualizado
Recopilar documentos en n8n tiene un problema de formularios. Un siniestro por daños de agua necesita fotos y un presupuesto de reparación, y uno por robo necesita una denuncia policial y recibos. Para recopilar documentos de clientes así en n8n, o creas un formulario largo con lógica o un formulario por tipo de siniestro, y en ambos casos mantienes formularios cuando lo que tienes es una lista.
Este workflow no crea el formulario primero. La lista vive en un nodo Code, la solicitud lleva el formulario y quien reclama ve solo lo que su siniestro necesita. Los mismos pasos sirven para altas de clientes, préstamos, alquileres y visados: cualquier caso en que el papeleo depende del caso.
Puedes importar el workflow terminado desde formstep-claim-documents.json, y no necesita ningún formulario en Formstep. Lo comprobé en n8n 2.44 autoalojado con la versión 0.13.0 del nodo.
En resumen: guarda la lista en un nodo Code y envíala con la solicitud. Formstep crea el formulario, quien reclama ve solo lo que su siniestro necesita y el workflow espera el resultado.

El workflow completo. Se detiene en Wait for the documents hasta que quien reclama sube los archivos, y entonces guarda cada uno. Selecciónala para verla en tamaño completo.
Cómo se recopilan hoy documentos de clientes en n8n
El formulario del nodo Wait de n8n no admite archivos, y su Form Trigger tiene sus propios límites. Consultado el 5 de noviembre de 2026; n8n publica cambios a menudo, así que comprueba cualquier punto que decida tu elección.
- El Form Trigger tiene un elemento File. El Form Trigger lo incluye entre doce tipos de elemento, y el nodo Form añade páginas con las opciones
multipleFilesyacceptFileTypes. Sirve para una persona que inicia el workflow. - El formulario del nodo Wait no tiene campo File. Un workflow en pausa espera en Wait configurado en On Form Submitted, cuyos tipos documentados son Date, Dropdown List, Number, Password, Text y Textarea. Un siniestro lo abre tu sistema, así que el workflow ya está en marcha cuando hacen falta los documentos.
- Las subidas chocan con límites de tamaño. En n8n autoalojado,
N8N_PAYLOAD_SIZE_MAXes 16 MiB por defecto yN8N_FORMDATA_FILE_SIZE_MAXes 200 MiB, además de cualquier límite del proxy. Un formulario falló en un VPS hasta que se subieron ambos, y en n8n Cloud videos de 100 a 300 MB recibieron un 413 sin solución registrada. - Hay que mover los archivos a algún sitio. Los datos binarios se quedan en memoria salvo que configures
N8N_DEFAULT_BINARY_DATA_MODEcomofilesystemo S3, y los datos de ejecución se eliminan por defecto a las 336 horas.
Para un cliente que abre un enlace mientras tu workflow está en pausa, Formstep aloja la subida, acepta archivos de hasta 1 GiB cada uno y le da a tu workflow una URL por archivo para descargar cuando se reanude.
Antes de empezar
Necesitas el nodo de Formstep en un n8n autoalojado con una dirección HTTPS pública, y una credencial de Formstep. El nodo es solo para n8n autoalojado: n8n Cloud solo instala nodos de comunidad verificados, y el nuestro aún no lo está. También necesitas un lugar donde guardar los archivos: el ejemplo los escribe en el disco de n8n.
1. Empieza por el caso
El ejemplo abre con un nodo Edit Fields llamado Claim: claimId, claimType (water_damage o theft), claimLabel, firstName y email. En tu workflow esto es un deal del CRM, una fila nueva o un webhook de tu sistema de siniestros.
2. Convierte la lista en bloques
Un nodo Code llamado Build the checklist busca los documentos del tipo de siniestro y escribe el formulario como bloques: un saludo, dos campos ocultos que lee el saludo, una pregunta de archivo por documento y una nota.
const checklists = {
water_damage: [
{ key: 'damage_photos', title: 'Photos of the damage', maxFiles: 10 },
{ key: 'repair_estimate', title: 'Repair estimate from a contractor', maxFiles: 1 },
],
theft: [
{ key: 'police_report', title: 'Police report', maxFiles: 1 },
{ key: 'receipts', title: 'Receipts for the stolen items', maxFiles: 10 },
],
}
const documents = checklists[$json.claimType]
if (!documents) throw new Error(`No checklist for claim type ${$json.claimType}`)
const blocks = [
{ type: 'header', content: 'Hi {{first_name}}, a few documents for claim {{claim_id}}' },
{ type: 'paragraph', content: 'Upload each document below. Photos from your phone are fine.' },
{ type: 'hiddenField', key: 'first_name' },
{ type: 'hiddenField', key: 'claim_id' },
...documents.map((document) => ({ type: 'file', ...document })),
{ type: 'text', key: 'notes', title: 'Anything we should know?', required: false },
]
return { json: { ...$json, blocks } }
El throw detiene la ejecución ante un tipo de siniestro desconocido en lugar de enviar un formulario sin preguntas. {{first_name}} en un texto muestra el valor de un campo oculto, y todos los tipos de bloque están en Crear un formulario y una solicitud en una sola llamada.
Añadir un tipo de siniestro es una entrada nueva en el objeto, y no hay que crear ningún formulario.
3. Envía la solicitud con un formulario nuevo
Añade un nodo Create request de Formstep y configura Form Source en New Form:
- Form Blocks es
{{ JSON.stringify($json.blocks) }}, del nodo Code. - Context rellena los campos ocultos:
{{ JSON.stringify({ first_name: $json.firstName, claim_id: $json.claimId }) }}. - Form Options le da tu marca.
- Recipient Email sale del siniestro. Activa Wait for the Outcome.
- En Additional Fields, configura Delivery, un External ID y Expires At, como
{{ $now.plus({ days: 14 }).toISO() }}.
Lo que cambia por persona va en Context o Prefill, nunca en los bloques ni en el nombre del formulario. Formstep crea un formulario la primera vez que ve una definición y lo reutiliza después, así que el segundo siniestro por daños de agua recibe el formulario del primero y la respuesta dice form.reused: true. Si pones el nombre de quien reclama en los bloques, cada solicitud crea un formulario nuevo, hasta 300 formularios nuevos al día por espacio de trabajo.
Delivery configurado en Email the Invitation requiere Pro o Business, aparte de las 10 invitaciones que Free envía a tu propia dirección para probarlo. En Free, déjalo en None y haz que un nodo posterior envíe el url de la solicitud por tu propio correo o chat. Reminders funciona igual: Pro y Business envían correos a quien reclama de forma programada hasta que termine o la solicitud acabe, y en Free tú haces el seguimiento. Test Mode está activado en el ejemplo, así que no se envía ningún correo hasta que lo desactives. Consulta los precios para ver los planes.

El formulario creado a partir de la lista de daños de agua, tal como lo ve quien reclama. El nombre y el número de siniestro vienen de Context.
4. Espera y crea un elemento por archivo
Añade un nodo Wait configurado en On Webhook Call, y un nodo If que compruebe que {{ $json.body.type }} es request.completed. La otra salida recoge una solicitud expirada o cancelada, donde reclamas los documentos o cierras el siniestro. Una solicitud expira a los 30 días salvo que pongas otra fecha, hasta 365.
La respuesta a cada pregunta de archivo es una lista de archivos con name, size, type y url. Un segundo nodo Code los convierte en un elemento por archivo, para que los nodos siguientes se ejecuten una vez por subida:
// One item per uploaded file, named after the question it answers.
const event = $json.body.data
const items = []
for (const [question, answer] of Object.entries(event.answers)) {
if (!Array.isArray(answer)) continue
for (const file of answer) {
if (file.url) items.push({ json: { question, name: `${question} - ${file.name}`, url: file.url } })
}
}
return items
Recorre las respuestas en lugar de nombrar las preguntas, así que sirve para cualquier tipo de siniestro.
5. Descarga y guarda cada archivo
Un nodo HTTP Request descarga {{ $json.url }} con Response Format en File, una vez por elemento. Luego el ejemplo escribe cada archivo con Read/Write Files from Disk, como /home/node/.n8n-files/{{ $('Claim').item.json.claimId }} {{ $json.name }}.
Para usar Google Drive, cambia ese nodo por Google Drive › Upload file: Input Data Field Name data, File Name {{ $json.name }} y la carpeta del siniestro como Parent Folder. Los nodos de S3, Dropbox y SharePoint reciben el campo binario de la misma forma. Los archivos fueron a Formstep, así que el límite de carga de tu formulario nunca se aplicó, y cada uno puede pesar hasta 1 GiB dentro de tu almacenamiento.
Trata el url de un archivo como una contraseña. Quien lo tenga puede descargar el archivo, y la URL no caduca, así que descarga el archivo como aquí y comparte tu propia copia.
Lo que no puede hacer un formulario creado en la solicitud
No puede llevar un archivo para este único reclamante, como su póliza o un documento para firmar, porque ese archivo se sube a un formulario que ya existe. Para enviar además algo para leer o firmar, usa un formulario publicado con un bloque Documents, como en Obtener la aprobación de un responsable. El data.submission.pdfUrl del evento, un PDF con todas las respuestas, solo se define cuando el formulario conserva un PDF, así que una solicitud que solo hace callback, como esta, no lo tiene.
Cuándo es mejor el formulario de n8n
Si a todas las personas se les piden los mismos archivos, publica un formulario con preguntas de archivo. Empieza desde la plantilla de recopilación de documentos, o desde la plantilla de alta de clientes cuando los archivos van con algunas preguntas.
Si quien sube los archivos es un compañero, el Form Trigger de n8n funciona en n8n Cloud y no añade ningún servicio a tu stack. Formstep frente al formulario de n8n repasa esa elección punto por punto.
Para la versión con un solo formulario de este ciclo, mira pausar un workflow hasta que el cliente confirme sus datos. Cuando los archivos son facturas, la IA puede leerlas y quien las envía puede confirmar los valores. Para revisar los documentos según llegan, usa la validación con IA, que empieza en Pro y se paga con créditos de IA. La página de la integración con n8n enumera lo que hace el nodo, y la guía paso a paso está en formstep.io/docs.
