Aller au contenu principal

Remplissez un PDF Forme dans n8n

Que fait ce nœud ?

PDF4me: Remplissez un PDF Formulaire prend un remplissable PDF (AcroForm) et remplit ses champs avec vos données en une seule fois n8n étape. Fournissez le modèle comme Binary Data, Base64, ou URL et les valeurs des champs comme un JSON objet (JSON Chaîne, binaire ou Base64) ou comme lignes Nom du champ / Valeur du champRenvoie un résultat complet PDF, soit aplatie (par défaut), soit avec les champs modifiables conservés. Idéal pour remplir des demandes, des contrats, des formulaires d'admission ou tout autre document. AcroForm modèle à partir de CRM, webhook ou données de feuille de calcul.

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 en toute sécurité les demandes de remplissage de formulaires.

Informations importantes à ne pas manquer

Le PDF doit déjà avoir AcroForm champs
Ce nœud remplit les champs de formulaire existants, il ne les crée pas. Un formulaire vierge, sans aucun champ, ne peut pas être rempli. Utilisez « Ajouter des champs de formulaire à ». PDF Premièrement, si votre modèle ne contient que des espaces réservés visuels.
Les clés doivent correspondre AcroForm noms de champs exactement
Les noms de champs sont sensibles à la casse et diffèrent souvent des étiquettes visibles (prénom au lieu de Prénom). Exécuter Extraire les données du formulaire à partir de PDF Consultez d'abord le modèle ou inspectez-le avec Adobe Acrobat Prepare Form pour obtenir la liste exacte.
Données du formulaire (JSONattend un objet, pas une liste
Envoyer un seul JSON objet ({"prénom":"John","nom":"Doe"}Un tableau contenant un seul objet est déballé ; les objets multiples sont rejetés. Pour remplir plusieurs tableaux, il faut en ajouter. PDFDans une seule exécution, enveloppez ce nœud dans une boucle sur les éléments.
Remplir un formulaire PDF : nœud n8n configuré avec des identifiants pour se connecter à Pdf4me, Formulaires de ressources, Opérations sur les formulaires, Remplir un formulaire PDF, Type de données d'entrée PDF : Données binaires, Données de champ binaires PDF, Sélectionner le type d'entrée : Données de formulaire d'entrée, deux exemples de champs de formulaire : « Prénom » avec la valeur « shakti » et « Nom » avec la valeur « Karmakar », ainsi qu'un bouton « Ajouter un champ de formulaire ».

Panneau de nœud complet : PDF modèle via Binary Data + Lignes du champ de données du formulaire de saisie

Paramètres

Requis dans le n8n UI: Identifiant pour se connecter, PDF Type de données d'entrée, sélectionnez le type d'entrée et (selon le type d'entrée sélectionné) soit le type d'entrée de données de formulaire avec son champ de contenu correspondant, soit au moins une ligne de champs de formulaire avec le nom et la valeur du champ. Nom du fichier de sortie (par défaut) Résultat du formulaire rempli.pdf), Garder PDF Modifiable (désactivé), et Binary Data Nom de la sortie (par défaut) données) sont facultatifs. Les champs de modèle conditionnels (PDF Champ binaire, PDF Base64 Contenu, PDF URL) n'apparaissent que lorsque leur type d'entrée est sélectionné.

ParamètreRequisCe que cela faitExemple
PDF Input Data TypeYesHow the PDF template enters the node. Binary Data reads from a previous node (default, most common). Base64 String accepts an encoded PDF. URL downloads the PDF from a public link.Binary Data
PDF Binary FieldConditionalName of the binary property on the incoming n8n item that holds the PDF. Required when PDF Input Data Type is Binary Data. Defaults to data.data
PDF Base64 ContentConditionalBase64-encoded PDF content. Required when PDF Input Data Type is Base64 String. Data-URL prefixes (data:application/pdf;base64,) are stripped automatically.JVBERi0xLjQK...
PDF URLConditionalPublicly reachable HTTPS URL to the PDF template. Required when PDF Input Data Type is URL. Must be a valid full URL format.https://example.com/application-form.pdf
Select Input TypeYesHow the field values are supplied. JSON sends a stringified JSON object via dataArray. Input Form Data adds one UI row per field with Field Name and Field Value.JSON
Form Data Input TypeConditionalHow the JSON object is supplied. Required when Select Input Type is JSON. JSON String pastes the object directly (default). Binary Data reads a JSON file from a previous node. Base64 String accepts an encoded JSON object.JSON String
Form Data (JSON)ConditionalRaw JSON object whose keys are PDF field names and values are what to fill. Required when Form Data Input Type is JSON String. Must be a single object, not a list.{"firstname":"John","lastname":"Doe","email":"[email protected]"}
Form Data Binary FieldConditionalName of the binary property on the incoming n8n item that holds the JSON data file. Required when Form Data Input Type is Binary Data. Defaults to data.data
Form Data Base64 ContentConditionalBase64-encoded UTF-8 JSON object. Required when Form Data Input Type is Base64 String. Decoded then stringified into dataArray.eyJmaXJzdG5hbWUiOiJKb2huIn0=
Form FieldsConditionalCollection of field rows. Required when Select Input Type is Input Form Data. Add at least one row via Add Form Field. The node errors if the list is empty.[{Field Name: firstname, Field Value: John}]
Field Name (per row)ConditionalExact AcroForm field name to fill. Required for every row added to Form Fields.firstname
Field Value (per row)ConditionalValue to fill into the matching AcroForm field. Required for every row added to Form Fields.John
Output File NameNoFilename of the filled PDF returned by the node. Default is filled_form_output.pdf. Include the .pdf extension.filled_form_output.pdf
Keep PDF EditableNoToggle to keep AcroForm fields editable on the filled PDF. Off (default) flattens the form into static text. On preserves field definitions so the recipient can re-edit.Off
Binary Data Output NameNoName of the binary property the output item exposes. Default is data. Use a different name when a downstream node expects it.data

PDF Options de type de données d'entrée

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

Menu déroulant « Type de données d'entrée PDF » dans le nœud « Remplir un formulaire PDF » de n8n PDF4me : trois options sont proposées : « Données binaires » (avec la description « Utiliser le fichier PDF du nœud précédent »), « Chaîne Base64 » (avec la description « Fournir le contenu du PDF sous forme de chaîne encodée en base64 ») et « URL » (avec la description « Fournir l'URL du fichier PDF »).

PDF Type de données d'entrée : Binary Data, Base64 Chaîne, ou URL

Données binairesDéfaut: PDF à partir du nœud précédent
Lit le PDF directement à partir d'un nœud précédent tel que le téléchargement Google Drive, HTTP Demander ou lire un fichier binaire. Définir Champ binaire PDF au nom du champ binaire (par défaut) données).
Chaîne Base64PDF sous forme de chaîne de caractères en base64
Collez ou mappez une chaîne base64 dans Contenu PDF Base64. Données-URL préfixes de style (données:application/pdf;base64,) sont automatiquement supprimés.
URLTélécharger à partir d'un lien public
Fournir un complet HTTPS URL dans URL du PDF. PDF4me récupère directement le modèle. URL doit être valide et accessible sans authentification.

Options de sélection du type d'entrée

Choisissez le mode de saisie des valeurs des champs. Les champs suivants seront modifiés en fonction de ce choix.

Sélectionnez le menu déroulant Type d'entrée dans n8n PDF4me. Le nœud Remplir un formulaire PDF affiche deux options : JSON (avec la description « Envoyer les données du formulaire sous forme d'objet JSON sérialisé dans dataArray ») et Données du formulaire (avec la description « Envoyer les données du formulaire sous forme de tableau de paires nom de champ/valeur »).

Sélectionnez le type d'entrée : JSON (pour dataArray) ou données de formulaire d'entrée (UI lignes)

JSONIdéal pour de nombreux domaines et les données dynamiques
Envoie une chaîne de caractères JSON l'objet via le API tableau de données champ. Les clés sont PDF Les noms et valeurs des champs sont ce qu'il faut renseigner. Ajoutez un choix de type de saisie de données de formulaire de suivi (JSON Chaîne, Binary Data, ou Base64 Chaîne de caractères) pour fournir l'objet.
Données du formulaire de saisieIdéal pour les petits ensembles fixes configurés dans le UI
Ajouter une ligne par champ via Ajouter un champ de formulaireChaque ligne a un Nom du champ (exact AcroForm nom) et Valeur du champLe nœud génère une erreur si la liste est vide.

Options du type de saisie des données du formulaire (lorsque Sélectionner le type de saisie est JSON)

Dans le nœud « Remplir un formulaire PDF » de n8n PDF4me, lorsque le type d'entrée sélectionné est JSON, trois options s'affichent : « Chaîne JSON » (avec la description « Fournir le contenu JSON sous forme de texte ou d'objet »), « Données binaires » (avec la description « Utiliser le fichier JSON du nœud précédent ») et « Chaîne Base64 » (avec la description « Fournir le contenu JSON sous forme de chaîne encodée en base64 »).

Type de saisie de données de formulaire : JSON Chaîne, Binary Data, ou Base64 Chaîne

Chaîne JSONPar défaut : coller ou carte JSON en ligne
Saisissez l'objet directement dans Données du formulaire (JSON) ou le mapper à partir d'une expression de nœud précédente. Le choix le plus courant pour CRM-flux de travail pilotés par des webhooks ou des webhooks.
Données binairesJSON fichier provenant d'un nœud précédent
Ensemble Champ binaire de données de formulaire au nom du champ binaire (par défaut) donnéesUtilisez ceci lorsque le JSON Il arrive sous forme de fichier téléchargé. Ce fichier doit contenir un seul objet.
Chaîne Base64Base64-encodé JSON objet
Fournir le UTF-8 JSON objet au format base64 dans Contenu de la base de données du formulaire 64Le nœud le décode et le convertit en chaîne de caractères. tableau de données.

Exemple de données de formulaire (JSON)

Quand Form Data Input Type est JSON Chaîne, collez un seul objet dont les clés sont exactes AcroForm noms de champs.

Type de saisie des données du formulaire défini sur Chaîne JSON avec l'éditeur de données de formulaire (JSON) affichant un seul objet JSON intégré : prénom John, nom Doe, email john@example.com, suivi du nom du fichier de sortie filled_form_output.pdf

JSON Entrée de type chaîne : un objet, les clés correspondent AcroForm noms de champs exactement

{
"firstname": "John",
"lastname": "Doe",
"email": "[email protected]"
}

Champs de sortie

Une course réussie rapporte un n8n transport d'objets JSON métadonnées et les champs remplis PDF.

ChampTaperCe qu'il contient
successBooleanTrue when the PDF was filled successfully. Use to route error-handling branches.
messageStringHuman-readable status confirming success or describing an error.
fileNameStringFilename of the filled PDF, set from Output File Name (default filled_form_output.pdf).
mimeTypeStringMIME type of the filled file, application/pdf.
fileSizeNumberSize of the filled PDF in bytes.
inputModeStringWhich input mode was used: json or inputFormData.
fieldCountNumberHow many form fields were sent in this request.
Binary (data)BinaryThe filled PDF under Binary Data Output Name (default data). Pass into Write Binary File, Email, or any cloud-storage upload.

Configuration rapide

  1. Ajouter PDF4me à votre n8n Flux de travail. Définir Ressource à Formulaires et Opérations de formulaires à Remplissez un PDF Formulaire.
  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 PDF Type de données d'entrée à Binary Data (défaut), Base64 Chaîne, ou URL et remplissez le champ correspondant (Champ binaire PDF, Contenu PDF Base64, ou URL du PDF).
  4. Ensemble Sélectionnez le type d'entrée à JSON (puis choisissez Type de saisie de données de formulaire = JSON Chaîne / Binary Data / Base64 Chaîne et fournir l'objet) ou Données du formulaire de saisie (cliquer) Ajouter un champ de formulaire et ajoutez une ligne par champ avec Nom du champ et Valeur du champ).
  5. Assurez-vous que chaque Nom du champ correspond à un AcroForm Nom du champ dans le modèle, exactement (sensible à la casse). Utiliser Extraire les données du formulaire. PDF d'abord, si vous n'êtes pas sûr.
  6. Modifier (facultatif) Nom du fichier de sortie par défaut filled_form_output.pdf.
  7. Basculer Garder PDF Modifiable Activer cette option uniquement si le destinataire doit pouvoir modifier les champs remplis. Désactivée par défaut, elle simplifie le formulaire.
  8. Partir Binary Data Nom de sortie comme data sauf si un nœud en aval a besoin d'un nom de propriété différent. Exécutez le nœud et acheminez les données remplies. PDF dans un fichier binaire, par e-mail ou dans un espace de stockage cloud.

Configurations typiques

Exemples de flux de travailCommon n8n workflow patterns using Fill a PDF Form.
Fichier. Remplir. Enregistrer : PDF Modèle provenant de Drive, valeurs intégrées
  1. Un nœud de téléchargement Google Drive récupère le formulaire de candidature PDF modèle (Binary Data, propriété données).
  2. PDF4me Remplissez un PDF Le formulaire fonctionne avec PDF Type de données d'entrée Binary Data, Sélectionnez le type d'entrée JSON, Type de saisie de données de formulaire JSON Chaîne. Données du formulaire (JSON) est un seul objet en ligne.
  3. Un nœud « Écrire un fichier binaire » enregistre le fichier rempli. PDF vers un dossier réseau en utilisant $json.nom_de_fichier.
Valeurs d'un nœud précédent mappées avec des expressions
  1. Un webhook reçoit les données de soumission d'un formulaire depuis un site web.
  2. PDF4me Remplissez un PDF Le formulaire est configuré avec le type d'entrée Select. JSON, Type de saisie de données de formulaire JSON Chaîne. Données du formulaire (JSON) est un n8n expression qui mappe directement la charge utile du webhook dans le AcroForm forme du champ ({{ { prénom: $json.first, nom: $json.last } }).
  3. Un nœud Gmail envoie par e-mail les données remplies. PDF renvoyé à l'expéditeur en pièce jointe.
Peu de champs, pas JSON: Lignes de données du formulaire de saisie
  1. Un formulaire d'admission ne comporte que trois AcroForm champs : prénom, nom de famille, e-mail.
  2. PDF4me Remplissez un PDF Le formulaire est configuré avec le type de saisie « Sélectionnez les données du formulaire ». Trois lignes sont ajoutées via Ajouter un champ de formulaire avec les noms de champs exacts et les valeurs saisies ou mappées par expression.
  3. Garder PDF L'option « Modifiable » est désactivée, le formulaire rempli est donc aplati.
  4. Le PDF est téléchargé sur un SharePoint bibliothèque de documents.
PDF et JSON en fichiers séparés, fusionnés dans n8n
  1. Un nœud télécharge le PDF modèle ; un autre nœud télécharge le JSON fichier de données. Un nœud Fusionner les combine en un seul élément.
  2. PDF4me Remplissez un PDF Le formulaire est configuré avec PDF Type de données d'entrée Binary Data (Champ binaire PDF réglé sur le PDF nom du champ) et sélectionnez le type de saisie JSON, Type de saisie de données de formulaire Binary Data (Champ binaire de données de formulaire réglé sur le JSON nom du champ).
  3. Le rempli PDF est sauvegardé avec la commande ID comme nom de fichier.
Modifiable rempli PDF pour qu'un destinataire remplisse
  1. UN CRM La mise à jour déclenche le flux de travail lors de la création d'un nouveau client.
  2. PDF4me Remplissez un PDF Le formulaire pré-remplit les champs connus du client sur un formulaire d'intégration (nom, e-mail, identifiant_compte) en utilisant le type de saisie Select JSON.
  3. Garder PDF Modifiable Cette option est activée afin que le client puisse remplir les champs facultatifs restants.
  4. Un Outlook Les e-mails du nœud contiennent les champs préremplis modifiables PDF avec un rappel de date limite.

Conseils pratiques

Wrong field names are the #1 cause of empty output
Run Extract Form Data From PDF on the template first to get the exact list. Names are case-sensitive and usually have no spaces (firstname, not First Name).
"No binary data found" errors
Double-check PDF Binary Field and Form Data Binary Field names. The Merge node in a fan-in workflow can rename binary properties.
Prefer JSON for many or dynamic fields
Input Form Data is great for 2-3 hardcoded fields, but JSON scales better and works naturally with expressions from previous nodes.
Keep PDF Editable only when needed
Default off flattens the form, which is the right choice when the filled PDF is a final record. Turn on only when the recipient needs to add or change values.
Form Data (JSON) is one object only
Send a single object, not an array of records. An array of one is unwrapped; multiple objects fail. To fill many PDFs in one run, wrap this node in Loop Over Items.
No AcroForm fields means nothing to fill
A flat scan with no fields cannot be filled. Use Add Form Fields To PDF first to add fillable fields before calling Fill a PDF Form.

Aide-mémoire

ChampValeur
ResourceForms
OperationFill a PDF Form
PDF Input Data TypeBinary Data
PDF Binary Fielddata
Select Input TypeJSON
Form Data Input TypeJSON String
Form Data (JSON){"firstname":"John","lastname":"Doe","email":"[email protected]"}
Output File Namefilled_form_output.pdf
Keep PDF EditableOff
Binary Data Output Namedata
CredentialsPDF4me API credential

Foire aux questions

What is the difference between JSON and Input Form Data?+
JSON sends one stringified object via the API dataArray field. Keys are PDF field names and values are what to fill. Best for many fields, dynamic data mapped from previous nodes, or workflows that already produce JSON. Input Form Data adds one UI row per field with Field Name and Field Value. Best for a small fixed set of fields configured manually in the n8n editor.
How do I know the exact AcroForm field names?+
Run PDF4me Extract Form Data From PDF on the template first. The output is the exact list of field names you can use as keys in Form Data (JSON) or as Field Name rows in Input Form Data. Or inspect the PDF in Adobe Acrobat (Prepare Form) and read the field names from the properties panel. Field names are case-sensitive.
What does Keep PDF Editable do?+
Off (default) flattens the form into static text in the output PDF. Useful when the filled PDF is a final, locked record of what was submitted. On preserves AcroForm field definitions in the output so the recipient can re-edit values in any PDF viewer. Turn it on only when the recipient needs to add or change values after automation.
Can I send an array of multiple objects in Form Data (JSON)?+
No. The node expects a single object. An array containing one object is unwrapped automatically as a convenience. Arrays of multiple objects are rejected. To fill many PDFs in one execution, wrap this node in a Loop Over Items and call it once per object.
Why are some fields blank in the output PDF?+
Almost always because the keys you sent did not match the AcroForm field names exactly. Field names are case-sensitive and often have no spaces or capital letters (firstname instead of First Name). Confirm the exact names with Extract Form Data From PDF before mapping your data.
What happens with a flat PDF that has no form fields?+
Nothing fills. This node populates existing AcroForm fields; it does not create them. For a flat scan or a PDF with visual placeholders only, run Add Form Fields To PDF first to add fillable fields, then call Fill a PDF Form.
How do I send the PDF as base64 with a data: prefix?+
The node strips data-URL prefixes (data:application/pdf;base64,) automatically when you paste them into PDF Base64 Content, so it works either way.
Can I get a non-PDF output (e.g. PNG of the filled form)?+
No. This endpoint outputs PDF only. To rasterize the filled PDF into PNG or JPEG, chain a downstream PDF4me Convert PDF to Image action after Fill a PDF Form.

Actions connexes

Même tâche sur d'autres plateformes

Obtenez de l'aide