> For the complete documentation index, see [llms.txt](https://help.alternativepayments.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.alternativepayments.io/payments-and-invoicing/managing-invoices/sync-tool-error-messages.md).

# 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.

<figure><img src="https://1567070316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKPl2XyqKMY0CU5Sb4EWy%2Fuploads%2FfI0og9n0qG4bLEc3Rjka%2Fimage.png?alt=media&amp;token=8c72cba8-7388-44fe-8ee1-f4be9bf22f94" alt=""><figcaption></figcaption></figure>

#### 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.

<figure><img src="https://1567070316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKPl2XyqKMY0CU5Sb4EWy%2Fuploads%2FG92T47ofAPbdpwTelLMv%2Fimage.png?alt=media&amp;token=9b16284f-3eca-4906-a5ff-c83fdf1259ea" alt=""><figcaption></figcaption></figure>

**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.

2. **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.

3. **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.

4. **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.

5. **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.

6. **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**.

7. **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**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.alternativepayments.io/payments-and-invoicing/managing-invoices/sync-tool-error-messages.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
