Preencha um PDF Formulário em n8n

O que este nó faz

PDF4mePreencha um PDF Forma requer um formulário preenchível PDF (AcroForm) e preenche seus campos com seus dados em um n8n Passo. Forneça o modelo como Binary Data, Base64, ou URL e valores de campo como um JSON objeto (JSON Cadeia de caracteres, binário ou Base64) ou como Linhas de Nome do Campo / Valor do CampoRetorna um arquivo preenchido. PDF, seja achatado (padrão) ou com os campos editáveis preservados. Ideal para preencher formulários de inscrição, contratos, fichas de cadastro ou qualquer outro documento. AcroForm modelo de CRM, webhook ou dados de planilha.

Artigos relacionados no blogue(1)

PDF preenchível mais JSON? O n8n preenche o formulário. Quatro nós, pronto!

Preencha formulários PDF com JSON no n8n: Baixe PDFs do Dropbox, PDF4me, preencha formulários PDF e faça upload. Preenchimento automático de formulários e faturamento sem código. Hospedagem própria ou na nuvem n8n. Tutorial passo a passo com imagens.

Ler publicação →

Autenticando seu API Solicitar

Todo PDF4me nó em n8n requer um válido Credencial para se conectar comCrie ou selecione um que contenha o seu PDF4me API chave para que o fluxo de trabalho possa autenticar solicitações de preenchimento de formulários com segurança.

Get your API Key

Fatos importantes que você não deve perder

O PDF já deve ter AcroForm campos

Este nó preenche campos de formulário existentes, não os cria. Uma varredura plana sem campos não pode ser preenchida. Use Adicionar Campos de Formulário para PDF Primeiro, se o seu modelo tiver apenas elementos visuais.

As chaves devem corresponder. AcroForm nomes de campos exatos

Os nomes dos campos diferenciam maiúsculas de minúsculas e geralmente diferem dos rótulos visíveis (primeiro nome em vez de Primeiro nomeExecutar Extrair Dados do Formulário de PDF Primeiro, preencha o modelo ou inspecione-o com o Adobe Acrobat Prepare Form para obter a lista exata.

Dados do formulário (JSON) espera um objeto, não uma lista

Enviar uma única JSON objeto ({"firstname":"John","lastname":"Doe"}Um array com um único objeto é desembrulhado; múltiplos objetos são rejeitados. Para preencher vários PDFEm uma única execução, envolva este nó em um Loop Over Items.

Painel de nós completo: PDF modelo via Binary Data + Linhas de campos de dados do formulário de entrada

Parâmetros

Requerido no n8n UI: Credencial para conectar-se com, PDF Tipo de dados de entrada, selecione o tipo de entrada e (dependendo do tipo de entrada selecionado) o tipo de entrada de dados do formulário com seu campo de conteúdo correspondente ou pelo menos uma linha de campos do formulário com o nome e o valor do campo. Nome do arquivo de saída (padrão). filled_form_output.pdf), Manter PDF Editável (desativado) e Binary Data Nome de saída (padrão) dados) são opcionais. Campos de modelo condicional (PDF Campo binário, PDF Base64 Contente, PDF URL) aparecem somente quando o tipo de entrada correspondente é selecionado.

Parâmetro	Obrigatório	O que faz	Exemplo
PDF Input Data Type	Yes	How 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 Field	Conditional	Name 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 Content	Conditional	Base64-encoded PDF content. Required when PDF Input Data Type is Base64 String. Data-URL prefixes (data:application/pdf;base64,) are stripped automatically.	JVBERi0xLjQK...
PDF URL	Conditional	Publicly 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 Type	Yes	How 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 Type	Conditional	How 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)	Conditional	Raw 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 Field	Conditional	Name 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 Content	Conditional	Base64-encoded UTF-8 JSON object. Required when Form Data Input Type is Base64 String. Decoded then stringified into dataArray.	eyJmaXJzdG5hbWUiOiJKb2huIn0=
Form Fields	Conditional	Collection 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)	Conditional	Exact AcroForm field name to fill. Required for every row added to Form Fields.	firstname
Field Value (per row)	Conditional	Value to fill into the matching AcroForm field. Required for every row added to Form Fields.	John
Output File Name	No	Filename of the filled PDF returned by the node. Default is filled_form_output.pdf. Include the .pdf extension.	filled_form_output.pdf
Keep PDF Editable	No	Toggle 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 Name	No	Name of the binary property the output item exposes. Default is data. Use a different name when a downstream node expects it.	data

PDF Opções de tipo de dados de entrada

Escolha como o PDF O modelo é inserido no nó. Os campos subsequentes mudam com essa escolha.

PDF Tipo de dados de entrada: Binary Data, Base64 Corda, ou URL

Dados bináriosPadrão: PDF do nó anterior

Lê o PDF diretamente de um nó anterior, como o Google Drive Download, HTTP Solicitar ou ler arquivo binário. Configurar Campo binário PDF para o nome do campo binário (padrão) dados).

String Base64PDF como uma string base64

Cole ou mapeie uma string base64 em Conteúdo Base64 do PDF. Dados-URL prefixos de estilo (dados:application/pdf;base64,) são removidos automaticamente.

URLBaixar a partir de um link público

Forneça um completo HTTPS URL em URL do PDF. PDF4me busca o modelo diretamente. O URL Deve ser válido e acessível sem autenticação.

Selecione as opções de tipo de entrada

Escolha como os valores dos campos serão fornecidos. Os campos subsequentes mudarão de acordo com essa escolha.

Selecione o tipo de entrada: JSON (para dataArray) ou Dados do Formulário de Entrada (UI linhas)

JSONIdeal para diversas áreas e dados dinâmicos.

Envia uma stringificada JSON objeto através do API matriz de dados campo. As chaves são PDF Os nomes dos campos e os valores são o que devem ser preenchidos. Adicione uma opção de Tipo de Entrada de Dados do Formulário subsequente (JSON Corda, Binary Data, ou Base64 String) para fornecer o objeto.

Dados do formulário de entradaIdeal para pequenos conjuntos fixos configurados em UI

Adicione uma linha por campo através de Adicionar campo de formulárioCada linha tem um Nome do campo (exato) AcroForm nome) e Valor do campoO nó gera um erro se a lista estiver vazia.

Opções de tipo de entrada de dados do formulário (quando Selecionar tipo de entrada for JSON)

Tipo de entrada de dados do formulário: JSON Corda, Binary Data, ou Base64 Corda

String JSONPadrão: colar ou mapear JSON em linha

Digite o objeto diretamente em Dados do formulário (JSON) ou mapeá-lo a partir de uma expressão de nó anterior. A escolha mais comum para CRMFluxos de trabalho orientados por webhook ou baseados em webhooks.

Dados bináriosJSON arquivo de um nó anterior

Definir Campo binário de dados do formulário para o nome do campo binário (padrão) dadosUse isso quando o JSON O arquivo é disponibilizado para download. O arquivo deve conter um único objeto.

String Base64Base64-codificado JSON objeto

Forneça o UTF-8 JSON objeto como base64 em Conteúdo do formulário Base64O nó decodifica e converte em string. matriz de dados.

Exemplo de dados de formulário (JSON)

Quando Form Data Input Type é JSON String, cole um único objeto cujas chaves sejam exatas AcroForm nomes de campos.

JSON Entrada de texto: um objeto, chaves correspondentes AcroForm nomes de campos exatos

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

Campos de saída

Uma corrida bem-sucedida retorna um n8n item carregando JSON metadados e o preenchido PDF.

Campo	Tipo	O que contém
success	Boolean	True when the PDF was filled successfully. Use to route error-handling branches.
message	String	Human-readable status confirming success or describing an error.
fileName	String	Filename of the filled PDF, set from Output File Name (default filled_form_output.pdf).
mimeType	String	MIME type of the filled file, application/pdf.
fileSize	Number	Size of the filled PDF in bytes.
inputMode	String	Which input mode was used: json or inputFormData.
fieldCount	Number	How many form fields were sent in this request.
Binary (data)	Binary	The filled PDF under Binary Data Output Name (default data). Pass into Write Binary File, Email, or any cloud-storage upload.

Configuração rápida

1. Adicionar PDF4me para o seu n8n Fluxo de trabalho. Configurar Recurso para Formulários e Operações de formulários para Preencha um PDF Forma.
2. Em Credencial para se conectar com, selecione o seu PDF4me credencial ou clique Criar nova credencial e cole o seu API chave.
3. Definir PDF Tipo de dados de entrada para Binary Data (padrão), Base64 Corda, ou URL e preencha o campo correspondente (Campo binário PDF, Conteúdo Base64 do PDF, ou URL do PDF).
4. Definir Selecione o tipo de entrada para JSON (então escolha Tipo de entrada de dados do formulário = JSON Corda / Binary Data / Base64 String e forneça o objeto) ou Dados do formulário de entrada (clique) Adicionar campo de formulário e adicione uma linha por campo com Nome do campo e Valor do campo).
5. Certifique-se de que todos Nome do campo combina com um AcroForm Insira o nome do campo exatamente como está no modelo (respeitando maiúsculas e minúsculas). Use a opção "Extrair dados do formulário". PDF Primeiro, se você não tiver certeza.
6. Opcionalmente, altere Nome do arquivo de saída do padrão filled_form_output.pdf.
7. Alternar Manter PDF Editável Ative esta opção somente se o destinatário precisar poder editar novamente os campos preenchidos. O padrão "desativado" torna o formulário plano.
8. Deixar Binary Data Nome de saída como data a menos que um nó subsequente precise de um nome de propriedade diferente. Execute o nó e direcione o valor preenchido. PDF Para gravar um arquivo binário, enviar um e-mail ou armazená-lo na nuvem.

Configurações típicas

Exemplos de fluxo de trabalhoCommon n8n workflow patterns using Fill a PDF Form.

Arquivo. Preencher. Salvar: PDF Modelo do Drive, valores embutidos

1. Um nó de download do Google Drive extrai o formulário de inscrição. PDF modelo (Binary Data, propriedade dados).
2. PDF4me Preencha um PDF O formulário funciona com PDF Tipo de dados de entrada Binary DataSelecione o tipo de entrada JSON, Tipo de entrada de dados do formulário JSON Corda. Dados do formulário (JSON) é um único objeto embutido.
3. Um nó "Write Binary File" salva o arquivo binário preenchido. PDF para uma pasta de rede usando $json.fileName.

Valores de um nó anterior mapeados com expressões

1. Um webhook recebe uma carga útil de envio de formulário de um site.
2. PDF4me Preencha um PDF O formulário está configurado com a opção Selecionar Tipo de Entrada. JSON, Tipo de entrada de dados do formulário JSON Corda. Dados do formulário (JSON) é um n8n expressão que mapeia a carga útil do webhook diretamente para o AcroForm forma de campo ({{ { firstname: $json.first, lastname: $json.last } }).
3. Um nó do Gmail envia por e-mail o arquivo preenchido. PDF Devolvido ao remetente como anexo.

Poucos campos, nenhum JSONLinhas de dados do formulário de entrada

1. Um formulário de admissão tem apenas três AcroForm campos: primeiro nome, sobrenome, e-mail.
2. PDF4me Preencha um PDF O formulário está configurado com o tipo de entrada "Selecionar" definido como "Dados do Formulário de Entrada". Três linhas foram adicionadas através de Adicionar campo de formulário com os nomes exatos dos campos e os valores digitados ou mapeados por expressão.
3. Manter PDF A opção "Editável" está desativada, portanto o formulário preenchido é achatado.
4. O PDF é carregado para um SharePoint biblioteca de documentos.

PDF e JSON como arquivos separados, mesclados em n8n

1. Um nó baixa o PDF modelo; outro nó baixa o JSON arquivo de dados. Um nó Merge os combina em um único item.
2. PDF4me Preencha um PDF O formulário está configurado com PDF Tipo de dados de entrada Binary Data (Campo binário PDF definido para o PDF nome do campo) e selecione o tipo de entrada JSON, Tipo de entrada de dados do formulário Binary Data (Campo binário de dados do formulário definido para o JSON nome do campo).
3. O preenchido PDF é salvo com o pedido ID como nome de arquivo.

Preenchimento editável PDF para que o destinatário complete

1. A CRM A atualização aciona o fluxo de trabalho quando um novo cliente é criado.
2. PDF4me Preencha um PDF O formulário preenche automaticamente os campos já conhecidos do cliente em um formulário de integração (nome, e-mail, id_da_conta) usando Selecionar Tipo de Entrada JSON.
3. Manter PDF Editável Está ativado para que o cliente possa preencher os campos opcionais restantes.
4. Um Outlook O nó envia por e-mail o formulário editável pré-preenchido. PDF com um lembrete de prazo.

Dicas práticas

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.

Folha de dicas

Campo	Valor
Resource	Forms
Operation	Fill a PDF Form
PDF Input Data Type	Binary Data
PDF Binary Field	data
Select Input Type	JSON
Form Data Input Type	JSON String
Form Data (JSON)	{"firstname":"John","lastname":"Doe","email":"[email protected]"}
Output File Name	filled_form_output.pdf
Keep PDF Editable	Off
Binary Data Output Name	data
Credentials	PDF4me API credential

Perguntas frequentes

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.

Ações relacionadas

Extrair dados de formulário de PDF

Ação complementar. Puxe exatamente AcroForm nomes de campos e valores atuais de qualquer campo preenchível PDF Antes de projetar seu preenchimento, PDF Carga útil do formulário.

Adicionar campos de formulário a PDF

Se o seu modelo tiver apenas espaços reservados visuais, adicione elementos reais. AcroForm Preencha os campos primeiro, então preencha um PDF O formulário precisa ser preenchido.

Gerar documento (único)

Se você tiver uma palavra, HTMLou modelo de formulário PDF com marcadores de posição (como bigodes ou campos de mesclagem) em vez de AcroForm Os campos são renderizados através do mecanismo de modelos.

Mesma tarefa em outras plataformas

Preencha um PDF Formulário em Make

Funcionamento semelhante ao de um módulo Make, com cenários visuais e gatilhos de armazenamento em nuvem conectados ao mesmo dataArray + AcroForm nomes de campos.

Preencha um PDF Formulário no Zapier

Acione o preenchimento de formulários a partir de qualquer um dos mais de 6.000 disponíveis. SaaS aplicativos e webhooks por meio de Zapier.

Preencha um PDF Formulário em Power Automate

Microsoft 365 flui com SharePoint, OutlookIntegrações com Teams e Dataverse.

Preencha um PDF Forma REST API

O bruto POST /api/v2/FillPdfForm endpoint, para código backend personalizado ou testes com o Postman.

Obtenha ajuda

n8n Integration Guiden8n SampleGetting Started