Accrual Policy Object

The Accrual Policy Object represents a PTO, sick leave, or custom accrual policy that can be created for a company and assigned to respective company employees.

attributetypedescription
companyIDstringZeal Company ID
policy_codestringCustom code that can be assigned for the policy
policy_typeenumType of the accrual policy (accepts: pto, sick_leave, or custom)
policy_namestringCustom name that can be assigned for the policy
policy_effective_dateYYYY-MM-DDThe effective start date of the policy
accrual_rate_hoursfloatThe rate at which employees will accrue hours
accrual_period_hoursfloatThe number of hours employees need to work to accrue accrual_rate_hours
immediate_balancefloatThe immediate hour balance the employee would receive
include_doubletimebooleanInclude if double-time work is eligible for hour accrual
include_overtimebooleanInclude if overtime work is eligible for hour accrual
include_flatbooleanInclude if flat earning component is eligible for accrual
accrual_waiting_periodfloatThe number of hours the employees need to work before they are eligible to begin accruing time for policy
accrual_capfloatThe maximum number of hours an employee can accrue within a policy year. Once this limit is reached, no additional hours will accrue until the next accrual period or rollover date.
rollover_capfloatThe maximum number of unused hours an employee is allowed to carry over from one policy year to the next on the specified rollover date.
rollover_datefloatRequired if the user passes a value for rollover_cap or accrual_cap
balance_capfloatThe maximum balance an employee is allowed to hold under this policy. Once this limit is reached, no additional hours will accrue until the balance drops below the cap.
accrual_start_after_daysfloatThe number of calendar days after the employees' start date before they begin accruing time for the policy
{
  "companyID": "fc235f012bae46aa8a082f357715bcfa",
  "policy_code": "001",
  "policy_type": "pto",
  "policy_name": "test name",
  "policy_effective_date": "2023-03-01",
  "accrual_rate_hours": 10,
  "accrual_period_hours": 40,
  "immediate_balance": 0,
  "include_doubletime": true,
  "include_overtime": true,
  "include_flat": false,
  "accrual_waiting_period": 0,
  "accrual_cap": 100,
  "rollover_cap": 40,
  "rollover_date": "01-01",
  "policy_status": "live",
  "balance_cap": 100,
  "accrual_start_after_days": 0
}