fix(wms,oms)：入库排名统计口径修复：件数改为实际上架量SUM(SHELVES_QUANTITY)(原PIECE_COUNT为建档申报值不随收货上架变化)；OMS端数据源跨库改查WMS入库表NGWL_TEST_WMS.stock_in_order/in_material_detail(OMS执行单状态不回传且上架量回填代码未启用，与出库排名1300a4e1跨库修法一致)，状态恢复为已入库(5)；入仓日期为空兜底建档时间；OMS与WMS两端数字一致；接口路径/参数/返回结构不变

2026-09-01 21:36:33 +08:00
parent a4f27ab643
commit da3c58a366
9 changed files with 40 additions and 32 deletions
@@ -26,9 +26,11 @@ import java.util.List;
 /**
 * 入库排名统计Api
 *
- * <p>按入仓日期区间筛选商品入库量统计排名。统计口径：入仓日期(为空的历史单按建档时间兜底)；
- * OMS 执行入库单状态不回传(长期停留已创建)，不按"已入库"过滤，仅排除已取消(6)/已关闭(7)，
- * 与入库明细查询页面口径一致；明细仅取 level=1 主行；一行 = 某仓单内某货品的合计，按件数降序排名。
+ * <p>按入仓日期区间筛选商品入库量统计排名。OMS 库执行入库单状态/上架数量均不回传，真实数据在 WMS 库，
+ * 故数据源跨库取 WMS 入库表(NGWL_TEST_WMS.stock_in_order/in_material_detail，与 OMS 出库排名跨库修法一致)；
+ * 口径与 WMS 端 /inboundRankApi 完全一致，两边数字一致：仅已入库(5) + 明细 level=1 主行 +
+ * 入仓日期(为空的历史单按建档时间兜底) + 件数=实际上架量(SHELVES_QUANTITY)；
+ * 一行 = 某仓单内某货品的合计，按件数降序排名。
 * 字段：入仓日期/仓单编号/客户编号/存货人/货名/件数/毛重(吨)/投保总额/体积(CBM)。
 * 与出库排名(/executionOutboundRankApi)配对，前端用 tab 页区分</p>
 *