ComposioHQ/QuickBooks-Automation

QuickBooks Automation

QuickBooks Online の操作を自動化し、請求書の作成、顧客管理、勘定科目の照会、請求書一覧の取得などを通じて財務報告を効率化します。

ツールキットドキュメント: composio.dev/toolkits/quickbooks

---

セットアップ

このスキルを使用するには、https://rube.app/mcp に接続された Rube MCP サーバー が必要です。

ツールを実行する前に、quickbooks ツールキットに対するアクティブな接続が存在することを確認してください。接続がアクティブでない場合は、RUBE_MANAGE_CONNECTIONS を介して接続を開始します。

---

コアワークフロー

1. 請求書の作成

顧客向けに明細行を含む新しい請求書を作成します。

ツール: QUICKBOOKS_CREATE_INVOICE

主要パラメータ:

• customer_id (必須) -- 顧客の ID (CustomerRef.value)
• lines (必須) -- 明細行オブジェクトの配列。各オブジェクトには次のものを含める必要があります:
  • DetailType -- 例: "SalesItemLineDetail"
  • Amount -- 明細行の合計金額
  • SalesItemLineDetail -- ItemRef を含むオブジェクト。value (アイテム ID) を指定します
• minorversion -- オプションの API バージョンパラメータ

例:

ツール: QUICKBOOKS_CREATE_INVOICE
引数:
  customer_id: "21"
  lines: [
    {
      "DetailType": "SalesItemLineDetail",
      "Amount": 150.00,
      "SalesItemLineDetail": {
        "ItemRef": {"value": "1", "name": "Services"}
      }
    }
  ]

前提条件: QUICKBOOKS_READ_CUSTOMER を使用して顧客 ID を解決するか、QUICKBOOKS_CREATE_CUSTOMER で新しい顧客を作成します。QUICKBOOKS_QUERY_ACCOUNT を使用してアイテム/勘定科目 ID を解決します。

---

2. 顧客の管理

顧客レコードの作成と読み取りを行います。

ツール:

• QUICKBOOKS_CREATE_CUSTOMER -- 新しい顧客を作成します
• QUICKBOOKS_READ_CUSTOMER -- ID で顧客を読み取ります

QUICKBOOKS_CREATE_CUSTOMER の主要パラメータ:

• display_name -- 表示名 (顧客、ベンダー、従業員間で一意である必要があります。最大 500 文字)
• given_name -- 名 (最大 100 文字)
• family_name -- 姓 (最大 100 文字)
• middle_name -- ミドルネーム (最大 100 文字)
• title -- 敬称。例: "Mr.", "Dr." (最大 16 文字)
• suffix -- 名前の接尾辞。例: "Jr." (最大 16 文字)

display_name、title、given_name、middle_name、family_name、suffix のうち少なくとも 1 つが必要です。

QUICKBOOKS_READ_CUSTOMER の主要パラメータ:

• customer_id (必須) -- 読み取る顧客の ID

例:

ツール: QUICKBOOKS_CREATE_CUSTOMER
引数:
  display_name: "Acme Corporation"
  given_name: "John"
  family_name: "Doe"

---

3. 勘定科目の照会と読み取り

請求書の明細行や財務報告で使用する勘定科目情報を取得します。

ツール:

• QUICKBOOKS_QUERY_ACCOUNT -- 勘定科目に対するクエリを実行します
• QUICKBOOKS_READ_ACCOUNT -- ID で特定の勘定科目を読み取ります

QUICKBOOKS_QUERY_ACCOUNT の主要パラメータ:

• query (必須) -- SQL ライクなクエリ文字列。例: "SELECT * FROM Account WHERE AccountType = 'Income'"

例:

ツール: QUICKBOOKS_QUERY_ACCOUNT
引数:
  query: "SELECT * FROM Account WHERE AccountType = 'Income' MAXRESULTS 10"

---

4. 請求書の一覧表示とフィルタリング

オプションのページネーションとフィルタリングを使用して請求書を取得します。

ツール: QUICKBOOKS_LIST_INVOICES

手順:

1. ページネーションパラメータを指定して QUICKBOOKS_LIST_INVOICES を呼び出します
2. start_position と max_results を使用して結果をページングします
3. 必要に応じて特定の条件でフィルタリングします

---

推奨実行計画

1. QUICKBOOKS_READ_CUSTOMER を使用して顧客を解決します（顧客 ID がある場合）。または QUICKBOOKS_CREATE_CUSTOMER で新しい顧客を作成します
2. QUICKBOOKS_QUERY_ACCOUNT と QUICKBOOKS_READ_ACCOUNT を使用してアイテム/収益勘定科目を解決し、請求書の明細行に使用する勘定科目 ID またはアイテム ID を取得します
3. 解決した customer_id と適切な明細行を使用して QUICKBOOKS_CREATE_INVOICE で請求書を作成します
4. QUICKBOOKS_LIST_INVOICES を使用して作成を確認し、ID または DocNumber で新しい請求書を特定します

---

既知の落とし穴

落とし穴	詳細
無効な参照	customer_id または ItemRef.value が存在しない、または無効なレコードを参照している場合、QUICKBOOKS_CREATE_INVOICE は失敗します。常に事前に ID を解決してください。
明細行の検証	DetailType が間違っている、または SalesItemLineDetail フィールドが欠落している場合、請求書作成時にスキーマ/検証エラーが発生します。
ページネーション	QUICKBOOKS_LIST_INVOICES は start_position と max_results を使用します。ページネーション設定が不完全だと、大規模な帳簿で請求書を見逃す可能性があります。
同期トークン	後で編集を行うには、最新の請求書読み取りから最新の SyncToken が必要です。古い同期トークンは更新を拒否されます。
レート制限	QuickBooks は 1 分あたりおよび 1 日あたりの API 制限を適用します。大量実行時はスロットリングエラーを回避するためにバックオフを含めてください。
DisplayName の一意性	顧客の display_name は、すべての顧客、ベンダー、従業員オブジェクト間で一意である必要があります。重複があると作成に失敗します。

---

クイックリファレンス

ツールスラッグ	説明
QUICKBOOKS_CREATE_INVOICE	明細行を含む新しい請求書を作成します
QUICKBOOKS_READ_CUSTOMER	ID で顧客レコードを読み取ります
QUICKBOOKS_CREATE_CUSTOMER	新しい顧客レコードを作成します
QUICKBOOKS_QUERY_ACCOUNT	SQL ライクな構文で勘定科目を照会します
QUICKBOOKS_READ_ACCOUNT	ID で特定の勘定科目を読み取ります
QUICKBOOKS_LIST_INVOICES	ページネーション付きで請求書を一覧表示します

---

Powered by Composio