Fremadrettet vil releases have en fortløbende nummerering (release 5, release 6, release 7 mv.) fremfor de tidligere anvendte versioneringsnumre (fx version 1.4.0). Det er for at undgå forvirring i forhold til versionering af Digitalt Samtykke API og hop-integration.
Release 5 af Digitalt Samtykke indeholder en række forbedringer og ændringer. De største nyheder er:
- Yderligere valg (tilvalg og fravalg) på samtykker
- Vedhæftninger til anmodninger/samtykkeerklæringer
- Opdaterede detaljesider i Digitalt Samtykke til myndigheder
Yderligere valg (tilvalg og fravalg) på samtykker
- Et samtykke kan nu suppleres med yderligere valg, som borgeren tager stilling til, når samtykket gives.
- Et yderligere valg er enten et fravalg (fx at borgeren frabeder sig information om alvorlige helbredsfund) eller et tilvalg (fx at borgeren ønsker at få tilsendt information om et forskningsprojekts resultater).
- Yderligere valg opsættes på erklæringsskabelonen og er især tiltænkt til samtykke til deltagelse i sundhedsvidenskabelige forskningsprojekter og kliniske lægemiddelforsøg.
- I ‘Anmod om samtykke’ vælger medarbejderen, hvilke valgfrie yderligere valg borgeren skal tage stilling til. Obligatoriske yderligere valg er altid med.
- Ved besvarelse af anmodningen vises de yderligere valg under overskrifterne ‘Fravalg’ og ‘Tilvalg’, og borgeren markerer dem, der skal gælde. Det samme gælder, når en medarbejder hjælper borgeren med at besvare. Borgeren får kun mulighed for at tage stilling til de yderligere valg, hvis de giver mindst et samtykke i samtykkegruppen.
- Borgeren og medarbejderen kan efterfølgende se og skifte de yderligere valg på samtykkegruppedetaljesiden, fx fra ‘Fravalgt’ til ‘Ikke fravalgt’. Hvilke skift medarbejderen og borgeren kan foretage, afhænger af opsætningen i erklæringsskabelonen. Et skift udløser Digital Post-beskeder på samme måde som tilbagekaldelse af et samtykke.
- Der er i opsætningen af erklæringsskabelonen mulighed for at sætte udløbsdato på yderligere valg.
- Når en samtykkeerklæring lukkes, ugyldiggøres alle yderligere valg i samtykkeerklæringen.
- ‘Find borgers samtykker’ i Digitalt Samtykke har fået to nye faner (Fravalg og Tilvalg), der vises, når der indgår yderligere valg i søgeresultatet.
- Yderligere valg fremgår af PDF-kopier af samtykkeerklæringen og understøttes i Digitalt Samtykke API og hop-integration, jf. afsnittene nedenfor.
Vedhæftninger på anmodninger og samtykkeerklæringer
- Afsenderen kan nu vedhæfte op til 3 PDF-filer på en erklæringsskabelon, fx deltagerinformation om et forskningsprojekt, så borgeren kan læse informationen, inden anmodningen besvares, og finde den igen, når samtykket er givet. En PDF-fil må højst fylde 5 MB.
- Medarbejderen ser vedhæftningerne på opsummeringstrin i ‘Anmod om samtykke’ og på anmodnings- og erklæringsdetaljesiden. Vedhæftningerne følger erklæringsskabelonen og kan ikke til- eller fravælges pr. anmodning.
- Borgeren ser vedhæftningerne i sektionen ‘Vedhæftet af afsenderen’ på det nye trin ‘Inden du besvarer anmodningen’ og senere på samtykkegruppedetaljesiden under ‘Vigtig information’. Vedhæftningerne åbnes i en ny fane, og det er ikke et krav at åbne dem for at kunne svare.
- PDF-kopier af samtykkeerklæringen og anmodningen lister vedhæftningernes titler. Vedhæftningerne kan også hentes via Digitalt Samtykke API og vedhæftes udvalgte Digital Post-beskeder.
- Bemærk, at myndigheden selv er ansvarlig for, at de vedhæftede PDF-filer overholder kravene til webtilgængelighed.
Forbedringer af Digitalt Samtykke til myndigheder
- Valg af myndighed: Medarbejdere med adgang til flere myndigheders samtykkedata vælger nu myndighed på første trin i ‘Anmod om samtykke’ og i ‘Find borgers samtykker’. Myndighedens CVR-nummer indgår ikke længere i adresserne i Digitalt Samtykke til myndigheder. Medarbejdere med adgang til én myndighed oplever ingen ændring, og eksisterende links med CVR-nummer virker fortsat.
- Login: Medarbejderen kan vælge at få sin login-metode (NemLog-in eller Fælleskommunal Adgangsstyring) husket til næste gang, og i links til Digitalt Samtykke til myndigheder kan det angives, hvilken login-metode der skal bruges.
- Opdaterede detaljesider: Nyt design af detaljesiderne for anmodning, samtykkeerklæring og samtykkegruppe for at sikre konsistens i information og opbygning. Siderne har blandt andet fået tydeligere overskrifter, handlingsknapper øverst og information samlet i sektioner.
- Begrænsning af CPR-opslag: Af sikkerhedshensyn er der indført grænser for en medarbejders CPR-opslag. Overskrides grænsen, får medarbejderen besked om, hvornår der igen kan slås op.
Forbedringer af Digitalt Samtykke til borgere
- Borgeren kan nu se de anmodningsbetingelser, som afsenderen har bekræftet var opfyldt, inden anmodningen blev sendt. De vises under overskriften ‘Krav opfyldt af afsenderen’ tre steder: på det nye trin ‘Inden du besvarer anmodningen’ i besvarelsesflowet, på samtykkegruppedetaljesiden under ‘Vigtig information’ og i borgerens PDF-kopi af samtykkeerklæringen.
- Besvareren (giver 1) kan nu se sin egen besvarelse, mens den afventer bekræfteren (giver 2). Besvarelsen vises skrivebeskyttet med en infoboks om, at den afventer bekræfteren.
- Borgere med navnebeskyttelse ser nu deres rigtige navn øverst på siden i stedet for pladsholderen ‘Pseudonym’ fra NemLog-in.
Opdateringer af Digitalt Samtykke API
- Ny version 4 af Digitalt Samtykke API. Version 3 markeres som udfaset (deprecated) på linje med version 1 og 2. De udfasede versioner fungerer fortsat, men udfases på et senere tidspunkt. Det anbefales at planlægge og gennemføre migrering til API version 4.
- BREAKING CHANGE (API V1, V2, V3 og V4) ‘Anmodet af’ er påkrævet ved oprettelse af samtykkeerklæring. En samtykkeerklæring afvises nu ved oprettelse med 400 Bad Request, hvis AnmodetAf mangler, selvom skemaet angiver elementet som valgfrit. AnmodetAf skal angive medarbejderens Navn og LoginId.
- BREAKING CHANGE (API V1, V2, V3 og V4) Hvert samtykke skal have en brugervendt overskrift ved oprettelse af samtykkeerklæring. En samtykkeerklæring afvises nu ved oprettelse med 400 Bad Request, hvis et samtykke mangler BrugervendtTekst med en Overskrift, også når samtykket er afvist.
- BREAKING CHANGE (API V4) Ny skemaversion 2026-12 af udvekslingsformatet for samtykkeerklæringer og af skemaet for samtykkeerklæringsskabeloner. Skemaerne understøtter vedhæftninger (Vedhaeftningsliste) og yderligere valg (YderligereValgListe). Samtykkeerklæringer oprettet via API V4 skal overholde skemaversion 2026-12.
- BREAKING CHANGE (API V4) Hent samtykkeerklæringsskabelon returnerer nu en versionsoversigt i JSON i stedet for den fulde skabelon som XML. Den fulde skabelon-XML hentes med nye endpoints til seneste version eller en specifik version.
- BREAKING CHANGE (API V4) Hvert samtykke i en skabelon skal have en brugervendt tekst. I skemaversion 2026-12 for samtykkeerklæringsskabeloner skal en SamtykkeSkabelon have elementet BrugervendtTekstSkabelon med en Overskrift, som ikke må være tom, på højst 160 tegn, og et valgfrit Indhold på højst 500 tegn. Teksten bruges, når borgeren afviser samtykket, og når samtykket ikke har valgmuligheder.
- BREAKING CHANGE (API V4) Feltnavne på anmodninger er ensrettet med resten af API’et og XML-skemaet: ‘oprettetAf’ hedder nu ‘anmodetAf’, og ‘oprettelsesDato’ hedder nu ‘anmodningsTidspunkt’.
- BREAKING CHANGE (API V4) Borgernes navne er fjernet fra samtykkeerklæringens XML. Borger under Subjekt, BesvaretAf og BekraeftetAf har ikke længere Navn. Borgeren angives kun med CPR eller CprUUID, og et Navn giver en skemafejl.
- BREAKING CHANGE (API V4) Overskrifter i samtykkeerklæringens HTML-felter skal starte med h4 og må ikke springe niveauer. Oprettelse af samtykkeerklæring afvises med en fejlbesked pr. overtrædelse . V1, V2 og V3 accepterer fortsat samme indhold.
- Nye endpoints i API V4 til upload og opslag af vedhæftninger i myndighedens vedhæftningsbibliotek. En PDF uploades én gang og refereres fra samtykkeerklæringen med filens SHA-256. Anmodninger og samtykkeerklæringer viser deres vedhæftninger, og den enkelte vedhæftning kan hentes som PDF.
- Yderligere valg i API V4: Ved oprettelse af anmodning kan det angives, hvilke valgfrie yderligere valg der medtages; obligatoriske medtages altid. Nye endpoints til søgning i og opslag af yderligere valg, og samtykkegruppen på et samtykke indeholder nu også gruppens yderligere valg. Status på et yderligere valg kan skiftes via API’et, og ved lukning af en samtykkeerklæring kan det angives, om erklæringens yderligere valg også skal ugyldiggøres.
- Nyt endpoint til login med klientcertifikat (mTLS): Et anvendersystem, der er registreret under en myndighed, kan autentificere sig med sit OCES-certifikat og få et token med rollen tredjepartsanmoder. Rollen giver adgang til at hente erklæringsskabeloner samt oprette og annullere anmodninger, afgrænset til de skabeloner anvendersystemet er registreret til. Et anvendersystem kan kun annullere anmodninger, det selv har oprettet (API V4, oprettelse også via V3).
- 'Anmodet af' på en anmodning kan nu også bære en organisation og et system (API V4).
- Dokumentationssiden til Digitalt Samtykke API er omlagt: /docs er nu en fælles indgang med dokumentation af Digitalt Samtykke API under /docs/api (versioner, adgangsvejledning, XML-skemaer, release notes og Swagger) og af hop-integration under /docs/hop. Endpoints, der kan kaldes med certifikat-login, er markeret i dokumentationen. I præproduktionsmiljøet tilgås dokumentationen via dette link: https://api-pp-digitaltsamtykke.ssl.digst.dk/docs/api
Ændringer og forbedringer af hop-integration
- Dokumentationen af hop-integration findes nu på API-dokumentationssiden med beskrivelse af de enkelte integrationer, OpenAPI-kontrakt, release notes og en demo-app, der kan bruges til test. I præproduktionsmiljøet tilgås dokumentationen via dette link: https://api-pp-digitaltsamtykke.ssl.digst.dk/docs/hop
- BREAKING CHANGE Den usignerede variant af hop-integration til borgers besvarelse af anmodning er fjernet. Fremover understøttes kun den signerede og krypterede variant.
- BREAKING CHANGE Som varslet i release notes til version 1.3.0 og 1.4.0 er Subject1Cpr fjernet fra hop-integration til ‘Anmod om samtykke’. SubjectCpr skal anvendes i stedet.
- BREAKING CHANGE Adgang til erklæringsskabeloner i de signerede forløb styres nu af, hvilke skabeloner anvendersystemets certifikat er registreret til hos myndigheden. Kontakt Digitaliseringsstyrelsen for at få jeres anvendersystem sat op.
- BREAKING CHANGE Digital Post-status returneres kun til myndighedens egne anvendersystemer.
- BREAKING CHANGE Fejlrettelse: RedirectionUrl skal være https i bekræft-forløbet.
- Angives samme CPR-nummer i Consenter1Cpr og SubjectCpr ved hop-integration til ‘Anmod om samtykke’, vises nu en valideringsfejl, som medarbejderen skal rette. Tidligere blev Consenter1Cpr fjernet uden besked.
- Ved hop-integration til ‘Anmod om samtykke’ kan det angives, hvilken myndighed der skal være forhåndsvalgt, når medarbejderen har adgang til flere myndigheder. De medarbejdervendte integrationspunkter tager imod parameteren idp (NemLogin eller FkaLogin), der forudvælger medarbejderens login-metode.
- Mere robust overførsel af brugeren: Integrationspunkterne svarer på HEAD, så anvendersystemet kan tjekke forbindelsen, før brugeren sendes videre, og Digitalt Samtykke tjekker på samme måde RedirectionUrl, inden borgeren sendes tilbage.
- Brugerens brug af tilbage-knappen, genindlæsning og lukning af browseren under viderestillingen håndteres bedre, og uden for produktion vises konkrete fejlbeskeder ved afviste kald.
- Anmodninger startet i det signerede forløb stemples med anvendersystemets organisationsnavn som ‘Anmodet af’ på anmodningen og samtykkeerklæringen.
- I det signerede besvarelsesforløb kan fagsystemet pr. trin angive, hvilke valgfrie yderligere valg anmodningen medtager (AdditionalChoices). Obligatoriske yderligere valg medtages altid.
- Svaret i signerede forløb signeres med det certifikat, anvendersystemet krypterede til, og JWS-headeren angiver certifikatet (x5t#S256). Det har betydning i perioder, hvor Digitalt Samtykke har to gyldige systemcertifikater.
Forbedringer af Digitalt Samtykke til administratorer
- Driftsmeddelelser kan målrettes Digitalt Samtykke til borgere, Digitalt Samtykke til
myndigheder eller begge. Standard er begge. - Anvendersystemer: På et anvendersystem (certifikat) under en myndighed angives nu organisationsnavn (obligatorisk), hvilke erklæringsskabeloner anvendersystemet må benytte, og om samtykkeerklæringen skal sendes retur i hop-svaret. Et registreret anvendersystem kan logge ind i Digitalt Samtykke API med sit certifikat som tredjepartsanmoder og oprette anmodninger på vegne af myndigheden.
- Automatisk sletning af samtykkeerklæringer: Pr. myndighed angives, hvor mange måneder der skal gå, fra alle samtykker i en samtykkeerklæring er blevet inaktive (og alle yderligere valg er udløbet eller blevet gjort ugyldige), til erklæringen slettes automatisk. Standard er 36 måneder. Sletningen sker i et natligt job, og id på de slettede erklæringer og samtykker auditlogges.
Øvrige ændringer
- Vandmærke på det enkelte testmiljø, så det er let at se hvilke testmiljø, som man benytter
- Erklæringsskabeloner: Brugervendt tekst skal nu også angives på samtykker uden valgmuligheder, så simple samtykker og samtykker med valgmuligheder følger samme model.
- Det registreres på anmodninger og samtykkeerklæringer, hvilken medarbejder eller hvilket anvendersystem der har oprettet dem, så oplysningen kan ses i hele deres levetid og ikke kun i auditloggen.
- Opdatering af sikkerhed på health endpoint.
- Opgradering til version 4 af CPR GraphQL-tjenesten på Datafordeleren.
- Opdatering til Det Fælles Designsystem version 11.3.0.