⚡

ZohoBooks自动化Skill ZohoBooksAutomation

Zoho Books自动化技能用于通过自然语言命令自动化Zoho Books会计工作流，包括发票创建、账单管理、联系人查找、支付跟踪和多组织支持。关键词：Zoho Books、自动化、会计工作流、发票管理、账单跟踪、支付系统、财务软件、RPA。

其他 0 次安装 0 次浏览 更新于 3/12/2026

名称: Zoho Books自动化 描述: “通过自然语言命令自动化Zoho Books会计工作流，包括发票创建、账单管理、联系人查找、支付跟踪和多组织支持” 要求: mcp: - rube

Zoho Books自动化

自动化Zoho Books会计工作流——通过自然语言创建和管理发票、跟踪账单和支付、查找联系人、导出PDF以及处理多组织设置。

工具包文档: composio.dev/toolkits/zoho_books

设置

  1. 将Rube MCP服务器添加到您的环境: https://rube.app/mcp
  2. 提示时连接您的Zoho Books账户（通过Composio进行OAuth流程）
  3. 开始发出用于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, viewed
  • customer_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张发票合并为单个PDF

批量打印: ZOHO_BOOKS_BULK_PRINT_INVOICES – 为最多25张发票生成组合打印就绪PDF

示例提示:

“为客户1234567890创建一张发票，包含2个行项目：10个Widget A单价25美元，5个Widget B单价50美元，30天后到期”

3. 跟踪和管理账单

使用全面筛选列出、查看和更新供应商账单。

列表: ZOHO_BOOKS_LIST_BILLS

关键参数:

  • organization_id（必需）
  • status – paid, open, overdue, void, partially_paid
  • vendor_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 或 vendor
  • contact_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. 完整开票工作流

结合工具进行端到端发票管理：

  1. 组织: ZOHO_BOOKS_LIST_ORGANIZATIONS – 获取organization_id
  2. 联系人: ZOHO_BOOKS_LIST_CONTACTS – 查找或验证customer_id
  3. 创建: ZOHO_BOOKS_CREATE_INVOICE – 使用行项目创建发票
  4. 审查: ZOHO_BOOKS_GET_INVOICE – 获取发票详情或PDF
  5. 跟踪: ZOHO_BOOKS_LIST_INVOICE_PAYMENTS – 监控支付状态
  6. 导出: ZOHO_BOOKS_BULK_EXPORT_INVOICES_PDF – 批量导出记录

示例提示:

“查找’Acme Corp’的客户ID，为他们创建咨询服务的发票，然后获取PDF”

已知陷阱

陷阱 详情
组织ID始终必需 几乎所有端点都需要organization_id——始终首先调用ZOHO_BOOKS_LIST_ORGANIZATIONS
发票需要行项目 ZOHO_BOOKS_CREATE_INVOICE需要至少一个行项目，带有item_id或name
发票ID格式 使用发票对象中的数字invoice_id（例如7472322000000264123），而不是来自invoice_url的编码ID
批量限制 ZOHO_BOOKS_BULK_EXPORT_INVOICES_PDF和ZOHO_BOOKS_BULK_PRINT_INVOICES最多接受25个发票ID
分页最多200 所有列表端点每页限制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

由 Composio 提供支持