Settings ▸ Accounting ▸ Tax Rates
Tax Rates is a small but load-bearing surface — the rates configured here drive the tax-line behavior on every fee invoice and disbursement. This page documents Settings ▸ Accounting ▸ Tax Rates.
Rate columns
Section titled “Rate columns”| Column | Required | Purpose |
|---|---|---|
| Code | yes | Short identifier, unique within the org. Examples: HST, GST, PST, QST, Z. |
| Name | yes | Human-readable label shown in pickers (e.g. “HST 13%”). |
| Rate | yes | Percentage. Stored to 4 decimal places (13.0000, 9.9750). |
| Account | optional | The GL account this tax credits/debits to. Examples: 2200 HST/GST Payable for collected tax, 1290 HST Receivable for input tax credits paid on operating expenses. |
| Jurisdiction | optional | Free-form label for reporting (e.g. “Ontario”, “BC”, “Federal”). |
| Agency | optional | The tax-collecting body (e.g. “Canada Revenue Agency”, “Ontario Ministry of Finance”). Surfaces on invoice line footers and tax reports. |
| Citation | optional | The legal/regulatory source for the rate (e.g. “Excise Tax Act s.165”). Travels with the rate so the authority isn’t only on the reference page. |
| Effective date | optional | The date this rate took effect. Shown beside the rate so a stale figure is visible at a glance. |
| Source link | optional | A URL to the authority (CRA / provincial / statute). Rendered as a source ↗ link on the rate. The citation, effective date, and source you enter here are yours — Athenty does not vet or approve them. They flag your source; they don’t assert it as final. |
| Applies to | enum | One or more of Fixed Fee, Time, Hard Costs, Soft Costs, Purchases (input tax / ITC on vendor bills). A single rate can cover any combination — this replaced the old two-boolean fees/disbursements flags in #226. |
| Default | bool | A default rate is the default for every scope in its Applies to set; no scope may be claimed by two defaults. So you can have one default each for Fixed Fee / Time / Hard Costs / Soft Costs / Purchases. The default auto-selects on new invoices. |
| Active | bool | Inactive rates hide from new invoices but stay on historical entries. |
Common Canadian rates
Section titled “Common Canadian rates”A typical Ontario law firm seeds:
| Code | Rate | Account | Default? |
|---|---|---|---|
| HST | 13% | 2200 HST Payable | Default for fees + disbursements |
| Z | 0% | — | — |
A BC firm seeds:
| Code | Rate | Account |
|---|---|---|
| GST | 5% | 2200 GST Payable |
| PST | 7% | 2210 PST Payable |
| Z | 0% | — |
A Quebec firm:
| Code | Rate | Account |
|---|---|---|
| GST | 5% | 2200 GST Payable |
| QST | 9.975% | 2210 QST Payable |
| Z | 0% | — |
Adding rates
Section titled “Adding rates”Click + New tax rate to open the side sheet:
- Code (required, unique) and Name
- Rate as a decimal (e.g.
13or9.975) - Account — pick from the GL chart (Liability range for collected, Asset range for ITC)
- Applies to — tick the scopes this rate covers (Fixed Fee, Time, Hard Costs, Soft Costs, Purchases); at least one must be checked
- Default — toggle if this should auto-select on new invoices
- Active — leave on; toggle off to retire a rate later
Saving a new default auto-clears the flag on any prior default — no need to un-default the old one first.
Editing rates
Section titled “Editing rates”Click any row to reopen the side sheet. Code is editable but should be rare — historical invoices reference the rate ID, not the code, so renames don’t break audit trails, but they do change what the picker shows going forward.
Archiving rates
Section titled “Archiving rates”Click the trash icon on a row → confirm. Athenty soft-deletes (sets
isActive=false); historical invoices keep the rate on file. To
genuinely retire a rate’s history, contact support — but in practice,
soft-delete is what every audit-defensible system supports.
Tax Rate Groups
Section titled “Tax Rate Groups”Below the rate table, Tax Rate Groups let you bundle two or more component rates — GST + PST, or state / county / city tax — into a single line the client sees on the invoice, while Athenty still tracks and posts each component separately for accurate liability reporting.
A Tax Rate Group is a container, not a new rate:
- Each component rate keeps its own GL account, so a “GST 5% + PST 7%” group still produces two posting lines (5% to GST Payable, 7% to PST Payable) — exactly how remittance reports expect to see them.
- The group’s effective rate is the sum of its live members and is never stored. Change a component from 5% to 6% and every group it belongs to reflects it automatically — no group edit required.
- The same rate can belong to multiple groups (one GST 5% shared by a BC group and a Quebec group — a many-to-many relationship).
- Components are always shown separately as chips, never harmonized into one number.
Creating a group
Section titled “Creating a group”- Click + New group beneath the rate table.
- Enter a Code (e.g.
BC-GST-PST, max 16 chars) and Name (e.g. “BC GST + PST”). - Tick the component rates — each selected rate gets a
#1,#2… badge showing the order it will appear in. - The dialog shows a Combined display rate (“derived live, never stored”) so you can sanity-check the total. Chip order follows your selection order.
- Save. The group lands in the table below the standalone rates with its components as separate chips and a Combined column for reference.
Editing a group reopens the dialog with members pre-checked and an Active toggle. Archiving (the trash icon) deactivates the group; the component rates and any historical postings are untouched, and you can re-surface it with Show inactive groups.
Reporting
Section titled “Reporting”The Tax Liability report (Settings ▸ Accounting ▸ Reports) always breaks tax out per component, grouped by agency — never by the group container. The grouping is purely a customer-facing convenience on the invoice; the books and the remittance numbers stay component-level.
Composite stacks
Section titled “Composite stacks”Standalone tax rates are never auto-synthesized into a single composite (e.g., a literal “HST = GST + PST” rate). Provinces with stacked taxes show their components as separate lines on the underlying invoice and in reporting — that’s how Canadian tax filings expect to see them. When you want the client-facing invoice to read as one combined line while the books still split it, use a Tax Rate Group (above) rather than a hand-rolled composite rate.
Troubleshooting
Section titled “Troubleshooting”| Symptom | Likely cause |
|---|---|
| New rate not in picker | Check Active is on AND the rate’s Applies to set includes the scope the picker is for (Fixed Fee / Time / Hard Costs / Soft Costs / Purchases). |
| Default not auto-selecting | The default flag is per-scope. Check the prior default still covers the same scope in its Applies to set. |
| Saving rejected with “isDefault scope conflict” | Trying to set two defaults for the same scope — service auto-clears, but this means the prior default came from a different audit log row not yet refreshed. Reload the table. |
| Group’s Combined column looks wrong | It is the live sum of the current member rates, not a stored value. If a component rate changed, the combined figure changed with it — that’s expected. |
| A group can’t be saved | A group needs a Code, a Name, and at least one component rate selected. |
Reporting periods & remittances
Section titled “Reporting periods & remittances”Rates are only half of a tax setup. The other half is what your firm files, how often it reports, and whether a given period has actually been filed. That lives in Tax obligations & remittances, at the bottom of the same Settings ▸ Accounting ▸ Tax Rates tab.
A tax rate is a percentage. A tax obligation is a filing relationship with an agency. They are deliberately separate: rates are not tied to obligations, because the same rate can feed more than one filing and the mapping between them is your firm’s to make.
Tax obligations
Section titled “Tax obligations”Most firms hold several obligations at once, each on its own clock — a sales tax reported on one cycle, payroll source deductions on another, an annual return on a third. That is why the reporting period is configured per obligation rather than once for the whole organization.
| Column | Required | Purpose |
|---|---|---|
| Name | yes | Your firm’s own name for the obligation (e.g. “Sales tax”, “Payroll source deductions”). |
| Type | yes | What kind of filing it is: Sales tax, Excise, Income, Payroll, or Other. A grouping label — it carries no behaviour. |
| Reporting period | yes | How often this obligation is reported: Monthly, Quarterly, Semi-annual, or Annual. |
| Tax agency | optional | The body you file with. Free text — Athenty ships no list of regulators. |
| Jurisdiction | optional | Your own label for where the obligation applies. Free text, and not a country or region list. |
| Notes | optional | Anything your firm wants on the record. |
| Active | bool | Inactive obligations stay on historical remittances but are hidden from new ones. Archiving never deletes recorded filings. |
Choosing a reporting period
Section titled “Choosing a reporting period”The four reporting periods are offered equally, and nothing is preselected — Athenty does not choose one for you, does not mark one “recommended”, and does not infer one from your revenue, your country, your agency, or the jurisdiction label you typed.
Recording a remittance
Section titled “Recording a remittance”“The period ended” and “we filed” are different facts, and only one of them is knowable from the reporting period.
A quarterly filer whose quarter ended 31 March may not file until 30 April. Through the whole of April the period has ended and nothing has been remitted. The reporting period tells you when a period ends; recording a remittance is what makes the second fact knowable.
Use Record a remittance on the selected obligation and supply:
| Field | Required | Purpose |
|---|---|---|
| Period start / Period end | yes | The period the filing covers. The end cannot fall before the start. |
| Remitted on | yes | The day the filing or payment was actually made — normally after the period end. This is the field that separates “ended” from “filed”. |
| Amount + Currency | yes | What was remitted, and in which currency. |
| Reference number | optional | The agency’s confirmation or filing number. |
| Notes | optional | Anything worth keeping with the record. |
Every amount is recorded and displayed with its currency, and remittances are never summed across currencies — a filing in one currency and a filing in another are two separate records, never one combined figure.
Un-marking a remittance
Section titled “Un-marking a remittance”If a remittance was recorded in error — wrong period, wrong obligation, or a filing that did not go through — use Un-mark on the row and give a reason.
Un-marking never deletes the row. The record stays in the log, shown as Un-marked, together with who withdrew it, when, and why. “This period was reported and then un-reported on 3 May” is exactly the kind of history an auditor or regulator may ask you to show, and a deletion would destroy it.
Recording or un-marking a remittance is a bookkeeping record of a filing made at the agency. It posts nothing to the general ledger and moves no funds.
Troubleshooting
Section titled “Troubleshooting”| Symptom | Cause |
|---|---|
| No reporting period is selected on a new obligation | Expected. Nothing is preselected — choose the period that applies to your firm. |
| The remittance log is empty | Remittances are recorded per obligation. Select the obligation by name in the table above the log. |
| An archived obligation’s remittances disappeared | They didn’t. Turn on Show inactive obligations and select it again — archiving hides the obligation from new remittances, it does not remove its history. |
| An un-marked row is still listed | Intended. Un-marking preserves history; the row remains, labelled Un-marked, with the reason it was withdrawn. |
Sources & authorities
Section titled “Sources & authorities”The rates you configure here are your organization’s responsibility to keep current. The authorities below are the official sources behind the rate model and the GST/HST treatment Athenty applies. They were reviewed and approved by counsel on 2026-07-12 (#577 c.64828).
Approval covers the citations — not the rates themselves. Tax rates change, and a rate you save here is yours. Always verify a rate against the current source on the date you rely on it.
- GST/HST rates by province — CRA, Charge and collect the GST/HST — which rate to use (rates change — verify the current rate + effective date)
- Input Tax Credits (ITCs) — CRA, Input tax credits
- Excise Tax Act (GST/HST statute) — Excise Tax Act, R.S.C. 1985, c. E-15, on laws-lois.justice.gc.ca — incl. s. 169 (ITC entitlement)
- Agent vs. principal on lawyers’ disbursements — CRA GST/HST Policy Statement P-209R, Lawyers’ disbursements (whether a paid disbursement passes through tax-free)
- Per-province cited rate table + disbursement treatment — Tax rates reference (current Canadian rates with sources + effective dates, and how GST/HST applies to hard vs soft costs and the separate acting-as-agent option)