Sign up today for free — no credit card down.Get started
    All articles
    8 min read

    How DocStream AI Handles Canadian Sales Tax

    DocStream AI records the GST, HST, PST and QST printed on your bills using the tax codes already in your QuickBooks Online or Xero. It claims only the tax the CRA allows, and holds anything it can't verify for you to review.

    Quick summary

    Every bill follows five rules:

    1. Your tax setup, never ours. We use your existing tax codes and rates. We never create, rename or change a tax code.
    2. Matched to the cent. A code is used only when its rate × the bill's subtotal reproduces the printed tax, within a 2-cent rounding allowance you can adjust.
    3. The total always equals the bill. What posts is exactly what your vendor is owed. If the posted total would differ from the bill by more than a cent, it's held, and we never rewrite your amounts to force a match.
    4. Claim only what's recoverable. GST, HST and the QST share go to your recoverable tax account. PST goes into the expense, as your provincial codes are set up to do. When a vendor overcharges tax, the extra is never claimed.
    5. Hold when unsure. A missing province code, an unreadable tax setup, a possible US sales tax charge, or a tax amount that doesn't match the printed rate all stop for your review. Nothing gets guessed.

    By default, a person reviews and submits every bill. You can turn on automatic posting per vendor or per receipt type.

    How a bill flows

    How a bill's tax is decided: 3 checks, 4 outcomes. Green posts, amber waits for your review, grey posts with no tax credit.

    Every check uses your own tax codes. Before any outcome posts, the bill total must match the document to the cent, and by default you review the bill before it's submitted.

    Rates we recognise

    The combined rate on a bill tells us its tax structure. We read the rate and the amount separately, so a wrong rate printed on a bill can be caught.

    Combined rateStructureProvinces / territoriesWhat's recoverable
    5%GSTAB, NT, NU, YT (and GST-only bills elsewhere)All 5%
    11%5% GST + 6% PSTSKGST only
    12%5% GST + 7% PSTBC, MBGST only
    13%HSTONAll 13%
    14%HSTNSAll 14%
    14.975%5% GST + 9.975% QSTQCGST and QST (QST if registered in Quebec)
    15%HSTNB, NL, PEAll 15%

    How PST is recorded. PST isn't recoverable. The provincial tax codes in QuickBooks Canada and Xero Canada split each bill: GST to the recoverable account, PST into the expense or asset. We use those codes as they are.

    Nova Scotia's rate change. Nova Scotia went from 15% to 14% HST on April 1, 2025. Some vendors still print "HST 15%" while charging 14%. When the dollars are 14%, we book 14% and don't treat it as an error.

    Scenarios in depth

    The examples use an Ontario bill with a $1,000.00 subtotal. The same logic applies at every rate.

    1. A standard bill

    The vendor prints HST 13% and charges $130.00, for a total of $1,130.00. We find your 13% HST code and post $1,000.00 of pre-tax lines with that code. The tax line is exactly $130.00. Your HST return picks up the full $130.00 as an input tax credit.

    2. Small rounding differences

    Vendors round per line, so tax is often a cent or two off the math. Gaps up to $0.02 count as rounding, and the tax posts as printed. You can raise the allowance (up to $1.00) under Tax on bills in settings.

    3. The vendor charged too much tax

    The bill prints HST 13% but charges $150.00. The real tax on $1,000.00 is $130.00, and the CRA only allows a credit for tax that was properly charged.

    Posted lineAmountTax code
    Your expense lines$1,000.00HST ON 13%
    Tax claimed$130.00HST ON 13%
    "Tax charged above the printed rate (not claimable)"$20.00Out of Scope
    Bill total (what you owe the vendor)$1,150.00

    By default the bill is held with a ▲ marker and one button: Add the extra $20.00 tax as an expense line and post. The bill gets a note reminding you to ask the vendor for a credit note. The extra $20.00 goes to an account you choose, or to the bill's largest expense account.

    There's one exception. If the extra tax is exactly 13% of another amount on the bill, such as a fee we didn't treat as taxable, we hold the bill and ask you to check the lines instead. It's probably a missing line, not an overcharge.

    4. The vendor charged too little tax

    The bill prints HST 13% but charges $125.00. You can only claim the tax you were charged, so we claim $125.00 and the total is $1,125.00. The bill is held with a ▼ marker and one button: Post as printed.

    5. Turning the hold off

    If you'd rather not review over- and undercharges, turn off Hold bills whose tax doesn't match the printed rate. Bills then post automatically using the same split as above, with a note and an in-app warning. The ▲/▼ markers also appear in your notification emails, with a legend.

    6. Taxable and exempt lines on one bill

    QuickBooks Online: every line has its own Sales Tax code. We prefill the codes, and you can change any of them before submitting. Set Amounts are to Exclusive, Inclusive or Out of scope, and the tax rows under the subtotal update per rate.

    Xero: exempt lines use your Xero tax-exempt purchase rate. If your organisation doesn't have one, we hold the bill.

    7. A province you haven't set up

    A Nova Scotia vendor charges 14%, but your books have no 14% code. We hold the bill and name the province. You can set up the province in QuickBooks and submit again, pick one of your codes, or choose Out of scope. We check your codes again on resubmit, so a newly added code gets picked up.

    8. Out-of-province vendors

    We record the rate the vendor charged, as long as you have a code for it. We don't decide place-of-supply questions, like whether a vendor shipping to Ontario should have charged 13%. If a rate looks wrong for where the goods were delivered, ask the vendor for a corrected invoice.

    9. US and other foreign vendors

    Bills in any currency are matched, but only to codes with a recoverable part (GST, HST or QST). A 5% charge from a vendor with no Canadian postal code is held: it could be GST, or US state sales tax that happens to be 5%. US sales tax that matches no Canadian rate is included in the expense, and no credit is claimed.

    10. Vendor credits and credit notes

    The same rules apply in reverse. A QuickBooks vendor credit or Xero credit note reverses the tax with the same code, so your claimed credits go down by the right amount.

    11. Receipts and card purchases

    On QuickBooks Online, receipts use the same matching and per-line codes. A receipt is already paid, so it's never held for an over- or undercharge. It posts with the correct split and a note. On Xero, matching Canadian tax codes on receipts isn't available yet, so check the tax on Xero receipts.

    12. Bills we can't tie to a single rate

    Some bills mix taxes in ways no single code can reproduce. A customs broker invoice, for example, can combine duty, GST on imports and a taxable brokerage fee. If the tax matches no code and no standard rate, we never claim a credit we can't support: the tax stays in the expense amount. On QuickBooks Online, set the codes per line in the review drawer before submitting to claim the recoverable part.

    13. When we can't read your tax setup

    If QuickBooks or Xero doesn't return your tax codes, the bill holds until it can. If QuickBooks rejects a code you picked, the bill holds with QuickBooks' reason. We never swap in a different code.

    QuickBooks Online vs Xero

    The tax rules are the same on both. The differences come from what each platform supports.

    Swipe to see more

    CapabilityQuickBooks OnlineXero
    Match printed tax to your existing codes to the centYesYes
    Never create or change a tax codeYesYes
    Over- and undercharge handling, one-click approval, ▲/▼ markersYesYes
    Hold for a possible US 5% sales taxYesYes
    Tax code per line, editable before submittingYesExempt lines only
    Hold when the province has no codeYesYes (any unmatched CAD bill)
    Vendor credits / credit notesYesYes
    Canadian tax on receiptsYesNot yet
    Exact tax cents sent to the platformYes, one tax line per rateYes, within $0.01 (we set the tax amount when Xero's rounding would differ)

    What you control, and what stays with you

    DocStream AI records purchase tax accurately. Filing, registration and judgement calls stay with you and your accountant.

    Settings you control:

    SettingDefaultWhat it does
    Hold bills whose tax doesn't match the printed rateOnOn: over- and undercharges wait for one-click approval. Off: they post automatically with the correct split and a note.
    Rounding allowance$0.02Gaps up to this amount post as printed
    Extra tax goes toBill's largest expense accountThe account for overcharged, non-claimable tax
    Review before postingOnTurn on automatic posting per vendor or for receipts when you're ready

    What stays your responsibility:

    • Your tax codes. We use the codes in your QuickBooks or Xero, so they need the right provinces and accounts.
    • Supplier registration numbers. CRA requires the vendor's GST/HST number to support a credit on purchases of $100 or more. We keep the original invoice with every bill, but we don't read or verify the number. Keep an eye out for vendors who leave it off.
    • Self-assessed tax. Imported services and other purchases with no tax printed (such as US software subscriptions) may need self-assessed HST. There's nothing on the bill for us to read, so record these yourself.
    • Place of supply and exemptions. Whether a vendor should have charged tax, or at what rate, is between you and the vendor.
    • Your HST/GST/QST return. We record the tax in your books. You or your accountant prepare and file the return.

    Questions about a specific bill? Open it in DocStream AI to see the original document and any notes or warnings it carried.

    See DocStreamAI on your own documents

    Book a demo and we'll walk through how your invoices and receipts would be captured, extracted and posted to QuickBooks or Xero, using your setup rather than a sample file.

    Or start a free 14-day trial instead.