fix(order): allow weighing during packing

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
liufumingren 2026-11-17 01:01:01 +08:00
parent 70e823480d
commit 4813a00ad4
4 changed files with 22 additions and 23 deletions

View File

@ -329,7 +329,7 @@ class OrderExpressService extends Service {
}
/**
* 散单称重前置校验:开启「散单称重是否需要打包」时,未打包订单禁止称重。
* 散单称重前置校验:开启「散单称重是否需要打包」时,打包中或已打包订单允许称重。
*
* 适用范围:订单波次范围 wave_scope 不属于 1(大团购)/ 3(小团购)时生效,
* 即未分配波次、散单、单品单件等按散单处理的订单;团购订单不校验。
@ -337,7 +337,7 @@ class OrderExpressService extends Service {
*
* @param {number} orderId 订单ID。
* @param {number|null} warehouseId 仓库ID,缺失时跳过校验。
* @return {Promise<void>} 无返回值;未打包时抛出业务异常。
* @return {Promise<void>} 无返回值;未打包或打包异常时抛出业务异常。
*/
async assertSingleOrderPackedForWeigh(orderId, warehouseId) {
const normalizedWarehouseId = Number(warehouseId || 0);
@ -361,18 +361,17 @@ class OrderExpressService extends Service {
}
const packStatus = String(orderRow.pack_status || '').trim();
if (packStatus !== 'fin') {
throw this.createBusinessError(this.buildWeighPackBlockedMessage(packStatus), 400);
if (packStatus !== 'fin' && packStatus !== 'padding') {
throw this.createBusinessError(this.buildWeighPackBlockedMessage(), 400);
}
}
/**
* 构造「散单称重需先打包」拦截文案,供各称重入口复用(保证提示语一致)。
* @param {string} packStatus 打包状态原值。
* @return {string} 拦截提示文案:打包中(padding)返回「订单打包中」,其余未完成状态返回「订单未打包」。
* @return {string} 拦截提示文案。
*/
buildWeighPackBlockedMessage(packStatus) {
return packStatus === 'padding' ? '订单打包中' : '订单未打包';
buildWeighPackBlockedMessage() {
return '订单未打包';
}
/**
@ -1124,7 +1123,7 @@ class OrderExpressService extends Service {
* @return {Promise<{order_id:number, waybill_code:string, weighing_weight:number, items_weight:number}>} 更新结果。
*/
async _updateSingleOrderWeight(orderId, waybillCode, weight, warehouseId) {
// 散单称重前置校验:开启「散单称重是否需要打包」后,未打包订单禁止称重
// 散单称重前置校验:开启「散单称重是否需要打包」后,仅打包中或已打包订单允许称重
await this.assertSingleOrderPackedForWeigh(orderId, warehouseId);
const rows = await this.findValidOrderExpressRows(orderId, warehouseId);

View File

@ -367,7 +367,7 @@ const WAREHOUSE_SETTING_FIELDS = Object.freeze([
type: 'flag',
default: false,
required: false,
description: '开启后散单称重(订单波次范围 wave_scope 非 1 大团购 / 3 小团购)前必须已打包完成(pack_status=fin),未打包时拒绝称重并返回错误,默认 false(关闭)',
description: '开启后散单称重(订单波次范围 wave_scope 非 1 大团购 / 3 小团购)须处于打包中或已打包(pack_status=padding/fin);未打包或打包异常时拒绝称重并返回错误,默认 false(关闭)',
}),
Object.freeze({
key: 'stock_warning_enabled',

View File

@ -1833,8 +1833,8 @@ class WorkbenchService extends Service {
/**
* 散单称重前置校验(工作台):开启仓库配置「散单称重是否需要打包」后,
* 波次范围(wave_scope)非 1(大团购)/ 3(小团购)的订单未打包完成
* (pack_status != fin)时禁止称重。
* 波次范围(wave_scope)非 1(大团购)/ 3(小团购)的订单,打包中或已打包
* (pack_status = padding/fin)时允许称重。
*
* 配置读取与提示文案复用 systems/order_express,避免多处判定逻辑漂移;
* 当前订单行已含 wave_scope/pack_status,故无需重复查询订单表。
@ -1842,7 +1842,7 @@ class WorkbenchService extends Service {
*
* @param {Object} orderRow 订单行(需包含 wave_scope/pack_status)
* @param {number} warehouseId 仓库ID
* @return {Promise<void>} 无返回值;未打包时抛出错误
* @return {Promise<void>} 无返回值;未打包或打包异常时抛出错误
*/
async _assertSingleWeighPackedForWeigh(orderRow, warehouseId) {
const waveScope = Number((orderRow && orderRow.wave_scope) || 0);
@ -1863,13 +1863,13 @@ class WorkbenchService extends Service {
}
const packStatus = String((orderRow && orderRow.pack_status) || '').trim();
if (packStatus === 'fin') {
if (packStatus === 'fin' || packStatus === 'padding') {
return;
}
const message = typeof orderExpressService.buildWeighPackBlockedMessage === 'function'
? orderExpressService.buildWeighPackBlockedMessage(packStatus)
: (packStatus === 'padding' ? '订单打包中' : '订单未打包');
? orderExpressService.buildWeighPackBlockedMessage()
: '订单未打包';
throw new Error(message);
}

View File

@ -3083,7 +3083,7 @@
},
{
"method": "order.updateExpressWeighingWeight",
"description": "更新订单运单称重重量。支持两种模式:1) 订单模式(order_id>0):规则:订单仅一个运单时,直接写入该运单重量;多运单时,必须传 waybill_code 并按运单写入;团购波次批量设置同一重量到波次下所有订单运单,并返回拆单汇总信息(total_weight/split_count/splits/store_name/sys_logistics_name)。2) 运单号模式(order_id=0):从运单号反查订单与波次,散单/非团购波次仅更新单个运单重量,团购波次按 wave_no+business_key 批量设置并返回拆单汇总信息。;散单称重前置打包校验:开启仓库配置 single_weigh_require_pack 后,散单路径(订单模式与运单号模式的散单/非团购波次)写入重量前校验订单波次范围与打包状态,wave_scope 非 1(大团购)/3(小团购)且 pack_status 非 fin 时拒绝称重(400);团购波次批量称重不校验;配置缺失/读取异常按关闭处理",
"description": "更新订单运单称重重量。支持两种模式:1) 订单模式(order_id>0):规则:订单仅一个运单时,直接写入该运单重量;多运单时,必须传 waybill_code 并按运单写入;团购波次批量设置同一重量到波次下所有订单运单,并返回拆单汇总信息(total_weight/split_count/splits/store_name/sys_logistics_name)。2) 运单号模式(order_id=0):从运单号反查订单与波次,散单/非团购波次仅更新单个运单重量,团购波次按 wave_no+business_key 批量设置并返回拆单汇总信息。;散单称重前置打包校验:开启仓库配置 single_weigh_require_pack 后,散单路径(订单模式与运单号模式的散单/非团购波次)写入重量前校验订单波次范围与打包状态,wave_scope 非 1(大团购)/3(小团购)且 pack_status 既非 padding 也非 fin 时拒绝称重(400);团购波次批量称重不校验;配置缺失/读取异常按关闭处理",
"isNeedAuth": false,
"isNeedLogin": true,
"headers": [
@ -3208,7 +3208,7 @@
},
{
"code": 400,
"message": "订单未打包(pack_status=padding 打包中时返回「订单打包中」)——开启仓库配置 single_weigh_require_pack 后,散单/非团购波次(wave_scope 非 1 大团购/3 小团购)订单 pack_status 未达 fin 时拒绝称重"
"message": "订单未打包——开启仓库配置 single_weigh_require_pack 后,散单/非团购波次(wave_scope 非 1 大团购/3 小团购)订单仅在 pack_status 为 padding(打包中)或 fin(已打包)时允许称重"
},
{
"code": 404,
@ -15787,7 +15787,7 @@
"name": "subject_config.single_weigh_require_pack",
"type": "boolean",
"required": false,
"description": "散单称重是否需要打包(flag,默认 false 关闭):开启后散单称重(订单波次范围 wave_scope 非 1 大团购/3 小团购)前必须已打包完成(pack_status=fin),未打包时拒绝称重并返回错误"
"description": "散单称重是否需要打包(flag,默认 false 关闭):开启后散单称重(订单波次范围 wave_scope 非 1 大团购/3 小团购)须处于打包中或已打包(pack_status=padding/fin);未打包或打包异常时拒绝称重并返回错误"
},
{
"name": "subject_config.return_unpack_max_record_minutes",
@ -15903,7 +15903,7 @@
},
{
"method": "setting.warehouse.getFieldMeta",
"description": "获取仓库设置字段元信息;本次 list 新增「大团购打包系数」(key=big_group_pack_coefficient,type=number,default=3,min=0.1,单位秒/单,用于大团购波次打包时长闸门与倒计时);本次新增「散单称重是否需要打包」(key=single_weigh_require_pack,type=flag,default=false,required=false,开启后散单称重(wave_scope 非 1 大团购/3 小团购)前必须已打包完成 pack_status=fin);本次新增「启用自动出库」(key=auto_outbound_enabled,type=flag,default=false,required=false);「自动出库规则」(key=auto_outbound_rules)由 object 调整为 array(default=[],item_keys 仅含 require_pack/require_weigh/require_sync/exclude_same_day_outbound/same_day_outbound_deadline_time/same_day_outbound_release_time)",
"description": "获取仓库设置字段元信息;本次 list 新增「大团购打包系数」(key=big_group_pack_coefficient,type=number,default=3,min=0.1,单位秒/单,用于大团购波次打包时长闸门与倒计时);本次新增「散单称重是否需要打包」(key=single_weigh_require_pack,type=flag,default=false,required=false,开启后散单称重(wave_scope 非 1 大团购/3 小团购)须处于打包中或已打包(pack_status=padding/fin));本次新增「启用自动出库」(key=auto_outbound_enabled,type=flag,default=false,required=false);「自动出库规则」(key=auto_outbound_rules)由 object 调整为 array(default=[],item_keys 仅含 require_pack/require_weigh/require_sync/exclude_same_day_outbound/same_day_outbound_deadline_time/same_day_outbound_release_time)",
"isNeedAuth": false,
"isNeedLogin": true,
"headers": [
@ -16166,7 +16166,7 @@
"type": "boolean",
"required": false,
"source": "body.subject_config",
"description": "散单称重是否需要打包(flag,默认 false 关闭):开启后散单称重(wave_scope 非 1 大团购/3 小团购)前必须已打包完成(pack_status=fin)。仅接受布尔/like-flag(true/1/'1'/'true' → true;false/0/'0'/'false' → false),非法值报 400:subject_config.single_weigh_require_pack 必须是布尔值"
"description": "散单称重是否需要打包(flag,默认 false 关闭):开启后散单称重(wave_scope 非 1 大团购/3 小团购)须处于打包中或已打包(pack_status=padding/fin)。仅接受布尔/like-flag(true/1/'1'/'true' → true;false/0/'0'/'false' → false),非法值报 400:subject_config.single_weigh_require_pack 必须是布尔值"
},
{
"name": "subject_config.return_unpack_max_record_minutes",
@ -36583,7 +36583,7 @@
},
{
"method": "workbench.sendWeight",
"description": "工作台称重上报(免登录、免权限、免鉴权,以工作台 token 鉴权):仓库由服务端从 token 解析注入(body 传入 warehouse_id/workbench_id 一律忽略,禁止前端传值),入参条码(运单号)+ 重量(单位克,必须为正整数);条码→运单记录(wms_order_express,按 waybill_code+warehouse_id 精确匹配)→ 定位订单分表(current→history→dispatch,序列表定位优先,命中先查对应分表)→ 更新运单称重重量 weighing_weight(DB 统一单位 g):散单(wave_id=0)仅更新该运单;团购波次(wave_type=1)批量更新波次下所有未拦截订单的运单称重重量并返回 total_weight(单件重量×订单数)与 order_count;非团购波次降级为散单逻辑;拦截流程中的订单不允许称重;写称重操作日志(ORDER_WEIGH,团购逐订单批量写);保留系统日志(systemInit 未声明免日志);成功返回 flag=success、code=200;散单称重前置打包校验:开启仓库配置 single_weigh_require_pack 后,散单路径(订单 wave_scope 非 1 大团购/3 小团购)在拦截校验后校验打包状态,pack_status 非 fin 时拒绝称重(业务失败 code=400,提示末尾附 [条码]);团购波次批量称重不校验",
"description": "工作台称重上报(免登录、免权限、免鉴权,以工作台 token 鉴权):仓库由服务端从 token 解析注入(body 传入 warehouse_id/workbench_id 一律忽略,禁止前端传值),入参条码(运单号)+ 重量(单位克,必须为正整数);条码→运单记录(wms_order_express,按 waybill_code+warehouse_id 精确匹配)→ 定位订单分表(current→history→dispatch,序列表定位优先,命中先查对应分表)→ 更新运单称重重量 weighing_weight(DB 统一单位 g):散单(wave_id=0)仅更新该运单;团购波次(wave_type=1)批量更新波次下所有未拦截订单的运单称重重量并返回 total_weight(单件重量×订单数)与 order_count;非团购波次降级为散单逻辑;拦截流程中的订单不允许称重;写称重操作日志(ORDER_WEIGH,团购逐订单批量写);保留系统日志(systemInit 未声明免日志);成功返回 flag=success、code=200;散单称重前置打包校验:开启仓库配置 single_weigh_require_pack 后,散单路径(订单 wave_scope 非 1 大团购/3 小团购)在拦截校验后校验打包状态,仅 pack_status 既非 padding 也非 fin 时拒绝称重(业务失败 code=400,提示末尾附 [条码]);团购波次批量称重不校验",
"isNeedAuth": false,
"isNeedLogin": false,
"isNeedRight": false,
@ -36708,7 +36708,7 @@
},
{
"code": 400,
"message": "订单未打包(pack_status=padding 打包中时返回「订单打包中」)——开启仓库配置 single_weigh_require_pack 后,wave_scope 非 1 大团购/3 小团购 且 pack_status 非 fin 时拦截;团购波次不校验"
"message": "订单未打包——开启仓库配置 single_weigh_require_pack 后,wave_scope 非 1 大团购/3 小团购 且 pack_status 既非 padding 也非 fin 时拦截;团购波次不校验"
}
]
},