fix(order): allow weighing during packing
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
parent
70e823480d
commit
4813a00ad4
@ -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);
|
||||
|
||||
@ -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',
|
||||
|
||||
@ -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);
|
||||
}
|
||||
|
||||
|
||||
@ -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 时拦截;团购波次不校验"
|
||||
}
|
||||
]
|
||||
},
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user