用途:该技能用于从 Xero 会计软件安全地只读提取财务数据并进行分析,适用于提取财务数据、生成会计报告、分析交易历史、审计会计科目表、查看资产登记簿等任务。
主要能力:可读取组织信息、会计科目表、银行交易、发票、手工日记账、付款、联系人,以及试算平衡表、损益表、资产负债表等财务报表,还可读取固定资产。输出结构包含组织、科目、报表、交易、资产、联系人和元数据。
使用方式:采用 OAuth 2.0 授权码流程。所需作用域为 offline_access、accounting.transactions.read、accounting.reports.read、accounting.contacts.read、accounting.settings、openid profile email。流程为:重定向用户至 https://login.xero.com/identity/connect/authorize 授权,用授权码向 https://identity.xero.com/connect/token 换取令牌,再通过 GET https://api.xero.com/connections 获取 tenantId。调用 API 时需携带 Authorization: Bearer {access_token} 与 xero-tenant-id 请求头。令牌过期可用 refresh_token 刷新。
限制:严格只读,仅授权读取作用域,绝不修改 Xero 数据,所有变更仅为建议。速率限制为每租户每日 5000 次调用、每分钟 60 次、最多 4 个并发请求,建议实现指数退避、缓存与分页。需加密存储令牌、仅用 HTTPS、不记录访问令牌。错误处理涵盖 401 刷新令牌、429 等待重试、403 检查作用域等。财务年度按澳大利亚口径 7 月 1 日至次年 6 月 30 日处理。