QuickBooks Online 发票对账代理

手动对账的工程痛点

当财务团队用 QuickBooks Online 处理未付发票时，通常会遇到三个问题：数据源割裂——发票数据在 QuickBooks，银行交易记录在银行后台，两者没有原生的关联字段；规则硬编码——不同账期的发票可能按金额、日期或客户ID匹配，写死在Excel或脚本里的规则无法应对新场景；异常处理困难——金额不匹配、状态不一致、时区错位等情况需要人工逐条核对，耗时且易漏。这些场景下，自动化工具需要做的不只是“把数据拉过来”，还要在正确的时机做正确的匹配，并保留可审计的输出。

技能如何工作

该技能以 QuickBooks Online Accounting API 为数据源，通过 intuit-oauth Node.js SDK 完成 OAuth 2.0 授权，拿到访问令牌后调用发票接口拉取未付发票列表。银行交易记录通过外部通道导入后，技能按以下步骤处理：

• 数据标准化：将发票金额、币种、日期与银行交易记录对齐到同一时区与精度，避免浮点误差或跨日差异。
• 匹配逻辑：以金额+日期为默认键，允许通过 transaction_id 或 customer_ref 做二次校验；匹配成功则标记“已对账”，未匹配则进入差异列表。
• 差异报告生成：使用 PDFKit 将未匹配条目、金额偏差、日期错位等信息生成结构化 PDF，包含表头、明细和汇总页。
• 通知分发：通过 SendGrid 将 PDF 报告发送至指定邮箱，附带差异摘要和附件。

整个流程无需人工干预即可完成一轮基础对账，差异项会自动汇总到报告中供财务人员复核。

适用边界与注意点

该技能适用于已接入 QuickBooks Online API 且能获取银行交易明细的场景，不适用于离线账套或未授权环境。使用时需注意：

• API 权限：OAuth 2.0 授权范围需包含 invoice 读写权限，否则拉取未付发票会失败。
• 字段一致性：银行交易记录中的 amount 和 date 字段必须与 QuickBooks 发票数据兼容，否则匹配率会显著下降。
• 异常处理：金额偏差超过设定阈值（如 ±0.01）或日期跨时区的情况需要人工确认，技能不会自动修正。
• 安全合规：PDF 报告含财务数据，发送路径需确保加密传输，建议通过 SendGrid 的 TLS 配置而非直接附件。