Lønnssystem

APIene mot lønnssystemet (SAP-ERP) er utviklet av DFØ og estatter masterdata2-filer. Disse gir et øyeblikksbilde av de etterspurte dataene på en gitt dato. APIene er i hovedsak GET APIer, men for følgende API er det også mulig å skrive inn data:

  • ansatte

  • ansatteKurs

  • ansatteTerminovervakning

Vi tilbyr i tillegg ett API med mulighet for sletting:

  • ansatteTerminovervakning.

Dokumentasjon

For å se all dokumentasjon på et API, klikk inn på det aktuelle APIet, og klikk deretter på en av operasjonene, f.eks «GET». Da vil man se hvilke felter som er inkludert i apiet og hvor i systemet det henter data fra.  

Bestilling

For bestilling av SAP Lønnsystem-APIer fyll ut følgende bestillingsskjema og send det inn som en Kundesenter på Nett (KPN) sak til Lønnsdivisjonen. Ved spørsmål er det også mulig å ta kontakt via epost til lonn@dfo.no, men utfylt bestillingsskjema må sendes inn som KPN sak. 

Meldingskø

På flere av APIene mot lønnssystemet er det mulig å abonnere på endringsmeldinger, for å kunne agere på endringer kort tid etter at de har skjedd i systemet. Det benyttes en meldingsformidler (AMQP) for å sende ut notifikasjoner gjennom meldingsmegleren. Meldingene vil være så tynne som mulig og vil ikke inneholde noen feltverdier.  

Når en mottar en notifikasjon på en endring så kan en velge å gjøre et eget kall mot DFØ sine REST api-er basert på nøkkelverdier i notifikasjonen. Når meldingen/notifikasjonen er konsumert så forsvinner den fra køen.  

Et eksempel på hvordan en melding vil se ut:

{"firmakode":1234,"gyldigEtter":"2021-08-30","id":30001111, "feltnavn":["innehaver"],"uri":"dfo:stillinger"}

Firma = XXXX
Startdato = 01.09.2020
Stillingsnummer = 30001111
Felt som er blitt opprettet/endret= Innehaver
Tilhørende API = stillinger

Her vil man se at det er blitt lagt til en innehaver av stilling 30001111 f.o.m. 01.09.2020, og man kan hente fulle detaljer på stillinger APIet.