Lønnssystem

APIene mot lønnssystemet (SAP-ERP) er utviklet av DFØ og erstatter masterdata2-filer. Disse gir et øyeblikksbilde av de etterspurte dataene på en gitt dato.  

På alle lønnssystem-APIene er det mulig å gjøre spørringer frem og tilbake i tid, for å få øyeblikksbilder for en annen dato enn dagens. For å gjøre dette må man legge inn en header med navn “dato” og legge inn dato med format ÅÅÅÅMMDD. Hvis man ikke legger inn dette vil spørringen gjøres på dagens 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 to APIer med mulighet for sletting:

• ansatteTerminovervakning

• ansatteKurs

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.