Housecall Pro + QuickBooks Online: how the sync actually works, and the alerts that break it

1. A one-way push, not a mirror
2. What syncs, and which way
3. When it syncs
4. The failures that raise no alert
5. The alerts that actually hurt
6. Payments, deposits and payouts in QuickBooks
7. Habits that keep it clean

In Housecall Pro’s words, the QuickBooks Online integration “typically functions one-way, with data automatically syncing from Housecall Pro to QuickBooks Online. There are a few exceptions.” Their advice follows from that: “ensure that all work is being completed within Housecall Pro” (Housecall Pro: syncing information).

“Automatically” needs a footnote. The sync doesn’t watch your records continuously. It fires on specific events: finishing a job, sending the invoice, or taking payment. The first of those creates the invoice in QuickBooks and links the two. Later events update that same linked invoice. But edits to the invoice itself after that first sync don’t travel on their own (section 04 has the details and Housecall Pro’s exact wording).

If you’ve used Jobber, this is the opposite of what Jobber documents for its new QuickBooks integration, where edits keep syncing after the first sync. Our Jobber + QuickBooks guide covers that side.

A few things to confirm before anything else:

• Plan. Housecall Pro’s onboarding guide says “you must be on either the Essentials or MAX Housecall Pro plans.” Its pricing page lists QuickBooks Online sync in the Essentials column; the Basic column doesn’t list it. Plans change, so check the pricing page for your account.
• QuickBooks edition. Housecall Pro names Simple Start, Essentials, Plus and Advanced as compatible (Housecall Pro: onboarding guide).
• One integration, one company. Unlike Jobber, the help center describes a single QuickBooks Online integration, with no old and new versions. It connects to one QuickBooks company.
• QuickBooks Desktop is a separate integration with its own articles. It’s also one-way and runs through the QuickBooks Web Connector (Housecall Pro: Desktop syncing). This guide is about QuickBooks Online.

Source: Housecall Pro’s syncing, onboarding and managing-payments articles.

Details that trip people up

• One link per customer. “Only one Customer Profile in Housecall Pro can be linked to a customer in QuickBooks Online.”
• Service addresses don’t land on the customer. A separate service address goes into the invoice’s “Shipping to” box, not the QuickBooks customer record. For per-address separation, Housecall Pro suggests customers and sub-customers in QuickBooks.
• Labor and materials aren’t separated when the Price Book syncs. An item added straight onto a job, rather than from the Price Book, is categorized generically as “Sales.”
• Invoice numbers match Housecall Pro’s. With Simple Invoicing the invoice number “may be slightly off from the job number,” a deposit invoice takes the next number (or a “D-” prefix when Match Invoice and Job Number is on), and progressive invoices “may not be aligned with the job number at all.”

• The triggers: a job marked Finished (if your sync trigger is “Sync when job is finished”), an invoice sent to the customer, or a job or invoice marked Paid. Housecall Pro says the sync happens “within 2-5 minutes.”
• Printing an invoice doesn’t push it.
• Old jobs don’t sync on their own. The integration “only affects new jobs after the initial setup.” Jobs finished, sent or paid before you connected have to be pushed by hand.
• The manual push: Job Details → QuickBooks Online section → three dots → “Push invoice to QBO.” A $0.00 invoice can be pushed, but it needs at least one line item. If the push fails, the box reloads with the alert, and “Review Alert” opens Sync Alerts.

All of the above is from Housecall Pro’s syncing article.

The alert queue reports things that tried to sync and failed. In the cases below, Housecall Pro’s own documentation says the change doesn’t reach QuickBooks on its own, and nothing on its documented alert list covers them. That’s why they come first: a stuck invoice gets noticed, but a QuickBooks invoice that quietly disagrees with Housecall Pro can sit there until someone reconciles.

1. Edits after the first sync

“Changes made to the invoice itself in Housecall Pro do not automatically update the invoice in QuickBooks Online after the initial sync. This includes changes to: Line items, Quantities, Prices, Descriptions.” Housecall Pro: syncing information

The same article says changes to the invoice date or due terms need a manual push too. The fix is the manual push from section 03.

In fairness, the article isn’t fully consistent. Elsewhere it says information updated in Housecall Pro “will not need to be manually updated in QBO, but may require a manual push,” and that later triggers update the same invoice. Rather than guess which sentence wins on your account, treat it the safe way: any change to line items, quantities, prices or descriptions after the first sync gets pushed again.

2. Deleted or cancelled invoices

“Any invoices deleted/canceled in Housecall Pro will need to be manually deleted/canceled in QuickBooks Online. This update will not automatically push over.” Until someone does, the invoice stays in QuickBooks.

3. Estimates

Estimates don’t push to QuickBooks at all. That’s by design, but it means QuickBooks can’t tell you what’s been quoted. For deposits, see section 06.

A weekly check that catches them

This is our suggestion, not a Housecall Pro feature. It takes a list from each program and compares them:

1. Invoices edited this week. For any Housecall Pro invoice changed after it was finished, sent or paid, open the QuickBooks invoice and compare the total. If they differ, push it again.
2. Invoices deleted or cancelled this week. Find each one in QuickBooks and delete or cancel it there.
3. Open balances. Compare open invoices in QuickBooks against unpaid invoices in Housecall Pro. Anything open in QuickBooks only could be one of the two cases above, or a payment that never reached QuickBooks.
4. The Sync Alerts page. Clear what’s there, in the order in the next section.

Housecall Pro lists these as the most common alerts, not a complete list (Housecall Pro: sync alerts). The Sync Alerts page shows each one with its job number, time, type, description and resolution. Two rules apply to all of them:

• Fix the cause first, then Reprocess (QuickBooks icon → three dots → “Sync again”). Housecall Pro says to resolve the cause before reprocessing to “avoid any further issues.”
• Dismiss is permanent and “cannot be undone.” It also doesn’t fix anything: “If you edit any job that initiates the update to QuickBooks Online, the error will regenerate,” and a manual push regenerates dismissed alerts too.

The ranking below is our editorial judgment of how much cleanup each tends to cause, not a measurement.

1. Name collisions: three alerts, one cause

What they mean

• “Name Already Taken” (“We found a customer, vendor, or employee with the same name”). QuickBooks requires names to be unique across customers, vendors and employees together. A vendor or employee who also pays you for a job will trip it.
• “Duplicate Name Exists Error.” A customer, Service Plan or Product/Service name in Housecall Pro “is not linked to a customer with the same Display Name in QuickBooks Online.”
• “Display Name Conflict.” An invoice was created for a duplicate customer. One oddity: this entry sits in the QuickBooks Online alerts article, but its text refers to QuickBooks Desktop. The article is inconsistent with itself there, and we can’t tell you which reading is right.

The fix

• Name Already Taken: change the Customer Display Name in Housecall Pro to something that doesn’t collide, then Reprocess.
• Duplicate Name Exists: Reprocess. If it doesn’t clear, ask Chat Support to repair the link by hand. If you have many, reprocess as many as you can, then contact support.
• Display Name Conflict: rename the customer, or merge the customer profiles if they really are duplicates, then Reprocess.

2. “Tax Rate Unavailable,” and Automated Sales Tax

What it means

“The tax rate % with name (tax rate name) was not found in QuickBooks.” It usually shows up on invoices imported from QuickBooks, or on new invoices using a rate that was only added in Housecall Pro. The rate has to match “exactly”: spelling, capitalization, punctuation, even trailing spaces. Compound tax rates aren’t supported.

The fix

Create the identical rate (same name, same percentage) in QuickBooks, or pick a rate on the job that exists in both programs. If nothing on the invoice is taxable, remove the tax. Then Reprocess.

The quieter version: Automated Sales Tax

If QuickBooks Automated Sales Tax is on, it can overwrite the rate Housecall Pro chose. If its rate is higher and the invoice was already paid in Housecall Pro, QuickBooks shows an outstanding balance; if lower, a credit on the customer’s account. Housecall Pro’s tell: if you can’t create tax rates in QuickBooks, Automated Sales Tax is on.

• Unpaid invoice: change the rate on the Housecall Pro invoice to match QuickBooks’ suggestion before re-sending.
• Paid invoice: override the rate on the QuickBooks invoice (Sales Tax link → Override this amount → pick a reason → Confirm).
• Housecall Pro says to contact QuickBooks to get Automated Sales Tax turned off.

3. The bank deposit doesn’t match the invoice

Not an alert, but a constant source of reconciliation work. It gets its own section below.

4. “Invalid Item Ref”

What it means

Housecall Pro calls this the most common auto-reconciliation alert. Usually the bank account Housecall Pro uses to reconcile card payments, most often the checking account, was deleted in QuickBooks. It’s card-payment reconciliation that breaks.

The fix

In QuickBooks, open the Chart of Accounts and click “Make Active” on that account. Then chat with Housecall Pro support and give them the checking account’s name.

5. “Account Period Closed”

The invoice belongs to a period your books have closed: “Invoices created on or before (date) cannot be pushed until the books have been reopened.” Reopen the period and Reprocess. If the invoice is already correct in QuickBooks, ask support to remove the alert.

6. “Invoice Number Already Taken”

QuickBooks already has an invoice with that number. The fix is inside the alert: Sync again → choose “Regenerate invoice number using Housecall Pro sequence” or “…using QuickBooks sequence” → Submit. Deposit and progressive invoice numbering (see section 02) is worth knowing here, since those numbers don’t follow the job number.

Also on the list: quick reference

How card payments get booked

• A payment (amount, type, date) is pushed when the job is marked finished or paid, and grouped in Undeposited Funds.
• When the payout reaches your bank, Housecall Pro “creates a transaction in QuickBooks Online that groups together your payments and subtracts any credit card transaction fees,” moving the money from Undeposited Funds to Checking “within 2-5 business days.” You then match the bank-feed deposit to that transaction.
• That’s why one deposit never matches one invoice: it’s several payments, net of fees. To see what makes up a payout, go to My money → My payouts in Housecall Pro, which shows each payout’s date, method, amount and processing fees.
• Housecall Pro’s rule, in capitals: “DO NOT move or reconcile credit card payments.”

The fee account’s name isn’t consistent in Housecall Pro’s own article. It says an account called “Housecall Pro Payment Processing Fees” is created in your Chart of Accounts, but its manual-deposit steps name an expense account “Housecall Pro Credit Card Processing Fee.” Look in your Chart of Accounts for whichever you actually have (Housecall Pro: reconciling payments).

Cash and checks never deposit themselves

Card payments, card tips, Instapay and Mobile Check Deposits reconcile automatically (a mobile check deposit once the check clears). Cash, Check and Other payments don’t. They sit in Undeposited Funds until you record the bank deposit in QuickBooks yourself. Card tips are added as invoice line items under an income account called “Housecall Pro Tips.”

The bank account is set in two places

The account Housecall Pro reconciles to is chosen under the QuickBooks icon → Banking. Housecall Pro: “If you change your Bank Account in the QBO Banking settings, you must also change the bank account connected in your HCP My Money Payout Settings… Otherwise, credit card payments may be attributed to old bank accounts.” Owners have hit exactly this:

“We recently switched HCP credit card deposits from one bank to another. Money has been deposited to another bank; however QBO continue to post the deposits to old bank account.” QuickBooks Community thread (2020–2022)

Those posts are from 2020–2022. Housecall Pro’s current article spells out the two-setting fix, so if you change banks, change both settings.

Refunds, and payments recorded elsewhere

• Refunds create a Refund Receipt under the customer, who then shows a balance due for the refunded amount. The receipt also appears in the Undeposited Funds register “for you to add to a deposit and deduct from your account register appropriately” (Housecall Pro: managing payments). So every refund has a QuickBooks step left for you.
• “Add Local Payment” marks the invoice Paid in Housecall Pro without pushing anything to QuickBooks. It avoids a duplicate when the payment is already in QuickBooks, but if it isn’t, you record it there by hand.
• Payment entered in QuickBooks first? Use “Pull Payment from QBO” on the job.

Job deposits: income by default

By default a job deposit is recorded as income. A newer “Treat as liability” option (Settings → QuickBooks → Syncing tab, rolling out gradually) instead books it to a liability account, “Customer Deposits (via Housecall Pro),” and applies it as a negative line on the final invoice. It isn’t available with progressive invoicing, and turning progressive invoicing on switches it off automatically (Housecall Pro: deposits). Which is right for your books is a question for your accountant.

• Do all the work in Housecall Pro. That’s Housecall Pro’s own advice, and with a one-way push it’s the only way the two stay in step.
• Get the invoice right before you finish, send or take payment. If it changes afterward, push it again the same day.
• Keep tax rates mirrored exactly, name and percentage, and avoid compound rates.
• Before connecting, clean up QuickBooks. Housecall Pro recommends it. Only parent customers and second-level sub-customers import; anything deeper, and its invoices, doesn’t. If you have more than seven years of data, it suggests importing from a start date rather than all time.
• Don’t keep re-importing. Housecall Pro recommends importing additional data “no more than 2 times after the initial integration” (Housecall Pro: settings).
• Talk to support before you disconnect. Housecall Pro: “Before disconnecting… reach out to our Chat Support team… to avoid any errors.”

Three things worth checking

We haven’t confirmed these in Housecall Pro’s documentation. They’re risks to look at in your own setup, not known behaviour:

• Where your duplicates come from. On the Jobber side, a community thread names staff creating a new customer instead of finding the existing one. It’s worth checking whether the same habit is behind your name-collision alerts.
• Skipping the import at setup. Housecall Pro’s Desktop article says skipping the import means the link between existing customers has to be made by hand. We didn’t find the same statement for QuickBooks Online, but if you skipped it and names differ between the two programs, expect duplicates.
• Reconnecting. The help center doesn’t say what a disconnect and reconnect does to existing links. Treat a reconnect as a possible source of duplicates, and ask support first.

Everything above works without us, and the linked Housecall Pro 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.

Related reading

• Jobber + QuickBooks Online: how the sync actually works, and the errors that break it
• Unpaid invoices in a trade business: the first 30 days, step by step
• Overdue invoice reminders for service businesses: settings for Jobber, Housecall Pro and QuickBooks, plus templates
• Jobber vs Housecall Pro: the money side, plan by plan

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