¿Cuándo necesitas un PDF en Base64?
JSON, XML y muchos formularios solo pueden transportar texto, así que un archivo binario como un PDF tiene que escribirse primero como texto. Base64 es la forma habitual de hacerlo:
- Enviar un documento a una API. Los servicios de factura electrónica, firma electrónica, envíos y gestión documental suelen pedir el PDF en un campo llamado content, file o data.
- Probar tu propia integración. Con la opción JSON obtienes un cuerpo de petición listo para pegar en Postman, curl o una prueba unitaria, sin escribir código de codificación.
- Guardarlo en una columna de texto o en una configuración. Algunos sistemas almacenan plantillas o certificados pequeños como texto; Base64 permite que el PDF quepa ahí.
- Incrustarlo en una página web. Un data URI permite que una página muestre un PDF en un iframe sin alojar un archivo aparte; es adecuado para documentos pequeños.
Tienes ejemplos de peticiones paso a paso con curl, JavaScript y Python en Cómo enviar un PDF a una API en Base64. Para convertir el código de nuevo en un archivo, usa Base64 a PDF; para imágenes, consulta Imagen a Base64.
Cómo es cada formato
| Formato | Empieza por | Uso habitual |
|---|---|---|
| Solo el código Base64 | JVBERi0 | Campos de API, JSON, XML, bases de datos |
| Data URI | data:application/pdf;base64, | Pestaña del navegador, iframe, etiqueta object |
| Líneas de 76 caracteres | JVBERi0, dividido en líneas cortas | Adjuntos de correo (MIME), archivos de estilo PEM |
| JSON | { "fileName": … } | Cuerpo de petición para probar una integración |
Si algo sale mal
"Este archivo no es un PDF válido". El archivo no empieza con la firma %PDF-; puede ser un archivo de Word o una imagen a la que se le cambió la extensión a .pdf. Ábrelo primero en un lector de PDF o conviértelo con la herramienta adecuada.
La API dice que el contenido no es válido. Comprueba que enviaste el código sin el prefijo data: y sin saltos de línea, salvo que la documentación los pida. Asegúrate también de que no se cortó nada al final al pegarlo.
El texto es demasiado largo para el campo. Reduce el PDF con Comprimir PDF y vuelve a convertirlo; el código se reduce en la misma proporción.