This commit is contained in:
yin 2026-10-03 18:00:19 +08:00
parent ef732ca2c6
commit 43cafbba83
2 changed files with 47 additions and 6 deletions

View File

@ -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[]

View File

@ -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 @@
<div class="picker-body">
<!-- ===== 商品类任务:从库存明细挑选商品 → stock_ids ===== -->
<template v-if="!isLocationMode">
<el-alert type="info" :closable="false" show-icon :title="goodsAlertText" />
<!-- 筛选行 -->
<div class="picker-filters">
<el-input
@ -306,6 +310,18 @@ const locationAlertText = computed(() =>
: '按库位盘点:请从下方列表勾选要盘点的库位(后端按库位ID直接入库,无需担心编码写错)。'
)
/**
* 商品模式说明:addDetail 的 stock_ids 按「商品 + 库存库位」拆行
*
* 列表里的库位仅供参考(同一商品可能在多个库位有库存,去重后只传 stock_id),
* 盘点范围由服务端按「该商品在各启用库存库位」展开 → 提示用户「新增条数」可能多于所选商品数。
*/
const goodsAlertText = computed(
() =>
'按商品添加:系统按该商品在仓库的每个启用库存库位拆成多条明细(一个「商品+库位」= 一条明细行,账面数量取该库位库存)。' +
'下方列表的库位仅供参考、不限制盘点范围;无启用库存库位的商品会被跳过(计入无效商品)。'
)
/** 库位模式:勾了库位 / 填了库位编码 / all 类型(允许不选=全仓) */
const canSubmit = computed(() => {
if (isLocationMode.value) {
@ -550,7 +566,7 @@ function toStringList(value: unknown): string[] {
*/
function resolveAddResult(
res: any,
invalid: { ids?: number[]; codes?: string[]; stocks?: number[] } = {}
invalid: { ids?: number[]; codes?: string[]; stocks?: number[]; addedUnit?: string } = {}
): { added: number; skipped: number } {
if (!isCheckApiSuccess(res)) {
throw new Error(res?.message || '添加盘点明细失败')
@ -558,11 +574,16 @@ function resolveAddResult(
const data = res?.data ?? res
const added = Number(data?.added ?? 0)
const skipped = Number(data?.skipped ?? 0)
const parts = [`新增 ${added} 项`]
// added 是**明细行数**;商品路径按「商品+库位」拆行时行数可能多于所选商品数 → 允许自定义单位文案
const parts = [`新增 ${added} ${invalid.addedUnit ?? '项'}`]
if (skipped) parts.push(`跳过已存在 ${skipped} 项`)
if (invalid.ids?.length) parts.push(`无效库位 ${invalid.ids.length} 个`)
if (invalid.codes?.length) parts.push(`无效库位编码 ${invalid.codes.length} 个`)
if (invalid.stocks?.length) parts.push(`无效商品 ${invalid.stocks.length} 个`)
if (invalid.stocks?.length) {
parts.push(
`无效商品 ${invalid.stocks.length} 个(不存在 / 货主不一致 / 无启用库存库位)`
)
}
if (invalid.ids?.length || invalid.codes?.length || invalid.stocks?.length) {
ElMessage.warning(parts.join(','))
} else {
@ -659,7 +680,11 @@ async function submitGoodsRows(taskId: number) {
try {
const res: any = await stockCheckAddDetail({ id: taskId, stock_ids: stockIds })
const data = res?.data ?? res
const result = resolveAddResult(res, { stocks: toNumberList(data?.invalid_stock_ids) })
const result = resolveAddResult(res, {
stocks: toNumberList(data?.invalid_stock_ids),
// 商品路径服务端按「商品+库位」拆行 → 明确 added 是明细行数
addedUnit: '条明细(按商品+库位拆分)'
})
emit('update:visible', false)
emit('success', result)
} catch (e: any) {