重庆环卫 · 妙雀 308/318K 咖啡机交付对接指南

交付阶段资料导航｜2026-07-27｜用于研发、交付、厂家与项目负责人协作
协议与方案已归档 我方 API 契约待冻结 服务端与用户端待开发 实机联调待厂家条件
状态边界：已完成的是原厂协议、字段矩阵和对接设计；未完成的是我方接口实现、用户扫码扣款闭环和实机验收。服务器基础部署完成不等于咖啡机已经对接完成。

V1 对接闭环

设备取码
咖啡机调用 weburlA，提交订单、商品、价格、轨道和签名。
用户扣款
我方返回 twocode；用户扫码进入我方消费系统确认扣款。
设备轮询
咖啡机调用 weburlC 查询扣款结果，成功后设备自行制作/出货。
结果回传
咖啡机调用 weburlB 上报出货结果；失败进入冲正、退款或人工处理。

双方边界

咖啡机方

  • 维护设备商品、价格、轨道和设备订单。
  • 请求二维码、轮询扣款状态、成功后自行出货。
  • 回传出货成功/失败与错误信息。

我方系统

  • 验签、设备与商品价格校验、订单幂等。
  • 生成消费二维码，处理餐卡/余额/补贴扣款。
  • 记录出货状态、异常、冲正/退款和对账。

交付前必须补齐

责任方必须项完成判定
厂家测试机、测试商品、设备台账、machid/appkey、318K 固件确认、错误码与重试规则。可在测试环境重复完成一笔设备交易。
研发weburlA/B/C 的 OpenAPI/Apifox 契约、验签、订单状态机、幂等与异常处理。成功、超时、重复回调和出货失败均有自动化或可复现测试。
产品/项目扣款账户、商品轨道映射、出货失败后冲正/退款/补贴返还规则。书面确认的 V1 业务规则与验收指标。
交付/运维公网 HTTPS、VPN/专线或白名单；现场网络、联系人和联调窗口。设备能够稳定访问我方回调接口并留存日志。

微盘资料导航

目录用途
00 项目总览与导航先读 README，了解资料边界、目录职责和当前状态。
01 原厂协议与接口核对妙雀 308/318K 原厂协议、字段矩阵和来源。
02 咖啡机对接方案查看本指南、流程沟通页、方案摘要和双方职责。
03 部署与运行查看脱敏部署沟通摘要和基础运行环境说明。
04 联调测试与验收沉淀测试用例、联调日志、验收记录和遗留问题。

来源：妙雀 308/318K 原厂文档、重庆环卫项目对接方案、有道云群聊脱敏摘要。账号、密码、验证码和生产登录信息不在本页或微盘归档中保存。