Resetting your Xero Connection

Use Refresh Connection when Xero access has expired, been revoked, or is missing the payroll permissions Astalty needs. You need permission to update Settings.

Disconnect your Account

Do not disconnect as the first troubleshooting step. Disconnecting removes Astalty's stored credentials, clears Xero as the selected invoicing platform, and stops integration actions immediately. Use it when you intend to remove or replace the Xero connection. See Connecting and Disconnecting.

Reconnect your Account

1. Open Settings > Integrations > Xero.
2. Select Actions > Refresh Connection.
3. Sign in to Xero, select the correct organisation, and grant every requested permission.
4. Return to Astalty and confirm that Connected Organisation is correct.

If the credentials exist but no valid organisation is selected, use Select Organisation on the Xero settings card.

Syncing Failed Batches

Refreshing the connection does not automatically restart invoice sync. Open the finalised batch and select Actions > Sync with accounting. The action is available while the batch is new, pending or failed and the selected accounting platform is ready. It can also reappear on a synced batch after Astalty confirms that Xero no longer has one of its invoices. See Sync With Xero.

Syncing Reconciliation Payments

For a batch that is already synced and still outstanding, select Actions > Sync payments. Astalty queues a fresh payment pull for each non-NDIA invoice in the batch. See Sync Payments Within Batch.