Générer des documents (multiples) dans n8n

Générer plusieurs documents Il s'agit d'une action du nœud PDF4me dans n8n, nommée « Générer des documents (multiples) », qui produit plusieurs fichiers finaux en une seule opération à partir d'un modèle unique et d'un tableau d'enregistrements. Utilisez-la pour un lot de factures, de lettres clients ou de rapports par région ; chaque document sera renvoyé comme un élément n8n distinct.

Que fait ce nœud ?

PDF4meGénérer des documents (multiples) prend un modèle et une liste d'enregistrements et produit de nombreux documents finis en un seul n8n Exécuter. Fournir un Mot, HTML, ou PDF modèle via des données binaires, Base64, HTML code, ou URL plus données en masse JSON ou XML (tableau d'enregistrements ou répétition) XMLChaque fichier généré est renvoyé comme un élément de sortie distinct, ce qui vous permet de les parcourir, de les enregistrer, de les envoyer par e-mail ou de les télécharger individuellement. Utilisez ce nœud à la place de Générer un document (unique) chaque fois que vous avez une liste de clients, de factures ou d'enregistrements et que vous souhaitez un document finalisé par ligne en une seule exécution.

Articles de blog connexes

Il n'y a pas encore d'article de blog consacré à cette fonctionnalité — à venir prochainement.

En attendant, n'hésitez pas à consulter le blog de PDF4me pour découvrir des tutoriels et des procédures de travail adaptés à toutes les plateformes.

Consultez le blog →

Authentification de votre API Demande

Chaque PDF4me nœud dans n8n nécessite un numéro valide Identifiant pour se connecter avecCréez ou sélectionnez-en un qui contient votre PDF4me API clé permettant au flux de travail d'authentifier en toute sécurité les demandes de génération de documents par lots.

Get your API Key

Informations importantes à ne pas manquer

Un n8n article par document généré

Une exécution réussie renvoie généralement plusieurs éléments, un par fichier généré. Chaque élément contient le fichier binaire sous le nom de sortie des données binaires et JSON métadonnées avec documentIndex et totalDocuments vous permettant de boucler, d'enregistrer ou d'envoyer par e-mail chaque fichier individuellement en aval.

Passez un tableau (JSON) ou en répétant XML donc le API sait combien de fichiers rendre

Pour JSON, utilisez un tableau d'objets, un par document généré. XMLUtilisez une structure d'enregistrement répétitif conforme au modèle (type publipostage). Les objets uniques produisent un seul document, ce qui annule l'intérêt de cette opération.

CSVLe publipostage et Google Docs ne sont pas disponibles ici.

Le type de fichier modèle ne propose que Word, HTML, PDFLe type de données du document offre uniquement JSON ou XMLSi vous avez besoin de quelque chose CSV Pour les modèles d'entrée ou de fusion de courrier/Google Docs, utilisez plutôt Générer un document (unique).

Panneau de nœuds complet. Modèle Word + JSON Données textuelles + PDF Le résultat est la configuration typique de publipostage.

Générer plusieurs documents vs Générer un seul document

Choisir la mauvaise option parmi les deux est l'erreur la plus fréquente dans cette tâche. La répartition dépend du nombre de fichiers renvoyés et des modèles et formats de données disponibles.

Aspect	Générer des documents (multiples)	Générer un document (unique)
Files returned	Many, one n8n item per generated document	Exactly one
Template types	Word, HTML, PDF	Word, HTML, PDF, plus Mail Merge and Google Docs
Data formats	JSON or XML only	JSON, XML, and CSV
Output types	PDF, Word, or Excel (HTML templates output HTML)	PDF, Word (no Excel option)
Reach for it when	You have a list of records and want one document per row	You have a single record, CSV data, or a Mail Merge template

De quels paramètres la fonction Générer des documents (multiples) a-t-elle besoin ?

Requis dans le n8n Interface utilisateur : Informations d'identification pour la connexion, type de fichier modèle, type d'entrée du fichier modèle, type de données du document, type d'entrée des données du document et type de sortie (toujours affichés ; les choix dépendent du type de fichier modèle). Champs obligatoires conditionnels (propriété binaire du modèle, modèle). Base64 Contenu, HTML Code, fichier modèle URLLes champs « Texte des données du document », « Propriété binaire du document », etc., n’apparaissent que lorsque leur type d’entrée parent est sélectionné. Nom du fichier de sortie, Conserver PDF Les champs « Modifiable » et « Nom de sortie des données binaires » sont facultatifs et proposent des valeurs par défaut pertinentes.

Paramètre	Requis	Ce que cela fait	Exemple
Template File Type	Required	Format of the template the node will render. Word for .docx templates, HTML for HTML templates (including pasted code), PDF for PDF templates. There is no Mail Merge, Google Docs, or PDF form option here; use Generate Document (Single) for those.	Word
Output Type	Required	Format of every generated document. Word and PDF templates accept PDF, Word, or Excel. HTML templates accept HTML only. Default is PDF when available.	PDF
Template File Input Type	Required	How the template is supplied. Binary Data reads from a previous node (most common). Base64 String accepts an encoded template. HTML Code accepts pasted raw HTML (only valid when Template File Type is HTML). URL downloads the template from a public link.	Binary Data
Template Binary Property	Conditional	Name of the binary property on the incoming n8n item that holds the template. Required when Template File Input Type is Binary Data. Defaults to data.	data
Template Base64 Content	Conditional	Base64-encoded template content. Required when Template File Input Type is Base64 String.	UEsDBBQAAAAI...
HTML Code	Conditional	Raw HTML body (mustache placeholders such as {{title}} are supported). Required when Template File Input Type is HTML Code, which is only valid for Template File Type HTML. The node wraps the snippet in a basic <html> shell if missing.	<h1>{{title}}</h1>
Template File URL	Conditional	Publicly reachable HTTPS URL to the template file. Required when Template File Input Type is URL.	https://example.com/template.docx
Template File Name	Conditional	Filename of the template. Optional with Binary Data (falls back to the uploaded filename or a sensible default such as template.docx, template.html, template.pdf). Required for Base64 String, HTML Code, and URL.	template.docx
Document Data Type	Required	Format of the bulk records you are sending. JSON for arrays of objects (most common). XML for repeating-record XML. CSV is not available on this operation.	JSON
Document Data Input Type	Required	How the bulk data is supplied. Text is the default (paste JSON or XML directly). Binary Data reads from a previous node. Base64 String accepts an encoded data file. URL downloads the data file from a public link.	Text
Document Data Text	Conditional	Raw bulk JSON or XML payload. Required when Document Data Input Type is Text. The node validates that JSON parses; XML is sent as-is. Use an array of objects in JSON so the API renders many files.	[{"name":"Alice"},{"name":"Bob"}]
Document Binary Property	Conditional	Name of the binary property on the incoming n8n item that holds the data file. Required when Document Data Input Type is Binary Data. Defaults to data.	data
Document Data File Name	Conditional	Filename for the bulk data file. Optional with Binary Data (falls back to data.json). Required when Document Data Input Type is Base64 String or URL.	customers.json
Document Base64 Content	Conditional	Base64-encoded data file. Required when Document Data Input Type is Base64 String.	W3sibmFtZSI6...
Document Data File URL	Conditional	Publicly reachable HTTPS URL to the bulk data file. Required when Document Data Input Type is URL.	https://example.com/customers.json
Output File Name	Optional	Prefix for the generated filenames. The node appends _1, _2, ... and the correct extension. Example: invoice becomes invoice_1.pdf, invoice_2.pdf. Leave blank to use API-provided names or generated_document_1, generated_document_2, ...	invoice
Keep PDF Editable	Optional	Only shown when Output Type is PDF. Keeps AcroForm fields editable on every generated PDF when enabled. Default is off (flattened output).	Off
Binary Data Output Name	Optional	Name of the binary property each output item exposes. Default is data. Placeholder suggests generated-documents.	data

Options de type de fichier modèle

Choisissez le format du modèle. Les options de type de sortie changent en fonction de ce choix.

Menu déroulant Type de fichier modèle. Word, HTML, ou PDF (Ici, pas de publipostage ni de Google Docs)

MotPar défaut : modèles .docx

Standard PDF4me Modèle Word avec espaces réservés pour les moustaches. Le type de sortie peut être PDFWord ou Excel. Le choix le plus courant pour les factures groupées, les lettres aux clients et les rapports personnalisés.

HTMLHTML modèles et collés HTML code

Rendus HTML Modèles avec espaces réservés Mustache. Type de sortie : HTML uniquement. Associer au type d'entrée de fichier modèle HTML Code à coller brut HTML en ligne, ou utilisez des données binaires / URL pour un fichier .html hébergé.

PDFPDF modèles

Utiliser un existant PDF comme modèle. Le type de sortie peut être PDF, Word ou Excel. Pour PDF sortie, activer Conserver PDF Modifiable si vous souhaitez que les champs soient modifiables sur chaque fichier généré.

Type de sortie par modèle

Type de fichier modèle	Choix du type de sortie	Défaut
Word	PDF, Word, Excel	PDF
PDF	PDF, Word, Excel	PDF
HTML	HTML only	HTML

Options de type d'entrée de fichier modèle

Choisissez comment le modèle est inséré dans le nœud. Les champs suivants seront modifiés en fonction de ce choix.

Type d'entrée du fichier modèle : Données binaires. Base64 Chaîne, HTML Code, ou URL

Données binairesPar défaut : fichier du nœud précédent

Lit le modèle directement à partir d'un nœud précédent tel que Téléchargement Google Drive, HTTP Demander ou lire un fichier binaire. Définir Propriété binaire du modèle au nom du champ binaire (par défaut) données). Nom du fichier modèle est facultatif et utilise par défaut le nom du fichier téléchargé.

Chaîne Base64Base64-modèle encodé

Collez ou mappez une chaîne base64 dans Modèle de contenu Base64. Nom du fichier modèle L'extension est requise pour correspondre au type de fichier modèle (.docx, .html, .pdf).

Code HTMLPâte crue HTML en ligne (HTML seulement)

Valable uniquement lorsque le type de fichier modèle est HTMLColler tout ou partie HTML avec des espaces réservés comme {{titre}}, {{contenu}} dans Code HTMLLe nœud l'encapsule dans un élément de base. <html> coquille si manquante. Nom du fichier modèle est requis (par exemple, modèle.html).

URLTélécharger à partir d'un lien public

Fournir un HTTPS URL dans URL du fichier modèle. PDF4me récupère directement le modèle. URL doit être ouvert (sans authentification) et Nom du fichier modèle est nécessaire pour que l'extension corresponde au type de modèle.

Options de type de données du document

Choisissez le format des données que vous envoyez.

Type de données du document. JSON ou XML (Non CSV (dans cette opération)

JSONValeur par défaut : tableau d’enregistrements (le plus courant)

Utilisez un JSON tableau où chaque objet est un document généré, par exemple : [{"name":"Alice"}, {"name":"Bob"}]Le nœud vérifie que la charge utile est analysable. Un seul objet génère un document. Passez un tableau si vous en souhaitez plusieurs.

XMLDisque répétitif XML

Utilisez un XML La structure de votre modèle est attendue pour les lignes répétitives (style publipostage). Le nœud n'effectue pas de validation approfondie. Assurez-vous que XML correspond aux points de liaison du modèle.

Options de type de saisie de données de document

Choisissez comment les données en masse entrent dans le nœud.

Type de données saisies : Texte, Données binaires Base64 Chaîne, ou URL

TextePar défaut : coller les données en masse directement dans le texte

Saisissez ou exprimez le mappage complet JSON tableau ou XML dans Texte des données du documentCe champ est strictement obligatoire pour l'opération multiple lorsque l'option Texte est sélectionnée (plus strict que pour l'opération unique).

Données binairesUtilisez un fichier de données provenant d'un nœud précédent

Ensemble Propriété binaire du document au nom du champ binaire (par défaut) données). Veillez à ce que les noms des propriétés binaires du modèle et des données n'entrent pas en conflit lorsqu'ils proviennent tous deux du même élément.

Chaîne Base64Base64fichier de données encodé

Fournir l'intégralité .json ou .xml fichier au format base64 dans Contenu du document Base64. Nom du fichier de données du document est requis.

URLTélécharger à partir d'un lien public

Ensemble URL du fichier de données du document à un public HTTPS URL de la JSON ou XML fichier de données. Nom du fichier de données du document est nécessaire pour que l'extension corresponde au type de données.

Comportement du nom du fichier de sortie

Scénario	Nom du fichier de sortie	Noms de fichiers générés
One document returned	invoice	invoice.pdf (extension added if missing)
Many documents returned	invoice	invoice_1.pdf, invoice_2.pdf, invoice_3.pdf, ...
Many documents, name left empty	(empty)	API-provided names or generated_document_1, generated_document_2, ...

Champs de sortie

Une course réussie rapporte un n8n un élément par document généré. Chaque élément contient les deux JSON métadonnées et fichier binaire.

Champ	Taper	Ce qu'il contient
success	Boolean	True when the document was generated successfully. Use to route error handling branches.
fileName	String	Filename of this generated document, e.g. invoice_2.pdf. Map into upload or email nodes.
mimeType	String	MIME type of the output file, e.g. application/pdf, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, text/html.
fileSize	Number	Size of the generated file in bytes.
documentIndex	Number	Index of this document within the batch (1-based). Useful for filenames or logging.
totalDocuments	Number	How many documents were produced in this run. Same on every item.
Binary (data)	Binary	The generated document under Binary Data Output Name (default data). Pass to Write Binary File, Email, or any cloud-storage upload.

Comment configurer la génération de documents (multiples) dans n8n ?

1. Ajouter PDF4me à votre n8n Flux de travail. Définir Ressource à Générer et Générer des opérations à Générer des documents (multiples).
2. Dans Identifiant pour se connecter avec, sélectionnez votre PDF4me identifiant ou cliquez Créer un nouveau compte et collez votre API clé.
3. Ensemble Type de fichier modèle à Mot (défaut), HTML, ou PDF.
4. Ensemble Type de sortie. PDF, Word ou Excel pour Word / PDF modèles ; HTML uniquement pour HTML modèles.
5. Ensemble Type de fichier modèle à Données binaires (défaut), Base64 Chaîne, HTML Code (HTML seulement), ou URL et remplissez le champ de modèle correspondant plus Nom du fichier modèle si nécessaire.
6. Ensemble Type de données du document à JSON (par défaut) ou XML.
7. Ensemble Type de saisie de données du document à Texte (par défaut) et collez votre JSON tableau dans Texte des données du document.ou choisissez Données binaires, Base64 Chaîne, ou URL et fournir le fichier de données.
8. Ensemble Nom du fichier de sortie à quelque chose de lisible comme invoice Les fichiers reviennent donc sous forme de invoice_1.pdf, invoice_2.pdf, ...
9. Si la sortie PDF et votre modèle comporte des champs de formulaire, activez Garder PDF Modifiable.
10. Partir Nom de la sortie de données binaires comme data Sauf si un nœud en aval nécessite un nom de propriété différent. Exécutez le nœud et acheminez les différents éléments de sortie vers la fonction « Fractionner par lots », « Écrire dans un fichier binaire », « Envoyer par e-mail » ou « Téléverser vers un stockage cloud ».

Configurations typiques

Exemples de flux de travailCommon n8n workflow patterns using Generate Documents (Multiple).

Publipostage à partir d'un tableau JSON. Lettres aux clients

1. Un nœud Google Sheets extrait une liste de clients avec leur nom, leur adresse et leur solde dans le flux de travail.
2. Un nœud Code ou Set regroupe les lignes dans un JSON tableau d'objets (un objet par client).
3. PDF4me Générer des documents (multiples) avec un modèle de fichier Word, type de sortie PDF, Type de données d'entrée du fichier modèle : données binaires, et type de données d'entrée du document : texte. Nom du fichier de sortie : lettre_client.
4. Le nœud renvoie un élément par client nommé lettre_client_1.pdf, lettre_client_2.pdf, et ainsi de suite.
5. Un nœud de boucle sur les éléments envoie chaque PDF au client correspondant via Gmail ou par téléchargement sur Google Drive.

Modèle + données à la fois sous forme de fichiers dans n8n

1. Un nœud télécharge le modèle .docx ; un autre nœud télécharge le fichier .json contenant les clients. Un nœud de fusion les combine afin que les deux fichiers binaires soient regroupés en un seul élément.
2. PDF4me L'option Générer des documents (multiples) est configurée avec le type d'entrée de fichier modèle Données binaires (Propriété binaire du modèle défini sur le nom du champ du modèle) et Type d'entrée de données du document Données binaires (Propriété binaire du document défini sur le nom du champ de données).
3. Ensemble Nom du fichier de données du document si le fichier de données n'est pas nommé data.json.
4. Les fichiers générés sont renvoyés sous forme d'éléments séparés et sont écrits dans un SharePoint Bibliothèque de documents nommée d'après l'identifiant du client.

Modèle hébergé + données hébergées. Traitement par lots des factures

1. Un déclencheur de planification nocturne lance le traitement par lots des factures.
2. PDF4me L'option « Générer des documents (multiples) » est configurée avec le type d'entrée « Fichier modèle ». URL (URL du fichier modèle pointe vers le modèle de facture .docx sur S3) et le type de saisie de données de document URL (URL du fichier de données du document pointe vers un généré billing-cycle.json déposer).
3. Nom du fichier modèle est facture.docx et Nom du fichier de données du document est billing-cycle.json.
4. Le type de sortie est PDF, Nom du fichier de sortie : factureet gardez PDF L'option « Modifiable » est désactivée.
5. Chaque article retourné est téléchargé dans le dossier Dropbox du client et envoyé par e-mail via Outlook.

Lot de code HTML à partir de code collé → pages de destination personnalisées

1. Un déclencheur Webhook s'active lors du lancement d'une campagne marketing.
2. PDF4me L'option « Générer des documents (multiples) » est configurée avec le type de fichier modèle. HTML et type d'entrée de fichier modèle HTML Code. le HTML est collé directement dans le nœud avec des espaces réservés Mustache.
3. Le type de données du document est JSONLe type de données d'entrée du document est du texte, et une expression transforme la liste de prospects de la campagne en un JSON tableau.
4. Le type de sortie est HTMLLe nœud renvoie un HTML Un dossier par prospect.
5. Un nœud d'écriture de fichier binaire enregistre chaque fichier généré HTML vers un dossier web public ; un autre nœud envoie le lien personnalisé à chaque prospect.

Génération Excel à partir d'un modèle Word. Rapports par lots

1. Un déclencheur de planification quotidien extrait les indicateurs de performance clés (KPI) de PostgreSQL.
2. Un nœud Set regroupe les lignes par région dans un JSON tableau, un enregistrement par région.
3. PDF4me Générer des documents (multiples) avec un modèle de fichier Word, un format de sortie Excel et un type de données de document JSONType de données d'entrée du document : Texte. Nom du fichier de sortie : rapport régional.
4. Le nœud renvoie un fichier .xlsx par région nommée rapport_régional_1.xlsx, rapport_régional_2.xlsx, et ainsi de suite.
5. Un nœud Microsoft OneDrive télécharge chaque fichier dans le dossier régional correspondant pour l'équipe d'analyse.

Conseils pratiques

Shape your data as rows

One record per output document. Single objects yield one file. defeats the purpose of this operation.

Use Generate Document (Single) for CSV / Mail Merge / Google Docs

Generate Documents (Multiple) only accepts JSON or XML data and Word / HTML / PDF templates.

"No binary data found" errors

Double-check Template Binary Property and Document Binary Property names. The Merge node from a fan-in workflow can rename binary properties.

Document Data Text is strictly required

On the Multiple operation, leaving the Text field empty rejects the node, stricter than Single.

Name outputs with a meaningful prefix

Use Output File Name like <code>invoice</code> or <code>customer_letter</code> so files are easy to scan in storage (avoid the generic <code>generated_document_*</code> default).

Plan for multiple items downstream

Use Split In Batches, Loop Over Items, or any node that handles many items. not just the first one.

Aide-mémoire

Champ	Valeur
Resource	Generate
Operation	Generate Documents (Multiple)
Template File Type	Word
Output Type	PDF
Template File Input Type	Binary Data
Template Binary Property	data
Document Data Type	JSON
Document Data Input Type	Text
Document Data Text	(bulk JSON array with multiple records)
Output File Name	my_document (optional, becomes prefix)
Binary Data Output Name	data
Credentials	PDF4me API credential

Foire aux questions

How is Generate Documents (Multiple) different from Generate Document (Single)?+

Multiple renders many documents per run, one n8n item per generated document. Single produces exactly one file. Multiple supports fewer template types (Word, HTML, PDF only, no Mail Merge or Google Docs), only JSON or XML data (no CSV), and adds Excel as an output option for Word and PDF templates. Use Single for one-off documents, CSV data, Mail Merge, Google Docs, or PDF form templates.

What shape should my JSON data have?+

A JSON array where each object becomes one generated document, e.g. [{"name":"Alice","email":"[email protected]"},{"name":"Bob","email":"[email protected]"}] generates two files. The node validates that the payload parses; the API drives how many documents are produced based on the records you pass.

What does Output File Name do when many documents come back?+

It becomes a prefix. Setting Output File Name to invoice with Output Type PDF produces invoice_1.pdf, invoice_2.pdf, ... If you leave it empty, filenames come from the API or default to generated_document_1, generated_document_2, ...

Can I use CSV data with Generate Documents (Multiple)?+

No. Document Data Type only offers JSON and XML on this operation. Use Generate Document (Single) for CSV input or any other workflow that needs CSV.

How do I handle the multiple output items in n8n downstream?+

Each generated document is its own n8n item with the binary file under Binary Data Output Name (default data) and metadata fields like documentIndex and totalDocuments. Wire the node into Split In Batches, Loop Over Items, Write Binary File, or any cloud-storage / email node. they iterate over all items automatically.

Can I keep generated PDFs editable?+

Yes. Enable Keep PDF Editable when Output Type is PDF. Every generated PDF in the batch keeps its AcroForm field definitions. With Keep PDF Editable off, the form is flattened to static text on each file.

What happens if the API returns a single file instead of a list?+

You will get one n8n item only. Downstream nodes that already handle multiple items behave correctly for the single-item case. Always design the rest of the flow to handle 1..N items, not exactly N.

My data file is not named data.json. does it matter?+

When using Binary Data input, set Document Data File Name explicitly so the API treats the payload with the correct extension. Same applies to the template: use Template File Name when the binary does not carry a recognisable filename.

Actions connexes

Générer un document (unique)

Générer un document à partir d'un modèle et d'un enregistrement de données. Prend en charge CSV, le publipostage et les modèles Google Docs que Multiple ne propose pas.

Remplir un formulaire PDF

Remplissez les champs AcroForm existants dans un PDF plutôt que de générer un modèle de publipostage.

Fusionner plusieurs fichiers PDF

Combiner le lot généré en un seul livrable PDF (un seul carnet de factures consolidé, par exemple).

Même tâche sur d'autres plateformes

Générer des documents (multiples) dans Make

Même opération de rendu par lots qu'un Make module : scénarios visuels qui se déploient sur de nombreux fichiers par modèle.

Générer des documents (multiples) dans Zapier

Déclenchez la génération par lots à partir de plus de 6 000 applications SaaS, webhooks et CRMs à travers Zapier.

Générer des documents (multiples) dans Power Automate

Microsoft 365 flux avec SharePoint bibliothèques de documents, Outlook Courriels de facturation et tableaux Dataverse.

Générer des documents (multiples) REST API

Le cru POST /api/v2/GenerateDocumentMultiple Point de terminaison. Pour le code backend personnalisé ou les tests Postman.

Obtenez de l'aide

n8n Integration Guiden8n SampleGetting Started