核心用法
qb-cli 是一款面向 QuickBooks Online 的命令行工具，通过 Docker 容器运行，直接与 Intuit 官方 API 通信，无需第三方代理。涵盖 29 个命令组、164 个命令，完整支持应收应付、总账、银行对账、月末结账等核心会计流程。
主要功能模块：
- 客户与供应商管理：完整的 CRUD 操作，支持搜索去重、1099 供应商标记
- 发票与账单：创建、发送、作废、付款全流程，支持明细行级 JSON 配置
- 财务报告：损益表、资产负债表、现金流量表、试算平衡表等标准报表
- 银行对账：OFX/QFX/CSV 导入、自动匹配算法、对账差异分析
- 月末工作流：自动检查未存资金、逾期应收应付，生成结账报告
Agent 集成优势：
- 默认 JSON 输出，便于程序解析
- 自动处理 SyncToken、OAuth 令牌刷新
- 完善的退出码体系（0-5）便于错误处理
- 内置 8 条关键安全规则，防止误操作（如重复创建客户、误发发票等）
显著优点
1. 官方 API 直连：数据不经过第三方，符合企业合规要求
2. 容器化部署：Docker 运行环境隔离，依赖清晰
3. 批量操作支持：JSON 批量文件处理，自动分块（30 条/批次）
4. 多格式导入：支持 OFX、QFX、QBO、CSV 及自定义列映射
5. 智能匹配算法：银行流水与 QB 交易的精确/模糊匹配机制
潜在缺点与局限性
- 认证流程复杂：需 Intuit 开发者账号，OAuth 回调需手动复制粘贴
- 部分功能只读：银行对账无法自动标记已核对，需人工在 QB UI 确认
- 查询语法受限：不支持 OR 操作符，部分字段（如电话）无法索引查询
- Docker 依赖：需本地安装 Docker 和 docker-compose
- 沙盒/生产环境切换：需手动配置 QB_ENVIRONMENT
适合人群
- 中小企业财务团队：需要自动化月末结账、批量发票处理
- 会计服务提供商：管理多个客户账套的标准化操作
- 财务自动化开发者：构建 AI Agent 或 RPA 流程的技术团队
- QuickBooks 高级用户：熟悉 QB 逻辑、希望提升效率的专业人士
常规风险
- 数据误操作风险：发票/账单删除不可恢复，建议开启 QB 审计日志
- OAuth 令牌安全：Client Secret 需妥善保管，避免硬编码在脚本中
- 批量导入风险：银行导入前务必使用
--dry-run预览匹配结果 - 1099 合规风险：供应商 TIN 信息需核实，避免税务申报错误
- 时区与日期：跨时区企业需注意 QB 公司设置与系统时区一致性