View a markdown version of this page

QuickBooks の統合 - Amazon Quick
[開始する前に]QuickBooks の設定Amazon Quick でのコネクタのセットアップ使用可能なアクションの管理とトラブルシューティング

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

QuickBooks の統合

QuickBooks アクションコネクタを使用すると、自然言語を通じて Amazon Quick で QuickBooks Online に直接アクセスできます。Amazon Quick を離れることなく、請求書、顧客、ベンダー、アカウントを管理し、財務レポートを生成できます。

Amazon Quick は、QuickBooks の複数の認証方法をサポートしています。組織のセキュリティ要件に最適な方法を選択します。

  • デフォルトの OAuth アプリケーション – AWSが管理する OAuth アプリケーションを使用します。追加の認証情報は必要ありません。ユーザーは Intuit アカウントで直接認証します。

  • カスタム OAuth アプリ – Intuit 開発者ポータルに登録されているカスタマーマネージドアプリケーションを使用します。このオプションを使用すると、組織は OAuth 設定を完全に制御できます。

Amazon Quick がサポートする認証方法の詳細については、「」を参照してください認証方法。

[開始する前に]

統合を設定する前に、以下があることを確認してください。

QuickBooks の設定

デフォルトの OAuth アプリ認証を使用している場合は、このセクションをスキップして に進みますAmazon Quick でのコネクタのセットアップ。

カスタム OAuth アプリ認証の場合は、Amazon Quick を設定する前に、Intuit 開発者ポータルで次の手順を実行します。

Intuit Developer アプリを作成する (カスタム OAuth アプリ)

Intuit Developer ポータルでアプリケーションを作成し、Amazon Quick に必要なクライアント認証情報を取得します。詳細については、Intuit Developer ウェブサイトのOAuth 2.0」を参照してください。

  1. Intuit ウェブサイトの Intuit Developer ポータルにサインインします。

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

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

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

  5. アクセス許可については、QuickBooks Online および Payments で、統合に必要な認可スコープを選択します。推奨されるスコープについては、「」を参照してください推奨されるスコープ。

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

  7. 次の値を記録します。Amazon Quick を設定するときに必要になります。

    • クライアント ID

    • クライアントシークレット

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

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

推奨されるスコープ

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 でのコネクタのセットアップ

使用可能なタブから接続する

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

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

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

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

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

チームの作成タブから を作成する

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

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

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

  3. QuickBooks を検索して選択します。

    注記

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

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

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

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

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

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

    2. カスタム 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 があらかじめ入力されています。

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

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

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

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

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

使用可能なアクション

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

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

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

の管理とトラブルシューティング

コネクタを編集、共有、または削除するには、「」を参照してください既存の統合の管理。

認証問題

  • サインインが失敗する (デフォルトの OAuth アプリまたはカスタム OAuth アプリ) – Intuit アカウントがアクティブであり、Intuit ウェブサイトで quickbooks.intuit.com に直接サインインできることを確認します。カスタム OAuth アプリの場合、Intuit Developer アプリのリダイレクト URI が Amazon Quick コールバック URL と一致することを確認します。

  • 無効なクライアント認証情報 (カスタム OAuth アプリ) – クライアント ID とクライアントシークレットが Intuit Developer アプリの値と一致していることを確認します。認証情報は、Intuit デベロッパーポータルのアプリ設定から表示できます。

  • アクセス許可が不十分 – Intuit Developer アプリ用に設定されたスコープに、使用するアクションに必要なアクセス許可が含まれていることを確認します。「推奨されるスコープ」を参照してください。