Accounting: How to Set Up QuickBooks Online Sales Tax

Use this guide to confirm how RoasterTools sends sales tax to QuickBooks Online, complete the matching tax setup, and test the result before syncing more invoices.

1. Confirm how sales tax syncs

How sales tax is recorded depends on the tax settings QuickBooks Online reports for this connection. In RoasterTools, open Integrations, select the connection, then open Settings → Invoices → Sales tax. Follow the section that matches what appears on that page.

If the page shows Automated sales tax

RoasterTools sends the order's tax amount through QuickBooks Online's Automated Sales Tax fields. QuickBooks records the tax without adding a separate sales-tax line, so there is no Sales tax item to choose.

For this tax behavior, RoasterTools and QuickBooks each have a different job:

• RoasterTools: Uses Tax Registrations, the customer's tax status, product tax codes, and the ship-to address to calculate the tax amount. A Tax Registration is the state-level setup that tells RoasterTools where your business collects tax.
• QuickBooks: Uses the invoice's ship-to state to find the corresponding state under Where you collect sales tax and determine which sales tax payable account records the amount.

If an invoice ships to a state with a Tax Registration in RoasterTools but no corresponding state under Where you collect sales tax in QuickBooks, RoasterTools can calculate and send the tax while QuickBooks cannot identify the intended agency. QuickBooks then silently falls back to its Out of scope system code and records the amount under Out Of Scope Agency Payable.

If the page shows Sales tax item

QuickBooks Online is not calculating sales tax automatically for this connection. Instead, RoasterTools records the order's tax amount as a separate invoice line. Taxable invoices cannot sync until you select a QuickBooks item for that line. Orders without sales tax do not use this item.

Set up the item in QuickBooks Online first, then return to RoasterTools:

1. In QuickBooks Online, choose an existing item that you already use to record sales tax. If you do not have one, create a new item with a clear name that you will recognize in RoasterTools.
2. Review the item's settings. Confirm that it uses the account where the tax amount should be recorded and the appropriate tax setting. If you are unsure, check with whoever manages your accounting.
3. In RoasterTools, return to Settings → Invoices → Sales tax.
4. Under Sales tax item, choose that item and save.

If the page shows Tax handling not confirmed

This is not another tax method. Select Verify tax settings so RoasterTools can check QuickBooks Online and show the correct setup for the connection.

For Canadian QuickBooks Online connections

On Settings → Invoices → Sales tax, choose the appropriate Zero-rated QuickBooks code under Default GST/HST code.

QuickBooks requires the selected code on Canadian invoice product lines and on the shipping line when the order includes a shipping charge. If an invoice mixes taxable and non-taxable items, adjust its line-item tax rates in QuickBooks as needed. RoasterTools lists only currently available tax codes imported from QuickBooks Online.

Continue with step 2 only if your Sales tax page shows Automated sales tax. Otherwise, skip to step 3 and test the result.

2. Match Tax Registrations for Automated Sales Tax

Compare the two settings state by state. Do this after connecting QuickBooks to RoasterTools and before enabling tax calculation. If tax calculation is already enabled, compare them now and review invoices that may already have been routed incorrectly.

1. In RoasterTools, open the username menu and select Tax Registrations. Note each state configured there.
2. In QuickBooks Online, open Sales tax and find Where you collect sales tax.
3. For every Tax Registration in RoasterTools, confirm that the same state appears under Where you collect sales tax in QuickBooks.
4. If a corresponding state is missing under Where you collect sales tax, choose Add state and complete its setup, including filing frequency, start date, agency, and reporting method where requested.
5. After setup, QuickBooks automatically generates the applicable state, county, and city rates for that state.

For QuickBooks instructions, see Intuit's Set up where you collect sales tax.

3. Test how sales tax syncs

Run the checks that match the tax behavior you confirmed in step 1:

• Automated sales tax: Follow the state-by-state steps below. Confirm that QuickBooks records the tax without a separate sales-tax line and uses the intended payable account.
• Sales tax item: Confirm that a taxable invoice includes a separate tax line using the item selected in RoasterTools.
• Canadian QuickBooks Online: Confirm that the selected GST/HST code appears on the applicable product and shipping lines.

Test Automated Sales Tax by state

Test one representative invoice for each state configured under Tax Registrations in RoasterTools. Do this after the settings match and before enabling tax calculation across all orders:

1. Create or sync an invoice for a customer shipping to the state.
2. Open the invoice in QuickBooks and select the tax breakdown on the right side.
3. Confirm that the amount posts to the intended state sales tax payable account, such as California Department of Tax and Fee Administration Payable, rather than Out Of Scope Agency Payable.
4. If QuickBooks uses the wrong payable account, confirm that the invoice's ship-to state has both a RoasterTools Tax Registration and a corresponding state under Where you collect sales tax in QuickBooks.
5. Add or correct the QuickBooks setup for that state, then test with a new invoice.

Once an invoice for each RoasterTools Tax Registration reaches the intended QuickBooks payable account, the setup is ready for tax calculation across normal orders.

4. Troubleshoot sales tax setup

Automated sales tax: Tax is recorded under Out Of Scope Agency Payable

Symptom: Tax on synced invoices lands in the general ledger account named Out Of Scope Agency Payable instead of the intended state sales tax payable account. This can affect all invoices or only invoices shipping to certain states.

Cause: The invoice ships to a state configured under Tax Registrations in RoasterTools, but QuickBooks does not have a matching state under Where you collect sales tax. QuickBooks falls back to its Out of scope system code and records the amount there.

Fix:

1. Note the ship-to state on each affected invoice.
2. In RoasterTools, open Tax Registrations and confirm that each ship-to state is configured as intended.
3. In QuickBooks, open Where you collect sales tax. Confirm that the same state appears there and that the appropriate agency is active.
4. Add or correct the QuickBooks setup for the state and complete the requested filing details.
5. Sync a new representative invoice for that state and confirm that the amount reaches the intended account.

Changing setup does not rewrite an invoice that already synced. Reclassify historical invoices directly in QuickBooks or work with your accountant.

Automated sales tax: The tax settings do not match

• Tax Registration in RoasterTools but no matching state in QuickBooks: RoasterTools can calculate tax, but QuickBooks can record it under Out Of Scope Agency Payable. Add the state under Where you collect sales tax in QuickBooks and test a new invoice.
• State in QuickBooks but no Tax Registration in RoasterTools: RoasterTools does not calculate tax for that state under this flow, so QuickBooks has no tax amount to route and customers in that state receive invoices without tax. Add the appropriate RoasterTools Tax Registration and test a new invoice.

Why QuickBooks calls this Automated Sales Tax

Automated Sales Tax is QuickBooks' name for the feature that calculates and routes tax automatically from information such as customer ship-to addresses. It is the default tax system for QuickBooks Online accounts. See Intuit's Automated Sales Tax overview.

QuickBooks Desktop and Xero use different tax models

For QuickBooks Desktop, follow Set up QuickBooks Desktop sales tax. Xero does not use Automated Sales Tax. RoasterTools records the order's tax as a separate invoice line using the Sales tax item selected for the Xero connection.

Next: decide how payments sync

Once your test results are correct, your sales tax setup is ready. Return to Set up accounting sync and continue with step 5, Decide how payments sync.