Configuration errors and their resolution for Xero

Problem Statement

What do I do when I see configuration errors in Chargebee while syncing to Xero, such as "Account not found for supplied sales account code," "The tracking category XXX - Sales entered for this credit note plan/addon is invalid," or "Tax rate applied to this invoice does not match the tax rate selected as part of settings"?

Solution

Account not found for supplied sales account code

This error appears when a plan has an accounting code that does not exist in Xero. Only valid accounts from the Chart of Accounts in Xero should be used.

Fix: Go to the plan in Chargebee, edit its price point, add a valid account code (e.g., 200) from Xero's Chart of Accounts, and save. The sync will then succeed.

The tracking category XXX - Sales entered for this credit note plan/addon is invalid

The tracking category value format in the custom field is incorrect. The format must match: Custom Field Name - Tracking Category Name: Value.

Example: If the tracking category in Xero is State with value NSW, and the custom field name is CF 1, enter: CF1 - State: NSW.

Fix: Go to the customer record, click Edit Customer, and enter the correct value in the Tracking Category custom field.

Tax rate <X%> applied to this invoice does not match the tax rate <Y%> selected as part of Settings

Chargebee selects tax rates based on jurisdiction (line item taxes, shipping address, or billing address). If the jurisdiction on the invoice does not match the default sales tax mapping, this error occurs.

Tax precedence:

1. Line Item Taxes (country/state code)
2. Shipping Address (if line item taxes lack jurisdiction)
3. Billing Address (if shipping address is missing)

Example: If the invoice jurisdiction is Canada (CA) but the default sales tax is mapped to a different country, change the default sales tax to Canada in Chargebee settings and try again.