Skip to main content
Customers who use the QuickBooks integration to send invoice and quote data from Zuper to QuickBooks sometimes encounter errors. The Sync history feature allows you to troubleshoot these issues. To help troubleshoot Zuper-QuickBooks Online sync issues, Zuper provides a sync history log that tracks data transfers between the two systems. This allows you to determine the root cause of errors, resolve them, and resync for smooth integration.

​
Sync History

  1. Select the “Settings” module from the left navigation menu. Under the “Other Settings,” select the “Sync Activity.”
  1. The “Sync History” list page appears.
2.1. Sync UID - The unique ID identifying the sync between Zuper and QuickBooks. 2.2. Module Name - The name of the module where the sync happened. 2.3. Record ID/Name - The exact module record ID or Name with the hyperlink. 2.4. Application Name - The name of the integrated application. 2.5. Type of Sync - The sync type of the integration which can be the actions such as Create, Update, and Delete. 2.6. Status - The sync current status is shown - Started, Success, or Error status is displayed. QBO11 Pn
  1. Click a record id/name to view details.
You can view the current sync status of the QuickBooks integration along with the destination record ID. QBO12 Pn
  1. Click the clock icon to view the Sync History.
QBO13 Pn
  1. A dialog box will appear to display the list of recent syncs for the record.
QBO14 Pn
Daily sync limits: To keep the QuickBooks Online integration stable, Zuper limits the number of syncs that can happen each day.
  • The company-level limit counts all syncs across your account.
  • The record-level limit counts syncs for each individual record, in every module that syncs with QuickBooks Online. Both limits reset daily.
Once a limit is reached, changes made later that day do not sync, and an error appears in Sync History and stays there. If your company reaches its limit, syncing stops for all records. If a single record reaches its limit, only that record stops syncing. If these limits affect your syncing, contact Support.

​
How to Retry Sync?

  1. Whenever an error occurs during the sync, an alert will appear on the Invoice / Quote’s details page.
Take corrective actions and click the “Retry Sync” to reysnc the record. QBO15 Pn
  1. The sync will happen and it will be completed in few seconds.
QBO16 Pn
  1. The sync is successfully done.
QBO17 Pn
  1. If you wish to acknowledge and dismiss the error, click the “Acknowledge” button.
QB018 Pn

​
How To Resolve Errors?

  1. When the error alert appears, click the “Learn How to Fix” button. You will be redirected to the relevant section of this article, which contains information on resolving errors.
We created this feature to provide visibility into sync errors for our customer to identify issues, allowing for corrective actions and manual resync when necessary. QBO18 Pn