Formstep

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 , 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 de n8n terminado tras una ejecución: un disparador manual, Claim, Build the checklist, Ask for the documents, Wait for the documents y Completed?, luego One item per file, Download each file y Save to the claim folder, con una rama No answer

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 multipleFiles y acceptFileTypes. 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_MAX es 16 MiB por defecto y N8N_FORMDATA_FILE_SIZE_MAX es 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_MODE como filesystem o 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 que abre quien reclama, con el título Hi Ada, a few documents for claim CLM-3107, con subidas para Photos of the damage y Repair estimate from a contractor, y una pregunta de notas

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.

Preguntas sobre este artículo

¿Algo más en mente? La documentación cubre cada configuración, y respondemos los correos.

Su documentación, consultada el 5 de noviembre de 2026, enumera seis tipos de campo para On Form Submitted: Date, Dropdown List, Number, Password, Text y Textarea. No aparece ningún campo File en su documentación. El Form Trigger tiene un elemento File, pero inicia un workflow en lugar de pausarlo.

En Formstep, hasta 1 GiB por archivo, dentro de tu almacenamiento: 100 MB en Free, 100 GB en Pro y 500 GB en Business. Un formulario de n8n autoalojado está limitado por N8N_PAYLOAD_SIZE_MAX, 16 MiB por defecto, y N8N_FORMDATA_FILE_SIZE_MAX, 200 MiB por defecto, además de cualquier límite de tu proxy inverso.

No. Con Form Source en New Form, el nodo Create request recibe el formulario como bloques y Formstep lo crea y lo publica en la misma llamada. Un formulario publicado sigue siendo mejor para todo lo que lleve traducciones o un diseño hecho a mano.

No. Formstep reutiliza un formulario cuando ve de nuevo la misma definición, así que el segundo siniestro por daños de agua usa el formulario del primero. Lo que cambia por persona va en Context o Prefill, nunca en los bloques ni en el nombre del formulario. Un espacio de trabajo crea como máximo 300 formularios nuevos al día de esta forma.

No desde un formulario creado en la solicitud: el archivo para un destinatario se sube a un formulario que ya existe. Usa en su lugar un formulario publicado con un bloque Documents y adjunta el archivo a la solicitud.

No con el nodo de Formstep, que es solo para n8n autoalojado. En n8n Cloud, llama a la API REST de Formstep desde un nodo HTTP Request, o usa el Form Trigger de n8n cuando quien sube los archivos es de tu equipo.

Recopila información de cualquier persona.

Publica un formulario de ejemplo, respóndelo como lo haría tu destinatario y mira cómo llegan las respuestas. Sin necesidad de cuenta.

Lee la documentación