Skip to content

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.

ColumnRequiredPurpose
CodeyesShort identifier, unique within the org. Examples: HST, GST, PST, QST, Z.
NameyesHuman-readable label shown in pickers (e.g. “HST 13%”).
RateyesPercentage. Stored to 4 decimal places (13.0000, 9.9750).
AccountoptionalThe 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.
JurisdictionoptionalFree-form label for reporting (e.g. “Ontario”, “BC”, “Federal”).
AgencyoptionalThe tax-collecting body (e.g. “Canada Revenue Agency”, “Ontario Ministry of Finance”). Surfaces on invoice line footers and tax reports.
CitationoptionalThe 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 dateoptionalThe date this rate took effect. Shown beside the rate so a stale figure is visible at a glance.
Source linkoptionalA 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 toenumOne 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.
DefaultboolA 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.
ActiveboolInactive rates hide from new invoices but stay on historical entries.

A typical Ontario law firm seeds:

CodeRateAccountDefault?
HST13%2200 HST PayableDefault for fees + disbursements
Z0%——

A BC firm seeds:

CodeRateAccount
GST5%2200 GST Payable
PST7%2210 PST Payable
Z0%—

A Quebec firm:

CodeRateAccount
GST5%2200 GST Payable
QST9.975%2210 QST Payable
Z0%—

Click + New tax rate to open the side sheet:

  1. Code (required, unique) and Name
  2. Rate as a decimal (e.g. 13 or 9.975)
  3. Account — pick from the GL chart (Liability range for collected, Asset range for ITC)
  4. Applies to — tick the scopes this rate covers (Fixed Fee, Time, Hard Costs, Soft Costs, Purchases); at least one must be checked
  5. Default — toggle if this should auto-select on new invoices
  6. 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.

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.

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.

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.
  1. Click + New group beneath the rate table.
  2. Enter a Code (e.g. BC-GST-PST, max 16 chars) and Name (e.g. “BC GST + PST”).
  3. Tick the component rates — each selected rate gets a #1, #2 … badge showing the order it will appear in.
  4. The dialog shows a Combined display rate (“derived live, never stored”) so you can sanity-check the total. Chip order follows your selection order.
  5. 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.

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.

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.

SymptomLikely cause
New rate not in pickerCheck 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-selectingThe 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 wrongIt 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 savedA group needs a Code, a Name, and at least one component rate selected.

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.

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.

ColumnRequiredPurpose
NameyesYour firm’s own name for the obligation (e.g. “Sales tax”, “Payroll source deductions”).
TypeyesWhat kind of filing it is: Sales tax, Excise, Income, Payroll, or Other. A grouping label — it carries no behaviour.
Reporting periodyesHow often this obligation is reported: Monthly, Quarterly, Semi-annual, or Annual.
Tax agencyoptionalThe body you file with. Free text — Athenty ships no list of regulators.
JurisdictionoptionalYour own label for where the obligation applies. Free text, and not a country or region list.
NotesoptionalAnything your firm wants on the record.
ActiveboolInactive obligations stay on historical remittances but are hidden from new ones. Archiving never deletes recorded filings.

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.

“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:

FieldRequiredPurpose
Period start / Period endyesThe period the filing covers. The end cannot fall before the start.
Remitted onyesThe day the filing or payment was actually made — normally after the period end. This is the field that separates “ended” from “filed”.
Amount + CurrencyyesWhat was remitted, and in which currency.
Reference numberoptionalThe agency’s confirmation or filing number.
NotesoptionalAnything 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.

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.

SymptomCause
No reporting period is selected on a new obligationExpected. Nothing is preselected — choose the period that applies to your firm.
The remittance log is emptyRemittances are recorded per obligation. Select the obligation by name in the table above the log.
An archived obligation’s remittances disappearedThey 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 listedIntended. Un-marking preserves history; the row remains, labelled Un-marked, with the reason it was withdrawn.

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.