Importing from Xero

Importing your financial, tracking category & budget data from Xero

Updated over a week ago


Adding a Xero company to Fathom

Fathom has a direct integration with Xero, and those with Advisor or Standard-level permissions in Xero are able to import data into Fathom.

When you import a Xero company into Fathom, your company’s Chart of Accounts will automatically be brought into Fathom. You can import a maximum of 3000 accounts and up to 8 years of monthly data.

📝 Note: Fathom imports the Standard P&L and Balance Sheet from Xero. You can customise the Profit & Loss and Balance Sheet once they've been imported into Fathom in 'Step 3 - Chart of Accounts'. The changes you make in 'Step 3' will flow through to the Reports, Analysis, and Forecasting tools in Fathom.

Importing your financials from Xero

To add a company from Xero into Fathom:

  1. Select ‘Add’ in the upper right corner of the ‘My Companies’ screen.

  2. Then, choose ‘Company’

  3. Select ‘Xero’.

  4. Click the grey ‘Connect to Xero’ button.

  5. Enter your Xero credentials. The first time Fathom connects to your Xero organisation, you must authorise Fathom to access your data from Xero. You’ll only need to do this once for each Xero organisation.

    ❗Notice: To connect a Xero company, you must be an 'Advisor' or 'Standard' level user with the 'View Reports' permissions set to 'All Reports' in that specific company. If you cannot find your company in the list that Xero presents, you'll want to check on the permission levels in Xero before re-attempting the import.

After authorising access, Fathom will begin to import your financial data (Profit & Loss and Balance Sheet). The import should not take more than a few minutes. Once completed, you will see your Xero company listed on the 'My Companies' screen in Fathom.

💡 Pro Tip: All initial imports from Xero will default to the accrual accounting method. To switch the accounting method, please see our article on switching between cash basis and accrual accounting.

Update your financial data from Xero

You can manually update the financials of your Xero company in Fathom at any time in the company’s Settings.

  1. Go to ‘Step 1 - Update Data’ of the company’s Settings

    💡 Pro Tip: Your financials will default to update through the most recently completed calendar month. If you want month-to-date financials imported into Fathom, then you’ll need to select this using the ‘edit’ option next to the listing under the ‘Automatically update every day’ checkbox.

  2. In the ‘Financials’ section, select the grey ‘Update from Xero’ button.

💡 Pro Tip: By default, Fathom will automatically update your financial data from Xero once every 24 hours. This setting can be toggled on or off in 'Step 1 - Update Data' of the Settings for a company. For more information about automatic updates, please see our ‘Automatic Updates’ article.

Next steps

Congratulations on adding your Xero company to Fathom! Continue the 'Getting Started Workflow' by setting up your company for analysis, reporting, and forecasting. Choose from one of the steps below:

What you want to do:

Next step in the setup process:

Have classes or locations you want to analyse or report on?

Want to switch out the budget that was automatically imported?

Happy with the above and ready to begin setting up your Company Profile?

💡Pro Tip: If you want to consolidate several companies in Fathom, we recommend importing and completing the setup process for each company before creating a consolidated group.

Additional knowledge & common questions

Did this answer your question?