Quickbooks Online Error Codes

The most commonly occurring Quickbooks Online syncing errors and how to troubleshoot them

Table of Contents

  1. 620: TxnID Cannot Be Linked
  2. 2050: String length specified does not match the supported length
  3. 2210: Email Address does not conform to the syntax rules of RFC 822
  4. 5010: Stale Object Error 
  5. 6000: Business Validation Error
  6. 6140: Duplicate Document Number Error
  7. 6190: Subscription period has ended or canceled or there was a billing problem 
  8. 6210: Account Period Closed, Cannot Update Through Services API
  9. 6250: Invalid Customer
  10. 6560: CustomerRef is missing in the request

 

620: TxnID Cannot Be Linked

What is it: TxnID Cannot Be Linked : Cannot validate linked transactions: Something you're trying to use has been made inactive. Check the fields with accounts, customers, items, vendors or employees.
What causes it:
  • Two entities or transactions can be linked only if they belong to the same customer or vendor. If you see this error, it means that the transactions you are trying to link, Invoice & Payment for example, are referring to different customers.
How to fix it:
  1. Check the Quickbooks mapping of the customer.

 

2050: String length specified does not match the supported length

What is it: String length specified does not match the supported length. Min:0 Max:1,000 supported. Supplied length:1,001
What causes it:
  • A text field on the invoice has exceeded the character limit. This usually happens if the invoice note is too long.
How to fix it:
  1. Edit the invoice and amend any text field that seems too long. 
  2. Save and sync again.

 

2210: Email Address does not conform to the syntax rules of RFC 822

What is it: Email Address does not conform to the syntax rules of RFC 822. 
What causes it:
  • The customer's email address or billing email address is not formatted correctly. 
How to fix it: 
  1. Go to the customer's profile and fix the email address. There could be an extra comma, missing .com, etc. 
  2. Try syncing again.

 

5010: Stale Object Error 

What is it: Stale Object Error : You and ____were working on this at the same time. ___ finished before you did, so your work was not saved.
What causes it:
  • You and someone else were working on the same document, either within CurbWaste and/or Quickbooks.
How to fix it:
  1. Refresh the page and try syncing again.



6000: Business Validation Error

What is it:

Business Validation Error:
- An unexpected error occurred while accessing or saving your data. Please wait a few minutes and try again.  If the problem persists, contact customer support.
- Another user is currently accessing this company. Please try again.
- Enter a transaction amount that is 0 or greater.
- You cannot enter more than 100 characters in the billing_email field.

What causes it:
  • Please see the error message for more details about how to troubleshoot this error.
How to fix it: 
  1. Depends on the error message.

 

6140: Duplicate Document Number Error

What is it: Duplicate Document Number Error : You must specify a different number. This number has already been used.
What causes it:
  • You created a manual invoice in Quickbooks so the invoice number is repeated.
  • Incorrect sync status on our end. 
How to fix it: 
  1. Check your Quickbooks to see if an existing invoice has the same invoice number. 
  2. If the invoice number already exists for a completely different invoice, change that invoice's invoice # in Quickbooks then try syncing again.
  3. If the invoice you already trying to sync is already in Quickbooks, this is a sync status error on our end. Please reach out to support to fix the sync status.
 

6190: Subscription period has ended or canceled or there was a billing problem 

What is it: Subscription period has ended or canceled or there was a billing problem: You can't add data to QuickBooks Online Plus because your trial or subscription period ended, you canceled your subscription, or there was a billing problem. To update your subscription, click the gear icon and view your account information.
What causes it:
  • Your QuickBooks Online trial or subscription period ended
How to fix it: 
  1. Click the gear icon and view your account information
  2. Update your subscription

 

6210: Account Period Closed, Cannot Update Through Services API

What is it: Account Period Closed, Cannot Update Through Services API: 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.
What causes it:
  • Your account period has been closed, so this invoice/payment cannot be synced (or re-synced). 
How to fix it: 
  1. Reopen the account period in Quickbooks and try syncing again or
  2. Make the edits directly in Quickbooks.

 

6250: Invalid Customer

What is it:

Invalid Customer: The customer you have specified has been deleted. You cannot create or edit a transaction with a deleted customer.

What causes it:
  • The customer account may have been deactivated or deleted in QuickBooks.
How to fix it: 
  1. Reactivate the customer
  2. Restore the customer
  3. Create a new customer in QuickBooks and map it to your CurbWaste customer 

6560: CustomerRef is missing in the request

What is it: CustomerRef is missing in the request
What causes it:
  • The customer is not mapped to Quickbooks.
    • When you create a new customer, CurbWaste has built-in automation that will create the Quickbooks mapping for you, which has failed for some reason. 
    • The customer was never mapped correctly when your account was onboarded.
How to fix it: 
  1. If it's a recently created customer, go into the customer profile, click the edit button, then click update without making any changes. Go to Settings>Integrations and check if the customer mapping has been created.
  2. If #1 doesn't work, go to Settings>Integrations and select a Quickbooks customer to map to your CurbWaste customer. You may have to create the customer first in Quickbooks.
  3. After the mapping has been fixed, try syncing again.

 

 

Updated: 1/29/25