用途:该工具用于访问 QuickBooks Online 的 REST API,查询发票、客户、付款、账户与财务报表,并可创建发票等记录。
主要能力:支持查询客户、列出发票、创建发票以及获取利润与损失(ProfitAndLoss)报表,返回 JSON 结果,可配合 jq 提取关键字段。
使用方式:需要配置两个环境变量:QUICKBOOKS_ACCESS_TOKEN(OAuth 2.0 访问令牌)和 QUICKBOOKS_REALM_ID(公司 ID / realm ID)。请求通过 curl 调用,基础地址为 https://quickbooks.api.intuit.com/v3/company/$QUICKBOOKS_REALM_ID,生产环境使用该域名,测试时可使用沙箱地址 https://sandbox-quickbooks.api.intuit.com。示例包括:查询客户(query?query=SELECT * FROM Customer MAXRESULTS 10 并提取 Id、DisplayName、PrimaryEmailAddr、Balance),列出发票(SELECT * FROM Invoice MAXRESULTS 10 并提取 Id、DocNumber、CustomerRef、TotalAmt、Balance、DueDate),创建发票(POST 到 /invoice,需指定 CustomerRef 与 Line 明细),获取利润与损失报表(/reports/ProfitAndLoss?start_date=2024-01-01&end_date=2024-12-31)。
适用场景:适合需要以脚本或自动化方式读取 QuickBooks 财务数据、同步客户与发票信息、或生成报表的流程。
限制与注意:创建发票或付款前应始终进行确认。资料未提供令牌获取流程、权限范围、速率限制、分页方式及错误处理细节,使用前需自行确认。