←Gerar documento (único)

Voltar ao guia principal: todos os tipos de modelos, parâmetros de nós e campos de saída.

Formulário em PDF

O que este guia abrange

Este guia orienta você no preenchimento de um PDF Modelo AcroForm em n8n usando modelo.pdf e formdata.jsonMapa de chaves de dados diretamente para formar nomes de campos (primeiro nome, sobrenome, etc.). A saída é PDF apenas. Usar Manter PDF Editável Para deixar os campos editáveis após o preenchimento, ou desativá-los para simplificar o formulário.

Artigos relacionados no blogue

Ainda não há nenhuma publicação no blogue sobre esta funcionalidade — em breve.

Entretanto, explore o blogue da PDF4me para encontrar tutoriais e fluxos de trabalho para todas as plataformas.

Visite o blogue →

Antes de começar

PDF com campos AcroForm

A amostra modelo.pdf É um formulário de inscrição com quatro campos. JSON As chaves devem corresponder ao nome interno do AcroForm, não o rótulo visível na tela. Os nomes diferenciam maiúsculas de minúsculas.

Objeto de dados plano

Usar formdata.json (recomendado), test.xml, ou test.csvTodos os três fornecem os mesmos quatro valores. Os dados do formulário PDF são um objeto plano único, não aninhados como o HTML Exemplo de fatura.

PDF4me credencial em n8n

Criar um PDF4me credencial em n8n e cole o seu API chave. A mesma chave funciona em todos os PDF4me nós em sua instância.

→ Obtenha o seu API chave

:::nota Formulário PDF vs Preencher um Formulário PDF Gerar documento (único) com Formulário em PDF usa o mecanismo de geração de modelos com um PDF formulário como modelo. Para preencher qualquer formulário existente. PDF AcroForm sem o fluxo de trabalho de geração, veja Preencha um PDF FormaPara descobrir os nomes dos campos em um campo desconhecido. PDF, correr Extrair dados de formulário de PDF Primeiro, no modelo. :::

Pacote de Arquivos de Amostra

Faça o download dos quatro arquivos abaixo. Um deles. PDF Modelo de formulário mais três formatos de dados equivalentes.

modelo.pdf

PDF Modelo AcroForm (4 campos)

formdata.json

Plano JSON indexado por nome de campo (recomendado)

test.xml

Valores de formulário iguais a XML

test.csv

Valores de formulário iguais a CSV (uma linha)

O que há dentro dos arquivos de amostra?

Campos de formulário em template.pdf

O PDF de exemplo é simples. formulário de inscrição/cadastroCada nome de campo do AcroForm corresponde a uma chave nos seus dados:

Nome do campo AcroForm	Uso típico em modelos	Valor de amostra (formdata.json)
firstname	Nome dado	John
lastname	Nome de família	Adams
gender	Seleção de gênero	Fêmea
member	Nível de associação	Básico

:::dica Nomes de campos vs. rótulos visíveis Os nomes do AcroForm geralmente são em minúsculas e sem espaços (firstname), mesmo quando o PDF Exibe "Nome". Se um valor aparecer em branco, a chave em seu JSON Quase sempre não corresponde ao nome do campo interno. Use Extrair dados de formulário de PDF Para listar os nomes exatos do seu próprio modelo. :::

Mapeamento de campos em todos os arquivos de dados

AcroForm field	JSON key (formdata.json)	XML element (test.xml)	CSV column (test.csv)	Sample value
firstname	firstname	firstname	firstname	John
lastname	lastname	lastname	lastname	Adams
gender	gender	gender	gender	Female
member	member	member	member	Basic

Ao contrário do Word ou HTML modelos, existem Sem espaços reservados para bigodesO motor combina chaves de dados para nomes de campos AcroForm um para um.

Visão geral do fluxo de trabalho

Manual Trigger  →  Read Binary File (template.pdf)  →  PDF4me Generate Document (Single)  →  (optional) Write Binary File

Etapa	n8n nó	Propósito
1	Gatilho manual	Inicie o fluxo de trabalho sob demanda
2	Ler arquivo binário	Cargas template.pdf em propriedade binária data
3	PDF4me → Gerar documento (único)	Preenche os campos do AcroForm a partir de JSON/XML/CSV, saídas PDF
4	Escrever arquivo binário ou Enviar e-mail (opcional)	Salva ou envia generated_document_output.pdf

Definir Tipo de arquivo de modelo para Formulário em PDF. Tipo de saída é PDF Apenas para este tipo de modelo.

---

Passo 1: Baixe e coloque os arquivos de exemplo.

1. Download template.pdf e formdata.json do Pacote de Arquivos de Amostra acima.
2. Salvar template.pdf em algum lugar n8n É possível lê-lo (caminho local em servidores próprios ou armazenamento em nuvem para gatilhos de produção).
3. Opcionalmente, faça o download. test.xml ou test.csv para testar outros tipos de dados.

---

Passo 2: Crie o n8n Fluxo de trabalho

1. Em n8nCrie um novo fluxo de trabalho.
2. Adicionar um Gatilho manual nó.
3. Adicionar um Ler arquivo binário nó após o gatilho.
4. Adicionar PDF4me → Gerar documento (único) após ler o arquivo binário.
5. Conecte seu PDF4me credencial.

:::cuidado O código HTML não é válido aqui Tipo de entrada do arquivo de modelo: HTML Código só funciona quando Tipo de arquivo de modelo é HTMLPara formulário em PDF, use Dados binários, Base64 Corda, ou URL. :::

---

Passo 3: Carregar o modelo PDF (Read Binary File)

Campo	Valor
Caminho do arquivo	Caminho completo para o arquivo baixado. template.pdf
Nome da propriedade	data (padrão; usado como Propriedade binária do modelo em PDF4me)

Execute este nó uma vez e confirme se o item de saída mostra o valor binário. data com nome de arquivo template.pdf.

---

Etapa 4: Configurar PDF4me Gerar documento (único)

Configurações principais

Campo	Valor	Notas
Credencial para se conectar com	Seu PDF4me credencial	Pegar API chave
Recurso	Generate
Gerar operações	Gerar documento (único)
Tipo de arquivo de modelo	Formulário em PDF	PDF com campos AcroForm
Tipo de saída	PDF	Única opção para formulário em PDF

Entrada de modelo (de Ler arquivo binário)

Campo	Valor
Tipo de entrada de arquivo de modelo	Dados binários
Propriedade binária do modelo	data
Nome do arquivo de modelo	template.pdf

Dados do documento (cole o JSON de formdata.json)

Campo	Valor
Tipo de entrada de dados do documento	Texto
Tipo de dados do documento	JSON
Texto dos dados do documento	Cole o conteúdo completo de formdata.json (ver bloco abaixo)

{
  "firstname": "John",
  "lastname": "Adams",
  "gender": "Female",
  "member": "Basic"
}

Opções de saída

Campo	Valor	Quando usar
Manter PDF Editável	Sobre	O destinatário ainda deverá editar os campos no formulário preenchido. PDF
Manter PDF Editável	Desligado (padrão)	Transformar campos de formulário em conteúdo estático.
Nome da saída de dados binários	data (padrão)	Propriedade binária para a saída PDF

---

Etapa 5: Execute e verifique o PDF

1. Clique Executar fluxo de trabalho.
2. Abra o PDF4me Saída do nó. Em Binário, propriedade aberta data (generated_document_output.pdf).
3. Confirme se todos os quatro campos estão preenchidos:
   • primeiro nome → João
   • sobrenome → Adams
   • gênero → Feminino
   • membro → Básico

Se algum campo estiver vazio, compare o seu JSON chaves com os nomes AcroForm em template.pdf caractere por caractere.

---

Etapa 6: Salvar ou enviar a saída (opcional)

Escrever arquivo binário:

Campo	Valor
Nome do arquivo	filled-form-output.pdf
Nome da propriedade de dados	data
Caminho de saída	Pasta de destino no seu n8n hospedar

Enviar e-mail: Anexe o binário data de PDF4me como o PDF anexo.

---

Formatos de dados alternativos

Opção A: JSON arquivo como binário (formdata.json)

1. Adicionar Ler arquivo binário para formdata.json (use um Fusão nó se o modelo e os dados compartilharem o item de fluxo de trabalho).
2. Definir Tipo de entrada de dados do documento para Dados binários, Tipo de dados do documento para JSON, Propriedade binária do documento para o seu campo de dados, Nome do arquivo de dados do documento para formdata.json.

:::cuidado Conflito de nomes de propriedades binárias Se o modelo e os dados usarem a propriedade data, um sobrescreve o outro. Use nomes separados (por exemplo, template e formData) ou mesclar itens de dois nós de Leitura de Arquivo Binário. :::

Opção B: XML (test.xml)

Definir Tipo de dados do documento para XML e cole:

<?xml version="1.0" encoding="UTF-8"?>
<Person>
    <firstname>John</firstname>
    <lastname>Adams</lastname>
    <gender>Female</gender>
    <member>Basic</member>
</Person>

Os nomes dos elementos correspondem aos nomes dos campos do AcroForm e JSON chaves.

Opção C: CSV (test.csv)

Definir Tipo de dados do documento para CSV e colar (linha de cabeçalho + uma linha de dados):

firstname,lastname,gender,member
"John","Adams","Female","Basic"

Os cabeçalhos das colunas correspondem diretamente aos nomes dos campos do AcroForm.

---

Entrada de modelo alternativo: URL

Hospedar template.pdf em público HTTPS URL, então defina:

Campo	Valor
Tipo de entrada de arquivo de modelo	URL
URL do arquivo de modelo	Link público para template.pdf
Nome do arquivo de modelo	template.pdf

Não é necessário nenhum nó de leitura de arquivo binário. Os dados ainda podem ser colados como Texto dos dados do documento ou carregado de um URL.

---

Padrões de fluxo de trabalho de produção

Formas comuns de preencher formulários PDF em produçãoOnce the sample test works, replace the Manual Trigger with these patterns.

Envio de formulário via webhook

1. O webhook recebe a carga útil de registro.
2. Mapear campos do corpo para JSON Chaves que correspondem a nomes AcroForm.
3. PDF4me preenche fixo modelo.pdf de binário ou URL.
4. Envie por e-mail ou armazene o formulário preenchido. PDF.

Linha do Google Sheets para PDF

1. As planilhas são acionadas na criação de uma nova linha.
2. Definir ou Código compilações de nós {"primeiro nome": "...", ...}.
3. PDF4me Gerar documento (único) com modelo de formulário PDF.
4. Faça upload da saída para o Drive ou SharePoint.

CRM contato com a associação PDF

1. Acionador do HubSpot/Salesforce para novo contato.
2. Mapa CRM propriedades para primeiro nome, sobrenome, etc.
3. Definir Manter PDF Editável Vou alisar antes de arquivar.

Perguntas frequentes

How is Pdf Form different from Fill a PDF Form?+

Generate Document (Single) with Pdf Form is part of the generate template workflow (same node as Word and HTML). Fill a PDF Form is a dedicated Forms operation for any PDF with AcroForm fields. Both map keys to field names; choose Generate when Pdf Form is your Template File Type in a generate pipeline.

Why are some fields blank in the output?+

JSON keys must match AcroForm field names exactly, including case. firstname works; FirstName or first_name usually does not. Run Extract Form Data From PDF on template.pdf to list internal names before mapping CRM or webhook data.

Should I turn Keep PDF Editable on or off?+

On: fields remain editable (useful for review workflows). Off: fields are flattened into static text (better for final archival or when recipients should not change values). Default is Off.

Can Pdf Form output Word or HTML?+

No. When Template File Type is Pdf Form, Output Type is PDF only.

JSON vs XML vs CSV: which should I use?+

JSON is simplest for n8n expressions and webhooks. XML and CSV in the sample pack use the same four keys. All formats map one value per AcroForm field name.

Guias relacionados

• Visão geral da geração de documento (único): todos os parâmetros, campos de saída e tipos de modelo
• Preencha um PDF FormaPreenchimento dedicado de AcroForm sem o mecanismo de geração de modelos
• Extrair dados de formulário de PDF: listar nomes de campos de qualquer PDF forma

Back to overviewFill a PDF Form