餐饮接入团购核销,技术上跑通不难。真正让人头疼的是上线一个月后财务来问:这个月的券都核销了,为什么到账金额对不上?
答案通常在四个金额的混淆上。它们看起来都像「这笔券的钱」,实际含义完全不同。
一、四个金额,各是什么意思
| 字段 | 含义 | 方向 |
|---|---|---|
| 券售价(salePrice) | 顾客在平台买这张券实际付了多少钱 | 进账起点 |
| 服务费(serviceFee) | 平台从这笔里收走的佣金 | 扣减项 |
| 商家优惠(bizCost) | 券参加商家促销活动(立减、秒杀、拼团等)由商家承担的优惠 | 扣减项 |
| 结算金额(settleAmount) | 实际结算给商家到账的钱,已刨除服务费与商家优惠 | 最终结果 |
一条式子可以概括:
关键认知在这一句:券售价不等于券面额。一张「10 元面额」的代金券,顾客可能只花了 2 元买到,那么商家这条账单的起点是 2 元,不是 10 元。
二、用官方示例走一遍
这个示例来自平台账单字段说明,值得逐项对照:
顾客买了 1 张鸡翅券(面额 10 元、售价 8 元、佣金 1%),该券又参加了商家秒杀活动,优惠价 5 元。同时买了 1 张代金券(面额 10 元、售价 2 元、佣金 1%)。
鸡翅券(套餐券类)
| 项 | 值 | 怎么来的 |
|---|---|---|
| 券售价 | 8 元 | 顾客实付 |
| 商家优惠 | 3 元 | 8 − 5,秒杀让利部分由商家承担 |
| 服务费 | 约 0.08 元 | 按券售价 × 1% |
| 结算金额 | 约 4.92 元 | 8 − 0.08 − 3 |
代金券
| 项 | 值 | 怎么来的 |
|---|---|---|
| 券售价 | 2 元 | 顾客实付 |
| 商家优惠 | 0 元 | 未参加促销 |
| 服务费 | 0.02 元 | 按券售价 × 1% |
| 结算金额 | 1.98 元 | 2 − 0.02 |
三、官方文档里有一处算法不一致,不要照抄
同一个鸡翅券示例,在平台的两处说明里算出的服务费不同:
| 出处口径 | 服务费 | 结算金额 |
|---|---|---|
| 按券售价 × 佣金率 | 8 × 1% = 0.08 | 4.92 |
| 按(券售价 − 商家优惠)× 佣金率 | (8−3) × 1% = 0.05 | 4.95 |
差额 0.03 元,很小,但它说明一件事:不要按文档里的示例公式自己写结算计算逻辑。
平台提供按券码查询结算流水的接口,返回的字段里包含原价、售价、服务费、商家优惠、结算金额、退款金额,还有服务商分润这类可选字段。以它返回的结算金额为准,是唯一可靠的做法。
另外提醒两个边界:结算流水通常只能查一小时之前的数据,且已撤销核销、已消费退款的券码查不到。所以核销时就该把结算相关字段落库,不要指望事后回查。
四、代金券和套餐券,别用同一套模型
餐饮的券大致分三类,结算方式与业务动作都不同:
| 券类型 | 顾客得到什么 | 商家侧要做的事 | 金额要点 |
|---|---|---|---|
| 套餐券 | 固定商品组合 | 按套餐出餐,可能要选规格 | 按券结算,与菜品价格无关 |
| 代金券 | 抵扣固定金额 | 在结账环节抵扣,需算出实收 | 抵扣额 ≠ 券售价,需按规则算尾款 |
| 单品券 / 折扣券 | 指定商品或按比例优惠 | 按平台规则计算实收 | 受品类、时段限制 |
代金券最容易出错的不是结算,是「尾款」:顾客消费 35 元、用一张面额 10 元的代金券抵扣,还要再付 25 元。这 25 元怎么收、和核销金额怎么区分,很多系统一开始没想清楚。
五、三个最常见的错解
错解一:把券面额当成商家收入
「顾客用了 10 元代金券,我应该收到 10 元」—— 这是最普遍也最贵的误解。商家收到的是结算金额,而结算金额的起点是券售价。面额 10 元的券如果只卖 2 元,商家账上不会有 10 元。
错解二:把核销金额当成实收金额
核销接口返回的「券抵扣金额」是这张券在订单里抵掉了多少钱,不是商家收到的钱。两者不是一回事:抵掉 10 元,商家可能只收 2 元。
错解三:把服务费当成唯一扣减项
只扣服务费、忘了商家优惠,会让账面收入虚高。券一旦参加过秒杀、立减、拼团,那部分让利是商家承担的,必须在结算前扣掉。
六、对账时怎么把这笔对上
- 核销成功时,把券码、券类型、券面额、券售价、平台返回的流水号一起落库
- 结算数据出来后,按券码与本地记录匹配,取平台的结算金额字段
- 核对三对数:核销笔数是否一致、结算金额合计是否一致、有无单边记录
- 差异逐条归类:是撤销未同步、是跨天、还是商家优惠没算进去
- 对账结果留痕,注明冲正原因与依据
完整的对账口径与差异处理见「团购核销怎么对账」。这里只强调一点:代金券的差异几乎都出在「面额 vs 售价」这一层,先把这层想清楚,对账会顺很多。
七、走聚合接口时的差异
通过第三方接口核销时,你的直接结算对象是服务方,不是平台。这带来两点变化:
- 给服务方付的是核销服务费(按成功核销次数计),与你从平台收到的结算金额是两条独立流水
- 平台的结算金额仍由平台直接结给商家,不经过服务方
所以账要分成两本看:一本是「平台结给商家的钱」,一本是「你付给服务方的核销费用」。混成一本会一直对不平。
常见问题
面额 10 元的代金券,商家为什么只收到 1.98 元?
因为顾客买这张券只花了 2 元。代金券是「低价买高面额抵扣权」的商品,商家让利的部分在售卖环节就已经发生,不在结算环节。
服务费是按面额算还是按售价算?
按售价(是否先扣商家优惠,官方两处文档口径不完全一致,见第三节)。不要自己算,取平台返回的结算金额。
退款金额等于结算金额吗?
在官方示例里两者数值相同,表示这张券的退款会把当初结算给商家的金额扣回。但实际退款还受退款政策、是否已消费等条件影响,以平台退款流水为准。