Xero Automation

Xero Automation - 云会计自动化技能

技能概述

Xero Automation 是一个专用于 Xero 云会计平台的自动化技能，帮助小企业主和会计师自动化发票管理、联系人维护、付款处理、银行交易记录等日常簿记工作，大幅减少重复性手工录入，提升财务处理效率。

适用场景

1. 小企业财务流程自动化

对于使用 Xero 进行日常账务处理的小企业，该技能可以自动完成发票的创建、筛选和排序，支持按状态、联系人、日期范围等多维度过滤，让财务数据井井有条。每日的银行交易也可以自动记录并分类到正确的账户代码中，减少月末对账的工作量。

2. 会计和簿记团队批量处理

会计师和簿记员常常需要管理多个客户的 Xero 账户。该技能支持多租户管理，可以同时处理多个 Xero 组织的发票和付款，快速搜索和更新联系人信息，批量创建付款记录，显著提高团队的工作效率。

3. 企业级财务系统集成

对于已经使用自动化工作流的企业，Xero Automation 通过 Rube MCP 服务器提供标准化的 API 工具集，支持与现有系统集成，实现从业务系统到财务系统的端到端自动化，确保数据一致性和准确性。

核心功能

1. 发票全生命周期管理

提供完整的发票处理能力，包括按状态（草稿、已提交、已授权、已付款）筛选发票、按联系人和日期范围过滤、支持 OData 查询语法进行复杂筛选、灵活的排序和分页功能，以及增量获取修改过的发票。无论是查看未付款发票还是导出历史发票记录，都能快速完成。

2. 智能联系人搜索与管理

支持全字段搜索联系人，可以通过姓名、邮箱、联系人编号快速定位目标联系人。对于数据量大的账户，提供分页和归档联系人查询功能。即使在 Xero API 限制较多的高级过滤场景下，也能通过搜索词和分页稳定获取数据。

3. 付款与银行交易自动化

一键创建付款记录，将发票与银行账户关联，自动处理多币种汇率计算。银行交易支持支出和收入两种类型，可以批量记录多行明细，自动匹配税务类型和账户代码。所有交易都支持日期标记和参考号填写，便于审计追踪。

常见问题

Xero Automation 技能需要什么前置条件？

使用该技能需要连接 Rube MCP 服务器（rube.app/mcp），并确保已建立与 Xero 工具包的活跃连接。如果是第一次使用，需要通过 RUBE_MANAGE_CONNECTIONS 初始化连接。如果需要管理多个 Xero 组织，建议先调用 XERO_GET_CONNECTIONS 获取正确的租户 ID。

如何同时管理多个 Xero 组织账户？

Xero Automation 支持多租户管理。在执行任何工具前，先调用 XERO_GET_CONNECTIONS 列出所有活跃的租户连接，获取目标组织的 tenant_id。在后续的发票、付款、交易等操作中，传入该 tenant_id 参数即可确保操作作用于正确的组织。如果省略该参数，系统默认使用第一个连接的租户。

为什么我的 OData 过滤器会报错？

Xero 使用 OData 查询语法，常见的错误是使用单等号（=）而不是双等号（==）。正确的写法是 Status=="AUTHORISED"。另外，在高数据量的账户中，某些过滤器如 IsCustomer 或 IsSupplier 可能会被 Xero 拒绝，此时建议改用 searchTerm 配合分页来获取数据。所有日期必须使用 YYYY-MM-DD 格式，时间戳则需要完整的 ISO 8601 UTC 格式。