Docs
You are viewing:
Product Catalog 1.0
If you want to start using Chargebee with Xero, or have been using Xero and have existing invoices, it's a good idea to migrate the customers to Chargebee and map them to avoid creating duplicates during sync.
This document will walk you through the process of migrating and mapping the customer records.
For information on how to migrate your customers to Chargebee, check our migration documentation.
If you have manually imported invoices into Xero from Chargebee, the customers present in Chargebee would have been created in Xero. Once you start the sync, there is a possibility of creating duplicates in Xero. To avoid duplicates, you can map the customers between Xero and Chargebee. Here's how:
The customer mapping process can be initiated after connecting your Xero organization to Chargebee. Chargebee will ask you to map customer records if it finds pre-existing invoices in Xero.
Download the file containing customer information from Chargebee and Xero. Chargebee will automatically match the customers and show the equivalent if the customers have the following:
Note:
Xero does not accept UTF-8 characters for customer email field.
You can review the details of the customers in the mapping file and view customers that match or don't match. If the customers don't match, you can update the mapping in the file.
Reviewing the file gives you the opportunity to:
Once reviewed, you can upload the updated customer mapping file. The customers in Xero and Chargebee, as matched in the file, will be mapped in Chargebee. When sync runs, customers already present in Xero will not be created.
Note:
If you have set up the integration and later want to map the customers between Chargebee and Xero, contact support.
If you want to skip the mapping step, you can choose to Ignore and proceed. Later during the sync, if Chargebee finds duplicates, the customers will be created with a suffix, such as 'XYZ Company_2'. Chargebee will check for duplicates based on customer display name in Xero.
1. Are UTF-8 characters supported in customer email field?
No, Xero does not support UTF-8 encoding for the customer email field.
Was this article helpful?