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)。