Troubleshooting QuickBooks Online errors
Occasionally, invoices will fail to copy due to a requirement from QuickBooks Online. If an invoice can't be copied, you'll receive an email with the specific error message. Below are some of the most common error messages and how to resolve them so that your invoice can be copied.
Duplicate document number error (Error 6140)
You might see one of the following messages in the copy failure notification:
Duplicate Document Number Error: Duplicate Document Number Error : You must specify a different number. This number has already been used.
OR
This invoice ID has already been used for a document (such as an invoice or credit memo) in QuickBooks Online. Document numbers in QuickBooks Online must be unique.
To fix the error, update the invoice ID in Harvest then use the Actions drop down on the invoice in Harvest to copy it to QuickBooks Online.
This error message means there's an existing invoice or credit memo on the QuickBooks side with the same number. You'd need to change the invoice ID in Harvest to something different, or remove the existing invoice/credit memo in QuickBooks, before you can copy it over. After you've made changes, head to the invoice in question in your Harvest account, then click Actions > Copy to QuickBooks.
Account period closed (Error 6200)
You might see one of the following messages in the copy failure notification:
Account Period Closed Cannot Update Through Services API: The account period has closed and the account books cannot be updated through the QBO Services API. Please use the QBO website to make these changes.
OR
The account period has been closed in QuickBooks Online.
Because this closure locks the account books, Harvest can't make any changes including copying over an invoice or payment. You'll need to reopen the period in QuickBooks Online and then use the Actions drop down on the invoice in Harvest to manually copy it to QuickBooks Online.
This error message means that this invoice failed to copy to QuickBooks Online because the account period has been closed on the QuickBooks side, which means your account books can't be updated by copying over this invoice.
Once a period is locked in QuickBooks, it requires an Admin (in QuickBooks) to unlock the time period to make further changes (or override on a case-by-case basis).
Because this closure locks the account books, Harvest can't make any changes. You'll need to reopen the books in order for us to copy the invoice over. You can find instructions on how to do that here.
Business validation error
You might see the following message in the copy failure notification:
A business validation error has occurred while processing your request: Business Validation Error: Please select the number of days from the Statement Date.
This error has to do with the Terms set in QuickBooks Online. You can find the terms clicking the gear icon, then selecting All lists > Terms. When editing your terms, it'll look something like this:
To fix the issue, please select the first choice of Due in fixed number of days and have that set to 0 days.
Then, return to Harvest and try to manually copy the invoice over again. Here's how to do that:
- Go to Invoices > Overview, and select the invoice you want to copy to QuickBooks Online.
- In the Actions menu, click Copy to QuickBooks.
If you receive an error message that's not listed above, or need further assistance, please contact our support team.