Saltar al contenido principal

Rellene un PDF Formulario en n8n

Lo que hace este nodo

PDF4me: Rellene un PDF Forma toma un formulario rellenable PDF (AcroForm) y rellena sus campos con sus datos en uno n8n paso. Proporcione la plantilla como Binary Data, Base64, o URL y valores de campo como un JSON objeto (JSON Cadena, binario o Base64) o como Filas con nombre de campo / valor de campo. Devuelve un completo PDF, ya sea aplanado (predeterminado) o con campos editables conservados. Ideal para rellenar solicitudes, contratos, formularios de admisión o cualquier AcroForm plantilla de CRM, webhook o datos de hoja de cálculo.

Entradas de blog relacionadas(1)

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 llenado de formularios.

Datos importantes que no debes perderte

El PDF debe tener ya AcroForm campos
Este nodo rellena los campos de formulario existentes, no los crea. Un escaneo plano sin campos no se puede rellenar. Utilice Agregar campos de formulario para PDF Primero, si tu plantilla solo tiene marcadores de posición visuales.
Las llaves deben coincidir AcroForm nombres de campo exactamente
Los nombres de los campos distinguen entre mayúsculas y minúsculas y a menudo difieren de las etiquetas visibles (nombre de pila en lugar de Nombre de pila). Ejecutar Extraer datos del formulario PDF Primero, revise la plantilla o inspeccione con Adobe Acrobat Prepare Form para obtener la lista exacta.
Datos del formulario (JSON) espera un objeto, no una lista
Enviar un solo JSON objeto ({"nombre":"John","apellido":"Doe"}). Un array con un objeto se desempaqueta; varios objetos se rechazan. Para llenar muchos PDFs en una sola ejecución, envuelva este nodo en un Bucle sobre elementos.
Nodo n8n para rellenar un formulario PDF configurado con credenciales para conectarse con Pdf4me, Formularios de recursos, Operaciones de formularios: rellenar un formulario PDF, Tipo de datos de entrada PDF: Datos binarios, Datos de campo binarios PDF, Seleccionar tipo de entrada: Datos de formulario de entrada, dos campos de formulario de ejemplo con el nombre del campo "Nombre" con el valor "shakti" y el apellido "Karmakar", además de un botón para añadir campos de formulario.

Panel de nodos completo: PDF plantilla vía Binary Data + Filas de campos de datos del formulario de entrada

Parámetros

Requerido en el n8n UI: Credencial para conectarse con, PDF Tipo de datos de entrada, seleccione el tipo de entrada y (dependiendo del tipo de entrada seleccionado) el tipo de entrada de datos del formulario con su campo de contenido correspondiente, o al menos una fila de campos del formulario con el nombre del campo y el valor del campo. Nombre del archivo de salida (predeterminado) formulario_rellenado_salida.pdf), Mantener PDF Editable (desactivado) y Binary Data Nombre de salida (predeterminado) datos) son opcionales. Campos de plantilla condicionales (PDF Campo binario, PDF Base64 Contenido, PDF URL) aparecen solo cuando se elige su tipo de entrada.

ParámetroRequeridoLo que haceEjemplo
PDF Input Data TypeYesHow the PDF template enters the node. Binary Data reads from a previous node (default, most common). Base64 String accepts an encoded PDF. URL downloads the PDF from a public link.Binary Data
PDF Binary FieldConditionalName of the binary property on the incoming n8n item that holds the PDF. Required when PDF Input Data Type is Binary Data. Defaults to data.data
PDF Base64 ContentConditionalBase64-encoded PDF content. Required when PDF Input Data Type is Base64 String. Data-URL prefixes (data:application/pdf;base64,) are stripped automatically.JVBERi0xLjQK...
PDF URLConditionalPublicly reachable HTTPS URL to the PDF template. Required when PDF Input Data Type is URL. Must be a valid full URL format.https://example.com/application-form.pdf
Select Input TypeYesHow the field values are supplied. JSON sends a stringified JSON object via dataArray. Input Form Data adds one UI row per field with Field Name and Field Value.JSON
Form Data Input TypeConditionalHow the JSON object is supplied. Required when Select Input Type is JSON. JSON String pastes the object directly (default). Binary Data reads a JSON file from a previous node. Base64 String accepts an encoded JSON object.JSON String
Form Data (JSON)ConditionalRaw JSON object whose keys are PDF field names and values are what to fill. Required when Form Data Input Type is JSON String. Must be a single object, not a list.{"firstname":"John","lastname":"Doe","email":"[email protected]"}
Form Data Binary FieldConditionalName of the binary property on the incoming n8n item that holds the JSON data file. Required when Form Data Input Type is Binary Data. Defaults to data.data
Form Data Base64 ContentConditionalBase64-encoded UTF-8 JSON object. Required when Form Data Input Type is Base64 String. Decoded then stringified into dataArray.eyJmaXJzdG5hbWUiOiJKb2huIn0=
Form FieldsConditionalCollection of field rows. Required when Select Input Type is Input Form Data. Add at least one row via Add Form Field. The node errors if the list is empty.[{Field Name: firstname, Field Value: John}]
Field Name (per row)ConditionalExact AcroForm field name to fill. Required for every row added to Form Fields.firstname
Field Value (per row)ConditionalValue to fill into the matching AcroForm field. Required for every row added to Form Fields.John
Output File NameNoFilename of the filled PDF returned by the node. Default is filled_form_output.pdf. Include the .pdf extension.filled_form_output.pdf
Keep PDF EditableNoToggle to keep AcroForm fields editable on the filled PDF. Off (default) flattens the form into static text. On preserves field definitions so the recipient can re-edit.Off
Binary Data Output NameNoName of the binary property the output item exposes. Default is data. Use a different name when a downstream node expects it.data

PDF Opciones de tipo de datos de entrada

Elige cómo el PDF La plantilla se inserta en el nodo. Los campos siguientes cambian con esta selección.

Menú desplegable Tipo de datos de entrada PDF en n8n PDF4me. Nodo "Rellenar un formulario PDF" que muestra tres opciones: Datos binarios (resaltado con descripción): Usar el archivo PDF del nodo anterior; Cadena Base64 (con descripción): Proporcionar el contenido del PDF como una cadena codificada en base64; URL (con descripción): Proporcionar la URL del archivo PDF.

PDF Tipo de datos de entrada: Binary Data, Base64 Cuerda o URL

Datos binariosPor defecto: PDF del nodo anterior
Lee el PDF directamente desde un nodo anterior como Google Drive Download, HTTP Solicitar o leer archivo binario. Establecer Campo binario PDF al nombre del campo binario (predeterminado) datos).
Cadena Base64PDF como una cadena base64
Pegue o asigne una cadena base64 a Contenido PDF Base64. Datos-URL prefijos de estilo (datos:application/pdf;base64,) se eliminan automáticamente.
URLDescargar desde un enlace público
Proporcione una descripción completa HTTPS URL en URL del PDF. PDF4me obtiene la plantilla directamente. URL Debe ser válido y accesible sin autenticación.

Seleccione las opciones de tipo de entrada

Seleccione cómo se proporcionan los valores de los campos. Los campos subsiguientes cambiarán según esta elección.

Seleccione el menú desplegable Tipo de entrada en el nodo n8n PDF4me Rellenar un formulario PDF que muestra dos opciones: JSON con descripción Enviar datos del formulario como un objeto JSON en formato de cadena en dataArray y Datos del formulario de entrada resaltados con la descripción Enviar datos del formulario como una matriz de pares nombre-valor de campo.

Seleccione el tipo de entrada: JSON (para dataArray) o datos de formulario de entrada (UI filas)

JSONIdeal para muchos campos y datos dinámicos.
Envía una cadena de texto JSON objeto a través del API matriz de datos campo. Las claves son PDF Los nombres de los campos y los valores son lo que se debe rellenar. Añada una opción de tipo de entrada de datos del formulario de seguimiento (JSON Cadena, Binary Data, o Base64 Cadena) para proporcionar el objeto.
Datos del formulario de entradaIdeal para conjuntos pequeños y fijos configurados en el UI
Agregue una fila por campo mediante Agregar campo de formularioCada fila tiene una Nombre del campo (exacto AcroForm nombre) y Valor de campoEl nodo genera un error si la lista está vacía.

Opciones de tipo de entrada de datos del formulario (cuando Seleccionar tipo de entrada es JSON)

Menú desplegable Tipo de entrada de datos de formulario en n8n PDF4me. Rellene un nodo de formulario PDF cuando seleccione Tipo de entrada JSON, mostrando tres opciones: Cadena JSON resaltada con la descripción Proporcionar contenido JSON como texto u objeto, Datos binarios con la descripción Usar archivo JSON del nodo anterior, Cadena Base64 con la descripción Proporcionar contenido JSON como cadena codificada en base64.

Tipo de entrada de datos del formulario: JSON Cadena, Binary Data, o Base64 Cadena

Cadena JSONPredeterminado: pegar o mapear JSON en línea
Escriba el objeto directamente en Datos del formulario (JSON) o mapearlo desde una expresión de nodo anterior. La opción más común para CRMflujos de trabajo controlados por procesos o por webhooks.
Datos binariosJSON archivo de un nodo anterior
Colocar Campo binario de datos de formulario al nombre del campo binario (predeterminado) datos). Utilice esto cuando el JSON Llega como un archivo descargado. El archivo debe contener un único objeto.
Cadena Base64Base64codificado JSON objeto
Proporcione el UTF-8 JSON objeto como base64 en Contenido del formulario de datos Base64El nodo lo decodifica y lo convierte en cadena. matriz de datos.

Ejemplo de datos de formulario (JSON)

Cuando Form Data Input Type es JSON Cadena, pegue un solo objeto cuyas claves sean exactas AcroForm nombres de campos.

Tipo de entrada de datos del formulario configurado como cadena JSON con editor de datos de formulario (JSON) que muestra un único objeto JSON en línea: nombre John, apellido Doe, correo electrónico john@example.com, seguido del nombre del archivo de salida filled_form_output.pdf

JSON Entrada de cadena: un objeto, las claves coinciden AcroForm nombres de campo exactamente

{
"firstname": "John",
"lastname": "Doe",
"email": "[email protected]"
}

Campos de salida

Una carrera exitosa devuelve uno n8n artículo que transporta JSON metadatos y el llenado PDF.

CampoTipoLo que contiene
successBooleanTrue when the PDF was filled successfully. Use to route error-handling branches.
messageStringHuman-readable status confirming success or describing an error.
fileNameStringFilename of the filled PDF, set from Output File Name (default filled_form_output.pdf).
mimeTypeStringMIME type of the filled file, application/pdf.
fileSizeNumberSize of the filled PDF in bytes.
inputModeStringWhich input mode was used: json or inputFormData.
fieldCountNumberHow many form fields were sent in this request.
Binary (data)BinaryThe filled PDF under Binary Data Output Name (default data). Pass into Write Binary File, Email, or any cloud-storage upload.

Configuración rápida

  1. Agregar PDF4me a tu n8n flujo de trabajo. Establecer Recurso a Formularios y Operaciones de formularios a Rellene un PDF Forma.
  2. En Credencial para conectarse con, seleccione su PDF4me credenciales o haga clic Crear nueva credencial y pega tu API llave.
  3. Colocar PDF Tipo de datos de entrada a Binary Data (por defecto), Base64 Cadena, o URL y rellenar el campo correspondiente (Campo binario PDF, Contenido PDF Base64, o URL del PDF).
  4. Colocar Seleccione el tipo de entrada a JSON (luego elige Tipo de entrada de datos del formulario = JSON Cadena / Binary Data / Base64 Cadena y proporcione el objeto) o Datos del formulario de entrada (clic Agregar campo de formulario y agregar una fila por campo con Nombre del campo y Valor de campo).
  5. Asegúrese de que cada Nombre del campo coincide con un AcroForm Nombre del campo en la plantilla exactamente (distingue mayúsculas y minúsculas). Utilice Extraer datos del formulario de PDF Primero, si no estás seguro.
  6. Opcionalmente, cambiar Nombre del archivo de salida desde el valor predeterminado filled_form_output.pdf.
  7. Alternar Mantener PDF Editable Activar esta opción solo si el destinatario debe poder editar los campos completados. Si está desactivada por defecto, el formulario se simplifica.
  8. Dejar Binary Data Nombre de salida como data a menos que un nodo descendente necesite un nombre de propiedad diferente. Ejecute el nodo y enrute el contenido. PDF en Escribir archivo binario, correo electrónico o almacenamiento en la nube.

Configuraciones típicas

Ejemplos de flujo de trabajoCommon n8n workflow patterns using Fill a PDF Form.
Archivo. Rellenar. Guardar: PDF Plantilla de Drive, valores en línea
  1. Un nodo de descarga de Google Drive descarga el formulario de solicitud. PDF plantilla (Binary Data, propiedad datos).
  2. PDF4me Rellene un PDF El formulario funciona con PDF Tipo de datos de entrada Binary Data, Seleccione el tipo de entrada JSON, Tipo de entrada de datos del formulario JSON Cadena. Datos del formulario (JSON) es un único objeto en línea.
  3. Un nodo Escribir archivo binario guarda el archivo lleno. PDF a una carpeta de red usando $json.fileName.
Valores de un nodo anterior mapeados con expresiones
  1. Un webhook recibe una carga útil de envío de formulario desde un sitio web.
  2. PDF4me Rellene un PDF El formulario está configurado con el tipo de entrada de selección. JSON, Tipo de entrada de datos del formulario JSON Cadena. Datos del formulario (JSON) es un n8n expresión que asigna la carga útil del webhook directamente al AcroForm forma del campo ({{ { firstname: $json.first, lastname: $json.last } }).
  3. Un nodo de Gmail envía por correo electrónico el archivo completado. PDF De vuelta al remitente como archivo adjunto.
Pocos campos, no JSON: Filas de datos del formulario de entrada
  1. Un formulario de admisión tiene solo tres AcroForm campos: nombre de pila, apellido, correo electrónico.
  2. PDF4me Rellene un PDF El formulario está configurado con Seleccionar tipo de entrada Datos de formulario de entrada. Se agregan tres filas a través de Agregar campo de formulario con los nombres exactos de los campos y los valores escritos o asignados mediante expresiones.
  3. Mantener PDF La opción de edición está desactivada, por lo que el formulario rellenado aparece plano.
  4. El PDF se carga en un SharePoint biblioteca de documentos.
PDF y JSON como archivos separados, fusionados en n8n
  1. Un nodo descarga el PDF plantilla; otro nodo descarga la JSON archivo de datos. Un nodo de fusión los combina en un solo elemento.
  2. PDF4me Rellene un PDF El formulario está configurado con PDF Tipo de datos de entrada Binary Data (Campo binario PDF establecido al PDF nombre del campo) y Seleccionar tipo de entrada JSON, Tipo de entrada de datos del formulario Binary Data (Campo binario de datos de formulario establecido al JSON nombre del campo).
  3. El lleno PDF se guarda con el pedido ID como nombre de archivo.
Editable rellenado PDF para que un destinatario complete
  1. A CRM La actualización activa el flujo de trabajo cuando se crea un nuevo cliente.
  2. PDF4me Rellene un PDF El formulario rellena previamente los campos conocidos por el cliente en un formulario de incorporación (nombre, correo electrónico, ID de cuenta) utilizando Seleccionar tipo de entrada JSON.
  3. Mantener PDF Editable Está activado para que el cliente pueda completar los campos opcionales restantes.
  4. Un Outlook El nodo envía correos electrónicos prellenados y editables PDF con un recordatorio de fecha límite.

Consejos prácticos

Wrong field names are the #1 cause of empty output
Run Extract Form Data From PDF on the template first to get the exact list. Names are case-sensitive and usually have no spaces (firstname, not First Name).
"No binary data found" errors
Double-check PDF Binary Field and Form Data Binary Field names. The Merge node in a fan-in workflow can rename binary properties.
Prefer JSON for many or dynamic fields
Input Form Data is great for 2-3 hardcoded fields, but JSON scales better and works naturally with expressions from previous nodes.
Keep PDF Editable only when needed
Default off flattens the form, which is the right choice when the filled PDF is a final record. Turn on only when the recipient needs to add or change values.
Form Data (JSON) is one object only
Send a single object, not an array of records. An array of one is unwrapped; multiple objects fail. To fill many PDFs in one run, wrap this node in Loop Over Items.
No AcroForm fields means nothing to fill
A flat scan with no fields cannot be filled. Use Add Form Fields To PDF first to add fillable fields before calling Fill a PDF Form.

Hoja de trucos

CampoValor
ResourceForms
OperationFill a PDF Form
PDF Input Data TypeBinary Data
PDF Binary Fielddata
Select Input TypeJSON
Form Data Input TypeJSON String
Form Data (JSON){"firstname":"John","lastname":"Doe","email":"[email protected]"}
Output File Namefilled_form_output.pdf
Keep PDF EditableOff
Binary Data Output Namedata
CredentialsPDF4me API credential

Preguntas frecuentes

What is the difference between JSON and Input Form Data?+
JSON sends one stringified object via the API dataArray field. Keys are PDF field names and values are what to fill. Best for many fields, dynamic data mapped from previous nodes, or workflows that already produce JSON. Input Form Data adds one UI row per field with Field Name and Field Value. Best for a small fixed set of fields configured manually in the n8n editor.
How do I know the exact AcroForm field names?+
Run PDF4me Extract Form Data From PDF on the template first. The output is the exact list of field names you can use as keys in Form Data (JSON) or as Field Name rows in Input Form Data. Or inspect the PDF in Adobe Acrobat (Prepare Form) and read the field names from the properties panel. Field names are case-sensitive.
What does Keep PDF Editable do?+
Off (default) flattens the form into static text in the output PDF. Useful when the filled PDF is a final, locked record of what was submitted. On preserves AcroForm field definitions in the output so the recipient can re-edit values in any PDF viewer. Turn it on only when the recipient needs to add or change values after automation.
Can I send an array of multiple objects in Form Data (JSON)?+
No. The node expects a single object. An array containing one object is unwrapped automatically as a convenience. Arrays of multiple objects are rejected. To fill many PDFs in one execution, wrap this node in a Loop Over Items and call it once per object.
Why are some fields blank in the output PDF?+
Almost always because the keys you sent did not match the AcroForm field names exactly. Field names are case-sensitive and often have no spaces or capital letters (firstname instead of First Name). Confirm the exact names with Extract Form Data From PDF before mapping your data.
What happens with a flat PDF that has no form fields?+
Nothing fills. This node populates existing AcroForm fields; it does not create them. For a flat scan or a PDF with visual placeholders only, run Add Form Fields To PDF first to add fillable fields, then call Fill a PDF Form.
How do I send the PDF as base64 with a data: prefix?+
The node strips data-URL prefixes (data:application/pdf;base64,) automatically when you paste them into PDF Base64 Content, so it works either way.
Can I get a non-PDF output (e.g. PNG of the filled form)?+
No. This endpoint outputs PDF only. To rasterize the filled PDF into PNG or JPEG, chain a downstream PDF4me Convert PDF to Image action after Fill a PDF Form.

Acciones relacionadas

La misma tarea en otras plataformas

Obtén ayuda