Skip to main content
About the Xero Integration

How to use Xero and what the Xero integration fields in Settings mean

Jessica Magri avatar
Written by Jessica Magri
Updated over a week ago

Xero is an online software tool that simplifies accounting tasks for businesses. When this integration is set up, invoices and payments created in Semble are automatically uploaded to Xero, even if payment is not recorded at the time of the invoice creation.

For information on how to set up the Xero integration, see here.

Note: To view the Xero integration settings, you must have a role assigned to you that gives you viewing permissions for Integrations. For more information on roles, see here.

In this article:

Xero Integration Settings

When your practice has fully set up Xero, some new fields will appear in the Integrations tab in Settings:

  • Xero sales account: Where both paid and unpaid invoices are uploaded to in Xero. An example name could be '200 - Sales' - please note that this must be marked as "Revenue" for Account Type in Xero and not "Sales"

  • Xero payment account: Where your paid invoices go in Xero. An example name could be '160 - Revenue'

  • Invoice due in: Where you select how long patients have to pay off their invoice

  • Send practitioner as reference: Tick this box to have the clinician's name appear in the 'reference' field on invoices sent to Xero

Note: To keep any changes you have made to the integration, you must click Save.

Configure a Product to a Xero Account

When you have fully set up the Xero integration, you can configure your products to invoice to a specific Xero account:

1. Go to the Products page.

2. Select the product you want to configure Xero with.

3. Click the edit icon in the top right-hand corner.

4. Scroll down to the Xero section, then use the two dropdowns to select the Sales Account and Payment Account that you want to link the product to.

5. Click Save.

Now, when that product is added to an invoice, it will be processed by the Xero account that you have configured for it.

Handling multiple line items with different Xero information

For a Xero invoice to be correctly processed, all products within the invoice must have the same Xero settings for the "Payment account." If you have an invoice with two (or more) line items where some products have no Xero info linked and other products have Payment Account 1 linked, the entire invoice will default to the payment account set up in Settings > Integrations > Xero.

For example, if the default payment account in the settings is Payment Account 2, the invoice will be assigned to Payment Account 2.

This ensures consistency in processing, even if some products lack specific Xero account details.

Note that while the "Payment account" settings must be consistent, the "Sales account" settings can indeed be different.

What Data is Sent to Xero?

The data flow between Semble and Xero is one way. Semble sends data to Xero, but Xero does not send data to Semble.

See the following diagram for information about what data flows from Semble to Xero, and the place in Xero where this information can be found:



Name of patient

Invoice > "To"

Invoice Number

Top of invoice

Products listed in invoice

Invoice > "Description"

Date invoice created/Due date

Invoice > "Date" + "Due date"

Amount paid/outstanding

Invoice > "Total"


Invoice > "Status"

Disconnect from Xero

You can disconnect Semble from Xero at any time:

1. Go to the Settings page.

2. Go to the Integrations tab.

3. Click Disconnect from Xero.

You are now disconnected from Xero. You can set up the Xero integration again at any time. For more information, see here.

Did this answer your question?