General QuickBooks Info

How do I Troubleshoot Quickbooks When my Estimate/Invoice is not Syncing?

An estimate or invoice may not be syncing for a variety of reasons. First look at the error message located on the financial record. Read what the error message says by selecting "Why?".

QB - Estimate Not Syncing - Why

If there is no error and it doesn't say "synced with QuickBooks No/Why?", then the sync for those transactions is not set up yet.


Reasons an estimate or invoice is not syncing:

  1. Sync is not set up

  2. Contact or Job not syncing

  3. Not in a status that syncs 

  4. On initial setup, choosing a time constraint (Quickbooks Desktop only)

  5. Products not syncing within the invoice

  6. Conflict in estimate/invoice numbers


1. Sync is not set up:

If the sync is not set up the estimate/invoice will not have the line "Synced to Quickbooks".

Sync is set up for invoices:

QB - Estimate Not Syncing - Why

Sync that has NOT been set up:

QB - Estimate Not Syncing - Sync not set up

Check your sync settings

  • Check settings in JobNimbus=>Settings=>QuickBooks to see what is set up to sync.

    • If you do not see the QuickBooks tab in Settings, it may need to be enabled in Settings=>Features.

  • The sync has not been set up yet if you see this screen:
    QB - Estimate Not Syncing - Set up sync

2. Contact or Job not syncing:

There is a hierarchy to the sync. The records above it must sync. If an estimate/invoice was created on a job, then both the job and the contact need to sync before the transaction can. Check the "parent" records above it (contact/job). Common reasons are that they are not yet in a status that syncs. See this article for additional reasons why a contact is not syncing.

QB - Estimate Not Syncing - Sync pyramid

3. Not in a status that syncs 

Invoices and estimates are in ‘draft’ status by default after they are created in JobNimbus (this default cannot be changed or edited).

If you are syncing to QuickBooks Online, Estimates or invoices in "draft" status will not sync to Quickbooks.

 If you are using Quickbooks Desktop, you can decide if ‘Draft’ status syncs:

To turn on the sync for the ‘Draft’ status:

  • Settings=> QuickBooks

  • Estimates/Invoices "manage"
    QB - Estimate Not Syncing - Manage Estimates

  • Check the box next to ‘Sync Draft Estimates (Invoices). If the box is left unchecked, ‘draft’ status estimates will not sync.
    QB - Estimate Not Syncing - Sync estimate draft

It is easy to edit the status of an invoice or estimate:

  • Select the ellipse

  • Select "change status"

  • Choose a status other than draft
    QB - Estimate Not Syncing - Estimate statuses

There are some actions within JobNimbus that will automatically change the status of a transaction such as: emailing it to a customer (changes to ‘Sent’) or adding a payment (changes to ‘Closed’)


4. On initial setup, choosing a time constraint (Quickbooks Desktop only)

If you have an invoice/estimate that is outside of the date range it will be excluded from the sync. This will occur depending on how many months were chosen when the sync was set up.


The sync error on the transaction will read: “Will sync on the next cycle…”

To fix this: edit something on the invoice and save it. Then hit retry in the sync error report. It should sync on the next cycle.


5. Products not syncing within estimate/invoice: 

Products that are not syncing will prevent an invoice from syncing. If you have an estimate/invoice with ten products and one product is not syncing it will prevent the entire invoice from syncing. Each product on the invoice must sync. Your product list in settings will tell you which products are syncing.

  • Look at the error on the invoice to find product name

  • Go to Products and Services in Settings

  • Select "Both" from the drop-down

  • Search for the product to check it's sync status

  • Return to the invoice and re-select the product if needed
    QB - Estimate Not Syncing - Products and Services

Common reasons why a product is not syncing:

  • Product is a duplicate. A common issue is to have two products with identical names. QuickBooks will only allow a name to be used once. Choose the product you want to keep and make the other product hidden in JobNimbus. The invoice must be using the product that is syncing and not hidden.

    • If an invoice/estimate was made with a non-syncing product, edit the invoice/estimate, select the product again, adjust the price and save. The invoice should sync on the next sync cycle.

  • Quickbooks Desktop limits product names to 32 characters. If the Product name is longer than 32 characters, it cannot sync.

There is a custom line item used on the invoice. If the line item on the invoice was added prior to the QuickBooks sync being enabled, then it could be a ‘custom item’ (meaning it was not added to the product list when the invoice was created). Even if that product was added to the Product list after the face, the item line on the invoice could still be considered a ‘custom item’. The invoice must be edited to select the product from the product list instead:
QB - Estimate Not Syncing - Edit product on Invoice

  • The product was deleted or made inactive in Quickbooks. To fix this, make the product active again in QuickBooks.
    • To find inactive Products in QuickBooks Online, go to Sales=>Products & Services and change the filter.
      QB - Estimate Not Syncing - QBO Sales
    • To find inactive products in QuickBooks Desktop, go to Lists=>Item Lists and check the inactive box:
      QB - Estimate Not Syncing - Item List

6. Conflict in estimate/invoice numbers

If an estimate or invoice in Quickbooks exists with the same number there will be an error. In General Settings you may choose what number estimates and invoices start at to avoid conflicts in numbering. 

QB - Estimate Not Syncing - Next Invoice ID

To fix:

  • Change the ID number at which invoices start at by going to: Settings=>General 

  • Duplicate the invoice or estimate in JobNimbus (a new number will be assigned)

  • Delete the original that won't be able to sync due to an existing number.

    • unless the estimate has a signature, then leave it in JobNimbus

  • The newly created invoice should now sync with a newly assigned number