Docschargebeedocs

HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates

  • Release Notes

Getting Started

  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • Chargebee Tech Glossary
  • Articles and FAQ

Implementing Chargebee

  • Implementation Guide
  • Go-live Checklist
  • Articles and FAQ

AI in Chargebee

  • Chargebee Agents
  • Chargebee Copilot
  • Chargebee MCP Server (Model Context Protocol)

Developer Resources

  • Developer Resources Overview
  • Articles and FAQ

Product Catalog

  • Product Catalog Overview
  • Coupons
  • Articles and FAQ

Subscriptions

  • Working with Subscriptions
  • Billing
  • Orders
  • Articles and FAQ

Customers

  • Managing Customers
  • Account Hierarchy
  • Email Notifications
  • Branding
  • Configure Multiple Languages
  • Articles and FAQ

Entitlements

  • Entitlements Overview
  • Features Overview
  • Feature Management
  • Managing Product Entitlements
  • Subscription Entitlements
  • Customer Entitlements
  • Grandfathering Entitlements
  • Articles and FAQ

Usage Based Billing

  • Understanding Usages
  • Setting up Usage Based Billing
  • Metered Billing
  • Articles and FAQ

Chargebee CPQ

  • Chargebee CPQ
  • Chargebee CPQ for Salesforce
  • Chargebee CPQ for HubSpot

Invoices, Credit Notes, and Quotes

  • Invoices
  • Credit Notes
  • Quotes [Legacy]
  • Transactions
  • Articles and FAQ

Taxes

  • Overview
  • Configuring Taxes
  • Country-specific Taxes
  • Articles and FAQ

Hosted Capabilities

  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Pricing Table
  • Managing Payments with Chargebee.js
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration

  • Users & Roles
  • Custom Fields & Metadata
  • Approvals
  • Mandatory Fields
  • File Attachments & Comments
  • Advanced Filter Options
  • Multicurrency Pricing
  • Multi-decimal Support
  • Configuring Reason Codes
  • Events and Webhooks
  • API Keys
  • Time Zone
  • Time Machine
  • Transfer Configurations
  • Articles and FAQ

Multi Business Entity

  • Multi Business Entity Overview
  • Customer Transfer Overview
  • Articles and FAQ

Mobile Subscriptions

  • Overview
  • Omnichannel Subscriptions
  • Omnichannel One-Time Orders
  • Mobile Subscriptions (Legacy)

Reports and Analytics

  • RevenueStory
  • Home Dashboard
  • Frequently Asked Questions
  • FAQs for Classic Reports Sunset
  • Articles and FAQ

Integrations

  • Sales
  • Customer Support and Success
  • Finance
  • Tax
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Ecommerce Management
  • Articles and FAQ

Data Privacy & Security

  • Two Factor Authentication
  • SAML Single Sign-On
  • System for Cross-Domain Identity Management (SCIM)
  • EU-GDPR
  • Consent Management
  • Personal Data Management
  • Compliance Certificates
  • HIPAA Guidelines
  • PCI Recommendations and Integration Types
  • Articles and FAQ

Data Operations

  • Bulk Operations
  • Migration
  • Articles and FAQ
  1. Billing
  3. Integrations
  5. Articles and FAQ
  6. Xero
  1. Billing
  3. Integrations
  5. Articles and FAQ
  6. Xero

Xero sync errors - A currency rate must be specified

Problem Statement

Invoices or credit notes fail to sync with "A currency rate must be specified." This often appears when the base currency in Chargebee does not match the base currency in your Xero organisation.

Solution

Use one of these approaches:

Option 1: Align base currencies. Change the base currency in Chargebee to match Xero (e.g. to GBP), or change the base currency in Xero to match Chargebee (e.g. to USD). Chargebee base currency changes require support; Xero changes are done in your Xero organisation settings.

Option 2: In Chargebee, under Settings > Apps > Xero > Manage mapping (or Third-party Integrations > Xero > Manage mapping), configure the same currency bank accounts for payments and refunds as in Xero. This ensures the integration uses the correct accounts and currency.

Chargebee mapping:

image

Xero bank accounts:

image

Related Articles

How to install the Google Chrome Extension for Xero/QuickBooks Reconciliation?
Xero sync error - Payments can only be made against Authorised documents & Payment amount exceeds the amount outstanding on this document.
Where can I see the details for bad debt?
Xero sync error - Price List Item Code must not be more than 30 characters long.
'Xero Error : Account code ''0000'' is not a valid code for this document.'
Configuration errors and their resolution for Xero
How to match invoices report to a line item report?
Xero - How to connect two Chargebee sites to one Xero account (Internal)?
Xero - Why is the round off amount so large?
The contact number XXX is already assigned to another contact. The contact number must be unique across all contacts.
The TaxType code 'X' cannot be used with account code 'Y'
How to map existing customers in Chargebee to existing customers in Xero/QuickBooks/NetSuite?
'Xero app show error: The chart of account mapping for the plan/addon is not configured‌'
Xero Sync Error - Invoice number must be unique
What is Default Sales Tax in Xero integrations?
'"[Xero] 1) You have reached the limit of invoices you can approve" while syncing invoices'
How to check the lock date in Xero?
Authentication for this Chargebee to Xero connection has expired. Click 'reconnect' to resume data sync
Plan level tracking categories in Xero
Error - Xero 1) Account must be valid. 2) Tax rate must be valid
Adding additional email addresses to the customer card in Xero
Save option greyed out while trying to change account mapping on Xero.
Base Currency difference for Chargebee and Xero

Show more

Was this article helpful?