> ## Documentation Index
> Fetch the complete documentation index at: https://support.jomioz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect QuickBooks

> Connect QuickBooks Online on a US company. Customers, products, invoices, payments, and card payouts sync into QuickBooks on their own.

Connect QuickBooks Online and the invoices you send, the payments you take, and your card payouts are recorded in QuickBooks for you, so nobody types them in twice.

QuickBooks is for **US companies** on **Growth** and **Pro**. On Starter the page shows an upgrade.

## How it works

Jomioz sends information **one way**, into QuickBooks Online. Jomioz is where you make changes.

* **Make changes in Jomioz.** The next send updates it in QuickBooks. A change you make only in QuickBooks is not copied back.
* **Clearing a field in Jomioz** leaves the old value in QuickBooks.
* **Deleting, archiving, or voiding something in Jomioz** leaves it as it is in QuickBooks.
* **There is no Sync now button and no Send to QuickBooks button.** Everything goes on its own when you send an invoice or take a payment.
* You connect **one QuickBooks company** to one Jomioz account. A QuickBooks company can be connected to one Jomioz account at a time.

### What is sent

| Jomioz | In QuickBooks |
| - | - |
| **Customers** | A customer with the name, company, first email address, and billing address. |
| **Products and services** | A **Service** item. Materials become **Non-inventory** items. A one-off line with no price book item uses one item named **Custom Service**. |
| **Invoices** | An invoice with each line, its tax, and the job address as the ship-to address. Headings are not sent. |
| **Payments and refunds** | A payment applied to the invoice. A refund comes off that payment. |
| **Card payouts** | One deposit in your checking account, with the fees taken out. |

### What is not sent

* **Estimates.** An estimate stays in Jomioz. A deposit taken on an estimate is sent as a payment.
* **Draft invoices** and **voided invoices**, with the default settings.
* **The [example data](https://support.jomioz.com/go-live/clear-practice-work.md)** from sign-up: the example customer, the example invoices, and the starter price book items.
* **Archived customers.** If a customer is archived after it was sent, it stays in QuickBooks.

## Before you start

You need:

* A **US company** in Jomioz, on **Growth** or **Pro**.
* A **US QuickBooks Online** company. QuickBooks Desktop is not supported.
* Permission to change company settings in Jomioz. If the buttons are grayed out, ask someone who has it.
* A **checking account** in QuickBooks, if you take card payments with Jomioz Payments. See step 4 below.

If your Jomioz company is not in the US, or the QuickBooks company is not in the US, connecting is refused.

## Set it up

**1. Open QuickBooks**

Go to **Settings → Integrations → QuickBooks**.

**2. Connect**

Click **Connect QuickBooks** and approve the QuickBooks company. Nothing is copied across at the moment you connect. The status becomes **Needs an income account**.
If that QuickBooks company is already connected to another Jomioz account, you see a message saying so. Disconnect it there first.

**3. Choose an income account and save**

Under **Accounts**, choose **Income account**. A bar at the bottom says **Unsaved changes**. Click **Save**. Products and invoices wait until that account is saved. The status then says **Connected**.

**4. Choose a checking account**

Choose **Checking account** and click **Save** again. The list shows checking accounts only. If it is empty, create one in QuickBooks first: **Accounting → Chart of accounts → New**, account type **Bank**, detail type **Checking**.
Card payments stay in Undeposited Funds until Stripe pays you. The payout is then deposited into this account. Until you choose one, the payout stays in Jomioz and the **Activity** tab asks you to choose. The choice does not change the bank Stripe pays out to.

Leave **Deposit account** on **Undeposited Funds** unless your bookkeeper asks for another account. Leave **Tips account** on **Don't post tips** unless you want card tips posted as their own journal entry.

## What happens after you send an invoice

With the default settings:

1. You send the invoice. A draft stays in Jomioz.
2. The customer is created or matched in QuickBooks, then the products on the invoice, then the invoice.
3. You take a payment. It is applied to that QuickBooks invoice.
4. A card payment sits in Undeposited Funds. A cash or check payment can land in the deposit account you chose.
5. When Stripe marks the payout paid, QuickBooks gets one deposit in your checking account, with the fees taken out.

You can see the result on the **invoice**, the **customer**, and the **price book item**. The QuickBooks row there says **Synced**, **Warning**, **Error**, **Pending**, or **Not linked yet**. **Open in QuickBooks** opens it there.

* **Warning** means it was saved in QuickBooks and something needs a look, usually tax.
* **Error** means it was not saved. Read the sentence on the **Activity** tab.

## The QuickBooks page

The page has three tabs:

* **Activity** opens first. It lists what needs your attention, and what was sent.
* **Settings** holds the connection, accounts, sales tax, and when to sync.
* **Import and older items** holds the optional import and the sync for older work.

Until an income account is saved, the page opens on **Settings** instead, because nothing can sync before then.

### Activity

**Activity** opens on **Needs attention**. It shows one row for each customer, invoice, or item, with its latest result, and only when that result is a warning or an error. When everything is in sync it says **Nothing needs attention**. The tab shows a count of the rows that need you.

Each row has the time, a link to the customer, invoice, or price book item, a status, and one sentence saying what happened. A row has at most one button: **Sync again**, or **Use QuickBooks rates** for a tax difference.

Some warnings are news, not a problem. A voided invoice, an archived customer, an inactive product, and a reversed payment are left in QuickBooks on purpose, so those rows have no button.

Switch to **All activity** to see everything that was sent, newest first. **Load more** shows older rows. Activity older than about six months is removed.

## Settings

### Accounts

| Setting | What it is for | Which accounts are listed |
| - | - | - |
| **Income account** | Required. Invoice income posts here. | Income and Other Income accounts. |
| **Deposit account** | Where a cash or check payment can land. Card payments stay in Undeposited Funds until the payout. | **Undeposited Funds**, Bank accounts, and Other Current Asset accounts. |
| **Checking account** | Where a paid Stripe payout is deposited. Fees come out of that deposit. | Checking accounts only. |
| **Tips account** | Card tips post as a journal entry when this is set. | Other Current Liability and Income accounts. |

If you leave **Tips account** on **Don't post tips**, the payment still syncs. The **Activity** tab notes that the tip was not posted.

Any change on this page waits for **Save**.

### When to sync

| What | Default | Other option |
| - | - | - |
| **Customers** | When they are used on an invoice | When they are created or edited |
| **Products and services** | When they appear on an invoice | When they are created or edited |
| **Invoices** | When they are sent | When they are created. This includes drafts. |
| **Payments and refunds** | When they are collected | **Don't sync payments** |

After a customer or product is in QuickBooks, every edit to it syncs again, whichever option you chose.

**Customers.** Jomioz looks for a QuickBooks customer with the same name. One match is linked. More than one match means nothing is linked: the invoice is not sent, and the **Activity** tab says several QuickBooks customers use that name. Rename or merge them in QuickBooks, then use **Sync again**. When you **import**, you are asked to choose instead.

**Payments and refunds.** The payment is applied to the QuickBooks invoice. A deposit on an estimate is a payment too. It sits in Undeposited Funds until the job invoice is in QuickBooks, then it is applied to that invoice. It does not become a second invoice. A refund comes off that payment, so the amount due goes back up. For a card refund, the money leaves the bank on the payout deposit.

## Sales tax

**Settings → Integrations → QuickBooks → Sales tax** says how your QuickBooks works out tax. Jomioz reads it for you.

| QuickBooks setting | What Jomioz does |
| - | - |
| **Calculated by QuickBooks** (Automated Sales Tax) | QuickBooks takes the tax from the job address. Jomioz still gives the customer a total up front on the estimate and invoice, so the two should agree. |
| **Your own tax rates** | Jomioz sends the invoice's rate and adds it in QuickBooks if it is missing. QuickBooks takes **one** rate per invoice, so an invoice with two rates is held until you fix it. |
| **Sales tax is off in QuickBooks** | The invoice is sent without tax and is never held. If Jomioz charged tax, the invoice shows a warning saying so. Turn on sales tax under Taxes in QuickBooks if you charge it. |
| **Could not be read** | Jomioz could not read the setup just now. Reload the page. |

When the setting is **Calculated by QuickBooks**, the page also shows **Set your default tax rate**, with a link to **Settings → Tax**. Set it to your own area's rate, so new estimates and invoices start with the right tax.

Estimates, jobs, and invoices take their tax from the same place: the customer's tax-exempt setting, then the tax chosen for the job **address**, then your company default. So the tax on the estimate your customer agreed to is the tax on the invoice. See [Tax](https://support.jomioz.com/settings/tax.md).

### When Jomioz and QuickBooks disagree

The invoice is always sent, unless it is held for a reason in the table. **Activity** then says **why** in one sentence, and offers the one thing that fixes it.

| What the row says | Why | What to do |
| - | - | - |
| *Jomioz charged X and QuickBooks calculated Y for this address.* | Jomioz used a different rate from the one QuickBooks uses for that address. | Click **Use QuickBooks rates**. Jomioz adds QuickBooks' rates, groups them (for example **San Pablo, CA 9.5%**), and makes that group the tax for that address. The group and its rates appear under **Settings → Tax**. The next estimate, job, and invoice there agree. |
| *This invoice has no job address, so QuickBooks used your business address.* | QuickBooks calculates from the address, and there was none. | Add the job address in Jomioz, then **Sync again**. |
| *QuickBooks added no tax because your company is not set up to collect sales tax in TX.* | QuickBooks only collects in states you have added under Taxes. | Add the state in QuickBooks, or take the tax off the invoice in Jomioz. Then **Sync again**. |
| *Sales tax is turned off in QuickBooks.* | Nothing to calculate. | Turn on sales tax in QuickBooks, then **Sync again**. |
| *QuickBooks rounds each tax rate on its own, so a cent or two can differ.* | QuickBooks rounds every rate in a group separately. | Nothing. The invoice is fine. |
| *This invoice charges tax at X% and Y%. QuickBooks takes one sales tax rate per invoice, so it was not sent.* | Your QuickBooks uses its own tax rates, and the invoice has two. | Use one rate, or split it into two invoices, then **Sync again**. |
| *A taxed line has no tax rate Jomioz can send to QuickBooks, so it was not sent.* | A taxed line has no rate. | Pick a tax rate on the invoice, then **Sync again**. |

Only a difference in rates offers **Use QuickBooks rates**. The other rows have no such button, because taking over QuickBooks' rates would not fix them.

When a rate is not in QuickBooks yet, Jomioz adds it with its percentage in the name (for example **CA 7.375%**). Rates keep up to four decimals.

The **first** estimate in a brand-new area uses your company default, because QuickBooks has not seen that area yet. Set the tax for the address on the customer before you send the estimate, or send one invoice and use **Use QuickBooks rates**. After that, every estimate and invoice at that address uses the right tax.

## Payouts, fees, and disputes

A paid Stripe payout becomes **one deposit** in the checking account you chose. Manual cash and check payments are not part of that deposit.

Jomioz creates these accounts in QuickBooks the first time they are needed:

| Account | What posts there |
| - | - |
| **Jomioz Payments Fees** (expense) | Stripe fees. A refunded card fee is added back on the same account. |
| **Refunds Clearing** | A refund included in the payout. |
| **Allowance for Disputed Jomioz Payments** | A card dispute. If you win the dispute, a later payout puts the money back. |
| **Jomioz Negative Payouts** | A payout below zero. See below. |

A payout below zero cannot be a negative deposit. QuickBooks gets a journal entry out of checking for that amount, and a zero deposit that still lists the payments, fees, refunds, and disputes.

**If the numbers do not match,** the deposit is not created. The **Activity** tab says why. For example:

* "Stripe paid X but the Jomioz payments, fees, refunds, and disputes add up to Y."
* "Some payments in this payout are not in QuickBooks yet." Send those invoices first. See [Sync older items](#import-and-older-records) if they are from before you connected.
* "Choose a checking account in QuickBooks settings."

## Import and older records

Both of these are optional, under the **Import and older items** tab.

**Import from QuickBooks** copies your **active** customers and your **Service** and **Non-inventory** items into Jomioz. A matching name is linked. When a name matches more than one, you choose which one to link. The others stay unlinked. Anything already in Jomioz is not overwritten.

Import copies top-level customers only. A QuickBooks sub-customer or job (named like **Parent:Child**) is skipped, because it would come back to QuickBooks as a separate customer.

**Sync older items** sends work that already existed before you connected.

1. Set **Created on or after**.
2. Check **Invoices**. Check **Payments** only with invoices. Check **Payouts** only with invoices and payments.
3. Click **Start sync**.

Drafts and voided invoices are skipped. Anything already in QuickBooks is left as it is. The sync runs in the background, so you can leave the page. The row under **Previous syncs** says **Sending in the background** until it ends. **Previous syncs** lists the latest three. Only one sync runs at a time.

## Names and matching

QuickBooks reads a colon in a customer or product name as a sub-customer or sub-item. Jomioz sends a colon as a dash, so **Panel upgrade: 200A** becomes **Panel upgrade - 200A** in QuickBooks. Tabs and line breaks become spaces.

A customer, vendor, or employee in QuickBooks can already use a name. The **Activity** row then says: "A customer, vendor or employee in QuickBooks already uses this name. Rename one of them, then sync again."

## Send something again

**Sync again** shows on an error row, and on a warning that sending again can fix. It sends that one customer, invoice, or item again, once the cause is fixed.

* It never makes a second copy. Jomioz finds the one in QuickBooks by its link or its name.
* If it was deleted in QuickBooks, it is created again, and the row says so.
* A customer or product that was made inactive in QuickBooks is made active again when Jomioz sends it.

## If something goes wrong

| You see | What to do |
| - | - |
| **Could not connect QuickBooks** | Try **Connect QuickBooks** again. |
| That QuickBooks company is already connected to another Jomioz account. | Disconnect it in the other account first. |
| QuickBooks sync is for US companies. / Connect a US QuickBooks company. | QuickBooks sync works for US companies only. Check the country of your Jomioz company and of the QuickBooks company. |
| **Needs an income account** | Choose an **Income account** on the **Settings** tab and click **Save**. |
| **Reconnect needed** | See [Reconnect](#reconnect). |
| A row on **Activity** with **Error** | Read the sentence. Fix the cause, then **Sync again**. |
| A payout is not in QuickBooks. | Choose a **Checking account**. Then check **Activity** for a row about the payout. |
| QuickBooks changed this at the same moment. | Nothing. It syncs again with the next change. |

If **Activity** shows an error you do not understand, contact support and include the text of the row.

## Reconnect

QuickBooks can stop accepting the connection: you disconnected Jomioz inside QuickBooks, or the connection went unused for about 100 days. The status then says **Reconnect needed** and nothing syncs. The page shows **QuickBooks needs to be connected again**, with only the connection on **Settings**. Click **Connect QuickBooks** there. Your links and account choices are kept. Jomioz refreshes the connection every day so it does not lapse.

### Switch company or start again

Use **Connect again** under **Settings → Connection**. It asks whether to **Keep the links** or **Clear the links**.

* **Keep the links:** customers, products, and invoices stay linked.
* **Clear the links:** Jomioz forgets which QuickBooks customers, products, and invoices match yours. Everything already in QuickBooks stays there.
* A **different QuickBooks company** always clears the links.

### Disconnect

**Disconnect QuickBooks**, next to it, stops sending anything new and removes Jomioz from the company's connected apps in QuickBooks. Everything already in QuickBooks stays there. You can connect again later.

If your plan no longer includes QuickBooks, the QuickBooks page asks you to upgrade.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.