# QuickBooks Integration

Integrating QuickBooks with Sphere enables a) seamless import of transaction data and b) live tax calculation within QuickBooks transactions (invoices, credit memos and refund receipts).

This guide provides detailed, step-by-step instructions for connecting your QuickBooks account to Sphere using the secure OAUTH flow.

### Configure Data Synchronization from QuickBooks to Sphere

1. In your Sphere account, select the QuickBooks tile and click the “**Connect**” button.

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2FdqT2mqdsj5eZC406n5qm%2FQuickbooks%20(1).png?alt=media&#x26;token=c99a3e1a-aadd-429b-a20b-786dc6a2d34e" alt=""><figcaption></figcaption></figure>

2. You will be redirected to a QuickBooks OAUTH link, where you'll need to select the company to connect with Sphere. Please click Next after selecting the company.

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2FqKiGOgSPmrgkbBWMs7Jz%2FScreenshot%202025-09-16%20at%204.13.33%E2%80%AFPM.png?alt=media&#x26;token=2a5bab98-c569-43d9-8c5b-104390ec45a5" alt=""><figcaption></figcaption></figure>

3. After granting access, you'll be redirected back to Sphere, where you'll see that your QuickBooks account has been successfully connected.

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2F9gJXemCHUI0NYM2JhnzC%2FQuickbooks.png?alt=media&#x26;token=b981b992-c7d6-4cc8-8500-213fd36f1ef6" alt=""><figcaption></figcaption></figure>

4. You’re all set! If the connection is successful, data will begin importing, and after some time, your products will appear in **Sphere**.

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2FoAXElSy2isY3CaBKW3v3%2FAssign%20code_Quick.png?alt=media&#x26;token=136c78f8-e4d1-4467-a43d-b5e4ddeeddd9" alt=""><figcaption></figcaption></figure>

### Tax Calculation in QuickBooks

### <sub>Pre-requisite for tax calculation in QuickBooks</sub>

1. Ensure that the Sales Tax feature is enabled in your QuickBooks account, as Sphere cannot apply taxes to your transactions without it. In the left navigation bar, search for **Taxes**, then click the **Sales Tax** settings button in the top-right corner.

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2F3DcfDDeNOVkWu3vBMbRC%2FScreenshot%202025-09-16%20at%204.30.25%E2%80%AFPM.png?alt=media&#x26;token=c22ade50-bc91-4dee-8c68-bf2647129355" alt=""><figcaption></figcaption></figure>

2. Please make sure the Sales Tax option is enabled.

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2F5hgpLLDLQbLByHO1qss5%2FScreenshot%202025-09-16%20at%204.30.45%E2%80%AFPM.png?alt=media&#x26;token=ec7455ed-1398-4147-8305-1de424044576" alt=""><figcaption></figcaption></figure>

Note: If Sales Tax is disabled in your QuickBooks account, please reach out to your Sphere representative for assistance with enabling it.

### <sub>Next Steps</sub>

1. Ensure all your 'Subscribed Regions' in Sphere have 'Tax Calculations' settings switched to Yes (see video [here](https://www.loom.com/share/6254e72b130c44808a59513046ee60ea?sid=463c87f3-0683-4622-a479-0f960620d332) on how to ensure this is done).

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2FxgAOJ0mmtxABBkillGw9%2FCalc_new%20(1).png?alt=media&#x26;token=f9474b47-1564-4cc4-8b19-63ea29102372" alt=""><figcaption></figcaption></figure>

2. You can create an invoice in QuickBooks for that region. After saving, refresh the page to see the taxes added to the invoice by Sphere. Since this process runs asynchronously, there may be a short delay before the taxes appear on the invoice.

### How to store Tax Ids in QuickBooks

Follow these steps to save the tax IDs linked to a customer in QuickBooks so Sphere can sync them.

1. Open the customer in QuickBooks and select **Edit**.

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2F21wnG4zgV2JEhEi1izBi%2FScreenshot%202025-09-16%20at%204.34.39%E2%80%AFPM.png?alt=media&#x26;token=8981a10e-a353-4b0f-bd5e-2c69f5c075a8" alt=""><figcaption></figcaption></figure>

2. Click the **Edit Customer** button.

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2FraSsu2rEpnzze8uziUt3%2FScreenshot%202025-09-16%20at%204.34.57%E2%80%AFPM.png?alt=media&#x26;token=45ae6ec5-8058-4752-b0fd-97e2eb25b1c7" alt=""><figcaption></figcaption></figure>

3. In the customer details, go to the **Additional Info** section and mark the customer as tax-exempt. This will reveal two fields: select **Other** as the exemption reason, and enter the tax ID in the **Exemption Details** field. Once complete, click **Save**.

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2FX0wLVL1VxEEcWoujA8s4%2FScreenshot%202025-09-16%20at%204.35.33%E2%80%AFPM.png?alt=media&#x26;token=d58ff122-f40e-453e-bdf0-cd305c8f9424" alt=""><figcaption></figcaption></figure>
