Canadian Payroll in Odoo:
Complete CPP, EI, T4, RL-1 Setup

The Canadian Payroll Regulatory Landscape — Why Odoo Canada Is Not Odoo US

Canadian payroll is deceptively complex. On paper it's one country with one payroll engine; in practice it's two parallel tax administrations, thirteen provincial and territorial tax schedules, two public pension schemes, two unemployment insurance programs, four distinct workers' compensation regimes, and an employer health tax that changes name and rate at every provincial border. If you are migrating to Odoo from ADP, Ceridian Dayforce, Nethris, or QuickBooks Payroll, the first rule is that the Canadian Odoo localization is not a minor skin on the US module — it is a separate module, l10n_ca_hr_payroll, with its own structures, rules, and year-end reporting engine.

At the federal level, the Canada Revenue Agency (CRA) administers income tax withholding, Canada Pension Plan (CPP and CPP2) contributions, Employment Insurance (EI) premiums, and the T4/T4A information return for every province except Quebec. For Quebec-resident employees, almost everything splits: Revenu Québec administers Quebec provincial income tax (via the TP-1 return), the Quebec Pension Plan (QPP) replaces CPP, the Quebec Parental Insurance Plan (QPIP) runs alongside a reduced federal EI rate, and year-end slips are filed as RL-1 instead of T4. An employee based in Gatineau who crosses the river to work in Ottawa has federal CPP and EI on their payslip; their coworker one desk over who lives and works in Montreal has QPP, QPIP, and reduced EI. Both work for the same company. Both run through the same Odoo database. Different rules fire for each.

On top of this sit the provincial payroll taxes. Ontario employers pay the Employer Health Tax (EHT) on the portion of annual payroll above the exemption threshold. Quebec employers pay the Fonds des services de santé (FSS), a health services fund with a sliding rate depending on total payroll. British Columbia has its own EHT. Manitoba has the Health and Post-Secondary Education Tax Levy. None of these are employee deductions — they are employer-only costs computed on the payroll base, and they need journal entries on every payslip run even though they never appear on the employee's T4.

Workers' compensation is another four-way split. In Ontario it's WSIB billed quarterly on assessable earnings. In Quebec it's CNESST with monthly remittance and an annual reconciliation. In Alberta it's the WCB-Alberta. In British Columbia it's WorkSafeBC. Each province publishes its own classification units, rate groups, and maximum assessable earnings ceilings. Odoo models these as separate "contribution" rules tied to the employee's work-location province, not the company's head-office province — a distinction that trips up implementations where the head office is in Toronto but half the crew is on a job site in Calgary.

The upshot is that "Canadian payroll in Odoo" is not one configuration — it's a matrix of federal rules, provincial rules, and Quebec-specific overrides that must be bound to the right employee contract through the right work-location record. Get the matrix right on day one and month-end close takes twenty minutes; get it wrong and your first RL-1 run in February will surface errors that have compounded for twelve months. The rest of this guide walks through that matrix, with the exact module configuration, Python salary rule logic, and year-end filing workflow we use for Octura Solutions clients running Odoo in Canada.

CPP and CPP2: Configuring Canada Pension Plan Contributions for 2026

The Canada Pension Plan has been running through its enhancement schedule since 2019, and 2026 is the first full year with the second-tier CPP2 bracket fully phased in. There are now two separate ceilings, two rates, and two corresponding boxes on the T4 slip. For 2026, the Year's Maximum Pensionable Earnings (YMPE) sits at approximately CAD $72,400, with a basic exemption of $3,500. The employee contribution rate on earnings between the exemption and the YMPE is 5.95%, matched by the employer. Earnings between the YMPE and the Year's Additional Maximum Pensionable Earnings (YAMPE) — roughly $82,400 for 2026 — are subject to CPP2 at 4.00% employee and 4.00% employer.

# Rule code: CPP — sequence 61, category DED
# 2026 parameters (verify annually against CRA T4127)
YMPE = 72400.00
YAMPE = 82400.00
BASIC_EXEMPTION = 3500.00
CPP_RATE = 0.0595
CPP2_RATE = 0.0400

# Pay period gross (pensionable earnings for this cheque)
pensionable = categories['GROSS']

# Annualize for ceiling comparison using the contract's pay schedule
periods = {
    'weekly': 52, 'bi-weekly': 26,
    'semi-monthly': 24, 'monthly': 12,
}[contract.schedule_pay]

# Per-period exemption (basic exemption pro-rated)
period_exemption = BASIC_EXEMPTION / periods
period_ympe = YMPE / periods
period_yampe = YAMPE / periods

# Tier 1: CPP on earnings above exemption up to YMPE
tier1_base = max(0, min(pensionable, period_ympe) - period_exemption)
cpp = tier1_base * CPP_RATE

# Tier 2: CPP2 on earnings between YMPE and YAMPE
tier2_base = max(0, min(pensionable, period_yampe) - period_ympe)
cpp2 = tier2_base * CPP2_RATE

# Deductions are negative
result = -round(cpp + cpp2, 2)

The employer-side matching contribution runs as a separate rule (category Employer Cost, sequence 200 range) that mirrors the calculation but does not reduce net pay — it posts to an employer CPP expense account and an employer CPP payable account in the payroll journal. Odoo's Canadian module ships with this pair already wired; the only thing you typically override is the rate constants at the turn of each calendar year.

Employment Insurance (EI): Federal Rate, Quebec Reduced Rate, Employer 1.4x Match

Employment Insurance premiums are simpler than CPP: a flat percentage up to an annual Maximum Insurable Earnings (MIE) ceiling, with no exemption. For 2026, the MIE is approximately CAD $65,700. The federal employee rate is 1.64%, and employers pay 1.4 times the employee premium. For employees resident in Quebec, the federal EI rate is reduced (to roughly 1.31% for 2026) because QPIP covers maternity and parental benefits separately.

# Rule code: EI — sequence 62, category DED
MIE = 65700.00                       # 2026 Maximum Insurable Earnings
EI_RATE_FEDERAL = 0.0164             # rest of Canada
EI_RATE_QUEBEC = 0.0131              # Quebec reduced rate (QPIP offset)

insurable = categories['GROSS']
periods = {
    'weekly': 52, 'bi-weekly': 26,
    'semi-monthly': 24, 'monthly': 12,
}[contract.schedule_pay]
period_cap = MIE / periods
capped = min(insurable, period_cap)

# Branch on employee's province of residence
is_qc = employee.address_id.state_id.code == 'QC'
rate = EI_RATE_QUEBEC if is_qc else EI_RATE_FEDERAL

result = -round(capped * rate, 2)

The 1.4x employer match is a separate rule on the employer-cost side; if your business qualifies for an EI Premium Reduction (short-term disability plans, certain registered programs), the employer multiplier drops below 1.4 — Odoo stores this as l10n_ca_ei_employer_rate on the company record and the rule reads it as a parameter instead of hardcoding 1.4.

Provincial Income Tax: Ten Provinces, Three Territories, One Rule Engine

Every Canadian employee pays two income taxes on every cheque: federal income tax and one provincial (or territorial) income tax. The federal tax is uniform across the country; the provincial tax varies in both rates and brackets. Alberta has a nearly-flat structure. Ontario layers a "surtax" on the basic calculation once tax payable exceeds a threshold. BC has seven brackets. Quebec is not handled by CRA at all and has its own section below.

Odoo's l10n_ca_hr_payroll module stores the bracket tables in hr.rule.parameter records keyed by year and province. Each jurisdiction has a distinct parameter — l10n_ca_tax_federal_brackets_2026, l10n_ca_tax_on_brackets_2026, l10n_ca_tax_bc_brackets_2026, and so on. The salary rule reads the parameter at compute time, so when CRA publishes the new T4127 tables each January, you update the parameter record and every payslip from that date forward uses the new rates without touching the rule code.

# Rule code: TAX_PROV — sequence 63, category DED
from datetime import date

province = employee.work_location_id.state_id.code or employee.address_id.state_id.code
year = payslip.date_to.year

# Fetch bracket table for this province + year
param_key = f'l10n_ca_tax_{province.lower()}_brackets_{year}'
brackets = env['hr.rule.parameter'].get_param(param_key) or []

# Annualize per-period gross for bracket lookup
periods = {
    'weekly': 52, 'bi-weekly': 26,
    'semi-monthly': 24, 'monthly': 12,
}[contract.schedule_pay]
annual_gross = categories['GROSS'] * periods

# Apply the TD1 provincial claim code exemption
claim_amount = contract.l10n_ca_claim_code_provincial or 0
taxable = max(0, annual_gross - claim_amount)

# Progressive bracket walk: brackets = [(upper, rate, constant), ...]
annual_tax = 0
for upper, rate, constant in brackets:
    if taxable <= upper:
        annual_tax = taxable * rate - constant
        break
else:
    upper, rate, constant = brackets[-1]
    annual_tax = taxable * rate - constant

# Convert to per-period and negate
result = -round(annual_tax / periods, 2)

The critical configuration detail: Odoo binds the province to the employee's work location, not their residence. This matters for remote workers. An employee living in Gatineau (Quebec) but reporting to an Ottawa office has their payroll taxes computed on the Ontario bracket table and pays Ontario provincial tax, with a reconciliation on their personal T1 at year-end. CRA's rule is that the "province of employment" for withholding is determined by the employer's permanent establishment where the employee reports. Odoo exposes this via the work_location_id field on the employee; if that's left blank the rule falls back to the home address province, which is almost always wrong for cross-province workers.

Year-End Reporting: T4, T4 Summary, RL-1, and XML Filing

At year-end, every Canadian employer issues T4 slips to every employee (and a T4 Summary to CRA). Employers with Quebec-resident staff additionally issue RL-1 slips to Revenu Québec. Both are due by the last day of February following the calendar year. Odoo's l10n_ca_hr_payroll module ships a T4/RL-1 generation wizard that walks the year's confirmed payslips, aggregates by employee and by T4/RL-1 box, and produces both the employee-facing PDF slip and the XML file for electronic transmission.

T4 Box Mapping — Salary Rules to Tax Boxes

Every salary rule must be tagged with the T4 box it contributes to. Odoo models this via the l10n_ca_t4_box field on hr.salary.rule. The canonical mapping:

Taxable benefits — employer-paid group insurance above the exempt threshold, employer-paid parking, company vehicle personal-use benefit — land in Box 14 (employment income) and usually require Other Information codes such as 40 (other taxable allowances and benefits), 30 (board and lodging), or 34 (personal use of employer's automobile). Configure each taxable benefit as a salary rule with both the l10n_ca_t4_box and l10n_ca_t4_other_info_code set so the wizard routes the amount correctly.

RL-1 Box Mapping

RL-1 boxes map similarly: A = employment income, B = QPP contribution, C = EI premium, D = RRSP deduction at source, E = Quebec income tax withheld, F = union dues, G = pensionable salary for QPP, H = QPIP premium, I = insurable salary for QPIP. Quebec employees effectively have two sets of year-end slips — a T4 for federal items and an RL-1 for Quebec items — and the Odoo wizard generates both from the same consolidated payslip data.

XML Upload to CRA and Revenu Québec

Once slips are validated, the wizard produces two XML files: one in the CRA's T619 schema for the T4 batch (uploaded via CRA's Web Forms or Internet File Transfer), and one in Revenu Québec's XML schema for the RL-1 batch (uploaded via clicSÉQUR-entreprises). Both require a valid certifier identifier; for CRA it's your BN with RP suffix, for RQ it's your NEQ plus the identification number. Odoo stores the generated XML on the payroll period record so you have an audit trail of what was actually filed.

Canadian Payroll in Odoo — Frequently Asked Questions