Docs
You are viewing:
Product Catalog 2.0
If you want to start using Chargebee with Xero, or have been using Xero and have existing invoices, 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.
Note:
Chargebee provides an account hierarchy feature that is now available with this integration. Click Chargebee Account hierarchy for more details.
If your Chargebee site has the accounting hierarchy feature enabled, then listed below are the expected outcomes:
Invoiced To | Bill Payment By | Expected behavior |
PARENT | PARENT | Sync Invoices, Credit notes, payments and refunds. |
CHILD | CHILD | Sync Invoices, Credit notes, payments and refunds. |
CHILD | PARENT | Sync invoices and adjustable credit notes. Do not sync Payments, refunds, and refundable credit notes. Note: The invoice will always be in a payment due status. |
If you are connecting a brand new Chargebee site or an existing Chargebee site to your Xero organization, which has customers and invoices already created, you can migrate the customers into Chargebee. For information on how to migrate your customers to Chargebee, check our migration documentation.
If you manually imported invoices into Xero from Chargebee, Chargebee customers would have been created in Xero. Once you start the sync, this may create duplicates in Xero. To avoid duplicates, you can map the customers between Xero and Chargebee. Here's how:
You can initiate the customer mapping process after connecting your Xero organization to Chargebee. Chargebee will prompt you to map customer records if it finds pre-existing invoices in Xero.
Download the file containing customer information from Chargebee and Xero. Chargebee automatically matches customers and shows the equivalent if customers have the following:
Note:
Xero does not accept UTF-8 characters for customer email field.
Review the customer details in the mapping file and view customers that match or don't match. If customers don't match, you can update the mapping in the file. Reviewing the file gives you the opportunity to:
Once reviewed, upload the updated customer mapping file. Chargebee will map the customers in Xero and Chargebee as matched in the file. When sync runs, existing customers in Xero will not be created.
Note:
If you set up the integration and later want to map 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, customers will be created with a suffix, such as 'XYZ Company_2'. Chargebee checks for duplicates based on customer display name in Xero.
1. Are UTF-8 characters supported in the customer email field? No, Xero does not support UTF-8 encoding for the customer email field.
Was this article helpful?