Sådan virker vedhæftninger
En samtykkeerklæring kan have vedhæftninger i form af PDF-filer, som borgeren og myndigheden kan åbne sammen med erklæringen. Filerne ligger i myndighedens eget vedhæftningsbibliotek, og erklæringen refererer dem med filens SHA-256.
Vedhæftninger er fælles materiale, fx vilkår eller en informationsfolder, og ikke dokumenter om den enkelte borger. En fil uploades én gang og kan derefter refereres af alle de erklæringer, myndigheden opretter, uden at blive uploadet igen. Vedhæftninger kræver API v4 og udvekslingsformat 2026-12 eller nyere.
Forløbet
Trin 1. Slå op, om filerne findes
Beregn SHA-256 af hver fil, og slå op i myndighedens vedhæftningsbibliotek. Svaret indeholder kun de filer, myndigheden har i forvejen, og om de er tilgængelige (PDF/UA).
Trin 2. Upload de manglende filer
Upload én PDF pr. kald. Uploaden er idempotent, så det gør ikke noget at uploade en fil, der allerede findes. En ny fil tjekkes, før den gemmes, så kaldet kan tage længere tid end de øvrige.
Svaret indeholder filens SHA-256, og om filen er tilgængelig (PDF/UA). En fil, der ikke er tilgængelig, bliver ikke afvist, men se kravene til filen.
Trin 3. Referér filerne fra erklæringen
Angiv hver vedhæftning med titel, linktitel og SHA-256 i erklæringens
Vedhaeftningsliste. En fil, myndigheden ikke har uploadet, afvises.
Trin 4. Hent vedhæftningerne igen
Når en samtykkeerklæring eller anmodning hentes, følger dens vedhæftninger med, inklusive links til at hente filerne. En fil hentes altid gennem den erklæring eller anmodning, den hører til.
Endpoints og svarkoder står i Swagger UI, og
Vedhaeftningsliste er beskrevet i XML-skemaerne.
Krav til filen
Filen skal:
- være generel og ikke indeholde oplysninger om en bestemt borger eller sag.
- være en PDF på højst 5 MB.
- være uden kryptering og adgangskode.
- være uden aktivt indhold, fx JavaScript, handlinger der udføres ved åbning, formularer, indlejrede filer, multimedier eller indhold, der hentes udefra.
- kun have links til
https://eller en e-mailadresse (mailto:).
Filen bør:
- overholde PDF/UA (ISO 14289), så borgere, der bruger skærmlæser, kan læse den.
Ubrugte filer slettes
En fil, som ingen erklæring refererer, slettes igen efter kort tid. Biblioteket er altså ikke et arkiv: upload først filen, når den skal bruges i en erklæring kort efter.
Filen slettes også, når den sidste erklæring, der refererer den, er slettet. Gem derfor ikke i jeres eget system, at en fil er uploadet, men slå den op (trin 1), før erklæringen sendes.