Housecall Pro sync with QuickBooks Online: clear every alert

Where do you find the sync alerts?

Click the QuickBooks icon at the top right of the Housecall Pro navigation bar. It opens the QuickBooks Online Sync Alerts settings page.

An alert on a single job shows at the top of its QuickBooks Online section, with a Review Alert link to the same page.

Count the alerts by type before fixing anything. Many share one cause.

Example tally of a long backlog:

Alert type	Count
Display Name Conflict	70
Tax Rate Unavailable	60
Invoice Number Already Taken	30
Name Already Taken	25
Account Period Closed	10
At least 1 line item is required	5

What does each alert mean, and what fixes it?

From Housecall Pro’s Sync Alerts article:

Alert	Cause	Fix
Display Name Conflict	An invoice was created for a duplicate customer	Merge the duplicates, or rename the customer
Name Already Taken	A QuickBooks customer, vendor or employee has the same name	Change the Customer Display Name in Housecall Pro
Duplicate Name Exists Error	A customer, Service Plan or Product/Service name isn’t linked to its QuickBooks match	Sync again; if it stays, ask Chat Support to repair it
Tax Rate Unavailable	Tax rate name or rate doesn’t match exactly, down to capitals and trailing spaces	Create the identical rate in QuickBooks, or pick a shared rate on the Job Details page
Invoice Number Already Taken	QuickBooks already has an invoice with that number	Sync again and choose a numbering sequence
Invalid Item Ref	Usually the bank account used to reconcile card payments was deleted in QuickBooks	Click Make Active next to it in the Chart of Accounts, then give Chat Support your checking account’s name
Account Period Closed	A synced invoice is being updated inside a closed accounting period	Reopen the period; if QuickBooks is already right, Chat Support can remove the alert
At least 1 line item is required	The invoice has no Service or Material line items	Add a line item, or ask Chat Support to remove the alert
QuickBooks Service Unavailable	The connection to QuickBooks dropped	Sync again

Housecall Pro doesn’t support compound tax rates. If you can’t create tax rates in QuickBooks, Automated Sales Tax is on and QuickBooks sets the tax from the job address.

In what order should you clear a long backlog?

1. Fix the settings first. One tax rate or bank account fix clears a whole group.

2. Merge duplicate customers in Housecall Pro. Housecall Pro says “Only one Customer Profile in Housecall Pro can be linked to a customer in QuickBooks Online.”

1. Click Customers in the left navigation bar.
2. Click Actions and select Manage duplicates. Possible duplicates are grouped by Name, Mobile Number, Home Number, Work Number or Email.
3. Expand a customer row, select the confirmed duplicates and click Merge.
4. Check the details in the pop-up and click Merge Customers.

“You cannot unmerge customers after completing this step.” Merge one pair, sync its alert and check QuickBooks before merging the rest.

3. Rename the name clashes. For Name Already Taken, change the Display Name in Housecall Pro, such as “Rivera Supply (customer)” when a vendor has that name. QuickBooks picks it up on the customer’s next invoice sync.

4. Fix invoice numbers. Housecall Pro now sends each invoice with its own invoice number instead of the job number, so some numbers collide with older QuickBooks invoices.

1. Click the 3 dots on the alert, then Sync again.
2. Compare the two invoices in the pop-up.
3. Choose Regenerate invoice number using Housecall Pro sequence or Regenerate invoice number using QuickBooks sequence.
4. Click Submit.

• If Match invoice and job number is on (Settings > Invoices > Configuration), contact Housecall Pro Support before reprocessing anything.
• With many stuck, each needs its own re-sync, so Housecall Pro suggests Support.
• If Housecall Pro emailed you a form about your invoice number sequence, filling it in lets them change it.

5. Agree closed periods with your accountant. An admin changes the closing date in QuickBooks under Settings > Account and settings > Advanced, then Edit in the Accounting section. QuickBooks blocks changes to transactions on or before that date without approval.

6. Sync each alert again. QuickBooks icon > 3 dots on the alert > Sync again, then answer any prompts.

7. Dismiss only what is already right in QuickBooks. Hover over the alert and click the X. “Dismissing an alert cannot be undone,” and the alert comes back if the job is edited or the invoice is pushed again.

Should you merge in Housecall Pro or in QuickBooks Online?

Merge where the duplicate lives. Display Name Conflict alerts come from duplicates in Housecall Pro; duplicates inside QuickBooks need QuickBooks’ merge. Both are permanent.

Intuit’s steps:

1. Go to All apps > Customer Hub > Customers & leads, and select the Customers tab.
2. Open the profile you don’t want to keep.
3. Select the dropdown next to Edit, then Merge contacts.
4. Change the Display name to match the profile you keep. “The names must be identical.”
5. Select Save, then Yes.

“This action is permanent and can’t be undone.” Neither customer can have sub-customers, which include linked projects. Keep the profile your Housecall Pro invoices land on: search QuickBooks for a recent Housecall Pro invoice number.

To spot QuickBooks duplicates, export your customer list and drop it into the free duplicate customer finder. For duplicates coming from a CRM, see fixing HubSpot and QuickBooks duplicate customers.

How do you check the sync worked?

• The alert is gone from the Sync Alerts page.
• In QuickBooks, the invoice appears once under the same number, on the right customer.

Then watch for what the sync never sends on its own:

• Edits after the first sync. Changed lines, quantities or prices don’t update QuickBooks. On the Job Details page, click the 3 dots in the QuickBooks Online section and select Push invoice to QBO.
• Work from before you connected. Jobs marked Finished, Sent or Paid before the integration have to be pushed by hand.
• Deleted or canceled invoices. Delete or cancel them in QuickBooks yourself.
• Estimates and printed invoices. Neither pushes.

How do you keep names unique so the alerts stop?

Housecall Pro: “QuickBooks Online requires all employees, vendors, and customers to have unique names.”

• Search by phone or email before adding a new customer.
• Run Customers > Actions > Manage duplicates once a week.
• Give same-name customers distinct Display Names, such as “John Smith (Oak St)”.
• Add “(customer)” for anyone who is also a vendor or on your payroll.

What are your options?

Option	Good for	Watch for
Clear it yourself in the order above	A few dozen alerts with clear causes	Merges can’t be undone; one Sync again per alert
Housecall Pro Chat Support	Duplicate Name Exists errors that won’t clear, many invoice number clashes	You still decide which customer and number are right
Your bookkeeper	Closed periods and checking the QuickBooks side	Needs access to Housecall Pro too
Bring in an outside team (Fixes & connections)	Hundreds of alerts with duplicates on both sides	Needs access to both tools and someone who knows the customers