用途:为集成 Fondo 税务与会计数据提供生产级模式。Fondo 是托管记账平台,通过 QuickBooks Online 与薪资服务商同步;集成使用 FONDO_API_KEY 认证的 REST 端点获取导出数据,用 QuickBooks Online API 取总账数据,并以结构化 CSV 解析加 Zod 校验做批量导入。
主要能力:单例客户端(getClient 读取环境变量 FONDO_API_KEY,缺失即抛错)、交易与账户查询、FondoError 错误包装与 safeCall(429 时 5 秒退避重试、401 提示密钥无效)、FondoQuery 请求构建器(日期范围、分类、账户、仅研发、limit)、响应类型定义(交易、账户、报表、研发抵免)、测试用 mock 工厂。
使用方式:先校验源 schema 与字段白名单再解析或转发;使用不透明操作 ID、有界重试与对账闸门防止重复或部分导入;未知字段与不匹配项隔离待财务复核,而非扩大数据访问。输出客户端校验回执,含契约/夹具版本、聚合 schema 与对账结果、操作 ID、负责人与脱敏失败引用。
适用场景:将 Fondo 导出数据导入内部工具、与 QuickBooks 总账对接、研发费用与税务抵免相关财务建模。
限制:需限定范围的凭证、已授权的源/目标映射、合成夹具与指定财务数据负责人;不得记录交易、账户、税务/薪资数据或令牌;财务结论需专业复核。资料未提供具体定价、平台支持范围与完整端点清单。