很多团队上线几个月后才第一次对账,然后发现问题:平台结算金额和自己记的核销金额差了一截,但不知道差在哪。对账能力应该在接入时一起做掉。

一、三个口径,先分清

口径来源代表什么
核销流水你的系统记录的核销事件券被用了多少次
平台账单平台侧导出的结算数据平台最终认多少笔、算多少钱
本地实收收银/财务系统的收款记录实际收到多少钱

三者天然会有差异,差异本身不可怕,可怕的是不知道差异来自哪里。对账的目标不是让三个数相等,而是让每一笔差异都有归属。

二、常见差异来源

差异现象常见原因
核销笔数多于平台账单撤销核销未同步扣减;或重复核销造成的多余记录
金额少于预期代金券按面额抵扣但实收另有规则;或平台服务费扣除
跨天差异核销时间与结算时间跨日;时区处理不一致
有核销但平台无记录核销请求实际未生效,只是本地记录了成功
平台有记录但本地无回调丢失;或核销发生在旧系统

三、日对账怎么做

  1. 每日固定时间拉取前一日的核销明细(平台侧接口或导出)
  2. 与本地核销流水按「券码 + 门店 + 时间」匹配
  3. 核对三件事:笔数是否一致、金额是否一致、有无单边记录
  4. 差异逐条标注类型,能自动判定的自动判定,其余转人工
  5. 生成对账结果,差异超过阈值时告警

关键在匹配维度。只用券码匹配在连锁场景下容易撞;建议用「券码 + 门店 + 核销时间」三者组合,仍冲突时再人工判。

四、必须落库的字段

  • 门店ID(本地ID 与平台ID 都存,便于与平台账单对齐)
  • 平台标识(美团/点评/抖音/快手)
  • 券码(脱敏存储)、券类型、券面额
  • 核销时间(带时区)、平台返回的交易流水号
  • 核销状态(成功 / 已撤销 / 待确认)
  • 操作人、终端来源
  • 是否重试、重试次数、原始响应的关键字段

五、差异处理流程

差异类型处理方式
本地多、平台少先查是否为重复核销;确认后冲正本地记录,必要时联系顾客
本地少、平台多补录核销记录;查是否是旧系统或人工操作
金额不一致拆到券类型与代金券实收规则,与财务确认口径
撤销未同步把撤销作为独立事件记录,对账时双向匹配

对账结果的处置要留痕 —— 为什么冲正、谁批的、依据是什么。这部分审计时会要。

六、用聚合接口时的差异

走聚合接口时,你的结算对象是服务方而不是平台,对账口径变成:

  • 核销流水以服务方返回为准,按成功核销次数计费
  • 预核销(验券准备)通常不计费,正式核销成功才计费
  • 多平台券在同一个流水里,需按平台维度拆分统计
  • 服务方账单仍建议与平台侧数据交叉核对,避免中间层误差

云飞API 的计费按核销成功次数,账单粒度到「哪家门店、哪个平台、哪一张券」,便于与本地流水逐笔匹配。

常见问题

对账需要每天做吗?

建议每日。差异发现得越晚,回溯成本越高 —— 一周前的核销要查到具体操作人和终端很难。

撤销核销的券还算计费吗?

按平台与服务方规则,通常撤销后不计入成功核销。但不同服务方规则可能有差异,接入前应确认。