Versionshistorik - Version 1.5.0

Digitalt Samtykke HOP-integration - Digitaliseringsstyrelsen

Breaking changes

Breaking change

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.

Breaking change

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.

HTTP: POST /api/Integration/ConsentRequestParameters
Fjernet felt: Subject1Cpr — erstattet af SubjectCpr, som har samme format og betydning.
Breaking change

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.

HTTP: POST /api/Integration/{tenantCvr}/SignedConsentResponseParameters/Confirm
Breaking change

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.

Namespace: urn:digst:samtykke:samtykkeerklaering:2026-12 (tidligere urn:digst:samtykke:samtykkeerklaering:2026-06)
Breaking change

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.

HTTP: POST /api/Integration/{tenantCvr}/SignedConsentResponseParameters
HTTP: POST /api/Integration/{tenantCvr}/SignedConsentResponseParameters/Confirm

Ændringer

Ændring

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.

HTTP: POST /api/Integration/{tenantCvr}/SignedConsentResponseParameters
HTTP: POST /api/Integration/{tenantCvr}/SignedConsentResponseParameters/Confirm
Ændring

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.

HTTP: POST /api/Integration/ConsentRequestParameters

Nye funktioner

Ny funktionalitet

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".

Ny funktionalitet

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.

Ny funktionalitet

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.

HTTP: POST /api/Integration/{tenantCvr}/SignedConsentResponseParameters
Ny funktionalitet

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.

HTTP: POST /api/Integration/{tenantCvr}/SignedConsentResponseParameters
Nyt felt: Steps[].AdditionalChoices (valgfrit)
Ny funktionalitet

Å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".

HTTP: POST /api/Integration/ConsentQueryParameters/Json
Nye værdier: Tab.Type = "optouts" og Tab.Type = "optins"