View a markdown version of this page

QuickBooks 整合 - Amazon Quick
开始前的准备工作正在配置 QuickBooks在 Amazon Quick 中设置连接器可用操作管理和故障排除

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

QuickBooks 整合

使用 QuickBooks 操作连接器，您可以直接在 Amazon Quick 中通过自然语言访问在 QuickBooks 线。您无需离开 Amazon Quick 即可管理发票、客户、供应商、账户并生成财务报告。

Amazon Quick 支持多种身份验证方法 QuickBooks。选择最适合您组织安全要求的方法。

  • 默认 OAuth 应用程序-使用 AWS由托管的 OAuth 应用程序。无需其他凭证。用户直接使用其 Intuit 帐户进行身份验证。

  • 自定义 OAuth 应用程序-使用在 Intuit 开发者门户中注册的客户管理应用程序。此选项可让您的组织完全控制 OAuth 配置。

有关 Amazon Quick 支持的身份验证方法的更多信息，请参阅身份验证方法。

开始前的准备工作

在设置集成之前，请确保您具备以下条件。

  • 一个有效的 QuickBooks 在线帐户，可以访问您要使用的公司数据。

  • 对于自定义 OAuth 应用程序：访问 Intuit 网站上的 Intuit 开发者门户以创建应用程序。

  • 有关 Amazon Quick 订阅要求，请参阅在控制台中设置集成。

正在配置 QuickBooks

如果您使用的是默认 OAuth 应用程序身份验证，请跳过本节并继续。在 Amazon Quick 中设置连接器

要进行自定义 OAuth 应用程序身份验证，请在配置 Amazon Quick 之前在 Intuit 开发者门户中完成以下步骤。

创建 Intuit 开发者应用程序（自定义 OAuth 应用程序）

在 Intuit 开发者门户中创建应用程序，以获取 Amazon Quick 所需的客户证书。有关更多信息，请参阅 Intuit 开发者网站上的 OAuth 2.0。

  1. 在 Intui t 网站上登录 Intuit 开发者门户。

  2. 在工作区中，选择加号 (+) 按钮以创建新应用程序。

  3. 在 “类型” 中，选择 QuickBooks 在线平台。

  4. 输入应用程序的应用程序名称。

  5. 对于权限，在 “QuickBooks 在线和付款” 下，选择您的集成所需的授权范围。有关推荐的范围，请参阅推荐瞄准镜。

  6. 完成应用程序创建。在确认页面上，选择显示凭证以查看您的开发凭证。

  7. 记录以下值。在配置 Amazon Quick 时，您需要它们。

    • 客户端 ID

    • 客户端密钥

  8. 在应用程序设置中，选择重定向 URI 选项卡。添加 Amazon 快速回传 URL：https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

  9. 选择保存。

推荐瞄准镜

创建 Intuit Developer 应用程序时，请根据要使用的操作选择以下授权范围。

QuickBooks 推荐瞄准镜
Scope 说明
com.intuit.quickbooks.accounting 访问 QuickBooks 在线会计数据，包括发票、客户、供应商、账户和财务报告。
com.intuit.quickbooks.payment 访问 QuickBooks 在线支付数据，包括购买和付款交易。
openid 验证用户的身份。
email 读取用户的电子邮件地址。
profile 读取用户的个人资料信息。
phone 读取用户的电话号码。
address 读取用户的地址。
注意

openid、、emailprofilephone、和address范围用于通过自定义 OAuth 应用程序进行用户身份验证。

在 Amazon Quick 中设置连接器

从 “可用” 选项卡连接

如果要使用默认 OAuth 应用程序身份验证，则无需额外配置即可直接从 “可用” 选项卡进行连接。

  1. 在 Amazon Quick 控制台中，选择连接器。

  2. 在 “可用” 选项卡上，找到QuickBooks并选择 Connect。

  3. 完成 QuickBooks 登录流程并授予所请求的权限。

要改为使用自定义 OAuth 应用程序配置连接器，请使用为团队创建选项卡，如下所述。

从 “为你的团队创建” 选项卡中创建

完成所有必需的 QuickBooks 配置后，请在 Amazon Quick 中创建连接器。

  1. 在 Amazon Quick 控制台中，选择连接器。

  2. 选择 “为你的团队创建” 选项卡。

  3. 查找并选择QuickBooks。

    注意

    如果 QuickBooks 连接器已经存在，则会出现一个包含现有连接器的对话框。要使用现有的连接器，请选择它。要创建新的，请选择 “否，新建”。

  4. 输入连接器的名称。（可选）选择 + 添加描述以添加描述。

  5. 对于连接类型，选择公共网络。

  6. 对于 OAuth 配置，请选择以下身份验证方法之一并配置必填字段。

    1. 对于默认 OAuth 应用程序：

      无需其他凭证。选择下一步以继续。

    2. 对于自定义 OAuth 应用程序，请配置以下字段：

      • 基本网址（可选）— QuickBooks API 基础网址。示例：https://quickbooks.api.intuit.com

      • 客户端 ID — 来自 Intuit 开发者应用程序的客户端 ID。

      • 客户端密钥-来自 Intuit 开发者应用程序的客户端密钥。

      • 令牌网址-令牌端点。示例：https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer

      • 授权 URL-授权端点。示例：https://appcenter.intuit.com/connect/oauth2

      • 重定向 URL — Pre-filled 使用 Amazon 快速回传网址。

  7. 选择下一步。

  8. 如果您选择默认 OAuth 应用程序或自定义 OAuth 应用程序，则会打开 Intui t 授权窗口。查看请求的权限，然后选择 Connect。

  9. 在 “查看” 页面上，查看连接器的可用操作。选择下一步。

  10. 在 “发布” 页面上，选择谁可以访问连接器。您可以为组织中的所有人启用访问权限，也可以搜索特定的团队或群组。

  11. 选择发布。

可用操作

设置连接器后，可以使用以下操作。

QuickBooks 可用操作
类别 处理建议 说明
查询 搜索实体 使用查询跨 QuickBooks 实体进行搜索。
账户 获取账户详情 通过查询检索特定账户的详细信息。
账户 获取账号 按 ID 检索特定账户。
账户 创建账户 在会计科目表中创建新账户。
账单 获取发票 按 ID 检索特定的发票。
账单 列出发票 列出带有可选筛选功能的发票。
账单 创建发票 创建新发票。
Customers 获取客户 按 ID 检索特定客户。
Customers 创建客户 创建新的客户记录。
供应商 创建供应商 创建新的供应商记录。
购买次数 创建购买 创建新的购买交易。
购买次数 创建账单 从供应商处创建新账单。
日记条目 创建日记分录 创建新的日记分录。
Reports 获取损益报告 生成损益报告。
Reports 获取客户余额报告 生成客户余额汇总报告。
Reports 获取客户余额详情 生成详细的客户余额报告。
Reports 获取供应商余额报告 生成供应商余额汇总报告。
Reports 获取供应商余额详情 生成详细的供应商余额报告。
Reports 获取总账报表 生成总账报告。
分批操作 Batch Exute 操作 在单个批处理请求中运行多个操作。
公司 获取公司信息 检索有关关联公司的信息。
注意

您可以使用的操作取决于经过身份验证的用户可以访问的公司数据。

管理和故障排除

要编辑、共享或删除您的连接器，请参阅管理现有集成。

身份验证问题

  • Sign-in 失败（默认 OAuth 应用程序或自定义 OAuth 应用程序）— 确认你的 Intuit 账户处于活动状态，并且可以直接在 Intuit 网站上登录 quickbooks .intuit.com。对于自定义 OAuth 应用程序，请确认您的 Intuit 开发者应用程序中的重定向 URI 与 Amazon Quick 回调网址相匹配。

  • 无效的客户端凭证（自定义 OAuth 应用程序）-验证客户端 ID 和客户端密钥是否与 Intuit 开发者应用程序中的值相匹配。您可以在 Intuit 开发者门户的应用程序设置中查看您的凭据。

  • 权限不足-验证为 Intuit Developer 应用程序配置的范围是否包含您要使用的操作所需的权限。请参阅推荐瞄准镜。