Resolving Connection Issues


A Red Connection Status Indicator icon reflects a disconnection between Ostendo and Xero, therefore further action is required in order to resolve this.




In order to resolve this situation, you need to determine where the issue lies. There could be one of a number of reasons why this may have occurred. Follow this process to identify the issue. 


Determining the Response Code from Xero:

    • Go to the General Ledger Settings screen in Ostendo File -> Financial Configuration -> General Ledger Settings
    • Press the 'Connect' button to test the connection



    • A Connection message will appear along with a Response Code Error Number and a brief explanation of that error code. 



Response Code & Exception Errors


Response Code

Name

Suggested Action

400

Bad Request - A validation exception has occurred

Please contact your Ostendo Support Partner

401

Invalid authorisation credentials

Please re-initiate the setup to re-establish this connection

403

User does not have permission to access the resource

This indicates the Xero user that was specified when establishing the Setup does not have Business & Accounting privileges of either Standard or Adviser. Please re-initiate the setup to re-establish this connection using a Xero User with adequate security privileges

404

The resource you have specified cannot be found

Please re-initiate the setup to re-establish this connection

412

One or more conditions given in the request header fields were invalid

Please contact your Ostendo Support Partner

429

The API rate limit for your organisation/application pairing has been exceeded

Please contact your Ostendo Support Partner. Refer Xero Transaction Rate Limits for more information

500

An unhandled error with the Xero API

If this error persists, Please contact your Ostendo Support Partner

503

The organisation temporarily cannot be connected to.

The Xero API is unavailable at present. This could be due to a scheduled outage. Try re-initiating the setup to re-establish this connection later.

Socket Error 11001

Host not found

Ensure https://api.xero.com/api.xro/2.0/ is specified in the GL Settings URL or Path field