SuperAPI AI 工具集

zoho books automation

办公与效率

查看项目

更新于 10-17 04:18

技能介绍

Zoho Books Automation 用于以自然语言方式自动化 Zoho Books 的会计工作流,涵盖发票创建与管理、账单跟踪、联系人查询、付款记录查看以及多组织支持。

用途与使用方式 在环境中添加 Rube MCP 服务器(https://rube.app/mcp),按提示通过 Composio 完成 Zoho Books 账号的 OAuth 连接,之后即可用自然语言下达指令。工具包文档位于 composio.dev/toolkits/zoho_books。

组织发现 调用 ZOHO_BOOKS_LIST_ORGANIZATIONS 可获取已认证用户的全部组织,返回组织 ID、名称等元数据。由于几乎所有其他接口都要求 organization_id,应始终先执行此步骤。示例指令:“List my Zoho Books organizations”。

发票管理 创建发票使用 ZOHO_BOOKS_CREATE_INVOICE,必需参数为 organization_id、customer_id 与 line_items(每项可引用已有 item_id 或直接填写名称,并包含数量、单价,可选描述、税号、折扣);还可设置 YYYY-MM-DD 格式的开票日与到期日、自定义发票号(需将 ignore_auto_number_generation 设为 true)、发票级折扣及折扣类型(entity_level 或 item_level)、备注与条款、创建后立即邮件发送(send)、付款期限天数。 列表查询使用 ZOHO_BOOKS_LIST_INVOICES,可按状态(sent、draft、overdue、paid、void、unpaid、partially_paid、viewed)、客户、日期区间、搜索文本过滤,并支持按日期、到期日、总额、余额等排序及分页(每页最多 200 条)。 获取详情使用 ZOHO_BOOKS_GET_INVOICE,可按 invoice_id 获取,接受 json、pdf 或 html 格式;删除使用 ZOHO_BOOKS_DELETE_INVOICE。批量导出使用 ZOHO_BOOKS_BULK_EXPORT_INVOICES_PDF(最多 25 张合并为单个 PDF),批量打印使用 ZOHO_BOOKS_BULK_PRINT_INVOICES(最多 25 张生成合并打印版 PDF)。

账单管理 ZOHO_BOOKS_LIST_BILLS 支持按状态(paid、open、overdue、void、partially_paid)、供应商、账单号、日期区间、金额上下限过滤与多种排序、分页。ZOHO_BOOKS_GET_BILL 按 bill_id 与 organization_id 获取完整账单;ZOHO_BOOKS_UPDATE_BILL 可修改账单,需提供 bill_id、organization_id、vendor_id、bill_number。

联系人查询 ZOHO_BOOKS_LIST_CONTACTS 可按 contact_type(customer 或 vendor)、名称包含/开头、邮箱包含/开头、公司名包含、状态(如 Status.Active、Status.Inactive、Status.Duplicate)、搜索文本(最多 100 字符)过滤,并支持按名称、邮箱、应收余额、创建时间等排序和分页。

付款跟踪 ZOHO_BOOKS_LIST_INVOICE_PAYMENTS 用于列出指定发票上的全部付款记录,需提供 invoice_id 与 organization_id。

适用场景与限制 适合财务、运营人员以自然语言批量创建和检索发票、导出 PDF、查看逾期账单、核对客户与供应商信息及回款情况。使用前提是完成 MCP 服务器配置与 OAuth 授权,且每次操作前需先获得 organization_id;分页上限为每页 200 条,批量 PDF 导出与打印单次最多 25 张发票。价格、部署平台等其它信息暂未提供。