Accesibilidad PDF/UA-1 vía API

La Directiva Europea de Accesibilidad (Directiva 2019/882) se aplica desde el 28 de junio de 2025 a los productos y servicios enumerados, como la banca de consumo, el e-commerce y las comunicaciones electrónicas; las microempresas que prestan servicios (menos de 10 empleados y un volumen de negocios o balance de hasta 2 millones de euros) están exentas. Ya no es un tema “lo veremos más adelante”. Los proveedores incluidos deben entregar cada PDF dirigido al cliente en una forma navegable por un usuario de lector de pantalla. Las sanciones varían por estado miembro; en Alemania alcanzan los 100 000 € por infracción (BFSG § 37). Para PDF, la norma ISO de accesibilidad es ISO 14289-1, es decir PDF/UA-1.

Añadir PDF/UA-1 a la misma salida estaba desde hace tiempo en la hoja de ruta; el mandato de la UE lo movió de “útil” a “soporte para nuestro posicionamiento de compliance”. A partir de hoy, cada documento que SealDoc genera puede salir como un híbrido PDF/A-3u etiquetado y compatible con lectores de pantalla, enviando un campo adicional en la solicitud.

Qué cambia

POST /api/documents/generate y POST /api/invoices/generate ahora aceptan un campo accessibilityLevel. El valor por defecto es "None", que preserva la salida byte-exacta del flujo existente. Establézcalo en "PdfUa1" y el conversor cambia de ruta: exportación PDF etiquetado con árbol de estructura, identificador de metadatos PDF/UA-1 y un control post-vuelo de veraPDF contra ISO 14289-1.

POST /api/invoices/generate HTTP/1.1
Host: api.sealdoc.eu
X-Api-Key: ...
Content-Type: application/json

{
  "seller": { "name": "FeFem Holding B.V.", "vatNumber": "NL000000000B01", ... },
  "buyer": { "name": "Acme Corp", ... },
  "invoiceNumber": "INV-2026-001",
  "invoiceDate": "2026-05-07",
  "currency": "EUR",
  "vatRate": 0.21,
  "vatLabel": "21% IVA",
  "lines": [ ... ],
  "accessibilityLevel": "PdfUa1"
}

La respuesta tiene la misma forma jobId que ya conoce. La PDF que puede descargar a continuación tiene un árbol de estructura, textos alternativos donde corresponde, encabezados de tabla correctamente etiquetados y un atributo de idioma. Un lector de pantalla que la recorre anuncia “Factura 2026-001. Cliente: Acme Corp. Subtotal: 1750 euros” en lugar de “Factura 2026 001 Acme Corp 1750”.

Lo que medimos

Antes de activar el flag, hicimos pasar un corpus de 12 documentos por la nueva pipeline y validamos cada salida contra verapdf -f ua1. El corpus cubre documentos mínimos, facturas simples y complejas, párrafos multilingües, contenido con mucho Unicode, encabezados profundamente anidados, tablas sin encabezados, tablas con encabezados correctos, listas anidadas y un documento largo de 50 secciones.

Resultados: 8 de 12 documentos pasaron las 106 reglas ISO 14289-1. Los 4 restantes pasaron 105 de 106 con el mismo único fallo (cláusula 7.4.2, anidamiento de encabezados), causado por el importador HTML de LibreOffice que promueve el primer <h1> a metadato Title del documento. Nuestra plantilla de factura en InvoiceHtmlBuilder usa párrafos estilizados en lugar de mezcla de encabezados <h1>/<h2>, así que ese caso no aplica. Una factura representativa obtiene 106/106 en la nueva pipeline con 2778 verificaciones individuales de veraPDF que pasan todas.

Por qué esto importa estratégicamente

La Directiva Europea de Accesibilidad es el tipo de regulación que crea ventanas de compra de pánico. Los responsables de compliance están buscando activamente ahora, la madurez de los proveedores es desigual, y la mayoría de las opciones existentes son herramientas de escritorio (axesPDF Quickfix), bibliotecas Java con licencia empresarial (iText con el módulo Pdf/UA) o servicios de remediación manual facturados por documento. Ninguna de esas es API-first, ninguna produce un híbrido PDF/A-3 + PDF/UA-1 en la misma llamada, y ninguna es soberana de la UE por construcción.

Construimos nuestra versión sobre la exportación PDF etiquetado nativa de LibreOffice y el validador Universal Accessibility open source de veraPDF. No hay biblioteca comercial involucrada. El coste de infraestructura marginal sobre nuestra pipeline PDF/A-3 existente es insignificante. Podemos entregar esto a nuestros puntos de precio actuales sin impacto en el margen.

Qué está en alcance

En alcance: documentos y facturas que SealDoc genera por sí mismo a partir de su entrada estructurada (Markdown, HTML o JSON de factura). La estructura de la plantilla está bajo nuestro control, y también la ruta de conversión.

Nivel de plan

PDF/UA-1 es una funcionalidad Growth-y-superior (slug pdf_ua en el conjunto de funciones de su plan). Los niveles Developer y Starter siguen recibiendo PDF/A-3 sin etiquetar por defecto. El flag se rechaza con un 402 Payment Required si su plan no lo incluye, con el destino de upgrade nombrado en la respuesta para que su SDK cliente pueda enlazar a la página correcta.

Si está en Starter y un cliente empresarial le pide facturas accesibles: esa es una conversación Growth, y la tenemos con gusto.

Validándolo usted mismo

SealDoc comprueba la salida PDF/UA-1 con veraPDF. Descargue un PDF generado y ejecute verapdf -f ua1 localmente para ver el resultado usted mismo. No le pedimos que tome la afirmación de marketing por confianza; el validador es open source, la norma está publicada por ISO, y la salida es binario-reproducible por solicitud.

Sprint 53 entrega PDF/UA-1 hoy.