滨州项目｜万医生接口可对接范围确认稿

本页仅展示康比特智慧营养健康餐厅当前能够提供和实施的接口字段。未列字段不纳入本次对接承诺范围。

3本次推送接口
93可提供字段（含结构节点）
24健康档案字段
63订单与菜品字段
范围声明：健康档案、完成消费订单、成功餐饮退单由康比特系统异步推送万医生；第三方推送失败不影响现有主流程。所有完成消费订单统一传 dine_in_order。

接口与调用时机

健康档案同步
POST /open-api/v1/nutrition/profileSync
人员档案或一次完整健康测量成功落库后推送。
订单信息同步
POST /open-api/v1/nutrition/orderSync
任意来源消费订单首次进入完成状态且最终菜品明细形成后推送。
退单信息同步
POST /open-api/v1/nutrition/orderRefund
餐饮退款真正成功后推送；本次支持整单退款和金额退款。
可靠性
配置开关、异步任务、幂等重试；失败不回滚人员、体测、订单或退款。

可提供字段明细

序号接口对方字段类型我方提供来源/口径提供方式转换及约定

联调时需冻结的共同口径

  1. 接口单批最大数据量、超时、限流和批量部分失败返回方式。
  2. 菜品和食材分类、烹饪方式、健康标签的双方枚举映射表。
  3. 营养数据的计量基准及各字段单位。
  4. 订单菜品 amount 按克传输，spec.weightUnit 的目标文本及空值规则。
  5. 整单退款和金额退款的 refundType 枚举值；本次不启用菜品级退菜。
  6. 健康标签单个文本、多个字符串数组的兼容规则。

双方按本页字段进行请求样例确认、枚举对表和联调验收；新增字段另行评估。