--- title: How Customers Map to QuickBooks description: Learn how MetaFleet companies match, link and sync with QuickBooks customers, and which choice to use when a match is missing or wrong. --- [Skip to content](https://support.metafleet.ai/quickbooks-customers-reference#main-content) English Show submenu for translations ![AI-powered fleet repair software](https://support.metafleet.ai/hs-fs/hubfs/Transparent%20logo%20for%20dark%20background.png?width=350&height=54&name=Transparent%20logo%20for%20dark%20background.png) Open main navigation Close main navigation - English Show submenu for translations - [Contact us](mailto:support@metafleet.ai) [Contact us](mailto:support@metafleet.ai) How can we help you? - There are no suggestions because the search field is empty. 1. [MetaFleet Answer Hub](https://support.metafleet.ai/?hsLang=en) 2. [Integrations](https://support.metafleet.ai/integrations?hsLang=en) 3. [QuickBooks](https://support.metafleet.ai/integrations?hsLang=en#quickbooks) # How Customers Map to QuickBooks ## See what MetaFleet sends to a QuickBooks customer, how a company is matched, and what each choice on the QuickBooks card does. **For:** Owners, managers and bookkeepers · **Permission:** Manage account settings to change a link (anyone who can open a company can see its card) · **Type:** Reference In MetaFleet, a customer is a company. In QuickBooks Online, it is a customer. MetaFleet links each company to one QuickBooks customer, and every invoice and payment for that company goes to the linked customer. This page explains what is sent, how MetaFleet finds the right customer, and what each choice on the company's **QuickBooks** card does. ### What maps to what | In MetaFleet | In QuickBooks | Direction | When it syncs | Where you set it | | --- | --- | --- | --- | --- | | Company name | Customer name | Both ways | When the customer is created. After that, a rename on either side is picked up by the nightly sync. | Company Details › Companies, then the company | | Owner's email | Customer email | MetaFleet to QuickBooks | When the customer is created. Also used to find a match. | The company's owner | | Billing address | Billing address | MetaFleet to QuickBooks | When you click **Create in QuickBooks** | The company's **Details** tab | | Full tax exemption and its reason | Customer marked not taxable, with a reason | MetaFleet to QuickBooks | When the customer is created, when you change the exemption, and nightly when a certificate runs out | The company's **Taxes** tab | | Service location | Shipping address on each invoice (not on the customer) | MetaFleet to QuickBooks | With each invoice | The order | Tax exemptions have their own rules. See [How Sales Tax and Exemptions Work with QuickBooks](https://support.metafleet.ai/quickbooks-sales-tax-reference?hsLang=en). ### How MetaFleet finds the QuickBooks customer MetaFleet looks for a customer when the first invoice for a company is sent, and again in the nightly sync. If Customers are turned off for the connection, or you have not finished choosing which customers sync, nothing is linked or created and the invoice waits. Otherwise it tries these steps in order and stops at the first one that works: 1. **An existing link.** If the company is already linked on this QuickBooks connection, MetaFleet uses that customer. 2. **The same name.** A QuickBooks customer with exactly the company's name (capital letters don't matter) is linked automatically. 3. **The same email.** A QuickBooks customer with the owner's email is linked automatically. 4. **A close name.** A name that is at least 82% similar is not linked. It goes to **Possible duplicates** so a person decides. 5. **No match.** MetaFleet creates a new customer with the company's name, the owner's email and its tax exemption. The billing address is sent only when you click **Create in QuickBooks** yourself. A QuickBooks customer that is already linked to another company is never offered as a match. Neither is one you marked **Not a match**. > **Invoices wait for the link.** While a company's customer is waiting in **Possible duplicates**, its invoice is skipped and shows under **Needs attention** with **Map customer…**. Once you link the customer, open the order's **Invoice** tab and click **Resend**. The invoice then goes through. ### Your choices on a company Open the company (**Company Details › Companies**, then the company). The **QuickBooks** card shows a status of **Linked**, **Not linked** or **Not syncing**. A linked card lists the QuickBooks customer, the QuickBooks company, the date it was linked, and how many invoices and payments are in QuickBooks. ![QuickBooks card on a company page showing Not linked, the closest customer, and the Link, Create and Stop syncing buttons](https://support.metafleet.ai/hs-fs/hubfs/knowledge-base/oct-2026/quickbooks-customers-reference-01-company-card.png?width=458&height=276&name=quickbooks-customers-reference-01-company-card.png) This card is from before the first invoice. MetaFleet links an exact name automatically at the first invoice or in the nightly sync, so a close customer can show here until then. A card that is **Not linked** says its invoices skip QuickBooks until it is linked, and how many are waiting under **Needs attention**. ### Link to a QuickBooks customer Use this when the customer already exists in QuickBooks. Click **Link to a QuickBooks customer**, search with **Search QuickBooks customers**, pick the customer and click **Link to this customer**. Each result shows its name match, for example "100% name match". The card also shows the closest customer it found. ![Link to a QuickBooks customer dialog with a search box, a customer with its name match, and a Create option](https://support.metafleet.ai/hs-fs/hubfs/knowledge-base/oct-2026/quickbooks-customers-reference-02-link-dialog.png?width=698&height=338&name=quickbooks-customers-reference-02-link-dialog.png) The dialog also offers a choice to create a new customer from the company. Linking takes QuickBooks' name on your main QuickBooks company. If the names differ (not just in capital letters or spaces around the name), the dialog warns you that the company will take the QuickBooks name before you confirm. If QuickBooks' name is longer than MetaFleet's 100-character limit, the company keeps its name, nothing is renamed in QuickBooks, and the nightly sync lists the company as skipped until the name is shortened in QuickBooks. ### Create in QuickBooks Use this when the customer is not in QuickBooks yet. **Create in QuickBooks** makes a new customer with the company's name, the owner's email, its billing address and its tax exemption, then links it. If QuickBooks already has a customer with that name that MetaFleet missed, MetaFleet links it instead of creating a second one. A customer that is already linked to another company is never taken. In that case nothing is created, and MetaFleet tells you the name is already linked to another company and asks you to rename this company. You can also link it to a different customer instead. ### Change the match On a linked company, click **Change the match** to pick another QuickBooks customer, or create a new one. The dialog is titled **Change the QuickBooks customer**. Once you pick another customer, it shows a note called **What stays where.** Invoices already in QuickBooks stay on the old customer, and payments on them still go there. New invoices and payments go to the new customer. ### Possible duplicates and Not a match Open **Settings › Integrations**, the **QuickBooks** tab, then the **Review** tab. Close name matches are listed under **Possible duplicates**. Click **Review match…** on the row. The dialog is titled Map "\" to QuickBooks and asks "Is this the same customer?" Then choose one: - **Confirm** links the two customers. No duplicate is created. It also gives the company the QuickBooks customer's name. When the names differ, the warning shows next to that customer before you click. - **Not a match** tells MetaFleet these two are different. MetaFleet remembers it and never suggests that pair again. If nothing similar exists, the dialog says "No similar QuickBooks customers found. Create one in QuickBooks, then re-sync." You can also use **Create in QuickBooks** on the company. ### Remove the match Click **Remove the match** to unlink a company. The **Remove the QuickBooks match?** dialog explains what stays in QuickBooks. Nothing already there is deleted. After the match is removed, the card shows **Not linked** and new invoices skip QuickBooks until the company is linked again. MetaFleet does not look for a new match on its own. Link the company again yourself. ### Stop syncing this company Click **Stop syncing this company** for a company you do not want in your books. Its invoices and payments stay out of QuickBooks, and nothing waits for it. The company's card shows **Not syncing**. The card records who stopped it and when. To turn it back on, click **Start syncing again**. ### Renaming a company later The nightly sync compares the company's name on both sides with the name they shared at the last sync. - Renamed only in MetaFleet: QuickBooks gets the new name. - Renamed only in QuickBooks: MetaFleet gets the new name. - Renamed in both: the QuickBooks name wins. Names that differ only in capital letters or spaces around the name count as the same name. Neither side is renamed for them. ### Brands with their own QuickBooks company Links belong to one QuickBooks company. If a brand is connected to its own QuickBooks company, a customer link there is separate from the link to your main company. The same MetaFleet company can be linked to different customers in each. A link made through a brand's own QuickBooks company does not rename the company. The rename on linking applies to your main QuickBooks company only. See [Disconnect, Reconnect and Use Brands with QuickBooks](https://support.metafleet.ai/disconnect-reconnect-and-brands-in-quickbooks?hsLang=en). ### What QuickBooks never gets - Contacts other than the owner's email. MetaFleet sends the company, not its individual contacts. - Service locations as customers. They only appear as the shipping address on an invoice. ### FAQs **Will MetaFleet create a duplicate customer in QuickBooks?** Not when the name or email matches exactly, or when a close name is waiting in **Possible duplicates**. A new customer is created only when nothing similar is found. **Does removing a match delete anything in QuickBooks?** No. Invoices and payments already in QuickBooks stay where they are. **Can I turn off one company without turning off QuickBooks?** Yes. Use **Stop syncing this company** on that company's card. **Why did my company's name change after I linked it?** Linking to your main QuickBooks company takes the QuickBooks customer's name. The dialog warns you before you confirm. **I can see the QuickBooks card but the buttons are missing.** Changing a link needs the Manage account settings permission. Ask an owner or manager. **Where do I fix an invoice that is waiting for its customer?** See [Fix What Needs Attention in QuickBooks](https://support.metafleet.ai/fix-quickbooks-sync-problems?hsLang=en). ### Related articles - [Link a Customer to QuickBooks](https://support.metafleet.ai/link-a-customer-to-quickbooks?hsLang=en) - [How MetaFleet and QuickBooks Work Together](https://support.metafleet.ai/quickbooks-sync?hsLang=en) - [How Invoices Map to QuickBooks](https://support.metafleet.ai/quickbooks-invoice-reference?hsLang=en) - [Fix What Needs Attention in QuickBooks](https://support.metafleet.ai/fix-quickbooks-sync-problems?hsLang=en) - [Start Here](https://support.metafleet.ai/start-here?hsLang=en) - [Companies & Contacts](https://support.metafleet.ai/companies-contacts?hsLang=en#main-content) - [Create/Edit Companies](https://support.metafleet.ai/companies-contacts?hsLang=en#create-edit-companies) - [Contacts](https://support.metafleet.ai/companies-contacts?hsLang=en#contacts) - [Vehicles](https://support.metafleet.ai/companies-contacts?hsLang=en#vehicles) - [Work Intake (Requests & Service Orders)](https://support.metafleet.ai/work-intake-requests-service-orders?hsLang=en#main-content) - [Creating Service Orders](https://support.metafleet.ai/work-intake-requests-service-orders?hsLang=en#creating-service-orders) - [Customer & Partner Requests](https://support.metafleet.ai/work-intake-requests-service-orders?hsLang=en#customer-partner-requests) - [Reference](https://support.metafleet.ai/work-intake-requests-service-orders?hsLang=en#reference) - [Customer Portal](https://support.metafleet.ai/work-intake-requests-service-orders?hsLang=en#customer-portal) - [Estimates & Approvals](https://support.metafleet.ai/estimates-approvals?hsLang=en#main-content) - [Approval Gates](https://support.metafleet.ai/estimates-approvals?hsLang=en#approval-gates) - [Estimates](https://support.metafleet.ai/estimates-approvals?hsLang=en#estimates) - [Invoices](https://support.metafleet.ai/estimates-approvals?hsLang=en#invoices) - [Billing](https://support.metafleet.ai/estimates-approvals?hsLang=en#billing) - [Parts, Inventory & Vendors](https://support.metafleet.ai/parts-inventory-vendors?hsLang=en#main-content) - [Add Parts & Kits](https://support.metafleet.ai/parts-inventory-vendors?hsLang=en#add-parts-kits) - [Stock & Counts](https://support.metafleet.ai/parts-inventory-vendors?hsLang=en#stock-counts) - [Locations & Bins](https://support.metafleet.ai/parts-inventory-vendors?hsLang=en#locations-bins) - [Purchase Orders](https://support.metafleet.ai/parts-inventory-vendors?hsLang=en#purchase-orders) - [Parts Catalog](https://support.metafleet.ai/parts-inventory-vendors?hsLang=en#parts-catalog) - [Vendors & Manufacturers](https://support.metafleet.ai/parts-inventory-vendors?hsLang=en#vendors-manufacturers) - [Pricing](https://support.metafleet.ai/parts-inventory-vendors?hsLang=en#pricing) - [Service Vehicles](https://support.metafleet.ai/parts-inventory-vendors?hsLang=en#service-vehicles) - [Sourcing & Hand-Off](https://support.metafleet.ai/parts-inventory-vendors?hsLang=en#sourcing-hand-off) - [Part Numbers](https://support.metafleet.ai/parts-inventory-vendors?hsLang=en#part-numbers) - [Notifications](https://support.metafleet.ai/parts-inventory-vendors?hsLang=en#notifications) - [Reports](https://support.metafleet.ai/parts-inventory-vendors?hsLang=en#reports) - [Invoicing & Payments](https://support.metafleet.ai/invoicing-payments?hsLang=en) - [Dispatch & Scheduling](https://support.metafleet.ai/dispatch-scheduling?hsLang=en#main-content) - [Preventative Maintenance](https://support.metafleet.ai/dispatch-scheduling?hsLang=en#preventative-maintenance) - [Technician Assignment](https://support.metafleet.ai/dispatch-scheduling?hsLang=en#technician-assignment) - [Scheduling & Calendar](https://support.metafleet.ai/dispatch-scheduling?hsLang=en#scheduling-calendar) - [Technician Schedule](https://support.metafleet.ai/dispatch-scheduling?hsLang=en#technician-schedule) - [Technicians & Mobile App](https://support.metafleet.ai/technicians-mobile-app?hsLang=en#main-content) - [Time Tracking](https://support.metafleet.ai/technicians-mobile-app?hsLang=en#time-tracking) - [Tech Workflow](https://support.metafleet.ai/technicians-mobile-app?hsLang=en#tech-workflow) - [Evidence & Photos](https://support.metafleet.ai/technicians-mobile-app?hsLang=en#evidence-photos) - [AI Assistant](https://support.metafleet.ai/technicians-mobile-app?hsLang=en#ai-assistant) - [Alerts, Alarms & Notifications](https://support.metafleet.ai/alerts-alarms-notifications?hsLang=en#main-content) - [Email/SMS/App Settings](https://support.metafleet.ai/alerts-alarms-notifications?hsLang=en#email-sms-app-settings) - [Reporting & Dashboards](https://support.metafleet.ai/reporting-dashboards?hsLang=en) - [Admin & Settings](https://support.metafleet.ai/admin-settings?hsLang=en#main-content) - [Rates & Fees](https://support.metafleet.ai/admin-settings?hsLang=en#rates-fees) - [Branding](https://support.metafleet.ai/admin-settings?hsLang=en#branding) - [Roles, Permissions & Users](https://support.metafleet.ai/admin-settings?hsLang=en#roles-permissions-users) - [Service Areas](https://support.metafleet.ai/admin-settings?hsLang=en#service-areas) - [Workflows](https://support.metafleet.ai/admin-settings?hsLang=en#workflows) - [Taxes](https://support.metafleet.ai/admin-settings?hsLang=en#taxes) - [Integrations](https://support.metafleet.ai/admin-settings?hsLang=en#integrations) - [Integrations](https://support.metafleet.ai/integrations?hsLang=en#main-content) - [Phone Setup](https://support.metafleet.ai/integrations?hsLang=en#phone-setup) - [AI Assistant Access](https://support.metafleet.ai/integrations?hsLang=en#ai-assistant-access) - [QuickBooks](https://support.metafleet.ai/integrations?hsLang=en#quickbooks) - [Getting Around](https://support.metafleet.ai/getting-around?hsLang=en#main-content) - [Search & Command Bar](https://support.metafleet.ai/getting-around?hsLang=en#search-command-bar) [![AI-powered fleet repair software](https://support.metafleet.ai/hs-fs/hubfs/Transparent%20logo%20for%20dark%20background.png?width=350&height=54&name=Transparent%20logo%20for%20dark%20background.png "AI-powered fleet repair software")](http://www.metafleet.ai) [mailto:support@metafleet.ai](mailto:support@metafleet.ai) Copyright © 2025, MetaFleet, Inc