Collecte de documents avec n8n : demandez les fichiers dont chaque dossier a besoin
Collectez des documents dans n8n : le formulaire naît d’une liste dans la demande, chacun ne voit que ce qu’exige son dossier, et chaque fichier est enregistré.
Par Onur Hakbilen, fondateur de Formstep · Publié · Mis à jour
La collecte de documents avec n8n a un problème de formulaire. Une déclaration de dégât des eaux demande des photos et un devis de réparation, une déclaration de vol demande un dépôt de plainte et des justificatifs. Pour collecter des documents auprès de clients comme ceux-là dans n8n, vous construisez soit un long formulaire avec de la logique, soit un formulaire par type de dossier, et dans les deux cas vous entretenez des formulaires alors que vous avez une simple liste.
Ce workflow ne construit pas le formulaire d’abord. La liste vit dans un nœud Code, la demande porte le formulaire, et la personne ne voit que ce que son dossier exige. Les mêmes étapes conviennent à l’intégration de clients, aux prêts, aux locations et aux visas : tous les cas où les pièces dépendent du dossier.
Vous pouvez importer le workflow terminé depuis formstep-claim-documents.json, et il n’a besoin d’aucun formulaire dans Formstep. Je l’ai testé sur n8n 2.44 auto-hébergé avec la version 0.13.0 du nœud.
En bref : gardez la liste dans un nœud Code et envoyez-la avec la demande. Formstep crée le formulaire, la personne ne voit que ce que son dossier exige, et le workflow attend le résultat.

Le workflow complet. Il s’arrête à Wait for the documents jusqu’à ce que la personne envoie ses fichiers, puis enregistre chaque fichier. Sélectionnez-la pour l’afficher en grand.
Comment on collecte aujourd’hui des documents auprès de clients dans n8n
Le formulaire du nœud Wait de n8n n’accepte aucun fichier, et son Form Trigger a ses propres limites. Consulté le 5 novembre 2026 ; n8n évolue vite, vérifiez donc si un point pèse dans votre choix.
- Le Form Trigger a un élément File. Le Form Trigger le range parmi douze types d’éléments, et le nœud Form ajoute des pages avec les options
multipleFilesetacceptFileTypes. Il convient à une personne qui lance le workflow. - Le formulaire du nœud Wait ne liste aucun champ File. Un workflow en pause attend sur Wait réglé sur On Form Submitted, dont les types documentés sont Date, Dropdown List, Number, Password, Text et Textarea. Un dossier est ouvert par votre système : le workflow tourne donc déjà quand les documents deviennent nécessaires.
- Les envois se heurtent à des limites de taille. Sur n8n auto-hébergé,
N8N_PAYLOAD_SIZE_MAXvaut 16 Mio par défaut etN8N_FORMDATA_FILE_SIZE_MAX200 Mio, plus la limite éventuelle d’un proxy. Un formulaire a échoué sur un VPS tant que les deux n’avaient pas été relevées, et sur n8n Cloud, des vidéos de 100 à 300 Mo ont reçu une erreur 413 sans correctif enregistré. - Il faut déplacer les fichiers quelque part. Les données binaires restent en mémoire sauf si vous réglez
N8N_DEFAULT_BINARY_DATA_MODEsurfilesystemou sur S3, et les données d’exécution sont purgées au bout de 336 heures par défaut.
Pour un client qui ouvre un lien pendant que votre workflow est en pause, Formstep héberge l’envoi, accepte des fichiers jusqu’à 1 Gio chacun et remet à votre workflow une URL par fichier à télécharger à la reprise.
Avant de commencer
Il vous faut le nœud Formstep sur un n8n auto-hébergé avec une adresse HTTPS publique, et un identifiant Formstep. Le nœud est réservé à n8n auto-hébergé : n8n Cloud n’installe que les nœuds communautaires vérifiés, et le nôtre ne l’est pas encore. Il vous faut aussi un endroit où ranger les fichiers : l’exemple les écrit sur le disque de n8n.
1. Partir du dossier
L’exemple commence par un nœud Edit Fields nommé Claim : claimId, claimType (water_damage ou theft), claimLabel, firstName et email. Dans votre workflow, c’est une affaire de CRM, une nouvelle ligne ou un webhook de votre système de gestion des dossiers.
2. Transformer la liste en blocs
Un nœud Code nommé Build the checklist cherche les documents du type de dossier et écrit le formulaire sous forme de blocs : un message d’accueil, deux champs masqués que ce message lit, une question de fichier par document et une note.
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 } }
Le throw arrête l’exécution sur un type de dossier inconnu au lieu d’envoyer un formulaire sans questions. {{first_name}} dans un texte affiche la valeur d’un champ masqué, et tous les types de blocs sont décrits dans Créer un formulaire et une demande en un seul appel.
Ajouter un type de dossier, c’est une nouvelle entrée dans l’objet, et il n’y a aucun formulaire à construire.
3. Envoyer la demande avec un nouveau formulaire
Ajoutez un nœud Formstep Create request et réglez Form Source sur New Form :
- Form Blocks vaut
{{ JSON.stringify($json.blocks) }}, issu du nœud Code. - Context remplit les champs masqués :
{{ JSON.stringify({ first_name: $json.firstName, claim_id: $json.claimId }) }}. - Form Options y met votre marque.
- Recipient Email vient du dossier. Activez Wait for the Outcome.
- Sous Additional Fields, réglez Delivery, un External ID et Expires At, par exemple
{{ $now.plus({ days: 14 }).toISO() }}.
Mettez ce qui change d’une personne à l’autre dans Context ou Prefill, jamais dans les blocs ni dans le nom du formulaire. Formstep crée un formulaire la première fois qu’il voit une définition et le réutilise ensuite : la deuxième déclaration de dégât des eaux reçoit donc le formulaire de la première, et la réponse indique form.reused: true. Mettez le nom de la personne dans les blocs et chaque demande crée un nouveau formulaire, jusqu’à 300 nouveaux formulaires par jour et par espace de travail.
Delivery réglé sur Email the Invitation demande Pro ou Business, hormis les 10 invitations que Free envoie à votre propre adresse pour essayer. En Free, laissez-le sur None et faites envoyer l’url de la demande par un nœud suivant, via votre propre e-mail ou messagerie. Les Reminders fonctionnent de la même façon : Pro et Business envoient des e-mails à la personne selon un calendrier jusqu’à ce qu’elle termine ou que la demande se termine, et en Free, c’est à vous de relancer. Test Mode est activé dans l’exemple : rien n’est donc envoyé par e-mail tant que vous ne le désactivez pas. Voir les tarifs pour les formules.

Le formulaire construit à partir de la liste dégât des eaux, tel que la personne le voit. Le nom et le numéro de déclaration viennent de Context.
4. Attendre, puis créer un élément par fichier
Ajoutez un nœud Wait réglé sur On Webhook Call, et un nœud If qui vérifie que {{ $json.body.type }} vaut request.completed. L’autre sortie récupère une demande expirée ou annulée, où vous relancez ou clôturez le dossier. Une demande expire au bout de 30 jours sauf si vous fixez une autre date, jusqu’à 365.
La réponse à chaque question de fichier est une liste de fichiers avec un name, une size, un type et une url. Un deuxième nœud Code les transforme en un élément par fichier, pour que les nœuds suivants s’exécutent une fois par envoi :
// 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
Il parcourt les réponses au lieu de nommer les questions : il fonctionne donc pour n’importe quel type de dossier.
5. Télécharger et enregistrer chaque fichier
Un nœud HTTP Request télécharge {{ $json.url }} avec Response Format réglé sur File, une fois par élément. L’exemple écrit ensuite chaque fichier avec Read/Write Files from Disk, sous /home/node/.n8n-files/{{ $('Claim').item.json.claimId }} {{ $json.name }}.
Pour utiliser Google Drive, remplacez ce nœud par Google Drive › Upload file : Input Data Field Name data, File Name {{ $json.name }}, et le dossier du dossier client comme Parent Folder. Les nœuds S3, Dropbox et SharePoint prennent le champ binaire de la même façon. Les fichiers sont allés chez Formstep, la limite de charge utile de votre formulaire ne s’est donc jamais appliquée, et chacun peut atteindre 1 Gio dans la limite de votre stockage.
Traitez l’url d’un fichier comme un mot de passe. Quiconque la possède peut télécharger le fichier, et l’URL n’expire pas : téléchargez donc le fichier comme ici et partagez votre propre copie.
Ce qu’un formulaire créé dans la demande ne peut pas faire
Il ne peut pas porter un fichier destiné à cette seule personne, comme sa police d’assurance ou un document à signer, car un tel fichier est envoyé sur un formulaire qui existe déjà. Pour envoyer aussi à la personne quelque chose à lire ou à signer, utilisez un formulaire publié avec un bloc Documents, comme dans Obtenir l’approbation d’un responsable. Le champ data.submission.pdfUrl de l’événement, un PDF de toutes les réponses, n’est renseigné que si le formulaire conserve un PDF : une demande qui ne fait que rappeler, comme celle-ci, n’en a pas.
Quand le formulaire n8n est le meilleur choix
Si tout le monde doit fournir les mêmes fichiers, publiez un seul formulaire avec des questions de fichier. Partez du modèle de collecte de documents, ou du modèle d’intégration de clients quand les fichiers s’accompagnent de quelques questions.
Si la personne qui envoie est un collègue, le Form Trigger de n8n fonctionne sur n8n Cloud et n’ajoute aucun service à votre pile. Formstep vs le formulaire de n8n compare point par point ces deux choix.
Pour la version à formulaire unique de cette boucle, voir mettre un workflow en pause jusqu’à ce que le client confirme ses informations. Quand les fichiers sont des factures, l’IA peut les lire et l’expéditeur confirmer les valeurs. Pour vérifier les documents à mesure qu’ils arrivent, utilisez la validation par IA, disponible à partir de Pro et payée avec des crédits d’IA. La page d’intégration n8n liste ce que fait le nœud, et le guide pas à pas se trouve sur formstep.io/docs.
