> ## Documentation Index
> Fetch the complete documentation index at: https://www.spacebring.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Xero

> Connect Xero integration to automatically sync invoices, invoice statuses, and payments from Spacebring in real time, understand the key prerequisites for successful synchronization and how the integration works, and fix sync errors

Seamlessly sync all invoices and payments from Spacebring to Xero to automate revenue accounting and payment reconciliation.

> [!NOTE]
>
> Xero is a distinct company not affiliated with us. For any inquiries regarding Xero's solutions, services, or pricing, please reach out to Xero directly. We do not have the authority to provide information or support on behalf of Xero.

## Prerequisites

1. Have your Xero account ready.
2. Set up the same [tax rates](https://www.spacebring.com/docs/billing/taxes.md) in Xero and Spacebring.
3. Make sure your Spacebring invoice currency matches your Xero account currency.
4. Set up your “Revenue” accounts in Xero for syncing **invoice items** from Spacebring.
5. [Set up a clearing account](https://central.xero.com/s/article/Reconcile-payments-received-from-online-sales-AU-UK-US-GL) in Xero for syncing **invoice payments** from Spacebring. Fill in the **Code** field for it and check the **Enable payments to this account** box.

## Connect Xero integration

1. Click the menu **(...)** next to the location's name > go to **Integrations**.

![Location menu open in the left panel with Integrations highlighted on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/EoXqL0krIeX5lJ8K/images/integrations-connect-a-location-level-integration.png?fit=max\&auto=format\&n=EoXqL0krIeX5lJ8K\&q=85\&s=59910549be2afb079049dadf53f7e2b9)

2. Open the **Xero** integration page and click **Connect**.

![](https://mintcdn.com/spacebring/NXOhFSPltwhOqCNG/images/integrations-accounting-xero-3.png?fit=max\&auto=format\&n=NXOhFSPltwhOqCNG\&q=85\&s=af0a763bdcaabc06a627db959a446d19)

3. Grant access to your Xero organization.
4. Select the same organization in the **Organization** dropdown.
5. **Tax rates for invoice item sync** — select the same Xero tax rates as the ones you use in Spacebring. During sync, each invoice item's tax rate from Spacebring must match one of the Xero tax rates selected here.

> [!WARNING]
>
> If an item's tax rate doesn't match any selected Xero tax rate, the invoice will fail to sync.

6. **Account for invoice payment sync** — select your Xero account where Spacebring should sync invoice payments.

> [!NOTE]
>
> Only accounts with 'Enable payments to this account' checked in Xero are available to select.

7. **Accounts for invoice item sync** — for each product type, select your Xero account where Spacebring should sync invoice items for this product.

> [!NOTE]
>
> Only 'Revenue' accounts are available to select.

> [!WARNING]
>
> It is required to select accounts for **all** invoice item types, even if you don't have some of these product types. Otherwise, invoice syncing to Xero will not work.

8. **Tracking categories for invoice sync** — select one option per Xero tracking category to add to every synced invoice item and credit note line.
   * The section shows when your Xero organization has active tracking categories.

![Xero integration settings with an organization, a tax rate, a payment account, an account for every invoice item type, and tracking options on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/sow6uq41aDWzB6wS/images/integrations-accounting-xero-connect-xero-integration-xero-page.png?fit=max\&auto=format\&n=sow6uq41aDWzB6wS\&q=85\&s=3108fc65ac9d69db3916ffa87093cb8c)

## How Xero integration works

Once the integration is connected, Spacebring syncs the following to Xero in real time:

* Newly issued invoices
* Invoice status updates
* Invoice payments
* Credit notes for unpaid invoices.

> [!NOTE]
>
> Applied balance, partial payments, credit notes for paid invoices, and refunds do not sync to Xero.

> [!NOTE]
>
> Spacebring syncs invoices for all purchase types, including subscriptions, bookings, shop orders, event tickets, and other one-time payments starting December 9, 2025. Before this date, immediate one-time payments (bookings, shop orders, event tickets, etc.) generated receipts only, which were not synced to Xero.

To sync an invoice issued before you connected Xero, or one that failed to sync, open it and click **Sync to Xero** in the **(...)** menu. To sync several, select their checkboxes on the **Billing** > **Invoices** page, then press **Actions** > **Sync to Xero**. The sync covers the invoice, its payments, and its credit notes, and skips what Xero already has. Xero rejects an invoice dated before its lock date, and the failure shows in the invoice's activities.

### How invoices sync

The integration maps Spacebring invoice data to Xero as follows:

| **Data in Xero** | **Sync** |
| - | - |
| To | Company/user's name or legal business name |
| Customer email | - |
| Invoice date | ✓ |
| Due date | ✓ |
| Invoice no. | ✓ |
| Currency | ✓ |
| Account | Selected **Revenue** accounts |
| Item description | Invoice item name in Spacebring |
| Item quantity | ✓ |
| Item price | ✓ |
| Amount | ✓ |
| Tax | Tax type (inclusive or exclusive), and tax rate. |
| Tracking | Selected tracking options |
| Attachment | Invoice PDF |
| Status | ✓ |
| The **Go to Spacebring** link directs to the related invoice in Spacebring. | ✓ |

![](https://mintcdn.com/spacebring/NXOhFSPltwhOqCNG/images/integrations-accounting-xero-6.png?fit=max\&auto=format\&n=NXOhFSPltwhOqCNG\&q=85\&s=fc9092afc00b4ec70217cf989afce731)

### How invoice statuses sync

The integration syncs the following invoice statuses to Xero:

| **Invoice status in Spacebring** | **Status in Xero** |
| - | - |
| Unpaid | Awaiting payment |
| Paid | Paid |
| Voided | Void |

![Integrations Accounting Xero Invoice Statuses Sync](https://mintcdn.com/spacebring/MYQ5EiBBoAqDemNI/images/integrations-accounting-xero-invoice-statuses-sync.png?fit=max\&auto=format\&n=MYQ5EiBBoAqDemNI\&q=85\&s=811b15203be0d43a43e6f11dd2fb8073)

### How invoice payments sync

When payments sync to your Xero clearing account, the following data is transferred:

| **Data in Spacebring** | **Xero** |
| - | - |
| Transaction date | Payment date |
| Invoice number | Reference Inv # |
| Legal business name / Name | Contact |
| Due date | Due date |
| Paid amount | Payment amount |

Invoice payment in Spacebring:

![](https://mintcdn.com/spacebring/NXOhFSPltwhOqCNG/images/integrations-accounting-xero-8.png?fit=max\&auto=format\&n=NXOhFSPltwhOqCNG\&q=85\&s=b7f336bd4129941e124c8a1a5300fdf9)

Invoice payment in Xero:

![](https://mintcdn.com/spacebring/NXOhFSPltwhOqCNG/images/integrations-accounting-xero-9.png?fit=max\&auto=format\&n=NXOhFSPltwhOqCNG\&q=85\&s=6c1cba5bc081a02313c9ff303512d928)

## Disconnect the Xero integration

1. Press the menu **(...)** next to the location's name > go to the **Integrations** page.
2. Select **Xero** > press **Disconnect** and confirm your choice.

## Troubleshoot Xero sync errors

When an invoice or its payment fails to sync, administrators get a [notification](https://www.spacebring.com/docs/account/notifications.md) that ends with the error in quotes, such as *Failed to sync an invoice INV-0042 from Central Hub due to an error "Xero tax rate not found."* Spacebring doesn't retry it on its own, so once you fix the cause, open the invoice and click **Sync to Xero**.

> [accordion] "Xero organization not selected."
>
> **What it means:** No Xero organization is selected on the **Integrations** > **Xero** page. Spacebring also clears the selection when Xero no longer gives access to the organization.
>
> **How to fix it:**
>
> 1. Go to **Integrations** > **Xero**.
> 2. Select your organization in the **Organization** dropdown.
> 3. If it isn't listed, disconnect Xero and [connect it](#connect-xero-integration) again, granting access to that organization.

> [accordion] "A required Xero account is not selected or invalid."
>
> **What it means:** An account field on the **Integrations** > **Xero** page is empty, or the account selected in it was deleted or archived in Xero. Spacebring clears an account that is no longer valid.
>
> **How to fix it:**
>
> 1. Go to **Integrations** > **Xero**.
> 2. Select an account in every empty field:
>    * If the notification says *Failed to sync an invoice*, check **Accounts for invoice item sync**.
>    * If it says *Failed to sync payment for the invoice*, check **Account for invoice payment sync** and **Processing fee**.
> 3. If the payment account you need isn't listed, check **Enable payments to this account** for it in Xero.

> [accordion] "Xero tax rate not found."
>
> **What it means:** An invoice item's tax rate matches none of the Xero tax rates selected in **Tax rates for invoice item sync**.
>
> **How to fix it:**
>
> 1. In Xero, check that a tax rate with the same rate exists, and add it if it doesn't.
> 2. In Spacebring, go to **Integrations** > **Xero** and select that tax rate in **Tax rates for invoice item sync**.

> [accordion] "Organization is not subscribed to currency \[currency code]"
>
> **What it means:** The invoice's currency isn't added to your Xero organization.
>
> **How to fix it:** Add the currency in the Xero currency settings.

## FAQs

> [accordion] Why is nothing syncing at all after I connected Xero?
>
> The connection stays incomplete — and nothing syncs — until every setting below is in place. Check them in this order.
>
> In Spacebring, on the **Integrations** > **Xero** page:
>
> * **Organization** — select the same Xero organization you granted access to. Nothing syncs without it, and the tax rate and account sections only appear once it's selected.
> * **Tax rates for invoice item sync** — select the Xero tax rates matching the ones you charge. Required whenever [taxes](https://www.spacebring.com/docs/billing/taxes.md) are enabled for your location. If an invoice item's rate matches none of them, that invoice won't sync.
> * **Account for invoice payment sync** — select the Xero clearing account to sync invoice payments to. Without it, invoices sync but payments don't.
> * **Accounts for invoice item sync** — select an account for **every** item type: **Bookings**, **Event tickets**, **Shop products**, **Packages**, **Subscription items**, **Processing fee**, and **Custom**. Missing even one stops invoices syncing, including item types you don't sell.
>
> In your Xero account:
>
> * The account you want for invoice payments needs **Enable payments to this account** checked, otherwise it won't appear in the Spacebring dropdown.
> * The accounts you want for invoice items must be **Revenue** accounts, otherwise they won't appear either.
> * Your Xero organization must be subscribed to the currency your invoices use.
> * Your Xero tax rates must match the ones you charge in Spacebring.
>
> If a specific invoice fails rather than everything, the notification names [the cause](#troubleshoot-xero-sync-errors).

> [accordion] Why are my invoices appearing in Xero, but not invoice payments?
>
> This happens if no **Account** is selected in your Spacebring Xero settings. While invoices sync automatically, invoice payments require you to select a clearing account in the **Account** dropdown. Also, ensure that this clearing account has ****Enable payments to this account**** enabled in Xero.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.