Gerar documentos (múltiplos) em n8n

Gerar vários documentos é uma ação do nó PDF4me no n8n, exibida no nó como Gerar Documentos (Múltiplos), que renderiza vários arquivos finalizados em uma única execução a partir de um único modelo e uma matriz de registros. Use-a para um lote de faturas, cartas para clientes ou relatórios por região, com cada documento retornado como um item n8n individual.

O que este nó faz

PDF4meGerar documentos (múltiplos) Utiliza um modelo e uma lista de registros e produz vários documentos finalizados em um único documento. n8n executar. Fornecer um Palavra, HTML, ou PDF modelo via Dados Binários, Base64, HTML código, ou URL mais dados em massa como JSON ou XML (matriz de registros ou repetição) XMLCada arquivo gerado retorna como um item de saída separado, permitindo que você os reproduza em loop, salve, envie por e-mail ou faça upload individualmente. Use este nó em vez de Gerar documento (único) Sempre que você tiver uma lista de clientes, faturas ou registros e desejar um documento finalizado por linha em uma única execução.

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 →

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 geração de documentos em lote de forma segura.

Get your API Key

Fatos importantes que você não deve perder

Um n8n item por documento gerado

Uma execução bem-sucedida geralmente retorna vários itens, um para cada arquivo gerado. Cada item contém o arquivo binário em Nome de Saída de Dados Binários e JSON Metadados com documentIndex e totalDocuments permitem que você faça um loop, salve ou envie cada arquivo individualmente por e-mail posteriormente.

Passe um array (JSON) ou repetindo XML então o API sabe quantos arquivos renderizar

Para JSONUtilize um array de objetos, um para cada documento gerado. Para XML, utilize uma estrutura de registro repetido que o modelo espera (estilo mala direta). Objetos únicos produzem um único documento, o que anula o propósito desta operação.

CSVAs funcionalidades de Mala Direta e Google Docs não estão disponíveis aqui.

O tipo de arquivo de modelo oferece apenas o formato Word. HTML, PDFO tipo de dados Documento oferece apenas JSON ou XMLSe você precisar CSV Para inserir dados ou usar modelos de Mala Direta/Google Docs, utilize a opção Gerar Documento (Único).

Painel de nós completo. Modelo do Word + JSON Dados de texto + PDF O resultado é a configuração típica de mala direta.

Gerar documentos (múltiplos) vs Gerar documento (único)

Escolher a opção errada é o erro mais comum nesta tarefa. A escolha depende da quantidade de arquivos retornados e dos formatos de modelo e dados disponíveis.

Aspecto	Gerar documentos (múltiplos)	Gerar documento (único)
Files returned	Many, one n8n item per generated document	Exactly one
Template types	Word, HTML, PDF	Word, HTML, PDF, plus Mail Merge and Google Docs
Data formats	JSON or XML only	JSON, XML, and CSV
Output types	PDF, Word, or Excel (HTML templates output HTML)	PDF, Word (no Excel option)
Reach for it when	You have a list of records and want one document per row	You have a single record, CSV data, or a Mail Merge template

Quais parâmetros são necessários para gerar documentos (múltiplos)?

Requerido no n8n Interface do usuário: Credencial de conexão, Tipo de Arquivo de Modelo, Tipo de Entrada do Arquivo de Modelo, Tipo de Dados do Documento, Tipo de Entrada de Dados do Documento e Tipo de Saída (sempre exibidos; as opções dependem do Tipo de Arquivo de Modelo). Campos obrigatórios condicionais (Propriedade Binária do Modelo, Modelo) Base64 Contente, HTML Código, Arquivo de Modelo URLOs campos (Texto de Dados do Documento, Propriedade Binária do Documento, etc.) aparecem somente quando o tipo de entrada pai é selecionado. Nome do Arquivo de Saída, Manter PDF Os campos "Editável" e "Nome de saída de dados binários" são opcionais e possuem valores padrão adequados.

Parâmetro	Obrigatório	O que faz	Exemplo
Template File Type	Required	Format of the template the node will render. Word for .docx templates, HTML for HTML templates (including pasted code), PDF for PDF templates. There is no Mail Merge, Google Docs, or PDF form option here; use Generate Document (Single) for those.	Word
Output Type	Required	Format of every generated document. Word and PDF templates accept PDF, Word, or Excel. HTML templates accept HTML only. Default is PDF when available.	PDF
Template File Input Type	Required	How the template is supplied. Binary Data reads from a previous node (most common). Base64 String accepts an encoded template. HTML Code accepts pasted raw HTML (only valid when Template File Type is HTML). URL downloads the template from a public link.	Binary Data
Template Binary Property	Conditional	Name of the binary property on the incoming n8n item that holds the template. Required when Template File Input Type is Binary Data. Defaults to data.	data
Template Base64 Content	Conditional	Base64-encoded template content. Required when Template File Input Type is Base64 String.	UEsDBBQAAAAI...
HTML Code	Conditional	Raw HTML body (mustache placeholders such as {{title}} are supported). Required when Template File Input Type is HTML Code, which is only valid for Template File Type HTML. The node wraps the snippet in a basic <html> shell if missing.	<h1>{{title}}</h1>
Template File URL	Conditional	Publicly reachable HTTPS URL to the template file. Required when Template File Input Type is URL.	https://example.com/template.docx
Template File Name	Conditional	Filename of the template. Optional with Binary Data (falls back to the uploaded filename or a sensible default such as template.docx, template.html, template.pdf). Required for Base64 String, HTML Code, and URL.	template.docx
Document Data Type	Required	Format of the bulk records you are sending. JSON for arrays of objects (most common). XML for repeating-record XML. CSV is not available on this operation.	JSON
Document Data Input Type	Required	How the bulk data is supplied. Text is the default (paste JSON or XML directly). Binary Data reads from a previous node. Base64 String accepts an encoded data file. URL downloads the data file from a public link.	Text
Document Data Text	Conditional	Raw bulk JSON or XML payload. Required when Document Data Input Type is Text. The node validates that JSON parses; XML is sent as-is. Use an array of objects in JSON so the API renders many files.	[{"name":"Alice"},{"name":"Bob"}]
Document Binary Property	Conditional	Name of the binary property on the incoming n8n item that holds the data file. Required when Document Data Input Type is Binary Data. Defaults to data.	data
Document Data File Name	Conditional	Filename for the bulk data file. Optional with Binary Data (falls back to data.json). Required when Document Data Input Type is Base64 String or URL.	customers.json
Document Base64 Content	Conditional	Base64-encoded data file. Required when Document Data Input Type is Base64 String.	W3sibmFtZSI6...
Document Data File URL	Conditional	Publicly reachable HTTPS URL to the bulk data file. Required when Document Data Input Type is URL.	https://example.com/customers.json
Output File Name	Optional	Prefix for the generated filenames. The node appends _1, _2, ... and the correct extension. Example: invoice becomes invoice_1.pdf, invoice_2.pdf. Leave blank to use API-provided names or generated_document_1, generated_document_2, ...	invoice
Keep PDF Editable	Optional	Only shown when Output Type is PDF. Keeps AcroForm fields editable on every generated PDF when enabled. Default is off (flattened output).	Off
Binary Data Output Name	Optional	Name of the binary property each output item exposes. Default is data. Placeholder suggests generated-documents.	data

Opções de tipo de arquivo de modelo

Escolha o formato do modelo. As opções de Tipo de Saída mudam com essa seleção.

Menu suspenso Tipo de arquivo de modelo. Word, HTML, ou PDF (Sem mala direta ou Google Docs aqui)

PalavraPadrão: modelos .docx

Padrão PDF4me Modelo do Word com marcadores de posição em forma de bigode. O tipo de saída pode ser PDFWord ou Excel. A opção mais comum para faturas em lote, cartas para clientes e relatórios personalizados.

HTMLHTML modelos e colados HTML código

Renderizações HTML Modelos com marcadores de posição para bigodes. O tipo de saída é HTML Somente. Combine com o tipo de entrada de arquivo de modelo. HTML Código para colar o texto bruto HTML embutido ou use Dados Binários / URL para um arquivo .html hospedado.

PDFPDF modelos

Utilize um existente PDF como modelo. O tipo de saída pode ser PDFWord ou Excel. Para PDF saída, habilite Manter PDF Editável, caso deseje que os campos sejam editáveis em todos os arquivos gerados.

Tipo de saída por modelo

Tipo de arquivo de modelo	Opções de tipo de saída	Padrão
Word	PDF, Word, Excel	PDF
PDF	PDF, Word, Excel	PDF
HTML	HTML only	HTML

Opções de tipo de entrada do arquivo de modelo

Escolha como o modelo será inserido no nó. Os campos subsequentes serão alterados de acordo com essa escolha.

Tipo de entrada do arquivo de modelo: Dados binários. Base64 Corda, HTML Código, ou URL

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

Lê o modelo diretamente de um nó anterior, como o Google Drive Download. HTTP Solicitar ou ler arquivo binário. Configurar Propriedade binária do modelo para o nome do campo binário (padrão) dados). Nome do arquivo de modelo É opcional e, como alternativa, utiliza o nome do arquivo carregado.

String Base64Base64-modelo codificado

Cole ou mapeie uma string base64 em Conteúdo do modelo Base64. Nome do arquivo de modelo É necessário que a extensão corresponda ao tipo de arquivo do modelo (.docx, .html, .pdf).

Código HTMLPasta crua HTML em linha (HTML apenas)

Válido somente quando o tipo de arquivo de modelo for HTMLCole tudo ou parte dele HTML com marcadores de posição como {{título}}, {{contente}} em Código HTMLO nó o envolve em um básico <html> casca se estiver faltando. Nome do arquivo de modelo é necessário (por exemplo, modelo.html).

URLBaixar a partir de um link público

Forneça um HTTPS URL em URL do arquivo de modelo. PDF4me busca o modelo diretamente. O URL deve estar aberto (sem autenticação) e Nome do arquivo de modelo É necessário para que a extensão corresponda ao tipo de modelo.

Opções de tipo de dados do documento

Selecione o formato de dados que você está enviando.

Tipo de dados do documento. JSON ou XML (não CSV nesta operação)

JSONPadrão: matriz de registros (mais comum)

Use um JSON matriz onde cada objeto é um documento gerado, por exemplo. [{"name":"Alice"}, {"name":"Bob"}]O nó valida se a carga útil foi analisada corretamente. Um único objeto gera um documento. Passe um array se desejar vários documentos.

XMLRegistro repetitivo XML

Use um XML A estrutura que seu modelo espera para linhas repetidas (estilo mala direta). O nó não realiza validação profunda. Certifique-se de que... XML corresponde aos pontos de ligação do modelo.

Opções de tipo de entrada de dados do documento

Escolha como os dados em massa entram no nó.

Tipo de entrada de dados do documento: Texto, Dados binários. Base64 Corda, ou URL

TextoPadrão: colar dados em massa diretamente no texto

Digite ou mapeie a expressão completa JSON matriz ou XML em Texto dos dados do documentoEste campo é estritamente obrigatório na operação Múltipla quando a opção Texto é selecionada (mais rigoroso do que na operação Única).

Dados bináriosUtilize um arquivo de dados de um nó anterior.

Definir Propriedade binária do documento para o nome do campo binário (padrão) dadosObserve que os nomes das propriedades binárias do modelo e dos dados não entrem em conflito quando ambos vierem do mesmo item.

String Base64Base64-arquivo de dados codificado

Forneça o inteiro .json ou .xml arquivo como base64 em Conteúdo do documento Base64. Nome do arquivo de dados do documento é necessário.

URLBaixar a partir de um link público

Definir URL do arquivo de dados do documento para o público HTTPS URL do JSON ou XML arquivo de dados. Nome do arquivo de dados do documento É necessário que a extensão corresponda ao tipo de dados.

Comportamento do nome do arquivo de saída

Cenário	Nome do arquivo de saída	Nomes de arquivos gerados
One document returned	invoice	invoice.pdf (extension added if missing)
Many documents returned	invoice	invoice_1.pdf, invoice_2.pdf, invoice_3.pdf, ...
Many documents, name left empty	(empty)	API-provided names or generated_document_1, generated_document_2, ...

Campos de saída

Uma corrida bem-sucedida retorna um n8n item por documento gerado. Cada item contém ambos JSON metadados e o arquivo binário.

Campo	Tipo	O que contém
success	Boolean	True when the document was generated successfully. Use to route error handling branches.
fileName	String	Filename of this generated document, e.g. invoice_2.pdf. Map into upload or email nodes.
mimeType	String	MIME type of the output file, e.g. application/pdf, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, text/html.
fileSize	Number	Size of the generated file in bytes.
documentIndex	Number	Index of this document within the batch (1-based). Useful for filenames or logging.
totalDocuments	Number	How many documents were produced in this run. Same on every item.
Binary (data)	Binary	The generated document under Binary Data Output Name (default data). Pass to Write Binary File, Email, or any cloud-storage upload.

Como faço para configurar a geração de documentos (múltiplos) no n8n?

1. Adicionar PDF4me para o seu n8n Fluxo de trabalho. Configurar Recurso para Gerar e Gerar operações para Gerar documentos (múltiplos).
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 Tipo de arquivo de modelo para Palavra (padrão), HTML, ou PDF.
4. Definir Tipo de saída. PDF, Word ou Excel para Word / PDF modelos; HTML apenas para HTML modelos.
5. Definir Tipo de entrada de arquivo de modelo para Dados binários (padrão), Base64 Corda, HTML Código (HTML apenas), ou URL e preencha o campo do modelo correspondente, além de Nome do arquivo de modelo se necessário.
6. Definir Tipo de dados do documento para JSON (padrão) ou XML.
7. Definir Tipo de entrada de dados do documento para Texto (padrão) e cole o seu JSON matriz em Texto dos dados do documentoOu selecione Dados Binários. Base64 Corda, ou URL e forneça o arquivo de dados.
8. Definir Nome do arquivo de saída para algo legível como invoice então os arquivos retornam como invoice_1.pdf, invoice_2.pdf, ...
9. Se a saída PDF e seu modelo possui campos de formulário, habilite-os. Manter PDF Editável.
10. Deixar Nome da saída de dados binários como data a menos que um nó subsequente precise de um nome de propriedade diferente. Execute o nó e direcione os múltiplos itens de saída para Dividir em Lotes, Gravar Arquivo Binário, Enviar por E-mail ou fazer upload para armazenamento em nuvem.

Configurações típicas

Exemplos de fluxo de trabalhoCommon n8n workflow patterns using Generate Documents (Multiple).

Mala direta a partir de um array JSON. Cartas para clientes

1. Um nó do Google Sheets importa para o fluxo de trabalho uma lista de clientes com nome, endereço e saldo.
2. Um nó de código ou conjunto agrupa as linhas em um JSON matriz de objetos (um objeto por cliente).
3. PDF4me Gerar documentos (múltiplos) com o tipo de arquivo de modelo Word e o tipo de saída definido. PDF, Tipo de entrada do arquivo de modelo: Dados binários, e Tipo de entrada dos dados do documento: Texto. O nome do arquivo de saída é carta_ao_cliente.
4. O nó retorna um item por cliente nomeado. customer_letter_1.pdf, customer_letter_2.pdfE assim por diante.
5. Um nó Loop Over Items envia cada PDF para o cliente correspondente via Gmail ou uploads para o Google Drive.

Modelo + dados, ambos como arquivos em n8n

1. Um nó baixa o modelo .docx; outro nó baixa o arquivo .json com os clientes. Um nó de mesclagem os combina, resultando em um único arquivo binário.
2. PDF4me A opção Gerar Documentos (Múltiplos) está configurada com o Tipo de Entrada de Arquivo de Modelo como Dados Binários (Propriedade binária do modelo definido para o nome do campo do modelo) e Tipo de Entrada de Dados do Documento Dados Binários (Propriedade binária do documento definido como o nome do campo de dados).
3. Definir Nome do arquivo de dados do documento se o arquivo de dados não for nomeado data.json.
4. Os arquivos gerados retornam como itens separados e são gravados em um SharePoint Biblioteca de documentos com o nome do ID do cliente.

Modelo hospedado + dados hospedados. Lote de faturas

1. Um gatilho de agendamento noturno aciona a execução em lote da fatura.
2. PDF4me A opção Gerar Documentos (Múltiplos) está configurada com o Tipo de Entrada Arquivo de Modelo. URL (URL do arquivo de modelo aponta para o modelo de fatura .docx no S3) e Tipo de entrada de dados do documento URL (URL do arquivo de dados do documento aponta para um gerado ciclo-de-faturamento.json arquivo).
3. Nome do arquivo de modelo é fatura.docx e Nome do arquivo de dados do documento é ciclo-de-faturamento.json.
4. Tipo de saída é PDFO nome do arquivo de saída é faturae mantenha PDF A opção "Editável" está desativada.
5. Cada item devolvido é carregado na pasta do cliente no Dropbox e enviado por e-mail via Outlook.

Lote HTML a partir de código colado → páginas de destino personalizadas

1. Um gatilho de webhook é acionado quando uma campanha de marketing é lançada.
2. PDF4me A opção Gerar Documentos (Múltiplos) está configurada com o Tipo de Arquivo de Modelo. HTML e Tipo de Entrada de Arquivo de Modelo HTML Código. o HTML é colado diretamente no nó com marcadores de posição tipo bigode.
3. O tipo de dados do documento é JSONO tipo de entrada de dados do documento é Texto e uma expressão mapeia a lista de leads da campanha em um JSON variedade.
4. Tipo de saída é HTMLO nó retorna um HTML Um arquivo por contato.
5. Um nó "Write Binary File" salva cada arquivo binário gerado. HTML para uma pasta web pública; outro nó envia o link personalizado para cada lead.

Saída do Excel a partir de um modelo do Word. Relatórios em lote.

1. Um gatilho de agendamento diário extrai números de KPIs do PostgreSQL.
2. Um nó Set agrupa as linhas por região em um JSON matriz, um registro por região.
3. PDF4me Gerar documentos (múltiplos) com o tipo de arquivo de modelo Word, tipo de saída Excel e tipo de dados do documento. JSON, Tipo de entrada de dados do documento: Texto. O nome do arquivo de saída é relatório_da_região.
4. O nó retorna um arquivo .xlsx por região nomeada. region_report_1.xlsx, region_report_2.xlsxE assim por diante.
5. Um nó do Microsoft OneDrive carrega cada arquivo para a pasta da região correspondente para a equipe de análise.

Dicas práticas

Shape your data as rows

One record per output document. Single objects yield one file. defeats the purpose of this operation.

Use Generate Document (Single) for CSV / Mail Merge / Google Docs

Generate Documents (Multiple) only accepts JSON or XML data and Word / HTML / PDF templates.

"No binary data found" errors

Double-check Template Binary Property and Document Binary Property names. The Merge node from a fan-in workflow can rename binary properties.

Document Data Text is strictly required

On the Multiple operation, leaving the Text field empty rejects the node, stricter than Single.

Name outputs with a meaningful prefix

Use Output File Name like <code>invoice</code> or <code>customer_letter</code> so files are easy to scan in storage (avoid the generic <code>generated_document_*</code> default).

Plan for multiple items downstream

Use Split In Batches, Loop Over Items, or any node that handles many items. not just the first one.

Folha de dicas

Campo	Valor
Resource	Generate
Operation	Generate Documents (Multiple)
Template File Type	Word
Output Type	PDF
Template File Input Type	Binary Data
Template Binary Property	data
Document Data Type	JSON
Document Data Input Type	Text
Document Data Text	(bulk JSON array with multiple records)
Output File Name	my_document (optional, becomes prefix)
Binary Data Output Name	data
Credentials	PDF4me API credential

Perguntas frequentes

How is Generate Documents (Multiple) different from Generate Document (Single)?+

Multiple renders many documents per run, one n8n item per generated document. Single produces exactly one file. Multiple supports fewer template types (Word, HTML, PDF only, no Mail Merge or Google Docs), only JSON or XML data (no CSV), and adds Excel as an output option for Word and PDF templates. Use Single for one-off documents, CSV data, Mail Merge, Google Docs, or PDF form templates.

What shape should my JSON data have?+

A JSON array where each object becomes one generated document, e.g. [{"name":"Alice","email":"[email protected]"},{"name":"Bob","email":"[email protected]"}] generates two files. The node validates that the payload parses; the API drives how many documents are produced based on the records you pass.

What does Output File Name do when many documents come back?+

It becomes a prefix. Setting Output File Name to invoice with Output Type PDF produces invoice_1.pdf, invoice_2.pdf, ... If you leave it empty, filenames come from the API or default to generated_document_1, generated_document_2, ...

Can I use CSV data with Generate Documents (Multiple)?+

No. Document Data Type only offers JSON and XML on this operation. Use Generate Document (Single) for CSV input or any other workflow that needs CSV.

How do I handle the multiple output items in n8n downstream?+

Each generated document is its own n8n item with the binary file under Binary Data Output Name (default data) and metadata fields like documentIndex and totalDocuments. Wire the node into Split In Batches, Loop Over Items, Write Binary File, or any cloud-storage / email node. they iterate over all items automatically.

Can I keep generated PDFs editable?+

Yes. Enable Keep PDF Editable when Output Type is PDF. Every generated PDF in the batch keeps its AcroForm field definitions. With Keep PDF Editable off, the form is flattened to static text on each file.

What happens if the API returns a single file instead of a list?+

You will get one n8n item only. Downstream nodes that already handle multiple items behave correctly for the single-item case. Always design the rest of the flow to handle 1..N items, not exactly N.

My data file is not named data.json. does it matter?+

When using Binary Data input, set Document Data File Name explicitly so the API treats the payload with the correct extension. Same applies to the template: use Template File Name when the binary does not carry a recognisable filename.

Ações relacionadas

Gerar documento (único)

Renderiza um documento a partir de um modelo e um registro de dados. Suporta CSVMala direta e modelos do Google Docs que o Multiple não possui.

Preencha um formulário em PDF

Preencher campos AcroForm existentes em um PDF em vez de renderizar a partir de um modelo de mala direta.

Mesclar vários PDFs

Combine o lote gerado em um único entregável. PDF (um livro de faturas consolidado, por exemplo).

Mesma tarefa em outras plataformas

Gerar documentos (múltiplos) em Make

Mesma operação de renderização em lote que um Make Módulo: cenários visuais que se desdobram em vários arquivos por modelo.

Gerar documentos (múltiplos) em Zapier

Gere lotes de gatilhos a partir de mais de 6.000 aplicativos SaaS, webhooks e CRMs através Zapier.

Gerar documentos (múltiplos) em Power Automate

Microsoft 365 flui com SharePoint bibliotecas de documentos, Outlook E-mails de faturamento e arrays do Dataverse.

Gerar documentos (múltiplos) REST API

O bruto POST /api/v2/GenerateDocumentMultiple ponto final. para código de backend personalizado ou testes com o Postman.

Obtenha ajuda

n8n Integration Guiden8n SampleGetting Started