It's simple to get up and running with Xero and Joiin.


You start by following a few simple steps to connect your Xero organisation(s) to Joiin - once they're connected you don't need to perform this task again - from that point on your data will by kept in sync automatically and the Joiin reports will show up to date figures.


  • Go to the Companies page.
  • Click on Add Company and select Add Xero Company.

  • If you're not already logged into Xero you'll be taken to the login page of Xero - login with your Xero account details as you normally do.  NOTE if you are already logged into Xero under a different account than the one you want to connect to Joiin then you should first log off from Xero before attempting to connect.
  • Once logged in you will see the name of your organisation and an Allow Access button - if you have multiple organisations you can select the desired organisation.  NOTE you must have Standard (with Reports) or Advisor permissions in Xero to authorize the connection.

  • Click on the Allow Access button.
  • Your company will be added and data synchronisation will begin.
  • While the data sync is in progress you will see a message on the company indicating that the Finanical data is being loaded.  If you have Sales Reporting enabled on your Joiin account there will be an additional step to load the Sales data.

  • Once the Financial data has loaded you can start to run Financial reports.  The Sales data will continue to load.

  • Once it's complete you will see the date of the last refresh.


Now you're ready to run reports against that company.  For more information on running reports see the Running Reports user guide.


You can view your list of companies any time on the Companies page.  There you can also:


  • Change the dates data is imported for - by default Joiin pulls the data from Xero from the beginning of last year - if you want to go back further or include future-dated transactions you can change these settings.
  • Manually refresh data from Xero - Joiin will automatically refresh your data every day but if you've updated something in Xero and want to pull in the latest data you can refresh manually.
  • Change the order companies appear in in the report filters and the Compare by Company view.