餐饮接入团购核销,技术上跑通不难。真正让人头疼的是上线一个月后财务来问:这个月的券都核销了,为什么到账金额对不上?

答案通常在四个金额的混淆上。它们看起来都像「这笔券的钱」,实际含义完全不同。

一、四个金额,各是什么意思

字段含义方向
券售价(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.084.92
按(券售价 − 商家优惠)× 佣金率(8−3) × 1% = 0.054.95

差额 0.03 元,很小,但它说明一件事:不要按文档里的示例公式自己写结算计算逻辑。

平台提供按券码查询结算流水的接口,返回的字段里包含原价、售价、服务费、商家优惠、结算金额、退款金额,还有服务商分润这类可选字段。以它返回的结算金额为准,是唯一可靠的做法。

另外提醒两个边界:结算流水通常只能查一小时之前的数据,且已撤销核销、已消费退款的券码查不到。所以核销时就该把结算相关字段落库,不要指望事后回查。

四、代金券和套餐券,别用同一套模型

餐饮的券大致分三类,结算方式与业务动作都不同:

券类型顾客得到什么商家侧要做的事金额要点
套餐券固定商品组合按套餐出餐,可能要选规格按券结算,与菜品价格无关
代金券抵扣固定金额在结账环节抵扣,需算出实收抵扣额 ≠ 券售价,需按规则算尾款
单品券 / 折扣券指定商品或按比例优惠按平台规则计算实收受品类、时段限制

代金券最容易出错的不是结算,是「尾款」:顾客消费 35 元、用一张面额 10 元的代金券抵扣,还要再付 25 元。这 25 元怎么收、和核销金额怎么区分,很多系统一开始没想清楚。

五、三个最常见的错解

错解一:把券面额当成商家收入

「顾客用了 10 元代金券,我应该收到 10 元」—— 这是最普遍也最贵的误解。商家收到的是结算金额,而结算金额的起点是券售价。面额 10 元的券如果只卖 2 元,商家账上不会有 10 元。

错解二:把核销金额当成实收金额

核销接口返回的「券抵扣金额」是这张券在订单里抵掉了多少钱,不是商家收到的钱。两者不是一回事:抵掉 10 元,商家可能只收 2 元。

错解三:把服务费当成唯一扣减项

只扣服务费、忘了商家优惠,会让账面收入虚高。券一旦参加过秒杀、立减、拼团,那部分让利是商家承担的,必须在结算前扣掉。

六、对账时怎么把这笔对上

  1. 核销成功时,把券码、券类型、券面额、券售价、平台返回的流水号一起落库
  2. 结算数据出来后,按券码与本地记录匹配,取平台的结算金额字段
  3. 核对三对数:核销笔数是否一致、结算金额合计是否一致、有无单边记录
  4. 差异逐条归类:是撤销未同步、是跨天、还是商家优惠没算进去
  5. 对账结果留痕,注明冲正原因与依据

完整的对账口径与差异处理见「团购核销怎么对账」。这里只强调一点:代金券的差异几乎都出在「面额 vs 售价」这一层,先把这层想清楚,对账会顺很多。

七、走聚合接口时的差异

通过第三方接口核销时,你的直接结算对象是服务方,不是平台。这带来两点变化:

  • 给服务方付的是核销服务费(按成功核销次数计),与你从平台收到的结算金额是两条独立流水
  • 平台的结算金额仍由平台直接结给商家,不经过服务方

所以账要分成两本看:一本是「平台结给商家的钱」,一本是「你付给服务方的核销费用」。混成一本会一直对不平。

常见问题

面额 10 元的代金券,商家为什么只收到 1.98 元?

因为顾客买这张券只花了 2 元。代金券是「低价买高面额抵扣权」的商品,商家让利的部分在售卖环节就已经发生,不在结算环节。

服务费是按面额算还是按售价算?

按售价(是否先扣商家优惠,官方两处文档口径不完全一致,见第三节)。不要自己算,取平台返回的结算金额。

退款金额等于结算金额吗?

在官方示例里两者数值相同,表示这张券的退款会把当初结算给商家的金额扣回。但实际退款还受退款政策、是否已消费等条件影响,以平台退款流水为准。