Intuit QuickBooks Online

本文介绍如何将 Tableau 连接到 Intuit QuickBooks Online 数据并设置数据源。

注意:Tableau 正在开发替换连接器。完成后,它将添加到此页面。

警告:自 2023.1 版本起,Intuit QuickBooks 连接器已弃用。您可以使用该连接器,直至其停用为止。一旦连接器停用,它就会从 Tableau 用户界面中移除,使用该连接器的任何数据源将不再按预期工作。已弃用的连接器将在替换连接器推出后的 1-2 个版本中停用。

注意:有关此连接器的最新信息,请参见适用于当前版本的 Tableau 的 Intuit QuickBooks Online 帮助主题。

开始之前

在开始之前,请收集以下连接信息:

  • 您的 QuickBooks Online 帐户的电子邮件地址或用户 ID 和密码。

注意:若要将 Tableau 连接到 QuickBooks Online 数据,您必须是 QuickBooks Online 公司的公司管理员。您的公司只有一个管理员可以将 Tableau 连接到 QuickBooks Online。

QuickBooks Online 不支持检索库存调整事务。有关何时可在 QuickBooks Online API 中使用库存调整事务的信息,请参见 Intuit Developer 网站上的问题(链接在新窗口中打开)

进行连接并设置数据源

  1. 启动 Tableau,并在“连接”下选择“Intuit QuickBooks Online”。有关数据连接的完整列表,请在“至服务器”下选择“更多”。在 Tableau 在默认浏览器中打开的选项卡内,请执行以下操作:
    1. 输入您的 QuickBooks Online 帐户的电子邮件地址或用户 ID 和密码。
    2. 选择“登录”

      QuickBooks Online 将定期提示执行双步骤验证。如果发生这种情况,请按照提示获取代码以确认您的 Intuit 帐户。

    3. 如果多个公司与您的帐户相关联,请选择您想要连接到的公司。
    4. 选择“授权”以授权 Intuit 与 Tableau Desktop 安全地共享您的数据。
    5. 如果 Tableau 无法建立连接,请验证您的凭据是否正确。如果仍然无法连接,则说明您的计算机在定位服务器时遇到问题。请与您的网络管理员或数据库管理员联系以获得更多帮助。

  2. 在数据源页面上,执行下列操作:

    1. (可选)在页面顶部选择默认数据源名称,然后输入要在 Tableau 中使用的唯一数据源名称。例如,使用可帮助其他数据源用户推断出要连接的数据源的数据源命名约定。

    2. “表”下方,选择一个表并将它拖到画布的顶部。
    3. 选择“工作表 1”标签以开始分析。

      选择工作表标签后,Tableau 将通过创建数据提取来导入数据。请注意,Tableau Desktop 仅支持 QuickBooks Online 数据提取。您可通过刷新数据提取来更新数据。有关详细信息,请参见提取数据

      根据包含的数据量,创建数据提取可能需要一些时间。

使用“Sales and Expenses Line Items”(销售和费用行项目)表创建会计报表

QuickBooks Online 聚合创建各种报表所需的信息,例如损益 (P&L) 表和资产负债表。由于数据是由 QuickBooks Online 聚合的,因此您无法在 Tableau 中创建这些类型的报表。为了解决此问题,我们在 Tableau 增加了一个“Sales and Expenses Line Items”(销售和费用行项目)表,其中包括创建这些报表所需的行项目明细以及所有字段。

“Sales and Expenses Line Items”(销售和费用行项目)表结构

“Sales and Expenses Line Items”(销售和费用行项目)表包含以下 QuickBooks Online 事务(或文档)的信息:

Bill(账单)

Bill Payment(账单付款)

Credit Memo(贷项通知单)

Deposit(保证金)

Estimate(估值)

Invoice(发票)

Journal Entry(日记账分录)

Payment(付款)

Purchase(采购)

Purchase Order(采购订单)

Refund Receipt(退款收据)

Sales Receipt(销售凭据)

Vendor Credit(供应商贷项)

大多数事务都有子级(或子项目),例如,发票有明细项目。与此示例类似:

某些事务具有组项目,其中包括一组其他行项目。与此示例类似:

“Sales and Expenses Line Items”(销售和费用行项目)表通过为每个项目包括一行,并复制每一行上的事务字段,对“事务到项目”关系进行了反规范化。对于带有子级的组行项目,该表包含组子项目,而不是组。

下图显示了这两张发票如何在 Tableau 中以包含反规范化数据的形式显示:

除事务表之外,“Sales and Expenses Line Items”(销售和费用行项目)表还包含“Account”(账户)的信息。

将各个表与“Sales and Expenses Line Items”(销售和费用行项目)表联接

使用“Sales and Expenses Line Items”(销售和费用行项目)表,您可以将“Account”(帐户)表事务表与其联接,从而为要创建的报表获取所需的详细信息。

若要将“Account”(帐户)表与事务中的每一行联接,请将“Sales and Expenses Line Items”(销售和费用行项目)表中的“[Line Detail Account Ref Value]”(行明细帐户参考值)联接到“帐户”表中的“[ID Account]”(ID 帐户)。

对于 QuickBooks Online 事务表(例如,“Bill”(账单)、“Estimate”(估值)、“Purchase Order”(采购订单)等),请将“Sales and Expenses Line Items”(销售和费用行项目)表中的“[Transaction Type]”(事务类型)+“[ID]”+“[Line ID]”(行 ID)联接到事务表中的等效字段。举例来说,如果创建与“Bill”(账单)事务表的联接,则对于“Bill”要在其上联接的“[ID]”字段为“[(ID) Bill]”;对于“Bill”要在其上联接的“[Line ID]”字段为“[Line ID (Bill)]”,以此类推。

下图左侧显示了“Sales and Expenses Line Items”(销售和费用行项目)表的多个联接,右侧显示了“Account”(帐户)表和“Bill”(账单)表的联接子句。

创建 QuickBooks Online 数据源

利用下面的这些常规步骤,您可以开始建立可用于创建各种报表(例如损益表)的数据源:

  1. 连接到 QuickBooks Online。
  2. “数据源”页面上的“表”下,选择“Sales And Expenses Line Items”(销售和费用行项目)表。
  3. “Sales and Expenses Line Items”(销售和费用行项目)表结构中列出的一个或多个表联接到“Sales And Expenses Line Items”(销售和费用行项目)表,以包括要创建的报表所需的数据。
  4. 创建数据源后,即可构建报表并分析数据。

QuickBooks Online 错误疑难解答

当您尝试将 Tableau 连接到 QuickBooks Online 数据时,您可能会看到以下错误之一。

在以前版本的 Tableau 中保存的工作簿

在 Tableau 版本 2018.2 之前创建的工作簿和数据源将无法访问在更高版本的连接器中添加的表或字段。为了解决此问题,请打开一个新工作簿,并创建与 QuickBooks Online 数据源的新连接。从以前的连接中复制并粘贴要保留的工作表,或在 Tableau 中重新创建它们。

对不起,只有管理员才可以购买应用程序…

QuickBooks Online 要求将应用程序连接到 QuickBooks Online 的每个用户都是公司管理员。如果您不是公司帐户的管理员,则会出现以下 Intuit 错误:

对不起,只有 <电子邮件地址> 的公司管理员才可以在公司中购买应用程序。请与公司管理员联系,或者选择另一家公司。

若要解决此问题,请您的公司帐户所有者将您设置为帐户的公司管理员。

错误代码:app_already_purchased

对于每个应用程序,只允许一个公司管理员进行连接,例如连接到 Tableau Desktop。如果您的公司中的某个人已将 Tableau 连接到您的 QuickBooks Online 帐户,则会出现以下 Intuit 错误:

哎呀!出现了错误。请关闭此窗口,然后重试。

错误代码:app_already_purchased

消息:此公司的另一个用户已订阅该应用程序。请与 <电子邮件地址> 联系以更改此订阅。

若要解决此问题,您需要请该公司管理员放弃 Tableau Desktop 的应用程序权限并将该权限提供给您。如果这不可行,例如因为管理员当前在使用 Tableau,则另一种选择是,让管理员将数据源发布到 Tableau Server 或 Tableau Cloud,以便具有权限的任何人都可以访问该数据。

更改连接会打开我的应用程序页面

如果需要访问另一个 QuickBooks Online 公司,则在您登录之后(可能要经过双步骤身份验证过程),Intuit 可能会显示“我的应用程序”页面,而不是“选择要连接到的公司”页面。若要解决此问题,请执行以下步骤:

  1. 关闭“我的应用程序”页面。

  2. 在 Tableau 的“连接”窗格上,选择“Intuit QuickBooks Online”。

  3. 如果多个公司与您的帐户相关联,请选择您想要连接到的公司。

  4. 选择“授权”以打开 Tableau 数据源页面。

 

另请参见