Map tax rates and accounts

When you connect Xero, Kiaro fetches your tax rates and chart of accounts so you can choose how Kiaro invoice lines should appear in your books.

Set a default tax code and a default income account before you send invoices. Until both are set, an invoice push fails with a “no mapping” message and the invoice stays in Kiaro (it won’t appear in Xero). The integration card shows a Finish setup prompt while either default is missing, and any failed push is recorded in the sync activity log so you can retry it once the mapping is in place.

Default tax code

The default tax code is used when a Kiaro invoice’s tax rate doesn’t have a specific mapping. Most solo consultants use one rate (e.g. 20% VAT in the UK, 21% BTW in the Netherlands), in which case the default covers every invoice.

Default income account

The default income account is the Xero account code applied to every invoice line, unless the project has its own mapping. Common choices: 200 Sales, 230 Consulting Income.

Per-rate tax mapping

If you charge different tax rates (e.g. standard rate domestic and zero-rated EU exports), map each Kiaro rate to a separate Xero tax code:

Per-project mapping

If different projects feed different income lines in your books, map projects individually:

Projects without an explicit mapping use the default account.

Stripe clearing account

To sync Stripe payments and refunds to Xero, you need to nominate a bank account in Xero that represents your Stripe balance. This is sometimes called a “Stripe clearing account” or “Stripe float account” in your chart of accounts.

Open the mapping page (Settings, Integrations, then click Configure on the Xero card) and choose the account from the Stripe clearing account dropdown. Kiaro posts incoming Stripe payments against this account as receipts, and records the cash side of any refund against it as well.

Until you set this account, payment and refund sync is paused. The events are logged in the integration’s sync activity, so nothing is lost; once you nominate the account you can retry any queued events.

Refresh catalog

If you add new tax rates or accounts in Xero, click Refresh catalog on the mapping page. Kiaro re-fetches the current list and marks anything missing as inactive.