←Generar documento (único)

Volver a la guía principal: todos los tipos de plantillas, parámetros de nodo y campos de salida.

Combinación de correspondencia

Qué abarca esta guía

Esta guía le muestra cómo fusionar un Plantilla clásica de combinación de correspondencia de Word en n8n usando plantilla_de_combinación_de_correo_simple.docx y sample_mail_merge_data.jsonLa plantilla utiliza Word. CAMPO DE FUSIÓN marcadores de posición (no <<[campo]>> o bigote {{campo}}). Los datos son un JSON matriz con un objeto por destinatario. Para Generar documento (único), utilice una fila en el arreglo. La salida puede ser PDF o Word.

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 →

Antes de comenzar

campos de combinación de correspondencia de Word

La muestra plantilla_de_combinación_de_correo_simple.docx Se creó con la combinación de correspondencia de Word (Insertar campo de combinación). Los nombres de los campos son: nombre de pila, apellido, género, y miembroDeben coincidir. JSON llaves exactamente.

JSON datos de matriz

Usar sample_mail_merge_data.json (recomendado), test.xml, o prueba.csv. Los datos de combinación de correspondencia son un matriz de objetos. Para un documento, pegue una matriz con un solo objeto.

PDF4me credencial en n8n

Crear un PDF4me credencial en n8n y pega tu API clave. La misma clave funciona en todos PDF4me nodos en su instancia.

→ Consigue tu API llave

:::nota Combinación de correspondencia vs. Plantilla de Word de PDF4me Combinación de correspondencia es para documentos de Word creados con campos de combinación de correspondencia clásicos (MERGEFIELD). Plantilla de Word PDF4me usos <<[fieldName]>> Sintaxis LINQ en un formato regular .docx. Elija el tipo que coincida con cómo se creó su plantilla. Para muchos destinatarios en uno API llamar, usar Generar documentos (múltiples) en cambio. :::

Paquete de archivos de muestra

Descarga los cuatro archivos a continuación. Una plantilla de combinación de correspondencia de Word más tres formatos de datos equivalentes.

plantilla_de_combinación_de_correo_simple.docx

Plantilla de combinación de correspondencia de Word (4 campos)

sample_mail_merge_data.json

JSON Matriz con una fila de destinatario (recomendado)

test.xml

Los mismos datos del destinatario que XML

prueba.csv

Los mismos datos del destinatario que CSV (una fila)

¿Qué contienen los archivos de muestra?

Combinar campos en simple_mail_merge_template.docx

La muestra es simple carta de membresía con cuatro campos de combinación clásicos de Word:

Merge field name	Typical label in template	Sample value (sample_mail_merge_data.json)
firstname	Given name	John
lastname	Family name	Adams
gender	Gender	Female
member	Membership tier	Basic

Cómo inspeccionar los nombres de los campos de combinación

En Microsoft Word, pulse Alt+F9 para alternar los códigos de campo. Los campos de combinación de correspondencia aparecen como { CAMPO DE COMBINACIÓN nombre } códigos de estilo. El nombre después CAMPO DE FUSIÓN debe coincidir con su JSON llave.

Mapeo de campos en todos los archivos de datos

Merge field	JSON key (sample_mail_merge_data.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

A diferencia de la plantilla de Word de PDF4me, no hay <<[campo]>> etiquetas. A diferencia de HTML, no hay sintaxis de bigote. El motor enlaza JSON claves para nombres de campos de combinación de Word cara a cara.

El flujo de trabajo de un vistazo

Manual Trigger  →  Read Binary File (simple_mail_merge_template.docx)  →  PDF4me Generate Document (Single)  →  (optional) Write Binary File

Paso	n8n nodo	Objetivo
1	Disparador manual	Inicie el flujo de trabajo bajo demanda.
2	Leer archivo binario	Cargas simple_mail_merge_template.docx en propiedad binaria data
3	PDF4me → Generar documento (único)	Combina plantillas + JSON matriz, salidas PDF o Word
4	Escribir archivo binario o Enviar correo electrónico (opcional)	Guarda o envía generated_document_output.pdf

Colocar Tipo de archivo de plantilla a Combinación de correspondencia. Elegir PDF o Word para Tipo de salida.

---

Paso 1: Descargue y coloque los archivos de muestra.

1. Descargar simple_mail_merge_template.docx y sample_mail_merge_data.json del Paquete de archivos de muestra arriba.
2. Guarda la plantilla en algún lugar n8n Puede leerlo (ruta local en servidores propios o almacenamiento en la nube para activadores de producción).
3. Opcionalmente, descárguelo. test.xml o test.csv para probar otros tipos de datos.

---

Paso 2: Crear el n8n Flujo de trabajo

1. En n8n, crear un nuevo flujo de trabajo.
2. Agregar un Disparador manual nodo.
3. Agregar un Leer archivo binario nodo después del disparador.
4. Agregar PDF4me → Generar documento (único) Después de leer el archivo binario.
5. Conecta tu PDF4me credencial.

:::precaución: El código HTML no es válido aquí Tipo de entrada de archivo de plantilla: HTML Código solo funciona cuando Tipo de archivo de plantilla es HTMLPara la combinación de correspondencia, utilice Datos binarios, Base64 Cadena, o URL.

:::

---

Paso 3: Cargar la plantilla de Word (Read Binary File)

Configurar el Leer archivo binario nodo:

Campo	Valor
Ruta del archivo	Ruta completa a su descarga simple_mail_merge_template.docx
Nombre de la propiedad	data (predeterminado; utilizado como Propiedad binaria de plantilla en PDF4me)

Ejecute este nodo una vez y confirme que el elemento de salida muestra datos binarios. data con nombre de archivo simple_mail_merge_template.docx.

---

Paso 4: Configurar PDF4me Generar documento (único)

Configuración principal

Campo	Valor	Notas
Credencial para conectarse con	Su PDF4me credencial	Conseguir API llave
Recurso	Generate
Generar operaciones	Generar documento (único)
Tipo de archivo de plantilla	Combinación de correspondencia	Plantilla clásica de campo de combinación de Word
Tipo de salida	PDF o Word	PDF para compartir; Word si el destinatario debe editar el documento combinado

Entrada de plantilla (desde Leer archivo binario)

Campo	Valor
Tipo de entrada de archivo de plantilla	Datos binarios
Propiedad binaria de plantilla	data
Nombre del archivo de plantilla	simple_mail_merge_template.docx

Datos del documento (pegar matriz JSON desde sample_mail_merge_data.json)

Campo	Valor
Tipo de entrada de datos del documento	Texto
Tipo de datos del documento	JSON
Texto de los datos del documento	Pegue el contenido completo de sample_mail_merge_data.json (ver el bloque a continuación)

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

:::importante JSON debe ser una matriz Los datos de combinación de correspondencia son una JSON matriz, incluso para un único destinatario. Un objeto en el array produce un documento combinado con Generar documento (único).

:::

Opciones de salida

Campo	Valor
Mantener PDF Editable	Desactivado (predeterminado) cuando el tipo de salida es PDF
Nombre de salida de datos binarios	data (por defecto)

---

Paso 5: Ejecutar y verificar el resultado.

1. Haga clic Ejecutar flujo de trabajo.
2. Abrir el PDF4me Salida del nodo. Bajo Binario, propiedad abierta data (generated_document_output.pdf o .docx).
3. Confirme que los cuatro campos de combinación estén completos:
   • nombre de pila → Juan
   • apellido → Adams
   • género → Mujer
   • miembro → Básico

Si un campo está en blanco, compare su JSON claves con los nombres de CAMPO DE COMBINACIÓN en la plantilla de Word (Alt+F9 en Word).

---

Paso 6: Guardar o enviar el resultado (opcional)

Escribir archivo binario:

Campo	Valor
Nombre del archivo	mail-merge-output.pdf
Nombre de la propiedad de datos	data
Ruta de salida	Carpeta de destino en su n8n anfitrión

Enviar correo electrónico: adjuntar el binario data de PDF4me como el PDF o Word adjunto.

---

Formatos de datos alternativos

Opción A: JSON archivo como binario (sample_mail_merge_data.json)

1. Agregar Leer archivo binario para sample_mail_merge_data.json (utilizar un Unir nodo si la plantilla y los datos comparten el elemento del flujo de trabajo).
2. Colocar Tipo de entrada de datos del documento a Datos binarios, Tipo de datos del documento a JSON, Propiedad binaria del documento a su campo de datos, Nombre del archivo de datos del documento a sample_mail_merge_data.json.

:::precaución: Colisión de nombres de propiedades binarias Si tanto la plantilla como los datos utilizan la propiedad data, uno sobrescribe al otro. Utilice nombres separados (p. ej. template y mergeData) o fusionar elementos de dos nodos de lectura de archivos binarios.

:::

Opción B: XML (test.xml)

Colocar Tipo de datos del documento a XML y pegar:

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

Los nombres de los elementos coinciden con los nombres de los campos de combinación y las claves JSON.

Opción C: CSV (test.csv)

Colocar Tipo de datos del documento a CSV y pegar (fila de encabezado + una fila de datos):

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

Los encabezados de columna coinciden directamente con los nombres de los campos de combinación.

---

Entrada de plantilla alternativa: URL

Anfitrión simple_mail_merge_template.docx en un público HTTPS URL, luego establecer:

Campo	Valor
Tipo de entrada de archivo de plantilla	URL
URL del archivo de plantilla	Enlace público a simple_mail_merge_template.docx
Nombre del archivo de plantilla	simple_mail_merge_template.docx

No se requiere el nodo Leer archivo binario. Los datos aún se pueden pegar como Texto de los datos del documento o cargado desde un URL.

---

Patrones de flujo de trabajo de producción

Métodos comunes para realizar una combinación de correspondencia en producciónOnce the sample test works, replace the Manual Trigger with these patterns.

Hojas de cálculo de Google: de fila a letra

1. Las hojas se activan al crear una nueva fila.
2. Código o Colocar El nodo envuelve la fila en un JSON matriz: [{"nombre de pila": "...", ...}].
3. PDF4me Combinación de correspondencia con fija plantilla_de_combinación_de_correo_simple.docx.
4. Enviar por correo electrónico el combinado PDF al destinatario.

Formulario de registro de webhook

1. El webhook recibe la carga útil del formulario.
2. Mapear campos del cuerpo para fusionar claves (nombre de pila, apellido, etc.).
3. Construye un solo artículo JSON Matriz para texto de datos de documento.
4. Almacene o envíe por correo electrónico el resultado. PDF.

Combinación masiva (varios destinatarios)

1. Exportar contactos como un JSON matriz (un objeto por persona).
2. Cambiar a Generar documentos (múltiples) por una PDF por fila.
3. Mantenga la opción Generar documento (único) cuando solo necesite un archivo combinado por ejecución.

Preguntas frecuentes

How is Mail Merge different from PDF4me Word Template?+

Mail Merge uses classic Word MERGEFIELD placeholders created in Word mail merge. PDF4me Word Template uses <<[fieldName]>> LINQ syntax in a regular .docx. Pick the type that matches how your template was authored. Data for Mail Merge is typically a JSON array.

Why must JSON be an array?+

Mail merge is designed for one or more recipient rows. Generate Document (Single) uses the first row when you pass one object in the array. Generate Documents (Multiple) processes every row and returns multiple output files.

Why is a merge field blank?+

JSON keys must match MERGEFIELD names exactly, including case. firstname works; FirstName or first_name usually does not. Toggle field codes in Word (Alt+F9) to read the internal name.

PDF or Word output?+

Choose PDF for emailing, archiving, or printing. Choose Word when the recipient needs to edit the merged document after generation. Both work with the same template and JSON array.

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

JSON arrays are the most natural fit for mail merge in n8n. XML and CSV in the sample pack carry the same four values for a single recipient. All formats map one value per merge field name.

Guías relacionadas

• Descripción general de la generación de documentos (individuales): todos los parámetros, campos de salida y tipos de plantilla
• PDF4me Plantilla de Word: <<[fieldName]>> sintaxis en lugar de MERGEFIELD
• Generar documentos (múltiples): un archivo de salida por fila en su JSON matriz
• Blog sobre el flujo de trabajo de combinación de correspondencia: patrón de extremo a extremo en Make

Back to overviewGenerate Documents (Multiple)