Skip to main content

How to Fix Common QuickBooks Sync Errors

Learn what common QuickBooks Online sync error messages in SmartMoving mean and how to fix each one, including disconnection, closed period, inactive account, tax rate, and customer name errors.

P
Written by Patrick Burdette

Overview

Find out what a QuickBooks Online sync error in SmartMoving means and what to change so the invoice, payment, or refund syncs.

Available on the Growth plan and above with QuickBooks Online linked.


Before You Start

  • To open Settings > Integrations > Integration Library > QuickBooks / Intuit, your SmartMoving role needs the Settings permission.

  • To see the QB Sync Errors page, your SmartMoving role needs both the Accounting jobs and Accounting payroll permissions.

  • Some QuickBooks sync fixes happen inside QuickBooks Online, so you also need a QuickBooks user who can edit accounts, products and services, customers, and company settings.

  • To read a QuickBooks sync error, go to Accounting > QB Sync Errors and click View Details on the error. For how the page works, see Resolve QuickBooks Sync errors.

Note: If the QB Sync Errors tab is missing from Accounting, your QuickBooks connection has expired. Reconnect QuickBooks Online first, and the QB Sync Errors tab comes back.


Retry, Resync, or Mark Resolved: Which One to Use

After you fix the cause of a QuickBooks sync error, use one of these actions on the QB Sync Errors page. The table below explains when to use each one.

QuickBooks sync action

When to use it

Retry or Resync

You fixed the cause in SmartMoving or in QuickBooks, and SmartMoving needs to send the record to QuickBooks again.

Mark Resolved

You handled the record directly in QuickBooks. Mark Resolved clears the error and sends nothing to QuickBooks.


How to Fix "QuickBooks has been disconnected from your account."

This QuickBooks sync error can also read "Your QuickBooks account is no longer authenticated." QuickBooks Online stopped accepting the SmartMoving connection. A common cause is that the QuickBooks user who connected SmartMoving lost access to the QuickBooks company.

The QuickBooks account card in SmartMoving does not show this error. To check the connection, click Manage on the QuickBooks account card, click the gear icon, and look under Account Errors.

To reconnect QuickBooks Online to SmartMoving:

  1. Allow pop-ups for SmartMoving in your browser.

  2. Go to Settings > Integrations > Integration Library > QuickBooks / Intuit.

  3. Click Link New Account. The QuickBooks sign-in opens in a pop-up.

  4. Log in as a QuickBooks admin with access to the same company.

  5. Select the QuickBooks company that is already connected.

  6. Click Close Window when the pop-up shows Connection successful! SmartMoving refreshes your QuickBooks items and accounts.

  7. Go to Accounting > QB Sync Errors.

  8. Click Retry on each disconnected error. SmartMoving sends each record to QuickBooks again.

The QuickBooks connection is restored, and each record you retried syncs to QuickBooks.

Note: Reconnecting QuickBooks Online does not retry failed records. Each failed record stays on the QB Sync Errors page until you click Retry. If the QuickBooks user who first connected SmartMoving no longer has access to the QuickBooks company, log in with a different QuickBooks admin user who has access to that company.


How to Fix "Your QuickBooks account is no longer active."

This QuickBooks sync error means your QuickBooks Online subscription has lapsed or been canceled. Reconnecting QuickBooks does not fix this error.

  1. Renew or update your QuickBooks Online subscription with Intuit.

  2. In SmartMoving, go to Accounting > QB Sync Errors.

  3. Click Retry on each error. SmartMoving sends each record to QuickBooks again.

Once your QuickBooks Online subscription is active, each record you retried syncs to QuickBooks.


How to Fix "Account period closed"

The "Account period closed" QuickBooks sync error means the invoice, payment, or refund is dated on or before the closing date set in QuickBooks Online. QuickBooks blocks any new or changed transaction in a closed period, so Retry and Resync keep failing while that QuickBooks closing date is in place. You have two ways to fix it.

Option 1: Enter the Record in QuickBooks Manually

  1. Enter the invoice, payment, or refund directly in QuickBooks Online.

  2. In SmartMoving, go to Accounting > QB Sync Errors.

  3. Open the item menu on the error and select Mark Resolved. The error moves to the Resolved filter.

Option 2: Have Your Accountant Change the QuickBooks Closing Date

  1. Ask your accountant to move or remove the closing date in QuickBooks Online.

  2. In SmartMoving, go to Accounting > QB Sync Errors.

  3. Click Retry on the error. SmartMoving sends the record to QuickBooks again.

⚠️ Warning: Moving the QuickBooks closing date reopens books that were already finalized. Let your accountant make this decision.


How to Fix "A QuickBooks account, item, or customer has been made inactive."

This QuickBooks sync error means something connected to the SmartMoving record is inactive in QuickBooks Online. It is usually a mapped account, product or service, or class, and it can also be the customer. Click View Details on the error to see which item QuickBooks named.

  1. In SmartMoving, go to Settings > Integrations > Integration Library > QuickBooks / Intuit.

  2. Click Manage on the QuickBooks account card. The QuickBooks mappings page opens.

  3. Review the Jobs, Storage, and Account tabs for mapped items.

  4. In QuickBooks Online, check that each mapped item is active.

  5. Reactivate the item in QuickBooks, or map an active item in SmartMoving.

  6. Go to Accounting > QB Sync Errors and click Resync. SmartMoving sends the record again.

When every related account, product or service, and customer is active, the record syncs to QuickBooks.


How to Fix the QuickBooks Tax Rate Setup Error

This QuickBooks sync error reads: "Make sure your tax rate is setup on the QuickBooks integration page. In QuickBooks itself, make sure tax rates are selected for each product/service, and if you use erplain, make sure the tax rate is not empty." QuickBooks Online could not find a tax rate for the invoice, either in the SmartMoving tax mapping or on a QuickBooks product or service.

  1. In SmartMoving, go to Settings > Integrations > Integration Library > QuickBooks / Intuit.

  2. Click Manage on the QuickBooks account card.

  3. Click the Tax Info tab.

  4. Map a QuickBooks tax code to the Taxed and Non-Taxed rows.

  5. Confirm the Taxed tax code matches your branch's sales tax rate.

  6. In QuickBooks Online, open each product or service in your SmartMoving mappings.

  7. Confirm each QuickBooks product or service has a tax setting selected.

  8. If you use Erplain, confirm its tax rate is not empty.

  9. Go to Accounting > QB Sync Errors and click Resync. SmartMoving sends the invoice again.

The invoice syncs to QuickBooks with the tax code you mapped.

Note: The Tax Info tab appears for SmartMoving companies set up in Canadian dollars (CAD), and for companies set up in US dollars (USD) with the Sales Tax toggle on. See Connect to QuickBooks Online for the Sales Tax toggle.


How to Fix a QuickBooks Customer Name Error

QuickBooks Online does not allow a colon (:), a tab, or a line break in customer name fields. If a SmartMoving customer name contains one of these characters, the QuickBooks sync fails with a name error. The QuickBooks name rule applies to the display name, first, middle, and last name, title, suffix, and print-on-check name.

  1. From Accounting > QB Sync Errors, open the customer record in SmartMoving.

  2. Remove any colon from the customer's name fields.

  3. Remove any tab or line break, often left by pasting a name.

  4. Click Save. The customer record updates.

  5. Go to Accounting > QB Sync Errors and click Resync. SmartMoving sends the record again.

The record syncs to QuickBooks with the corrected customer name.

Note: Parentheses in a customer name are allowed in QuickBooks Online. SmartMoving adds (1), (2), and so on to a customer name when the same name already exists in QuickBooks.


How to Clear a QuickBooks Payment Error When the Deposit Was Already Moved

This QuickBooks sync error happens when SmartMoving tries to update a payment that was already deposited or allocated in QuickBooks Online, usually before the job was closed out in SmartMoving. QuickBooks does not let SmartMoving change a payment after it is moved into a deposit. The payment is already handled in QuickBooks, so nothing needs to change there.

  1. Go to Accounting > QB Sync Errors.

  2. Open the item menu on the error and select Mark Resolved. The error moves to the Resolved filter.

Note: Retry and Resync do not clear this QuickBooks payment error, because the payment is already deposited in QuickBooks.


How to Fix the QuickBooks Inventory Lock Error

This QuickBooks sync error reads: "Business Validation Error: The action could not be completed because another user was creating, editing or deleting a transaction with inventory products at exactly the same time. Please try again in 30 min. If the issue persists, please contact Customer Support." QuickBooks Online was busy saving another transaction with inventory products when SmartMoving tried to sync.

  1. Wait at least 30 minutes.

  2. Go to Accounting > QB Sync Errors.

  3. Click Retry on the error. SmartMoving sends the record to QuickBooks again.

The record syncs once QuickBooks finishes the other transaction. If the same error appears after several retries, contact SmartMoving Support.


Best Practices

  • Check Accounting > QB Sync Errors regularly, and before you close each month, so QuickBooks errors do not pile up.

  • Ask your accountant to set the QuickBooks closing date after all SmartMoving records for that period have synced.

  • Connect SmartMoving with a QuickBooks admin user who will keep long-term access to the QuickBooks company.

  • Before you deactivate an account, product or service, or customer in QuickBooks, check whether it is mapped in SmartMoving.


Troubleshooting

  • QuickBooks shows an unapplied credit that SmartMoving did not send.

    • QuickBooks Online is applying credits on its own. In QuickBooks, go to Settings > Account and settings > Advanced > Automation and turn off Automatically apply credits.

  • An invoice appears twice in QuickBooks.

    • A synced invoice was deleted in QuickBooks, so SmartMoving created a new copy the next time the record synced. Do not delete synced records in QuickBooks. Contact SmartMoving Support with the invoice number so Support can help clean up the duplicate.

  • Payments keep syncing to a QuickBooks customer with an old name.

    • After SmartMoving links a customer to a QuickBooks customer, it keeps syncing to that same QuickBooks customer, even if the customer is renamed in QuickBooks. See QuickBooks customer matching logic.

  • Transactions from before I connected QuickBooks are not in QuickBooks.

    • Connecting QuickBooks Online does not sync past transactions. Only transactions created or updated after you connect QuickBooks sync from SmartMoving.


FAQs

  • Does reconnecting QuickBooks retry my failed records?

    • No, reconnecting QuickBooks Online does not retry failed records. After you reconnect, go to Accounting > QB Sync Errors and click Retry on each failed record.

  • Does Mark Resolved send the record to QuickBooks?

    • No, Mark Resolved only clears the QuickBooks sync error from the list and sends nothing to QuickBooks. If you later edit the record in SmartMoving, it can sync to QuickBooks again.

  • What should I send SmartMoving Support about a QuickBooks sync error?

    • Contact SmartMoving Support when a QuickBooks sync error is not listed in this article, or when a fix does not clear it. Include the opportunity or invoice number, the exact error text from View Details, and the steps you already tried.

Did this answer your question?