Overview

The error "The name supplied already exists. Another customer, vendor, or employee is already using this name" is a limitation returned directly from QuickBooks. It occurs when the Display Name you are trying to create already exists in QuickBooks Online.

Why This Happens

QuickBooks enforces global uniqueness on the Display Name field across Customers, Vendors, and Employees. Even though you are inserting records into different tables (e.g., Customer and Vendor), QuickBooks checks a single master list of names across all entity types.

This error typically occurs in the following situations:

• When importing data into QuickBooks or enabling payroll after employees have already been added in QuickBooks Online.
• When the customer, vendor, or employee name you are trying to create already exists in QuickBooks Online under a different entity type.

For more context, see the QuickBooks help article on this error.

Resolution

There are two workarounds available:

1. Map a different source column to the QuickBooks Display Name field so the values do not conflict with existing names.
2. Use an Expression Mapping for the Display Name that appends a label in parentheses, for example: NAME + ' (Vendor)', where NAME is the source column mapped to the QuickBooks Display Name.