You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

Get all absences for all or specific employees.

Description

GET /absence_management/get_absences.php?company=RTI_COMPANYKEY&import=RTI_IMPORTKEY

Parameter

parameter

description

type

hint

mandatory

companyRTI company keystring
yes
importRTI import keystring
yes
employeeNumbersarray of employee numbersjson

Restriction to specific employees

If this parameter is not set, all absences of all employees, who own an employee number, will be returned

Format: [ 'NR1','NR2', ... ]

no
withHolidaysreturn holidays as wellbool

Each employee can be assigned to a holiday profile. If this parameter is active, the holidays will be returned as absences as well. You can recognize such entries by the atrribute isHoliday = true. 

Default: true

no
withDeletedreturn deleted absences as wellbool

Deleted absences are not returned by default. You can change this by setting this parameter to true. You can recognize such entries by the attribute "deleteDate" being set.

Default: false

no

Return value

A string in Json format is returned. Returns "ERROR:description" on error.


Attributes

attribute

format

description

employeeNumberstringemployee number for identification
createDate

string (according to ISO 8601) | null

create date of entry
deleteDatestring (according to ISO 8601) | nulldelete date of entry
startDatestring (according to ISO 8601)begin of absence
endDatestring (according to ISO 8601)end of absence
factorfloat

share of working day based on assigned work profile

value is between 0 and 1 with 1 being equivalent to a full day

typestringshort name of absence type according to portal settings
remarkstring | nulloptional description text
isRestTimeboolflag if this absence is an annual leave
isFlexTimeboolflag if this absence is subtracted from flex time account
isHolidayboolflag if this absence is a holiday according to assigned holiday profile

ignored

  • weekDays
  • calendarDays

object

  • int[]
  • string[] (according to ISO 8601)

Absences with a long duration might exclude some days in between.

weekDays: numbers of weekdays (value 0 to 6 = sunday to saturday), e.g. weekend

calendarDays: explicit dates, e.g. a holiday


Example

[
    {
        "employeeNumber": "0815",
        "createDate": "2021-04-15T13:53:23+02:00",
        "deleteDate": null,
        "startDate": "2021-03-08T00:00:00+01:00",
        "endDate": "2021-03-08T23:59:59+01:00",
        "factor": 1,
        "type": "BA",
        "remark": null,
        "isRestTime": false,
        "isFlexTime": false,
        "isHoliday": false,
        "ignored": {
            "weekDays": [],
            "calendarDays": []
        }
    },
	...
]



  • No labels