This article explains common synchronization issues between Silverfin and Xero and provides guidance on resolving them. If your sync has been rate-limited or is experiencing credential-related errors, follow the steps outlined below to ensure the issue is addressed effectively.

Table of contents 

Xero API rate limit 

sync has been rate limited and will be resumed after about xx hours

Explanation:

This message indicates that one of the API sync limits imposed by Xero for this file has been reached. 

What you Can Do:

  1. Wait: The sync will resume automatically as soon as the rate limit resets.
  2. Cancel and manually upload data: If you’re facing a tight deadline, you can cancel the sync and manually upload the necessary data.

Note: The rate limit is determined by Xero, not Silverfin. For further assistance, you may contact Xero directly. 

To learn more about Xero API limits, click here.


The credentials used by this sync no longer allow us access to the data in Xero. Please create a new Xero sync with valid credentials and then transfer this file there

or:

We were unable to access your data in Xero with credentials used by this sync.</strong> Please ensure that the user who set up this sync has full access to the file in Xero


Explanation:

These messages indicate that Silverfin is unable to access Xero data due to credential issues. This can happen if:

  • The credentials are no longer valid.
  • The user who set up the sync does not have full access to the file.

What You can do:

You must re-authenticate the sync by logging into Xero with valid credentials.

How to re-authenticate the sync?

  1. Go to the file and click on the 'Edit client' button.

  2. Navigate to the Sync tab.
  3. Click the Switch Sync button.
  4. Choose a synchronization scenario. If you select the first option, you will be prompted to set a sync transfer date.
  5. From the list of available synchronizations, select Xero or XeroTB.
  6. Click Save Changes.
  7. You will be redirected to the Xero login page. Log in using the credentials of a user who has access to the file.
  8. Once logged in, click Continue with X Organisations.

If you see the message 'Already connected,' it means another existing sync entity has already been authorised to sync with this file. In other words, if another user with access to this file has also established a connection between Silverfin and Xero, this message will appear.

Following these steps should resolve most sync-related issues. For further assistance, please contact Silverfin Support.