Gå til indhold

Connectivity

Beskrivelse af systemkommunikation mellem dataanvenders system og DUPLA / Billetautomaten.
Principdiagran

1. Kald til Billetautomaten med OCES3 certifikat

Dataanvenders it-system kalder Billetautomaten med et OCES3-certifikat, som identificerer organisationen, som ønsker adgang til skattedata via DUPLA.

Når jeres system (aftagersystemet) forespørger en DUPLA service, valideres det, at det medsendte certifikat matcher det, som er registreret på dataaftalen. Det benyttede OCES3 certifikat skal være tildelt PRG rollen Aftager-system, se tildeling af roller​​​​​​​.

 

2. Adgangstoken med rettigheder

Billetautomaten verificerer certifikatet og udsteder et adgangstoken til jer, som sendes retur til jeres it-system


3. Request + adgangstoken

Dataaftagers it-system kalder DUPLA med bl.a. adgangstoken
Nedenstående headere er et krav for request mod en Dupla service.

De tre headere fremgår også med præcise feltnavne i Open API specifikationen for den enkelte service (Findes i Servicekataloget). Såfremt der er forskel på nedenstående oversigt og det, der fremgår af Open API specifikationen, så skal I forholde jer til Open API specifikationen.

 

4. Skattedata fra fagsystem returneres til jeres it-system

 

End points

Servicens specifikke path kan findes i Open API specifikationen for den relevante service (se Servicekataloget for at downloade Open API specifikationen).

Forudsætninger

Dataaftageren har på forhånd fået oprettet en dataaftale i DUPLA

  • Ekstern test: Brug Dataudvekslings testaftale, så I kan test med anonymiseret eller syntetisk testdata
  • Produktion: Der laves en rigtig aftale, I kan bruge til at modtage produktions data