用途:通过 QuickBooks Online Accounting API 访问会计数据,覆盖公司信息、客户、供应商、发票、账单、账户、项目与财务报表。适用于需要以命令行方式查询或写入 QuickBooks 在线会计数据的场景。
主要能力:查询与获取公司信息;对客户、供应商、发票、账单、账户、项目执行列表与单项查询;运行自定义查询与计数;创建客户与发票;获取利润表和资产负债表等报表。
使用方式:基础 URL 为 https://quickbooks.api.intuit.com/v3/company/$QUICKBOOKS_REALM_ID。所有请求使用 Authorization: Bearer $QUICKBOOKS_TOKEN。QUICKBOOKS_REALM_ID 在 OAuth 流程中获取,每个 URL 都必须包含。部分端点需添加 ?minorversion=75。查询使用 /query 端点并通过 --data-urlencode 传 SQL 式语句。
故障排查:请求失败时运行 zero doctor check-connector --env-name QUICKBOOKS_TOKEN,或 zero doctor check-connector --url https://quickbooks.api.intuit.com/v3/company/$QUICKBOOKS_REALM_ID/companyinfo/$QUICKBOOKS_REALM_ID --method GET。
限制:需有效 OAuth 令牌与 realm ID;未提供令牌获取、权限范围、速率限制与错误处理细节;不涉及定价信息。