1
This commit is contained in:
parent
ef732ca2c6
commit
43cafbba83
@ -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[]
|
||||
|
||||
@ -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) {
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user