curl --request POST \
--url https://sandbox.nmbr.co/services/payroll/employee_benefits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"work_assignment_id": "<id>",
"employee_benefit_type": "dental",
"frequency": "per_month",
"amount": "325.5",
"amount_type": "fixed",
"income_basis": "regular_earnings",
"max_annual_contribution": "2500.5",
"max_annual_contribution_basis": "this_benefit",
"coverage_multiplier": "1",
"effective_from": "2026-01-01",
"effective_to": "2026-12-31",
"apply_sales_tax": false,
"title": "Dental",
"title_translations": {
"en": "Dental",
"fr": "Assurance dentaire"
},
"external_ref": "01KG003XG877R33YKHA40HJP84",
"tag_assignment": {
"unit": "percentage",
"tag_allocations": [
{
"tags": [
"<id>"
],
"value": 100
}
]
},
"date_basis": "by_period_start_date",
"pay_period_cadence": [
1
]
}
'import requests
url = "https://sandbox.nmbr.co/services/payroll/employee_benefits"
payload = {
"work_assignment_id": "<id>",
"employee_benefit_type": "dental",
"frequency": "per_month",
"amount": "325.5",
"amount_type": "fixed",
"income_basis": "regular_earnings",
"max_annual_contribution": "2500.5",
"max_annual_contribution_basis": "this_benefit",
"coverage_multiplier": "1",
"effective_from": "2026-01-01",
"effective_to": "2026-12-31",
"apply_sales_tax": False,
"title": "Dental",
"title_translations": {
"en": "Dental",
"fr": "Assurance dentaire"
},
"external_ref": "01KG003XG877R33YKHA40HJP84",
"tag_assignment": {
"unit": "percentage",
"tag_allocations": [
{
"tags": ["<id>"],
"value": 100
}
]
},
"date_basis": "by_period_start_date",
"pay_period_cadence": [1]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
work_assignment_id: '<id>',
employee_benefit_type: 'dental',
frequency: 'per_month',
amount: '325.5',
amount_type: 'fixed',
income_basis: 'regular_earnings',
max_annual_contribution: '2500.5',
max_annual_contribution_basis: 'this_benefit',
coverage_multiplier: '1',
effective_from: '2026-01-01',
effective_to: '2026-12-31',
apply_sales_tax: false,
title: 'Dental',
title_translations: {en: 'Dental', fr: 'Assurance dentaire'},
external_ref: '01KG003XG877R33YKHA40HJP84',
tag_assignment: {unit: 'percentage', tag_allocations: [{tags: ['<id>'], value: 100}]},
date_basis: 'by_period_start_date',
pay_period_cadence: [1]
})
};
fetch('https://sandbox.nmbr.co/services/payroll/employee_benefits', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.nmbr.co/services/payroll/employee_benefits",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'work_assignment_id' => '<id>',
'employee_benefit_type' => 'dental',
'frequency' => 'per_month',
'amount' => '325.5',
'amount_type' => 'fixed',
'income_basis' => 'regular_earnings',
'max_annual_contribution' => '2500.5',
'max_annual_contribution_basis' => 'this_benefit',
'coverage_multiplier' => '1',
'effective_from' => '2026-01-01',
'effective_to' => '2026-12-31',
'apply_sales_tax' => false,
'title' => 'Dental',
'title_translations' => [
'en' => 'Dental',
'fr' => 'Assurance dentaire'
],
'external_ref' => '01KG003XG877R33YKHA40HJP84',
'tag_assignment' => [
'unit' => 'percentage',
'tag_allocations' => [
[
'tags' => [
'<id>'
],
'value' => 100
]
]
],
'date_basis' => 'by_period_start_date',
'pay_period_cadence' => [
1
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sandbox.nmbr.co/services/payroll/employee_benefits"
payload := strings.NewReader("{\n \"work_assignment_id\": \"<id>\",\n \"employee_benefit_type\": \"dental\",\n \"frequency\": \"per_month\",\n \"amount\": \"325.5\",\n \"amount_type\": \"fixed\",\n \"income_basis\": \"regular_earnings\",\n \"max_annual_contribution\": \"2500.5\",\n \"max_annual_contribution_basis\": \"this_benefit\",\n \"coverage_multiplier\": \"1\",\n \"effective_from\": \"2026-01-01\",\n \"effective_to\": \"2026-12-31\",\n \"apply_sales_tax\": false,\n \"title\": \"Dental\",\n \"title_translations\": {\n \"en\": \"Dental\",\n \"fr\": \"Assurance dentaire\"\n },\n \"external_ref\": \"01KG003XG877R33YKHA40HJP84\",\n \"tag_assignment\": {\n \"unit\": \"percentage\",\n \"tag_allocations\": [\n {\n \"tags\": [\n \"<id>\"\n ],\n \"value\": 100\n }\n ]\n },\n \"date_basis\": \"by_period_start_date\",\n \"pay_period_cadence\": [\n 1\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://sandbox.nmbr.co/services/payroll/employee_benefits")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"work_assignment_id\": \"<id>\",\n \"employee_benefit_type\": \"dental\",\n \"frequency\": \"per_month\",\n \"amount\": \"325.5\",\n \"amount_type\": \"fixed\",\n \"income_basis\": \"regular_earnings\",\n \"max_annual_contribution\": \"2500.5\",\n \"max_annual_contribution_basis\": \"this_benefit\",\n \"coverage_multiplier\": \"1\",\n \"effective_from\": \"2026-01-01\",\n \"effective_to\": \"2026-12-31\",\n \"apply_sales_tax\": false,\n \"title\": \"Dental\",\n \"title_translations\": {\n \"en\": \"Dental\",\n \"fr\": \"Assurance dentaire\"\n },\n \"external_ref\": \"01KG003XG877R33YKHA40HJP84\",\n \"tag_assignment\": {\n \"unit\": \"percentage\",\n \"tag_allocations\": [\n {\n \"tags\": [\n \"<id>\"\n ],\n \"value\": 100\n }\n ]\n },\n \"date_basis\": \"by_period_start_date\",\n \"pay_period_cadence\": [\n 1\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.nmbr.co/services/payroll/employee_benefits")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"work_assignment_id\": \"<id>\",\n \"employee_benefit_type\": \"dental\",\n \"frequency\": \"per_month\",\n \"amount\": \"325.5\",\n \"amount_type\": \"fixed\",\n \"income_basis\": \"regular_earnings\",\n \"max_annual_contribution\": \"2500.5\",\n \"max_annual_contribution_basis\": \"this_benefit\",\n \"coverage_multiplier\": \"1\",\n \"effective_from\": \"2026-01-01\",\n \"effective_to\": \"2026-12-31\",\n \"apply_sales_tax\": false,\n \"title\": \"Dental\",\n \"title_translations\": {\n \"en\": \"Dental\",\n \"fr\": \"Assurance dentaire\"\n },\n \"external_ref\": \"01KG003XG877R33YKHA40HJP84\",\n \"tag_assignment\": {\n \"unit\": \"percentage\",\n \"tag_allocations\": [\n {\n \"tags\": [\n \"<id>\"\n ],\n \"value\": 100\n }\n ]\n },\n \"date_basis\": \"by_period_start_date\",\n \"pay_period_cadence\": [\n 1\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "<id>",
"object": "employee_benefit",
"data": {
"work_assignment": {
"id": "<id>",
"object": "work_assignment",
"links": {
"self": "/work_assignments/<id>"
}
},
"business_preset": null,
"employee_benefit_type": {
"id": "<id>",
"object": "employee_benefit_type",
"data": {
"type": "dental",
"label": "Dental"
},
"links": {
"self": "/employee_benefit_types/dental"
}
},
"employer_benefit": null,
"title": "Dental",
"title_translations": {
"en": "Dental",
"fr": "Assurance dentaire"
},
"title_translated": "Dental",
"income_basis": "regular_earnings",
"income_includes": [],
"max_annual_contribution_basis": "this_benefit",
"apply_sales_tax": false,
"remittance_account_id": null,
"remittance_account": null,
"amount": 325.5,
"amount_type": "fixed",
"coverage_multiplier": 1,
"max_annual_contribution": 2500.5,
"frequency": "per_month",
"date_basis": "by_period_start_date",
"pay_period_cadence": [
1
],
"effective_from": "2026-01-01",
"effective_to": "2026-12-31",
"expense_accounting_code": null,
"liability_accounting_code": null,
"external_ref": "01KG003XG877R33YKHA40HJP84",
"created_at": "2026-01-01T00:00:00.000000Z",
"updated_at": "2026-01-01T00:00:00.000000Z"
},
"links": {
"self": "/employee_benefits/<id>"
}
}Create an employee benefit
curl --request POST \
--url https://sandbox.nmbr.co/services/payroll/employee_benefits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"work_assignment_id": "<id>",
"employee_benefit_type": "dental",
"frequency": "per_month",
"amount": "325.5",
"amount_type": "fixed",
"income_basis": "regular_earnings",
"max_annual_contribution": "2500.5",
"max_annual_contribution_basis": "this_benefit",
"coverage_multiplier": "1",
"effective_from": "2026-01-01",
"effective_to": "2026-12-31",
"apply_sales_tax": false,
"title": "Dental",
"title_translations": {
"en": "Dental",
"fr": "Assurance dentaire"
},
"external_ref": "01KG003XG877R33YKHA40HJP84",
"tag_assignment": {
"unit": "percentage",
"tag_allocations": [
{
"tags": [
"<id>"
],
"value": 100
}
]
},
"date_basis": "by_period_start_date",
"pay_period_cadence": [
1
]
}
'import requests
url = "https://sandbox.nmbr.co/services/payroll/employee_benefits"
payload = {
"work_assignment_id": "<id>",
"employee_benefit_type": "dental",
"frequency": "per_month",
"amount": "325.5",
"amount_type": "fixed",
"income_basis": "regular_earnings",
"max_annual_contribution": "2500.5",
"max_annual_contribution_basis": "this_benefit",
"coverage_multiplier": "1",
"effective_from": "2026-01-01",
"effective_to": "2026-12-31",
"apply_sales_tax": False,
"title": "Dental",
"title_translations": {
"en": "Dental",
"fr": "Assurance dentaire"
},
"external_ref": "01KG003XG877R33YKHA40HJP84",
"tag_assignment": {
"unit": "percentage",
"tag_allocations": [
{
"tags": ["<id>"],
"value": 100
}
]
},
"date_basis": "by_period_start_date",
"pay_period_cadence": [1]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
work_assignment_id: '<id>',
employee_benefit_type: 'dental',
frequency: 'per_month',
amount: '325.5',
amount_type: 'fixed',
income_basis: 'regular_earnings',
max_annual_contribution: '2500.5',
max_annual_contribution_basis: 'this_benefit',
coverage_multiplier: '1',
effective_from: '2026-01-01',
effective_to: '2026-12-31',
apply_sales_tax: false,
title: 'Dental',
title_translations: {en: 'Dental', fr: 'Assurance dentaire'},
external_ref: '01KG003XG877R33YKHA40HJP84',
tag_assignment: {unit: 'percentage', tag_allocations: [{tags: ['<id>'], value: 100}]},
date_basis: 'by_period_start_date',
pay_period_cadence: [1]
})
};
fetch('https://sandbox.nmbr.co/services/payroll/employee_benefits', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.nmbr.co/services/payroll/employee_benefits",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'work_assignment_id' => '<id>',
'employee_benefit_type' => 'dental',
'frequency' => 'per_month',
'amount' => '325.5',
'amount_type' => 'fixed',
'income_basis' => 'regular_earnings',
'max_annual_contribution' => '2500.5',
'max_annual_contribution_basis' => 'this_benefit',
'coverage_multiplier' => '1',
'effective_from' => '2026-01-01',
'effective_to' => '2026-12-31',
'apply_sales_tax' => false,
'title' => 'Dental',
'title_translations' => [
'en' => 'Dental',
'fr' => 'Assurance dentaire'
],
'external_ref' => '01KG003XG877R33YKHA40HJP84',
'tag_assignment' => [
'unit' => 'percentage',
'tag_allocations' => [
[
'tags' => [
'<id>'
],
'value' => 100
]
]
],
'date_basis' => 'by_period_start_date',
'pay_period_cadence' => [
1
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sandbox.nmbr.co/services/payroll/employee_benefits"
payload := strings.NewReader("{\n \"work_assignment_id\": \"<id>\",\n \"employee_benefit_type\": \"dental\",\n \"frequency\": \"per_month\",\n \"amount\": \"325.5\",\n \"amount_type\": \"fixed\",\n \"income_basis\": \"regular_earnings\",\n \"max_annual_contribution\": \"2500.5\",\n \"max_annual_contribution_basis\": \"this_benefit\",\n \"coverage_multiplier\": \"1\",\n \"effective_from\": \"2026-01-01\",\n \"effective_to\": \"2026-12-31\",\n \"apply_sales_tax\": false,\n \"title\": \"Dental\",\n \"title_translations\": {\n \"en\": \"Dental\",\n \"fr\": \"Assurance dentaire\"\n },\n \"external_ref\": \"01KG003XG877R33YKHA40HJP84\",\n \"tag_assignment\": {\n \"unit\": \"percentage\",\n \"tag_allocations\": [\n {\n \"tags\": [\n \"<id>\"\n ],\n \"value\": 100\n }\n ]\n },\n \"date_basis\": \"by_period_start_date\",\n \"pay_period_cadence\": [\n 1\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://sandbox.nmbr.co/services/payroll/employee_benefits")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"work_assignment_id\": \"<id>\",\n \"employee_benefit_type\": \"dental\",\n \"frequency\": \"per_month\",\n \"amount\": \"325.5\",\n \"amount_type\": \"fixed\",\n \"income_basis\": \"regular_earnings\",\n \"max_annual_contribution\": \"2500.5\",\n \"max_annual_contribution_basis\": \"this_benefit\",\n \"coverage_multiplier\": \"1\",\n \"effective_from\": \"2026-01-01\",\n \"effective_to\": \"2026-12-31\",\n \"apply_sales_tax\": false,\n \"title\": \"Dental\",\n \"title_translations\": {\n \"en\": \"Dental\",\n \"fr\": \"Assurance dentaire\"\n },\n \"external_ref\": \"01KG003XG877R33YKHA40HJP84\",\n \"tag_assignment\": {\n \"unit\": \"percentage\",\n \"tag_allocations\": [\n {\n \"tags\": [\n \"<id>\"\n ],\n \"value\": 100\n }\n ]\n },\n \"date_basis\": \"by_period_start_date\",\n \"pay_period_cadence\": [\n 1\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.nmbr.co/services/payroll/employee_benefits")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"work_assignment_id\": \"<id>\",\n \"employee_benefit_type\": \"dental\",\n \"frequency\": \"per_month\",\n \"amount\": \"325.5\",\n \"amount_type\": \"fixed\",\n \"income_basis\": \"regular_earnings\",\n \"max_annual_contribution\": \"2500.5\",\n \"max_annual_contribution_basis\": \"this_benefit\",\n \"coverage_multiplier\": \"1\",\n \"effective_from\": \"2026-01-01\",\n \"effective_to\": \"2026-12-31\",\n \"apply_sales_tax\": false,\n \"title\": \"Dental\",\n \"title_translations\": {\n \"en\": \"Dental\",\n \"fr\": \"Assurance dentaire\"\n },\n \"external_ref\": \"01KG003XG877R33YKHA40HJP84\",\n \"tag_assignment\": {\n \"unit\": \"percentage\",\n \"tag_allocations\": [\n {\n \"tags\": [\n \"<id>\"\n ],\n \"value\": 100\n }\n ]\n },\n \"date_basis\": \"by_period_start_date\",\n \"pay_period_cadence\": [\n 1\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "<id>",
"object": "employee_benefit",
"data": {
"work_assignment": {
"id": "<id>",
"object": "work_assignment",
"links": {
"self": "/work_assignments/<id>"
}
},
"business_preset": null,
"employee_benefit_type": {
"id": "<id>",
"object": "employee_benefit_type",
"data": {
"type": "dental",
"label": "Dental"
},
"links": {
"self": "/employee_benefit_types/dental"
}
},
"employer_benefit": null,
"title": "Dental",
"title_translations": {
"en": "Dental",
"fr": "Assurance dentaire"
},
"title_translated": "Dental",
"income_basis": "regular_earnings",
"income_includes": [],
"max_annual_contribution_basis": "this_benefit",
"apply_sales_tax": false,
"remittance_account_id": null,
"remittance_account": null,
"amount": 325.5,
"amount_type": "fixed",
"coverage_multiplier": 1,
"max_annual_contribution": 2500.5,
"frequency": "per_month",
"date_basis": "by_period_start_date",
"pay_period_cadence": [
1
],
"effective_from": "2026-01-01",
"effective_to": "2026-12-31",
"expense_accounting_code": null,
"liability_accounting_code": null,
"external_ref": "01KG003XG877R33YKHA40HJP84",
"created_at": "2026-01-01T00:00:00.000000Z",
"updated_at": "2026-01-01T00:00:00.000000Z"
},
"links": {
"self": "/employee_benefits/<id>"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Must belong to a work assignment associated with an entity of type Employee.
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.
once, per_month, per_payroll 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.
x >= 0Whether amount is a fixed dollar value (fixed) or a percentage of the income basis (percent).
fixed, percent The date from which this benefit is applied to Pay Stubs.
The type of employee benefit, which determines how it is taxed and reported.
Must be present when business_preset_id is either empty or not set.
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 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.
all_earnings, none, regular_earnings, total_income The maximum dollar amount that will be contributed in a calendar year. Contributions stop once this limit is reached.
0 <= x <= 99999Whether max_annual_contribution accumulates across pay periods or applies as a fixed per-period cap.
all_line_items_of_type, this_benefit A multiplier applied to the Employee's earnings to determine the benefit coverage amount, used for coverage-based benefits such as life insurance.
0 <= x <= 100The 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.
255255Hide child attributes
Hide child attributes
Which payroll date determines the calendar month for the allocation. Applies only to per_month benefits.
by_pay_date, by_period_end_date, by_period_start_date 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.
1Response
Created
The unique identifier of the object in Nmbr.
The type of the object in Nmbr ("employee_benefit").
Hide child attributes
Hide child attributes
The type of employee benefit, which determines how it is taxed and reported.
Hide child attributes
Hide child attributes
The unique identifier of the object in Nmbr.
The type of the object in Nmbr ("employee_benefit_type").
Hide child attributes
Hide child attributes
The string identifier for this employee benefit type.
The human-readable display name for this employee benefit type.
Hide child attributes
Hide child attributes
The payroll calculation this entry describes.
eht, income_tax, insurable, pensionable, vacationable, wcb Human-readable name for the payroll calculation.
How this type affects the calculation, broken down by jurisdiction. Jurisdictions where it does not apply are omitted.
Hide child attributes
Hide child attributes
The jurisdiction this applies to (e.g. ca_federal, ca_on, ca_qc).
How this type affects the payroll calculation in this jurisdiction.
accrues_vacation_pay, reduces_base, tax_credit, withholding Plain-language explanation of how this type affects the calculation in this jurisdiction.
The program that applies in this jurisdiction, for calculations that use different programs by jurisdiction (e.g. CPP federally, QPP in Quebec; EI federally, QPIP in Quebec).
Hide child attributes
Hide child attributes
The form code (e.g. t4).
Human-readable form name.
The boxes on the form this type contributes to.
255The translation of the title property for the request locale. Computed using the values in title and title_translations and the value of the request's Accept-Language header.
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.
all_earnings, none, regular_earnings, total_income An optional list of specific earnings, allowances, and other line item types to include in the income calculation in addition to those included via income_basis.
Whether max_annual_contribution accumulates across pay periods or applies as a fixed per-period cap.
all_line_items_of_type, this_benefit Whether provincial sales tax is applied to the benefit amount.
The remittance account to which collected benefit amounts are remitted.
32The 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.
Whether amount is a fixed dollar value (fixed) or a percentage of the income basis (percent).
fixed, percent A multiplier applied to the Employee's earnings to determine the benefit coverage amount, used for coverage-based benefits such as life insurance.
The maximum dollar amount that will be contributed in a calendar year. Contributions stop once this limit is reached.
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.
once, per_month, per_payroll Which payroll date determines the calendar month for the allocation. Applies only to per_month benefits.
by_pay_date, by_period_end_date, by_period_start_date 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.
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.
A reference to the object in an external system, e.g. the primary key of the object in your application's database. Nmbr doesn't use, validate, parse, or require this value to be unique - it simply stores it for your reference.
255The date and time the object was created in Nmbr.
The date and time the object was last updated in Nmbr.