Versionshistorik - Version 1.2

Digitalt Samtykke API - Digitaliseringsstyrelsen

Ændringer i version 1.2

Udgivelsesdato: 2025-12-15
Ny funktionalitet

Mulighed for at konfigurere visning af opsummeringsside i samtykkeerklæringsSkabeloner

Der er tilføjet et nyt valgfrit boolean-attribut visOpsummeringsSide til elementet SamtykkeErklæringsSkabelon i skemaet XSD til validering af skabeloner.

Formål: Gør det muligt for skabelon-administratorer at konfigurere om en opsummeringsside skal vises til borgeren under samtykkebesvarelsesflowet. For simple skabeloner med kun et samtykke kan denne side være unødvendig.

Navn: visOpsummeringsSide
Type: xs:boolean
Standardværdi: true (bevarer bagudkompatibilitet)
Placering: Attribut på rod-elementet SamtykkeErklæringsSkabelon

Adfærd:

  • Når visOpsummeringsSide="false": Opsummeringstrinnet springes over, og knappen på det sidste samtykketrin viser "Send besvarelse" i stedet for "Opsummering"
  • Når visOpsummeringsSide="true" eller udeladt: Opsummeringssiden vises (eksisterende adfærd)
  • Specialtilfælde: Opsummeringssiden vises altid under medbetjening (assisteret håndtering), uanset denne indstilling

Påvirkede skemaer:
XSD til validering af skabeloner

Ændring

ReferenceLinks på alle relevante ressourcer

Alle relevante ressourcer i API'et returnerer nu et nyt objekt ReferenceLinks, der indeholder URL-referencer til de enkelte ressourcer. Objektet indeholder et Self-link, der peger på ressourcens egen URL i API'et.

For samtykkeerklæringer og samtykkegrupper er der et borgerUi-link og et medarbejderUi-link, der peger på den respektive side på UI-løsningen for hhv. en Borger- eller Medarbejder-bruger.

Formålet er at understøtte HATEOAS-princippet, så klienter fremover kan navigere i API'et ved at følge links i svarene uden at kende ressource-stierne på forhånd.

Påvirkede endpoints:
GET /v1/api/samtykker (Borger.dk)
GET /v1/api/myndighed/{cvrNummer}/samtykker
GET /v1/api/myndighed/{cvrNummer}/samtykker/{samtykkeUuid}
GET /v1/api/myndighed/{cvrNummer}/samtykkeerklaeringer
GET /v1/api/myndighed/{cvrNummer}/samtykkeerklaeringsSkabeloner

Ny funktionalitet

Luk samtykker på samtykkeerklaring eller sagskontekst

Der er tilføjet muligheder for at lukke alle samtykker på en samtykkeerklæring eller på samtlige samtykkeerklæringer indenfor et sagskontekst og sagsnummer.

Tilføjede endpoints:
POST /v1/api/myndighed/{cvrNummer}/samtykkeerklaeringer/{samtykkeErklaeringUuid}/luk
POST /v1/api/myndighed/{cvrNummer}/samtykkeerklaeringer/{sagskontekst}/{sagsnummer}/luk

Ny funktionalitet

Tilbagekald samtykker på samtykkeerklaring eller sagskontekst

Der er tilføjet muligheder for at tilbagekalde alle samtykker på en samtykkeerklaring eller på samtlige samtykkeerklæringer indenfor et sagskontekst og sagsnummer.

Tilføjede endpoints:
POST /v1/api/myndighed/{cvrNummer}/samtykkeerklaeringer/{samtykkeErklaeringUuid}/tilbagekald
POST /v1/api/myndighed/{cvrNummer}/samtykkeerklaeringer/{sagskontekst}/{sagsnummer}/tilbagekald

Ny funktionalitet

Ændre sagsnummer på samtykkeerklaring

Der er tilføjet mulighed for at ændre sagsnummer på en samtykkeerklaring.

Tilføjet endpoint:
PUT /v1/api/myndighed/{cvrNummer}/samtykkeerklæringer/{samtykkeErklaeringUuid}/sagsnummer

Ændring

Medarbejderinformation ved lukning af samtykke

Medarbejderinformation angives nu med følgende parametre: 

{
  "medarbejderNavn": "string",
  "medarbejderLoginId": "string"
}

Påvirket endpoint:
POST /v1/api/myndighed/{cvrNummer}/samtykker/{samtykkeUuid}/luk

Ændring

Medarbejderinformation ved tilbagekald af samtykke

Medarbejderinformation angives nu med følgende parametre: 

{
  "medarbejderNavn": "string",
  "medarbejderLoginId": "string",
  "erMundtligGodkendelse": true,
  "note": "string",
  "underskrift": "string"
}

Påvirket endpoint:
POST /v1/api/myndighed/{cvrNummer}/samtykker/{samtykkeUuid}/tilbagekald

Ny funktionalitet

Dataafgrænsning (constraints) for systemer via FKA STS

API'et understøtter nu dataafgrænsning baseret på forskellige typer af begrænsninger (constraints) for systemer, der henter billetter via FKA STS. Dette giver mulighed for finkornet adgangsstyring ved at begrænse et systems adgang til et fx et bestemt KLE-nummer.

Understøttede constraint-typer:

  • KLE-klassifikationer (urn:dk:kombit:KLE): Kommunernes Landsforenings Emnesystematik, f.eks. "27.69.*" eller "29.24.*"

Sådan fungerer det:

  • Når et system henter en billet via FKA STS, kan systemet være begrænset på fx KLE-nummerniveau. Dette vil i givet fald fremgå af billetten.
  • Hvis et system har begrænsninger, kan systemet kun tilgå ressourcer (skabeloner, erklæringsger, samtykker), der har matchende opmærkninger
  • Systemer uden begrænsninger har fuld adgang til alle ressourcer inden for deres tildelte rettigheder

Påvirkede endpoints:
Alle endpoints, der returnerer eller manipulerer samtykkeerklæringsskabeloner, samtykkeerklæringer eller samtykker, respekterer nu systemets begrænsninger

Ændring

Karakterbegrænsning på BrugervendtTekst

Angivelse af Overskrift under BrugervendtTekst er begrænset til 160 karakterer. Angivelse af Indhold under BrugervendtTekst er begrænset til 500 karakterer.

Påvirkede endpoints:
POST /v1/api/myndighed/{cvrNummer}/samtykkeerklaeringer