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 應用程式身分驗證，請先在 Intuit 開發人員入口網站中完成下列步驟，再設定 Amazon Quick。

建立 Intuit 開發人員應用程式 （自訂 OAuth 應用程式）

在 Intuit 開發人員入口網站中建立應用程式，以取得 Amazon Quick 所需的用戶端登入資料。如需詳細資訊，請參閱 Intuit 開發人員網站上的 OAuth 2.0。

  1. 登入 Intuit 網站上的 Intuit 開發人員入口網站。

  2. 在工作區中，選擇加號 (＋) 按鈕以建立新的應用程式。

  3. 針對類型，選取 QuickBooks Online 平台。

  4. 輸入您應用程式的應用程式名稱。

  5. 針對許可，在 QuickBooks Online 和 Payments 下，選取整合所需的授權範圍。如需建議的範圍，請參閱 建議範圍。

  6. 完成應用程式建立。在確認頁面上，選擇顯示登入資料以檢視您的開發登入資料。

  7. 記錄下列值。您在設定 Amazon Quick 時需要它們。

    • 用戶端 ID

    • Client secret (用戶端密碼)

  8. 在應用程式設定中，選擇重新導向 URIs索引標籤。新增 Amazon Quick 回呼 URL： https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

  9. 選擇儲存。

建議範圍

當您建立 Intuit 開發人員應用程式時，請根據您要使用的動作選取下列授權範圍。

QuickBooks 建議的範圍
Scope (範圍) Description
com.intuit.quickbooks.accounting 存取 QuickBooks Online 會計資料，包括發票、客戶、廠商、帳戶和財務報告。
com.intuit.quickbooks.payment 存取 QuickBooks Online 付款資料，包括購買和付款交易。
openid 驗證使用者的身分。
email 讀取使用者的電子郵件地址。
profile 讀取使用者的設定檔資訊。
phone 讀取使用者的電話號碼。
address 讀取使用者的地址。
注意

openid、email、phone、 profile和 address範圍用於使用自訂 OAuth 應用程式進行使用者身分驗證。

在 Amazon Quick 中設定連接器

從可用索引標籤連線

如果您想要使用預設 OAuth 應用程式身分驗證，您可以直接從可用索引標籤連線，而不需要其他組態。

  1. 在 Amazon Quick 主控台中，選擇連接器。

  2. 在可用索引標籤上，尋找 QuickBooks 並選擇連線。

  3. 完成 QuickBooks 登入流程並授予請求的許可。

若要改為使用自訂 OAuth 應用程式設定連接器，請使用為您的團隊建立索引標籤，如下所述。

從為您的團隊建立索引標籤建立

完成任何必要的 QuickBooks 組態後，請在 Amazon Quick 中建立連接器。

  1. 在 Amazon Quick 主控台中，選擇連接器。

  2. 選擇為您的團隊建立索引標籤。

  3. 尋找並選擇 QuickBooks。

    注意

    如果 QuickBooks 連接器已存在，則會顯示一個對話方塊，其中包含您現有的連接器。若要使用現有的連接器，請選擇它。若要建立新的，請選擇否，建立新的。

  4. 輸入連接器的名稱。或者，選擇 + 新增描述以新增描述。

  5. 針對連線類型，選擇公有網路。

  6. 針對 OAuth 組態，選擇下列其中一種身分驗證方法，並設定必要欄位。

    1. 對於預設 OAuth 應用程式：

      不需要額外的登入資料。選擇 Next (下一步) 繼續。

    2. 對於自訂 OAuth 應用程式，請設定下列欄位：

      • 基本 URL （選用） – QuickBooks API 基本 URL。範例：https://quickbooks.api.intuit.com

      • 用戶端 ID – 來自 Intuit 開發人員應用程式的用戶端 ID。

      • 用戶端秘密 – 來自 Intuit 開發人員應用程式的用戶端秘密。

      • 權杖 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 授權視窗。檢閱請求的許可，然後選擇連線。

  9. 在檢閱頁面上，檢閱連接器的可用動作。選擇下一步。

  10. 在發佈頁面上，選擇誰可以存取連接器。您可以為組織中的每個人啟用存取權，或搜尋特定的團隊或群組。

  11. 選擇發布。

可用動作

設定連接器之後，可以使用下列動作。

QuickBooks 可用的動作
Category Action Description
查詢 搜尋實體 使用查詢跨 QuickBooks 實體搜尋。
帳戶 取得帳戶詳細資訊 依查詢擷取特定帳戶的詳細資訊。
帳戶 取得帳戶 依 ID 擷取特定帳戶。
帳戶 建立帳戶 在帳戶圖表中建立新帳戶。
發票 取得發票 依 ID 擷取特定發票。
發票 列出發票 列出具有選用篩選的發票。
發票 建立發票 建立新的發票。
客戶 取得客戶 依 ID 擷取特定客戶。
客戶 建立客戶 建立新的客戶記錄。
廠商 建立廠商 建立新的廠商記錄。
購買次數 建立購買 建立新的購買交易。
購買次數 建立帳單 從廠商建立新的帳單。
日誌項目 建立日誌項目 建立新的日誌項目。
報告 取得損益報告 產生損益報告。
報告 取得客戶餘額報告 產生客戶餘額摘要報告。
報告 取得客戶餘額詳細資訊 產生詳細的客戶餘額報告。
報告 取得廠商餘額報告 產生廠商餘額摘要報告。
報告 取得廠商餘額詳細資訊 產生詳細的廠商餘額報告。
報告 取得一般分類帳報告 產生總帳報告。
批次操作 批次執行操作 在單一批次請求中執行多個操作。
公司 取得公司資訊 擷取連線公司的相關資訊。
注意

您可以使用的動作取決於已驗證使用者可存取的公司資料。

管理和疑難排解

若要編輯、共用或刪除連接器，請參閱 管理現有的整合。

驗證問題

  • 登入失敗 （預設 OAuth 應用程式或自訂 OAuth 應用程式） – 確認您的 Intuit 帳戶處於作用中狀態，而且您可以直接在 Intuit 網站上登入 quickbooks.intuit.com。對於自訂 OAuth 應用程式，請確認 Intuit 開發人員應用程式中的重新導向 URI 符合 Amazon Quick 回呼 URL。

  • 無效用戶端登入資料 （自訂 OAuth 應用程式） – 驗證用戶端 ID 和用戶端秘密是否符合 Intuit 開發人員應用程式中的值。您可以從 Intuit 開發人員入口網站中的應用程式設定檢視您的登入資料。

  • 許可不足 – 確認為 Intuit 開發人員應用程式設定的範圍包含您想要使用的動作所需的許可。請參閱建議範圍。