Aller au contenu principal

Superposition PDFs dans n8n

Superposition PDFs est un PDF4me action de nœud dans n8n qui place un PDF l'un sur l'autre, combinant les deux sur le même pages Au lieu de les ajouter, utilisez-le pour apposer un en-tête personnalisé sur un contenu généré, appliquer un cadre de certificat ou superposer un modèle approuvé à un document entrant sans ajouter une seule page.

Que fait ce nœud ?

PDF4me: Superposition PDFs prend deux PDFs, un base qui sert de fond et de couche qui se place au-dessus et renvoie un document unique où les deux apparaissent sur le même pagesChaque fichier possède son propre type d'entrée ; ainsi, la base peut provenir d'un nœud précédent sous forme de données binaires, tandis que la couche est extraite d'un autre fichier. URLContrairement à la fusion, le nombre de pages ne diminue pas, ce qui en fait l'outil idéal pour les en-têtes de lettres, les cadres et les tampons modèles.

Articles de blog connexes(1)

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 les requêtes de superposition de manière sécurisée.

Informations importantes à ne pas manquer

La superposition n'est pas fusionnée
Fusion des appends pages Le total est donc correct. La superposition empile les deux documents sur le même support. pages, sans modifier le nombre de pages.
Deux fichiers, deux types d'entrée indépendants
Base PDF Type d'entrée et couche PDF Les types d'entrée sont définis séparément, de sorte qu'un fichier peut contenir des données binaires tandis que l'autre provient d'un URL.
L'ordre modifie ce qui reste visible
Le calque se superpose au calque de base. Un calque avec un fond uni peut masquer le contenu situé en dessous ; il est donc conseillé de tester les deux ordres sur un échantillon.
Le nœud PDF4me dans n8n est configuré sur « Superposition de PDF », avec les types d'entrée PDF de base et PDF de calque « Données binaires », les champs binaires PDF de base et de calque, le nom du fichier de sortie « overlayed_output.pdf » et le nom de sortie des données binaires « data ».

PDF4me Superposition PDFs panneau des paramètres dans n8n, les deux types d'entrée étant définis sur Données binaires

Superposition vs Fusion vs Filigrane

Trois façons d'intégrer du contenu supplémentaire dans un PDF, chacun produisant un document différent.

ApprocheEffet sur le pagesMeilleure adaptation
Overlay PDFsBoth documents appear on the same pages, page count unchangedBranding that already exists as a designed PDF, such as a letterhead or certificate frame
Merge PDFsDocuments follow one another, page counts add upContent that genuinely belongs in sequence as one longer document
Add watermarkSimple text or a single image drawn onto the existing pagesA short notice such as DRAFT or CONFIDENTIAL, where no designed PDF layer exists

Quels paramètres sont affectés par la superposition ? PDFs Besoin?

Requis: L'action, les deux types d'entrée, le champ source correspondant à chaque type d'entrée et le nom du fichier de sortie. Le nom de sortie des données binaires et les options avancées conservent leurs valeurs par défaut.

ParamètreRequisCe que cela faitExemple
ActionRequiredSelects the PDF4me node action to run. Choose Overlay PDFs.Overlay PDFs
Base PDF Input TypeRequiredFormat of the background PDF. Choose Binary Data, Base64 String, or URL. Independent of the layer setting.Binary Data
Layer PDF Input TypeRequiredFormat of the PDF placed on top. Choose Binary Data, Base64 String, or URL. Independent of the base setting.Binary Data
Base PDF Binary FieldConditionalName of the binary property holding the base PDF. Required when Base PDF Input Type is Binary Data.data
Layer PDF Binary FieldConditionalName of the binary property holding the layer PDF. Required when Layer PDF Input Type is Binary Data.data
Base PDF Base64 ContentConditionalBase64-encoded content of the base PDF. Required when Base PDF Input Type is Base64 String.JVBERi0xLjQK...
Layer PDF Base64 ContentConditionalBase64-encoded content of the layer PDF. Required when Layer PDF Input Type is Base64 String.JVBERi0xLjQK...
Base PDF File URLConditionalPublicly reachable HTTPS URL to the base PDF. Required when Base PDF Input Type is URL.https://example.com/base.pdf
Layer PDF File URLConditionalPublicly reachable HTTPS URL to the layer PDF. Required when Layer PDF Input Type is URL.https://example.com/letterhead.pdf
Output File NameRequiredFilename for the combined PDF. Include the .pdf extension.overlayed_output.pdf
Binary Data Output NameOptionalName of the binary property the output item exposes. Defaults to data.data
Advanced OptionsOptionalCollection for extra processing settings, added with Add Option. Leave empty unless you have a specific requirement.No properties

Champs de sortie

Une course réussie rapporte un n8n objet contenant l'ensemble PDF.

ChampTaperCe qu'il contient
Binary (data)BinaryThe combined PDF with the layer placed over the base, under Binary Data Output Name (default data).
fileNameStringGenerated filename, matching Output File Name.
mimeTypeStringMIME type of the output, always application/pdf.
fileSizeNumberSize of the combined PDF in bytes.
docNameStringDocument name reference for the processed file, matching fileName.
overlayCompletedBooleanConfirms the overlay operation finished, useful as an explicit check that the layer was applied.
layersProcessedNumberCount of PDF layers combined into the final document.
successBooleanTrue when the operation completed, false on failure. Use it to branch error handling.
messageStringHuman-readable status message, carrying success confirmation or error detail.

Comment configurer la superposition ? PDFs dans n8n?

  1. Ajouter PDF4me à votre n8n flux de travail et choisissez le Superposition PDFs action.
  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 Base PDF Type d'entrée et Couche PDF Type d'entréeIls sont indépendants, donc chaque fichier peut arriver différemment.
  4. Remplissez les champs source correspondants, par exemple Base PDF Champ binaire et Couche PDF Champ binaire, tous deux par défaut à data.
  5. Ensemble Nom du fichier de sortie (doit se terminer par .pdf).
  6. Exécutez le nœud et acheminez le flux combiné PDF, exposé sous Nom de la sortie de données binaires, à l'étape suivante.

Configurations typiques

Exemples de flux de travailCommon n8n workflow patterns using Overlay PDFs.
Papier à en-tête sur les documents générés
  1. Un document est généré à partir d'un modèle sans marque.
  2. Superposition PDFs utilise le papier à en-tête approuvé PDF récupéré d'un URL comme la couche.
  3. Le produit final, portant la marque, est expédié sans qu'aucun designer n'y touche.
Cadre de certificat sur contenu dynamique
  1. Les données relatives à l'achèvement des cours produisent un résultat simple PDF avec le nom du destinataire.
  2. Superposition PDFs place la bordure du certificat conçue par-dessus.
  3. Chaque certificat finalisé est envoyé par courriel à son destinataire.
Cachet d'approbation sur les documents de révision
  1. Un document marque la fin d'une étape d'approbation dans le flux de travail.
  2. Superposition PDFs applique une couche de tampon préconçue et approuvée.
  3. L'exemplaire estampillé est classé dans le système d'archivage.
Application de modèle de traitement par lots
  1. Un nœud de boucle sur les éléments parcourt un dossier contenant les documents entrants des fournisseurs.
  2. Superposition PDFs applique la même couche PDF d'un URL à chacun.
  3. Chaque document entre dans les archives avec un encadrement uniforme.

Conseils pratiques

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.

Aide-mémoire

ChampValeur
ActionOverlay PDFs
Base PDF Input TypeBinary Data
Layer PDF Input TypeBinary Data
Base PDF Binary Fielddata
Layer PDF Binary Fielddata
Output File Nameoverlayed_output.pdf
Binary Data Output Namedata
Advanced OptionsNo properties
CredentialsPDF4me API credential

Questions fréquentes

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.

Actions connexes

Même tâche sur d'autres plateformes

Obtenez de l'aide