
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 = XXXXStartdato = 01.09.2020Stillingsnummer = 30001111Felt som er blitt opprettet/endret= InnehaverTilhø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.