- Print
- DarkLight
QuickBooks Online: Sync Errors
- Print
- DarkLight
Sync Errors occur when a record fails to upload to QuickBooks Online after going through the initial approval process. In this article, we will explain where to find these errors and highlight some of the most common integration errors in QuickBooks Online.
Where to Find Sync Errors
Sync errors will appear in the Accounts Payable tab near the top of the page, displaying the active number of errors. Please note that if there are no sync errors, this section will not be visible.
You can also view sync errors under the Archive tab, which includes bill, receipt, and payment sync errors. The Archive tab always displays the number of errors, even if it's zero, allowing you to check historical errors.
Clicking on Sync Errors will display a list of errors. Here, you can view each specific error along with its details, providing context on how to correct the error. For a list of common errors, please see the FAQ section below.
After addressing the error, you can resync the bill by clicking the Blue Chain icon next to the bill you corrected.
You can mark an error as read by selecting the error and clicking the Mark as Read button or by simply clicking into the error. This will remove it from the active sync error list.
To view a comprehensive list of all errors, click the Show All button at the top of the Sync Error section. Old errors will be displayed in grey, while new errors will appear in white
How to Identify which Bills have Errors
Bills that fail to sync with QuickBooks Online are marked by a blue link button next to them, allowing you to pick out the bills that have not yet been synced. Once you have corrected the error, you can click on the blue link, and MakersHub will attempt to resync the bill with QuickBooks Online.
You can search by document number, amount, or any other information that may be contained inside of the error in the search bar above. Some errors will display the ‘DocNumber’, which corresponds to the Invoice Number in MakersHub. If a number isn't listed, you can click on the error to view the full log. This log provides additional details, such as the total amount, which can help you identify the corresponding bill.
List of Common Errors
FAQ
Type: ValidationFault. Code: 6140. Detail: Duplicate Document Number Error : You must specify a different number. This number has already been used. DocNumber=XXXXXX is assigned to TxnType=Bill with TxnId=XXX.
A duplicate Invoice Number already exists within QuickBooks Online.
Solution: Remove the duplicate transaction from Quickbooks or change the Invoice Number within MakersHub.
Type: ValidationFault. Code: 6210. Detail: The account period has closed and the account books cannot be updated through through the QBO Services API. Please use the QBO website to make these changes..
The accounting period has been closed in QuickBooks.
Solution: Re-open the accounting period or adjust the date of the invoice to be within an open period.
Type: ValidationFault. Code: 2500. Detail: Invalid Reference Id : Account assigned to this transaction has been deleted. Before you can modify this transaction, you must restore XXXXXXXX (deleted)..
The account in Quickbooks has been deleted or marked as inactive.
Solution: Reactivate/recreate Account within QuickBooks or change the account on the transaction within MakersHub.
Type: ValidationFault. Code: 2500. Detail: Invalid Reference Id : Vendor assigned to this transaction has been deleted. Before you can modify this transaction, you must restore XXXXXXX(deleted-1)..
Vendor has deleted or made inactive within QuickBooks.
Solution: Reactivate/readd vendor to QuickBooks or update vendor name on transaction to new vendor.
HTTP Error: Timeout was reached (CURLE_OPERATION_TIMEOUTED): Operation timed out after 30001 milliseconds with 0 bytes received
Server has timed out.
Solution: QuickBooks Server may be experiencing technical difficulties please try again after a few minutes.
Type: ValidationFault. Code: 2500. Detail: Invalid Reference Id : Customer assigned to this transaction has been deleted. Before you can modify this transaction, you must restore XXXXXX (deleted)..
Customer/Job has deleted or made inactive within QuickBooks.
Solution: Reactivate/readd Customer/Job to QuickBooks or update Customer/Job name on transaction to new Customer/Job.
Type: ValidationFault. Code: 6000. Detail: Business Validation Error: You can't use an Accounts Payable account on the detail portion of a Bill..
There is an Account Receivable or Account Payable Account selected at line level.
Solution: Update the account at line level to be another type of account that is not AR or AP.