←Generar documento (único)

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

Formulario PDF

Qué abarca esta guía

Esta guía le muestra cómo rellenar un formulario. PDF Plantilla AcroForm en n8n usando plantilla.pdf y formdata.jsonMapa de claves de datos directamente a los nombres de los campos del formulario (nombre de pila, apellido, etc.). La salida es PDF solo. Usar Mantener PDF Editable para dejar los campos editables después de rellenarlos, o desactivar esta opción para aplanar el formulario.

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

PDF con campos de AcroForm

La muestra plantilla.pdf Es un formulario de membresía con cuatro campos. JSON Las claves deben coincidir con nombre interno de AcroFormNo se trata de la etiqueta visible en pantalla. Los nombres distinguen entre mayúsculas y minúsculas.

Objeto de datos plano

Usar formdata.json (recomendado), test.xml, o prueba.csvLos tres proporcionan los mismos cuatro valores. Los datos del formulario PDF son un objeto plano único, no anidado como el HTML Ejemplo de factura.

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 Formulario PDF vs. Rellenar un formulario PDF Generar documento (único) con Formulario PDF utiliza el motor de generación de plantillas con un PDF formulario como plantilla. Para rellenar cualquier formulario existente PDF AcroForm sin el flujo de trabajo de generación, ver Rellene un PDF FormaPara descubrir los nombres de los campos en un campo desconocido PDF, correr Extraer datos del formulario de PDF Primero en la plantilla.

:::

Paquete de archivos de muestra

Descarga los cuatro archivos a continuación. Uno PDF Plantilla de formulario más tres formatos de datos equivalentes.

plantilla.pdf

PDF Plantilla AcroForm (4 campos)

formdata.json

Departamento JSON indexado por nombre de campo (recomendado)

test.xml

Los mismos valores de formulario que XML

prueba.csv

Los mismos valores de formulario que CSV (una fila)

¿Qué contienen los archivos de muestra?

Campos de formulario en template.pdf

El PDF de muestra es un simple Formulario de membresía/registroCada nombre de campo de AcroForm se corresponde con una clave en sus datos:

Nombre del campo de AcroForm	Uso típico en plantilla	Valor de muestra (formdata.json)
firstname	Nombre de pila	John
lastname	Apellido	Adán
gender	Selección de género	Femenino
member	Nivel de membresía	Básico

Nombres de campo frente a etiquetas visibles

Los nombres de AcroForm suelen estar en minúsculas y sin espacios (firstname), incluso cuando el PDF muestra "Nombre". Si aparece un valor en blanco, la clave en su JSON casi siempre no coincide con el nombre del campo interno. Extraer datos del formulario de PDF para listar nombres exactos de tu propia plantilla.

Mapeo de campos en todos los archivos de datos

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

A diferencia de Word o HTML plantillas, hay Sin marcadores de posición de bigoteEl motor coincide Claves de datos para nombres de campos de AcroForm cara a cara.

El flujo de trabajo de un vistazo

Manual Trigger  →  Read Binary File (template.pdf)  →  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 template.pdf en propiedad binaria data
3	PDF4me → Generar documento (único)	Rellena los campos de AcroForm desde JSON/XML/CSV, salidas PDF
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 Formulario PDF. Tipo de salida es PDF Solo para este tipo de plantilla.

---

Paso 1: Descargue y coloque los archivos de muestra.

1. Descargar template.pdf y formdata.json del Paquete de archivos de muestra arriba.
2. Ahorrar template.pdf 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 el formulario PDF, utilice Datos binarios, Base64 Cadena, o URL.

:::

---

Paso 3: Cargar la plantilla PDF (Read Binary File)

Campo	Valor
Ruta del archivo	Ruta completa a su descarga template.pdf
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 template.pdf.

---

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	Formulario PDF	PDF con campos de AcroForm
Tipo de salida	PDF	Única opción para formulario PDF

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	template.pdf

Datos del documento (pegar JSON desde formdata.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 formdata.json (ver el bloque a continuación)

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

Opciones de salida

Campo	Valor	Cuándo usar
Mantener PDF Editable	En	El destinatario aún debe editar los campos en el formulario completado. PDF
Mantener PDF Editable	Apagado (por defecto)	Aplanar los campos del formulario y convertirlos en contenido estático.
Nombre de salida de datos binarios	data (por defecto)	Propiedad binaria para la salida PDF

---

Paso 5: Ejecutar y verificar el PDF

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

Si algún campo está vacío, compare su JSON claves con los nombres de AcroForm en template.pdf personaje por personaje.

---

Paso 6: Guardar o enviar el resultado (opcional)

Escribir archivo binario:

Campo	Valor
Nombre del archivo	filled-form-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 adjunto.

---

Formatos de datos alternativos

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

1. Agregar Leer archivo binario para formdata.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 formdata.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 formData) 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 AcroForm y JSON llaves.

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 del formulario AcroForm.

---

Entrada de plantilla alternativa: URL

Anfitrión template.pdf 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 template.pdf
Nombre del archivo de plantilla	template.pdf

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 rellenar formularios PDF en producciónOnce the sample test works, replace the Manual Trigger with these patterns.

Envío de formulario mediante webhook

1. El webhook recibe la carga útil de registro.
2. Campos del cuerpo del mapa a JSON claves que coinciden con los nombres de AcroForm.
3. PDF4me rellenos fijos plantilla.pdf de binario o URL.
4. Envíe por correo electrónico o guarde el formulario completado. PDF.

Fila de Google Sheets a PDF

1. Las hojas se activan al crear una nueva fila.
2. Colocar o Código compilaciones de nodos {"nombre de pila": "...", ...}.
3. PDF4me Generar documento (único) con plantilla de formulario PDF.
4. Cargar la salida a Drive o SharePoint.

CRM contacto para membresía PDF

1. Activador de HubSpot/Salesforce para nuevos contactos.
2. Mapa CRM propiedades a nombre de pila, apellido, etc.
3. Colocar Mantener PDF Editable Voy a aplanarlo antes de archivarlo.

Preguntas frecuentes

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.

Guías relacionadas

• Descripción general de la generación de documentos (individuales): todos los parámetros, campos de salida y tipos de plantilla
• Rellene un PDF Forma: Relleno dedicado de AcroForm sin el motor de generación de plantillas
• Extraer datos del formulario de PDF: listar los nombres de los campos de cualquier PDF forma

Back to overviewFill a PDF Form