先看这张表
餐厅接入前必须确认的六件事。每一条判断错,都不是改个参数能解决的。
| 事项 | 事实 | 容易踩的坑 |
|---|---|---|
| 业务线 | 餐饮属「到店餐饮」,与「到店综合」接口互不通用 | 拿洗车 / 健身房的接口路径去接餐厅,第一步就通不过 |
| 业务线判断依据 | 看门店主营类目,不看门店名字 | 混合业态(餐厅兼卖其他)凭名字判断,选错业务线 |
| 券的类型 | 套餐券 / 代金券 / 单品券,结算方式各不相同 | 只处理套餐券,上线后发现代金券的账单金额不对 |
| 金额口径 | 券面额 ≠ 券售价 ≠ 券抵扣 ≠ 结算金额 | 把面额当收入,或把抵扣当实收 |
| 核销后动作 | 必须接上出餐或下单,不能只弹「核销成功」 | 核销与出餐没串起来,顾客坐着等,后厨没收到单 |
| 并发特征 | 午晚高峰是平时的几十倍,且有明确时段 | 超时设太短造成大量假失败,重试又无幂等 |
三条落地路径,授权模型不一样
同样是「餐厅核销团购券」,落在哪个终端决定了要哪套授权。 这一点选错不是改代码能解决的,授权表结构要重设计。
| 路径 | 谁操作 | 需要什么授权 | 适合 |
|---|---|---|---|
| 收银台核销 | 收银员 | 仅门店授权 | 先吃后付、结账时用券 |
| 顾客自助核销 | 顾客 | 门店授权 + 用户授权 | 顾客自己扫码查券用券 |
| 点餐内嵌核销 | 顾客 | 门店授权 + 用户授权 | 扫码点餐、桌台码点餐 |
三者的差别不只是「谁点按钮」。后两条路径多一层 用户授权: 顾客先授权,系统才能查到他名下有哪些券。 少了这一层,连「这个顾客有什么券」都查不到 —— 因为券信息属于用户隐私,不在门店维度公开。 这是餐饮接入最常见的架构误判:按收银台核销的模型写完, 发现查券永远为空,以为是门店 ID 或授权失效,实际是模型选错了。
三种券,三套处理逻辑
把三种券当同一种来处理,是餐饮接入最常见的架构错误。 它们的业务动作与结算口径都不同。
| 券类型 | 顾客得到什么 | 核销后要做什么 | 金额要点 |
|---|---|---|---|
| 套餐券 | 固定商品组合 | 按套餐出餐,通常还要选规格(辣度、冷热、份量) | 按券结算,与菜品标价无关 |
| 代金券 | 抵扣固定金额 | 在结账环节抵扣,需算出尾款 | 面额是抵扣上限,实际抵扣受门槛与品类限制 |
| 单品券 / 折扣券 | 指定商品或按比例优惠 | 按平台规则计算实收 | 常限定品类、时段或不可与其他优惠共用 |
关于「叠加」的一个常见误解: 同一订单通常不能同时使用菜品券(套餐券)和代金券。所谓叠加, 实际是指一张券与订单里多个菜品之间的关系,不是两种券一起用。 此外代金券常有品类限制 —— 「2 元抵 10 元,仅限饮料」, 而顾客点的饮料只有 5 元时,实际只抵 5 元,不是 10 元。
核销到出餐:顺序错了会出真问题
自助门店核销完是开门、上电,机器不会等人。 餐厅核销完有人要做饭,所以「什么时候该出餐」必须想清楚。
| 步骤 | 做什么 | 为什么不能省 |
|---|---|---|
| ① 验券准备 | 校验券是否可用,取回套餐明细与规格选项 | 跳过就直接扣券,套餐不对只能撤销,而撤销有时限 |
| ② 顾客确认 | 展示套餐与规格,让顾客选完再核 | 后厨拿到的信息不全,做出来不是顾客要的 |
| ③ 执行核销 | 多张券逐张核,记录每张的结果 | —— |
| ④ 全部成功后出餐 | 出餐动作放在所有券核销成功之后 | 放在循环里会导致「核了 3 张只出 1 份」或「出了 3 份只核成 1 张」 |
| ⑤ 尾款结算 | 抵扣后的剩余金额由自己的渠道收取 | 尾款为 0 时仍要生成订单,否则后厨收不到单 |
餐厅和自助门店,到底差在哪
如果你发现自己的场景更像右边一列,那该看的是美团专题页,不是这一页。
| 维度 | 餐饮 | 自助门店(洗车 / 台球 / 健身) |
|---|---|---|
| 业务线 | 到店餐饮 | 到店综合(服务零售) |
| 核销后动作 | 出餐 / 下单 | 开门 / 上电 / 开台计时 |
| 规格处理 | 重要,辣度与份量必须选 | 通常没有 |
| 金额计算 | 代金券需算尾款与实收 | 一般直接计次,金额简单 |
| 并发特征 | 午晚高峰尖峰明显 | 全天较均匀 |
| 典型终端 | 收银机 / 点餐屏 / 扫码点餐 | 门口扫码 / 自助机 |
上线前过一遍这七条
这七条都是从实际接入里踩出来的。每一条漏掉,症状都要到上线后才暴露。
| 检查项 | 漏掉的后果 |
|---|---|
| 业务线按主营类目确认过 | 接口调不通,或查不到券 |
| 三种券分别处理,不是一套逻辑 | 代金券的账单金额算错 |
| 结算金额取接口返回值,不自己算 | 与平台账单长期挂分毫差异 |
| 出餐动作在全部核销成功之后 | 核了 3 张只出 1 份,或出了 3 份只核成 1 张 |
| 尾款为 0 也生成订单 | 后厨收不到单,顾客干等 |
| 超时重试带幂等键,且先查券状态 | 一张券核销两次,直接资损 |
| 每家门店的授权状态可查 | 新店开张后全部核销失败,才发现没授权 |
餐饮接入的每一关
按实际推进顺序排。前两类是餐饮专属,后两类是通用但餐饮高频撞上的。
01
先确认业务线
餐厅走哪套接口02
钱怎么算
面额、售价、实收不是一个数03
怎么点怎么核
扫码点餐与出餐衔接04