SuperAPI AI 工具集

quickbooks-online-api

编程与开发

查看项目

更新于 10-15 21:47

技能介绍

用途:面向 QuickBooks Online 会计数据的集成开发指南,帮助构建发票、付款、客户、商品、账户与财务报表相关功能。

主要能力:基于 REST,返回 JSON 或 XML,提供 Java、Python、PHP、Node.js、C# SDK,支持沙箱与生产环境。覆盖 Customer、Invoice、Payment、Item、Account 等核心实体,支持创建、读取、更新、删除、SQL 风格查询、批量操作(单请求最多 30 个操作)、变更数据捕获与 Webhook 同步。

认证:使用 OAuth 2.0。需在 developer.intuit.com 注册应用获取 Client ID 与 Client Secret,引导用户授权后换取访问令牌与刷新令牌。访问令牌有效期 3600 秒,刷新令牌自签发起 100 天有效,新令牌签发后旧刷新令牌 24 小时后失效,应始终使用最新刷新令牌。请求头使用 Authorization: Bearer {access_token},并需保存 OAuth 返回的 realmId。

用法要点:创建使用 POST /v3/company/{realmId}/{entityName};读取使用 GET /v3/company/{realmId}/{entityName}/{entityId};更新需携带最新 SyncToken,稀疏更新设置 "sparse": true;删除多为软删除(Active 设为 false)或作废。查询端点 GET /v3/company/{realmId}/query?query={sqlQuery},支持 =、<、>、IN、LIKE(仅 % 通配符),不支持 JOIN 与聚合函数,单次最多 1000 条,需分页。批量端点 POST /v3/company/{realmId}/batch,用 bId 跟踪结果。

限制:查询不能选择字段、无 JOIN、无 SUM/COUNT 等聚合;更新必须处理 SyncToken 并发冲突;令牌需安全加密存储并主动刷新;401 时应自动刷新重试。具体价格、配额与完整错误码资料暂未提供。