Overlay PDFs In n8n

Overlay PDFs ist ein PDF4me Knotenaktion in n8n das platziert eins PDF aufeinander, beide auf demselben pages Statt sie anzuhängen. Verwenden Sie es, um einen gestalteten Briefkopf über generierte Inhalte zu legen, einen Zertifikatsrahmen anzuwenden oder eine genehmigte Vorlage über ein eingehendes Dokument zu legen, ohne eine einzige Seite hinzuzufügen.

Was dieser Knoten bewirkt

PDF4me: Überlagerung PDFs benötigt zwei PDFs, A Base das als Hintergrund und ein Schicht das ganz oben liegt und ein einzelnes Dokument zurückgibt, in dem beide auf demselben Blatt erscheinen. pagesJede Datei hat ihren eigenen Eingabetyp, sodass die Basis als Binärdaten von einem vorherigen Knoten stammen kann, während die Ebene von einem anderen Knoten abgerufen wird. URLIm Gegensatz zum Zusammenführen von Dokumenten erhöht sich die Seitenzahl nicht, was diese Methode zum idealen Werkzeug für Briefköpfe, Rahmen und Stempelvorlagen macht.

Verwandte Blog-Beiträge(1)

Word-Dokument, Schweizer QR-Code und eine PDF-Datei. n8n führt sie zu einem Dokument zusammen. Sechs Knoten, fertig!

n8n-Workflow: Word-Datei aus Dropbox herunterladen, in PDF konvertieren, Schweizer QR-Rechnung mit PDF4me erstellen, Basis-PDF herunterladen, als Overlay einfügen, Ergebnis hochladen. Schritt-für-Schritt-Anleitung mit Screenshots und korrekten Bild-Meta-Tags.

Beitrag lesen →

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 Overlay-Anfragen sicher authentifizieren kann.

Get your API Key

Wichtige Fakten, die Sie nicht verpassen sollten

Overlay wird nicht zusammengeführt

Zusammenführen von Anhängen pages Die Anzahl stimmt also. Beim Übereinanderstapeln werden beide Dokumente auf demselben Stapel angezeigt. pagesDie Seitenzahl bleibt unverändert.

Zwei Dateien, zwei unabhängige Eingabetypen

Basis PDF Eingabetyp und -schicht PDF Die Eingabetypen werden separat festgelegt, sodass eine Datei Binärdaten enthalten kann, während die andere von einem anderen System stammt. URLDie

Die Reihenfolge ändert, was sichtbar bleibt.

Die Ebene liegt über der Basisebene. Eine Ebene mit einfarbigem Hintergrund kann darunterliegende Inhalte verdecken. Testen Sie daher beide Reihenfolgen zunächst an einem Beispielpaar.

Der PDF4me-Knoten in n8n ist auf die Aktion „PDFs überlagern“ eingestellt, wobei sowohl der Eingabetyp des Basis-PDFs als auch der Eingabetyp des Layer-PDFs Binärdaten sind, die Binärfelddaten des Basis-PDFs und des Layer-PDFs, der Ausgabedateiname „overlayed_output.pdf“ und der Ausgabename für Binärdaten „data“ lauten. — PDF4me Overlay PDFs Parameterbereich in n8n, wobei beide Eingabetypen auf Binärdaten eingestellt sind.

Überlagerung vs. Zusammenführen vs. Wasserzeichen

Drei Möglichkeiten, zusätzlichen Inhalt in ein PDF, wobei jedes Mal ein anderes Dokument entsteht.

Ansatz	Auswirkung auf die pages	Optimale Passform
Overlay PDFs	Both documents appear on the same pages, page count unchanged	Branding that already exists as a designed PDF, such as a letterhead or certificate frame
Merge PDFs	Documents follow one another, page counts add up	Content that genuinely belongs in sequence as one longer document
Add watermark	Simple text or a single image drawn onto the existing pages	A short notice such as DRAFT or CONFIDENTIAL, where no designed PDF layer exists

Welche Parameter werden überlagert? PDFs Brauchen?

Erforderlich: Die Felder „Aktion“, „beide Eingabetypen“, „das Quellfeld, das zu jedem Eingabetyp passt“ und „Ausgabedateiname“ sowie „Ausgabename für Binärdaten“ und alle Optionen unter „Erweiterte Optionen“ enthalten standardmäßige Arbeitswerte.

Parameter	Erforderlich	Was es tut	Beispiel
Action	Required	Selects the PDF4me node action to run. Choose Overlay PDFs.	`Overlay PDFs`
Base PDF Input Type	Required	Format of the background PDF. Choose Binary Data, Base64 String, or URL. Independent of the layer setting.	`Binary Data`
Layer PDF Input Type	Required	Format of the PDF placed on top. Choose Binary Data, Base64 String, or URL. Independent of the base setting.	`Binary Data`
Base PDF Binary Field	Conditional	Name of the binary property holding the base PDF. Required when Base PDF Input Type is Binary Data.	`data`
Layer PDF Binary Field	Conditional	Name of the binary property holding the layer PDF. Required when Layer PDF Input Type is Binary Data.	`data`
Base PDF Base64 Content	Conditional	Base64-encoded content of the base PDF. Required when Base PDF Input Type is Base64 String.	`JVBERi0xLjQK...`
Layer PDF Base64 Content	Conditional	Base64-encoded content of the layer PDF. Required when Layer PDF Input Type is Base64 String.	`JVBERi0xLjQK...`
Base PDF File URL	Conditional	Publicly reachable HTTPS URL to the base PDF. Required when Base PDF Input Type is URL.	`https://example.com/base.pdf`
Layer PDF File URL	Conditional	Publicly reachable HTTPS URL to the layer PDF. Required when Layer PDF Input Type is URL.	`https://example.com/letterhead.pdf`
Output File Name	Required	Filename for the combined PDF. Include the .pdf extension.	`overlayed_output.pdf`
Binary Data Output Name	Optional	Name of the binary property the output item exposes. Defaults to data.	`data`
Advanced Options	Optional	Collection for extra processing settings, added with Add Option. Leave empty unless you have a specific requirement.	`No properties`

Ausgabefelder

Ein erfolgreicher Lauf bringt eins zurück n8n Gegenstand, der die kombinierte PDFDie

Feld	Typ	Was es enthält
`Binary (data)`	Binary	The combined PDF with the layer placed over the base, under Binary Data Output Name (default data).
`fileName`	String	Generated filename, matching Output File Name.
`mimeType`	String	MIME type of the output, always application/pdf.
`fileSize`	Number	Size of the combined PDF in bytes.
`docName`	String	Document name reference for the processed file, matching fileName.
`overlayCompleted`	Boolean	Confirms the overlay operation finished, useful as an explicit check that the layer was applied.
`layersProcessed`	Number	Count of PDF layers combined into the final document.
`success`	Boolean	True when the operation completed, false on failure. Use it to branch error handling.
`message`	String	Human-readable status message, carrying success confirmation or error detail.

Wie richte ich ein Overlay ein? PDFs In n8n?

Hinzufügen PDF4me zu Ihrem n8n Workflow und wählen Sie den Overlay PDFs Aktion.
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.
Satz Basis PDF Eingabetyp Und Schicht PDF EingabetypSie sind unabhängig, daher kann jede Datei auf unterschiedliche Weise ankommen.
Füllen Sie die entsprechenden Quellfelder aus, zum Beispiel Basis PDF Binärfeld Und Schicht PDF Binärfeld, beide standardmäßig dataDie
Satz Name der Ausgabedatei (muss enden in .pdf).
Führe den Knoten aus und leite die kombinierte PDF, ausgesetzt unter Name der Binärdatenausgabezum nächsten Schritt.

Typische Konfigurationen

Workflow-BeispieleCommon n8n workflow patterns using Overlay PDFs.

Briefkopf auf generierten Dokumenten

Es wird ein Dokument aus einer Vorlage ohne Branding generiert.
Overlay PDFs verwendet den genehmigten Briefkopf PDF abgerufen von einem URL als die Schicht.
Das Markenprodukt wird ausgeliefert, ohne dass ein Designer daran mitgewirkt hat.

Zertifikatrahmen über dynamischem Inhalt

Die Daten zum Kursabschluss ergeben ein einfaches PDF mit dem Namen des Empfängers.
Overlay PDFs legt den entworfenen Zertifikatsrand darüber.
Jedes fertige Zertifikat wird per E-Mail an den Empfänger versendet.

Genehmigungsstempel auf Prüfdokumenten

Ein Dokument schließt einen Genehmigungsschritt im Arbeitsablauf ab.
Overlay PDFs bringt eine vordefinierte, genehmigte Stempelschicht an.
Die abgestempelte Kopie wird im Archiv abgelegt.

Batch-Vorlagenanwendung

Ein Loop-Over-Items-Knoten durchläuft einen Ordner mit eingehenden Lieferantendokumenten.
Overlay PDFs wendet die gleiche Schicht an PDF von einem URL jedem einzelnen.
Alle Dokumente werden mit einheitlicher Rahmung in das Archiv aufgenommen.

Praktische Tipps

Test both orderings before a batch run

Swapping which file is base and which is layer changes what stays visible. Prove it on one sample pair rather than discovering it across a hundred documents.

Design the layer with transparency in mind

A layer PDF with a solid white background will hide the base underneath. Frames, borders, and letterheads work best when the middle is genuinely empty.

Match page sizes where you can

A layer built at the same page size as the base lines up predictably. Mismatched geometry is the usual reason a stamp lands in the wrong place.

Mix input types to avoid extra nodes

Keeping a static letterhead at a URL while the base arrives as binary from the previous node saves fetching the template into the workflow separately.

Reach for merge when page count should grow

If the second document is meant to be read after the first rather than on top of it, Merge Multiple PDFs is the correct action.

Check overlayCompleted alongside success

The output carries an explicit overlay confirmation flag, which is a more specific signal than the generic success boolean alone.

Spickzettel

Feld	Wert
Action	`Overlay PDFs`
Base PDF Input Type	`Binary Data`
Layer PDF Input Type	`Binary Data`
Base PDF Binary Field	`data`
Layer PDF Binary Field	`data`
Output File Name	`overlayed_output.pdf`
Binary Data Output Name	`data`
Advanced Options	`No properties`
Credentials	`PDF4me API credential`

Häufig gestellte Fragen

What is the difference between overlaying PDFs and merging PDFs?+

Merging appends documents so the page count adds up and the files read one after another. Overlaying places the layer PDF on top of the base PDF on the same pages, so the page count does not grow and both sets of content appear together. Use overlay for letterheads, watermarks, and template stamps, and use merge when documents should follow each other.

Which file should be the base and which should be the layer?+

The base PDF is the background, and the layer PDF is placed on top of it, following the page content model described in the ISO 32000 PDF specification. For a letterhead applied to generated content, the content is usually the base and the branded template is the layer. If the layer has a solid background it can obscure what sits beneath, so test the order both ways on a sample first.

What happens if the two PDFs have different page counts?+

The two documents do not have to be identical, but the result is easiest to predict when they match or when the layer is a single page intended to repeat as a stamp. Run one representative pair through the node and inspect the output before committing a batch, since mismatched lengths are the most common cause of a surprising result.

Can the base and layer PDFs come from different sources?+

Yes. Base PDF Input Type and Layer PDF Input Type are set independently, so the base can arrive as Binary Data from a previous node in your n8n workflow while the layer is fetched from a URL, or any other combination.

Should I use Overlay PDFs or a watermark action for branding?+

Use a watermark action when you want simple text or a single image placed on the pages. Use Overlay PDFs when your branding already exists as a full PDF, such as a designed letterhead or a pre-approved certificate frame, because it preserves the layer document exactly as designed.