Skip to content
English - Australia
  • There are no suggestions because the search field is empty.

Syncing and troubleshooting the Xero integration

How to re-sync data, resolve common integration issues and access support.

1. Overview

Once connected and mapped, Synnch automatically syncs selected payroll and expense data from Xero.

If changes occur in Xero, such as new pay runs, updated salaries or additional expense accounts, you may need to re-sync your integration.

This article explains how syncing works and how to resolve common issues.

2. Automatic Sync

Synnch performs a scheduled sync with Xero to update:

  • Payroll data
  • Employee salary information
  • Expense account balances

The sync is read-only and does not modify data in Xero.

3. Manual Re-Sync

To manually refresh data:

  1. Navigate to Expenditure Workspace
  2. Locate the Sync or Xero refresh option
  3. Initiate the sync

This is recommended when:

  • A new payroll run has been completed
  • Expense accounts have been updated
  • An employee salary has changed
  • A previous sync error occurred

4. Re-Mapping After Sync

After syncing, you may:

  • Review employee mappings
  • Adjust expense account selections
  • Update allocation or apportionment methods

Existing selections remain saved unless manually changed.

5. Common Issues

Payroll Not Detected

Possible causes:

  • Payroll not enabled in Xero
  • No pay runs recorded in current financial year
  • Employee missing base rate or salary

Expense Accounts Not Appearing

Possible causes:

  • No expense data recorded in current financial year
  • Account type not eligible for mapping

Permission Errors

Possible cause:

  • User does not have Claimant Admin permissions in Synnch

6. Viewing Integration Logs

To view integration history:

  1. Click the Xero icon (top navigation)
  2. Open integration logs
  3. Review communication history and error messages

Logs help identify:

  • Failed sync attempts
  • Permission errors
  • Missing payroll data

7. When to Contact Support

If issues persist, provide:

  • Screenshot of the error
  • Date and time the issue occurred
  • Description of the action taken
  • Expected result
  • Page URL

Providing complete information significantly reduces resolution time.

8. Good Practice

To keep your integration stable:

  • Run payroll consistently
  • Avoid deleting mapped employees mid-year
  • Re-sync after structural accounting changes
  • Review allocation logic periodically