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

# QuickBooks 整合
<a name="quickbooks-integration"></a>

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

Amazon Quick 支持多种身份验证方法 QuickBooks。选择最适合您组织安全要求的方法。
+ **默认 OAuth 应用程序**-使用 AWS由托管的 OAuth 应用程序。无需其他凭证。用户直接使用其 Intuit 帐户进行身份验证。
+ **自定义 OAuth 应用程序**-使用在 Intuit 开发者门户中注册的客户管理应用程序。此选项可让您的组织完全控制 OAuth 配置。

有关 Amazon Quick 支持的身份验证方法的更多信息，请参阅[身份验证方法](quick-action-auth.md)。

## 开始前的准备工作
<a name="quickbooks-integration-prerequisites"></a>

在设置集成之前，请确保您具备以下条件。
+ 一个有效的 QuickBooks 在线帐户，可以访问您要使用的公司数据。
+ 对于**自定义 OAuth 应用程序**：访问 Intuit 网站上[的 Intuit 开发者门户](https://developer.intuit.com/)以创建应用程序。
+ 有关 Amazon Quick 订阅要求，请参阅[在控制台中设置集成](integration-console-setup-process.md)。

## 正在配置 QuickBooks
<a name="quickbooks-source-setup"></a>

如果您使用的是**默认 OAuth 应用程序**身份验证，请跳过本节并继续。[在 Amazon Quick 中设置连接器](#quickbooks-quicksuite-setup)

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

### 创建 Intuit 开发者应用程序（自定义 OAuth 应用程序）
<a name="quickbooks-register-oauth"></a>

在 Intuit 开发者门户中创建应用程序，以获取 Amazon Quick 所需的客户证书。有关更多信息，请参阅 Intuit 开发者网站上的 [OAuth 2.0](https://developer.intuit.com/app/developer/qbo/docs/develop/authentication-and-authorization/oauth-2.0)。

1. 在 Intui [t 网站上登录 Intuit 开发者门户](https://developer.intuit.com/)。

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

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

1. 输入**应用程序的应用程序名称**。

1. 对于**权限**，在 “**QuickBooks 在线和付款**” 下，选择您的集成所需的授权范围。有关推荐的范围，请参阅[推荐瞄准镜](#quickbooks-oauth-scopes)。

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

1. 记录以下值。在配置 Amazon Quick 时，您需要它们。
   + **客户端 ID**
   + **客户端密钥**

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

1. 选择**保存**。

### 推荐瞄准镜
<a name="quickbooks-oauth-scopes"></a>

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


**QuickBooks 推荐瞄准镜**  

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

**注意**  
`openid`、、`email``profile``phone`、和`address`范围用于通过自定义 OAuth 应用程序进行用户身份验证。

## 在 Amazon Quick 中设置连接器
<a name="quickbooks-quicksuite-setup"></a>

### 从 “可用” 选项卡连接
<a name="quickbooks-quick-connect"></a>

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

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

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

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

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

### 从 “为你的团队创建” 选项卡中创建
<a name="quickbooks-full-setup"></a>

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

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

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

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

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

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

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

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

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

   1. 对于**自定义 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 快速回传网址。

1. 选择**下一步**。

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

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

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

1. 选择**发布**。

## 可用操作
<a name="quickbooks-integration-actions"></a>

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


**QuickBooks 可用操作**  

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

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

## 管理和故障排除
<a name="quickbooks-integration-troubleshooting"></a>

要编辑、共享或删除您的连接器，请参阅[管理现有集成](integration-workflows.md#managing-existing-integrations)。

### 身份验证问题
<a name="quickbooks-troubleshooting-auth"></a>
+ **Sign-in 失败（默认 OAuth 应用程序或自定义 OAuth 应用程序）**— 确认你的 Intuit 账户处于活动状态，并且可以直接在 Intuit 网站上登录 [quickbooks](https://quickbooks.intuit.com) .intuit.com。对于自定义 OAuth 应用程序，请确认您的 Intuit 开发者应用程序中的重定向 URI 与 Amazon Quick 回调网址相匹配。
+ **无效的客户端凭证（自定义 OAuth 应用程序）**-验证客户端 ID 和客户端密钥是否与 Intuit 开发者应用程序中的值相匹配。您可以在 Intuit 开发者门户的应用程序设置中查看您的凭据。
+ **权限不足**-验证为 Intuit Developer 应用程序配置的范围是否包含您要使用的操作所需的权限。请参阅[推荐瞄准镜](#quickbooks-oauth-scopes)。