Generar documentos (múltiples) en n8n

Generar documentos múltiples Es una acción de nodo de PDF4me en n8n, que se muestra en el nodo como Generar documentos (múltiples). Genera varios archivos terminados en una sola ejecución a partir de una plantilla y una matriz de registros. Úsela para un lote de facturas, cartas a clientes o informes por región, donde cada documento se devuelve como un elemento n8n independiente.

Lo que hace este nodo

PDF4meGenerar documentos (múltiples) toma una plantilla y una lista de registros y produce muchos documentos terminados en uno n8n correr. Proporcionar una Palabra, HTML, o PDF plantilla a través de datos binarios, Base64, HTML código, o URL más datos masivos como JSON o XML (matriz de registros o repetición) XML). Cada archivo generado se devuelve como un elemento de salida separado para que pueda reproducirlos en bucle, guardarlos, enviarlos por correo electrónico o cargarlos individualmente. Utilice este nodo en lugar de Generar documento (único) Siempre que tenga una lista de clientes, facturas o registros y desee un documento finalizado por fila en una sola ejecución.

Entradas de blog relacionadas

Aún no hay ninguna entrada de blog sobre esta función; estará disponible próximamente.

Mientras tanto, echa un vistazo al blog de PDF4me para encontrar tutoriales y flujos de trabajo para todas las plataformas.

Visita el blog →

Autenticando su API Pedido

Cada PDF4me nodo en n8n requiere un válido Credencial para conectarse con. Crea o selecciona uno que contenga tu PDF4me API clave para que el flujo de trabajo pueda autenticar de forma segura las solicitudes de generación de documentos por lotes.

Get your API Key

Datos importantes que no debes perderte

Uno n8n artículo por documento generado

Una ejecución exitosa generalmente devuelve varios elementos, uno por cada archivo generado. Cada elemento lleva el archivo binario en Binary Data Output Name y JSON Metadatos con documentIndex y totalDocuments para que puedas reproducir en bucle, guardar o enviar por correo electrónico cada archivo individualmente.

Pasar un array (JSON) o repitiendo XML así que el API sabe cuántos archivos renderizar

Para JSON, utilice una matriz de objetos, uno por documento generado. Para XMLUtilice una estructura de registro repetible que la plantilla espera (estilo combinación de correspondencia). Los objetos individuales generan un solo documento, lo que anula el propósito de esta operación.

CSVLa combinación de correspondencia y Google Docs no están disponibles aquí.

El tipo de archivo de plantilla solo ofrece Word, HTML, PDF. El tipo de datos del documento solo ofrece JSON o XMLSi lo necesitas CSV Para introducir datos o utilizar plantillas de combinación de correspondencia/Google Docs, utilice la opción Generar documento (único).

Panel de nodos completo. Plantilla de Word + JSON Datos de texto + PDF La salida es la configuración típica de combinación de correspondencia.

Generar documentos (múltiples) vs. Generar documento (único)

Elegir la opción incorrecta es el error más común en esta tarea. La diferencia radica en la cantidad de archivos que se reciben y en los formatos de plantilla y datos disponibles.

Aspecto	Generar documentos (múltiples)	Generar 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

¿Qué parámetros necesita la función Generar documentos (múltiples)?

Requerido en el n8n Interfaz de usuario: Credencial para conectarse, Tipo de archivo de plantilla, Tipo de entrada de archivo de plantilla, Tipo de datos del documento, Tipo de entrada de datos del documento y Tipo de salida (siempre se muestra. Las opciones dependen del tipo de archivo de plantilla). Campos obligatorios condicionales (Propiedad binaria de la plantilla, Plantilla Base64 Contenido, HTML Código, archivo de plantilla URL, Texto de datos del documento, Propiedad binaria del documento, etc.) aparecen solo cuando se elige su tipo de entrada principal. Nombre del archivo de salida, Conservar PDF Editable y Binary Data Output Name son opcionales, con valores predeterminados sensatos.

Parámetro	Requerido	Lo que hace	Ejemplo
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

Opciones de tipo de archivo de plantilla

Seleccione el formato de plantilla. Las opciones de tipo de salida cambian con esta selección.

Menú desplegable Tipo de archivo de plantilla. Word, HTML, o PDF (Aquí no se utiliza la función de combinación de correspondencia ni Google Docs)

PalabraPredeterminado: plantillas .docx

Estándar PDF4me Plantilla de Word con marcadores de posición de bigotes. El tipo de salida puede ser PDFWord o Excel. La opción más común para facturas por lotes, cartas a clientes e informes personalizados.

HTMLHTML plantillas y pegadas HTML código

Renderizados HTML plantillas con marcadores de posición de bigote. El tipo de salida es HTML solamente. Emparejar con el tipo de entrada de archivo de plantilla HTML Código para pegar sin formato HTML en línea, o utilice datos binarios / URL para un archivo .html alojado.

PDFPDF plantillas

Utilice uno existente PDF como plantilla. El tipo de salida puede ser PDF, Word o Excel. Para PDF salida, habilitar Mantener PDF Se puede editar si desea que los campos sean editables en cada archivo generado.

Tipo de salida por plantilla

Tipo de archivo de plantilla	Opciones de tipo de salida	Por defecto
Word	PDF, Word, Excel	PDF
PDF	PDF, Word, Excel	PDF
HTML	HTML only	HTML

Opciones de tipo de entrada de archivo de plantilla

Elige cómo se inserta la plantilla en el nodo. Los campos siguientes cambian según esta elección.

Tipo de entrada de archivo de plantilla. Datos binarios, Base64 Cadena, HTML Código o URL

Datos binariosPredeterminado: archivo del nodo anterior

Lee la plantilla directamente desde un nodo anterior como Google Drive Download, HTTP Solicitar o leer archivo binario. Establecer Propiedad binaria de plantilla al nombre del campo binario (predeterminado) datos). Nombre del archivo de plantilla es opcional y, en caso contrario, se utilizará el nombre del archivo subido.

Cadena Base64Base64-plantilla codificada

Pegue o asigne una cadena base64 a Plantilla de contenido Base64. Nombre del archivo de plantilla Es necesario para que la extensión coincida con el tipo de archivo de plantilla (.docx, .html, .pdf).

Código HTMLPasta cruda HTML en línea (HTML solo)

Solo válido cuando el tipo de archivo de plantilla es HTMLPegar completo o parcial HTML con marcadores de posición como {{título}}, {{contenido}} en Código HTMLEl nodo lo envuelve en un básico <html> Si falta, la carcasa. Nombre del archivo de plantilla es necesario (por ejemplo, plantilla.html).

URLDescargar desde un enlace público

Proporcione un HTTPS URL en URL del archivo de plantilla. PDF4me obtiene la plantilla directamente. URL debe estar abierto (sin autenticación) y Nombre del archivo de plantilla Es necesario para que la extensión coincida con el tipo de plantilla.

Opciones de tipo de datos del documento

Seleccione el formato de datos que va a enviar.

Tipo de datos del documento. JSON o XML (No CSV en esta operación)

JSONPredeterminado: matriz de registros (lo más común)

Utilice un JSON matriz donde cada objeto es un documento generado, por ejemplo: [{"nombre":"Alice"}, {"nombre":"Bob"}]El nodo valida que la carga útil se analice correctamente. Un solo objeto genera un documento. Si desea generar varios, pase un array.

XMLGrabación repetitiva XML

Utilice un XML estructura que su plantilla espera para filas repetidas (estilo combinación de correspondencia). El nodo no realiza una validación profunda. asegúrese de que XML coincide con los puntos de enlace de la plantilla.

Opciones de tipo de entrada de datos del documento

Elige cómo ingresan los datos masivos al nodo.

Tipo de entrada de datos del documento. Texto, datos binarios, Base64 Cuerda o URL

TextoPredeterminado: pegar datos masivos en línea

Escriba o asigne expresiones al valor completo JSON matriz o XML en Texto de los datos del documentoEste campo es estrictamente obligatorio en la operación Múltiple cuando se elige Texto (más estricto que en la operación Única).

Datos binariosUtilice un archivo de datos de un nodo anterior.

Colocar Propiedad binaria del documento al nombre del campo binario (predeterminado) datos). Asegúrese de que los nombres de las propiedades binarias de la plantilla y de los datos no entren en conflicto cuando ambos provengan del mismo elemento.

Cadena Base64Base64archivo de datos codificado

Proporcione todo .json o .xml archivo como base64 en Contenido Base64 del documento. Nombre del archivo de datos del documento se requiere.

URLDescargar desde un enlace público

Colocar URL del archivo de datos del documento a un público HTTPS URL del JSON o XML archivo de datos. Nombre del archivo de datos del documento es necesario para que la extensión coincida con el tipo de datos.

Comportamiento del nombre del archivo de salida

Guión	Nombre del archivo de salida	Nombres de archivo generados
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 salida

Una carrera exitosa devuelve uno n8n elemento por documento generado. Cada elemento contiene ambos JSON metadatos y el archivo binario.

Campo	Tipo	Lo que contiene
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.

¿Cómo configuro la generación de documentos (múltiples) en n8n?

1. Agregar PDF4me a tu n8n flujo de trabajo. Establecer Recurso a Generar y Generar operaciones a Generar documentos (múltiples).
2. En Credencial para conectarse con, seleccione su PDF4me credenciales o haga clic Crear nueva credencial y pega tu API llave.
3. Colocar Tipo de archivo de plantilla a Palabra (por defecto), HTML, o PDF.
4. Colocar Tipo de salida. PDF, Word o Excel para Word / PDF plantillas; HTML solo para HTML plantillas.
5. Colocar Tipo de entrada de archivo de plantilla a Datos binarios (por defecto), Base64 Cadena, HTML Código (HTML solamente), o URL y rellenar el campo de plantilla correspondiente más Nombre del archivo de plantilla si es necesario.
6. Colocar Tipo de datos del documento a JSON (predeterminado) o XML.
7. Colocar Tipo de entrada de datos del documento a Texto (predeterminado) y pegue su JSON matriz en Texto de los datos del documento. o seleccione Datos binarios, Base64 Cuerda o URL y proporcionar el archivo de datos.
8. Colocar Nombre del archivo de salida a algo legible como invoice así que los archivos vuelven como invoice_1.pdf, invoice_2.pdf, ...
9. Si la salida PDF y su plantilla tiene campos de formulario, habilítelos. Mantener PDF Editable.
10. Dejar Nombre de salida de datos binarios como data a menos que un nodo posterior necesite un nombre de propiedad diferente. Ejecute el nodo y dirija los múltiples elementos de salida a Dividir en lotes, Escribir archivo binario, Correo electrónico o Carga en almacenamiento en la nube.

Configuraciones típicas

Ejemplos de flujo de trabajoCommon n8n workflow patterns using Generate Documents (Multiple).

Combinación de correspondencia a partir de una matriz JSON. Cartas de clientes

1. Un nodo de Google Sheets extrae una lista de clientes con nombre, dirección y saldo e la incorpora al flujo de trabajo.
2. Un nodo de código o conjunto empaqueta las filas en un JSON matriz de objetos (un objeto por cliente).
3. PDF4me Generar documentos (múltiples) se ejecuta con tipo de archivo de plantilla Word, tipo de salida PDF, Tipo de entrada del archivo de plantilla: Datos binarios, y Tipo de entrada de datos del documento: Texto. El nombre del archivo de salida es carta_al_cliente.
4. El nodo devuelve un artículo por cliente llamado carta_al_cliente_1.pdf, carta_al_cliente_2.pdf, etcétera.
5. Un nodo Loop Over Items envía cada PDF al cliente correspondiente a través de Gmail o mediante cargas a Google Drive.

Plantilla + datos ambos como archivos en n8n

1. Un nodo descarga la plantilla .docx; otro nodo descarga el archivo .json de clientes. Un nodo de fusión los combina para que ambos binarios se guarden en un solo elemento.
2. PDF4me Generar documentos (múltiples) está configurado con tipo de entrada de archivo de plantilla Datos binarios (Propiedad binaria de plantilla establecido al nombre del campo de la plantilla) y Tipo de entrada de datos del documento Datos binarios (Propiedad binaria del documento establecido al nombre del campo de datos).
3. Colocar Nombre del archivo de datos del documento si el archivo de datos no se llama datos.json.
4. Los archivos generados regresan como elementos separados y se escriben en un SharePoint Biblioteca de documentos cuyo nombre coincide con el ID del cliente.

Plantilla alojada + datos alojados. Lote de facturas

1. Un activador programado que se ejecuta cada noche inicia el procesamiento por lotes de las facturas.
2. PDF4me Generar documentos (múltiples) está configurado con el tipo de entrada de archivo de plantilla. URL (URL del archivo de plantilla apunta a la plantilla de factura .docx en S3) y Tipo de entrada de datos del documento URL (URL del archivo de datos del documento apunta a un generado ciclo-de-facturación.json archivo).
3. Nombre del archivo de plantilla es factura.docx y Nombre del archivo de datos del documento es ciclo-de-facturación.json.
4. El tipo de salida es PDF, El nombre del archivo de salida es facturay Mantén PDF La opción de edición está desactivada.
5. Cada artículo devuelto se sube a la carpeta del cliente en Dropbox y se envía por correo electrónico a través de Outlook.

Generación de lotes HTML a partir de código pegado → páginas de destino personalizadas

1. Un activador de webhook se dispara cuando se lanza una campaña de marketing.
2. PDF4me Generar documentos (múltiples) está configurado con el tipo de archivo de plantilla. HTML y tipo de entrada de archivo de plantilla HTML El Código. HTML se pega directamente en el nodo con marcadores de posición de bigote.
3. El tipo de datos del documento es JSON, El tipo de entrada de datos del documento es Texto, y una expresión asigna la lista de clientes potenciales de la campaña a un JSON matriz.
4. El tipo de salida es HTML. El nodo devuelve uno HTML Archivo por cliente potencial.
5. Un nodo Escribir archivo binario guarda cada archivo generado HTML a una carpeta web pública; otro nodo envía el enlace personalizado a cada cliente potencial.

Salida de Excel a partir de una plantilla de Word. Informes por lotes.

1. Un disparador programado diario extrae los datos de los indicadores clave de rendimiento (KPI) de PostgreSQL.
2. Un nodo Set agrupa las filas por región en un JSON matriz, un registro por región.
3. PDF4me Generar documentos (múltiples) se ejecuta con tipo de archivo de plantilla Word, tipo de salida Excel, tipo de datos del documento JSON, Tipo de entrada de datos del documento: Texto. El nombre del archivo de salida es informe_de_región.
4. El nodo devuelve un archivo .xlsx por región llamada informe_de_región_1.xlsx, informe_de_región_2.xlsx, etcétera.
5. Un nodo de Microsoft OneDrive carga cada archivo en la carpeta de la región correspondiente para el equipo de análisis.

Consejos prácticos

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.

Hoja de trucos

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

Preguntas frecuentes

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.

Acciones relacionadas

Generar documento (único)

Genera un documento a partir de una plantilla y un registro de datos. Admite CSV, Combinación de correspondencia y plantillas de Google Docs que Multiple no tiene.

Rellene un formulario PDF

Rellene los campos existentes de AcroForm en un PDF en lugar de generar a partir de una plantilla de combinación de correspondencia.

Combinar varios archivos PDF

Combine el lote generado en un único entregable. PDF (un talonario de facturas consolidado, por ejemplo).

La misma tarea en otras plataformas

Generar documentos (múltiples) en Make

Misma operación de renderizado por lotes que una Make Módulo: escenarios visuales que se despliegan en varios archivos por plantilla.

Generar documentos (múltiples) en Zapier

Generación de lotes activada desde más de 6000 aplicaciones SaaS, webhooks y CRMs a través de Zapier.

Generar documentos (múltiples) en Power Automate

Microsoft 365 fluye con SharePoint bibliotecas de documentos, Outlook correos electrónicos de facturación y matrices de Dataverse.

Generar documentos (múltiples) REST API

El crudo POST /api/v2/GenerateDocumentMultiple Punto final. Para código backend personalizado o pruebas con Postman.

Obtén ayuda

n8n Integration Guiden8n SampleGetting Started