Where does Housecall Pro show failed QuickBooks Online syncs, and how do I fix them?
By the ReconoSync team · Published · Updated
Failed Housecall Pro QuickBooks Online syncs show on Sync Alerts, opened from the QuickBooks icon in the top right. Each row is an invoice or job that never posted. Fix the cause first, then the three dots, then Sync again. Silent mismatches show against My Money and the bank.
This is the click path for a bookkeeper who closes several Housecall Pro shops in QuickBooks Online. A field service management system, or FSM, is the shop’s job, invoice, and payment app. Housecall Pro is that FSM. A payout is the lump that hit the bank.
Two kinds of errors
The native sync posts invoices and payments. Catching what it got wrong is a second job.
| Kind | Where it shows | What it is |
|---|---|---|
| Export failure | Housecall Pro Sync Alerts | A record that never posted: closed period, duplicate number, missing tax rate, name collision |
| Silent mismatch | My Money vs Undeposited Funds vs the bank | Duplicate payment, fee-netted deposit, missed bank-feed line |
The native sync wins the posting job. It is included on Housecall Pro Essentials and MAX, per the onboarding guide dated 2026-03-05. A commenter on r/QuickBooks in June 2025 told a shop joining the files to check the sync errors tab at least once a month.
Where Housecall Pro shows the failed sync
Failed exports live in Housecall Pro.
| Place | Click path | What it lists |
|---|---|---|
| Sync Alerts | QuickBooks icon, top right | Job number, time, type, description, resolution |
| Same queue from Settings | Gear, Money, QuickBooks Online, Sync alerts | The same rows |
| Job Details | QuickBooks Online section under the Activity Feed, View Alerts | The alert that fired on a manual push of that job |
| Import history | QuickBooks icon, Import, View Errors | One-time import failures, not the live push |
Housecall Pro’s settings help, dated 2026-01-21, puts Sync Alerts behind the QuickBooks icon. Syncing help, dated 2026-09-03, says a failed manual push reloads that job’s QuickBooks box with View Alerts. Import errors are a different queue.
How to reprocess, and when to Dismiss
Housecall Pro’s sync-alerts help, read 2026-11-13, is the fix list. Resolve the cause first. Reprocessing a still-broken record posts a second copy, or the same alert comes back.
- Click the QuickBooks icon in the top right.
- Fix the cause in QuickBooks or in Housecall Pro, using the table below.
- On the alert, click the three dots, then Sync again. Some alerts still show a Reprocess control on hover. Either one retries the push.
- Confirm the invoice in QuickBooks by number before you leave the row.
Dismiss is the X on hover. The help says it cannot be undone. Use it only when you already posted that invoice by hand and wrote the memo. A later Finish, Invoice, or Pay click can regenerate it. Keep the sync on. The settings help says to contact Chat Support before you disconnect. Disconnecting leaves what already posted.
Housecall Pro’s product page, read 2026-11-13, says built-in error handling prevents duplication. That guard stops a second document from reusing a number. It does not stop a second document with a new number.
The alerts and the fix for each
Work names and items before invoices, then payments. A later error often cascades from an earlier name or tax row.
| Alert | What it means | Fix, then Sync again |
|---|---|---|
| Invalid Item Ref | Checking account used for card auto-move was deleted | Make it active. Match Banking settings to My Money Payout settings. Ask Housecall Pro Chat Support to reconnect the name |
| Display Name Conflict | Duplicate Housecall Pro customer on the invoice | Rename one, or merge true duplicates |
| Duplicate Name Exists Error | Customer, Service Plan, or product not linked to the QuickBooks display name | Sync again. If it stays, Housecall Pro Chat Support repairs the link |
| Name Already Taken | Display name matches a QuickBooks vendor or employee | Change the Housecall Pro display name |
| Tax Rate Unavailable | Tax name does not match QuickBooks exactly | Recreate the rate with the same spelling, including trailing spaces |
| Account Period Closed | Invoice date is on or before the QuickBooks closing date | Reopen with the person who closed it, or ask Housecall Pro to drop the alert if the invoice is already correct |
| Invoice Number Already Taken | That number already exists in QuickBooks | Search by number. Then regenerate from the Housecall Pro sequence or the QuickBooks sequence |
| At least 1 line item is required | No service or material line | Add a line, even a $0 line |
| QuickBooks Service Unavailable | Connection dropped mid-push | Sync again |
QuickBooks requires unique names across customers, vendors, and employees. A commenter on r/smallbusiness in January 2024 said leftover name mismatches started raising errors. Merge true duplicates. Rename the rest. Search QuickBooks by number before you retry, in case the office typed that invoice while the alert sat.
Tax rates must match exactly, including trailing spaces. Housecall Pro does not support compound tax rates. QuickBooks Automated Sales Tax can still overwrite a posted invoice by job address, leaving an unpaid balance or a credit. Override the tax on the QuickBooks invoice if the cash already matches.
Regenerating Invoice Number Already Taken assigns a new number so the push can complete. It does not merge the two invoices. Confirm both against the job before you void either one. That pair is why Housecall Pro creates duplicate invoices. Intuit’s close-books help, updated 2026-09-15, sets the lock under Settings, Account and settings, Advanced, Close the books.
Invalid Item Ref is the most common auto-reconciliation alert. Housecall Pro’s reconciling-payments help, dated 2026-01-21, says Banking settings and My Money Payout settings have to be the same account or card payments land on an old bank. Then tell Housecall Pro Chat Support the checking account name.
What Sync Alerts miss
A payment that posted twice does not appear in Sync Alerts. A deposit that hit the bank net of fees, or a bank-feed line that never arrived, shows when you pull My Money and the bank.
| What you will see | Why the log is quiet |
|---|---|
| Two Receive Payment records, one unapplied | The sync posted. The bank feed posted the same cash |
| Undeposited Funds grows, bank rec still one lump | Gross payments, net payout |
| Invoice looks complete, totals do not tie | Automated Sales Tax overwrote the rate, or a field dropped |
| Bank statement has a line QuickBooks never downloaded | The feed missed it |
Brad Nelson, a CPA, posted on 2026-08-15 that a contractor’s Housecall Pro invoices and deposits were never matched in QuickBooks, so the 2024 return showed $367,000 of revenue against about $260,000 actual. Treat that as one client’s cleanup. A commenter on r/Bookkeeping in November 2025 preferred booking from the Housecall Pro report because the live sync needed more cleanup. The native sync still wins the posting job when it is on.
Intuit’s categorize help, updated 2026-08-24, treats Categorize or Post as a new ledger entry. Match merges the downloaded line with the deposit Housecall Pro already built. Card grouping is how to reconcile Housecall Pro payouts. Finding twins is how to find duplicate transactions in QuickBooks Online. Other FSMs park failures in their own logs, which is where field service apps show failed QuickBooks syncs.
If cash was typed in QuickBooks first, managing-payments help, dated 2026-08-07, has Pull Payment from QBO and Add Local Payment so you do not send a second payment.
After you find the extra copy
Confirm the cash hit the bank once against My Money. Keep the copy that is applied, deposited, or already marked R or C. Prefer exclude or void with a memo. Intuit’s void help, updated 2026-09-07, keeps a zero record.
| Where the extra copy sits | What to do |
|---|---|
| Sync Alerts | Fix the cause, then Sync again. Dismiss only if you already posted that invoice by hand |
| For review | Exclude. Undo from Excluded if you miss |
| Categorized or Posted | Undo, then Match or Exclude |
| Unapplied payment in Undeposited Funds | Void the unapplied copy after My Money confirms one cash event |
| Second invoice for one job | Void the extra invoice with a memo that names the job and the invoice you are keeping |
The native Housecall Pro sync wins the posting job. It creates the invoices and payments so you are not retyping them.
Pull this week’s Sync Alerts, the My Money payout with each deposit expanded, the QuickBooks Undeposited Funds detail, and the bank statement. Start with those files. They already exist.
Frequently asked questions
Does an empty Housecall Pro Sync Alerts page mean every invoice is in QuickBooks?
Housecall Pro's sync-alerts help, read 2026-11-13, lists records that failed to post. A payment that posted twice, a fee-netted deposit, or a missed bank-feed line still needs My Money and the bank. Search QuickBooks by invoice number before you call the week closed.
Can I undo Dismiss on a Housecall Pro Sync Alert?
No. The sync-alerts help, read 2026-11-13, says Dismiss cannot be undone. Use it only when you already posted that invoice by hand and wrote the memo. A later Finish, Invoice, or Pay click, or a manual push, can regenerate the alert. Prefer Sync again after you fix the cause.
Should I disconnect Housecall Pro from QuickBooks to clear the alerts?
Keep the sync on. Housecall Pro's settings help, dated 2026-01-21, says to contact Chat Support before disconnecting. Disconnecting leaves what already posted. Work the alerts, then check My Money against the bank. The native sync still wins the posting job.
What does Invoice Number Already Taken mean in Housecall Pro?
Housecall Pro found a QuickBooks invoice that already uses that number. The sync-alerts help, read 2026-11-13, lets you regenerate from the Housecall Pro sequence or the QuickBooks sequence. Regenerating does not merge the two invoices. Confirm both against the job before you void either one.
What does Invalid Item Ref mean on a Housecall Pro card payout?
Housecall Pro's sync-alerts help, read 2026-11-13, says this is the most common auto-reconciliation alert. The checking account the sync was set to use was deleted in QuickBooks. Make that account active, confirm Banking settings match My Money Payout settings, then ask Housecall Pro Chat Support to reconnect the account name.