Xero Runs on Clean CSV Bridges
Xero is the default ledger for many UK, Australian, and New Zealand businesses, and it is widely used in Canada and the US as well. Bank lines, invoices, bills, and contacts often move through CSV — either from the bank, from a previous system, or from a spreadsheet the accountant maintains.
Xero’s importers are template-driven. Headers must match. Tax rates must match names in the org. Dates must match the organisation’s locale. This guide walks through the CSV workflows that fail most often across those markets.
Which Xero CSV Are You Building?
Do not reuse one generic sheet for every import type.
| Import type | Typical columns | Watch-outs |
|---|---|---|
| Bank statement / transactions | Date, Amount, Payee, Description, Reference | Signed amount vs debit/credit columns |
| Invoices / bills | Contact, InvoiceNumber, Date, DueDate, Description, Quantity, UnitAmount, AccountCode, TaxType | TaxType must match Xero exactly |
| Contacts | Name, EmailAddress, AccountNumber, Addresses, Phones | Unique Name; postcodes as text |
| Chart of accounts / inventory | Vendor sample required | Never invent AccountType labels |
Step-by-Step: Bank CSV into Xero
Bank reconciliation is where most Xero CSV traffic comes from.
- Export CSV from your bank portal (UK/AU banks often use DD/MM/YYYY).
- If you only have OFX/QIF/PDF, convert to CSV first and reconcile totals.
- Open the file in the Online CSV Editor; delete balance-only rows and ad headers.
- Ensure Date, Amount, and a payee/description column are present.
- In Xero: Accounting → Bank accounts → manage account → Import statement.
- Map columns; check the preview for flipped signs and wrong dates.
- Complete the import and reconcile against the bank ending balance.
Example UK/AU bank CSV
Day-first dates are normal; keep them consistent:
Date,Amount,Payee,Description,Reference
03/05/2026,-42.18,AWS,Cloud hosting,INV-8891
04/05/2026,1500.00,Acme Ltd,Invoice payment,INV-2201Example US-style bank CSV for a US Xero org
Month-first dates if that is what the organisation expects:
Date,Amount,Payee,Description,Reference
05/03/2026,-42.18,AWS,Cloud hosting,INV-8891
05/04/2026,1500.00,Acme LLC,Invoice payment,INV-2201UK, Australian, and US Date Rules
Xero organisations inherit regional defaults. A file that works for a Sydney org can fail or mis-post in a California org.
- Ask which locale the Xero org uses before reshaping dates.
- When collaborating across AU and US offices, standardize on ISO YYYY-MM-DD in the shared CSV if Xero accepts it for that import.
- After Excel opens a CSV, verify a known date (e.g., 13 March) still shows day 13 — if Excel shifted it, the serial was misread.
| Organisation region | Common CSV date pattern | Risk |
|---|---|---|
| United Kingdom | DD/MM/YYYY | US Excel may reinterpret as MM/DD |
| Australia / NZ | DD/MM/YYYY | Same ambiguity on days 1–12 |
| United States | MM/DD/YYYY | UK exports look “wrong” until remapped |
| Canada | Mixed; often YYYY-MM-DD in careful teams | fr-CA vs en-CA spreadsheet habits |
GST, VAT, and TaxType Columns
Invoice and bill CSVs fail most often on tax names, not math.
- TaxType values must match Xero’s tax rates exactly (including spacing and case where required).
- Australian files often need GST on Income / GST on Expenses style rates.
- UK files need correct VAT rates configured in the org before import.
- Do not put “20%” in TaxType unless that is literally the rate name in Xero.
- UnitAmount is usually exclusive of tax unless your template documents inclusive amounts.
Minimal invoice line shape
Illustrative columns — always start from Xero’s current template for your plan:
ContactName,InvoiceNumber,InvoiceDate,DueDate,Description,Quantity,UnitAmount,AccountCode,TaxType
Acme Ltd,INV-1001,2026-05-01,2026-05-31,Design services,1,1200.00,200,VAT on IncomeContacts CSV Without Duplicates
Contact Name is the key Xero uses to match. Slight differences create duplicates that pollute reporting.
- Export existing contacts first; match names exactly when updating.
- Keep AccountNumber and phone fields as text.
- Preserve UK/AU postcodes and Canadian postal codes with spaces as intended.
- Split bill and ship addresses only if the template provides those fields.
- UTF-8 CSV for names with accents (common in Canadian and European supplier lists).
Excel and Encoding Pitfalls for Xero
Accountants often prep Xero files in Excel on Windows and Mac.
- Save as CSV UTF-8 so £, €, and accented contact names survive.
- German or EU Excel may export semicolons; convert to comma CSV before Xero if the importer expects commas.
- Remove formula cells — paste values only.
- Do not leave blank template columns that shift AccountCode under TaxType.
- Re-download Xero’s sample after product updates; old header names silently fail.
Migrating from QuickBooks or Another Ledger
Migrations are CSV-heavy. Treat them as several small imports, not one giant file.
- Export chart of accounts and recreate tax rates in Xero first.
- Import contacts before invoices so ContactName resolves.
- Import historical invoices in date batches; reconcile AR/AP subtotals each batch.
- Convert QuickBooks IIF/QFX leftovers to CSV for review — do not paste Desktop formats into Xero.
- Keep a mapping sheet: old account code → Xero AccountCode.
Common Mistakes
Frequent rejects across UK, AU, CA, and US Xero orgs.
- Using QuickBooks column names in a Xero invoice template.
- Wrong TaxType strings copied from an invoice PDF instead of Xero settings.
- Uploading semicolon-delimited EU Excel CSV without conversion.
- Flipped bank signs (payments appearing as deposits).
- Merged cells and title banners above the header row.
- Editing a CSV in Excel and letting it rewrite dates to US order on a UK machine (or the reverse).
Best Practices
Make Xero’s template the source of truth.
- Download a fresh sample CSV for each import type.
- Validate row counts and amount sums before and after import.
- Store each uploaded file with the import date in the filename.
- Train the team on the org’s date locale once; put it in the bookkeeping SOP.
- Clean files in the browser when handling client bank data.
Why Use Convert CSV Online?
Convert CSV Online is free, browser-based, and requires no account for everyday conversions. Use the Online CSV Editor to fix Xero bank and invoice tables, convert OFX/QIF bank downloads via the Finance File Converter, and switch semicolon exports to comma CSV with the Delimited converter. Works in Windows, macOS, and Linux browsers — fitting mixed UK, Australian, Canadian, and US teams.
Prep a Xero bank CSV
Open the bank export, normalize columns and dates, download CSV, then import statement in Xero.
Conclusion
Xero CSV imports succeed when templates, TaxType names, and regional dates align with the organisation. Clean the file first, import small batches, and reconcile — especially when moving data between UK/AU day-first dates and US month-first habits.
FAQ
Can I import a CSV bank statement into Xero?
Yes. Use the bank account’s import statement flow and map Date, Amount, and description/payee fields. Preview carefully for date order and signs.
What date format does Xero expect in CSV?
It follows the organisation’s regional settings. UK and Australian orgs commonly use DD/MM/YYYY; US orgs commonly use MM/DD/YYYY. Confirm in your org before bulk imports.
Why does my Xero invoice CSV fail on TaxType?
TaxType must match a tax rate name configured in Xero exactly. Values like “20%” or “GST” fail if the org’s rate is named differently.
Can I move QuickBooks data to Xero with CSV?
Often yes for contacts, invoices, and some lists, but you must remap columns to Xero templates. Convert IIF/QFX files to CSV for review; do not upload QuickBooks-native formats into Xero.
My EU Excel CSV won’t import to Xero — why?
Excel in many European locales saves semicolon-separated “CSV.” Convert to comma-separated UTF-8 CSV before uploading if Xero expects commas.
How do I preserve UK postcodes in a Xero contacts CSV?
Keep postcode columns as text in Excel, export UTF-8 CSV, and verify in a text editor before import so leading zeros and spaces are intact.
References
Convert your CSV in the browser
Preview, clean, and convert CSV files free with Convert CSV Online—no installation and no account required for everyday conversions.