> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-bradley-turek-pfilter-operators-reference.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# QuickBooks Online Reports Connector

## Intro

QuickBooks Online is the most commonly used small business accounting and financial management software. It allows users to track sales and customer information and provide reports for managing the business and serving their customers. You can use Domo's QuickBooks Online Reports connector to retrieve data about all financial aspects of your business. To learn more about the QuickBooks Online Reports API, go to [https://developer.intuit.com/docs/0050\_quickbooks\_api](https://developer.intuit.com/docs/0050_quickbooks_api).

The QuickBooks Online Reports connector is a "Cloud App" connector, meaning it retrieves data stored in the cloud. In the Data Center, you can access the connector page for this and other Cloud App connectors by clicking **Cloud App** in the toolbar at the top of the window.

To use the QuickBooks Online Reports connector, create a DataSet in the Data Center and select the QuickBooks Online Reports connector.

This topic discusses the fields and menus that are specific to the QuickBooks Online Reports connector user interface. For general information about adding DataSets, setting update schedules, and editing DataSet information, see [Adding a DataSet Using a Data Connector](/s/article/360042926274).

You can also pull on-premise QuickBooks Online data using Workbench, a secure, client-side solution for uploading your data in Domo. In addition to QuickBooks, you can use Workbench to upload data from other systems using CSV, JIRA, JSON, Microsoft Excel, ODBC, OLAP, and XML. For more information, see [Connecting to QuickBooks Data in Workbench 5](/s/article/360042932754)

<table border="1" cellpadding="1" cellspacing="1">
  <thead>
    <tr>
      <th colspan="1" rowspan="1">
        <p />
      </th>

      <th colspan="1" rowspan="1">
        <p />
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td colspan="1" rowspan="1">
        <p>
          <b>Primary Use Cases</b>
        </p>
      </td>

      <td colspan="1" rowspan="1">
        <p>Pulling financial accounting reports.</p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>
          <b>Primary Metrics</b>
        </p>
      </td>

      <td colspan="1" rowspan="1">
        <p>- Revenue - Costs - P\&L line items - Balance sheet items</p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>
          <b>Primary Company Roles</b>
        </p>
      </td>

      <td colspan="1" rowspan="1">
        <p>- Accountants - Purchasers - CFOs - Controllers</p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>
          <b>Average Implementation Time</b>
        </p>
      </td>

      <td colspan="1" rowspan="1">
        <p>
          Report runtime will depend on how large the reports in QuickBooks are.
          Smaller date ranges will take less.
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>
          <b>Ease of Use (on a 1-to-10 scale with 1 being easiest)</b>
        </p>
      </td>

      <td colspan="1" rowspan="1">
        <p>3</p>
      </td>
    </tr>
  </tbody>
</table>

## Best Practices

The connector should run on **Replace** at any reasonable schedule. **Append** will cause duplicates.

## Prerequisites

To connect to a QuickBooks Online account and create a DataSet, you must have the following:

* The email address or user ID you use to connect to QuickBooks Online.
* The password you use to connect to QuickBooks Online.

## Connecting to Your QuickBooks Online Reports Account

This section enumerates the options in the **Credentials** and **Details** panes in the QuickBooks Online Reports 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](/s/article/360042926274).

### Credentials Pane

The Domo QuickBooks Online Reports connector uses OAuth to connect, so there is no need to enter credentials within Domo. Click **Connect** (or select **Add Account** if you have existing QuickBooks Online accounts in Domo) to open the QuickBooks Online OAuth screen where you can enter your login credentials. After you log in using your credentials, you are requested to authorize Domo to access your QuickBooks Online data. Once you enter credentials and authorize Domo, you can use the same account any time you go to create a new QuickBooks Online Reports DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Manage Connector/Adapter Accounts](/s/article/360042926054).

<Note>
  **Note:** If you are already logged into QuickBooks Online when you connect in
  Domo, you are authenticated automatically when you click **Add account**. If
  you want to connect to an account that is different from the one you are
  logged into, you must first log out of QuickBooks Online.
</Note>

### Details Pane

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

<table border="1" cellpadding="1" cellspacing="1">
  <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 a QuickBooks Online report. The following reports are
          available:
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>Date Filter By</p>
      </td>

      <td colspan="1" rowspan="1">
        <p>Select the date filter method.</p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>Created Date Duration</p>
      </td>

      <td colspan="1" rowspan="1">
        <p>
          Select the created date duration for the report (a Single Date, or a
          Date Range).
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>Account Status</p>
      </td>

      <td colspan="1" rowspan="1">
        <p>Select account status.</p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>Transaction Date</p>
      </td>

      <td colspan="1" rowspan="1">
        <p>Select the start date for the report.</p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>Report Date</p>
      </td>

      <td colspan="1" rowspan="1">
        <p>
          Select report date using relative or specific dates. Relative meaning
          number of days from today or a specific date using the date selector
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>Specific Date</p>
      </td>

      <td colspan="1" rowspan="1">
        <p>
          Select the report date using the date picker, this option is only
          available when Report Date is set to 'Specific'
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>Date Offset</p>
      </td>

      <td colspan="1" rowspan="1">
        <p>
          This adjusts the current date the given number of days into the past.
          Example: 0 for today, 1 for yesterday.
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>Aging Method</p>
      </td>

      <td colspan="1" rowspan="1">
        <p>Select aging method.</p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>Days Per Aging Period</p>
      </td>

      <td colspan="1" rowspan="1">
        <p>Enter the number of days per aging period.</p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>Number of Periods</p>
      </td>

      <td colspan="1" rowspan="1">
        <p>Enter the number of aging periods to be shown in the report.</p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>Due Date Duration</p>
      </td>

      <td colspan="1" rowspan="1">
        <p>
          Select the due date duration for the report (a Single Date, or a Date
          Range).
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>Transaction Date Duration</p>
      </td>

      <td colspan="1" rowspan="1">
        <p>Select the transaction date range for the report.</p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>Accounting Method</p>
      </td>

      <td colspan="1" rowspan="1">
        <p>Select the desired accounting method.</p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>Summarize Column By</p>
      </td>

      <td colspan="1" rowspan="1">
        <p>
          Select how you want your report data to be broken down. For example,
          if you select <b>Month</b>, your report data is broken down by month.
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>Account Receivable Paid Status</p>
      </td>

      <td colspan="1" rowspan="1">
        <p>Select account receivable paid status.</p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>Select Columns</p>
      </td>

      <td colspan="1" rowspan="1">
        <p>
          Check this to be given an option, otherwise a default selection will
          be given. Schema will always be maintained, even if selections are
          changed. Note - this is for advanced users as QuickBooks may return
          errors based on column selection.
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p>Enable Pivot Parsing</p>
      </td>

      <td colspan="1" rowspan="1">
        <p>
          Select whether you want to pivot your report data by the selected{" "}
          <b>Summarize Column By</b> value.
        </p>
      </td>
    </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](/s/article/360042926274).

## Troubleshooting

Issues with this connector are minimal. However, the connector retrieves the reports from Quickbooks exactly as they appear. If you change a report for an ad-hoc analysis inside Quickbooks, that change is reflected in the report. A good solution to this problem is to use a system user that has standard reports in Quickbooks.

A few users have reported having their Quickbooks Online accounts become unauthorized. If this happens, manually disconnect Domo in the Quickbooks website then reconnect to QuickBooks through Domo by adding the account again.
