Dutch vacation configuration FAQ

Updated by Daniel Sjögren

Q: How can we get an overview/report of the vacation balances, split by statutory and non-statutory hours?

A: Currently, it is not possible to retrieve this overview via a Quinyx report, however, it is possible to get Statutory and Non-Staturory balances via API.

Read more about Get Statutory and Non-Statutory balances for Time Tracker with a First To Expire Deduction order here.
Q : What if I have employees starting during the year?

A: If the agreements connected to the agreement template where Time Tracker association is defined would be part of the year. Quinyx will calculate the hours automatically based on the agreement period and employment rate on the agreement. This also applies if the employment rate by date is updated on an individual agreement.

Q : What if I have employees changing employment rate during the year?

If employment rate by date is updated on an individual agreement connected to the agreement template where Time Tracker association is defined. Quinyx will calculate the hours automatically based on the agreement period and employment rates on the agreement.

Q : What if I need to manage statutory hours manually?

A : When adding a new Time Tracker transaction from the Time card, you can choose if it should affect statutory or statutory hours. This is also supported in the Web Service API wsdlUpdateTimeTrackers .

Q : What if I want the employees to accrue the hour per day the agreement has been active?

A : We don't support accruing of the vacation hours because of the specific logic where taken vacation needs to know what is to expire first. With our current implementation to support that deduction and carry over, we can't support both options.

Q : What if I want the employees to have multiple overlapping agreements and first to expire option?

A : We don't support multiple overlapping agreements. This is because of the specific logic where taken vacation needs to know what is to expire first.

Q : What if I want to see the balance as per a selected date?

A : Currently we only support viewing balances as per defined hardcoded expiry dates. This is explained in more detail here.

Q: How does the system handle retroactive leave deletions and balance recalculations?

A: When a past holiday is deleted, the system automatically recalculates statutory and non-statutory leave balances. This can be achieved by unlocking the TTP period and making changes to the past leave request. For Agreement-template-based TT associations, this calculation happens automatically. For Salary-based TT associations (connecting salary types to time trackers), the TTP period must be locked again to ensure correct balance calculations.

Q: I’m seeing a discrepancy in the Time Tracker balance for a specific year, especially after the statutory balance resets. Why is this happening?

A: After the statutory balance resets (typically yearly), you might notice that the non-statutory Time Tracker balance also appears to reset or show unexpected values. This can lead to temporary discrepancies between the actual Time Tracker balances and the values displayed in the timecard.

This happens because:

  • All salary transactions older than 62 days from the current date are expected to have been transferred to payroll and stored in the salary database.
    • Time Tracker balances are calculated based on these payroll-transferred salary types.
    • If a salary type hasn’t yet been transferred (e.g., if it’s less than 62 days old), the Non-Statutory balance may appear incorrect.

Once the relevant salary period is transferred to payroll, the non-statutory Time Tracker balance will correct itself.

Note: Reverting the TTP (Time Tracker Processing) period for that salary type will also restore the Time Tracker balance to its previous state.
This behaviour applies only to Time Tracker transactions generated from Salary types.
Q: How does the system recalculate leave balances when contract hours change?

A: When an employee’s working hours change mid-year, their leave entitlement will be adjusted accordingly. This can be achieved by either of the following methods in Quinyx:

  • Adjusting the employment rate in the agreement templates (e.g. from full-time to part-time) → this will trigger automatic recalculations of the relevant time trackers. OR
  • Adjusting the working hours in the agreement template AND the Time tracker accrual factor (Note: in this case, both changes are required to achieve the outcome. And changes must be made to the agreement template and not the agreement itself)
We have extensive documentation about "Dutch vacation" configuration here.


How Did We Do?