How the QuickBooks Online Integration Works

This article explains how TaxCloud interacts with QuickBooks Online once the integration is set up, including which document types are supported, how tax calculations work, and important rules to follow to keep your records accurate.

:::info New to TaxCloud for QuickBooks Online? Start with Connecting TaxCloud to QuickBooks Online to get set up first.

:::

What the Integration Does

TaxCloud replaces QuickBooks Online's built-in Automated Sales Tax (AST) with real-time sales tax calculations. It also captures your transactions for tax reporting and filing, tracking sales collected in each taxing jurisdiction.

Supported Document Types

TaxCloud supports specific QuickBooks Online document types to ensure accurate sales tax calculations and reporting. Each one interacts with TaxCloud differently depending on whether it represents a completed sale, a quote, or a return. Understanding how each document type maps to TaxCloud’s system is essential for proper tax management.

QuickBooks Online Document	TaxCloud Treatment	What It Does
Invoice	Captured as an Order	Records a sale and calculates tax liability
Sales Receipt	Captured as an Order	Records an immediate sale and calculates tax liability
Estimate	Tax Lookup Only	Calculates potential tax for a quote but does not record a transaction or tax liability in TaxCloud
Credit Memo	Captured as a Return	Processes a return, reducing tax liability
Refund Receipt	Captured as a Return	Processes a refund, reducing tax liability

Key Concepts

• Orders (Invoices and Sales Receipts) are the primary documents for recording sales. Tax calculated on these is queued for reporting as tax collected.
• Lookups (Estimates) are useful for giving customers a price that includes tax, but since an estimate is not a final sale, no tax is reported or remitted based on an estimate alone.
• Returns (Credit Memos and Refund Receipts) reverse previous transactions. They ensure you do not remit tax on sales that were refunded or returned.

How Tax Is Calculated

TaxCloud does not calculate taxes automatically when you save a document. You control when calculations happen using the TaxCloud for QuickBooks Online browser extension.

1. Save your invoice, sales receipt, or estimate in QuickBooks Online.
2. Open the TaxCloud browser extension and click Calculate Taxes.
3. TaxCloud automatically calculates tax for each line item, updates the document in the background, and refreshes your browser tab to show the updated totals.

https://www.loom.com/share/598b6cc2bda4444f9de012daa4dee131?sid=17605a23-d0bb-46d9-aa93-9420451ac695

:::info Note: By default, TaxCloud adds a single total tax amount for the entire invoice. If you prefer a separate tax line per line item, you can switch to Individual Tax Line Items display mode. See Changing the Sales Tax Display Mode for QuickBooks Online.

:::

Address Requirements

TaxCloud requires valid addresses to calculate tax correctly.

• Each invoice, sales receipt, or estimate must have a valid Ship to address.
• A Ship from address is recommended. If one is not provided, TaxCloud uses your QuickBooks Online company address as the default.

Taxable Line Items

When adding line items to an invoice or sales receipt, check the Tax checkbox for any item that should have sales tax applied. The state of this checkbox directly controls whether tax is calculated for that specific line:

• When checked: TaxCloud reads the product's assigned Taxability Information Code (TIC) and calculates the appropriate sales tax based on the shipping addresses and state rules.
• When cleared (unchecked): TaxCloud treats the line item as strictly non-taxable and automatically assigns TIC 99992 (non-taxable) to that line.

Clearing the Tax checkbox acts as a strict override. Even if a product has a valid, taxable TIC mapped in TaxCloud, unchecking the box guarantees no tax will be applied to that line. If a line item is missing tax when it should be taxed, verify that the Tax checkbox is checked in QuickBooks Online.

Discounts

Use the built-in discount field on the invoice to apply discounts — either as a percentage or a dollar amount. You may need to enable this field if it is not visible.

To enable the discount field:

1. From the invoice, go to Manage > Payment options.
2. Enable the Discount toggle.
3. In the summary section, enter your discount amount.

:::info Important: Negative line items cannot be used to apply discounts.

:::

Rules for Managing Documents After Capture

Do Not Edit Documents After They Are Captured

Once an invoice, sales receipt, or credit memo has been captured in TaxCloud, it cannot be modified. If you attempt to calculate tax on a captured document, TaxCloud will display this message:

:::info Tax cannot be calculated for this invoice because it was already captured in TaxCloud on [date]. If you have already edited this invoice, revert the changes or contact support for assistance.

:::

If you need to make changes after a document is captured, create a new document instead:

• To remove items: Create a Credit Memo.
• To add items: Create a new Invoice or Sales Receipt.

:::tip If you need more time to make edits before a document is captured, set the invoice date further in the future so that you have time to continue making changes before it is captured in TaxCloud.

:::

Do Not Backdate Invoices

If you set an invoice's transaction date in the past, it may not be captured by TaxCloud. If a backdated invoice is captured and its transaction date falls in a prior reporting period, an amendment may be required.

Invoices are imported into TaxCloud on Mondays for invoices with a Created Date from the prior 7 days.

Exempt Customers

Exempt customers must be marked in QuickBooks Online, and a corresponding exemption certificate should be added to TaxCloud. See Managing Exempt Customers in TaxCloud for QuickBooks Online.

Marketplace / Connector Orders (WooCommerce)

If WooCommerce orders are synced into QuickBooks Online via a connector, they are generally not “blanket-excluded” from TaxCloud just because they originated in WooCommerce. However, some QuickBooks Online sync configurations can de-duplicate these transactions in a specific scenario to prevent double-counting.