Opret en anmodning om samtykke

HOP-integration - Digitalt Samtykke

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.

Åbn kontrakten i Swagger UI

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)