Absence scenario is a scenario when you want to get or insert absence information for an employee. Users are free to register basic absence information or to work with absence XML. This article will provide you with general information about what you will have to take into account.
When starting with this scenario we assume that Getting started API is known.
Debtor, company and employee
Before you are going to send the information you have to know the employees, companies and debtors.
- To get the debtor use methods List_GetAll or List_GetByNumber from Debtor Service.
- To get the company use methods List_GetAll or List_GetByDebtor from Company Service.
- To get the employee use methods List_GetByCompany or List_GetByDebtor from Employee Service.
When employee is sick you can register the sickness in Nmbrs. When employee gets (partially) better you register this action as well. For more information about absence see Verzuim (dutch only).
Every employee in Nmbrs has to have a schedule. The sickness days will be calculated according to the schedule of the employee. However, the schedule of an employee is not a part that should be taken into account for the integration, we think it is relevant to know.
There are three types of employees:
- Full time employee is an employee with the schedule the same as company schedule.
- Part-time employee is an employee with a schedule less then company schedule. His schedule can not be zero.
- Employees without a schedule. If an employee is working not on regular basis he has to have a schedule where all hours are zero.
To get the company schedule see method from Company Service below:
For all schedule methods of an employee search for "Schedule" on Employee Service.
When registrating absence you have an option to create/send absence XML as well. Absence XML is a standard format that occupational health services, such as ArboNed, Arbo Unie, Achmea Arbo, UWV and others, use to process absence in their application. We work with XML standard version 1 of 1 May 2006.
You will have to set up occupational health service with type email before the system will create an XML. For more information about how to set up see Email koppelen (dutch only).
After you create an absence for an employee through interface or API, an absence XML will be created.