Rellenar un formulario PDF
En la mayoría de las oficinas administrativas hay un formulario PDF rellenable que todavía se completa a mano, campo por campo, porque nadie lo conectó al sistema que ya tiene esos datos. Esta API para rellenar formularios PDF toma los campos AcroForm existentes de un PDF y un objeto JSON de valores, y devuelve el documento completo, para que paquetes de incorporación, solicitudes y formularios de trámites se llenen solos con datos que ya tiene.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
El formulario que nunca se automatizó
Los formularios PDF interactivos están en todas partes — las autoridades fiscales los publican, las aseguradoras los emiten, los departamentos de recursos humanos los distribuyen para incorporación — y casi todos ya tienen campos rellenables con nombre, definidos por quien diseñó el formulario. Aun así, en la práctica una enorme proporción se sigue llenando a mano, se imprime, o peor, se recrea como formulario web que hay que mantener sincronizado manualmente con el PDF original. Esa brecha existe sobre todo porque rellenar un formulario existente de forma programática exige conocer su estructura de campos, que es justo la parte que resuelve este endpoint.
Cómo funciona el llenado
Envíe el PDF de origen junto con un objeto JSON que asocia nombres de campo con valores a POST /pdf/fill-form, y la solicitud devuelve un task_id de inmediato, ya que el llenado corre de forma asíncrona. El motor hace coincidir cada clave de su JSON con los nombres reales de los campos AcroForm del formulario y escribe el valor correspondiente en campos de texto, casillas, grupos de radio y listas desplegables exactamente como el formulario los define. Los campos que no incluya simplemente quedan en blanco, así que los datos parciales nunca son un problema.
De dónde vienen los campos AcroForm
El estándar AcroForm forma parte de la especificación de PDF desde los primeros días del formato, permitiendo a quien diseña un documento colocar campos nombrados y estructurados directamente sobre la página en lugar de depender de que una persona alinee su letra dentro de casillas impresas. Esa estructura es la razón por la que un formulario construido hace décadas en una herramienta todavía se puede rellenar de forma programática hoy: los nombres y tipos de campo se guardan dentro del propio PDF, y este endpoint simplemente lee esa estructura y escribe en ella, en lugar de adivinar coordenadas sobre una imagen plana de la página.
Cómo encaja en un flujo real
Encaja de forma natural donde un sistema ya tiene datos estructurados que necesitan llegar a un formulario oficial: tomar los datos de un solicitante desde una base de datos y llenar un formulario gubernamental, tomar los datos de incorporación recolectados en un formulario web y llevarlos a un paquete PDF de recursos humanos, o generar un formulario de reclamo de seguro ya lleno directamente desde los registros de un sistema de siniestros. Como cada llenado es un solo payload JSON contra un mapa de campos conocido, es sencillo correr la misma plantilla contra miles de registros distintos en un trabajo por lote.
Entrega y precio
El PDF completado se entrega por un webhook firmado, recomendado para flujos automatizados, o un enlace firmado válido durante 24 horas; los archivos de origen, los datos de los campos y la salida se eliminan tras la ventana de retención y nunca se usan para entrenar nada. El precio es un fijo de $0.002 por solicitud sin importar cuántos campos se rellenen, y una tarea que falla tras sus reintentos nunca se cobra. Este endpoint está activo ahora mismo y listo para tráfico de producción.
Qué puede hacer con ella
Autocompletar formularios gubernamentales o fiscales desde datos guardados
Rellene un formulario PDF oficial con los datos de un solicitante o contribuyente que ya están en una base de datos, en lugar de volver a escribirlos a mano en cada envío.
Convertir datos de incorporación en un paquete de RR. HH. completo
Tome los valores que un nuevo empleado ingresó en un formulario web de incorporación y llévelos directo a los campos rellenables del PDF oficial de la empresa.
Generar formularios de reclamo de seguro completos
Rellene el formulario de reclamo de una aseguradora directamente desde los datos estructurados que ya están en un sistema de gestión de siniestros, eliminando un paso de reingreso manual.
Producir formularios de solicitud personalizados por lote
Corra la misma plantilla de PDF rellenable contra una lista de miles de registros de solicitantes, generando un documento completo y correcto por cada persona.
Preguntas frecuentes
¿Cómo relleno un formulario PDF con una API?
Envíe el PDF junto con un objeto JSON de nombres de campo y valores a POST /pdf/fill-form, que devuelve un task_id de inmediato. El formulario completo llega por webhook o enlace firmado cuando termina el procesamiento.
¿La API para rellenar formularios PDF es gratis?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿El PDF ya necesita tener campos rellenables?
Sí. Este endpoint rellena campos AcroForm existentes definidos dentro del PDF; no crea campos nuevos sobre una página plana y no interactiva.
¿Cómo sé qué nombres de campo usar en el JSON?
Los nombres de campo son los que se definieron al diseñar el formulario, coincidiendo con las etiquetas visibles en las herramientas de formulario de un editor de PDF; cualquier inspector estándar de campos AcroForm los lista.
¿Puede rellenar casillas y listas desplegables, no solo campos de texto?
Sí. Se admiten campos de texto, casillas, grupos de radio y listas desplegables, cada uno escrito según cómo el formulario define ese tipo de campo.
¿Qué pasa si dejo un campo fuera de mi JSON?
Simplemente queda en blanco en el formulario de salida, así que enviar datos parciales para registros con valores faltantes no genera ningún error.
¿Puedo rellenar la misma plantilla de formulario por lote para muchos registros?
Sí. Cada solicitud es una tarea asíncrona independiente, así que puede correr la misma plantilla de PDF contra una lista grande de payloads JSON en paralelo.
¿Este endpoint está activo ahora mismo?
Sí, está activo y acepta tráfico de producción hoy mismo.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/pdf/fill-form \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"pdf":"https://ejemplo.com/documento.pdf"}'const res = await fetch("https://api.kit.forhosting.com/pdf/fill-form", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"pdf": "https://ejemplo.com/documento.pdf"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/fill-form",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"pdf": "https://ejemplo.com/documento.pdf"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/fill-form", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"pdf":"https://ejemplo.com/documento.pdf"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"pdf":"https://ejemplo.com/documento.pdf"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/fill-form", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"pdf": "https://ejemplo.com/documento.pdf"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.fill_form",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_mb | 25 |
max_pages | 200 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
413 | input_too_large | El archivo supera el límite de tamaño. |