PDFVela — pdfvela.com
Todas las herramientas PDF

Cómo enviar un PDF a una API en Base64

Una API de facturación electrónica, firma electrónica o envíos quiere el documento en un campo JSON. Así conviertes el PDF en el texto correcto, lo compruebas y evitas los errores que hacen fallar la petición.

Por · Actualizado el 10 de noviembre de 2026

Lo que suele esperar la API

La mayoría de las API de documentos describen un cuerpo JSON con un campo llamado content, file, data o document. Su valor es el código Base64 del PDF, a menudo acompañado de un nombre de archivo y un tipo:

{
  "fileName": "invoice-1024.pdf",
  "mimeType": "application/pdf",
  "content": "JVBERi0xLjcKJ..."
}

Antes de escribir código, busca tres cosas en la documentación: el nombre del campo, si hace falta un prefijo data: (normalmente no) y el límite de tamaño.

1. Convierte el PDF a Base64

La forma más rápida de obtener un valor de prueba es PDF a Base64. Elige el PDF, selecciona Solo el código Base64 y copia el resultado. Si prefieres partir de un cuerpo de petición completo, elige JSON: agrega por ti el nombre del archivo y el tipo. El PDF se codifica en tu navegador y no se sube, algo importante cuando el documento de prueba es una factura real.

Revisa el resultado: debe empezar por JVBERi0, no tener espacios y contener solo letras, números, + y /, salvo uno o dos signos = al final.

2. Envíalo desde tu código

El mismo paso en tres lenguajes habituales. Cada ejemplo lee el archivo, lo codifica y envía el JSON:

# curl (Linux / macOS): base64 -w 0 keeps it on one line
curl -X POST https://api.example.com/documents \
  -H "Content-Type: application/json" \
  -d "{\"fileName\":\"invoice.pdf\",\"content\":\"$(base64 -w 0 invoice.pdf)\"}"
// Node.js 18+
import { readFile } from 'node:fs/promises';
const content = (await readFile('invoice.pdf')).toString('base64');
await fetch('https://api.example.com/documents', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ fileName: 'invoice.pdf', content }),
});
# Python 3 with requests
import base64, requests
with open("invoice.pdf", "rb") as f:
    content = base64.b64encode(f.read()).decode("ascii")
requests.post("https://api.example.com/documents",
              json={"fileName": "invoice.pdf", "content": content})

En macOS, la línea de curl usa base64 -i invoice.pdf en lugar de -w 0. La dirección y los nombres de los campos son ejemplos; usa los que indique la documentación de tu servicio.

3. Comprueba el viaje de ida y vuelta

Si el servicio devuelve el documento o una copia guardada en Base64, pega esa respuesta en Base64 a PDF. Ver la primera página y el número de páginas es la forma más rápida de comprobar que no se perdió nada por el camino. Los pasos detallados para hacerlo a la inversa están en Cómo guardar una cadena Base64 como archivo PDF.

Errores frecuentes

SíntomaCausa probableSolución
"Invalid Base64"Saltos de línea (líneas de 76 caracteres) o un prefijo data:Envía el código sin prefijo en una sola línea
"Payload too large" (413)El PDF es demasiado grande una vez codificadoRedúcelo con Comprimir PDF
El PDF se abre en blanco o dañadoLa cadena se cortóVuelve a codificarlo y envía el valor completo
Los nombres con tildes se ven malEl nombre del archivo se envió con una codificación incorrectaMantén el cuerpo JSON en UTF-8

¿Quieres probarlo? Es gratis y tu archivo se queda en tu dispositivo.

Abrir PDF a Base64

Preguntas sobre el envío de un PDF en Base64

¿Por qué las API piden Base64 en lugar del archivo?

JSON solo puede transportar texto. Base64 escribe los bytes del PDF con letras, números, + y /, así que el documento entero cabe en un campo de texto junto al resto de los datos, como el número de cliente o la fecha de la factura.

¿Tengo que enviar el prefijo data:application/pdf;base64,?

Normalmente no. La mayoría de las API esperan solo el código, que empieza por JVBERi0. Envía el data URI únicamente si la documentación lo muestra o si un navegador necesita una URL, por ejemplo en un iframe.

La API dice que el Base64 no es válido. ¿Cuál es la causa más habitual?

Saltos de línea o un prefijo dentro de la cadena, o un código que se cortó al pegarlo. Usa el código sin prefijo en una sola línea y comprueba que el final de la cadena llegó completo.

¿Qué tamaño puede tener el PDF?

Depende del servicio, pero el texto ocupa aproximadamente un tercio más que el archivo, así que un PDF de 3 MB se convierte en unos 4 MB de JSON. Muchas API no admiten más de unos pocos megabytes; comprimir antes el PDF es la solución más sencilla.

¿Base64 es una forma de cifrado?

No. Cualquiera que tenga el código puede convertirlo de nuevo en el documento. Envíalo solo por HTTPS y nunca pegues un PDF confidencial en un sitio web que lo suba a un servidor.