翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

QuickBooks アクションコネクタを使用すると、自然言語を通じて Amazon Quick で QuickBooks Online に直接アクセスできます。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 Online アカウント。
+ **カスタム OAuth アプリ**の場合: [Intuit ウェブサイトの Intuit Developer ポータル](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 Developer アプリを作成する (カスタム OAuth アプリ)
<a name="quickbooks-register-oauth"></a>

Intuit Developer ポータルでアプリケーションを作成し、Amazon Quick に必要なクライアント認証情報を取得します。詳細については、Intuit Developer ウェブサイトの[OAuth 2.0](https://developer.intuit.com/app/developer/qbo/docs/develop/authentication-and-authorization/oauth-2.0)」を参照してください。

1. [Intuit ウェブサイトの Intuit Developer ポータル](https://developer.intuit.com/)にサインインします。

1. ワークスペースからプラス (\+) ボタンを選択して、新しいアプリを作成します。

1. **Type** で、QuickBooks Online プラットフォームを選択します。

1. アプリケーションの**アプリケーション名**を入力します。

1. アクセス**許可**については、**QuickBooks Online および Payments** で、統合に必要な認可スコープを選択します。推奨されるスコープについては、「」を参照してください[推奨されるスコープ](#quickbooks-oauth-scopes)。

1. アプリの作成を完了します。確認ページで、**認証情報を表示**を選択して開発認証情報を表示します。

1. 次の値を記録します。Amazon Quick を設定するときに必要になります。
   + **クライアント ID**
   + **クライアントシークレット**

1. アプリ設定で、**リダイレクト URIs **タブを選択します。Amazon Quick コールバック URL を追加します。 `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`

1. **[保存]** を選択します。

### 推奨されるスコープ
<a name="quickbooks-oauth-scopes"></a>

Intuit Developer アプリを作成するときは、使用するアクションに基づいて次の認可スコープを選択します。


**QuickBooks の推奨スコープ**  

| スコープ | 説明 | 
| --- | --- | 
| com.intuit.quickbooks.accounting | 請求書、顧客、ベンダー、アカウント、財務レポートなど、QuickBooks Online の会計データにアクセスします。 | 
| com.intuit.quickbooks.payment | 購入や支払いトランザクションなど、QuickBooks Online の支払いデータにアクセスします。 | 
| openid | ユーザーの ID を認証します。 | 
| email | ユーザーの E メールアドレスを読み取ります。 | 
| profile | ユーザーのプロファイル情報を読み取ります。 | 
| phone | ユーザーの電話番号を読み取ります。 | 
| address | ユーザーのアドレスを読み取ります。 | 

**注記**  
`openid`、`email`、`profile`、`phone`、および `address`スコープは、カスタム OAuth アプリでのユーザー認証に使用されます。

## Amazon Quick でのコネクタのセットアップ
<a name="quickbooks-quicksuite-setup"></a>

### 使用可能なタブから接続する
<a name="quickbooks-quick-connect"></a>

デフォルトの OAuth アプリ認証を使用する場合は、追加設定なしで **Available** タブから直接接続できます。

1. Amazon Quick コンソールで、**コネクタ**を選択します。

1. **使用可能**タブで、**QuickBooks** を検索し、**接続**を選択します。

1. QuickBooks のサインインフローを完了し、リクエストされたアクセス許可を付与します。

代わりにカスタム OAuth アプリでコネクタを設定するには、以下で説明するように**チーム用に作成**タブを使用します。

### チームの作成タブから を作成する
<a name="quickbooks-full-setup"></a>

必要な QuickBooks 設定が完了したら、Amazon Quick でコネクタを作成します。

1. Amazon Quick コンソールで、**コネクタ**を選択します。

1. **チームの作成**タブを選択します。

1. **QuickBooks** を検索して選択します。
**注記**  
QuickBooks コネクタが既に存在する場合は、既存のコネクタを含むダイアログが表示されます。既存のコネクタを使用するには、コネクタを選択します。新しいものを作成するには、**「いいえ」を選択し、新しいものを作成します**。

1. コネクタ**の名前**を入力します。必要に応じて、 **\+ 説明**を追加 を選択して説明を追加します。

1. Connection **type** で、**Public network** を選択します。

1. **OAuth 設定では**、次のいずれかの認証方法を選択し、必須フィールドを設定します。

   1. **デフォルトの OAuth アプリ**の場合:

      追加の認証情報は必要ありません。**[次へ]** を選択して続行します。

   1. **カスタム OAuth アプリ**の場合は、次のフィールドを設定します。
      + **ベース URL** (オプション) – QuickBooks API ベース URL。例: `https://quickbooks.api.intuit.com`
      + **クライアント ID** – Intuit Developer アプリのクライアント ID。
      + **クライアントシーク**レット – Intuit Developer アプリからのクライアントシークレット。
      + **トークン URL** – トークンエンドポイント。例: `https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer`
      + **認可 URL** – 認可エンドポイント。例: `https://appcenter.intuit.com/connect/oauth2`
      + **リダイレクト URL** – Amazon Quick コールバック URL があらかじめ入力されています。

1. [**次へ**] を選択します。

1. **デフォルトの OAuth アプリ**または**カスタム OAuth アプリ**を選択した場合、Intuit 認可ウィンドウが開きます。リクエストされたアクセス許可を確認し、**Connect** を選択します。

1. **レビュー**ページで、コネクタで使用可能なアクションを確認します。[**次へ**] を選択します。

1. **公開**ページで、コネクタにアクセスできるユーザーを選択します。組織内のすべてのユーザーに対してアクセスを有効にしたり、特定のチームやグループを検索したりできます。

1. **[公開]** を選択します。

## 使用可能なアクション
<a name="quickbooks-integration-actions"></a>

コネクタを設定すると、次のアクションを使用できます。


**QuickBooks で使用可能なアクション**  

| Category | [アクション] | 説明 | 
| --- | --- | --- | 
| クエリ | エンティティの検索 | クエリを使用して QuickBooks エンティティを検索します。 | 
| アカウント | アカウントの詳細を取得する | クエリによって特定のアカウントの詳細を取得します。 | 
| アカウント | アカウントの取得 | ID で特定のアカウントを取得します。 | 
| アカウント | アカウントの作成 | アカウントのグラフに新しいアカウントを作成します。 | 
| 請求書 | 請求書の取得 | ID で特定の請求書を取得します。 | 
| 請求書 | 請求書を一覧表示する | オプションのフィルタリングを使用して請求書を一覧表示します。 | 
| 請求書 | 請求書の作成 | 新しい請求書を作成します。 | 
| お客様 | 顧客を取得する | ID で特定の顧客を取得します。 | 
| お客様 | 顧客を作成する | 新しい顧客レコードを作成します。 | 
| ベンダー | ベンダーの作成 | 新しいベンダーレコードを作成します。 | 
| 購入 | 購入の作成 | 新しい購入トランザクションを作成します。 | 
| 購入 | 請求書の作成 | ベンダーから新しい請求書を作成します。 | 
| ジャーナルエントリ | ジャーナルエントリの作成 | 新しいジャーナルエントリを作成します。 | 
| レポート | 損益レポートの取得 | 損益レポートを生成します。 | 
| レポート | 顧客残高レポートの取得 | 顧客残高の概要レポートを生成します。 | 
| レポート | 顧客残高の詳細を取得する | 詳細な顧客残高レポートを生成します。 | 
| レポート | ベンダー残高レポートの取得 | ベンダー残高の概要レポートを生成します。 | 
| レポート | ベンダー残高の詳細を取得する | 詳細なベンダー残高レポートを生成します。 | 
| レポート | 一般的な台帳レポートを取得する | 総勘定元帳レポートを生成します。 | 
| バッチオペレーション | バッチ実行オペレーション | 1 つのバッチリクエストで複数のオペレーションを実行します。 | 
| Company | 会社情報の取得 | 接続された会社に関する情報を取得します。 | 

**注記**  
使用できるアクションは、認証されたユーザーがアクセスできる企業データによって異なります。

## の管理とトラブルシューティング
<a name="quickbooks-integration-troubleshooting"></a>

コネクタを編集、共有、または削除するには、「」を参照してください[既存の統合の管理](integration-workflows.md#managing-existing-integrations)。

### 認証問題
<a name="quickbooks-troubleshooting-auth"></a>
+ **サインインが失敗する (デフォルトの OAuth アプリまたはカスタム OAuth アプリ)** – Intuit アカウントがアクティブであり、Intuit ウェブサイトで [quickbooks.intuit.com](https://quickbooks.intuit.com) に直接サインインできることを確認します。カスタム OAuth アプリの場合、Intuit Developer アプリのリダイレクト URI が Amazon Quick コールバック URL と一致することを確認します。
+ **無効なクライアント認証情報 (カスタム OAuth アプリ)** – クライアント ID とクライアントシークレットが Intuit Developer アプリの値と一致していることを確認します。認証情報は、Intuit デベロッパーポータルのアプリ設定から表示できます。
+ **アクセス許可が不十分** – Intuit Developer アプリ用に設定されたスコープに、使用するアクションに必要なアクセス許可が含まれていることを確認します。「[推奨されるスコープ](#quickbooks-oauth-scopes)」を参照してください。