Accesibilidad PDF/UA-1, activada por defecto, vía API

La Directiva Europea de Accesibilidad (Directiva 2019/882) está en vigor desde el 28 de junio de 2025. Ya no es un tema “lo veremos más adelante”. Bancos, telcos, empresas de e-commerce con facturación superior a 10 M€, portales del sector público y proveedores de medios audiovisuales 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 pero alcanzan los 100 000 € por infracción en NL y DE. La directiva remite a EN 301 549, que remite a ISO 14289-1, es decir PDF/UA-1.

SealDoc lleva dos años produciendo archivos PDF/A-3. 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 y qué no

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, la ruta de conversión está bajo nuestro control, y podemos garantizar la calidad de salida.

Aún no en alcance: auto-remediación de PDFs arbitrarios subidos. Tomar un folleto de 30 páginas creado por un diseñador gráfico en InDesign hace cinco años e inferir su estructura semántica a partir de heurísticas de diseño es un problema de investigación de varios meses con calidad de salida incierta. No prometemos lo que no podemos entregar. Si lo necesita: contáctenos, hay integraciones de socios que tienen sentido aquí.

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

Cada salida PDF/UA-1 de SealDoc pasa el mismo validador verapdf -f ua1 que los Estados miembros de la UE citan en sus auditorías de compliance. Descargue un PDF generado, ejecute veraPDF localmente, y verá la misma línea passedRules="106" failedRules="0" que publicamos en nuestros benchmarks internos. 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. Sprint 53 estaba estimado en seis días y medio de trabajo de ingeniería. Quedamos por debajo del presupuesto porque la pipeline conversora existente ya hacía la mayor parte del trabajo; la afirmación de marketing “la única API soberana de la UE que entrega Factur-X 1.0 más PDF/UA-1 en una sola llamada” ahora es realmente cierta y está validada.