Documenten verzamelen in n8n: vraag de bestanden die elk geval nodig heeft
Documenten verzamelen in n8n: bouw het formulier uit een checklist in de aanvraag, zodat je alleen vraagt wat elk geval nodig heeft, en sla elke upload op.
Door Onur Hakbilen, oprichter van Formstep · Gepubliceerd · Bijgewerkt
Documenten verzamelen in n8n heeft een formulierprobleem. Voor een waterschadeclaim zijn foto’s en een reparatieofferte nodig, voor een diefstalclaim een proces-verbaal en bonnetjes. Om zulke documenten bij klanten op te vragen in n8n bouw je één lang formulier met logica of één formulier per claimtype, en in beide gevallen onderhoud je formulieren terwijl je eigenlijk een checklist hebt.
Deze workflow bouwt het formulier niet vooraf. De checklist staat in een Code-node, de aanvraag draagt het formulier, en de indiener ziet alleen wat zijn claim nodig heeft. Dezelfde stappen passen bij onboarding, leningen, verhuur en visa: overal waar de papieren van het geval afhangen.
Je kunt de kant-en-klare workflow importeren uit formstep-claim-documents.json, en er is geen formulier in Formstep voor nodig. Ik heb hem getest op self-hosted n8n 2.44 met versie 0.13.0 van de node.
Kort gezegd: bewaar de checklist in een Code-node en stuur hem mee met de aanvraag. Formstep bouwt het formulier, de indiener ziet alleen wat zijn claim nodig heeft, en de workflow wacht op de uitkomst.

De hele workflow. Hij pauzeert bij Wait for the documents tot de indiener uploadt en bewaart dan elk bestand. Selecteer het om het op volledige grootte te zien.
Hoe mensen nu in n8n documenten bij klanten opvragen
Het formulier van de n8n Wait-node neemt geen bestanden aan, en de Form Trigger heeft zijn eigen beperkingen. Gelezen op 5 november 2026; n8n brengt vaak updates uit, dus controleer het als een punt je keuze bepaalt.
- De Form Trigger heeft een File-element. De Form Trigger noemt het onder twaalf elementtypes, en de Form-node voegt pagina’s toe met de opties
multipleFilesenacceptFileTypes. Hij past bij iemand die de workflow zelf start. - Het formulier van de Wait-node kent geen File-veld. Een gepauzeerde workflow wacht op Wait met On Form Submitted, waarvan de gedocumenteerde types Date, Dropdown List, Number, Password, Text en Textarea zijn. Een claim wordt door jouw systeem geopend, dus de workflow loopt al als de documenten nodig zijn.
- Uploads lopen tegen groottegrenzen aan. Op self-hosted n8n staat
N8N_PAYLOAD_SIZE_MAXstandaard op 16 MiB enN8N_FORMDATA_FILE_SIZE_MAXop 200 MiB, plus eventuele proxylimieten. Eén formulier faalde op een VPS tot beide waren verhoogd, en op n8n Cloud kregen video’s van 100 tot 300 MB een 413 zonder dat er een oplossing is vastgelegd. - Bestanden moeten ergens naartoe. Binaire data blijft in het geheugen tenzij je
N8N_DEFAULT_BINARY_DATA_MODEopfilesystemof S3 zet, en uitvoeringsdata wordt standaard na 336 uur opgeschoond.
Voor een klant die een link opent terwijl je workflow gepauzeerd is, host Formstep de upload, neemt bestanden tot 1 GiB per stuk aan en geeft je workflow bij het hervatten een URL per bestand om te downloaden.
Voordat je begint
Je hebt de Formstep-node nodig op een self-hosted n8n met een openbaar HTTPS-adres, en een Formstep-credential. De node is alleen voor self-hosted n8n: n8n Cloud installeert alleen geverifieerde community-nodes, en de onze is nog niet geverifieerd. Je hebt ook een plek nodig voor de bestanden: het voorbeeld schrijft ze naar de schijf van n8n.
1. Begin bij het geval
Het voorbeeld opent met een Edit Fields-node met de naam Claim: claimId, claimType (water_damage of theft), claimLabel, firstName en email. In jouw workflow is dit een CRM-deal, een nieuwe rij of een webhook van je claimsysteem.
2. Maak blokken van de checklist
Een Code-node met de naam Build the checklist zoekt de documenten op voor het claimtype en schrijft het formulier als blokken: een begroeting, twee verborgen velden die de begroeting leest, één bestandsvraag per document en een opmerking.
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 } }
De throw stopt de run bij een onbekend claimtype in plaats van een formulier zonder vragen te versturen. {{first_name}} in tekst toont de waarde van een verborgen veld, en alle bloktypes staan in Create a form and a request in one call.
Een claimtype toevoegen is een nieuwe regel in het object, en je hoeft geen formulier te bouwen.
3. Verstuur de aanvraag met een nieuw formulier
Voeg een Formstep Create request-node toe en zet Form Source op New Form:
- Form Blocks is
{{ JSON.stringify($json.blocks) }}, uit de Code-node. - Context vult de verborgen velden:
{{ JSON.stringify({ first_name: $json.firstName, claim_id: $json.claimId }) }}. - Form Options geeft het jouw huisstijl.
- Recipient Email komt uit de claim. Zet Wait for the Outcome aan.
- Stel onder Additional Fields Delivery, een External ID en Expires At in, zoals
{{ $now.plus({ days: 14 }).toISO() }}.
Zet wat per persoon verschilt in Context of Prefill, nooit in de blokken of de formuliernaam. Formstep bouwt een formulier de eerste keer dat het een definitie ziet en hergebruikt het daarna, dus de tweede waterschadeclaim krijgt het formulier van de eerste en het antwoord zegt form.reused: true. Zet je de naam van de indiener in de blokken, dan maakt elke aanvraag een nieuw formulier, tot 300 nieuwe formulieren per dag per werkruimte.
Delivery op Email the Invitation vraagt Pro of Business, afgezien van de 10 uitnodigingen die Free naar je eigen adres stuurt om het uit te proberen. Laat het op Free op None staan en laat een latere node de url van de aanvraag via je eigen e-mail of chat versturen. Reminders werken net zo: Pro en Business mailen de indiener volgens een schema tot die klaar is of de aanvraag afloopt, en op Free doe je het nabellen zelf. Test Mode staat in het voorbeeld aan, dus er wordt niets gemaild tot je hem uitzet. Zie prijzen voor de abonnementen.

Het formulier gebouwd uit de checklist voor waterschade, zoals de indiener het ziet. De naam en het claimnummer komen uit Context.
4. Wacht en maak één item per bestand
Voeg een Wait-node toe met On Webhook Call, en een If-node die controleert of {{ $json.body.type }} gelijk is aan request.completed. De andere uitgang vangt een verlopen of geannuleerde aanvraag op, waarbij je nabelt of de claim sluit. Een aanvraag verloopt na 30 dagen, tenzij je een andere datum instelt, tot 365.
Het antwoord op elke bestandsvraag is een lijst bestanden met een name, een size, een type en een url. Een tweede Code-node maakt er één item per bestand van, zodat de volgende nodes één keer per upload draaien:
// 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
Hij loopt door de antwoorden in plaats van de vragen bij naam te noemen, dus hij werkt voor elk claimtype.
5. Download en bewaar elk bestand
Een HTTP Request-node downloadt {{ $json.url }} met Response Format op File, één keer per item. Het voorbeeld schrijft elk bestand daarna weg met Read/Write Files from Disk, als /home/node/.n8n-files/{{ $('Claim').item.json.claimId }} {{ $json.name }}.
Wil je Google Drive gebruiken, vervang die node dan door Google Drive › Upload file: Input Data Field Name data, File Name {{ $json.name }} en de map van de claim als Parent Folder. S3-, Dropbox- en SharePoint-nodes nemen het binaire veld op dezelfde manier. De bestanden gingen naar Formstep, dus de payloadlimiet van je formulier was nooit van toepassing, en elk bestand mag tot 1 GiB zijn binnen je opslag.
Behandel de url van een bestand als een wachtwoord. Wie hem heeft, kan het bestand downloaden, en de URL verloopt niet. Download het bestand dus zoals hier en deel je eigen kopie.
Wat een formulier dat in de aanvraag is gebouwd niet kan
Het kan geen bestand meedragen voor alleen deze indiener, zoals zijn polis of een formulier om te ondertekenen, omdat zo’n bestand wordt geüpload bij een formulier dat al bestaat. Wil je de indiener ook iets sturen om te lezen of te ondertekenen, gebruik dan een gepubliceerd formulier met een Documents-blok, zoals in Get a manager’s approval. De data.submission.pdfUrl van het event, een PDF met alle antwoorden, is alleen gevuld als het formulier een PDF bewaart, dus een aanvraag die alleen terugroept, zoals deze, heeft er geen.
Wanneer het n8n-formulier beter past
Als iedereen om dezelfde bestanden wordt gevraagd, publiceer dan één formulier met bestandsvragen. Begin met het sjabloon voor documenten verzamelen, of het sjabloon voor klant-onboarding als de bestanden met een paar vragen komen.
Als de persoon die uploadt een collega is, werkt de Form Trigger van n8n op n8n Cloud en voegt hij geen service toe aan je stack. Formstep vs n8n’s form loopt die keuze punt voor punt door.
Voor de versie met één formulier van deze lus, zie een workflow pauzeren tot de klant zijn gegevens bevestigt. Zijn de bestanden facturen, dan kan AI ze lezen en kan de afzender de waarden bevestigen. Om documenten te controleren terwijl ze binnenkomen, gebruik je AI-validatie, die op Pro begint en van AI-credits wordt betaald. De n8n-integratiepagina laat zien wat de node doet, en de stapsgewijze handleiding staat op formstep.io/docs.
