Zoho Books Automation
Zoho Booksの会計ワークフローを自動化します -- 請求書の作成・管理、請求書や支払いの追跡、取引先の検索、PDFのエクスポート、複数組織の設定など、すべて自然言語で実行できます。
ツールキットドキュメント: composio.dev/toolkits/zoho_books
セットアップ
- Rube MCPサーバーを環境に追加:
https://rube.app/mcp - プロンプトに従ってZoho Booksアカウントを接続（Composio経由のOAuthフロー）
- Zoho Books自動化のための自然言語コマンドを実行開始
コアワークフロー
1. 組織の確認
認証済みユーザーの全組織を取得します。これは、ほぼすべてのエンドポイントで organization_id が必要となるための前提条件です。
ツール: ZOHO_BOOKS_LIST_ORGANIZATIONS
パラメーターは不要です。組織ID、名前、メタデータが返されます。
他のすべてのZoho Booksツールで必要な
organization_idを取得するため、最初に必ずこのツールを呼び出してください。
プロンプト例:
"Zoho Booksの組織を一覧表示して"
2. 請求書の作成と管理
明細行を含む請求書を作成し、既存の請求書を管理し、PDFとしてエクスポートします。
作成: ZOHO_BOOKS_CREATE_INVOICE
主要パラメーター:
organization_id-- 対象の組織（必須）customer_id-- 請求先顧客（必須）line_items-- 明細行の配列（必須）、各項目:item_idまたはname-- 既存アイテムを参照するか、アドホックに明細を作成quantity,rate-- 数量・単価description,tax_id,discount-- オプション詳細
date/due_date-- 日付（YYYY-MM-DD形式）invoice_number-- カスタム番号（ignore_auto_number_generation=trueを設定）discount/discount_type-- 請求書全体の割引（entity_levelまたはitem_level）notes/terms-- 請求書に印刷される注意書き・条件send-- 作成後すぐに請求書をメール送信payment_terms-- 支払い期限日数
一覧: ZOHO_BOOKS_LIST_INVOICES
主要パラメーター:
organization_id（必須）status--sent,draft,overdue,paid,void,unpaid,partially_paid,viewedcustomer_id/customer_name-- 顧客で絞り込みdate_start/date_end-- 日付範囲フィルター（YYYY-MM-DD）search_text-- 請求書番号、参照、顧客名の検索sort_column/sort_order--date,due_date,total,balanceなどで並び替えpage/per_page-- ページネーション（最大200件）
詳細取得: ZOHO_BOOKS_GET_INVOICE -- invoice_id で取得。accept 形式: json, pdf, html
削除: ZOHO_BOOKS_DELETE_INVOICE -- invoice_id で削除
一括エクスポート: ZOHO_BOOKS_BULK_EXPORT_INVOICES_PDF -- 最大25件の請求書を1つのPDFにマージ
一括印刷: ZOHO_BOOKS_BULK_PRINT_INVOICES -- 最大25件の請求書を印刷可能なPDFに結合
プロンプト例:
"顧客ID 1234567890に対して、ウィジェットAを10個（単価$25）、ウィジェットBを5個（単価$50）の2明細の請求書を作成して。支払い期限は30日後に設定"
3. 請求書（買掛）の管理
ベンダー請求書を包括的なフィルターで一覧表示・閲覧・更新します。
一覧: ZOHO_BOOKS_LIST_BILLS
主要パラメーター:
organization_id（必須）status--paid,open,overdue,void,partially_paidvendor_id/vendor_name_contains-- ベンダーで絞り込みbill_number/bill_number_contains-- 請求書番号で絞り込みdate_start/date_end-- 日付範囲フィルターtotal_greater_than/total_less_than-- 金額範囲フィルターsort_column/sort_order--vendor_name,bill_number,date,due_date,totalなどで並び替えpage/per_page-- ページネーション（最大200件）
詳細取得: ZOHO_BOOKS_GET_BILL -- bill_id と organization_id で完全な請求書データを取得
更新: ZOHO_BOOKS_UPDATE_BILL -- 既存の請求書を変更（bill_id, organization_id, vendor_id, bill_number が必要）
プロンプト例:
"組織内の未払い請求書をすべて、支払い期限順に一覧表示して"
4. 取引先の検索
請求書や支払いで使用する取引先（顧客とベンダー）を検索・フィルタリングします。
ツール: ZOHO_BOOKS_LIST_CONTACTS
主要パラメーター:
organization_id（必須）contact_type--customerまたはvendorcontact_name_contains/contact_name_startswith-- 名前フィルターemail_contains/email_startswith-- メールフィルターcompany_name_contains-- 会社名フィルターfilter_by-- ステータスフィルター:Status.Active,Status.Inactive,Status.Duplicateなどsearch_text-- 取引先名またはメモでの検索（最大100文字）sort_column--contact_name,email,outstanding_receivable_amount,created_timeなどで並び替えpage/per_page-- ページネーション（最大200件）
プロンプト例:
"会社名に'Acme'を含むアクティブな顧客をすべて検索して"
5. 請求書の支払い追跡
特定の請求書に対して記録されたすべての支払いを一覧表示します。
ツール: ZOHO_BOOKS_LIST_INVOICE_PAYMENTS
主要パラメーター:
invoice_id-- 確認する請求書（必須）organization_id-- 組織（必須）
請求書に適用されたすべての支払いトランザクション（金額、日付、支払い方法を含む）が返されます。
プロンプト例:
"請求書 451025000000123045 に対するすべての支払い記録を表示して"
6. 完全な請求ワークフロー
ツールを組み合わせたエンドツーエンドの請求書管理:
- 組織:
ZOHO_BOOKS_LIST_ORGANIZATIONS--organization_idを取得 - 取引先:
ZOHO_BOOKS_LIST_CONTACTS--customer_idを検索・確認 - 作成:
ZOHO_BOOKS_CREATE_INVOICE-- 明細行を含む請求書を作成 - 確認:
ZOHO_BOOKS_GET_INVOICE-- 請求書の詳細またはPDFを取得 - 追跡:
ZOHO_BOOKS_LIST_INVOICE_PAYMENTS-- 支払いステータスを監視 - エクスポート:
ZOHO_BOOKS_BULK_EXPORT_INVOICES_PDF-- 記録用に一括エクスポート
プロンプト例:
"'Acme Corp'の顧客IDを見つけて、その顧客向けにコンサルティングサービスの請求書を作成し、その後PDFを取得して"
既知の注意点
| 注意点 | 詳細 |
|---|---|
| Organization ID は常に必須 | ほぼすべてのエンドポイントで organization_id が必要 -- 必ず最初に ZOHO_BOOKS_LIST_ORGANIZATIONS を呼び出すこと |
| 請求書には明細行が必要 | ZOHO_BOOKS_CREATE_INVOICE では、item_id または name を持つ明細行が少なくとも1つ必要 |
| Invoice ID の形式 | invoice_url のエンコードされたIDではなく、請求書オブジェクトの数値 invoice_id（例: 7472322000000264123）を使用 |
| 一括制限 | ZOHO_BOOKS_BULK_EXPORT_INVOICES_PDF と ZOHO_BOOKS_BULK_PRINT_INVOICES は最大25件の請求書IDまで受け付け |
| ページネーション最大200件 | すべての一覧エンドポイントは1ページあたり200レコードが上限 -- 完全な結果を得るにはページを繰り返すこと |
| 請求書の更新には全フィールドが必要 | ZOHO_BOOKS_UPDATE_BILL は、部分更新の場合でも bill_id, organization_id, vendor_id, bill_number が必要 |
| 日付形式 | すべての日付パラメーターは YYYY-MM-DD 形式を使用 |
| response_option は非公開 | ZOHO_BOOKS_LIST_INVOICES には、非公開の response_option パラメーター（0=完全、1=完全+合計、2=件数のみ）が存在し、予告なく変更される可能性あり |
クイックリファレンス
| アクション | ツールスラッグ | 主要パラメーター |
|---|---|---|
| 組織一覧 | ZOHO_BOOKS_LIST_ORGANIZATIONS | （なし） |
| 請求書作成 | ZOHO_BOOKS_CREATE_INVOICE | organization_id, customer_id, line_items |
| 請求書一覧 | ZOHO_BOOKS_LIST_INVOICES | organization_id, status, date_start |
| 請求書取得 | ZOHO_BOOKS_GET_INVOICE | invoice_id, organization_id, accept |
| 請求書削除 | ZOHO_BOOKS_DELETE_INVOICE | invoice_id, organization_id |
| PDF一括エクスポート | ZOHO_BOOKS_BULK_EXPORT_INVOICES_PDF | organization_id, invoice_ids |
| 一括印刷 | ZOHO_BOOKS_BULK_PRINT_INVOICES | organization_id, invoice_ids |
| 請求書一覧（買掛） | ZOHO_BOOKS_LIST_BILLS | organization_id, status, vendor_id |
| 請求書取得（買掛） | ZOHO_BOOKS_GET_BILL | bill_id, organization_id |
| 請求書更新（買掛） | ZOHO_BOOKS_UPDATE_BILL | bill_id, organization_id, vendor_id |
| 取引先一覧 | ZOHO_BOOKS_LIST_CONTACTS | organization_id, contact_type, search_text |
| 支払い一覧 | ZOHO_BOOKS_LIST_INVOICE_PAYMENTS | invoice_id, organization_id |
Powered by Composio