SuperAPI AI 工具集

xero

办公与效率

查看项目

更新于 10-16 06:57

技能介绍

Xero 技能用于查询 Xero 会计系统中的数据,涵盖发票、联系人、账户和银行交易等内容,通过 Xero 的 REST API 实现。

用途:该技能面向需要从 Xero 会计平台读取财务数据的场景,例如查看发票列表、联系人信息、账户结构以及损益报表。

主要能力:根据资料,该技能支持以下查询操作:列出发票(List invoices)、列出联系人(List contacts)、获取损益报表(Get profit/loss)、列出账户(List accounts)。资料中未提供银行交易的具体查询示例,但描述中提及可查询银行交易。

使用方式:使用前需要设置两个环境变量:XERO_ACCESS_TOKEN(OAuth 2.0 访问令牌)和 XERO_TENANT_ID(Xero 租户 ID)。随后通过 curl 命令调用 Xero API 端点,并使用 jq 处理返回的 JSON 数据。资料中给出的具体命令示例如下:

列出发票: curl -s -H "Authorization: Bearer $XERO_ACCESS_TOKEN"
-H "Xero-Tenant-Id: $XERO_TENANT_ID"
"https://api.xero.com/api.xro/2.0/Invoices?page=1" | jq '.Invoices[:10] | .[] | {InvoiceID, InvoiceNumber, Contact: .Contact.Name, Total, Status}'

列出联系人: curl -s -H "Authorization: Bearer $XERO_ACCESS_TOKEN"
-H "Xero-Tenant-Id: $XERO_TENANT_ID"
"https://api.xero.com/api.xro/2.0/Contacts?page=1" | jq '.Contacts[:10] | .[] | {ContactID, Name, EmailAddress}'

获取损益报表: curl -s -H "Authorization: Bearer $XERO_ACCESS_TOKEN"
-H "Xero-Tenant-Id: $XERO_TENANT_ID"
"https://api.xero.com/api.xro/2.0/Reports/ProfitAndLoss?fromDate=2024-01-01&toDate=2024-12-31" | jq '.Reports[0].Rows'

列出账户: curl -s -H "Authorization: Bearer $XERO_ACCESS_TOKEN"
-H "Xero-Tenant-Id: $XERO_TENANT_ID"
"https://api.xero.com/api.xro/2.0/Accounts" | jq '.Accounts[:10] | .[] | {AccountID, Name, Type, Code}'

适用场景:适用于需要以编程方式读取 Xero 会计数据的自动化流程或集成任务,例如定期拉取发票、联系人、账户或损益报表数据。

限制:资料中未提供关于收费、价格、平台支持范围或性能限制的信息。资料中明确提示:在创建发票或付款前应始终进行确认(Always confirm before creating invoices or payments)。