Her finner du informasjon om hvordan API kan benyttes for å hente ut fravær fra Capitech for gjenbruk i andre systemer.
Fravær i Capitech kan hentes ut på to nivå:
A. Fravær pr ansatt og periode
Dette er et nivå mange system bruker hvor en i hovedtrekk har hvilken ansatt, fraværskode, fra og til dato samt fraværsprosent mv.
For dette benyttes API endepunkt api/public/v1/Absence/getAbsence
B. Fravær pr ansatt og periode med klokkeslett og timer pr dag
Dette er et mer detaljert nivå med detaljert informasjon om klokkeslett og antall timer fravær for hver dag. Om det benyttes plan modul kan det også være flere vakter med fravær på samme dag og dermed flere sett med klokkeslett og timer på samme dag.
For dette benyttes API endepunkt api/public/v1/Absence/getAbsenceTransactions
Absence API - getAbsence
Fravær pr ansatt pr periode
Beskrivelse av Request parametere
Her er en beskrivelse og forklaring av hvilke parametre en kan benytte for å hente ut fravær. En kan få mer detaljer via mouseover på hhv. request parameter og retur felter i API oversikt.
| Parameter | Påkrevd | Beskrivelse | Merknad |
|---|---|---|---|
| accessToken | Ja | Token fra Login. | Kreves for å få svar på API request |
| clientId | Ja | Klientnummer for hvilket firma en skal hente timer på | |
| fromDate | Ja | Fradato for ønsket periode i format 'yyyy-mm-dd' | Fra og med |
| toDate | Ja | Tildato for ønsket periode i format 'yyyy-mm-dd' | Til og med |
| updateFromDateFilter | Nei | Filter for å kun hente fravær som er oppdatert etter angitt dato. Format: 'yyyy-mm-dd' | |
| absenceIdFilter | Nei | Filter for å kun hente fravær med angitt id | |
| employeeIdFilter | Nei | Filter for å kun hente fravær på angitte ansattnr | |
| departmentIdFilter | Nei | Filter for å hente kun fravær på angitte avdelingsnr | |
| absenceCodeFilter | Nei | Filter for å hente kun fravær på angitte Capitech fraværskoder | Eksempel AVS for avspasering eller BAR for barns sykdom, dette er avhengig av kundens oppsett av fraværskoder. |
| absenceTypeFilter | Nei | Filter for å hente kun fravær på angitte Capitech fraværstyper | Dette er faste systemtyper i Capitech fravær uavhengig av kundens oppsett 1: Fravær |
Returdata
Her er en beskrivelse og forklaring av returdata en får fra dette fravær API og hva det i praksis kan benyttes til.
| Felt | Beskrivelse | Eksempel | Merknad |
|---|---|---|---|
| absenceId | Fraværsid | 488788 | En unik id for hvert enkelt fravær |
| clientid | Klientnr | 100 | Klientnr er et unikt nr for hvert enkelt firma. For konsernkunder kjøres en request for hvert enkelt firma. |
| employeeid | Ansattnr | 155 | |
| employee | ansattnavn | Ola Danielsen | |
| absenceCode | Fraværskode | EGM | Fraværskode er et konfigurerbart oppsett pr klient (firma) |
| absenceDescription | Fraværskode navn | Egenmelding | |
| absenceType | Fraværstype | 1 | Dette er faste systemtyper i Capitech fravær uavhengig av kundens oppsett 1: Fravær |
| fromDate | Fravær startdato | 2021-07-10 | Dato fraværet starter |
| endDate | Fravær sluttdato | 2021-07-10 | Dato fraværet slutter |
| starttime | Fravær fra klokkeslett | 08:00:00.000 | Kun utfylt dersom dette er angitt av bruker og likt for alle dager i perioden Fravær klokkeslett beregnes iht. avtalt arbeidstid i Capitech og kan variere fra dag til dag. |
| endtime | Fravær til klokkeslett | 16:00:00.000 | Kun utfylt dersom dette er angitt av bruker og likt for alle dager i perioden. Fravær klokkeslett beregnes iht. avtalt arbeidstid i Capitech og kan variere fra dag til dag. |
| hours | Timer | 7.50 | Antall timer fravær |
| absencePercent | Fraværsprosent | 100 | Default 100%, kan angis til f. eks 50% i graderte sykemeldinger mv. |
| departmentId | Avdelingsnr | 50 | Nr på avdelingen fraværet er registrert på |
| department | Avdeling navn | Logistikk | Navn på avdelingen fraværet er registrert på |
| createdOn | Opprettet dato og klokkeslett | 2021-07-10 08:02:00.000 | |
| createdBy | Brukernavn som opprettet fraværet | trineg | |
| updatedOn | Sist endret dato og klokkeslett | 2021-07-11 14:05:00.000 | |
| updateBy | Brukernavn som sist endret fraværet | larsb |
Visste du at ....