← Back to all articles

Dostupnost PDF/UA-1, ve výchozím stavu zapnutá, přes API

SealDoc Team · · 4 min read

Evropský akt o přístupnosti (Směrnice 2019/882) je v platnosti od 28. června 2025. Už to není téma “vyřešíme později”. Banky, telco operátoři, e-commerce firmy s obratem nad 10 mil. €, portály veřejného sektoru a poskytovatelé audiovizuálních médií musí každý PDF určený zákazníkům dodávat ve formě, kterou je schopen procházet uživatel čtečky obrazovky. Pokuty se liší podle členského státu, ale v NL a DE dosahují 100 000 € za porušení. Směrnice odkazuje na EN 301 549, která odkazuje na ISO 14289-1, tedy PDF/UA-1.

SealDoc produkuje archivy PDF/A-3 už dva roky. Přidání PDF/UA-1 do téhož výstupu bylo dlouho v plánu; mandát EU to posunul z “užitečného” na “nosné pro naše compliance pozicování”. Ode dneška může každý dokument, který SealDoc generuje, vyjít jako otagovaný hybrid PDF/A-3u přístupný čtečkám obrazovky, odesláním jediného dalšího pole v požadavku.

Co se mění

POST /api/documents/generate a POST /api/invoices/generate nyní přijímají pole accessibilityLevel. Výchozí hodnota je "None", což zachovává bytový výstup stávajícího toku. Nastavte ji na "PdfUa1" a konvertor přepne cestu: export taggovaného PDF se stromem struktury, identifikátor metadat PDF/UA-1 a post-flight kontrola veraPDF proti 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% DPH",
  "lines": [ ... ],
  "accessibilityLevel": "PdfUa1"
}

Odpověď je stejný tvar jobId, který už znáte. PDF, které si pak můžete stáhnout, má strom struktury, alternativní texty tam, kde je to relevantní, správně otagované hlavičky tabulek a atribut jazyka. Čtečka obrazovky, která jím prochází, oznámí “Faktura 2026-001. Příjemce: Acme Corp. Mezisoučet: 1750 eur” namísto “Faktura 2026 001 Acme Corp 1750”.

Co jsme změřili

Před zapnutím flagu jsme nechali projít korpus 12 dokumentů přes nový pipeline a každý výstup zvalidovali proti verapdf -f ua1. Korpus pokryl minimální dokumenty, jednoduché a složité faktury, vícejazyčné odstavce, obsah bohatý na Unicode, hluboce vnořené nadpisy, holé tabulky, tabulky se správnými hlavičkami, vnořené seznamy a dlouhý dokument s 50 sekcemi.

Výsledky: 8 z 12 dokumentů prošlo všemi 106 pravidly ISO 14289-1. Zbylé 4 prošly 105 ze 106 se stejným jediným selháním (klauzule 7.4.2, vnořování nadpisů), způsobeným tím, že HTML importer LibreOffice povyšuje první <h1> na metadata Title dokumentu. Naše šablona faktury v InvoiceHtmlBuilder používá stylované odstavce místo mixu nadpisů <h1>/<h2>, takže tento případ se neprojevuje. Reprezentativní faktura dosahuje v novém pipelinu 106/106 s 2778 jednotlivými kontrolami veraPDF, které všechny projdou.

Proč na tom strategicky záleží

Evropský akt o přístupnosti je typ regulace, která vytváří panická nákupní okna. Compliance officeři aktivně hledají právě teď, zralost dodavatelů je nerovnoměrná, a většina existujících možností jsou desktopové nástroje (axesPDF Quickfix), Java knihovny s enterprise licencí (iText s modulem Pdf/UA) nebo manuální remediation služby účtované za dokument. Žádná z nich není API-first, žádná neprodukuje hybrid PDF/A-3 + PDF/UA-1 ve stejném volání, a žádná není suverénní EU svou konstrukcí.

Postavili jsme naši verzi na nativním exportu taggovaného PDF v LibreOffice a open-source validátoru Universal Accessibility od veraPDF. Žádná komerční knihovna není v hře. Marginální infrastrukturní náklad nad naším stávajícím pipelinem PDF/A-3 je zanedbatelný. Můžeme to dodávat za naše stávající cenové body bez dopadu na marži.

Co je v rozsahu a co ne

V rozsahu: dokumenty a faktury, které SealDoc generuje sám ze strukturovaného vstupu (Markdown, HTML nebo invoice JSON). Struktura šablony je pod naší kontrolou, konverzní cesta je pod naší kontrolou, a kvalitu výstupu můžeme garantovat.

Zatím ne v rozsahu: auto-remediation libovolných nahraných PDF. Vzít 30-stránkový prospekt vytvořený grafikem v InDesignu před pěti lety a odvodit z něj sémantickou strukturu z heuristiky rozvržení je víceměsíční výzkumný problém s nejistou kvalitou výstupu. Neslibujeme nic, co nemůžeme dodat. Pokud to potřebujete: kontaktujte nás, existují partnerské integrace, které tu dávají smysl.

Úroveň plánu

PDF/UA-1 je funkce Growth-a-výše (slug pdf_ua v sadě funkcí vašeho plánu). Úrovně Developer a Starter nadále dostávají netaggovaný PDF/A-3 ve výchozím stavu. Flag je odmítnut s 402 Payment Required, pokud váš plán neobsahuje, s upgrade-cílem pojmenovaným v odpovědi, aby váš klientský SDK mohl odkázat na správnou stránku.

Pokud jste na Starter a enterprise klient od vás žádá přístupné faktury: to je Growth konverzace, a rádi ji povedeme.

Ověřit si to sami

Každý výstup PDF/UA-1 ze SealDoc projde stejným validátorem verapdf -f ua1, který členské státy EU citují ve svých compliance auditech. Stáhněte si vygenerované PDF, spusťte veraPDF lokálně, a uvidíte stejný řádek passedRules="106" failedRules="0", který publikujeme v našich interních benchmarkech. Nežádáme vás, abyste marketingové tvrzení přijímali na důvěru; validátor je open source, norma je publikovaná ISO, a výstup je binárně reprodukovatelný na žádost.

Sprint 53 dodává PDF/UA-1 dnes. Sprint 53 byl odhadnut na šest a půl dne inženýrské práce. Vešli jsme se pod rozpočet, protože stávající konverzní pipeline už dělal většinu práce; marketingové tvrzení “jediné suverénní API EU dodávající Factur-X 1.0 plus PDF/UA-1 v jednom volání” je nyní skutečně pravdivé a validované.

← Back to all articles