Endpoint URL (POST):
Estonia: https://Palk.merit.ee/api/v1/getvacoblig
Elements for Vacation Obligation request:
| APIMonthObject Field Name | Type | Comment |
|---|---|---|
| ContractCode | Str 11 | Employee contract import code in Merit Palk system OR employee Personal ID code. |
| Date | Date | Balance Date |
The result, if not empty:
| EntryRowObject Field Name | Type | Comment |
|---|---|---|
| DaysUnused | Decimal 6.2 | EN: Unused annual vacation days in total. All other objects will show other aspects of the calculation of vacation obligation balance or what is included in the total number of unused days. - ET: Kasutamata puhkusepäevad kokku. Järgmised objektid annavad lisainfot päevade osas, kuidas kasutamata puhkusepäevade jääk saadi või mida see sisaldab. |
| AdDaysUnused | Decimal 6.2 | EN: Unused extended vacation days (included in DaysUnused). Extended vacation is for employees with decreased working ability and underaged employees. - ET: Kasutamata pikendatud põhipuhkuse päevad, mis sisalduvad "Kasutamata puhkusepäevade kokku" arvu sees. Pikendatud põhipuhkust saavad kasutada vähenenud töövõimega isikud ja alaealised. |
| DaysExpired | Decimal 6.2 | EN: Expired vacation days in total - ET: Aegunud puhkusekohustuse päevad kokku |
| DaysAcquired | Decimal 6.2 | EN: Acquired vacation days in total - ET: Saadud puhkusepäevad kokku |
| DaysObligations | Decimal 6.2 | EN: Vacation liability days in total. Vacation liability days which employee has earned in total to Date. - ET: Puhkusekohustuse suurus kokku, mis töötaja on kokku etteantud kuupäevani töötamise ajal teeninud. |
| AdDaysAcquired | Decimal 6.2 | EN: Acquired extended vacation days (included in DaysAquired). - ET: Saadud/kasutatud pikendatud põhipuhkuse päevad, mis sisalduvad "Saadud puhkusepäevad kokku" arvu sees. |
| AdDaysObligations | Decimal 6.2 | EN: Extended vacation liability days (included in DaysObligations). - ET: Pikendatud põhipuhkuse välja teenitud kohustuse suurus, mis sisaldub "Puhkusekohustuse suurus kokku" arvu sees. |
The main logic (“equation”) behind how Merit Palk calculates unused vacation days is:
Vacation liability days – acquired days – expired days = unused days (included extended vacations days).
The same vacation obligation balance can be found in Merit Palk > Absences > Detailed vacation liability report.
Example of the data:
“DaysUnused”: 2.84 (including AdDaysUnused 0.17)
“AdDaysUnused”: 0.17
“DaysExpired”: 0.00
“DaysAcquired”: 3.00 (including AdDaysAcquired 1.00)
“DaysObligations”: 5.84 (including AdDaysObligations 1.17)
“AdDaysAcquired”: 1.00
“AdDaysObligations”: 1.17
The same example data in report in Merit Payroll: