Hvordan ta i bruk tjenesten
DFØ tilbyr APIer (programmeringsgrensesnitt) til sine kunder for å legge til rette for automatisk informasjonsutveksling med DFØs lønns- og regnskapssystemer.
For å kunne ta i bruk DFØs APIer må man være kunde av DFØ og ha avtale om bruk av APIene.
APIene til DFØ gjøres tilgjengelig gjennom en felles API manager og Digitaliseringsdirektoratets “Maskinporten” brukes for sikker autentisering og tilgangskontroll. API Manager krever autentisering for alle endepunkter og tilgang er kun for system-til-system integrasjoner.
For at kunder enkelt skal kunne teste sitt oppsett via maskinporten har DFØ laget et echo API hvor en kan teste at access token fra maskinporten er gyldig. Echo tjenesten vil gi en 200 OK melding ved gyldig token og 401/403 melding ved ugyldig token. Endepunktet for bruk av GET operasjon på echo API er: https://api-test.dfo.no/dfo-echo
Meldingskø
Lønn og regnskaps systemene benytter en meldingsformidler (AMQP) for å sende ut notifikasjoner. Når det blir gjort endringer i kildesystemet på noen av feltene i et av API-ene, vil dette generere en melding som blir sendt gjennom meldingsmegleren. Meldingene vil være så tynne som mulig og vil ikke inneholde noen feltverdier. Noe nyttig linker for å sette opp klient side av meldingskø system (Getting started og klient).
API-Dokumentasjon
Liste over alle API-ene, der man kan klikke seg inn på hver enkelt og få opp dokumentasjonen
Driftsinformasjon
DFØ informerer om vesentlige endringer ved å sende ut driftsvarsler til teknikere som melder seg på e-postvarsler via følgende link.
https://dfo.no/kundesider/driftsstatus/abonner-pa-driftsvarsler
I tillegg kan en sjekke status på DFØs tjenester ved å gå inn på: https://status.dfo.no/
Kontaktinformasjon
Lønn:
For spørsmål om Lønns-API, ta kontakt med lønnsdivisjonen
lonn@dfo.no
Regnskap:
For spørsmål om Regnskaps-API, ta kontakt med regnskapsdivisjonen
regnskap@dfo.no
