From 4813a00ad43b0ced10d61dd7a5b0b59e9b2edeb5 Mon Sep 17 00:00:00 2001 From: liufumingren Date: Tue, 17 Nov 2026 01:01:01 +0800 Subject: [PATCH] fix(order): allow weighing during packing Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- app/service/systems/order_express.js | 17 ++++++++--------- app/service/systems/setting/warehouse.js | 2 +- app/service/systems/workbench.js | 12 ++++++------ methods/system.json | 14 +++++++------- 4 files changed, 22 insertions(+), 23 deletions(-) diff --git a/app/service/systems/order_express.js b/app/service/systems/order_express.js index b8cdd64..dce7669 100644 --- a/app/service/systems/order_express.js +++ b/app/service/systems/order_express.js @@ -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} 无返回值;未打包时抛出业务异常。 + * @return {Promise} 无返回值;未打包或打包异常时抛出业务异常。 */ 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); diff --git a/app/service/systems/setting/warehouse.js b/app/service/systems/setting/warehouse.js index bc10ddf..7b38ee1 100644 --- a/app/service/systems/setting/warehouse.js +++ b/app/service/systems/setting/warehouse.js @@ -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', diff --git a/app/service/systems/workbench.js b/app/service/systems/workbench.js index 4fa6f7f..3bb2a61 100644 --- a/app/service/systems/workbench.js +++ b/app/service/systems/workbench.js @@ -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} 无返回值;未打包时抛出错误 + * @return {Promise} 无返回值;未打包或打包异常时抛出错误 */ 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); } diff --git a/methods/system.json b/methods/system.json index df4106b..e535a5c 100644 --- a/methods/system.json +++ b/methods/system.json @@ -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 时拦截;团购波次不校验" } ] },