Xero FAQ

How do I remove the Xero integration completely?

If you want to disconnect your Xero account and remove it completely from Sonas, go to Venue > Integrations and click the remove button on the Xero tile. Remember that all previously added information will remain in your Xero account, and you will need to delete it manually.

What happens if my Xero account gets disconnected or I see activities with system errors?

On some occasions, you might receive a system notification saying your connection with Xero has been lost or asking you to revise your account settings. This might happen, for example, if you change the code or description of your Xero Accounts or update some organization settings. If your connection is lost, you can reconnect from the Xero Integration Settings.

In the other cases, you might need to refetch the latest Xero information from your account and update your config to use your latest changes. To do this, click on Actions > Refresh Xero Data.

Can I use multiple Xero accounts/organizations for my different venues?

Yes, each venue can add its own Xero account or use a shared one if required. However, only one organization can be used per venue.

What is not covered by the Xero integration?

• Synchronizing quotations/draft invoices
• Importing invoices/credit notes created directly in Xero
• Creating existing Xero taxes in Sonas
• Reconciling bank transfers in your Xero account automatically (we try to help match invoices and payments with the description)
• Creating any sort of Xero reports

When and how does data sync occur?

Syncs occur on the half hour. After an invoice is created, it waits at least one hour before syncing to allow time for corrections. If you just created an invoice and don't see it in Xero yet, wait for the next sync cycle. You can confirm an invoice has synced by looking for the "Xero Sync" tag on the invoice. Check Event Activities and System Logs for sync errors.

Please check this article for a more in-depth explanation of the process.

What do I do when I get a sync error due to removed contact?

You received the error, "Problem with Integration - Error creating Xero invoices: Error finding contact for INV-XX-123456 it might have been removed/archived." This the result of you either deleting or archiving the contact. The financial record cannot sync if there is no contact. To fix this, you must unarchive the contact or add back in. Within a few hours Sonas will retry the sync.

What do I do when I get a tax code sync error?

If you see an error like "The TaxType code 'OUTPUT2' cannot be used with account code 'XXX'", it means the Xero account is not configured to allow the tax rate assigned in Sonas. Update the account settings in Xero to permit the correct tax rate, then go to the Xero Integration Settings in Sonas and click Actions > Refresh Xero Data. You do not need to disconnect and reconnect Xero.

How do I update Xero account codes or settings without disconnecting?

You do not need to disconnect and reconnect Xero after making changes to account codes or settings in Xero. Simply update the settings in Xero, then in Sonas go to the Xero Integration Settings and click Actions > Refresh Xero Data to pull the latest information.

What does "Mismatch between data stored in Xero and Sonas" mean?

This error appears in System Logs when an invoice that is already synced with Xero has different values in Sonas and Xero — for example, if you manually edited an invoice in Xero after it was synced. This mismatch triggers error activities during automatic journaling. To resolve this, you can either:

1. Contact support to tag the event as "already journaled" in the back end, which stops the automatic journaling attempts for that event (you would then need to journal manually in Xero).
2. Contact support to update the invoice amount in Sonas to match Xero exactly, so automatic journaling can proceed.

If you manually edit synced invoices in Xero (e.g., to adjust for a cancellation fee), expect this mismatch error to appear.

How do I view Xero error logs?

You can view Xero sync errors in the Activities section of an event. Filter activities by "Error Synchronising Invoice" and "Error Synchronising Credit Note" to see all sync errors. You can match the date and time of these activities to alerts shown in System Logs.

How do I disable automatic journaling?

If you prefer to post journals manually in Xero and don't use automatic journaling from Sonas, you can switch it off from the Xero Integration Settings for each venue. Navigate to the Xero Integration settings and disable the automatic journaling option. You need to do this separately for each venue.

Updated on: 05/05/2026