编辑 | blame | 历史 | 原始文档

H5 溯源「品种信息带计量单位」- 前端联调说明

背景

H5 扫码溯源页(mes.trace-base-url 指向的 trace.html)「追溯查询」区块的品种信息需要带上计量单位。

品种主计量单位存储在 mdm_item.unit_measure_id(单位编号),页面需要的单位名称由后端通过
MdmUnitMeasureApi.getUnitMeasure(id) 解析后随响应返回,前端不需要再单独请求单位接口。

同时按需求精简「追溯查询」区块:去掉「责任人」「质检结论」两行(这两项数据在折叠的「质检信息」区块中仍然可查,未丢失)。

涉及接口

方法 路径 说明
GET /public/mes/trace/query?code={追溯码} H5 溯源查询(免登录),响应品种区块新增 itemUnitMeasureName

响应新增字段(品种信息区块,位于 itemSpecification 之后):

字段 类型 说明
itemUnitMeasureName String 品种主计量单位名称(如 48千克);物料未配置单位时返回 null

响应示例(品种相关片段):

{
  "code": 0,
  "data": {
    "itemCode": "ITEM_20260917002",
    "itemName": "测试",
    "itemSpecification": "一级",
    "itemUnitMeasureName": "48千克"
  }
}

页面展示规则

「追溯查询」区块字段顺序:

字段 取值 说明
品种名称 itemName + itemSpecification 两者以空格拼接,为空的不参与拼接
计量单位 itemUnitMeasureName 未配置单位时展示 -
生产经营者 页面常量 COMPANY_NAME 静态信息
单元识别代码 requestCode → batchCode → tempCode 依次回退 —
追溯网址 页面常量 TRACE_URL 外网访问地址,与包装/二维码印制一致
追溯类型 sourceType 袋码 / 托盘码 / 批次码
批次号 batchCode —
生产日期 produceDate —
产线 lineName,为空回退 lineCode —

本次移除的展示项:

字段 原展示位置 说明
责任人 追溯查询区块 已移除,ownerUserName 字段仍在响应中
质检结论 追溯查询区块 已移除,质检结论仍在响应 quality.resultName 中,可在折叠的「质检信息」区块查看

注意事项

  • itemUnitMeasureName 取的是单位**名称**(mdm_unit_measure.name),不是单位类型(type,如 48千克/100千克/吨)。物料未配置主计量单位时该字段为 null,页面展示 -。
  • 单位名称为空字符串时后端统一转成 null 返回。
  • 该字段为纯展示字段,历史数据无需处理;接口其余字段与结构保持不变,向后兼容。