~/keystrawai / insights / jobber-quickbooks-sync

Jobber + QuickBooks Online: how the sync actually works, and the errors that break it

Duplicate customers in QuickBooks. Bank deposits that never match an invoice. A sync screen full of errors. Jobber’s help center documents a fix for each of them. This guide collects those fixes, in the order you should work through them, with links to the source.

how-to guide · last checked against Jobber’s help center: 2026-10-08
KeyStrawAI is not affiliated with Jobber or Intuit. Product names belong to their owners.

// contents

On this page

  1. Which integration are you on?
  2. What syncs, and which way
  3. When it syncs, and what edits and deletes do
  4. The errors that actually hurt
  5. Why your bank deposit doesn’t match the invoice
  6. The quote-deposit gotcha
  7. Fix in this order
  8. Habits that keep it clean
// 01 · start here

First, find out which integration you’re on

Jobber has two different QuickBooks Online integrations: the original one, which Jobber’s docs now call the legacy integration, and the new QuickBooks integration. They follow different rules. A lot of the advice online doesn’t say which one it’s describing, so a fix that worked for someone else may not apply to you.

The quickest tell, going by Jobber’s two sets of documentation:

If you’re on legacy, you can migrate. It’s a one-way door: after migrating, in Jobber’s words, “you are unable to return to the old integration.” On migration, anything created or updated since your last manual sync gets synced (Jobber: migrate).

A few things hold for both. It’s QuickBooks Online only; QuickBooks Desktop isn’t supported (Jobber: integration FAQs). One QuickBooks company connects to one Jobber account, and an admin user sets up the connection. On Jobber’s pricing page, “Sync with QuickBooks Online” is listed from the Connect plan up; the Core plan doesn’t list it. Plans change, so check the pricing page for your account.

// 02 · direction

What syncs, and which way

The single biggest difference: on the new integration, syncing runs one way, from Jobber into QuickBooks (the only exception is an optional one-time import when you first connect). Jobber calls itself the “source of truth.” If a record is wrong, you fix it in Jobber and let the fix flow over. An edit made only in QuickBooks doesn’t come back, and an invoice’s paid status no longer syncs back either (Jobber: how items sync, new integration).

ItemNew integrationLegacy integration
ClientsJobber → QuickBooks. Optional one-time import from QuickBooks at first connect.Both ways.
Products & servicesJobber → QuickBooks. Optional one-time import at first connect.Both ways.
InvoicesJobber → QuickBooks. Later edits keep syncing.Jobber → QuickBooks, once only. Later edits go in both programs by hand. Only the Paid status updates afterward.
PaymentsJobber → QuickBooks, set to “when collected” or “do not sync.”Jobber → QuickBooks, one time.
Refunds, tips, payoutsEach set to “when collected” or “do not sync.”Covered in the legacy article too: payouts “can be set up to sync to QuickBooks including the fees.”
TimesheetsWhen approved. Needs QuickBooks Payroll and an exact employee-name match.Jobber → QuickBooks.
PropertiesProperty address becomes the QuickBooks shipping address.Never sync. Invoices go to the parent customer only.
Quotes & jobsJobber’s documentation for both integrations lists only the items above. On the new integration, though, quote deposits sync as payments: see the gotcha.

Source: Jobber’s item-sync articles for each integration.

Details that trip people up on the new integration

Details that trip people up on legacy

// 03 · timing

When it syncs, and what edits and deletes do

New integration

Legacy integration

Invoices and payments sync one time, so any later edit has to be made in both programs. Only the Paid status updates afterward: an invoice marked paid in QuickBooks syncs that status back, but the balance stays open in Jobber. Jobber’s recommendation is to record payments only in Jobber.

Reading the sync screen

An error blocks an item from syncing. A warning means it synced, with changes. And one to read twice before you click: the bulk Resolve and Ignore actions apply to every item that matches your current filter, not just the page you can see (Jobber: common sync errors).

// 04 · errors

The errors that actually hurt

Ranked by how much cleanup they tend to cause, which is our editorial judgment, not a measurement. The error wording comes from Jobber’s help center: the new-integration error list and the legacy error list. Where legacy words it differently, that’s noted.

1. “Client already exists in QuickBooks”

What it means

QuickBooks requires every customer name to be unique, and on the new integration the Jobber client name maps to the QuickBooks display name. Two records with the same name, and the second one can’t sync. Legacy says it as “The name supplied already exists.”

Why it happens

The same customer ends up with two records. One Jobber user put it plainly on the community board:

“At least once a week, when syncing with quickbooks, I get an error message saying that it can’t sync CLIENT NAME because CLIENT NAME already exists.” Jobber Community thread

The causes named in that thread are ordinary. An existing customer fills in the online request form and types “NJ” where staff would autofill “New Jersey.” Or someone in the office creates a new customer while on the phone. Fixing one, the poster says, takes “half an hour.”

The first-connect import has its own matching rules on the new integration: companies match by company name, individuals by first and last name. If the email also matches, the existing client is updated; otherwise a new client is created. Multiple matches go to a duplicate-resolution screen.

The fix

2. Payments and payouts stuck because something upstream never synced

What it means

Errors cascade downhill: whatever broke the invoice or the payment breaks the payout too. On a payout you’ll see “Payments from the following invoices have not been pushed.” On a payment, “TxnID Cannot Be Linked” means the invoice never synced, or was deleted in QuickBooks. Or an item is waiting on a client or product that’s “not in sync.”

The fix

3. The bank deposit doesn’t match the invoice

This one is a reconciliation headache more than an error message. It gets its own section below.

4. Tax rate missing, mismatched, or substituted

What it means

Each tax rate has to exist in QuickBooks under a matching name, or you get “Tax rate missing in QuickBooks Online.” Lines that aren’t taxable need a 0% code in QuickBooks (“0% tax rate not found”). If the same rate exists under another name, you get a “Tax rate substituted” warning. A “Business Validation Error” about calculating tax is fixed the same way: make the rates match. Legacy has its own version: “Tax Error – check QuickBooks US/Global settings.”

Why it happens

Two lists of tax rates, maintained separately, drift. If you use QuickBooks Automatic Sales Tax, Jobber shows suggestions with an “Add tax rates to Jobber” option.

The fix

Make the rates identical in both programs, then reselect the rate on the invoice in Jobber and save it again. For a missing rate, Jobber’s other route is to remove that rate from the invoice in Jobber.

5. “Invoice number already in use”

QuickBooks already has an invoice with that number. Legacy says “DocNumber already exists.” The fix is to renumber in Jobber, which counts up from the highest number.

6. Disconnected, or “Permission denied”

7. Zero totals, discounts, and rounding

Also on the list: quick reference

MessageWhat to do
“Too many updates” or “Unable to connect”Wait 30 seconds, then Retry.
“QueryProcessingError: null”A QuickBooks API issue. It resolves itself.
“Account period has closed”Reopen the period, or make the change in QuickBooks.
“Duplicate product or service,” “Product or service already exists,” “Two or more matching products or services found”Product and service names must be unique in QuickBooks. Rename. A QuickBooks “Inventory” item’s type can’t be changed, so recreate it.
“Invalid Reference Id: Names element id not found”Something it points at was deleted or made inactive. Contact Jobber support (1 to 2 business days).
“More than 21 characters in doc_num”Shorten the check or confirmation number on the payment.
Payment method not foundAdd it in QuickBooks: Gear → All Lists → Payment Methods.
“Undeposited funds account not found”Create an asset account named “Undeposited Funds.”
“Bank account not found” (payouts)Create the Checking account.
“Tips not found” or “Payout retry failed to sync”Contact Jobber support.
“Employee does not exist in QuickBooks”Create the employee with the exact same name. Split overnight shifts at midnight.
“Too many characters” (clients)Often a phone field with notes typed into it. Legacy caps display name at 25 characters, phone at 30, email at 100, address at 50. On the new integration, character-limit and invalid-character issues are warnings only.
// 05 · reconciliation

Why your bank deposit doesn’t match the invoice

If customers pay through Jobber Payments, the deposit that lands in your bank is not the invoice amount: the processing fee comes out before the money is deposited. So the invoice and the bank-feed line won’t match, and they aren’t supposed to.

How the new integration books it

The edge cases

All of the above is from Jobber’s payments, fees and payouts article.

Where it goes wrong

Without payout sync, the full payment sits in Undeposited or Unapplied Funds. If your bank feed also imports the deposit, an older Jobber article describes the result: “two ‘unapplied’ payments for the same Invoice” (Jobber: reconcile payments). Jobber’s fix is to turn on payout sync. If you reconcile by hand instead, use the payout fees as the adjustment.

Intuit agrees. A QuickBooks Team answer in the QuickBooks Community says “processing fees are deducted from the payment… explains why the payment amount in your bank register doesn’t match the deposit,” and suggests matching it manually with Resolve Difference (QuickBooks Community).

There’s an error version of this, too: “Unable to associate payments, refunds, or tips with bank deposit.” It means the deposit was already recorded somewhere else. Jobber’s options: set “Deposit to” back to Undeposited Funds, delete the manual bank deposit, and Retry; or reconcile it by hand and Ignore the error.

// 06 · gotcha

The quote-deposit gotcha

Jobber’s new-integration docs say deposits collected on a quote are treated as payments, and they sync with payments. A quote isn’t an invoice, though, so when the deposit reaches QuickBooks there’s nothing yet to apply it to. A Jobber Ambassador described it on the community board:

“We send a quote out, it requires a 25% deposit. Jobber collects the deposit, quickbooks registers the payment, but with NO invoice # since an invoice has not been completed.” Jobber Community thread

Jobber documents deposits syncing as payments, so plan for it rather than hunting for a setting: decide who ties each deposit to its invoice once the job is invoiced, and look for orphaned deposits in Undeposited or Unapplied Funds before you close the month.

// 07 · fix order

Fix in this order

Because errors cascade, fixing them out of order wastes time: you clear a payout error and it comes straight back because its invoice is still stuck. Jobber’s own recommended order:

  1. Clients.
  2. Products and services.
  3. Invoices.
  4. Payments, refunds and tips. These need their invoices.
  5. Payouts. These need invoices and payments.

After each fix, Retry the item. Before a bulk Resolve or Ignore, check the filter (see above).

// 08 · prevention

Habits that keep it clean

Two things worth checking

We haven’t confirmed either of these in vendor documentation. They’re risks to look at in your own setup, not known behaviour:

// next

If you’d rather not untangle it yourself

Everything above works without us, and the linked Jobber articles are the authority. If you’d rather hand it off, messy records and half-configured software are what our cleanup and configuration engagement is for, and the Revenue Recovery Sprint starts with a baseline of what you’re actually owed and fixes the invoice data that breaks follow-up. The intake is the way in.

Last checked against Jobber’s help center: 2026-10-08. Vendor screens and wording change; if something here no longer matches what you see, the linked Jobber article wins.
KeyStrawAI is not affiliated with Jobber or Intuit.