API de PDF/A para generación de PDF de archivo
Genere salida PDF/A desde solicitudes JSON Render para flujos de archivo, con límites claros entre perfiles PDF/A y empaquetado de factura electrónica.
/api/v1/pdf/render Generar salida con perfil PDF/A desde solicitudes de documento estructuradas cuando un flujo empresarial necesita PDF aptos para archivo, eligiendo E-Invoice Render solo cuando se requiera empaquetado de factura con XML incrustado.
Cuándo usar esta API
- Su flujo necesita seleccionar un perfil PDF/A en los ajustes de renderizado.
- Necesita salida de archivo para facturas, estados, informes o documentos.
- Quiere una página PDF/A general, más amplia que el empaquetado de factura electrónica PDF/A-3b.
- Puede validar el archivo producido con su propio flujo de aceptación de archivo.
Qué no sustituye
- Necesita Factur-X o ZUGFeRD con XML CII EN 16931 incrustado. Use E-Invoice Render.
- Necesita un flujo solo de validación. Use las páginas del validador como contexto de validación.
- Necesita salida cifrada y PDF/A en la misma solicitud. La API pública Render trata los ajustes de seguridad y los perfiles PDF/A como mutuamente excluyentes.
Qué endpoint llamar
/api/v1/pdf/render
JSON Render es la ruta predeterminada para este flujo.
/api/v1/e-invoice/render
Úsalo cuando el flujo necesite la ruta API relacionada, un contrato de plantilla o una consulta de capacidades.
Solicitud mínima
POST /api/v1/pdf/render - ajuste de salida PDF/A ordinaria.
{
"settings": {
"profile": "pdfa-2b"
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Archive-ready document",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Qué gestiona gPdf
- Ajustes de perfil PDF/A en solicitudes JSON Render.
- Renderizado de documentos con texto, tablas, imágenes, códigos de barras, metadatos y salida de perfil.
- Empaquetado de factura electrónica PDF/A-3b solo mediante la ruta E-Invoice Render.
- Respuesta PDF binaria con comportamiento de error compartido.
Qué controla su sistema
- Política de archivo, selección de perfil, flujo de validación, retención y aceptación legal.
- Semántica del documento, datos empresariales y cualquier evidencia externa requerida.
- Almacenamiento, control de acceso y política futura de migración.
Checklist de producción
- Seleccione el perfil PDF/A requerido por su archivo o cliente.
- Pase la salida por su validador y su flujo de aceptación de retención.
- Mantenga PDF/A y ajustes de seguridad en flujos de renderizado separados salvo que la documentación pública añada un contrato compatible.
- Use E-Invoice Render cuando se requiera XML CII incrustado.
- Guarde los datos fuente o el PDF devuelto según su política de retención.
Límites de la promesa
- La salida PDF/A no es lo mismo que el empaquetado legal de factura electrónica.
- gPdf no sustituye su flujo de aceptación de archivo ni sus validadores.
- Su sistema conserva la interpretación de retención y cumplimiento.
PDF/A es una elección de perfil
Para documentos de archivo ordinarios, PDF/A se selecciona mediante ajustes de renderizado. Esto mantiene el flujo cerca de JSON Render: su sistema describe el documento y define el perfil que necesita.
El empaquetado de factura electrónica es distinto. Cuando el documento necesita Factur-X o ZUGFeRD con XML CII incrustado, use el endpoint E-Invoice Render.
FAQ
- ¿Qué endpoint debo usar para salida PDF/A general?
- Use POST /api/v1/pdf/render con el valor settings.profile adecuado para salida PDF/A ordinaria.
- ¿Cuándo necesito E-Invoice Render?
- Use E-Invoice Render cuando el documento deba ser un paquete Factur-X o ZUGFeRD PDF/A-3b con XML CII incrustado.
- ¿gPdf valida la aceptación de archivo?
- No. gPdf renderiza salida PDF/A. Su sistema debe validar la salida contra la política de aceptación del archivo o del cliente.
- ¿PDF/A puede combinarse con ajustes de seguridad?
- No en la API pública Render actual. settings.profile y settings.security son mutuamente excluyentes, y las combinaciones inválidas fallan la validación.