Xero API能否返回自定义报表？获取Account Transactions报表遇404问题

1. 标准Account Transactions报表的正确调用方式 #

标准报表AccountTransactions必须携带必填参数才能正常返回数据，直接请求不带参数会返回404。你需要添加日期范围参数：

GET https://api.xero.com/api.xro/2.0/Reports/AccountTransactions?fromDate=YYYY-MM-DD&toDate=YYYY-MM-DD

• 确保fromDate和toDate为ISO 8601格式的日期（例如2024-01-01）
• 确认你的API应用已获得Reports只读权限，权限缺失也会导致404

2. 自定义Account Transactions报表的调用方式 #

自定义报表无法通过名称直接调用，必须使用报表的唯一ID：

• 先调用GET https://api.xero.com/api.xro/2.0/Reports获取所有自定义报表列表（注意：标准报表不会出现在该列表中）
• 从返回结果里找到Account Transactions Custom对应的ReportID字段值
• 使用ID发起请求，同样需要携带日期参数：

GET https://api.xero.com/api.xro/2.0/Reports/{ReportID}?fromDate=YYYY-MM-DD&toDate=YYYY-MM-DD

3. 排查GET /Reports无结果的问题 #

如果调用GET /Reports没有返回任何报表，可能是以下原因：

• 你尚未保存过任何自定义报表（标准报表不会出现在这个接口的返回中）
• API应用权限不足，未配置Reports相关权限
• 当前授权的Xero组织内确实不存在自定义报表

补充说明 #

• 标准报表只能通过官方定义的名称调用，且必须携带必填参数；自定义报表只能通过ID调用
• 若仍出现404，检查请求端点拼写（确保是api.xro子域名），以及请求头中的Authorization和Xero-tenant-id是否正确

内容的提问来源于stack exchange，提问作者Shane McCall