面向交付人员
取餐柜交付操作手册
用于项目上线、现场配置、联调验收、客户培训和资料留档。交付人员按本手册完成取餐柜功能从配置到验收的闭环。
现场联调：扫码存餐 / 用户取餐
A01
A02 已存餐
A03
B01
B02
B03
C01
C02
C03
一、上线操作流程
1
确认现场信息
确认安装位置、设备编号、设备 ID、关联餐厅、支持档口和打包费。
2
完成系统配置
维护取餐柜设备，配置档口支持取餐柜，并保存取餐柜打包费。
3
配置设备地址
在取餐柜设备端配置前置校验地址、存取回调地址和扫码识别规则。
4
验证完整链路
验证小程序下单、小票打印、扫码存餐、用户取餐和撤餐流程。
5
培训并留档
培训客户人员，保存配置截图、存取餐视频和客户确认记录。
二、上线前确认
基础信息确认
| 信息项 | 说明 |
|---|---|
| 安装位置 | 例如一楼餐厅入口、二楼就餐区入口。 |
| 设备编号 | 后台和用户侧识别的取餐柜编号。 |
| 设备 ID | 与取餐柜厂商对接的设备标识，必须保持一致。 |
| 关联餐厅/区域 | 取餐柜需要和对应餐厅处于同一区域。 |
| 支持档口 | 明确哪些档口允许选择取餐柜。 |
| 打包费 | 如客户需要收取费用，提前确认金额。 |
现场设备确认
取餐柜已通电、联网
取餐柜设备时间正常
设备端已配置前置校验地址
设备端已配置存取回调地址
扫码、开门、关门正常
现场打印机可以打印小票
已准备测试订单和测试账号
三、后台配置验收点
| 配置项 | 操作入口 | 验收标准 |
|---|---|---|
| 取餐柜设备 | PC 后台 -> 设备管理 | 设备类型为取餐柜，设备编号、设备 ID、地址与现场一致。 |
| 档口取餐方式 | PC 后台 -> 餐厅管理 -> 档口管理 | 档口已勾选取餐柜，小程序确认订单页可选择取餐柜。 |
| 取餐柜打包费 | 档口配置 | 用户选择取餐柜下单时，订单金额包含取餐柜打包费。 |
四、取餐柜设备端地址配置
| 配置位置 | 配置项 | 填写内容 | 验收标准 |
|---|---|---|---|
| 取餐柜设备 -> 功能设置 | 前置校验地址 | https://<业务域名>/api/lockerPickup/verify | 扫码开柜前，设备会先请求系统校验订单是否允许在当前取餐柜操作。 |
| 取餐柜设备 -> 功能设置 | 存取回调地址 | https://<业务域名>/api/lockerPickup/callback | 存餐、取餐、撤餐完成后，设备会通知系统更新订单取餐状态。 |
| 取餐柜设备 -> 模式设置 | 存取餐自定义格式 | 作为订单号 | 设备扫描小票二维码后，按订单号传给系统；小票二维码内容保持订单号。 |
`<业务域名>` 使用客户实际业务域名。现场如果使用 HTTPS，需要确认取餐柜设备可以正常访问证书链。
五、联调验收清单
后台已新增取餐柜设备
设备编号、设备 ID、地址与现场一致
档口已勾选取餐柜取餐方式
取餐柜打包费配置正确
设备端前置校验地址配置正确
设备端存取回调地址配置正确
设备端存取餐自定义格式为作为订单号
小程序确认订单页能选择取餐柜
小程序下单成功，订单显示取餐柜信息
小票能打印取餐柜编号和地址
正确取餐柜可以存餐
错误取餐柜会拦截存餐
存餐后订单状态变为已存餐
用户取餐后订单状态变为已取餐
撤餐后订单状态变为已撤销
六、客户培训话术
| 培训对象 | 培训重点 |
|---|---|
| 客户管理员 | 取餐柜需要先在设备管理中维护，再在档口上开启取餐柜取餐方式。设备 ID 必须和厂商提供的设备标识一致，地址建议填写现场可识别的位置。 |
| 餐厅工作人员 | 看到小票取餐方式为取餐柜时，需要按小票上的取餐柜编号和地址存餐。存餐后确认柜门关闭，用户才能正常取餐。 |
| 现场负责人 | 设备离线、柜门异常、无法扫码时，优先检查电源、网络、前置校验地址、存取回调地址，再联系设备厂商处理。 |
七、交付留档资料
交付完成后建议保存：取餐柜设备配置截图、档口取餐方式配置截图、取餐柜设备端地址配置截图、小程序下单截图、小票照片、存餐成功截图或视频、用户取餐成功截图或视频、异常拦截图、客户验收确认记录。