Quickbook API同步客户信息遇‘名称已存在’错误，如何排查？

When you hit that frustrating error even after checking active/inactive customers, vendors, and employees, here are the often-overlooked areas to inspect:

• Other Names List
  QBO has an easy-to-miss "Other Names" list for entities that don’t fit into customer, vendor, or employee categories—like independent contractors, consultants, or third-party service providers. Even inactive entries here can block your customer name. To find it: Go to the Lists menu > Other Names List, and make sure to enable "Include Inactive" here too.

• Lead Records (including inactive/deleted)
  Potential leads in QBO are separate entities from customers. Even if a lead was converted to a customer, marked inactive, or deleted, its name might still be flagged as used. Check the Leads tab, toggle on "Include Inactive", and also check the deleted leads section (usually under the "More" dropdown in the Leads list).

• Sub-Customers
  Don’t forget to dig into sub-customer records. A sub-customer (even under a different parent) could be using the exact name you’re trying to sync. Navigate to the Customers list, expand all parent customers, and verify every sub-entry (active and inactive).

• Deleted Records (Recycle Bin)
  QBO retains deleted records in a recycle bin for a period. Even if you’ve checked inactive entries, deleted items might still hold the name lock. To access: Go to Settings > Company Settings > Advanced > Recycle Bin (or look for the "Deleted Items" option in the relevant list’s dropdown).

• Merged Entity History
  If any customers, vendors, or leads were merged in the past, the original entity’s name might still be stored in QBO’s backend even if it’s no longer visible. You can check merge history by going to Settings > Audit Log and searching for "merge" actions to see if the conflicting name was part of a merge.

• Employee Name Variations
  Double-check employee records for name combinations that match your target customer name. For example, an employee with a display name like "John Smith Consulting" could conflict with a customer named "John Smith Consulting"—even if you didn’t notice it at first glance.

内容的提问来源于stack exchange，提问作者Divyesh K