很多团队上线几个月后才第一次对账,然后发现问题:平台结算金额和自己记的核销金额差了一截,但不知道差在哪。对账能力应该在接入时一起做掉。
一、三个口径,先分清
| 口径 | 来源 | 代表什么 |
|---|---|---|
| 核销流水 | 你的系统记录的核销事件 | 券被用了多少次 |
| 平台账单 | 平台侧导出的结算数据 | 平台最终认多少笔、算多少钱 |
| 本地实收 | 收银/财务系统的收款记录 | 实际收到多少钱 |
三者天然会有差异,差异本身不可怕,可怕的是不知道差异来自哪里。对账的目标不是让三个数相等,而是让每一笔差异都有归属。
二、常见差异来源
| 差异现象 | 常见原因 |
|---|---|
| 核销笔数多于平台账单 | 撤销核销未同步扣减;或重复核销造成的多余记录 |
| 金额少于预期 | 代金券按面额抵扣但实收另有规则;或平台服务费扣除 |
| 跨天差异 | 核销时间与结算时间跨日;时区处理不一致 |
| 有核销但平台无记录 | 核销请求实际未生效,只是本地记录了成功 |
| 平台有记录但本地无 | 回调丢失;或核销发生在旧系统 |
三、日对账怎么做
- 每日固定时间拉取前一日的核销明细(平台侧接口或导出)
- 与本地核销流水按「券码 + 门店 + 时间」匹配
- 核对三件事:笔数是否一致、金额是否一致、有无单边记录
- 差异逐条标注类型,能自动判定的自动判定,其余转人工
- 生成对账结果,差异超过阈值时告警
关键在匹配维度。只用券码匹配在连锁场景下容易撞;建议用「券码 + 门店 + 核销时间」三者组合,仍冲突时再人工判。
四、必须落库的字段
- 门店ID(本地ID 与平台ID 都存,便于与平台账单对齐)
- 平台标识(美团/点评/抖音/快手)
- 券码(脱敏存储)、券类型、券面额
- 核销时间(带时区)、平台返回的交易流水号
- 核销状态(成功 / 已撤销 / 待确认)
- 操作人、终端来源
- 是否重试、重试次数、原始响应的关键字段
五、差异处理流程
| 差异类型 | 处理方式 |
|---|---|
| 本地多、平台少 | 先查是否为重复核销;确认后冲正本地记录,必要时联系顾客 |
| 本地少、平台多 | 补录核销记录;查是否是旧系统或人工操作 |
| 金额不一致 | 拆到券类型与代金券实收规则,与财务确认口径 |
| 撤销未同步 | 把撤销作为独立事件记录,对账时双向匹配 |
对账结果的处置要留痕 —— 为什么冲正、谁批的、依据是什么。这部分审计时会要。
六、用聚合接口时的差异
走聚合接口时,你的结算对象是服务方而不是平台,对账口径变成:
- 核销流水以服务方返回为准,按成功核销次数计费
- 预核销(验券准备)通常不计费,正式核销成功才计费
- 多平台券在同一个流水里,需按平台维度拆分统计
- 服务方账单仍建议与平台侧数据交叉核对,避免中间层误差
云飞API 的计费按核销成功次数,账单粒度到「哪家门店、哪个平台、哪一张券」,便于与本地流水逐笔匹配。
常见问题
对账需要每天做吗?
建议每日。差异发现得越晚,回溯成本越高 —— 一周前的核销要查到具体操作人和终端很难。
撤销核销的券还算计费吗?
按平台与服务方规则,通常撤销后不计入成功核销。但不同服务方规则可能有差异,接入前应确认。