Genera documenti (multipli) in n8n

Genera documenti multipli PDF4me è un'azione del nodo in n8n, visualizzata nel nodo come Genera documenti (multipli), che genera più file finali in un'unica esecuzione a partire da un singolo modello e un array di record. Utilizzala per un batch di fatture, lettere ai clienti o report per regione, con ogni documento restituito come un elemento n8n separato.

Cosa fa questo nodo

PDF4me: Genera documenti (multipli) prende un modello e un elenco di record e produce molti documenti finiti in uno n8n correre. Fornire un Parola, HTML, O PDF modello Tramite dati binari, Base64, HTML codice o URL altro dati in blocco come JSON O XML (array di record o ripetizioni) XML). Ogni file generato viene restituito come elemento di output separato, quindi puoi eseguirne un ciclo, salvarli, inviarli via email o caricarli singolarmente. Usa questo nodo invece di Genera documento (singolo) Ogni volta che si dispone di un elenco di clienti, fatture o record e si desidera un documento finale per ogni riga in un'unica esecuzione.

Articoli correlati del blog

Non ci sono ancora post sul blog dedicati a questa funzionalità — in arrivo a breve.

Nel frattempo, dai un'occhiata al blog di PDF4me per trovare tutorial e procedure operative su tutte le piattaforme.

Visita il blog →

Autenticazione del tuo API Richiesta

Ogni PDF4me nodo in n8n richiede un valido Credenziali per connettersi con. Crea o selezionane uno che contenga il tuo PDF4me API chiave affinché il flusso di lavoro possa autenticare in modo sicuro le richieste di generazione di documenti in batch.

Get your API Key

Informazioni importanti da non perdere

Uno n8n elemento per documento generato

Un'esecuzione riuscita di solito restituisce più elementi, uno per ogni file generato. Ogni elemento contiene il file binario sotto Nome output dati binari e JSON metadati con documentIndex e totalDocuments in modo da poter eseguire un ciclo, salvare o inviare via e-mail ogni singolo file a valle.

Passa un array (JSON) o ripetendo XML così il API sa quanti file renderizzare

Per JSON, utilizzare un array di oggetti, uno per ogni documento generato. Per XMLUtilizzare una struttura a record ripetuti come previsto dal modello (stile stampa unione). Gli oggetti singoli producono un unico documento, il che vanifica lo scopo di questa operazione.

CSVLe funzioni di stampa unione e Google Docs non sono disponibili qui.

Il tipo di file modello offre solo Word, HTML, PDFIl tipo di dati del documento offre solo JSON O XMLSe hai bisogno CSV Se si utilizzano modelli di stampa unione o Google Docs, utilizzare invece Genera documento (singolo).

Pannello nodo completo. Modello Word + JSON Dati testuali + PDF L'output è la tipica configurazione di stampa unione

Genera documenti (multipli) vs Genera documento (singolo)

Scegliere l'opzione sbagliata è l'errore più comune in questo compito. La distinzione si basa sul numero di file restituiti e sui modelli e formati di dati offerti.

Aspetto	Genera documenti (multipli)	Genera documento (singolo)
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

Quali parametri sono necessari per la generazione di documenti (multipli)?

Richiesto nel n8n Interfaccia utente: Credenziali per la connessione, Tipo di file modello, Tipo di input del file modello, Tipo di dati del documento, Tipo di input dei dati del documento e Tipo di output (sempre mostrato. Le scelte dipendono dal tipo di file modello). Campi obbligatori condizionali (Proprietà binaria del modello, Modello Base64 Contenuto, HTML Codice, file modello URL, Testo dati documento, Proprietà binaria documento, ecc.) vengono visualizzati solo quando viene scelto il tipo di input padre. Nome file di output, Mantieni PDF Le opzioni "Modificabile" e "Nome output dati binari" sono facoltative e prevedono valori predefiniti appropriati.

Parametro	Necessario	Cosa fa	Esempio
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

Opzioni per il tipo di file modello

Scegli il formato del modello. Le opzioni relative al tipo di output cambiano in base a questa selezione.

Menu a tendina Tipo di file modello. Word, HTML, O PDF (niente stampa unione o Google Documenti qui)

ParolaPredefinito: modelli .docx

Standard PDF4me Modello Word con segnaposto per i baffi. Il tipo di output può essere PDFWord o Excel. La scelta più comune per fatture in blocco, lettere ai clienti e report personalizzati.

HTMLHTML modelli e incollati HTML codice

Renders HTML modelli con segnaposto per baffi. Il tipo di output è HTML solo. Abbina con il tipo di input File modello HTML Codice da incollare grezzo HTML in linea o utilizzare Dati binari / URL per un file .html ospitato.

PDFPDF modelli

Utilizzare un sistema esistente PDF come modello. Il tipo di output può essere PDF, Word o Excel. Per PDF output, abilita Mantieni PDF Modificabile se si desidera che i campi siano modificabili in ogni file generato.

Tipo di output per modello

Tipo di file modello	Opzioni del tipo di output	Predefinito
Word	PDF, Word, Excel	PDF
PDF	PDF, Word, Excel	PDF
HTML	HTML only	HTML

Opzioni per il tipo di input del file modello

Scegli come il modello entra nel nodo. I campi successivi cambieranno in base a questa scelta.

Tipo di input del file modello. Dati binari, Base64 Corda, HTML Codice o URL

Dati binariPredefinito: file dal nodo precedente

Legge il modello direttamente da un nodo precedente come Google Drive Download, HTTP Richiesta o lettura del file binario. Imposta Proprietà binaria del modello al nome del campo binario (predefinito) dati). Tempo di creazione del file modello è facoltativo e, in caso di errore, viene utilizzato il nome del file caricato.

Stringa Base64Base64modello codificato

Incolla o mappa una stringa base64 in Contenuto del modello Base64. Tempo di creazione del file modello è necessario che l'estensione corrisponda al tipo di file del modello (.docx, .html, .pdf).

Codice HTMLPasta cruda HTML in linea (HTML soltanto)

Valido solo quando il tipo di file modello è HTMLIncollare per intero o in parte HTML con segnaposto come {{titolo}}, {{contenuto}} in Codice HTMLIl nodo lo racchiude in un elemento base <html> guscio se mancante. Tempo di creazione del file modello è richiesto (ad esempio template.html).

URLScarica da un link pubblico

Fornire un HTTPS URL In URL del file modello. PDF4me recupera direttamente il modello. Il URL deve essere aperto (senza autenticazione) e Tempo di creazione del file modello è necessario affinché l'estensione corrisponda al tipo di modello.

Opzioni del tipo di dati del documento

Seleziona il formato dei dati che stai inviando.

Tipo di dati del documento. JSON O XML (NO CSV in questa operazione)

JSONPredefinito: array di record (opzione più comune)

Utilizzare un JSON array in cui ogni oggetto è un documento generato, ad esempio [{"name":"Alice"}, {"name":"Bob"}]Il nodo verifica che il payload sia analizzato correttamente. Un singolo oggetto genera un documento. Passa un array se ne desideri più di uno.

XMLRegistrazione ripetuta XML

Utilizzare un XML struttura il tuo modello si aspetta per righe ripetute (stile mail-merge). Il nodo non esegue una convalida approfondita. assicurati che XML corrisponde ai punti di collegamento del modello.

Opzioni per il tipo di immissione dei dati del documento

Scegli come i dati in blocco entrano nel nodo.

Tipo di input dei dati del documento. Testo, dati binari, Base64 Corda o URL

TestoPredefinito: incolla i dati in blocco direttamente nella riga

Tipo o mappa espressione completa JSON matrice o XML in Testo dei dati del documentoQuesto campo è obbligatorio severamente richiesto nell'operazione Multipla quando si seleziona Testo (più restrittivo rispetto all'operazione Singola).

Dati binariUtilizzare un file di dati da un nodo precedente

Impostato Proprietà binaria del documento al nome del campo binario (predefinito) dati). Assicurarsi che i nomi delle proprietà binarie del modello e dei dati non entrino in conflitto quando entrambi provengono dallo stesso elemento.

Stringa Base64Base64-file di dati codificato

Fornire l'intero .json O .xml file come base64 in Contenuto del documento in Base64. Nome del file di dati del documento è obbligatorio.

URLScarica da un link pubblico

Impostato URL del file di dati del documento a un pubblico HTTPS URL Del JSON O XML file di dati. Nome del file di dati del documento è necessario affinché l'estensione corrisponda al tipo di dati.

Comportamento del nome del file di output

Scenario	Nome del file di output	Nomi dei file generati
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, ...

Campi di output

Una corsa di successo restituisce uno n8n elemento per documento generato. Ogni elemento contiene entrambi JSON metadati e file binario.

Campo	Tipo	Cosa contiene
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.

Come si imposta la generazione di più documenti in n8n?

1. Aggiungere PDF4me al tuo n8n flusso di lavoro. Imposta Risorsa A Generare E Generare operazioni A Genera documenti (multipli).
2. In Credenziali per connettersi con, seleziona il tuo PDF4me credenziali o clicca Crea nuove credenziali e incolla il tuo API chiave.
3. Impostato Tipo di file modello A Parola (predefinito), HTML, O PDF.
4. Impostato Tipo di output. PDF, Word o Excel per Word / PDF modelli; HTML solo per HTML modelli.
5. Impostato Tipo di input del file modello A Dati binari (predefinito), Base64 Corda, HTML Codice HTML solo), o URL e compila il campo del modello corrispondente più Tempo di creazione del file modello se necessario.
6. Impostato Tipo di dati del documento A JSON (predefinito) o XML.
7. Impostato Tipo di immissione dati del documento A Testo (predefinito) e incolla il tuo JSON array in Testo dei dati del documento. oppure scegli Dati binari, Base64 Corda o URL e fornire il file di dati.
8. Impostato Nome del file di output in qualcosa di leggibile come invoice quindi i file vengono restituiti come invoice_1.pdf, invoice_2.pdf, ...
9. Se in uscita PDF e il tuo modello ha campi modulo, abilita Mantenere PDF Modificabile.
10. Partire Nome dell'output dei dati binari COME data a meno che un nodo a valle non necessiti di un nome di proprietà diverso. Esegui il nodo e instrada i molteplici elementi di output in Dividi in batch, Scrivi file binario, Invia tramite e-mail o carica su cloud storage.

Configurazioni tipiche

Esempi di flusso di lavoroCommon n8n workflow patterns using Generate Documents (Multiple).

Stampa unione da un array JSON. Lettere ai clienti.

1. Un nodo di Fogli Google importa nel flusso di lavoro un elenco di clienti con nome, indirizzo e saldo.
2. Un nodo Codice o Set raggruppa le righe in un JSON matrice di oggetti (un oggetto per cliente).
3. PDF4me Genera documenti (multipli) viene eseguito con tipo di file modello Word, tipo di output PDF, Tipo di input del file modello Dati binari e Tipo di input dei dati del documento Testo. Il nome del file di output è lettera al cliente.
4. Il nodo restituisce un elemento per cliente denominato lettera_al_cliente_1.pdf, lettera_al_cliente_2.pdfe così via.
5. Un nodo Loop Over Items invia ogni PDF al cliente corrispondente tramite Gmail o caricamenti su Google Drive.

Modello + dati entrambi come file in n8n

1. Un nodo scarica il modello .docx; un altro nodo scarica il file .json dei clienti. Un nodo Merge li combina in modo che entrambi i file binari finiscano in un unico elemento.
2. PDF4me Genera documenti (multipli) è configurato con tipo di input file modello Dati binari (Proprietà binaria del modello impostato sul nome del campo del modello) e Tipo di input dati documento Dati binari (Proprietà binaria del documento impostato sul nome del campo dati).
3. Impostato Nome del file di dati del documento se il file di dati non è denominato data.json.
4. I file generati vengono restituiti come elementi separati e vengono scritti su un SharePoint Libreria di documenti denominata con l'ID del cliente.

Modello ospitato + dati ospitati. Elaborazione batch delle fatture

1. Un trigger di pianificazione notturno avvia l'esecuzione in batch delle fatture.
2. PDF4me Genera documenti (multipli) è impostato con tipo di input file modello URL URL del file modello punta al modello di fattura .docx su S3) e al tipo di input dati documento URL URL del file di dati del documento punta a un generato ciclo-di-fatturazione.json file).
3. Tempo di creazione del file modello È fattura.docx E Nome del file di dati del documento È ciclo-di-fatturazione.json.
4. Il tipo di output è PDF, Il nome del file di output è fatturae mantieni PDF La modalità modifica è disattivata.
5. Ogni articolo restituito viene caricato nella cartella del cliente su Dropbox e inviato via email tramite Outlook.

Creazione di pagine di destinazione personalizzate tramite codice HTML incollato

1. Un trigger Webhook si attiva al lancio di una campagna di marketing.
2. PDF4me Genera documenti (multipli) è impostato con il tipo di file modello HTML e tipo di input del file modello HTML Codice. HTML viene incollato direttamente nel nodo con i segnaposto a forma di baffi.
3. Il tipo di dati del documento è JSON, Il tipo di input dei dati del documento è Testo e un'espressione mappa l'elenco dei lead della campagna in un JSON vettore.
4. Il tipo di output è HTMLIl nodo restituisce uno HTML file per lead.
5. Un nodo Write Binary File salva ogni file generato HTML in una cartella web pubblica; un altro nodo invia il link personalizzato a ciascun potenziale cliente.

Output di Excel da un modello di Word. Report batch

1. Un trigger programmato giornaliero preleva i valori KPI da PostgreSQL.
2. Un nodo Set raggruppa le righe per regione in un JSON matrice, un record per regione.
3. PDF4me Genera documenti (multipli) viene eseguito con tipo di file modello Word, tipo di output Excel, tipo di dati documento JSON, Tipo di input dati documento Testo. Nome file di output è rapporto regionale.
4. Il nodo restituisce un file .xlsx per regione denominata rapporto_regionale_1.xlsx, rapporto_regionale_2.xlsxe così via.
5. Un nodo di Microsoft OneDrive carica ciascun file nella cartella regionale corrispondente per il team di analisi.

Consigli pratici

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.

Foglio riassuntivo

Campo	Valore
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

Domande frequenti

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.

Azioni correlate

Genera documento (singolo)

Genera un documento da un modello e un record di dati. Supporta CSVModelli di stampa unione e documenti Google che Multiple non supporta.

Compila un modulo PDF

Popola i campi AcroForm esistenti in un PDF anziché generare il contenuto da un modello di stampa unione.

Unire più file PDF

Unire il batch generato in un unico risultato PDF (ad esempio, un unico registro delle fatture consolidato).

Stessa attività su altre piattaforme

Genera documenti (multipli) in Make

Stessa operazione di rendering batch di un Make modulo: scenari visivi che si diramano in molti file per modello.

Genera documenti (multipli) in Zapier

Attiva la generazione batch da oltre 6.000 app SaaS, webhook e CRMs Attraverso Zapier.

Genera documenti (multipli) in Power Automate

Microsoft 365 scorre con SharePoint librerie di documenti, Outlook email di fatturazione e array Dataverse.

Genera documenti (multipli) REST API

Il grezzo POST /api/v2/GenerateDocumentMultiple endpoint. per codice backend personalizzato o test con Postman.

Richiedi assistenza

n8n Integration Guiden8n SampleGetting Started