妙雀 308/318K 咖啡机对接流程图

重庆环卫项目 · 智慧餐厅适配沟通页 · 2026-07-28
一句话结论：这就是“设备扫码消费扣款”，不是复杂咖啡机业务。
二维码由智慧餐厅生成 PC 设备管理新增咖啡机类型 咖啡机只展示二维码并出货 扫码进入小程序扣款 手机不直接控制设备

308 和 318K 当前按同一套 V2.4 协议看：weburlA 取码、weburlC 查扣款、weburlB 报出货。智慧餐厅侧需要补设备类型、预支付订单、扫码扣款、扣款查询和出货结果记录。

1. 对接业务流程图

用户 在咖啡机选咖啡 咖啡机 生成订单和价格 我方接口 A 校验 machid，生成预支付订单 用户手机 扫码进智慧餐厅小程序 智慧餐厅系统 扣餐卡/余额/补贴 咖啡机查结果 weburlC：扣款成功才出货 咖啡机制作/出货 设备自己完成动作 我方记录结果 weburlB：成功完成，失败处理 关键边界：智慧餐厅负责订单与扣款；咖啡机负责展示二维码、查询结果和出货；用户手机只负责扫码确认支付。

2. 双方边界图

咖啡机方边界 1. 设备上维护商品、价格、轨道 2. 带 machid 调我方接口取二维码 3. 扣款成功后自己制作/出货 4. 把出货成功/失败告诉我方 不负责：我方账户、补贴、退款规则 双方交接点 weburlA：取小程序支付码 weburlC：查我方扣款结果 weburlB：报设备出货结果 智慧餐厅边界 1. PC 设备管理维护咖啡机 2. 校验 machid 并生成预支付订单 3. 处理餐卡/余额/补贴扣款 4. 记订单、异常、冲正或人工处理 不负责：直接控制咖啡机制作动作

3. 智慧餐厅适配范围

PC 设备管理 新增设备类型“咖啡机”；设备 SN 字段按咖啡机协议的 machid 保存，用于接口鉴权、订单归属和点位管理。
订单与扫码 咖啡机取码时，智慧餐厅先生成预支付订单，再生成微信小程序扫码支付二维码参数；用户扫码成功后在智慧餐厅侧完成扣款。
设备参数留痕 记录咖啡机传入的订单、商品、价格、轨道、设备编号等参数，后续用于查扣款、报结果、对账和异常处理。

4. 三个接口就够了

接口 A：取码 咖啡机把 machid、订单、商品、价格、轨道等参数发给智慧餐厅；智慧餐厅校验 machid 是否存在，生成预支付订单并返回小程序扫码支付二维码参数。
接口 C：查扣款 咖啡机轮询智慧餐厅扣款结果；只有智慧餐厅返回扣款成功，设备才制作/出货。
接口 B：报结果 设备出货后通知智慧餐厅成功或失败；智慧餐厅记录出货结果，失败进入冲正、退款、补贴返还或人工处理。

5. 现在只差厂家确认这 6 件事

318K 实机是否按 V2.4 执行 设备清单和点位 每台 machid / appkey 测试设备和测试商品 twocode 能否展示我方 URL 出货失败 errinfo 错误码

6. 可以直接发给厂家的一句话

本项目由智慧餐厅系统对接咖啡机：PC 端设备管理新增咖啡机类型，设备 SN 按 machid 保存。咖啡机在用户选品后调用接口 A 获取小程序扫码支付二维码参数；智慧餐厅校验 machid、生成预支付订单并记录设备传参，用户扫码后完成扣款。咖啡机通过接口 C 查询扣款结果，扣款成功后自行出货，并通过接口 B 回传出货成功或失败。请确认 308/318K 实机是否都支持 V2.4 文档中的 weburlA、weburlC、weburlB 三个接口。 待确认资料：设备清单、machid/appkey、测试设备、回调配置方式、轮询/重试规则、errinfo 错误码。

详细接口参数和资料清单仍保留在 summary.md、integration-design.md、pending-confirmation.md；本页只用于对接沟通。