Breaking changes
Anvendersystemet styrer nu skabelonadgang og HOP-opsætning
Anvendersystem-konceptet på en myndighed er udvidet: for de signerede forløb afgøres adgangen til en samtykkeerklæringsskabelon nu alene af, hvilke skabeloner det kaldende anvendersystems certifikat er registreret til.
Samtidig er opsætningen af, om samtykkeerklæringens XML skal vedhæftets i HOP-svaret efter afsluttet forløb, flyttet fra skabelonen til den enkelte registrering. Den konfigureres derfor nu pr. anvendersystem og skabelon, og to anvendersystemer kan have forskellig opsætning på samme skabelon.
Sådan kommer I videre
Kontakt Digitaliseringsstyrelsen for at få skabelonerne jeres anvendersystem benytter konfigureret korrekt.
Feltet Subject1Cpr er fjernet
Når en medarbejder sendes videre til opret-anmodning-siden, angives CPR-nummeret
på den person, samtykket handler om, udelukkende i SubjectCpr. Det tidligere
navn Subject1Cpr blev bevaret som en overgangsordning og tages ikke længere imod.
POST /api/Integration/ConsentRequestParameters
Subject1Cpr — erstattet af
SubjectCpr, som har samme format og betydning.
Fejlrettelse: RedirectionUrl skal være https i bekræft-forløbet
RedirectionUrl skal være en https-adresse. Besvar-forløbet har altid afvist
andet, men bekræft-forløbet (Giver 2) tog fejlagtigt imod en http-adresse. Det afvises nu
med 400 på fejlsiden, ligesom i besvar-forløbet.
POST /api/Integration/{tenantCvr}/SignedConsentResponseParameters/Confirm
Samtykkeerklæringens XML i HOP-svaret er nu i skemaversion 2026-12
Er anvendersystemet sat op til at få samtykkeerklæringens XML vedhæftet i HOP-svaret efter afsluttet forløb, følger XML'en nu udvekslingsformatet i skemaversion 2026-12 (tidligere 2026-06). Navnerummene skifter tilsvarende, så en modtager, der validerer mod 2026-06, skal opdateres.
XML'en kan nu have det valgfrie element Vedhaeftningsliste med erklæringens
vedhæftninger, og hver samtykkegruppe det valgfrie element YderligereValgListe med
de yderligere valg, borgeren har forholdt sig til ved afgivelse af samtykke, og borgerens status
på hvert valg (Valgt eller IkkeValgt). Et valg har desuden et valgfrit
GyldigtTil, når valget udløber eller er lukket; for et lukket valg er det lukketidspunktet.
AnmodetAf under Anmodning er nu altid med og har en ny struktur:
en medarbejder ligger i et Medarbejder-element med Navn og
LoginId (i 2026-06 lå de direkte under AnmodetAf), og et nyt
element Organisation bærer organisationsnavnet. Et HOP-forløb har ingen
medarbejder, så her indeholder AnmodetAf kun Organisation.
Elementet kan også have et System med navnet på det system, der oprettede
anmodningen; det angives ikke i et HOP-forløb.
<AnmodetAf> <sdt:Organisation>Eksempel Kommune</sdt:Organisation> </AnmodetAf>
XML'en indeholder ikke længere borgernes navne: Navn er fjernet fra borgeren
under Subjekt og givere, som kun angives med CPR eller
CprUUID.
Hvert samtykke har nu altid BrugervendtTekst med en Overskrift, også når
borgeren har svaret nej. Svarer borgeren nej til et samtykke, eller ja til et samtykke uden valgmuligheder,
indeholder BrugervendtTekst samtykkets egen overskrift og eventuelle indhold.
urn:digst:samtykke:samtykkeerklaering:2026-12 (tidligere
urn:digst:samtykke:samtykkeerklaering:2026-06)
Digital Post-status returneres kun til myndighedens egne anvendersystemer
Samtykkegivernes Digital Post-status viser, om en borger er fritaget for Digital Post. Den
oplysning må kun en myndighed få. Hvert anvendersystem er derfor registreret som enten
myndighedens eget anvendersystem eller 3. part, og svaret efter de signerede forløb indeholder kun
consenter1DigitalPostStatus og consenter2DigitalPostStatus, når
anvendersystemet er registreret som myndighedens eget anvendersystem.
For en 3. part er felterne altid udeladt, også når borgeren er tilmeldt Digital Post.
Anmodningen sender stadig Digital Post til samtykkegiverne som angivet i
sendDigitalPostToConsenters; det er kun oplysningen i svaret, der udelades.
Sådan kommer I videre
Alle anvendersystemer er registreret som 3. part, indtil Digitaliseringsstyrelsen har registreret dem som myndighed. Er jeres anvendersystem myndighedens eget og har brug for Digital Post-status, så kontakt Digitaliseringsstyrelsen.
POST /api/Integration/{tenantCvr}/SignedConsentResponseParameters
POST /api/Integration/{tenantCvr}/SignedConsentResponseParameters/Confirm
Ændringer
x5t#S256-header tilføjet til retursvar for signerede forløb
JWS-headeren på svaret i signerede forløb bærer nu x5t#S256, så det fremgår hvilket
certifikat der har signeret. Dette er relevant i den periode, hvor Digitalt Samtykke har flere gyldige systemcertifikater.
Svaret signeres med det certifikat, anvendersystemet brugte til kryptering ved starten af forløbet.
POST /api/Integration/{tenantCvr}/SignedConsentResponseParameters
POST /api/Integration/{tenantCvr}/SignedConsentResponseParameters/Confirm
UI advarsel, når Consenter1Cpr og SubjectCpr er ens
Angav I samme CPR-nummer i Consenter1Cpr og SubjectCpr, blev
Consenter1Cpr hidtil fjernet, og formularen åbnede, som om borgeren selv skulle besvare
anmodningen. Værdien bevares nu, og formularen viser i stedet en valideringsfejl, som
medarbejderen skal rette, før anmodningen kan sendes.
Baggrunden er, at Consenter1Cpr netop udtrykker, at en anden end
subjektet skal besvare anmodningen. Blev feltet fjernet lydløst, kunne de to hensigter ikke
skelnes bagefter.
POST /api/Integration/ConsentRequestParameters
Nye funktioner
Oppe check med HEAD i begge retninger
HOP-integrationspunkterne svarer nu på HEAD. Kaldet har ingen sideeffekter og
svarer altid 200 OK, så et anvendersystem kan kontrollere forbindelsen, før
borgeren eller medarbejderen sendes videre med den rigtige POST.
Digitalt Samtykke gør nu det samme i den modsatte retning: inden borgeren viderestilles
tilbage til jeres system, laves et oppe check med HEAD-kald til den RedirectionUrl,
forløbet blev startet med.
Svarer modtageren ikke, bliver borgeren ikke viderestillet.
Adressen i RedirectionUrl skal svare på HEAD. Alt andet end
5xx tæller som "kan nås".
Vælg login-metode for medarbejderen med idp
De medarbejder-vendte integrationspunkter tager nu imod query-parameteren
idp, der forudvælger, hvilken login-metode medarbejderen sendes til.
Gyldige værdier er NemLogin og FkaLogin, og de læses uden hensyn
til store og små bogstaver. Parameteren er valgfri, og udelades den, er forløbet uændret.
Valget har forrang for den login-metode, medarbejderen eventuelt har fået husket fra et tidligere login.
Anmodninger fra signerede forløb stemples med jeres organisationsnavn
Starter en borger et samtykke gennem det signerede forløb, står anvendersystemets registrerede organisationsnavn nu som "Anmodet af" på anmodningen og den færdige samtykkeerklæring.
POST /api/Integration/{tenantCvr}/SignedConsentResponseParameters
Vælg yderligere valg pr. trin med AdditionalChoices
Et trin i Steps kan nu angive, hvilke af trinnets valgfrie yderligere valg
anmodningen medtager, med en liste af { "Id": "..." } i
AdditionalChoices. Id er valgets UUID i skabelonen. Trinnets obligatoriske yderligere valg medtages altid.
Udelades feltet, eller udelades Steps helt, medtages alle trinnets valgfrie
yderligere valg. En tom liste medtager ingen valgfrie. Et id, som trinnet ikke har,
afvises med 400 på fejlsiden.
POST /api/Integration/{tenantCvr}/SignedConsentResponseParameters
Steps[].AdditionalChoices (valgfrit)
Åbn fanerne "Fravalg" og "Tilvalg" i samtykkesøgningen
Søgesiden "Find borgers samtykker" har fået fanerne "Fravalg" og "Tilvalg", som viser
borgerens yderligere valg af hver sin type. JSON-forløbet kan åbne siden på en af fanerne
med Tab.Type "optouts" (fravalg) eller "optins"
(tilvalg) og samtidig vælge sortering og statusfilter.
Sortering på begge faner: subject-asc, subject-desc,
casenumber-asc, casenumber-desc, declaration-asc,
declaration-desc, choice-asc og choice-desc.
Statusfilter på "optouts": optedout (fravalgt),
notoptedout (ikke fravalgt), expired (udløbet) og
invalid (ikke gyldigt). Statusfilter på "optins":
optedin (tilvalgt), notoptedin (ikke tilvalgt),
expired (udløbet) og invalid (ikke gyldigt). Den anden fanes
statusværdier afvises. TemplateName filtrerer på samtykkeerklæringen som på de
øvrige faner. ConsentName og ViewMode gælder fortsat kun fanen
"consents".
Fanen "Fravalg" vises kun, når søgningen har fravalg, og fanen "Tilvalg" kun, når den har tilvalg. Ellers åbner siden på fanen "Samtykkeerklæringer".
POST /api/Integration/ConsentQueryParameters/Json
Tab.Type = "optouts" og
Tab.Type = "optins"