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

种子流向信息(销售出库出入库流水) - H5 溯源联调说明

背景

H5 扫码溯源页(mes.trace-base-url 指向的 trace.html)新增「种子流向信息」区块:
按**批次全流水**展示该批次的入库与出库记录(数据源为销售出库 /sales-outbound/product-sales 模块对应的库存事务)。

同时修复既有「销售去向」数据链路:种子销售出库按袋码/托盘扫码拣货时,批次号只写入出库**明细表**
mes_wm_product_sales_detail.batch_code),原查询只匹配出库**行表**批次号,导致溯源永远查不到销售出库信息。

涉及接口

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

响应新增字段 seedFlows(批次出入库流水,按事务时间升序):

字段 类型 说明
type Integer 事务方向:1-入库 2-出库
bizType Integer 业务类型(118-生产入库、119-销售出库、124-产品产出、120-销售退货入库等,见 MesBizTypeConstants)
bizCode String 来源业务单号(如销售出库单号 SL_xxx)
quantity BigDecimal 变动数量(出库为负数,展示时取绝对值)
transactionTime LocalDateTime 事务发生时间
warehouseName String 仓库名称
locationName String 库区名称
areaName String 库位名称
clientName String 客户名称(仅销售出库流水带出,来自出库单快照)

salesTargets 字段变化(同接口,向后兼容):

  • 查询口径扩展:批次号除匹配出库行外,同时按出库明细聚合匹配(排除已取消单据)。
  • 新增填充 clientName(客户名称快照)、clientCode 不变;此前恒为 null。

H5 页面展示规则

区块 展示条件
种子流向信息 seedFlows 非空(优先) 方向(入库/出库徽标)、业务、来源单号、客户、数量、时间、仓库/库区
种子流向信息(回退) seedFlows 为空但 salesTargets 非空 销售出库单、客户、数量、日期

部署注意事项

  1. trace.htmlyudao-server 静态资源(src/main/resources/static/trace.html),需**重新打包发布后端**;
    若生产 nginx 的 /prod/trace.html(如 http://47.97.181.254:9008/prod/trace.html)是独立拷贝部署的,需同步替换该文件。
  2. 销售出库流水的客户名称取 mes_wm_product_sales.client_name 快照字段,要求环境库包含该列;
    经排查 mom-thzy 库已有,**mom-xgdl 库缺失 client_name / outbound_time / outbound_user_id 列**(落后于代码),使用 local 环境时需先补列。
  3. 历史出库单不会补生成流水,仅新出库可看到完整入+出记录;无流水时回退展示销售出库单。

验证数据(mom-thzy)

批次 PC20260819twoITEM_001:入库 100(产品产出,虚拟线边仓库)→ 出库 1(销售出库 SL_20260901002,成品合格库,南通客户)。