Statutory Holiday Pay

• Which holidays are statutory holidays and when they are observed. For example, Boxing Day is a statutory holiday in Ontario but not Alberta.
• How many days or weeks of earnings to include when calculating statutory holiday pay. For example, Prince Edward Island considers 30 days of earnings, Yukon considers 2 weeks of earnings, Quebec considers 4 weeks of regular earnings and 12 weeks of commission, etc.
• Which earning types are included in the statutory holiday pay calculation. For example, not all provinces include bonuses.

​

Enabling Statutory Holiday Pay

• calculate_entitlement (boolean, optional) - Whether to calculate the entitlement amount (true) or default to a $0 amount that can be overridden by the end user (false). Defaults to false.
• calculation_strategy (enum, optional) - Which strategy to use for calculating the entitlement amount. Defaults to provincial_rules_only. Must be one of:
  • provincial_rules_only: Calculate the entitlement amount using the work assignment’s Province of Work (POW)‘s rules. See Provincial Rules Calculations below.
  • hours_only: Calculate the entitlement amount as a fixed number of hours at one of the work assignment’s hourly pay rates. See Fixed Hours Calculations below.
  • provincial_rules_or_hours: Calculate the entitlement amount using both strategies and use whichever amount is greater. This lets the employer guarantee the employee a minimum number of paid hours per holiday while still paying out more when provincial rules require it (for example, when commissions push the provincial amount above the minimum).

​

Provincial Rules Properties

• override_rule_set (string, optional) - Override the work assignment’s Province of Work and use a different province or territory’s rules for statutory holiday pay.
• override_date_basis (enum, optional) - Override the selected province or territory’s date basis for calculating statutory holiday pay. Must be one of:
  • before_holiday_day: Calculates statutory holiday pay based on included earnings over a period ending the day before the holiday is observed.
  • before_holiday_week: Calculates statutory holiday pay based on included earnings over a period ending the day before the holiday week begins. The beginning of the holiday week isn’t necessarily the beginning of the calendar week the holiday is in. Nmbr calculates the beginning of the holiday week by taking the pay period start date and adding whole weeks until the date is less than a week before the holiday. This helps reduce proration (see below) for provinces that look at earnings over a period of weeks rather than days.
  • before_holiday_pay_period: Calculates statutory holiday pay based on included earnings over a period ending the day before the holiday pay period begins.

​

Fixed Hours Properties

• hours (number, required) - The number of hours to pay the employee for each statutory holiday. Must be between 0 and 40.
• pay_rate (enum, required) - Which of the work assignment’s hourly pay rates to use when calculating the fixed-hours amount. A work assignment may have multiple hourly pay rates effective on the holiday’s observed date, so this selector specifies how to pick one. Must be one of:
  • highest_rate: The pay rate with the highest hourly rate.
  • highest_expected_hours_per_week: The pay rate with the highest expected_hours_per_week.
  • highest_expected_weekly_amount: The pay rate with the highest expected weekly amount (rate × expected_hours_per_week).
  • earliest_effective_from: The pay rate with the earliest effective_from date.
  • latest_effective_from: The pay rate with the latest effective_from date.
  Ties are broken by the highest rate, then the earliest effective_from date, then the earliest id. If the work assignment has no hourly pay rate effective on the holiday’s observed date, the fixed-hours amount is $0.

​

Examples

  "value": {}

  "value": {
    "calculate_entitlement": true
  }

  "value": {
    "calculate_entitlement": true,
    "override_date_basis": "before_holiday_pay_period"
  }

  "value": {
    "calculate_entitlement": true,
    "override_rule_set": "ON"
  }

  "value": {
    "calculate_entitlement": true,
    "override_rule_set": "ON",
    "override_date_basis": "before_holiday_pay_period"
  }

  "value": {
    "calculate_entitlement": true,
    "calculation_strategy": "hours_only",
    "hours": 8,
    "pay_rate": "highest_rate"
  }

  "value": {
    "calculate_entitlement": true,
    "calculation_strategy": "provincial_rules_or_hours",
    "hours": 8,
    "pay_rate": "highest_rate"
  }

​

Fixed Hours Calculations

​

Provincial Rules Calculations

​

Earned-On Dates

• managed_earned_on - The system-assigned earned-on date.
• custom_earned_on - An override you can set via the API or Portal. Must fall within the payroll’s pay period.
• earned_on — The effective value: custom_earned_on if set, managed_earned_on otherwise. Read-only.

​

Proration

• Use a weekly or bi-weekly pay frequency.
• Set override_rule_set to a province or territory whose entitlement amount calculations are based on an even number of weeks.
• Set override_date_basis to before_holiday_pay_period.

​

Statutory Holiday Pay on Statutory Holiday Pay

​

Limitations