Floorzap offers two different functions for connecting customers with QuickBooks Online — Link and Map. They serve different purposes, and using the wrong one on an existing QBO account will create duplicate errors that require manual cleanup.
Link QuickBooks Customers with Floorzap
This function forces a sync of all existing Floorzap customers to QuickBooks, creating new customer records in QBO for each one.
When to use it: Only on brand new QuickBooks accounts with no existing customer data. It's a fast way to populate QBO with your Floorzap customer list from scratch.
Do not use Link if your QBO account already has customers — from a prior import or previous use. It will attempt to create duplicates and trigger "name already exists" errors for every matching record.
Map Customers
This function manually links a specific Floorzap customer to an existing QuickBooks customer record. Instead of creating a new QBO record, it connects the two existing ones.
When to use it: To resolve "duplicate name" errors — whether caused by accidentally running Link on an existing account, or by customers that were imported into QBO separately before the integration was set up.
To map a customer, go to Settings → Integrations → QuickBooks → Map My Customer, search for the customer causing the error, and match the Floorzap and QBO records.
📎 If you're seeing a "duplicate name" error caused by a vendor, contractor, or salesman — see QBO Error - Duplicate Name.