Versionshistorik - Version 4.0

Digitalt Samtykke API - Digitaliseringsstyrelsen

Breaking changes

Breaking change

Hent samtykkeerklæringsskabelon returnerer nu en versionsoversigt

GET /v4/api/myndighed/{cvrNummer}/samtykkeerklaeringsskabeloner/{uuid} returnerer nu en versionsoversigt i JSON - i samme form som ét element fra listen på GET /v4/api/myndighed/{cvrNummer}/samtykkeerklaeringsskabeloner, blot for den specifikke skabelon. I v3 returnerede dette endpoint den fulde skabelon som XML.

HTTP: GET /v4/api/myndighed/{cvrNummer}/samtykkeerklaeringsskabeloner/{uuid}
Svar: application/json — metadata og en liste af versioner, hver med et self-link til den fulde skabelon-XML.

Hent den fulde skabelon-XML

Brug GET /v4/api/myndighed/{cvrNummer}/samtykkeerklaeringsskabeloner/{uuid}/seneste for seneste version, eller GET /v4/api/myndighed/{cvrNummer}/samtykkeerklaeringsskabeloner/{uuid}/{skabelonVersion} for en specifik version. Begge returnerer XML i skemaversion 2026-12.

Breaking change

Ny skemaversion 2026-12 for samtykkeerklæringsskabeloner

Samtykkeerklæringsskabeloner hentet via API v4 returneres i skemaversion 2026-12. Skabelonen kan indeholde en Vedhaeftningsliste med højst 3 vedhæftninger (titel, linktitel og SHA-256 af PDF-filen).

Namespace: urn:digst:samtykke:samtykkeerklaeringskabelon:2026-12
Breaking change

Hvert samtykke i en skabelon skal have en brugervendt tekst

I skemaversion 2026-12 for samtykkeerklæringsskabeloner skal hvert 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. Skabeloner, der eksporteres fra Digitalt Samtykke, indeholder elementet.

Breaking change

Ny skemaversion 2026-12 for samtykkeerklæringer

Samtykkeerklæringer oprettet via API v4 skal overholde udvekslingsformatet i skemaversion 2026-12.

HTTP: POST /v4/api/myndighed/{cvrNummer}/samtykkeerklaeringer
Namespace: urn:digst:samtykke:samtykkeerklaering:2026-12
Nyt element: Vedhaeftningsliste (valgfri) med højst 3 vedhæftninger, der er uploadet til myndighedens vedhæftningsbibliotek.
Nyt element: Samtykkegruppe/YderligereValgListe (valgfri, efter Samtykker) med de yderligere valg, borgeren har forholdt sig til ved afgivelse af samtykke, og borgerens status på hvert valg. Hvert YderligereValg har elementerne YderligereValgUUID (unik for myndigheden), YderligereValgDefinitionUUID (stabil nøgle for valget, unik i listen; samme værdi på flere erklæringer er samme valg), Navn (maks. 160 tegn), Indhold (valgfri HTML) og Status (Valgt eller IkkeValgt ved besvarelsen; IkkeGyldigt og Udløbet ses kun i API'et), GyldigtTil (valgfri, tidspunktet hvorefter valget ikke længere er gældende; udelades, når valget ikke udløber; uden tidszone antages UTC; et tidspunkt i fortiden afvises) samt attributterne type (Fravalg eller Tilvalg), obligatorisk, kanSkifteTilValgt og borgerKanSelvSkifteTilValgt (valgfri, standard false).
Breaking change

Hvert samtykke skal have en brugervendt overskrift

BrugervendtTekst med en Overskrift er nu påkrævet på hvert Samtykke i skemaversion 2026-12, også når samtykket er afvist. En samtykkeerklæring, hvor et samtykke mangler elementet, afvises ved oprettelse med 400 Bad Request.

I JSON-svarene er brugervendtTekst nu altid med på samtykket. For samtykker fra før kravet, som ikke fik en brugervendt tekst (afviste samtykker og samtykker uden valgmuligheder), er overskrift tom.

Endpoint: POST /v4/api/myndighed/{cvrNummer}/samtykkeerklaeringer
Endpoint: GET /v4/api/myndighed/{cvrNummer}/samtykker/{samtykkeUuid}
Breaking change

Ensretning af Anmodnings felter

To felter på en anmodning hed noget andet end den samme oplysning gør i resten af API'et og i XML-skemaet. De er omdøbt i v4, så navnene er ens uanset om du opretter eller henter. Typen af anmodningsTidspunkt er uændret. Ved oprettelse har anmodetAf desuden en ny form: medarbejderens navn og loginId ligger nu under anmodetAf.medarbejder.

// v3
"oprettetAf": { "navn": "Jens Jensen", "loginId": "jje" }

// v4
"anmodetAf": { "medarbejder": { "navn": "Jens Jensen", "loginId": "jje" } }
Body: POST /v4/api/myndighed/{cvrNummer}/anmodninger — omdøb oprettetAf til anmodetAf, og flyt navn og loginId ind under anmodetAf.medarbejder. Ukendte felter under anmodetAf, fx den gamle flade form, giver 400.
Svar: GET /v4/api/myndighed/{cvrNummer}/anmodninger/{anmodningsUuid} — oprettelsesDato hedder nu anmodningsTidspunkt, som i samtykkeerklæringens Anmodning og i skemaets Anmodningstidspunkt.
Breaking change

"Anmodet af" er påkrævet i samtykkeerklæringens XML

En samtykkeerklæring i udvekslingsformatet skal nu altid angive AnmodetAf under Anmodning. Elementet har samme indhold som "Anmodet af" på en anmodning: en medarbejder, en organisation og/eller et system, mindst én af dem. Organisation og system er tekster på højst 100 tegn. Systemet er navnet på det system, der oprettede anmodningen, fx en selvbetjeningsløsning.

Strukturen er også ændret: medarbejderens Navn og LoginId ligger nu i et Medarbejder-element under AnmodetAf (i 2026-06 lå de direkte under AnmodetAf). Den gamle form giver en skemafejl, selvom elementet er udfyldt.

<!-- 2026-06 -->
<AnmodetAf>
  <sdt:Navn>Jens Jensen</sdt:Navn>
  <sdt:LoginId>jje</sdt:LoginId>
</AnmodetAf>

<!-- 2026-12 -->
<AnmodetAf>
  <sdt:Medarbejder>
    <sdt:Navn>Jens Jensen</sdt:Navn>
    <sdt:LoginId>jje</sdt:LoginId>
  </sdt:Medarbejder>
  <sdt:Organisation>Eksempel Kommune</sdt:Organisation>
</AnmodetAf>

<!-- 2026-12, kun system -->
<AnmodetAf>
  <sdt:System>Eksempel Selvbetjening</sdt:System>
</AnmodetAf>

Det samme gælder den XML, integrationen læser: GET på en samtykkeerklæring returnerer XML'en i den skemaversion, erklæringen blev oprettet i, og erklæringer oprettet fra en besvaret anmodning gemmes i 2026-12.

HTTP: POST /v4/api/myndighed/{cvrNummer}/samtykkeerklaeringer, GET /v4/api/myndighed/{cvrNummer}/samtykkeerklaeringer/{samtykkeErklaeringUuid}
XML: application/xml (skemaversion 2026-12) — AnmodetAf er påkrævet og af typen AnmodetAfType med Medarbejder, Organisation og/eller System.
Breaking change

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. Digitalt Samtykke slår altid navnet op i CPR. Navnene fås via API'ets opslag på anmodninger og samtykker.

XML'en, som Digitalt Samtykke selv udleverer i 2026-12, indeholder heller ikke navnene.

<!-- 2026-06 -->
<Borger>
  <Navn>Anna Hansen</Navn>
  <CPR>0101011234</CPR>
</Borger>

<!-- 2026-12 -->
<Borger>
  <CPR>0101011234</CPR>
</Borger>
Namespace: urn:digst:samtykke:samtykkeerklaering:2026-12
Fjernet element: Borger/Navn
Breaking change

Overskrifter i erklæringens HTML-felter skal starte med h4 og må ikke springe niveauer

HTML-felterne i en samtykkeerklæring (fx udsagn, vilkår, oplysningserklæring) må kun indeholde overskrifterne h4-h6. Fra v4 skal den første overskrift i hvert felt være h4, og hver efterfølgende overskrift må højst være ét niveau dybere end den foregående - at gå op i niveau er altid tilladt.

POST /v4/api/myndighed/{cvrNummer}/samtykkeerklaeringer afviser nu en erklæring der bryder reglen. Svaret indeholder én fejlbesked pr. overtrædelse, hver med navnet på feltet - enten at feltets første overskrift ikke er h4, eller at en overskrift følger direkte efter en der ligger mere end ét niveau højere oppe. v1, v2 og v3 accepterer fortsat den samme payload uændret.

HTTP: POST /v4/api/myndighed/{cvrNummer}/samtykkeerklaeringer
Svar: 400 Bad Request med én besked pr. overtrædelse, hver med navnet på feltet
Påvirker: alle HtmlTekst-felter i SamtykkeErklaering

Ændringer

Rettelse

Boolean-attributter med værdien 1 eller 0 læses nu korrekt

Skemaerne erklærer boolean-attributterne som xs:boolean, som tillader både true/false og 1/0. Værdierne 1 og 0 bestod valideringen, men blev ikke læst: attributten blev behandlet som udeladt, så fx forhaandsvalgt="1" blev gemt som false. Nu gemmes 1 som true og 0 som false.

Omfang: boolean-attributter i alle skemaversioner af samtykkeerklæringsskabeloner og samtykkeerklæringer, fx forhaandsvalgt, gentagbar, paakraevet og tilladBorgerTilbagekaldelse. Værdier der blev læst korrekt før, læses uændret.
Skemadokumentation

Præcisering af hvordan flettefelter tælles i valgmuligheders brugervendte tekst

Beskrivelsen af BrugervendtTekstSkabelon/Overskrift og BrugervendtTekstSkabelon/Indhold i ErklaeringSkabelon.xsd oplyste, at hvert flettefelt tæller som 50 karakterer. Det gælder ikke valgmulighedens eget flettefelt, som erstattes med valgmulighedens navn og derfor tæller navnets faktiske længde. Teksten er rettet i skemaversionerne 2025-10, 2026-03 og 2026-06.

Omfang: kun xs:documentation. Skemaernes struktur, navnerum og validering er uændrede.

Sådan tælles de 160 og 500 karakterer

Grænserne måles på den færdigflettede tekst. Et almindeligt flettefelt regnes som 50 karakterer, fordi værdien først kendes ved borgerens besvarelse. Valgmulighedens eget flettefelt regnes som valgmulighedens navn, og kan valgmuligheden præciseres af medarbejderen, lægges 50 karakterer til for præciseringen. XHTML-namespace-erklæringer (xmlns="http://www.w3.org/1999/xhtml") i Indhold tæller ikke med.

Nye funktioner

Skemaændring

Yderligere valg i skemaversion 2026-12 for samtykkeerklæringsskabeloner

I skabelonskemaet ErklaeringSkabelon.xsd kan et samtykke nu have yderligere valg: tilvalg og fravalg, som borgeren kan markere, når samtykket afgives - fx at frabede sig information om alvorlige helbredsfund. Valgene ligger i det nye, valgfrie element Afgiv/YderligereValgListe efter Valgmuligheder, i den rækkefølge de vises for borgeren. Borgerens svar på valgene fremgår af udvekslingsformatet for samtykkeerklæringer i skemaversion 2026-12 (YderligereValgListe).

Elementer: Navn (påkrævet, maks. 120 tegn), Indhold (valgfri HTML, maks. 500 tegn inkl. opmærkning) og BrugervendtTekstSkabelon (valgfri: Overskrift maks. 160 tegn og valgfrit Indhold maks. 500 tegn inkl. opmærkning; bruges i sin helhed på den endelige samtykkeerklæring i stedet for navn og indhold; ingen flettefelter).
Attributter: yderligereValgId (påkrævet UUID, unik blandt samtykkets valg; samme id i flere skabeloner er samme valg), type (Fravalg eller Tilvalg), obligatorisk (default true), kanSkifteTilValgt og borgerKanSelvSkifteTilValgt.
Ny funktionalitet

Yderligere valg ved oprettelse af anmodning

En anmodning tager skabelonens yderligere valg med. Obligatoriske yderligere valg medtages altid. Valgfrie medtages kun, når de angives på et valgt trin i valgteSkabelonTrin; udelades valgteSkabelonTrin, medtages kun de obligatoriske. Id'et er valgets UUID i skabelonen. Et id, der ikke findes på trinnets samtykke, afvises med 400.

Body: POST /v4/api/myndighed/{cvrNummer}/anmodninger — nyt valgfrit felt valgteSkabelonTrin[].yderligereValgListe[].yderligereValgId.
Ny funktionalitet

Yderligere valg på samtykkeerklæringen

Når borgeren afgiver et samtykke, gemmes borgerens status på hvert yderligere valg, som borgeren har forholdt sig til. Valgene kan hentes for sig, og en samtykkegruppe består nu af både samtykker og yderligere valg. Status er Valgt eller IkkeValgt for både tilvalg og fravalg, eller Udløbet, når valget er udløbet og ikke længere kan skiftes. Et valg har gyldigtTil, når det udløber eller er lukket (udeladt ellers); for et lukket valg er det lukketidspunktet; type (Fravalg eller Tilvalg) afgør, hvordan status vises, fx "Fravalgt" for et valgt fravalg. Er valget gjort ugyldigt, fordi samtykkeerklæringen blev lukket, er status IkkeGyldigt, og valget kan ikke skiftes bagefter. Er samtykket afvist, har gruppen ingen yderligere valg.

HTTP: GET /v4/api/myndighed/{cvrNummer}/yderligerevalg — søgning med de samme query-parametre og regler som søgning i samtykker (GET /v4/api/myndighed/{cvrNummer}/samtykker), undtagen samtykkeStatus.
Filtre: yderligereValgDefinitionId (valgets stabile nøgle, som finder samme valg på tværs af erklæringer), yderligereValgStatus (Valgt/IkkeValgt/IkkeGyldigt/Udløbet) og type (Fravalg/Tilvalg), hver med en eller flere værdier. Udelades et filter, filtreres der ikke på det. Et fravalgt valg findes med yderligereValgStatus=Valgt&type=Fravalg.
HTTP: GET /v4/api/myndighed/{cvrNummer}/yderligerevalg/{yderligereValgUuid}
Svar: application/json — yderligereValgUuid, yderligereValgDefinitionId, navn, indhold, status, gyldigtTil, type, obligatorisk, kanSkifteTilValgt, borgerKanSelvSkifteTilValgt, samtykkegruppe og links.
Svar: GET /v4/api/myndighed/{cvrNummer}/samtykker/{samtykkeUuid} — nyt felt samtykkegruppe.yderligereValgListe med gruppens yderligere valg i den rækkefølge, de blev vist for borgeren.

Når status på et yderligere valg skiftes, sendes en Digital Post-besked til myndighedens modtagersystem, efter samme princip som ved tilbagekaldelse af et samtykke. Beskeden har erklærings-PDF'en og kopier af beskederne til giverne vedhæftet.

Ny besked-kode

Beskeden bruger besked-koden dk.digst.samtykke.yderligerevalg.skiftet. Den bærer valget som YderligereValgUUID (samme værdi som yderligereValgUuid i GET /v4/api/myndighed/{cvrNummer}/yderligerevalg/{yderligereValgUuid}) og erklæringen som ErklæringsUUID.

Ny funktionalitet

Skift af et yderligere valg

Myndigheden kan skifte status på et yderligere valg på vegne af borgeren, med samme registrering af medbetjeningen som ved tilbagekaldelse af et samtykke. Et valg, der ikke er udløbet, kan altid skiftes til IkkeValgt; et udløbet valg kan ikke skiftes. Et skift til Valgt kræver, at valgets kanSkifteTilValgt er sand; borgerKanSelvSkifteTilValgt begrænser ikke myndigheden. Skiftet sender beskeden med besked-koden dk.digst.samtykke.yderligerevalg.skiftet til giverne og myndighedens modtagersystem.

HTTP: POST /v4/api/myndighed/{cvrNummer}/yderligerevalg/{yderligereValgUuid}/status
Body: application/json — status (Valgt/IkkeValgt), medarbejder (navn og loginId), erMundtligGodkendelse, note og underskrift (base64-kodet PNG, påkrævet når erMundtligGodkendelse er false), som ved POST .../samtykker/{samtykkeUuid}/tilbagekald.
Svar: 200 med digitalPostStatusOplysninger for giverne, som ved tilbagekaldelse. 400, når valget er IkkeGyldigt eller udløbet, når valget allerede har status, når skabelonen ikke tillader skiftet til Valgt, eller når medbetjeningen er ugyldig; 404, når valget ikke findes hos myndigheden.
Ny funktionalitet

Gør yderligere valg ugyldige, når samtykkeerklæringen lukkes

Begge luk-endpoints kan nu også gøre samtykkeerklæringens yderligere valg ugyldige. Valgene, der er valgt eller ikke valgt, får status "Ikke gyldigt" og kan ikke skiftes bagefter, hverken af borgeren, i Digitalt Samtykke eller via API'et. Udløbne valg røres ikke. Udelades feltet, lukkes kun samtykkerne som hidtil.

HTTP: POST /v4/api/myndighed/{cvrNummer}/samtykkeerklaeringer/{samtykkeErklaeringUuid}/luk og POST /v4/api/myndighed/{cvrNummer}/samtykkeerklaeringer/{sagskontekst}/{sagsnummer}/luk
Body: nyt felt ugyldiggoerYderligereValg (boolean, standard false) ved siden af medarbejder. Med true gøres valgene ugyldige, også når ingen samtykker er aktive.
Ny funktionalitet

Lukkede yderligere valg i beskeden om lukket samtykkeerklæring

Når samtykkeerklæringen lukkes, kan dens yderligere valg lukkes med den. Valgene får status "Ikke gyldigt" og kan ikke skiftes bagefter. Beskeden til myndighedens modtagersystem med besked-koden dk.digst.samtykke.erklæring.lukket lister de lukkede valg i hoveddokumentet og i et teknisk dokument for sig.

Teknisk dokument: lukkedeYderligereValg.json — en liste af { "yderligereValgId": "<uuid>" }, hvor yderligereValgId er samme værdi som yderligereValgUuid i GET /v4/api/myndighed/{cvrNummer}/yderligerevalg/{yderligereValgUuid}. Dokumentet vedhæftes kun, når valg blev lukket.
Ingen lukkede samtykker: lukker lukningen kun yderligere valg, fordi samtykkerne allerede var lukket, tilbagekaldt eller udløbet, sendes beskeden alligevel. lukkedeSamtykker.json er da en tom liste.
Ny funktionalitet

Udløbne yderligere valg i beskeden om udløbne samtykker

Når yderligere valg udløber, får myndighedens modtagersystem besked med besked-koden dk.digst.samtykke.samtykke.udløbet. Beskeden sendes pr. samtykkeerklæring og lister de udløbne valg i hoveddokumentet og i et teknisk dokument for sig. Udløber samtykker og valg samtidig, dækker samme besked begge dele.

Teknisk dokument: udløbneYderligereValg.json: en liste af { "yderligereValgId": "<uuid>" }, hvor yderligereValgId er samme værdi som yderligereValgUuid i GET /v4/api/myndighed/{cvrNummer}/yderligerevalg/{yderligereValgUuid}. Dokumentet vedhæftes kun, når valg udløb.
Ingen udløbne samtykker: udløber kun yderligere valg, sendes beskeden alligevel. udløbneSamtykker.json er da en tom liste.
Ny funktionalitet

Snart udløbne yderligere valg i varslingen om snart udløbne samtykker

Når yderligere valg snart udløber, får myndighedens modtagersystem besked med besked-koden dk.digst.samtykke.samtykke.udløber. Et valg varsles efter samme frist som samtykkerne i samtykkegruppen og kun én gang. Beskeden sendes pr. samtykkeerklæring og lister de snart udløbne valg i hoveddokumentet og i et teknisk dokument for sig. Udløber samtykker og valg snart samtidig, dækker samme besked begge dele. Borgeren får ingen besked.

Teknisk dokument: snartUdløbneYderligereValg.json: en liste af { "yderligereValgId": "<uuid>" }, hvor yderligereValgId er samme værdi som yderligereValgUuid i GET /v4/api/myndighed/{cvrNummer}/yderligerevalg/{yderligereValgUuid}. Dokumentet vedhæftes kun, når valg snart udløber.
Ingen snart udløbne samtykker: udløber kun yderligere valg snart, sendes beskeden alligevel. snartUdløbneSamtykker.json er da en tom liste.
Ny funktionalitet

Upload og opslag af vedhæftninger

Nye endpoints til myndighedens vedhæftningsbibliotek. En PDF uploades med body'en som application/pdf, og svaret er filens SHA-256, som erklæringens Vedhaeftningsliste refererer, og om filen er tilgængelig (PDF/UA). Uploaden er idempotent. Opslaget svarer med de af de angivne filer, myndigheden allerede har, og om de er tilgængelige, så kun de manglende skal uploades. Kræver samme rettighed som oprettelse af en samtykkeerklæring.

HTTP: POST /v4/api/myndighed/{cvrNummer}/vedhaeftninger
HTTP: GET /v4/api/myndighed/{cvrNummer}/vedhaeftninger?sha256=…&sha256=…
Ny funktionalitet

Vedhæftninger på anmodninger og samtykkeerklæringer

Anmodninger og samtykkeerklæringer viser nu deres vedhæftninger i feltet vedhaeftninger, herunder om filen er tilgængelig (PDF/UA), og den enkelte vedhæftning kan hentes som PDF med nye endpoints. Svaret har en ETag, så en uændret fil kan genbruges fra cache med If-None-Match.

HTTP: GET /v4/api/myndighed/{cvrNummer}/samtykkeerklaeringer/{samtykkeErklaeringUuid}/vedhaeftninger/{sha256}
HTTP: GET /v4/api/myndighed/{cvrNummer}/anmodninger/{anmodningsUuid}/vedhaeftninger/{sha256}
Ny funktionalitet

Log ind med klientcertifikat (mTLS) som anvendersystem

Nyt endpoint, hvor et registreret anvendersystem kan autentificere sig med sit OCES-klientcertifikat (mTLS) og få en JWT-token med rollen tredjepartsanmoder. Rollen giver adgang til at oprette og annullere anmodninger og læse samtykkeerklæringsskabeloner, afgrænset til de skabeloner anvendersystemet må anvende.

HTTP: GET /v4/api/authorize/certificate
Svar: application/json — access-token, token_type (Bearer) og expires_in.

Krav til certifikat

Der kan kun anvendes et gyldigt OCES-certifikat: klientcertifikatet skal kæde til en betroet OCES-CA og må ikke være udløbet eller tilbagekaldt. Den udstedte token er holder-of-key-bundet til samme certifikat, som derfor skal medsendes som Client Certificate på efterfølgende kald mod API'et.

Digital Post-status kun til myndighedens egne anvendersystemer

Samtykkegivernes Digital Post-status (digitalPostStatusOplysninger) returneres kun, når anvendersystemet er registreret som myndighedens eget anvendersystem hos den myndighed, kaldet gælder. Et anvendersystem, der tilhører en 3. part, får aldrig feltet, heller ikke når borgeren er tilmeldt. Reglen gælder også, når tokenen bruges mod /v3/. Et nyt anvendersystem registreres som 3. part; kontakt Digitaliseringsstyrelsen, hvis anvendersystemet tilhører myndigheden selv. Kald med en token fra Fælleskommunal Adgangsstyring eller NemLog-in får statussen som hidtil.

Ny funktionalitet

Hent seneste version af en samtykkeerklæringsskabelon

Nyt endpoint der returnerer den fulde, seneste version af en samtykkeerklæringsskabelon som XML.

HTTP: GET /v4/api/myndighed/{cvrNummer}/samtykkeerklaeringsskabeloner/{uuid}/seneste
Svar: application/xml (skemaversion 2026-12)
Ny funktionalitet

Hent specifik version af en samtykkeerklæringsskabelon

Nyt endpoint der returnerer en specifik version af en samtykkeerklæringsskabelon som XML, angivet ved versionsnummer.

HTTP: GET /v4/api/myndighed/{cvrNummer}/samtykkeerklaeringsskabeloner/{uuid}/{skabelonVersion}
Svar: application/xml (skemaversion 2026-12)
Ny funktionalitet

"Anmodet af" kan nu også bære en organisation og et system

Når en anmodning oprettes af et anvendersystem der er logget ind med klientcertifikat, stemples anvendersystemets organisationsnavn på anmodningen sammen med den medarbejder der er angivet i kaldet. AnmodetAf udvides derfor med et valgfrit organisationsfelt ved siden af medarbejderen, og feltet er nu også tilgængeligt når en anmodning hentes.

AnmodetAf kan også have et System med navnet på det system, der oprettede anmodningen eller samtykkeerklæringen, fx en selvbetjeningsløsning uden en medarbejder. Systemet kan kun læses gennem v4; v3's AnmodetAf er uændret og bærer kun medarbejderen.

Felterne er valgfrie hver for sig, men mindst ét er angivet. Anmodninger startet gennem det signerede HOP-forløb har ingen medarbejder, og her indeholder AnmodetAf derfor kun organisationen.

Når du opretter en anmodning, har anmodetAf i v4 formen { "medarbejder": { "navn", "loginId" }, "organisation": "...", "system": "..." } i stedet for en medarbejder direkte. Organisationen og systemet er højst 100 tegn og må ikke være tomme. Kaldes der uden certifikat-login, skal kaldet angive en medarbejder, en organisation eller et system, ellers afvises det med 400. Ved certifikat-login sættes anvendersystemets organisation på, og et kald, der selv angiver en organisation, afvises med 400.

Body: POST /v4/api/myndighed/{cvrNummer}/anmodninger — anmodetAf med medarbejder, organisation og/eller system.
HTTP: GET /v4/api/myndighed/{cvrNummer}/anmodninger
HTTP: GET /v4/api/myndighed/{cvrNummer}/anmodninger/{anmodningsUuid}
HTTP: GET /v4/api/myndighed/{cvrNummer}/samtykker/{samtykkeUuid}
Svar: application/json — AnmodetAf indeholder medarbejder, organisation og system, hvor de findes.

Gælder også anmodninger oprettet gennem v3

Bruges et certifikat-login-token mod POST /v3/api/myndighed/{cvrNummer}/anmodninger, stemples organisationen på samme måde. Den kan derimod kun læses tilbage gennem v4 — v3's AnmodetAf er uændret og bærer kun medarbejderen.