---
title: How do I troubleshoot QuickBooks Online?
description: Tips on how to troubleshoot your QuickBooks Online sync with JobNimbus.
---

[Skip to content](https://support.jobnimbus.com/troubleshooting-qbo#main-content)

English

Show submenu for translations

[Contact Us](https://support.jobnimbus.com/kb-tickets/new?hsLang=en)

![JN\_Logo\_Long-White@1x.png\]](https://support.jobnimbus.com/hs-fs/hubfs/JN_Logo_Long-White@1x.png?height=40&name=JN_Logo_Long-White@1x.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Contact Us](https://support.jobnimbus.com/kb-tickets/new)
- [Go to the JobNimbus Toolbox](https://www.jobnimbus.com/support/)

[Go to the JobNimbus Toolbox](https://www.jobnimbus.com/support/)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Help Center](https://support.jobnimbus.com/?hsLang=en)
2. [QuickBooks](https://support.jobnimbus.com/quickbooks?hsLang=en)
3. [QuickBooks Online](https://support.jobnimbus.com/quickbooks?hsLang=en#quickbooks-online)

# How do I troubleshoot QuickBooks Online?

## Tips on how to troubleshoot your QuickBooks Online sync with JobNimbus.

Be sure that the sync is set up and running properly. If you have not set up the initial sync, please refer to [this article](https://support.jobnimbus.com/how-do-i-connect-with-quickbooks-online?hsLang=en).

If the sync is set up and running properly, a time stamp at the top of the QuickBooks settings page (JobNimbus --\> Settings --\> 'QuickBooks' tab) will update every few hours.

![](https://support.jobnimbus.com/hubfs/c39e1e40-f0e3-4c11-a085-9a54021e795b-png.png)

If the sync has not run within the last few hours, the sync may have become disconnected from QuickBooks or has not yet run completely for the first time.

- If there is no timestamp, refer to the article above for connecting to QuickBooks Online.
- If the timestamp is present but is several hours or days past, click on the blue ‘**Sync Now**' button to see if it completes.
  
    - If it does not, then the sync has been disconnected from the QuickBooks program. Please refer to [this article](https://support.jobnimbus.com/how-do-i-determine-if-my-sync-is-running?hsLang=en) to resolve.

#### **Sync Error Report**

The sync error report shows a list of records that tried to sync but could not. Errors in this screen doesn't mean the sync isn't working entirely, only that there are some records that may need to be corrected. 

The below screenshot explains the QuickBooks setup interface in JobNimbus. This is located under the 'QuickBooks' in your JobNimbus settings when you click **Show Sync Errors**.

![](https://support.jobnimbus.com/hubfs/d3dbd04a-f422-4daf-9393-7c88fa4d827b-png.png)

### Troubleshooting QuickBooks Online

#### 1. An invoice I created in QuickBooks is not syncing to JobNimbus

- Be sure you are not using a **one-way sync** (from JobNimbus to QuickBooks). Records in QuickBooks will *not* sync to JobNimbus if this type of sync is configured.
- Check the **Sync Error Report** to see if there was something entered on the invoice that could not sync with JobNimbus. Correct the error and hit ‘retry’ on the report. Common sync errors are listed below.
- New information entered in QuickBooks can only import into JobNimbus **during a sync cycle**. Check the timestamp at the top of the QuickBooks settings page to see when the sync last ran. If it has not been updated since the invoice was entered into QuickBooks, you can hit the blue ‘sync now’ to run the sync immediately.
- Refresh your internet browser to reload JobNimbus.
- Check that the Contact or Job associated with the invoice is syncing to JobNimbus.

#### 2\. **My record will not sync to QuickBooks from JobNimbus**

- There are two places in JobNimbus to find what is keeping a record from syncing: 
    - The Sync Error Report (see above)
    - On the record itself (see ‘**synced with QuickBooks**’ status). If there is a ‘No’, click on the blue ‘why?’ and the error will display.

![](https://support.jobnimbus.com/hubfs/37023c1b-8fb4-48e4-9584-4690cb1bebbe-png.png)

#### **3. How do I fix the errors in my sync error report?**

Refer to the following linked articles to address common errors:

- [Unable to sync because of discount lines](https://support.jobnimbus.com/qbo-error-this-record-cant-sync-because-it-contains-discount-lines?hsLang=en)
- [Estimate skipped because QuickBooks product or discount not found in JN](https://support.jobnimbus.com/qbo-error-estimate-skipped-because-quickbooks-product-or-discount-not-found-in-jobnimbus?hsLang=en)
- [Duplicate document number](https://support.jobnimbus.com/qbo-error-duplicate-document-number-error-you-must-specify-a-different-number-this-number-has-already-been-used?hsLang=en)
- [Duplicate name exists](https://support.jobnimbus.com/qbo-error-duplicate-name-exists-error-the-name-supplied-already-exists-another-customer-vendor-or-employee-is-already-using-this-name-please-use-a-different-name?hsLang=en)
- [QuickBooks payment method not linked](https://support.jobnimbus.com/qbo-error-quickbooks-payment-method-is-not-linked-in-jobnimbus?hsLang=en)
- [Line item "product name" not found in QuickBooks](https://support.jobnimbus.com/qbo-error-this-record-contains-the-line-item-product-name-which-is-not-found-in-quickbooks?hsLang=en)
- [This product is a category item in QuickBooks](https://support.jobnimbus.com/qbo-error-this-product-is-a-category-item-in-quickbooks?hsLang=en)
- [Stale object error](https://support.jobnimbus.com/qbo-error-stale-object-error-you-and-someone-else-were-working-on-this-at-the-same-time-that-someone-else-finished-before-you-did-so-your-work-was-not-saved?hsLang=en)
- [Payments that consist of both a regular payment and a credit memo are not supported](https://support.jobnimbus.com/qbo-error-payments-that-consist-of-both-a-regular-payment-and-a-credit-memo-are-not-currently-supported-and-will-not-sync-to-jobnimbus?hsLang=en)
- [Invalid company status](https://support.jobnimbus.com/qbo-error-invalid-company-status-subscription-period-has-ended-or-canceled-or-there-was-a-billing-problem?hsLang=en)
- [The parent record(s) \[name\] has not synced to QuickBooks](https://support.jobnimbus.com/qbo-error-the-parent-records-name-has-not-synced-to-quickbooks?hsLang=en)
- [Invalid reference ID](https://support.jobnimbus.com/qbo-error-invalid-reference-id-names-element-id-4300-not-found?hsLang=en)
- [TxnID cannot be linked](https://support.jobnimbus.com/qbo-error-txnid-cannot-be-linked?hsLang=en)
- [This record can't sync because it contains group lines](https://support.jobnimbus.com/qbo-error-this-record-cant-sync-because-it-contains-group-lines?hsLang=en)

#### 4. **My job is not syncing; it says no parent record**

Every job needs a **Primary Contact** in order to sync to QuickBooks.

To fix this:

- Navigate to the Job record in JobNimbus
- Select the **+** under Related Contacts in the bottom right corner
- Add a Contact in the **Related Contacts **field
- **Save**

  Once that Primary Contact has synced to QuickBooks, then the Job can also sync.

![](https://support.jobnimbus.com/hs-fs/hubfs/Screenshot%202025-12-08%20at%2012-47-16%E2%80%AFPM-png.png?width=431&height=204&name=Screenshot%202025-12-08%20at%2012-47-16%E2%80%AFPM-png.png)

#### 5\. How do I merge duplicate records in QuickBooks?

In QuickBooks Online, it is at your discretion to merge your records; it may or may not be a solution to a duplicate.

[This article](https://quickbooks.intuit.com/learn-support/en-us/help-article/manage-customers/add-manage-customers-quickbooks-online/L0M9mMZmd_US_en_US) will explain the merging process.

\* *This merging process is permanent and **cannot be undone** \**

1. Within QuickBooks, go to '**Customers**'
2. Select and open the customer profile you *do not* want to keep.
3. Select **Edit**.
4. In the **Display name as** field, enter the name of the customer profile you want to keep.
   
     1. The names need to match **exactly**.
5. Select **Save**.
6. When asked if you want to merge the two profiles, select **Yes**.

- **Note:** If Customers need to be merged, first move all sub-customers to the contact you intend to keep.

The account being merged will maintain the status of "deleted" until QuickBooks Online's nightly processing removes them.  Any transactions in the account being merged will be moved to the remaining account at the time the merge is processed.

 

**Tip:** If one contact is syncing to JobNimbus and the other is not, keep the one that is syncing. Merging contacts in QuickBooks will not merge them in JobNimbus or vice versa. If duplicates exist in both, they will have to be merged in both systems

#### **6. How do I merge duplicate records in JobNimbus?**

**Important: ** The merging process is not reversible. Merging is permanent and cannot be undone at a later point.

1. Navigate to the contact you want to keep and click on the ellipses in the top right corner.
2. Select ‘**Merge**’
3. Start typing the name of the contact and select it from the options that appear
4. Acknowledge the warning: "I understand that this action cannot be undone"
5. Click ‘**Merge**’

**Please note:** You will want to make sure you keep the same record in both systems. Also be sure the record you are keeping is the one that is syncing.

\* *This merging process is permanent and **cannot be undone** \**

- [Learning and Training Resources](https://support.jobnimbus.com/learning-and-training-resources?hsLang=en)
- [Jobs, Contacts, and Boards](https://support.jobnimbus.com/jobs-contacts-and-boards?hsLang=en#main-content)

    - [Jobs and Contacts](https://support.jobnimbus.com/jobs-contacts-and-boards?hsLang=en#jobs-and-contacts)
    - [Boards](https://support.jobnimbus.com/jobs-contacts-and-boards?hsLang=en#boards)
    - [Documents & Photos](https://support.jobnimbus.com/jobs-contacts-and-boards?hsLang=en#documents-photos)
    - [Subcontractors as Contacts](https://support.jobnimbus.com/jobs-contacts-and-boards?hsLang=en#subcontractors-as-contacts)
    - [Communications](https://support.jobnimbus.com/jobs-contacts-and-boards?hsLang=en#communications)
- [Calendar and Tasks](https://support.jobnimbus.com/calendar-and-tasks?hsLang=en#main-content)

    - [Syncing Your Calendar](https://support.jobnimbus.com/calendar-and-tasks?hsLang=en#syncing-your-calendar)
    - [Your Calendar](https://support.jobnimbus.com/calendar-and-tasks?hsLang=en#your-calendar)
    - [Tasks](https://support.jobnimbus.com/calendar-and-tasks?hsLang=en#tasks)
    - [Record Scheduling](https://support.jobnimbus.com/calendar-and-tasks?hsLang=en#record-scheduling)
- [Financials](https://support.jobnimbus.com/financials?hsLang=en#main-content)

    - [Estimates](https://support.jobnimbus.com/financials?hsLang=en#estimates)
    - [Invoices](https://support.jobnimbus.com/financials?hsLang=en#invoices)
    - [Work Orders](https://support.jobnimbus.com/financials?hsLang=en#work-orders)
    - [Material Orders](https://support.jobnimbus.com/financials?hsLang=en#material-orders)
    - [Margin and Markup](https://support.jobnimbus.com/financials?hsLang=en#margin-and-markup)
    - [Products and Services](https://support.jobnimbus.com/financials?hsLang=en#products-and-services)
    - [Taxes](https://support.jobnimbus.com/financials?hsLang=en#taxes)
    - [Measurements](https://support.jobnimbus.com/financials?hsLang=en#measurements)
    - [Profit Tracker](https://support.jobnimbus.com/financials?hsLang=en#profit-tracker)
    - [Payments](https://support.jobnimbus.com/financials?hsLang=en#payments)
    - [Credit Memos](https://support.jobnimbus.com/financials?hsLang=en#credit-memos)
    - [Financing](https://support.jobnimbus.com/financials?hsLang=en#financing)
- [Reports](https://support.jobnimbus.com/reports?hsLang=en#main-content)

    - [Insights](https://support.jobnimbus.com/reports?hsLang=en#insights)
    - [Classic Reports](https://support.jobnimbus.com/reports?hsLang=en#classic-reports)
    - [Built-in Reports](https://support.jobnimbus.com/reports?hsLang=en#built-in-reports)
    - [Analytics](https://support.jobnimbus.com/reports?hsLang=en#analytics)
- [Settings](https://support.jobnimbus.com/settings?hsLang=en#main-content)

    - [General Settings](https://support.jobnimbus.com/settings?hsLang=en#general-settings)
    - [Company Info](https://support.jobnimbus.com/settings?hsLang=en#company-info)
    - [Team](https://support.jobnimbus.com/settings?hsLang=en#team)
    - [Groups](https://support.jobnimbus.com/settings?hsLang=en#groups)
    - [Estimate Settings](https://support.jobnimbus.com/settings?hsLang=en#estimate-settings)
    - [Workflows](https://support.jobnimbus.com/settings?hsLang=en#workflows)
    - [Templates](https://support.jobnimbus.com/settings?hsLang=en#templates)
    - [Forms](https://support.jobnimbus.com/settings?hsLang=en#forms)
    - [Subscription](https://support.jobnimbus.com/settings?hsLang=en#subscription)
    - [Mobile Settings](https://support.jobnimbus.com/settings?hsLang=en#mobile-settings)
- [Automations](https://support.jobnimbus.com/automations?hsLang=en#main-content)

    - [Event-Based Automations](https://support.jobnimbus.com/automations?hsLang=en#event-based-automations)
    - [Time-Based Automations](https://support.jobnimbus.com/automations?hsLang=en#time-based-automations)
    - [Automation Recipes](https://support.jobnimbus.com/automations?hsLang=en#automation-recipes)
- [Engage](https://support.jobnimbus.com/engage?hsLang=en#main-content)

    - [Set-Up](https://support.jobnimbus.com/engage?hsLang=en#set-up)
    - [Usage](https://support.jobnimbus.com/engage?hsLang=en#usage)
- [AssistAI](https://support.jobnimbus.com/assistai?hsLang=en)
- [JobNimbus Marketing](https://support.jobnimbus.com/jobnimbus-marketing?hsLang=en)
- [JobNimbus Payments](https://support.jobnimbus.com/jobnimbus-payments?hsLang=en#main-content)

    - [Account Set-Up](https://support.jobnimbus.com/jobnimbus-payments?hsLang=en#account-set-up)
    - [Usage](https://support.jobnimbus.com/jobnimbus-payments?hsLang=en#usage)
    - [Fees and Transactions](https://support.jobnimbus.com/jobnimbus-payments?hsLang=en#fees-and-transactions)
    - [Tracking and Reporting](https://support.jobnimbus.com/jobnimbus-payments?hsLang=en#tracking-and-reporting)
- [QuickBooks](https://support.jobnimbus.com/quickbooks?hsLang=en#main-content)

    - [General QuickBooks Info](https://support.jobnimbus.com/quickbooks?hsLang=en#general-quickbooks-info)
    - [QuickBooks Online](https://support.jobnimbus.com/quickbooks?hsLang=en#quickbooks-online)
    - [Accounting Sync](https://support.jobnimbus.com/quickbooks?hsLang=en#accounting-sync)
    - [QuickBooks Desktop](https://support.jobnimbus.com/quickbooks?hsLang=en#quickbooks-desktop)
- [Suppliers](https://support.jobnimbus.com/suppliers?hsLang=en#main-content)

    - [ABC Supply](https://support.jobnimbus.com/suppliers?hsLang=en#abc-supply)
    - [QXO](https://support.jobnimbus.com/suppliers?hsLang=en#qxo)
    - [SRS Distribution](https://support.jobnimbus.com/suppliers?hsLang=en#srs-distribution)
    - [Third-Party Suppliers](https://support.jobnimbus.com/suppliers?hsLang=en#third-party-suppliers)
- [Integrations](https://support.jobnimbus.com/integrations?hsLang=en#main-content)

    - [API](https://support.jobnimbus.com/integrations?hsLang=en#api)
    - [Angi](https://support.jobnimbus.com/integrations?hsLang=en#angi)
    - [ArcSite](https://support.jobnimbus.com/integrations?hsLang=en#arcsite)
    - [BirdEye](https://support.jobnimbus.com/integrations?hsLang=en#birdeye)
    - [CompanyCam](https://support.jobnimbus.com/integrations?hsLang=en#companycam)
    - [EagleView](https://support.jobnimbus.com/integrations?hsLang=en#eagleview)
    - [Get The Referral](https://support.jobnimbus.com/integrations?hsLang=en#get-the-referral)
    - [Global Payments](https://support.jobnimbus.com/integrations?hsLang=en#global-payments)
    - [HailTrace](https://support.jobnimbus.com/integrations?hsLang=en#hailtrace)
    - [Hover](https://support.jobnimbus.com/integrations?hsLang=en#hover)
    - [Leap](https://support.jobnimbus.com/integrations?hsLang=en#leap)
    - [mySalesman](https://support.jobnimbus.com/integrations?hsLang=en#mysalesman)
    - [naturalForms](https://support.jobnimbus.com/integrations?hsLang=en#naturalforms)
    - [Podium](https://support.jobnimbus.com/integrations?hsLang=en#podium)
    - [RoofScope](https://support.jobnimbus.com/integrations?hsLang=en#roofscope)
    - [SalesRabbit](https://support.jobnimbus.com/integrations?hsLang=en#salesrabbit)
    - [Simplii](https://support.jobnimbus.com/integrations?hsLang=en#simplii)
    - [Solo](https://support.jobnimbus.com/integrations?hsLang=en#solo)
    - [Spotio](https://support.jobnimbus.com/integrations?hsLang=en#spotio)
    - [SumoQuote](https://support.jobnimbus.com/integrations?hsLang=en#sumoquote)
    - [Sunlight Financial](https://support.jobnimbus.com/integrations?hsLang=en#sunlight-financial)
    - [Toolsey](https://support.jobnimbus.com/integrations?hsLang=en#toolsey)
    - [Wisetack](https://support.jobnimbus.com/integrations?hsLang=en#wisetack)
    - [Xactimate](https://support.jobnimbus.com/integrations?hsLang=en#xactimate)
    - [Zapier](https://support.jobnimbus.com/integrations?hsLang=en#zapier)
- [Additional Resources](https://support.jobnimbus.com/additional-resources?hsLang=en#main-content)

    - [General](https://support.jobnimbus.com/additional-resources?hsLang=en#general)
    - [Sales and Financial Information](https://support.jobnimbus.com/additional-resources?hsLang=en#sales-and-financial-information)
    - [Backing up data](https://support.jobnimbus.com/additional-resources?hsLang=en#backing-up-data)
- [App Status](https://support.jobnimbus.com/app-status?hsLang=en)
- [Suggestions](https://support.jobnimbus.com/suggestions?hsLang=en)
- [JobNimbus Legacy](https://support.jobnimbus.com/jobnimbus-legacy?hsLang=en#main-content)

    - [Legacy Estimates](https://support.jobnimbus.com/jobnimbus-legacy?hsLang=en#legacy-estimates)
    - [Legacy Invoices](https://support.jobnimbus.com/jobnimbus-legacy?hsLang=en#legacy-invoices)
    - [Legacy Material Orders](https://support.jobnimbus.com/jobnimbus-legacy?hsLang=en#legacy-material-orders)
    - [Legacy Budgets](https://support.jobnimbus.com/jobnimbus-legacy?hsLang=en#legacy-budgets)
    - [Legacy Mobile](https://support.jobnimbus.com/jobnimbus-legacy?hsLang=en#legacy-mobile)
    - [Legacy Integrations](https://support.jobnimbus.com/jobnimbus-legacy?hsLang=en#legacy-integrations)
    - [Legacy Jobs and Contacts](https://support.jobnimbus.com/jobnimbus-legacy?hsLang=en#legacy-jobs-and-contacts)
    - [Legacy Subscriptions](https://support.jobnimbus.com/jobnimbus-legacy?hsLang=en#legacy-subscriptions)
- [Analytics](https://support.jobnimbus.com/analytics?hsLang=en)

[![JN\_Logo\_Long-White@1x](https://support.jobnimbus.com/hs-fs/hubfs/JN_Logo_Long-White@1x.png?width=241&height=31&name=JN_Logo_Long-White@1x.png "JN_Logo_Long-White@1x")](http://www.jobnimbus.com)

JobNimbus Help Center

Copyright © 2025, JobNimbus