Zum Hauptinhalt springen

Dokumente (mehrere) generieren in n8n

Mehrere Dokumente generieren Die PDF4me-Knotenaktion in n8n, im Knoten als „Dokumente generieren (Mehrere)“ angezeigt, erzeugt in einem Durchlauf mehrere fertige Dateien aus einer einzigen Vorlage und einem Array von Datensätzen. Sie eignet sich beispielsweise für Stapelverarbeitungen von Rechnungen, Kundenbriefen oder regionalen Berichten. Jedes Dokument wird als eigenes n8n-Element zurückgegeben.

Was dieser Knoten bewirkt

PDF4me: Dokumente generieren (Mehrere) benötigt eine Vorlage und eine Liste von Datensätzen und erzeugt in einem Schritt viele fertige Dokumente. n8n Führen Sie aus. Stellen Sie eine bereit. Wort, HTML, oder PDF Vorlage über Binärdaten, Base64, HTML Code oder URL plus Massendaten als JSON oder XML (Array von Datensätzen oder Wiederholungen) XMLJede generierte Datei wird als separates Ausgabeelement zurückgegeben, sodass Sie sie einzeln verarbeiten, speichern, per E-Mail versenden oder hochladen können. Verwenden Sie diesen Knoten anstelle von Dokument generieren (Einzeln) Immer dann, wenn Sie eine Liste von Kunden, Rechnungen oder Datensätzen haben und für jede Zeile ein fertiges Dokument in einem einzigen Durchlauf erstellen möchten.

Verwandte Blog-Beiträge
Zu dieser Funktion gibt es noch keinen Blogbeitrag – folgt in Kürze.
Schauen Sie sich in der Zwischenzeit im PDF4me-Blog Tutorials und Arbeitsabläufe für alle Plattformen an.
Besuchen Sie den Blog

Authentifizierung Ihres API Anfrage

Jeder PDF4me Knoten in n8n erfordert eine gültige Anmeldeinformationen zum Verbinden mitErstellen oder wählen Sie einen Eintrag aus, der Ihre Daten enthält. PDF4me API Schlüssel, damit der Workflow Batch-Dokumentgenerierungsanforderungen sicher authentifizieren kann.

Wichtige Fakten, die Sie nicht verpassen sollten

Eins n8n Artikel pro generiertem Dokument
Ein erfolgreicher Durchlauf liefert in der Regel mehrere Elemente, eines pro generierter Datei. Jedes Element enthält die Binärdatei unter dem Namen „Binary Data Output Name“ und JSON Metadaten mit documentIndex und totalDocuments ermöglichen es Ihnen, jede Datei einzeln weiterzuverarbeiten, zu speichern oder per E-Mail zu versenden.
Übergeben Sie ein Array (JSON) oder wiederholend XML also die API weiß, wie viele Dateien gerendert werden sollen.
Für JSONVerwenden Sie ein Array von Objekten, eines pro generiertem Dokument. Für XMLVerwenden Sie die vom Template erwartete Struktur mit sich wiederholenden Datensätzen (Serienbriefstil). Einzelne Objekte erzeugen ein einzelnes Dokument, was den Zweck dieser Operation zunichtemacht.
CSVSerienbriefe und Google Docs sind hier nicht verfügbar.
Der Vorlagendateityp bietet nur Word an. HTML, PDFDer Dokumentdatentyp bietet nur JSON oder XMLFalls Sie benötigen CSV Verwenden Sie anstelle von Eingabe- oder Serienbriefvorlagen bzw. Google Docs-Vorlagen die Option „Dokument generieren (Einzeln)“.
Dokumente generieren (Mehrere) n8n-Knoten mit Anmeldeinformationen für die Verbindung mit Pdf4me, Ressourcengenerierung, Generierungsvorgänge, Dokumente generieren (Mehrere), Vorlagendateityp: Word, Ausgabetyp: PDF, Vorlagendatei-Eingabetyp: Binärdaten, Vorlagen-Binäreigenschaften: data, Vorlagendateiname: template.docx, Dokumentdatentyp: JSON, Dokumentdaten-Eingabetyp: Text, Beispieldokumentdaten: Text, Ausgabedateiname: generated_document, PDF bearbeitbar lassen (Umschalter), Binärdaten-Ausgabename: data

Vollständiges Knotenpanel. Word-Vorlage + JSON Textdaten + PDF Die Ausgabe entspricht dem typischen Serienbrief-Setup.

Dokumente generieren (mehrere) vs Dokument generieren (einzeln)

Die häufigste Fehlerquelle bei dieser Aufgabe ist die Wahl der falschen der beiden Optionen. Die Aufteilung hängt davon ab, wie viele Dateien zurückgegeben werden und welche Vorlagen und Datenformate angeboten werden.

AspektDokumente generieren (mehrere)Dokument generieren (Einzeln)
Files returnedMany, one n8n item per generated documentExactly one
Template typesWord, HTML, PDFWord, HTML, PDF, plus Mail Merge and Google Docs
Data formatsJSON or XML onlyJSON, XML, and CSV
Output typesPDF, Word, or Excel (HTML templates output HTML)PDF, Word (no Excel option)
Reach for it whenYou have a list of records and want one document per rowYou have a single record, CSV data, or a Mail Merge template

Welche Parameter benötigt die Funktion „Dokumente generieren (Mehrere)“?

Erforderlich in der n8n Benutzeroberfläche: Anmeldeinformationen für die Verbindung, Vorlagendateityp, Vorlagendatei-Eingabetyp, Dokumentdatentyp, Dokumentdaten-Eingabetyp und Ausgabetyp (wird immer angezeigt; die Auswahlmöglichkeiten hängen vom Vorlagendateityp ab). Bedingt erforderliche Felder (Binäre Eigenschaften der Vorlage, Vorlage). Base64 Inhalt, HTML Code, Vorlagendatei URLDokumentdaten (Text), Dokumentbinäreigenschaft usw.) werden nur angezeigt, wenn der entsprechende übergeordnete Eingabetyp ausgewählt ist. Ausgabedateiname beibehalten PDF Die Optionen „Bearbeitbar“ und „Binärdatenausgabename“ sind optional und verwenden sinnvolle Standardwerte.

ParameterErforderlichWas es tutBeispiel
Template File TypeRequiredFormat 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 TypeRequiredFormat 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 TypeRequiredHow 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 PropertyConditionalName 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 ContentConditionalBase64-encoded template content. Required when Template File Input Type is Base64 String.UEsDBBQAAAAI...
HTML CodeConditionalRaw 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 URLConditionalPublicly reachable HTTPS URL to the template file. Required when Template File Input Type is URL.https://example.com/template.docx
Template File NameConditionalFilename 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 TypeRequiredFormat 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 TypeRequiredHow 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 TextConditionalRaw 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 PropertyConditionalName 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 NameConditionalFilename 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 ContentConditionalBase64-encoded data file. Required when Document Data Input Type is Base64 String.W3sibmFtZSI6...
Document Data File URLConditionalPublicly reachable HTTPS URL to the bulk data file. Required when Document Data Input Type is URL.https://example.com/customers.json
Output File NameOptionalPrefix 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 EditableOptionalOnly 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 NameOptionalName of the binary property each output item exposes. Default is data. Placeholder suggests generated-documents.data

Optionen für den Vorlagendateityp

Wählen Sie das Vorlagenformat. Die Ausgabetypen ändern sich mit dieser Auswahl.

Das Dropdown-Menü „Vorlagendateityp“ im Knoten „Dokumente generieren (Mehrere)“ von n8n PDF4me zeigt drei Optionen an: Word (hervorgehoben), HTML und PDF.

Dropdown-Menü „Vorlagendateityp“. Word, HTML, oder PDF (Hier werden weder Serienbriefe noch Google Docs verwendet)

WortStandard: .docx-Vorlagen
Standard PDF4me Word-Vorlage mit Schnurrbart-Platzhaltern. Der Ausgabetyp kann sein: PDFWord oder Excel. Die gängigste Wahl für Sammelrechnungen, Kundenbriefe und personalisierte Berichte.
HTMLHTML Vorlagen und eingefügt HTML Code
Renderings HTML Vorlagen mit Schnurrbart-Platzhaltern. Ausgabetyp ist HTML Nur. Passend zum Eingabetyp „Vorlagendatei“. HTML Code zum Einfügen (Rohdaten) HTML inline oder Binärdaten verwenden / URL für eine gehostete .html-Datei.
PDFPDF Vorlagen
Verwenden Sie ein vorhandenes PDF als Vorlage. Der Ausgabetyp kann sein PDF, Word oder Excel. Für PDF Ausgabe, Beibehalten aktivieren PDF Bearbeitbar, wenn die Felder in jeder generierten Datei bearbeitbar sein sollen.

Ausgabetyp nach Vorlage

VorlagendateitypAuswahlmöglichkeiten für den AusgabetypStandard
WordPDF, Word, ExcelPDF
PDFPDF, Word, ExcelPDF
HTMLHTML onlyHTML

Vorlagendatei Eingabetypoptionen

Wählen Sie aus, wie die Vorlage in den Knoten eingefügt wird. Die Folgefelder ändern sich je nach dieser Auswahl.

Das Dropdown-Menü „Vorlagendatei-Eingabetyp“ im Knoten „Dokumente generieren (Mehrere)“ von n8n PDF4me bietet vier Optionen: Binärdaten (hervorgehoben mit Beschreibung): Vorlagendatei aus dem vorherigen Knoten verwenden; Base64-Zeichenkette (mit Beschreibung): Base64-kodierte Vorlagendatei angeben; HTML-Code (mit Beschreibung): Rohen HTML-Code manuell schreiben (nur für den Vorlagentyp HTML verfügbar); URL (mit Beschreibung): URL zur Vorlagendatei angeben

Eingabetyp der Vorlagendatei: Binärdaten. Base64 Zeichenkette HTML Code oder URL

BinärdatenStandardwert: Datei vom vorherigen Knoten
Liest die Vorlage direkt aus einem vorherigen Knoten, z. B. Google Drive Download, HTTP Binärdatei anfordern oder lesen. Festlegen Vorlage Binäre Eigenschaft zum Namen des Binärfelds (Standardwert) Daten). Vorlagendateiname ist optional und verwendet ansonsten den Namen der hochgeladenen Datei.
Base64-ZeichenketteBase64-kodierte Vorlage
Fügen Sie eine Base64-Zeichenkette ein oder ordnen Sie sie zu in Vorlage Base64-InhaltDie Vorlagendateiname ist erforderlich, damit die Dateierweiterung mit dem Dateityp der Vorlage (.docx, .html, .pdf) übereinstimmt.
HTML-CodeRohpaste HTML im Einklang (HTML nur)
Nur gültig, wenn der Vorlagendateityp HTML. Vollständige oder teilweise Einfügen HTML mit Platzhaltern wie {{Titel}}, {{Inhalt}} hinein HTML-CodeDer Knoten kapselt es in eine einfache <html> Shell, falls fehlt. Vorlagendateiname ist erforderlich (z.B. template.html).
URLVon einem öffentlichen Link herunterladen
Stellen Sie eine bereit HTTPS URL In URL der VorlagendateiDie PDF4me Ruft die Vorlage direkt ab. URL muss offen sein (keine Authentifizierung erforderlich) und Vorlagendateiname ist erforderlich, damit die Erweiterung zum Vorlagentyp passt.

Optionen für Dokumentdatentypen

Wählen Sie das Datenformat aus, das Sie senden möchten.

Im Dropdown-Menü „Dokumentdatentyp“ des Knotens „Dokumente generieren (Mehrere)“ in n8n PDF4me werden JSON und XML als Optionen hervorgehoben. Der Tooltip lautet: „Parameter documentDataType“.

Dokumentdatentyp. JSON oder XML (NEIN CSV bei diesem Vorgang)

JSONStandardwert: Array von Datensätzen (am häufigsten)
Verwenden Sie ein JSON Array, wobei jedes Objekt ein generiertes Dokument ist, z.B. [{"name":"Alice"}, {"name":"Bob"}]Der Knoten prüft, ob die Nutzdaten korrekt geparst werden. Ein einzelnes Objekt erzeugt ein Dokument. Übergeben Sie ein Array, wenn Sie mehrere Dokumente benötigen.
XMLWiederholungsaufnahme XML
Verwenden Sie einen XML Die Struktur, die Ihre Vorlage für wiederholte Zeilen erwartet (Serienbrief-Stil), ist korrekt. Der Knoten führt keine detaillierte Validierung durch. Stellen Sie sicher, dass… XML entspricht den Bindungspunkten der Vorlage.

Optionen für den Dokumentdaten-Eingabetyp

Wählen Sie aus, wie die Massendaten in den Knoten gelangen.

Das Dropdown-Menü „Dokumentdaten-Eingabetyp“ im Knoten „Dokumente generieren (Mehrere)“ von n8n PDF4me bietet vier Optionen: „Text hervorgehoben mit Beschreibung: JSON- oder XML-Daten manuell eingeben“, „Binärdaten mit Beschreibung: Datendatei aus dem vorherigen Knoten verwenden“, „Base64-Zeichenkette mit Beschreibung: Base64-kodierte Datendatei angeben“ und „URL mit Beschreibung: URL zur Datendatei angeben“.

Dokumentdaten-Eingabetyp: Text, Binärdaten. Base64 Zeichenkette oder URL

TextStandardmäßig werden Massendaten inline eingefügt.
Geben Sie den vollständigen Text ein oder verwenden Sie eine Ausdruckszuordnung. JSON Array oder XML hinein Dokumentdaten TextDieses Feld ist bei der Mehrfachauswahl zwingend erforderlich, wenn „Text“ ausgewählt ist (strenger als bei der Einzelauswahl).
BinärdatenVerwenden Sie eine Datendatei von einem vorherigen Knoten.
Satz Dokument-Binär-Eigenschaft zum Namen des Binärfelds (Standardwert) DatenAchten Sie darauf, dass die Namen der Vorlagen- und Datenbinäreigenschaften nicht kollidieren, wenn beide vom selben Element stammen.
Base64-ZeichenketteBase64-kodierte Datendatei
Stellen Sie das gesamte Dokument bereit. .json oder .xml Datei als Base64 in Dokument Base64-InhaltDie Dokumentdatendateiname ist erforderlich.
URLVon einem öffentlichen Link herunterladen
Satz URL der Dokumentdatendatei an eine Öffentlichkeit HTTPS URL der JSON oder XML Datendatei. Dokumentdatendateiname ist erforderlich, damit die Dateiendung zum Datentyp passt.

Verhalten des Ausgabedateinamens

SzenarioName der AusgabedateiGenerierte Dateinamen
One document returnedinvoiceinvoice.pdf (extension added if missing)
Many documents returnedinvoiceinvoice_1.pdf, invoice_2.pdf, invoice_3.pdf, ...
Many documents, name left empty(empty)API-provided names or generated_document_1, generated_document_2, ...

Ausgabefelder

Ein erfolgreicher Lauf bringt eins zurück n8n Ein Element pro generiertem Dokument. Jedes Element enthält beides. JSON Metadaten und die Binärdatei.

FeldTypWas es enthält
successBooleanTrue when the document was generated successfully. Use to route error handling branches.
fileNameStringFilename of this generated document, e.g. invoice_2.pdf. Map into upload or email nodes.
mimeTypeStringMIME type of the output file, e.g. application/pdf, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, text/html.
fileSizeNumberSize of the generated file in bytes.
documentIndexNumberIndex of this document within the batch (1-based). Useful for filenames or logging.
totalDocumentsNumberHow many documents were produced in this run. Same on every item.
Binary (data)BinaryThe generated document under Binary Data Output Name (default data). Pass to Write Binary File, Email, or any cloud-storage upload.

Wie richte ich die Option „Mehrere Dokumente generieren“ in n8n ein?

  1. Hinzufügen PDF4me zu Ihrem n8n Workflow. Festlegen Ressource Zu Erzeugen Und Operationen generieren Zu Dokumente generieren (mehrere)Die
  2. In Anmeldeinformationen zum Verbinden mit, wählen Sie Ihre PDF4me Anmeldeinformationen oder klicken Neue Anmeldeinformationen erstellen und fügen Sie Ihren ein API Schlüssel.
  3. Satz Vorlagendateityp Zu Wort (Standard), HTML, oder PDFDie
  4. Satz AusgabetypDie PDF, Word oder Excel für Word / PDF Vorlagen; HTML nur für HTML Vorlagen.
  5. Satz Eingabetyp der Vorlagendatei Zu Binärdaten (Standard), Base64 Zeichenkette, HTML Code (HTML nur), oder URL und füllen Sie das entsprechende Vorlagenfeld aus. Vorlagendateiname falls erforderlich.
  6. Satz Dokumentdatentyp Zu JSON (Standardeinstellung) oder XMLDie
  7. Satz Dokumentdaten-Eingabetyp Zu Text (Standardeinstellung) und fügen Sie Ihre ein JSON Array in Dokumentdaten Text. oder wählen Sie Binärdaten, Base64 Zeichenkette oder URL und die Datendatei bereitstellen.
  8. Satz Name der Ausgabedatei zu etwas Lesbarem wie invoice Die Dateien werden also zurückgeliefert als invoice_1.pdf, invoice_2.pdf, ...
  9. Wenn Ausgabe PDF und Ihre Vorlage Formularfelder enthält, aktivieren Sie diese. Halten PDF BearbeitbarDie
  10. Verlassen Name der Binärdatenausgabe als data Sofern ein nachgelagerter Knoten keinen anderen Eigenschaftsnamen benötigt, führen Sie den Knoten aus und leiten Sie die verschiedenen Ausgabeelemente an „In Stapeln aufteilen“, „Binärdatei schreiben“, „E-Mail“ oder „Cloud-Speicher-Upload“ weiter.

Typische Konfigurationen

Workflow-BeispieleCommon n8n workflow patterns using Generate Documents (Multiple).
Serienbriefe aus einem JSON-Array. Kundenbriefe
  1. Ein Google Sheets-Knoten importiert eine Liste von Kunden mit Namen, Adresse und Kontostand in den Workflow.
  2. Ein Code- oder Set-Knoten verpackt die Zeilen in ein JSON Array von Objekten (ein Objekt pro Kunde).
  3. PDF4me Mehrere Durchläufe zum Generieren von Dokumenten mit der Vorlage Dateityp Word, Ausgabetyp PDFDie Vorlagendatei hat den Eingabetyp Binärdaten, die Dokumentdaten den Eingabetyp Text. Der Ausgabedateiname lautet: KundenbriefDie
  4. Der Knoten gibt einen Artikel pro Kunde zurück, der benannt ist Kundenbrief_1.pdf, Kundenbrief_2.pdf, und so weiter.
  5. Ein Schleifenknoten sendet jedes Element PDF an den entsprechenden Kunden per Gmail oder Upload auf Google Drive.
Vorlage + Daten jeweils als Dateien in n8n
  1. Ein Knoten lädt die .docx-Vorlage herunter, ein anderer die .json-Kundendatei. Ein Merge-Knoten kombiniert die Dateien, sodass beide Binärdateien in einem Eintrag landen.
  2. PDF4me Die Funktion „Dokumente generieren (Mehrere)“ ist mit dem Eingabetyp „Binärdaten“ für Vorlagendateien konfiguriert.Vorlage Binäre Eigenschaft auf den Vorlagenfeldnamen festgelegt) und Dokumentdaten-Eingabetyp Binärdaten (Dokument-Binär-Eigenschaft (auf den Namen des Datenfelds setzen).
  3. Satz Dokumentdatendateiname wenn die Datendatei nicht benannt ist data.jsonDie
  4. Die generierten Dateien werden als separate Elemente zurückgegeben und in ein Verzeichnis geschrieben. SharePoint Dokumentenbibliothek, benannt nach der Kunden-ID.
Gehostete Vorlage + gehostete Daten. Rechnungsstapel
  1. Ein nächtlicher Zeitplan-Trigger löst die Stapelverarbeitung der Rechnungen aus.
  2. PDF4me Die Option „Dokumente generieren (Mehrere)“ ist auf den Eingabetyp „Vorlagendatei“ eingestellt. URL (URL der Vorlagendatei (verweist auf die .docx-Rechnungsvorlage auf S3) und Dokumentdaten-Eingabetyp URL (URL der Dokumentdatendatei verweist auf ein generiertes billing-cycle.json Datei).
  3. Vorlagendateiname Ist Rechnung.docx Und Dokumentdatendateiname Ist billing-cycle.jsonDie
  4. Ausgabetyp ist PDFDer Name der Ausgabedatei lautet: Rechnungund behalten PDF Die Bearbeitungsfunktion ist deaktiviert.
  5. Jeder zurückgesendete Artikel wird in den Ordner des Kunden in Dropbox hochgeladen und per Outlook-E-Mail versendet.
HTML-Batch aus eingefügtem Code → personalisierte Landingpages
  1. Ein Webhook-Trigger wird ausgelöst, wenn eine Marketingkampagne startet.
  2. PDF4me Die Option „Dokumente generieren (Mehrere)“ ist auf den Dateityp „Vorlage“ eingestellt. HTML und Vorlagendatei-Eingabetyp HTML Code. der HTML wird direkt in den Knoten mit Schnurrbart-Platzhaltern eingefügt.
  3. Der Dokumentdatentyp ist JSONDer Dokumentdaten-Eingabetyp ist Text, und ein Ausdruck ordnet die Lead-Liste der Kampagne einem Text zu. JSON Array.
  4. Ausgabetyp ist HTMLDer Knoten gibt einen Wert zurück HTML Akte pro Lead.
  5. Ein Write Binary File-Knoten speichert jede generierte Datei. HTML in einen öffentlichen Webordner; ein anderer Knoten sendet den personalisierten Link an jeden Lead.
Excel-Ausgabe aus einer Word-Vorlage. Stapelberichte
  1. Ein täglicher Zeitplan-Trigger ruft KPI-Zahlen aus PostgreSQL ab.
  2. Ein Set-Knoten gruppiert die Zeilen nach Region in eine JSON Array, ein Datensatz pro Region.
  3. PDF4me Mehrere Durchläufe zum Generieren von Dokumenten mit der Vorlage Dateityp Word, Ausgabetyp Excel, Dokumentdatentyp JSONDokumentdaten-Eingabetyp: Text. Ausgabedateiname: RegionsberichtDie
  4. Der Knoten gibt pro Region mit dem Namen eine .xlsx-Datei zurück. region_report_1.xlsx, region_report_2.xlsx, und so weiter.
  5. Ein Microsoft OneDrive-Knoten lädt jede Datei in den entsprechenden Regionsordner für das Analyseteam hoch.

Praktische Tipps

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.

Spickzettel

FeldWert
ResourceGenerate
OperationGenerate Documents (Multiple)
Template File TypeWord
Output TypePDF
Template File Input TypeBinary Data
Template Binary Propertydata
Document Data TypeJSON
Document Data Input TypeText
Document Data Text(bulk JSON array with multiple records)
Output File Namemy_document (optional, becomes prefix)
Binary Data Output Namedata
CredentialsPDF4me API credential

Häufig gestellte Fragen

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.

Verwandte Aktionen

Dieselbe Aufgabe auf anderen Plattformen

Hilfe erhalten