Configure Xero VAT mapping
For businesses operating in VAT-regulated regions (United Kingdom, Ireland, European Union countries, and others), accurate mapping between Zenoti tax groups and Xero VAT rates is essential for compliant invoices and correct VAT returns. This article covers the Xero Cloud deployment only β desktop / on-premise Xero is not supported.
On this page
- Before you begin
- Network requirements
- External-system prerequisites
- View your Xero VAT rates
- Map Zenoti tax groups to Xero VAT rates
- Common VAT rate codes (UK)
- Failure path (VAT mapping)
- Tips
- Related articles
Before you begin
Permission: You need organization administrator access in Zenoti to configure Xero VAT mapping, and Xero Standard or higher access on the Xero side.
- Your Xero Cloud connection must be authorised. See Connect an accounting provider.
- You need familiarity with the VAT rates configured in your Xero organisation β specifically the exact rate codes (for example,
OUTPUT2,ZERORATEDOUTPUT).
Network requirements
VAT mapping is a Zenoti configuration page that pulls the current tax rate list from Xero on demand. This uses the outbound HTTPS connection already required for the Xero integration β see Connect an accounting provider β Network requirements. No additional network change is required.
External-system prerequisites
- Xero VAT rates must already exist. Zenoti does not create Xero tax rates. Create each required rate under Accounting > Advanced > Tax Rates in Xero before mapping.
- VAT scheme. Confirm the Xero organisation is on the correct VAT scheme (Standard, Flat Rate, Cash Basis). The scheme affects how Xero computes VAT on posted invoices; Zenoti does not override it.
- If your Xero organisation files VAT under MTD, keep the scheme selection current in Xero β Zenoti posts the amounts.
- Reverse charge / domestic reverse charge (UK construction, EU cross-border B2B). If applicable, set these up in Xero first. Zenoti posts the tax rate code you map; Xero applies the reverse-charge logic at return time.
For anything above outside your day-to-day scope, work with your Xero adviser before running a production sync. Never re-use a VAT rate between incompatible scheme types.
View your Xero VAT rates
- Log in to Xero with a user that has Standard or higher access.
- Navigate to Accounting > Advanced > Tax Rates to view every active VAT rate and its code.
- Note each exact rate name and code β you will need them for mapping. Codes are case-sensitive.
Map Zenoti tax groups to Xero VAT rates
In Zenoti, navigate to Configuration > Integrations > Integration settings, expand Accounting, and open Tax Rates Mapping.
Select Add for each Zenoti tax group that is not yet listed.
For each Zenoti tax group, pick the matching Xero VAT rate.
Field Source What to enter Zenoti tax group Zenoti tax configuration (read-only) Name of the tax group β for example, "Standard Rate 20%". Xero VAT rate Xero Accounting > Advanced > Tax Rates The matching Xero tax rate. Drop-down is pulled live from Xero. Reporting classification Xero tax rate setup Read-only, displayed for reference. Tells you whether the rate is treated as Output, Input, Zero Rated, or Exempt in Xero. Click Save.
Common VAT rate codes (UK)
Use this as a starting point only. Your organisation's exact rate names may differ β always confirm against your Xero tax rate list.
| Zenoti tax group (example) | Typical Xero VAT rate | Typical Xero code |
|---|---|---|
| Standard rate (20%) | 20% (VAT on Income) | OUTPUT2 |
| Reduced rate (5%) | 5% (VAT on Income) | REDRATEOUTPUT |
| Zero rated | Zero Rated Income | ZERORATEDOUTPUT |
| Exempt | Exempt Income | EXEMPTOUTPUT |
| Reverse charge | Reverse Charge Expenses / Income | RCIPURCHASE / RCISALES |
Exact Xero VAT code names vary by organisation and over time as HMRC schemes change. Always verify the codes in your Xero account before mapping.
Failure path (VAT mapping)
| Failure mode | User-visible symptom | Resolution |
|---|---|---|
| Tax rate archived in Xero | Sync fails with "Tax rate not found" for invoices containing that group | Re-map the Zenoti tax group to an active Xero rate. If the change is effective from a specific date, reconcile historical postings manually. |
| Wrong reporting classification | VAT return amounts look wrong even though rates look right | Zenoti posts the rate you map; the scheme classification (Input vs Output, Zero Rated vs Exempt) is governed by Xero's own rate setup. Correct the classification in Xero, not in Zenoti. |
| Rounding drift on tax-inclusive items | Line-level VAT differs from Zenoti by a cent | Confirm whether tax is inclusive or exclusive in both systems and align. Rounding mismatches on high volumes accumulate materially. Raise with finance. |
| VAT return filed with missing invoices | VAT return amount doesn't match Zenoti totals for the period | Run Accounting variance report and the Zenoti Collections by Invoices report for the same period; match on invoice number. Investigate any Zenoti invoice not in Xero. |
| Reverse charge posted as standard VAT | Customer is invoiced VAT when the supply should have been reverse charge | Zenoti cannot infer reverse charge from the service context. Create a dedicated Zenoti tax group for reverse-charge cases and map it to the Xero reverse-charge rate. Staff must pick the correct group at checkout. |
| Multi-currency VAT amounts don't match filing currency | VAT return shows converted amounts that differ from original | VAT is computed in the invoice currency by Xero; the return is in base currency. Reconciliation should always be against the same currency view. |
Tips
- If you add new tax groups in Zenoti, update the Xero VAT mapping before enabling sync for those tax groups β an unmapped group will silently block affected invoices from posting.
- If a Xero tax rate is archived or deleted, update the Zenoti mapping immediately. Xero does not notify Zenoti when a rate is archived.
- For non-UK VAT scenarios (Ireland, Germany, France, UAE), follow the same process using the relevant local VAT rate codes from your Xero organisation.
- Run a manual sync for a narrow date range after every mapping change and review the resulting Xero invoices before resuming the full schedule.