Swedish Vacation

Swedish Vacation plugin configuration
Swedish Vacation plugin configuration

The Swedish Vacation plugin implements vacation accrual according to the Swedish vacation act (semesterlagen). It grants whole vacation days once per vacation year, prorated by employment days with the statutory round-up rule, and expires them at the end of the vacation year they belong to.

When to use

Use this plugin when:

  • You follow Swedish vacation rules
  • Employees earn 25 (or more) vacation days per year
  • You want the statutory proration: paid days are calculated from employment days and always rounded up to whole days

Parameters

ParameterDescriptionDefault
Days per yearAnnual vacation entitlement. The statutory minimum is 25 days; collective agreements may grant more.25
ModelDeferred (statutory): days are earned during one vacation year and granted at the start of the next. Same year (advance): days are granted in advance at the start of the year they are earned in, as in many collective agreements.Deferred
Year start monthThe month the vacation year starts. The statutory year runs April to March; calendar-year agreements use January.April

How it works

Once per vacation year, the plugin grants a single lump sum of whole days:

  1. The employee’s employment days during the earning year are counted
  2. Paid days = employment days ÷ days in the year × the annual entitlement
  3. A fractional result always rounds up to the next whole day (semesterlagen §7)
  4. With the deferred model the grant lands on the first day of the following vacation year; with the same-year model it lands on the first day of the year itself — or on the hire date for employees who start mid-year

Automatic expiration

Granted days expire at the end of the vacation year they belong to (March 31 with the statutory April year). Days that should be saved beyond that (sparade dagar, days above 20) are not moved automatically yet — handle them with a manual adjustment until carryover support lands.

Important: If you add an expiration plugin to the policy, it overrides the automatic expiration dates set by the Swedish Vacation plugin.

Proration example

An employee hired on 1 January with the statutory April year and 25 days per year:

Employment days in the earning year (1 Jan – 31 Mar)90
Days in the earning year365
25 × 90 ÷ 3656.16
Granted on 1 April (rounded up)7 days

Examples

Statutory Swedish vacation

  1. Add a new time-off policy
  2. Select the Swedish Vacation accrual plugin
  3. Set Days per year to 25 and keep Model on Deferred (statutory)

Collective agreement with same-year vacation

For agreements where the earning year and vacation year coincide with the calendar year:

  1. Add the Swedish Vacation plugin
  2. Set Model to Same year (advance) and Year start month to January

Troubleshooting

IssueSolution
New hire received no daysUnder the deferred model, employees hired during the vacation year have earned nothing in the previous earning year. Their first paid days arrive at the next year start. Switch to the same-year model to grant days in advance.
Fractional days expectedThe plugin intentionally grants whole days only — semesterlagen prescribes rounding up to whole days. Use Yearly Accrual if you need fractional proration.
Days above 20 should be saved, not expireAutomatic carryover to a saved-days account is not supported yet; record a manual adjustment before the year ends.