Create an employer benefit

Must belong to a work assignment associated with an entity of type Employee.

The type of employer benefit, which determines how it is categorized and reported.

Must be present when business_preset_id is either empty or not set.

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.

The contribution amount per pay period. When amount_type is percent, this is interpreted as a percentage of the income basis (0-100). When fixed_per_hour, it is multiplied by the hours on the Pay Stub's earning line items selected by hours_basis and hours_includes. Otherwise it is a fixed dollar amount.

Up to 2 decimal places.

Whether amount is a fixed dollar value (fixed), a dollar value per hour worked (fixed_per_hour), or a percentage of the income basis (percent).

Which earnings' hours a fixed_per_hour benefit multiplies amount by. all_earnings includes the hours on all earnings. regular_earnings includes only the hours on salary and wage earnings. none doesn't include any earnings, and can be used with hours_includes to count only the hours on specific earnings. Defaults to all_earnings, and can only be changed when amount_type is fixed_per_hour.

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.

The most this benefit will contribute in a tax year, including sales tax when apply_sales_tax is true. Once the contributions on approved payrolls in the tax year reach this maximum, contributions stop until the next tax year, and the Pay Stub that reaches it contributes only the remainder. Changing it later changes the limit, not the remaining amount: contributions already made in the tax year still count toward it.

Up to 2 decimal places.

Which earlier contributions count toward max_annual_contribution. this_benefit counts only the contributions on line items created by this benefit earlier in the tax year. all_line_items_of_type counts every contribution of the same type on the Work Assignment earlier in the tax year, including those created by other benefits and those added directly to a Pay Stub.

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

Up to 2 decimal places.

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

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

Whether provincial sales tax is applied to the benefit amount.

The remittance account to which collected benefit amounts are remitted.

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

The unique identifier of the object in Nmbr.

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