Sign in

v4

OpenAPI 3.0.02026-07-314441026.8 MB
Employee Benefits

Update an employee benefit

put/employee_benefits/{employee_benefit}

Path parameters

employee_benefitstring required

Request body

business_preset_idstring
employee_benefit_type'accident_insurance_plan' | 'critical_illness' | 'debt_relief' | 'dental' | 'employee_assistance_program' | 'fondaction' | 'fondaction_rrsp' | 'fonds_solidarite_ftq' | 'fonds_solidarite_ftq_rrsp' | 'group_dependent_life_insurance' | 'group_term_life_insurance' | 'health' | 'health_spending_account' | 'long_term_disability' | 'non_group_long_term_disability' | 'non_group_short_term_disability' | 'pension_dbpp' | 'pension_dcpp' | 'pension_mfpp' | 'pension_prpp' | 'pension_restricted_rrsp' | 'pension_rrsp' | 'pension_rrsp_non_periodic' | 'pension_unregistered_prpp' | 'pension_vrsp' | 'profit_sharing_dpsp' | 'savings_tfsa' | 'second_opinion_medical_consultation' | 'short_term_disability' | 'virtual_health_service' | 'wellness_spending_account'

The type of employee benefit, which determines how it is taxed and reported.

remittance_account_idstring

The remittance account to which collected benefit amounts are remitted.

amountnumber

The contribution amount per pay period. When amount_type is percent, this is interpreted as a percentage of the income basis (0-100); otherwise as a fixed dollar amount.

amount_type'fixed' | 'percent'

Whether amount is a fixed dollar value (fixed) or a percentage of the income basis (percent).

income_basis'all_earnings' | 'none' | 'regular_earnings' | 'total_income'

Determines the income used as the base for percentage-based benefit calculations. regular_earnings includes only salary and wage earnings. all_earnings includes all earnings. total_income includes all earnings, taxable allowances, and taxable reimbursements. none doesn't include any line items, and can be used with income_includes for completely custom definitions of income.

coverage_multipliernumber

A multiplier applied to the Employee's earnings to determine the benefit coverage amount, used for coverage-based benefits such as life insurance.

max_annual_contributionnumber

The maximum dollar amount that will be contributed in a calendar year. Contributions stop once this limit is reached.

max_annual_contribution_basis'all_line_items_of_type' | 'this_benefit'

Whether max_annual_contribution accumulates across pay periods or applies as a fixed per-period cap.

frequency'once' | 'per_month' | 'per_payroll'

The frequency at which this benefit is applied to Pay Stubs. When per_month, the amount is distributed across the selected Payrolls in the calendar month. per_month requires amount_type to be fixed.

effective_fromstring date

The date from which this benefit is applied to Pay Stubs.

effective_tostring date

The date after which this benefit is no longer applied. null if the benefit applies indefinitely.

apply_sales_taxboolean

Whether provincial sales tax is applied to the benefit amount.

expense_accounting_code_idstring
liability_accounting_code_idstring
titlestring nullable
external_refstring
date_basis'by_pay_date' | 'by_period_end_date' | 'by_period_start_date'

Which payroll date determines the calendar month for the allocation. Applies only to per_month benefits.

pay_period_cadenceinteger[]

Which pay periods within the month receive the allocation. An array of 1-based positions; -1 is the final period. Applies only to per_month benefits.

Response

OK

idstring

The unique identifier of the object in Nmbr.

objectstring

The type of the object in Nmbr ("employee_benefit").