Skip to main content

QBO Integration Error Codes

At times, errors may pop up during the integration between Canopy and QuickBooks Online (QBO). Refer to the following resources to find the description of error codes and their solutions.

If you cannot find the correct error code or message in the resources, please reach out to customer support.


Fix an Expired QBO Login

When most of your QBO syncs fail because your QBO login expired, Canopy shows a Your QBO connection needs attention banner on Billing > Invoices and Settings > Billing Settings > Manage QBO Integration. Only users with the Manage QBO integration permission see it.

To fix an expired QBO login:

  1. Click Refresh Login on the banner.

  2. Sign in to the same QBO company that is already connected to Canopy.

    • If no sign-in window opens, allow pop-ups for Canopy and click Refresh Login again.

  3. Confirm you see QBO login refreshed. The banner clears.

Step 1: Find Refresh Login on the banner at the top of Billing > Invoices.

Your QBO connection needs attention banner on the Invoices page, with Refresh Login marked

Step 1: Find Refresh Login on the banner on the Manage QBO Integration tab.

Your QBO connection needs attention banner on the Manage QBO Integration tab, with Refresh Login marked

Re-sync What Failed While the Login Was Expired

Refreshing the login doesn't re-send invoices or payments that failed while it was expired. You need the Manage QBO integration permission to see Sync now.

To re-sync what failed:

  1. Open Billing > Invoices and check the QBO sync column.

    • An invoice number: synced. Nothing to do.

    • Sync now: didn't sync. This is what needs fixing.

    • A dash (—): can't be synced from Canopy (drafts, or invoices created before QBO was connected). Leave these alone.

  2. Search QBO for each invoice number that shows Sync now.

    • If it's already in QBO, skip it. Syncing it again can create a duplicate.

  3. Click Sync now on each invoice you didn't skip.

    • Canopy shows "Re-syncing invoice with QBO" and syncs in the background.

  4. After a few minutes, reload the page.

    • The QBO sync column should now show the invoice number.

  5. Repeat on the Payments page, using its QBO sync column.

    • Sync invoices first. A payment can't sync until its invoice has.


Troubleshooting

Nothing happens when I click Refresh Login:

  • Your browser blocked the pop-up. Allow pop-ups for Canopy and try again.

I see "We couldn't refresh your QBO login. Please try again.":

  • The QBO sign-in failed. Retry with a QBO user who can access the company. If it keeps failing, contact Support.

I see "Unable to sync because this payment's invoices are not connected to QBO":

  • Sync the invoice first, then the payment.

Sync now still shows after I click it:

  • The sync is still queued or failed again. Wait a few minutes and reload. If Sync now is still there, contact Support with the invoice or payment numbers.

Heads Up! Don't use Restart integration or Disconnect to fix an expired login. Both erase your QBO links and force a full initial sync. Use Refresh Login, then Sync now on each item that failed.


You may receive a message along the lines of "Updates are not syncing with QBO due to...". They may look like any of the following images, depending on where you are in Canopy.

Screen Shot 2023-08-11 at 2.51.05 PM.png

Screen Shot 2023-08-11 at 2.38.24 PM.png

2024-05-07_10-17-58.jpg

Screen Shot 2023-08-11 at 2.50.49 PM.png

Message

Issue

Fix(es)

"Updates are not syncing with QBO due to..."

The QBO account used to set up the QBO integration is no longer an Admin in QBO.

Have a team member add you again as an Admin in QBO (you may need to go through the Reauthorization process afterward).

or

If you initially set up the integration, click the Reauthorize button. This will open a new window or tab. Sign in to QBO there. This is a specific flow that allows you to change the Admin for the integration. You don't need to repeat the whole integration process. Just sign in and confirm!

You missed a payment for your QBO account and QBO has suspended your account.

Make a payment on your QBO account.

Your QBO connection needs attention.

You went 100+ days without performing an action in Canopy that used the QBO integration. This means you didn't create a client, invoice, or service item for 100+ days.

If you initially set up the integration, click the Reauthorize button. This will open a new window or tab. Sign in to QBO there. This is a specific flow that allows you to change the Admin for the integration. You don't need to repeat the whole integration process. Just sign in and confirm!

Tip: You'll be able to see these error messages in any QBO-related columns in Canopy (invoices, clients, etc.) and on the QBO tile in the Integrations settings page.

Warning: If you do not fix the issue related to the error message within ~2 weeks of seeing the first error message, the integration automatically disconnects and you'll have to restart the integration to keep using it.

Did this answer your question?