n8n Dokumente einsammeln: genau die Dateien anfordern, die jeder Fall braucht
n8n-Dokumente einsammeln: Das Formular entsteht aus einer Checkliste in der Anfrage, jede Person liefert nur, was ihr Fall braucht. Jeder Upload wird gesichert.
Von Onur Hakbilen, Gründer von Formstep · Veröffentlicht · Aktualisiert
Dokumente einzusammeln ist in n8n ein Formularproblem. Ein Wasserschaden braucht Fotos und einen Kostenvoranschlag, ein Diebstahl eine Anzeige bei der Polizei und Belege. Um in n8n Dokumente von solchen Kunden einzusammeln, bauen Sie entweder ein langes Formular mit Logik oder ein Formular pro Schadensart, und in beiden Fällen pflegen Sie Formulare, obwohl Sie eigentlich eine Checkliste haben.
Dieser Workflow baut das Formular nicht vorab. Die Checkliste steht in einem Code-Node, die Anfrage trägt das Formular, und die Person sieht nur, was ihr Fall braucht. Dieselben Schritte passen zu Onboarding, Krediten, Vermietung und Visa: überall, wo die Unterlagen vom Fall abhängen.
Sie können den fertigen Workflow aus formstep-claim-documents.json importieren, und er braucht kein Formular in Formstep. Ich habe ihn auf selbst gehostetem n8n 2.44 mit Version 0.13.0 des Nodes geprüft.
Kurz gesagt: Halten Sie die Checkliste in einem Code-Node und schicken Sie sie mit der Anfrage. Formstep baut das Formular, die Person sieht nur, was ihr Fall braucht, und der Workflow wartet auf das Ergebnis.

Der ganze Workflow. Er hält bei Wait for the documents an, bis die Person hochlädt, und speichert dann jede Datei. Wählen Sie es aus, um es in voller Größe zu sehen.
Wie Menschen heute in n8n Dokumente von Kunden einsammeln
Das Formular des n8n-Wait-Nodes nimmt keine Dateien an, und der Form Trigger hat eigene Grenzen. Gelesen am 5. November 2026; n8n liefert oft neue Versionen, prüfen Sie also nach, wenn ein Punkt Ihre Wahl entscheidet.
- Der Form Trigger hat ein File-Element. Der Form Trigger führt es unter zwölf Elementtypen auf, und der Form-Node ergänzt Seiten mit den Optionen
multipleFilesundacceptFileTypes. Er passt für eine Person, die den Workflow selbst startet. - Das Formular des Wait-Nodes kennt kein File-Feld. Ein angehaltener Workflow wartet auf Wait mit On Form Submitted, dessen dokumentierte Typen Date, Dropdown List, Number, Password, Text und Textarea sind. Ein Schadensfall wird von Ihrem System eröffnet, der Workflow läuft also schon, wenn die Dokumente gebraucht werden.
- Uploads stoßen an Größenlimits. Bei selbst gehostetem n8n steht
N8N_PAYLOAD_SIZE_MAXstandardmäßig auf 16 MiB undN8N_FORMDATA_FILE_SIZE_MAXauf 200 MiB, dazu kommt jedes Proxy-Limit. Ein Formular scheiterte auf einem VPS, bis beide erhöht waren, und auf n8n Cloud bekamen Videos von 100 bis 300 MB einen 413, ohne dass eine Lösung vermerkt wäre. - Dateien müssen irgendwohin verschoben werden. Binärdaten bleiben im Arbeitsspeicher, solange Sie
N8N_DEFAULT_BINARY_DATA_MODEnicht auffilesystemoder S3 stellen, und Ausführungsdaten werden standardmäßig nach 336 Stunden gelöscht.
Für einen Kunden, der einen Link öffnet, während Ihr Workflow angehalten ist, hostet Formstep den Upload, nimmt Dateien bis 1 GiB pro Stück an und gibt Ihrem Workflow beim Fortsetzen pro Datei eine URL zum Herunterladen.
Bevor Sie anfangen
Sie brauchen den Formstep-Node auf einem selbst gehosteten n8n mit öffentlicher HTTPS-Adresse und die Formstep-Zugangsdaten. Der Node ist nur für selbst gehostetes n8n: n8n Cloud installiert nur verifizierte Community-Nodes, und unserer ist noch nicht verifiziert. Außerdem brauchen Sie einen Ort für die Dateien: Das Beispiel schreibt sie auf die Festplatte von n8n.
1. Vom Fall ausgehen
Das Beispiel beginnt mit einem Edit Fields-Node namens Claim: claimId, claimType (water_damage oder theft), claimLabel, firstName und email. In Ihrem Workflow ist das ein CRM-Deal, eine neue Zeile oder ein Webhook aus Ihrem Schadenssystem.
2. Die Checkliste in Blöcke verwandeln
Ein Code-Node namens Build the checklist schlägt die Dokumente zur Schadensart nach und schreibt das Formular als Blöcke: eine Begrüßung, zwei versteckte Felder, die die Begrüßung liest, pro Dokument eine Dateifrage und einen Hinweis.
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 } }
Das throw stoppt den Lauf bei einer unbekannten Schadensart, statt ein Formular ohne Fragen zu verschicken. {{first_name}} zeigt im Text den Wert eines versteckten Feldes an, und alle Blocktypen stehen unter Formular und Anfrage in einem Aufruf erstellen.
Eine neue Schadensart ist ein neuer Eintrag im Objekt, und Sie müssen dafür kein Formular bauen.
3. Die Anfrage mit einem neuen Formular senden
Fügen Sie einen Formstep-Create request-Node hinzu und stellen Sie Form Source auf New Form:
- Form Blocks ist
{{ JSON.stringify($json.blocks) }}, aus dem Code-Node. - Context füllt die versteckten Felder:
{{ JSON.stringify({ first_name: $json.firstName, claim_id: $json.claimId }) }}. - Form Options gibt dem Formular Ihr Branding.
- Recipient Email kommt aus dem Schadensfall. Schalten Sie Wait for the Outcome ein.
- Unter Additional Fields setzen Sie Delivery, eine External ID und Expires At, etwa
{{ $now.plus({ days: 14 }).toISO() }}.
Was sich pro Person ändert, gehört in Context oder Prefill, nie in die Blöcke oder den Formularnamen. Formstep baut ein Formular, wenn es eine Definition zum ersten Mal sieht, und verwendet es danach wieder: Der zweite Wasserschaden bekommt das Formular des ersten, und die Antwort enthält form.reused: true. Steht der Name der Person in den Blöcken, erzeugt jede Anfrage ein neues Formular, bis zu 300 neue Formulare am Tag pro Workspace.
Delivery auf Email the Invitation braucht Pro oder Business, abgesehen von den 10 Einladungen, die Free an Ihre eigene Adresse zum Ausprobieren schickt. Lassen Sie es bei Free auf None und lassen Sie einen späteren Node die url der Anfrage über Ihre eigene E-Mail oder Ihren Chat senden. Bei Reminders ist es genauso: Pro und Business mailen der Person nach Zeitplan, bis sie fertig ist oder die Anfrage endet, und bei Free erinnern Sie selbst. Test Mode ist im Beispiel eingeschaltet, es wird also nichts gemailt, bis Sie ihn ausschalten. Die Tarife stehen unter Preise.

Das aus der Wasserschaden-Checkliste gebaute Formular, wie es die Person sieht, die den Schaden gemeldet hat. Name und Schadensnummer kommen aus Context.
4. Warten, dann pro Datei ein Item erzeugen
Fügen Sie einen Wait-Node mit On Webhook Call hinzu und einen If-Node, der prüft, ob {{ $json.body.type }} gleich request.completed ist. Der andere Ausgang fängt eine abgelaufene oder stornierte Anfrage auf, bei der Sie nachhaken oder den Fall schließen. Eine Anfrage läuft nach 30 Tagen ab, wenn Sie kein anderes Datum setzen, höchstens nach 365.
Die Antwort auf jede Dateifrage ist eine Liste von Dateien mit name, size, type und url. Ein zweiter Code-Node macht daraus ein Item pro Datei, sodass die nächsten Nodes einmal pro Upload laufen:
// 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
Er geht die Antworten durch, statt die Fragen beim Namen zu nennen, und funktioniert deshalb für jede Schadensart.
5. Jede Datei herunterladen und speichern
Ein HTTP Request-Node lädt {{ $json.url }} herunter, mit Response Format auf File, einmal pro Item. Das Beispiel schreibt jede Datei dann mit Read/Write Files from Disk nach /home/node/.n8n-files/{{ $('Claim').item.json.claimId }} {{ $json.name }}.
Für Google Drive ersetzen Sie diesen Node durch Google Drive › Upload file: Input Data Field Name data, File Name {{ $json.name }}, und den Ordner des Falls als Parent Folder. Die Nodes für S3, Dropbox und SharePoint nehmen das Binärfeld genauso. Die Dateien gingen an Formstep, das Payload-Limit Ihres Formulars galt also nie, und jede kann bis zu 1 GiB groß sein, innerhalb Ihres Speichers.
Behandeln Sie die url einer Datei wie ein Passwort. Jeder, der sie hat, kann die Datei herunterladen, und die URL läuft nicht ab. Laden Sie die Datei also wie hier herunter und geben Sie Ihre eigene Kopie weiter.
Was ein Formular aus der Anfrage nicht kann
Es kann keine Datei für genau diese Person mitschicken, etwa ihre Police oder ein Formular zum Unterschreiben, denn eine solche Datei wird zu einem bereits bestehenden Formular hochgeladen. Wenn die Person zusätzlich etwas lesen oder unterschreiben soll, nehmen Sie ein veröffentlichtes Formular mit einem Dokumentenblock, wie in Freigabe von einer Führungskraft einholen. Die data.submission.pdfUrl des Ereignisses, ein PDF aller Antworten, ist nur gesetzt, wenn das Formular ein PDF behält. Eine Anfrage, die nur einen Callback auslöst wie diese, hat keines.
Wann das n8n-Formular die bessere Wahl ist
Wenn alle Personen dieselben Dateien liefern sollen, veröffentlichen Sie ein Formular mit Dateifragen. Starten Sie mit der Vorlage zum Einsammeln von Dokumenten oder der Vorlage für das Kunden-Onboarding, wenn zu den Dateien ein paar Fragen kommen.
Ist die Person, die hochlädt, ein Kollege, funktioniert der Form Trigger von n8n auch auf n8n Cloud und bringt keinen zusätzlichen Dienst in Ihren Stack. Formstep vs. das Formular von n8n geht diese Entscheidung Punkt für Punkt durch.
Die Variante mit einem einzigen Formular finden Sie unter einen Workflow anhalten, bis der Kunde seine Angaben bestätigt. Wenn die Dateien Rechnungen sind, kann die KI sie lesen und der Absender die Werte bestätigen. Um Dokumente beim Eintreffen zu prüfen, nehmen Sie die AI-Validierung, die ab Pro verfügbar ist und aus AI-Credits bezahlt wird. Die n8n-Integrationsseite listet auf, was der Node kann, und die Schritt-für-Schritt-Anleitung steht auf formstep.io/docs.
