Digital Fuldmagt udstiller et SOAP-baseret API med en række forskellige services, hvor oplysninger om digitale fuldmagter kan forespørges. Fuldmagterne repræsenteres som delegeringer af fuldmagtsprivilegier fra fuldmagtsgiver til repræsentant, og et it-system kan kun forespørge på egne fuldmagtsprivilegier.
Brug af API’erne har den fordel, at det er muligt at forespørge om fuldmagtsprivilegier for en vilkårlig borger og repræsentant. Dette kan bruges ved integration til tjenesteudbyderens interne systemer, fx kundeportaler. En sagsbehandler eller supportmedarbejder kan have behov for at vide, om der findes en fuldmagt. Det er fx relevant, hvis en repræsentant henvender sig via telefon eller e-mail, og sagsbehandleren eller supportmedarbejderen skal bekræfte fuldmagtsforholdet. Se et eksempel på, hvordan API'en er anvendt til at kontrollere kontrollere fuldmagtforhold i et fagsystem:
Eksempel på brug af API'en i et fagsystem
SOAP API’et er blevet udvidet med en version 2 den 26. august 2025. Alle it-systemudbydere, der i dag anvender version 1 af SOAP API’et, anbefales at migrere til version 2 inden marts 2026. Herefter vil version 1 ikke længere blive vedligeholdt.
Hvis man som it-systemudbyder allerede anvender version 1 og skal overgå til version 2
I skal opdatere følgende:
- Endpoint (URL) (tilføj V2)
- SOAP Action header (https) (tilføj V2)
Version 2 er bagud kompatibel til version 1. Dette betyder, at navne på elementer og deres indhold er det samme som i version 1, hvorfor det alene er ovenstående der skal opdateres.
Der er tilføjet et nyt element <Constraints> i version 2, som kan anvendes af it-systemudbydere, når det i fremtiden bliver muligt at opsætte dynamiske dataafgræsninger på fuldmagter. På nuværende tidspunkt vil elementet <Constraints> være tomt i svar på API-kald, og derfor vil det ikke være nødvendigt at behandle det.
For spørgsmål om overgangen til SOAP API version 2, kan man kontakte:
Digital Fuldmagt Forvaltningen: E-mail
Hvis man som it-systemudbyder integrerer til version 2
I kan nedenstående WSDL-fil og endpoints anvendes.
Du finder en WSDL-fil for webservicen her:
Hvis I har behov for version 1
I skal bruge denne WSDL-fil og endpoints.
Delegation webservice for Digital Fuldmagt (WSDL) - version 1