Xero sync error - Price List Item Code must not be more than 30 characters long.

Problem Statement

Sync fails with "[Xero] Price List Item Code must not be more than 30 characters long" because the plan ID (or item code) sent to Xero exceeds 30 characters.

Solution

Xero limits the Price List Item Code to 30 characters. When the plan ID is longer than that, set a SKU (or Alternative Name) of 30 characters or less on the plan. Chargebee will use the SKU instead of the plan ID for Xero, and the plan plus its invoices and credit notes can sync.

Steps to Set It Up

1. Go to Product Catalog > Plans and edit the plan that is failing.
2. In Accounting Information, fill SKU/Alternative Name with a value that is 30 characters or less.
3. Update the plan. Run sync again; the plan and related invoices/credit notes should sync.