For the complete documentation index, see llms.txt. This page is also available as Markdown.

Sync Tool Error Messages

Learn what the most common sync errors mean and how to fix them so your ConnectWise invoices sync successfully using the Sync Invoices functionality.

Overview

When you sync an invoice from ConnectWise (CW) to QuickBooks Online (QBO), QuickBooks can reject it because of how a customer, item, account, or accounting period is set up. When that happens, the invoice doesn’t sync and an error is returned.

Most of these errors are fixed by a change in QuickBooks, in ConnectWise, or in your account mapping. Each section below explains what the error means and the options for resolving it. You only need to apply one fix per error.

Note: This article applies to the ConnectWise and QuickBooks Online sync only.

Note: Changes made in QuickBooks or ConnectWise are managed in those platforms. If you’re unsure whether a change affects your books, check with your accountant before making it.

Finding a sync error

To see why an invoice didn’t sync, go to Previous syncs and select See details on the sync.

Retrying a sync after a fix

Once you’ve applied a fix, the invoice can sync again in either of these ways:

  • If automatic sync is enabled, let the next automatic sync run.

  • Run the sync manually from Unsynced invoices.

To run a manual sync:

  1. From your Partner Dashboard, select Sync invoices in the left menu.

  2. Select the Unsynced tab.

  3. Check the box next to each invoice you want to sync. To select all invoices, check the box in the header row.

  4. Select Sync invoices at the bottom of the page.

Note: The Unsynced tab shows the last 90 days by default. If you don’t see the invoice, change the date range using the View filter.

Common errors

  1. Customer deleted in QuickBooks

What it means: The customer exists in QuickBooks but is inactive. QuickBooks won’t allow new invoices to be created for an inactive customer, or existing invoices to be updated.

How to fix it:

  • In QuickBooks, restore (reactivate) the customer.

  • In QuickBooks, move the existing invoice to an active customer.

  • In ConnectWise, rename the customer. When a customer is deleted in QuickBooks, we automatically unmatch it on our side. On the next sync, we look for a QuickBooks customer with the new name and use it. If no customer with that name exists, a new one is created in QuickBooks.

  1. Name already used by a vendor or employee

What it means: QuickBooks uses one shared list of display names for customers, vendors, and employees. If a vendor or employee already has the same display name as your ConnectWise customer, QuickBooks rejects the customer.

How to fix it:

  • In QuickBooks, rename the vendor or employee display name. Adding “Vendor” to the end of the name is enough.

  • In QuickBooks, if the vendor or employee is no longer in use, archive it.

  • In ConnectWise, rename the customer.

  1. Item name already used as a category

What it means: QuickBooks uses shared names for products and services and their categories, so an item can’t have the same name as an existing category.

How to fix it:

  • In QuickBooks, rename the category. Adding “Category” to the end of the name is enough.

  • In ConnectWise, change the item code so it no longer matches the category name:

    • For non-product lines, update the Non-Product Id segment or the work role name.

    • For product lines, update the catalog item.

  1. Closed accounting period

What it means: The invoice is dated within an accounting period that’s closed in QuickBooks.

How to fix it:

  • In QuickBooks, reopen the books for that period.

  • In ConnectWise, change the invoice date to a date in an open period.

  1. Item linked to a wrong account type

What it means: The item is mapped to an account type that QuickBooks doesn’t allow on an item, such as Accounts Receivable, Accounts Payable, or a tax-tracking account. Items must use an income account.

How to fix it:

  • In ConnectWise, update the account mapping so the item points to an income account.

  • In QuickBooks, make sure the mapped account is an income account.

  1. Stale object error

What it means: Someone edited the same record in QuickBooks while the sync was running, so QuickBooks rejected the update.

How to fix it:

  • Retry the sync. Let the next automatic sync run if it’s enabled, or run it manually from Sync invoices > Unsynced.

  1. Income account not found

What it means: The income account number on the item in ConnectWise doesn’t match any account in your QuickBooks chart of accounts. The item can’t be created, so the invoice doesn’t sync.

How to fix it:

  • In QuickBooks, go to Chart of accounts and check that an active account exists with that exact number or name.

  • In QuickBooks, if the account exists but is inactive, make it active.

  • In ConnectWise, update the account mapping so the item points to an account number or name that exists in QuickBooks.

  • In ConnectWise, if the item has no account number, add one.

Still seeing an error?

If you’ve applied a fix and the invoice still doesn’t sync, or you see an error not listed here, contact our Customer Experience team at customersuccess@alternativepayments.io with the invoice number and the full error message from See details in Sync invoices > Previous syncs.

Last updated

Was this helpful?