> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Xero Custom Multi Account Connector

## Intro

Xero gives small businesses a firm grasp on their financial health, with tools to monitor cash flow, invoices, expenses, and more. When you connect Xero to Domo, you get a platform to collaborate around real-time data so you can move forward with a single version of the truth. Use the Domo Xero connector to bring your expenses into Domo, where you can easily track your finances and see exactly where your money is going.

Once your data is in Domo, you can assemble, organize, and visualize your Xero finance data any way you'd like. Get instant notifications when your financial metrics hit thresholds that you define.

You can connect to your Xero Custom Multi Account account in the Data Center. This topic discusses the fields and menus that are specific to the Xero Custom Multi Account connector user interface. To add add DataSets, sett update schedules, and edit DataSet information, see [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").

## Prerequisites

No prerequisites are required for this connector.

## Connecting to Your Xero Custom Multi Account Account

This section enumerates the options in the **Credentials** and **Details** panes in the Xero Custom Multi Account Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").

## Details Pane

This pane contains a primary **Reports** menu, along with various other menus which may or may not appear depending on the report type you select.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select the Xero Custom Multi Account report you want to run. The following reports are available: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"><p><b> Report Name </b></p></td><td colspan="1" rowspan="1"><p><b> Description </b></p></td></tr><tr><td colspan="1" rowspan="1"><p> Accounts </p></td><td colspan="1" rowspan="1"> Returns a list of accounts in your Xero Organization. </td></tr><tr><td colspan="1" rowspan="1"> Aged Payables By Contact </td><td colspan="1" rowspan="1"> Returns aged payable for all invoices within the specified time range. </td></tr><tr><td colspan="1" rowspan="1"> Aged Receivables By Contact </td><td colspan="1" rowspan="1"> Returns aged receivable for all invoices within the specified time range. </td></tr><tr><td colspan="1" rowspan="1"> Balance Sheet </td><td colspan="1" rowspan="1"> Returns a balance sheet for the current month to date. </td></tr><tr><td colspan="1" rowspan="1"> Bank Statement </td><td colspan="1" rowspan="1"> Returns bank statement lines for each bank account in your Xero Organization. </td></tr><tr><td colspan="1" rowspan="1"> Bank Summary </td><td colspan="1" rowspan="1"> Returns the balances and cash movements for each bank account. </td></tr><tr><td colspan="1" rowspan="1"> Bank Transactions </td><td colspan="1" rowspan="1"> Returns a list of any spend or receive transactions. </td></tr><tr><td colspan="1" rowspan="1"> Bank Transfers </td><td colspan="1" rowspan="1"> Returns a list of bank transfers. </td></tr><tr><td colspan="1" rowspan="1"> BAS Reports </td><td colspan="1" rowspan="1"> Returns a list of published BAS reports. This works for Australia based organizations only. </td></tr><tr><td colspan="1" rowspan="1"> Branding Themes </td><td colspan="1" rowspan="1"> Returns a list of branding themes defined for your Xero organization. </td></tr><tr><td colspan="1" rowspan="1"> Budget Summary </td><td colspan="1" rowspan="1"> Returns a summary of your monthly budget. </td></tr><tr><td colspan="1" rowspan="1"> Contacts </td><td colspan="1" rowspan="1"> Returns a list of contacts. </td></tr><tr><td colspan="1" rowspan="1"> Credit Notes </td><td colspan="1" rowspan="1"> Returns a list of credit notes. </td></tr><tr><td colspan="1" rowspan="1"> Currencies </td><td colspan="1" rowspan="1"> Returns a list of currencies for your organization. </td></tr><tr><td colspan="1" rowspan="1"> Employees </td><td colspan="1" rowspan="1"> Returns a list of employees used in Xero payrun functionality. </td></tr><tr><td colspan="1" rowspan="1"> Executive Summary </td><td colspan="1" rowspan="1"> Returns a summary including monthly totals and some common business ratios. </td></tr><tr><td colspan="1" rowspan="1"> Expense Claims </td><td colspan="1" rowspan="1"> Returns a list of expense claims and their status. </td></tr><tr><td colspan="1" rowspan="1"> Invoices </td><td colspan="1" rowspan="1"> Returns a list of invoices or purchase bills. </td></tr><tr><td colspan="1" rowspan="1"> Items </td><td colspan="1" rowspan="1"> Returns a list of items. </td></tr><tr><td colspan="1" rowspan="1"> Journals (deprecated) </td><td colspan="1" rowspan="1"> Returns a list of journal entries. Xero will no longer support the functionality of this report, and its accuracy cannot be guaranteed. Please use the Journals (Append) report instead. </td></tr><tr><td colspan="1" rowspan="1"> Journals (Append) </td><td colspan="1" rowspan="1"> Returns a list of journal entries created or modified after the specified date. </td></tr><tr><td colspan="1" rowspan="1"> Manual Journals </td><td colspan="1" rowspan="1"> Returns a list of manual journal entries. </td></tr><tr><td colspan="1" rowspan="1"> Organizations </td><td colspan="1" rowspan="1"> Returns information about your Xero organization. </td></tr><tr><td colspan="1" rowspan="1"> Payments </td><td colspan="1" rowspan="1"> Returns a list of payments for invoices and credit notes. </td></tr><tr><td colspan="1" rowspan="1"> Profit and Loss </td><td colspan="1" rowspan="1"> Returns a profit and loss report. </td></tr><tr><td colspan="1" rowspan="1"> Profit and Loss Aggregated </td><td colspan="1" rowspan="1"> Returns a profit and loss report with provided garnularity for selected date range. </td></tr><tr><td colspan="1" rowspan="1"> Purchase Orders </td><td colspan="1" rowspan="1"> Returns a list of purchase orders. </td></tr><tr><td colspan="1" rowspan="1"> Receipts </td><td colspan="1" rowspan="1"> Returns a list of draft expense claim receipts for any user. </td></tr><tr><td colspan="1" rowspan="1"> Repeating Invoices </td><td colspan="1" rowspan="1"> Returns a list of repeating invoice templates. </td></tr><tr><td colspan="1" rowspan="1"> Tax Rates </td><td colspan="1" rowspan="1"> Returns tax rates for your Xero organization. </td></tr><tr><td colspan="1" rowspan="1"> Tracking Categories </td><td colspan="1" rowspan="1"> Returns tracking categories and options for your Xero organization. </td></tr><tr><td colspan="1" rowspan="1"> Trial Balance </td><td colspan="1" rowspan="1"> Returns a trial balance for the current month to date. </td></tr><tr><td colspan="1" rowspan="1"> Users </td><td colspan="1" rowspan="1"> Returns a list of users for your Xero organization. </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"> Account Selection </td><td colspan="1" rowspan="1"> Select whether you would like to get reports for specific accounts or all accounts. </td></tr><tr><td colspan="1" rowspan="1"> Accounts Discovery </td><td colspan="1" rowspan="1"> Select the Accounts. </td></tr><tr><td colspan="1" rowspan="1"> Duration </td><td colspan="1" rowspan="1"><p> Select the duration for the report (a Single Date, or a Date Range). Many reports do not accept date ranges greater than 1 year. </p><p> The reports which do not accept date ranges greater than 1 year are: </p><ul><li> Accounts </li><li> Aged Payables By Contact </li><li> Aged Receivables By Contact </li><li> Bank Statement </li><li> Bank Summary </li><li> Bank Transactions </li><li> Bank Transfers </li><li> Contacts </li><li> Credit Notes </li><li> Employees </li><li> Expense Claims </li><li> Invoices </li><li> Items </li><li> Journals </li><li> Manual Journals </li><li> Payments </li><li> Profit and Loss </li><li> Purchase Orders </li><li> Receipts </li><li> Users </li></ul></td></tr><tr><td colspan="1" rowspan="1"> Report Date </td><td colspan="1" rowspan="1"> Select report date using relative or specific dates. Relative meaning number of days from today or a specific date using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> Select Specific Date </td><td colspan="1" rowspan="1"> Select the report date using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> Days Back </td><td colspan="1" rowspan="1"> The number of days back that you would like to get data for. Specify either today or 0, yesterday or 1, or today-7 or 7 to get data for 7 days into the past. </td></tr><tr><td colspan="1" rowspan="1"> Start Date </td><td colspan="1" rowspan="1"> Select report start date using relative or specific dates. Relative meaning number of days from today or a specific date using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> Select Specific Start Date </td><td colspan="1" rowspan="1"> Select the report date using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> Days Back To Start From </td><td colspan="1" rowspan="1"> The number of days back that you would like to get data from (start day). Specify either today or 0, yesterday or 1, or today-7 or 7 to get data for 7 days into the past. </td></tr><tr><td colspan="1" rowspan="1"> End Date </td><td colspan="1" rowspan="1"> Select report end date using relative or specific dates. Relative meaning number of days from today or a specific date using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> Select Specific End Date </td><td colspan="1" rowspan="1"> Select the report date using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> Days Back To End At </td><td colspan="1" rowspan="1"> he number of days back that you would like to get data to (end day). Specify either today or 0, yesterday or 1, or today-7 or 7 to get data for 7 days into the past. </td></tr><tr><td colspan="1" rowspan="1"> Skip Account Errors </td><td colspan="1" rowspan="1"> This setting controls how the connector behaves if one or more Xero Custom accounts have issues connecting to Xero. If set to “Yes”, the connector will ignore any Accounts that have issues connecting to Xero, and will skip to the next Account in the list. If set to “No”, the connector will immediately fail if it encounters any Account that cannot successfully connect, no matter the status of other Accounts. In this case, the dataset will not be updated. </td></tr><tr><td colspan="1" rowspan="1"> Contacts Filter Type </td><td colspan="1" rowspan="1"><table border="1"><tbody><tr><td colspan="1" rowspan="1"><b> Filter Type </b></td><td colspan="1" rowspan="1"><b> Description </b></td></tr><tr><td colspan="1" rowspan="1"> None </td><td colspan="1" rowspan="1"> No filtering will be performed. </td></tr><tr><td colspan="1" rowspan="1"> Filter by contact ID </td><td colspan="1" rowspan="1"> Only data for specified contact IDs will be returned. </td></tr><tr><td colspan="1" rowspan="1"> Filter by contact date </td><td colspan="1" rowspan="1"> Only data for contacts that have been modified since the specified date will be returned. </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"> Include Tracking Categories </td><td colspan="1" rowspan="1"> Checking this box will include tracking category data for each line item in the transaction entry. As transaction entries may contain more than one tracking category, this will result in 1 row of data per tracking category included. </td></tr><tr><td colspan="1" rowspan="1"> Select The Field To Flatten </td><td colspan="1" rowspan="1"> Some Xero reports return additional arrays of data. For example the 'Invoices' report has a list of payments that are a part of that invoice. If you chose to flatten on payments, and a single invoice had 5 payments, you would get 5 records for that one invoice. </td></tr><tr><td colspan="1" rowspan="1"> Journal History In Days </td><td colspan="1" rowspan="1"> Enter the number of days of Journal History you would like to retrieve. After the initial run, the connector will only retrieve newly created or updated journals. </td></tr><tr><td colspan="1" rowspan="1"> Data Entry Method </td><td colspan="1" rowspan="1"> Select the date function you would like to run for this report, or select to enter a date manually. </td></tr><tr><td colspan="1" rowspan="1"> Select The Period Count </td><td colspan="1" rowspan="1"> Select the period count. </td></tr><tr><td colspan="1" rowspan="1"> Tracking Category ID </td><td colspan="1" rowspan="1"> Filter your results based on a tracking category ID. This field is optional. </td></tr><tr><td colspan="1" rowspan="1"> Select The Report Granularity </td><td colspan="1" rowspan="1"> Select the report granularity. This generates the report for provided date range with selected granularity level, In the case of weekly granlarity first day of the week will be the day of start date selected. Example: if you select date range of last one year and granualarity as weekly then it will generate the report for 52 weeks, each week separately. </td></tr><tr><td colspan="1" rowspan="1"> Select The Timeframe Type </td><td colspan="1" rowspan="1"> select the timeframe type. </td></tr><tr><td colspan="1" rowspan="1" /><td colspan="1" rowspan="1" /></tr></tbody></table>

## Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").
