Xero Integration

Choosing the Right Contact Matching Method for Your Business

Choosing the Right Contact Matching Method for Your Business

In this article

When EasyBiz syncs invoices to Xero, it needs to know which Xero contact to assign each invoice to. You can choose from four matching methods depending on how your business manages customers. This guide explains each method so you can choose the one that best fits your workflow.


What is Contact Matching?

Contact matching is how EasyBiz decides which contact in Xero should receive the synced invoice. For example, if a customer named "John" places an order in EasyBiz, the system needs to find or create a matching contact in Xero to attach the invoice to. The method you choose determines how the system identifies that contact — by store name, phone number, customer ID, or a manually selected contact.


Method 1: Auto Match Using POS Location Name

This method syncs all invoices under a single Xero contact using your POS location name. If the contact does not exist in Xero, it will be created automatically.

This is best for businesses that want to group all sales from one location under one contact. For example, if your POS location is called "CLEM-HQ," all invoices from that location will appear under a single Xero contact named "CLEM-HQ" — regardless of which individual customer placed the order.

When to use this: You run one or more store locations and want a simple, location-based view of your revenue in Xero. You do not need to track individual customers in your accounting.


Method 2: Match by Customer Name with Phone Number

This method creates a separate Xero contact for each customer using a "Name (Phone)" format. For example, a customer named Ricky with phone number +65 9645 2556 will appear in Xero as "Ricky (+65 9645 2556)". If the contact does not exist in Xero, it will be created automatically.

This means two customers with the same name but different phone numbers will become separate contacts in Xero, giving you a more detailed, customer-level view of your invoices.

When to use this: Your customers are registered in EasyBiz with their phone numbers and you want to track invoices per individual customer. This is especially useful if your customers share common names and you need a reliable way to tell them apart.

Note: This method only works if your customers have phone numbers recorded in EasyBiz. Customers without phone numbers may not match correctly.

Method 3: Match by Customer Name with ID

This method creates a separate Xero contact for each customer using a "Name (ID)" format. For example, a customer named Ricky with ID 10001 will appear in Xero as "Ricky (10001)". If the contact does not exist in Xero, it will be created automatically.

When to use this: Your business uses a customer index system where each customer is assigned a unique ID number. This is common in B2C businesses such as laundry shops or repair services where customers are registered with a membership or account number.

Note: This method only works if your customers have IDs assigned in EasyBiz. Customers without IDs may not match correctly.

Method 4: Manual Select Xero Contact

This method lets you choose one specific Xero contact, and all invoices from that sales channel will be synced under that single contact. There is no automatic matching — you decide exactly where the invoices go.

This is the simplest option and best for consolidating all POS sales under a single customer in Xero. For example, you can create a contact in Xero called "POS Sales" and map all your transactions to it. Every invoice will appear under that one contact regardless of who the actual customer was.

When to use this: You want to consolidate all sales under one contact in Xero for simple bookkeeping. You do not need customer-level tracking in your accounting system.


Which Method Should I Choose?

Tip: Not sure which one to pick? If you just need clean accounting without tracking individual customers, go with POS Location Name or Manual Select. If you want to see each customer's invoice history in Xero, choose Customer Name with Phone Number or Customer Name with ID depending on which identifier your business already uses.

Give feedback

Auto Sync

Up next

Auto Sync

🔄 Set it and forget it. Enable auto-sync to have your sales data flow into Xero instantly without lifting a finger.

Read more