Passa al contenuto principale

Compila un PDF Forma in n8n

Cosa fa questo nodo

PDF4me: Compila un PDF Modulo prende un modulo compilabile PDF AcroForm) e popola i suoi campi con i tuoi dati in uno n8n passaggio. Fornire il modello come Binary Data, Base64, O URL e valori di campo come JSON oggetto JSON Stringa, binario o Base64) o come Righe Nome campo / Valore campo. Restituisce un completato PDF, sia appiattito (impostazione predefinita) che con campi modificabili preservati. Ideale per compilare domande, contratti, moduli di ammissione o qualsiasi altro AcroForm modello da CRM, webhook o dati di fogli di calcolo.

Articoli correlati del blog(1)

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 compilazione dei moduli.

Informazioni importanti da non perdere

IL PDF deve già avere AcroForm campi
Questo nodo riempie i campi del modulo esistenti, non li crea. Una scansione piatta senza campi non può essere riempita. Utilizzare Aggiungi campi modulo a PDF Innanzitutto, se il tuo modello contiene solo segnaposto visivi.
Le chiavi devono corrispondere AcroForm nomi dei campi esattamente
I nomi dei campi fanno distinzione tra maiuscole e minuscole e spesso differiscono dalle etichette visibili (nome di battesimo invece di Nome di battesimo). Esegui Estrai dati modulo da PDF Prima sul modello oppure controlla con Adobe Acrobat Prepara modulo per ottenere l'elenco esatto.
Dati del modulo (JSON) si aspetta un oggetto, non una lista
Invia un singolo JSON oggetto ({"nome":"John","cognome":"Doe"}). Un array con un oggetto viene spacchettato; gli oggetti multipli vengono rifiutati. Per riempire molti PDFin un'unica esecuzione, racchiudere questo nodo in un ciclo Loop Over Items.
Compila un modulo PDF n8n nodo configurato con Credenziali per connettersi con Pdf4me, Moduli risorse, Operazioni moduli Compila un modulo PDF, Tipo di dati di input PDF Dati binari, Dati del campo binario PDF, Seleziona tipo di input Dati del modulo di input, due campi modulo di esempio con Nome campo valore shakti e Nome campo Cognome valore Karmakar, più un pulsante Aggiungi campo modulo

Pannello completo dei nodi: PDF modello tramite Binary Data + Inserisci le righe del campo Dati del modulo

Parametri

Richiesto nel n8n UI: Credenziali per connettersi, PDF Tipo di dati di input, Seleziona tipo di input e (a seconda di Seleziona tipo di input) o Tipo di input dati modulo con il relativo campo di contenuto corrispondente, oppure almeno una riga Campi modulo con Nome campo e Valore campo. Nome file di output (predefinito) output_modulo_compilato.pdf), Mantenere PDF Modificabile (disattivato) e Binary Data Nome di output (predefinito) dati) sono facoltativi. I campi del modello condizionale (PDF Campo binario, PDF Base64 Contenuto, PDF URL) appaiono solo quando viene selezionato il loro tipo di input.

ParametroNecessarioCosa faEsempio
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 Opzioni del tipo di dati di input

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

Menu a tendina "Tipo di dati di input PDF" nel nodo "Compila un modulo PDF" di n8n PDF4me che mostra tre opzioni: Dati binari evidenziati con descrizione "Usa il file PDF dal nodo precedente", Stringa Base64 con descrizione "Fornisci il contenuto PDF come stringa codificata in base64", URL con descrizione "Fornisci l'URL del file PDF"

PDF Tipo di dati di input: Binary Data, Base64 Corda o URL

Dati binariPredefinito: PDF dal nodo precedente
Legge il PDF direttamente da un nodo precedente come Google Drive Download, HTTP Richiesta o lettura del file binario. Imposta Campo binario PDF al nome del campo binario (predefinito) dati).
Stringa Base64PDF come stringa base64
Incolla o mappa una stringa base64 in Contenuto PDF in formato Base64. Dati-URL prefissi di stile (dati:application/pdf;base64,) vengono rimossi automaticamente.
URLScarica da un link pubblico
Fornire un completo HTTPS URL In URL del PDF. PDF4me recupera direttamente il modello. Il URL deve essere valido e raggiungibile senza autenticazione.

Seleziona le opzioni del tipo di input

Scegli come vengono forniti i valori dei campi. I campi successivi cambieranno in base a questa scelta.

Seleziona il menu a tendina Tipo di input nel nodo Compila un modulo PDF di n8n PDF4me che mostra due opzioni: JSON con descrizione Invia i dati del modulo come oggetto JSON stringato in dataArray e Dati del modulo di input evidenziati con descrizione Invia i dati del modulo come un array di coppie nome campo valore

Seleziona il tipo di input: JSON (per dataArray) o Dati del modulo di input (UI righe)

JSONIdeale per molti settori e dati dinamici
Invia una stringa JSON oggetto tramite l' API array di dati campo. Le chiavi sono PDF I nomi dei campi e i valori sono ciò che bisogna compilare. Aggiungi una scelta di tipo di input dati modulo successiva (JSON Corda, Binary Data, O Base64 Stringa) per fornire l'oggetto.
Dati inseriti nel moduloIdeale per piccoli set fissi configurati nel UI
Aggiungi una riga per campo tramite Aggiungi campo modulo. Ogni riga ha una Nome del campo (esatto AcroForm nome) e Valore del campoIl nodo genera un errore se l'elenco è vuoto.

Opzioni del tipo di input dei dati del modulo (quando Seleziona tipo di input) JSON)

Menu a tendina Tipo di input dati modulo in n8n PDF4me Riempi un nodo Modulo PDF quando Seleziona tipo di input è JSON, mostrando tre opzioni: Stringa JSON evidenziata con descrizione Fornisci contenuto JSON come testo o oggetto, Dati binari con descrizione Usa file JSON dal nodo precedente, Stringa Base64 con descrizione Fornisci contenuto JSON come stringa codificata in base64

Tipo di immissione dati del modulo: JSON Corda, Binary Data, O Base64 Corda

Stringa JSONPredefinito: incolla o mappa JSON in linea
Digita l'oggetto direttamente in Dati del modulo (JSON) o mapparlo da un'espressione di nodo precedente. La scelta più comune per CRMflussi di lavoro basati su webhook o su processi guidati da webhook.
Dati binariJSON file da un nodo precedente
Impostato Campo binario dei dati del modulo al nome del campo binario (predefinito) dati). Usalo quando il JSON Il file viene scaricato. Il file deve contenere un singolo oggetto.
Stringa Base64Base64-codificato JSON oggetto
Fornire il UTF-8 JSON oggetto come base64 in Contenuto del modulo Data Base64Il nodo lo decodifica e lo converte in stringa array di dati.

Esempio di dati del modulo (JSON)

Quando Form Data Input Type È JSON Stringa, incolla un singolo oggetto le cui chiavi sono esatte AcroForm nomi dei campi.

Il tipo di input dei dati del modulo è impostato su stringa JSON con editor di dati del modulo (JSON) che mostra un singolo oggetto JSON inline firstname John lastname Doe email john at example dot com, seguito da nome del file di output filled_form_output.pdf

JSON Input stringa: un oggetto, le chiavi corrispondono AcroForm nomi dei campi esattamente

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

Campi di output

Una corsa di successo restituisce uno n8n trasporto dell'oggetto JSON metadati e il riempito PDF.

CampoTipoCosa contiene
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.

Configurazione rapida

  1. Aggiungere PDF4me al tuo n8n flusso di lavoro. Imposta Risorsa A Moduli E Operazioni sui moduli A Compila un PDF Modulo.
  2. In Credenziali per connettersi con, seleziona il tuo PDF4me credenziali o clicca Crea nuove credenziali e incolla il tuo API chiave.
  3. Impostato PDF Tipo di dati di input A Binary Data (predefinito), Base64 Corda, O URL e compilare il campo corrispondente (Campo binario PDF, Contenuto PDF in formato Base64, O URL del PDF).
  4. Impostato Seleziona il tipo di input A JSON (quindi scegli Tipo di input dati del modulo = JSON Corda / Binary Data / Base64 Stringa e fornisci l'oggetto) o Dati inseriti nel modulo (clicca) Aggiungi campo modulo e aggiungi una riga per campo con Nome del campo E Valore del campo).
  5. Assicurati che ogni Nome del campo corrisponde a AcroForm nome del campo nel modello esattamente (sensibile alle maiuscole). Usa Estrai dati del modulo da PDF prima se non sei sicuro.
  6. Modifica facoltativa Nome del file di output dall'impostazione predefinita filled_form_output.pdf.
  7. Attiva/disattiva Mantenere PDF Modificabile Attivare questa opzione solo se il destinatario deve essere in grado di modificare i campi compilati. L'impostazione predefinita è disattivata, in quanto il modulo viene visualizzato in modo appiattito.
  8. Partire Binary Data Nome dell'output COME data a meno che un nodo a valle non necessiti di un nome di proprietà diverso. Esegui il nodo e instrada il riempito PDF in Scrivi file binario, e-mail o archiviazione cloud.

Configurazioni tipiche

Esempi di flusso di lavoroCommon n8n workflow patterns using Fill a PDF Form.
File. Compila. Salva: PDF modello da Drive, valori in linea
  1. Un nodo di download di Google Drive recupera il modulo di domanda PDF modello (Binary Data, proprietà dati).
  2. PDF4me Compila un PDF Il modulo viene eseguito con PDF Tipo di dati di input Binary Data, Seleziona il tipo di input JSON, Tipo di input dati del modulo JSON Corda. Dati del modulo (JSON) è un singolo oggetto inline.
  3. Un nodo Scrivi file binario salva il file riempito PDF a una cartella di rete utilizzando $json.fileName.
Valori provenienti da un nodo precedente mappati con espressioni
  1. Un webhook riceve i dati inviati tramite un modulo da un sito web.
  2. PDF4me Compila un PDF Il modulo è configurato con Seleziona tipo di input JSON, Tipo di input dati del modulo JSON Corda. Dati del modulo (JSON) è un n8n espressione che mappa il payload del webhook direttamente nell' AcroForm forma del campo ({{ { firstname: $json.first, lastname: $json.last } }).
  3. Un nodo Gmail invia un'email al compilato PDF restituito al mittente come allegato.
Pochi campi, no JSON: Righe di dati del modulo di input
  1. Un modulo di ammissione ha solo tre AcroForm campi: nome di battesimo, cognome, e-mail.
  2. PDF4me Compila un PDF Il modulo è impostato con Seleziona tipo di input Dati del modulo di input. Vengono aggiunte tre righe tramite Aggiungi campo modulo con i nomi esatti dei campi e i valori digitati o mappati tramite espressioni.
  3. Mantenere PDF L'opzione "Modificabile" è disattivata, quindi il modulo compilato viene visualizzato in una visualizzazione piatta.
  4. IL PDF viene caricato su un SharePoint biblioteca di documenti.
PDF E JSON come file separati, uniti in n8n
  1. Un nodo scarica il PDF modello; un altro nodo scarica il JSON file di dati. Un nodo Merge li combina in un unico elemento.
  2. PDF4me Compila un PDF Il modulo è configurato con PDF Tipo di dati di input Binary Data Campo binario PDF impostato su PDF nome del campo) e Seleziona il tipo di input JSON, Tipo di input dati del modulo Binary Data Campo binario dei dati del modulo impostato su JSON nome del campo).
  3. Il riempito PDF viene salvato con l'ordine ID come nome file.
Compilabile modificabile PDF affinché il destinatario possa compilare
  1. UN CRM L'aggiornamento attiva il flusso di lavoro quando viene creato un nuovo cliente.
  2. PDF4me Compila un PDF Il modulo precompila i campi noti al cliente in un modulo di onboarding (nome, e-mail, ID account) utilizzando Seleziona tipo di input JSON.
  3. Mantenere PDF Modificabile è attivato in modo che il cliente possa compilare i restanti campi facoltativi.
  4. UN Outlook Il nodo invia via email il modulo modificabile precompilato PDF con un promemoria della scadenza.

Consigli pratici

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.

Foglio riassuntivo

CampoValore
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

Domande frequenti

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.

Azioni correlate

Stessa attività su altre piattaforme

Richiedi assistenza