Hvem og hvornår
Bruges af en myndighedsmedarbejder. Medarbejderen sidder i myndighedens eget fagsystem og har brug for et samtykke, før sagen kan komme videre. I stedet for selv at skifte til Digitalt Samtykke manuelt og indtaste det hele forfra, hopper medarbejderen direkte til opret‑anmodning‑siden med felterne allerede udfyldt.
Fagsystemet bestemmer, hvor meget det udfylder. Sender det ingenting ud over myndighedens CVR, lander medarbejderen på en tom formular. Sender det skabelon, sagsnummer og CPR, mangler der typisk at gennemse anmodningen, før den sendes til borgeren.
Forudsætninger
- Myndigheden er tilsluttet Digitalt Samtykke.
- Medarbejderen kan logge ind via NemLog-in eller Fælleskommunal Adgangsstyring og har rettigheder til at oprette anmodninger for myndigheden.
- Skabelonen, fagsystemet forudfylder, er oprettet i Digitalt Samtykke under myndigheden. Ukendte værdier afvises.
Forløbet
Trin 1. Fagsystemet bygger formularen
En HTML-formular med method="post" mod /api/Integration/ConsentRequestParameters. Se POST /api/Integration/ConsentRequestParameters i Swagger UI.
Trin 2. Browseren afsender den
Parametrene står i formularen og havner derfor hverken i adresselinjen eller i browserhistorikken.
Trin 3. Digitalt Samtykke validerer inputtet
Løsningen kontrollerer blandt andet, at
- myndigheden findes,
- skabelonen, findes hos netop den myndighed,
- skabelonen understøtter de felter, der er sendt med, og
Går noget galt, vises en fejlside til brugeren.
Trin 4. Medarbejderen lander på formularen
Er medarbejderen ikke logget ind i forvejen, sker login først. Derefter vises opret‑anmodning‑siden med de forudfyldte felter, og medarbejderen gør anmodningen færdig i Digitalt Samtykke.
Vælg login-tjeneste med idp
Ved du på forhånd, om medarbejderen skal logge ind via NemLog-in eller Fælleskommunal
Adgangsstyring, kan query-parameteren idp benyttes til automatisk at vælge for medarbejderen.
Datamodel
Den fulde feltliste med typer, længder og svarkoder ligger i Swagger UI under
POST /api/Integration/ConsentRequestParameters.
Prøv det
Testklienten viser integrationen i drift og fungerer som reference-implementation: brug browserens "vis kildekode" til at se, præcis hvordan formularen bygges.
Åbn demoen af opret anmodning (åbner i nyt vindue)