Formstep

Dokumentinnsamling i n8n: be om filene hver sak trenger

Samle inn dokumenter i n8n: bygg skjemaet fra en sjekkliste i forespørselen, så hver person bare får spørsmål om det saken krever, og lagre alle opplastinger.

Av , gründer av Formstep · Publisert · Oppdatert

Dokumentinnsamling i n8n har et skjemaproblem. En vannskadesak trenger bilder og et pristilbud på reparasjonen, og en tyverisak trenger en politianmeldelse og kvitteringer. For å samle inn dokumenter fra klienter som disse i n8n bygger du enten ett langt skjema med logikk eller ett skjema per sakstype, og uansett må du vedlikeholde skjemaer når det du egentlig har er en sjekkliste.

Denne arbeidsflyten bygger ikke skjemaet først. Sjekklisten ligger i en Code-node, forespørselen bærer skjemaet, og den som melder saken ser bare det saken krever. De samme stegene passer for onboarding, lån, utleie og visum: alt der papirene avhenger av saken.

Du kan importere den ferdige arbeidsflyten fra formstep-claim-documents.json, og den trenger ikke noe skjema i Formstep. Jeg har testet den på selvhostet n8n 2.44 med versjon 0.13.0 av noden.

Kort sagt: ha sjekklisten i en Code-node og send den med forespørselen. Formstep bygger skjemaet, den som melder saken ser bare det saken krever, og arbeidsflyten venter på utfallet.

Den ferdige n8n-arbeidsflyten etter en kjøring: en manuell trigger, Claim, Build the checklist, Ask for the documents, Wait for the documents og Completed?, deretter One item per file, Download each file og Save to the claim folder, med en No answer-gren

Hele arbeidsflyten. Den pauser ved Wait for the documents til den som melder saken laster opp, og lagrer så hver fil. Velg den for å se den i full størrelse.

Slik samler folk inn dokumenter fra klienter i n8n i dag

Skjemaet i n8ns Wait-node tar ikke imot filer, og Form Trigger har sine egne begrensninger. Lest 5. november 2026; n8n slipper nye versjoner ofte, så sjekk på nytt hvis et punkt avgjør valget ditt.

  • Form Trigger har et File-element. Form Trigger lister det blant tolv elementtyper, og Form-noden legger til sider med alternativene multipleFiles og acceptFileTypes. Den passer for en person som starter arbeidsflyten.
  • Skjemaet i Wait-noden har ikke noe File-felt. En arbeidsflyt på pause venter på Wait satt til On Form Submitted, med de dokumenterte typene Date, Dropdown List, Number, Password, Text og Textarea. En sak åpnes av systemet ditt, så arbeidsflyten kjører allerede når dokumentene trengs.
  • Opplastinger treffer størrelsesgrenser. På selvhostet n8n er N8N_PAYLOAD_SIZE_MAX 16 MiB som standard og N8N_FORMDATA_FILE_SIZE_MAX 200 MiB, pluss eventuelle proxygrenser. Ett skjema feilet på en VPS til begge ble hevet, og på n8n Cloud ga videoer på 100 til 300 MB en 413 uten noen registrert løsning.
  • Filene må flyttes et sted. Binærdata blir i minnet med mindre du setter N8N_DEFAULT_BINARY_DATA_MODE til filesystem eller S3, og kjøringsdata ryddes bort etter 336 timer som standard.

For en kunde som åpner en lenke mens arbeidsflyten din står på pause, hoster Formstep opplastingen, tar imot filer på opptil 1 GiB hver og gir arbeidsflyten din en URL per fil å laste ned når den fortsetter.

Før du begynner

Du trenger Formstep-noden på en selvhostet n8n med en offentlig HTTPS-adresse, og en Formstep-legitimasjon. Noden er bare for selvhostet n8n: n8n Cloud installerer bare verifiserte community-noder, og vår er ikke verifisert ennå. Du trenger også et sted å ha filene: eksempelet skriver dem til n8ns disk.

1. Start med saken

Eksempelet åpner med en Edit Fields-node som heter Claim: claimId, claimType (water_damage eller theft), claimLabel, firstName og email. I din arbeidsflyt er dette en CRM-avtale, en ny rad eller en webhook fra skadesystemet ditt.

2. Gjør sjekklisten om til blokker

En Code-node som heter Build the checklist slår opp dokumentene for sakstypen og skriver skjemaet som blokker: en hilsen, to skjulte felter hilsenen leser, ett filspørsmål per dokument og et notat.

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 } }

throw stopper kjøringen ved en ukjent sakstype i stedet for å sende et skjema uten spørsmål. {{first_name}} i tekst viser verdien til et skjult felt, og alle blokktyper står i Create a form and a request in one call.

Å legge til en sakstype er en ny oppføring i objektet, og det er ikke noe skjema å bygge.

3. Send forespørselen med et nytt skjema

Legg til en Formstep Create request-node og sett Form Source til New Form:

  • Form Blocks er {{ JSON.stringify($json.blocks) }}, fra Code-noden.
  • Context fyller de skjulte feltene: {{ JSON.stringify({ first_name: $json.firstName, claim_id: $json.claimId }) }}.
  • Form Options gir det din merkevare.
  • Recipient Email kommer fra saken. Slå på Wait for the Outcome.
  • Under Additional Fields setter du Delivery, en External ID og Expires At, for eksempel {{ $now.plus({ days: 14 }).toISO() }}.

Hold det som varierer per person i Context eller Prefill, aldri i blokkene eller skjemanavnet. Formstep bygger et skjema første gang det ser en definisjon og gjenbruker det etterpå, så den andre vannskadesaken får skjemaet fra den første, og svaret sier form.reused: true. Setter du navnet til den som melder saken i blokkene, lager hver forespørsel et nytt skjema, opptil 300 nye skjemaer om dagen per arbeidsområde.

Delivery satt til Email the Invitation krever Pro eller Business, bortsett fra de 10 invitasjonene Free sender til din egen adresse så du kan prøve det. På Free lar du den stå på None og får en senere node til å sende forespørselens url med din egen e-post eller chat. Reminders fungerer på samme måte: Pro og Business sender e-post til den som melder saken etter en tidsplan til personen er ferdig eller forespørselen utløper, og på Free må du purre selv. Test Mode er på i eksempelet, så ingenting sendes på e-post før du slår den av. Se priser for planene.

Skjemaet den som melder saken åpner, med overskriften Hi Ada, a few documents for claim CLM-3107, med opplastinger for Photos of the damage og Repair estimate from a contractor, og et notatspørsmål

Skjemaet bygget fra sjekklisten for vannskade, slik den som melder saken ser det. Navnet og saksnummeret kommer fra Context.

4. Vent, og lag ett element per fil

Legg til en Wait-node satt til On Webhook Call, og en If-node som sjekker at {{ $json.body.type }} er request.completed. Den andre utgangen fanger en utløpt eller kansellert forespørsel, der du purrer eller lukker saken. En forespørsel utløper etter 30 dager hvis du ikke setter en annen dato, opptil 365.

Svaret på hvert filspørsmål er en liste med filer med name, size, type og url. En andre Code-node gjør dem om til ett element per fil, så de neste nodene kjører én gang per opplasting:

// 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

Den går gjennom svarene i stedet for å nevne spørsmålene ved navn, så den fungerer for alle sakstyper.

5. Last ned og lagre hver fil

En HTTP Request-node laster ned {{ $json.url }} med Response Format satt til File, én gang per element. Eksempelet skriver deretter hver fil med Read/Write Files from Disk, som /home/node/.n8n-files/{{ $('Claim').item.json.claimId }} {{ $json.name }}.

For å bruke Google Drive erstatter du den noden med Google Drive › Upload file: Input Data Field Name data, File Name {{ $json.name }} og mappen til saken som Parent Folder. S3-, Dropbox- og SharePoint-nodene tar binærfeltet på samme måte. Filene gikk til Formstep, så skjemaets nyttelastgrense gjaldt aldri, og hver kan være opptil 1 GiB innenfor lagringsplassen din.

Behandle en fils url som et passord. Alle som har den kan laste ned filen, og URL-en utløper ikke, så last ned filen som her og del din egen kopi.

Hva et skjema bygget i forespørselen ikke kan

Det kan ikke bære en fil til akkurat denne som melder saken, for eksempel forsikringsvilkårene deres eller et skjema som skal signeres, fordi en slik fil lastes opp mot et skjema som allerede finnes. For å sende den som melder saken noe å lese eller signere i tillegg bruker du et publisert skjema med en Documents-blokk, som i Get a manager’s approval. Hendelsens data.submission.pdfUrl, en PDF av alle svarene, settes bare når skjemaet beholder en PDF, så en forespørsel som bare kaller tilbake, som denne, har ingen.

Når n8n-skjemaet er det beste valget

Hvis alle blir bedt om de samme filene, publiserer du ett skjema med filspørsmål. Start fra malen for dokumentinnsamling, eller malen for kundeonboarding når filene kommer sammen med noen spørsmål.

Hvis personen som laster opp er en kollega, fungerer n8ns Form Trigger på n8n Cloud og legger ikke til noen tjeneste i stacken din. Formstep vs n8n’s form går gjennom dette valget punkt for punkt.

For enkeltskjemaversjonen av denne løkken, se å sette en arbeidsflyt på pause til kunden bekrefter opplysningene sine. Når filene er fakturaer, kan AI lese dem og avsenderen bekrefte verdiene. For å kontrollere dokumenter etter hvert som de kommer inn bruker du AI-validering, som starter på Pro og betales med AI-kreditter. Integrasjonssiden for n8n lister hva noden gjør, og stegveiledningen finnes på formstep.io/docs.

Spørsmål om denne artikkelen

Har du noe annet på hjertet? Dokumentasjonen dekker alle innstillinger, og vi svarer på e-post.

Dokumentasjonen, lest 5. november 2026, lister seks felttyper for On Form Submitted: Date, Dropdown List, Number, Password, Text og Textarea. Et File-felt står ikke i dokumentasjonen. Form Trigger har et File-element, men den starter en arbeidsflyt i stedet for å sette en på pause.

I Formstep opptil 1 GiB per fil, innenfor lagringsplassen din: 100 MB på Free, 100 GB på Pro og 500 GB på Business. Et selvhostet n8n-skjema er begrenset av N8N_PAYLOAD_SIZE_MAX, 16 MiB som standard, og N8N_FORMDATA_FILE_SIZE_MAX, 200 MiB som standard, pluss eventuelle grenser i reverse proxyen din.

Nei. Med Form Source satt til New Form tar Create request-noden skjemaet som blokker, og Formstep bygger og publiserer det i samme kall. Et publisert skjema passer fortsatt best for alt med oversettelser eller et håndlaget oppsett.

Nei. Formstep gjenbruker et skjema når det ser samme definisjon igjen, så den andre vannskadesaken bruker skjemaet fra den første. Hold det som varierer per person i Context eller Prefill, aldri i blokkene eller skjemanavnet. Et arbeidsområde lager høyst 300 nye skjemaer om dagen på denne måten.

Ikke fra et skjema som bygges i forespørselen: en fil til én mottaker lastes opp mot et skjema som allerede finnes. Bruk et publisert skjema med en Documents-blokk i stedet, og legg filen ved forespørselen.

Ikke med Formstep-noden, som bare er for selvhostet n8n. På n8n Cloud kan du kalle Formstep REST API fra en HTTP Request-node, eller bruke n8ns egen Form Trigger når personen som laster opp er på teamet ditt.

Samle inn informasjon fra hvem som helst.

Publiser et eksempelskjema, svar på det som mottakeren din ville gjort, og se svarene komme tilbake. Ingen konto nødvendig.

Les dokumentasjonen