diff --git a/src/api/stock.check/stock.check.ts b/src/api/stock.check/stock.check.ts index 7affcdd2..37c54e1b 100644 --- a/src/api/stock.check/stock.check.ts +++ b/src/api/stock.check/stock.check.ts @@ -581,12 +581,20 @@ export function stockCheckList( /** * stock.check.addDetail 请求参数(与任务 type 对齐:商品类传 stock_ids,库位类传 locations / location_ids) * + * ⚠️ **商品路径按「商品+库位」拆行**(商品任务必须按库位盘点):服务端取该商品在仓库的 + * **启用库存库位**(wms_storage is_enabled=1,按 space_id 分组 SUM),**一个「商品+库位」生成一条明细行** + * (location_id / location_code 快照绑定库存库位、system_quantity = 该库位库存合计); + * 一个商品多个库位 → 多行;**无启用库存库位的商品不入明细**,计入响应 `invalid_stock_ids`。 + * → 前端语义:传 N 个 stock_ids 可能得到 >N 条明细,响应 `added` 是**明细行数**而非商品数。 + * * 维度校验(传错维度后端报 400): * - 按库位盘点(type=all/location)传 stock_ids → 「当前盘点类型按库位盘点,请传 locations 或 * location_ids(如需按商品盘点请创建 type=goods 任务)」 * - 按商品盘点(type=store/goods)传 locations → 「当前盘点类型按商品盘点,请传 stock_ids」 * - 按商品盘点传 location_ids → 「当前盘点类型按商品盘点,不能添加库位明细」 * + * 商品判定:商品必须属于本仓库;任务 store_id 非空时商品货主必须与任务货主一致 + * (不一致的商品计入 invalid_stock_ids)。 * 兼容:type=all 且已存在商品明细行(改造前创建的旧任务)时,继续按商品模式接受 stock_ids。 * 幂等:已存在同盘点项(商品行 stock_id / 库位行 location_code)自动跳过(计入 skipped)。 */ @@ -596,6 +604,9 @@ export type StockCheckAddDetailParams = { /** * 商品库存ID列表(wms_stock_warehouse.id):type=store/goods 按商品盘点时使用, * 与 locations / location_ids 按任务类型二选一 + * + * **每个商品按其启用库存库位(wms_storage is_enabled=1,按 space_id 分组)拆分为多行**; + * 无启用库存库位的商品记入 `invalid_stock_ids`(不生成明细行) */ stock_ids?: number[] /** @@ -622,7 +633,12 @@ export type StockCheckAddDetailResponse = { added: number /** 已存在被跳过(幂等)的盘点项数 */ skipped: number - /** 无效商品库存ID列表(不存在、不属于当前仓库,或商品货主与任务货主不一致) */ + /** + * 无效商品库存ID列表 + * + * 三种情形:不存在 / 不属于当前仓库;商品货主与任务货主不一致(任务 store_id 非空时); + * 该商品**没有启用库存库位**(无库位可盘 → 不生成明细行) + */ invalid_stock_ids: number[] /** 无效库位编码列表(当前仓库不存在对应库位编码) */ invalid_locations: string[] diff --git a/src/views/storage/stockcheck/pages/CheckStockPickerDialog.vue b/src/views/storage/stockcheck/pages/CheckStockPickerDialog.vue index 5b3342d0..b4991cff 100644 --- a/src/views/storage/stockcheck/pages/CheckStockPickerDialog.vue +++ b/src/views/storage/stockcheck/pages/CheckStockPickerDialog.vue @@ -2,7 +2,10 @@ CheckStockPickerDialog — 添加盘点明细 两种模式(由来源盘点单的 type 决定): - - 商品类(type=store/goods):从 storage.inventory.list 选商品 → stock.check.addDetail 传 stock_ids + - 商品类(type=store/goods):从 storage.inventory.list 勾选商品 → stock.check.addDetail 传 stock_ids + · ⚠️ 服务端按「商品 + 库存库位」**拆行**:一个商品在该仓库的每个**启用库存库位**各生成一条 + 明细行(location_id/location_code 快照 + 账面取该库位库存),故「新增条数」可能多于所选商品数 + · 无启用库存库位的商品不入明细,计入 invalid_stock_ids(提示为「无效商品」) - 库位类(type=all/location):从库位列表(index.searchSpace)勾选库位 → · 已勾选库位 → stock.check.addLocationDetail 传 location_ids(库位ID直查,不解析编码) · 未勾选但手填了库位编码 → stock.check.addDetail 传 locations(兼容通道) @@ -24,6 +27,7 @@