QuickBooks Online Sync Error: 6240 – Duplicate Name Exists
If you encounter the error “6240 - Duplicate Name Exists” in your QuickBooks Online (QBO) sync log, it typically means YoPrint is unable to sync a customer or vendor due to a naming conflict.
Why does this error occur?
QuickBooks Online does not allow two entities (customers, vendors, employees, etc.) to share the same name, even across categories.
Here’s what the 6240 error might look like in your sync logs. The message indicates a duplicate name conflict in QuickBooks Online.
This error can happen due to:
- A customer and vendor sharing the same name
- The name contains an ampersand symbol (&), which QuickBooks treats differently from the word “and”
Important: This is a known QuickBooks limitation and cannot be bypassed via API.
How to resolve the error
Note: If the customer already exists in QuickBooks Online, skip Step 1.
1. Manually create the customer in QuickBooks.
If the customer does not yet exist in QuickBooks, log in to your QuickBooks account and manually create the customer record with a unique name that doesn't conflict with any vendor or other entity.
2. Manually map the customer in YoPrint
In your Sales Order, click on the customer name.
3. In the customer dialog, click Map Manually in the "QuickBooks Mapping."
4. In the override screen, search for and select the corresponding QuickBooks customer name from the list.
Once mapped, the sync should go through without any issues.
If you continue to see sync errors or need help with specific mappings, please contact our support team at support@yoprint.com.