docs(api): 同步 workbench 打包接口文档、变更记录与方法路由
This commit is contained in:
parent
f06dc3d765
commit
17944bcf01
File diff suppressed because one or more lines are too long
@ -1,4 +1,130 @@
|
||||
[
|
||||
{
|
||||
"version": "2026.09.21-workbench.getWorkbenchInfo-order-fields",
|
||||
"date": "2026-09-21",
|
||||
"type": "updated",
|
||||
"summary": "workbench.getWorkbenchInfo 的 current_orders 补齐货主备注(store_remark)与运单信息(express:物流公司/称重重量/包材名称),与 queryOrder 口径一致",
|
||||
"methods": [
|
||||
"workbench.getWorkbenchInfo"
|
||||
],
|
||||
"notes": [
|
||||
"背景:getWorkbenchInfo 返回的 current_orders 相比 queryOrder 缺货主备注与包材信息,前端无法填充。",
|
||||
"散单任务(pack_mode=1)按 order_id(优先任务 waybill_code)补 wms_order_express 的 logistics_name/weighing_weight/package_material_name_snapshot 与 wms_store_warehouse.store_remask;团购任务为波次维度不适用(store_remark 空、express 为 null)。查询并行执行,异常降级不阻断主信息。",
|
||||
"代码变更:app/service/systems/workbench.js#buildCurrentPackingInfo;回归测试 test/workbench_pack_waybill_dimension.test.cjs(24 用例)。"
|
||||
],
|
||||
"module": "workbench"
|
||||
},
|
||||
{
|
||||
"version": "2026.09.21-workbench.packOrder-key-forward-fix",
|
||||
"date": "2026-09-21",
|
||||
"type": "updated",
|
||||
"summary": "修复 workbench.packOrder method 层未透传 key 导致 key 模式不生效(请求带 key 仍报发货单号不能为空)",
|
||||
"methods": [
|
||||
"workbench.packOrder"
|
||||
],
|
||||
"notes": [
|
||||
"根因:app/service/systemMethods/workbench.js#packOrder 解构白名单未包含 key,packOrderByToken 收不到 key 回退旧参数模式,新客户端只传 token+key 时报「发货单号不能为空」。",
|
||||
"修复:method 层透传 key;回归测试 test/workbench_pack_waybill_dimension.test.cjs 新增 method 层透传用例(22 用例)。"
|
||||
],
|
||||
"module": "workbench"
|
||||
},
|
||||
{
|
||||
"version": "2026.09.21-workbench.packOrder-legacy-compat",
|
||||
"date": "2026-09-21",
|
||||
"type": "updated",
|
||||
"summary": "workbench.packOrder 代码保留旧参数模式过渡兼容(不传 key 时直传参数),文档主推 token+key 新接口",
|
||||
"methods": [
|
||||
"workbench.packOrder",
|
||||
"workbench.business"
|
||||
],
|
||||
"notes": [
|
||||
"设备端过渡方案:代码同时支持新 key 模式(优先)与旧参数模式(不传 key 时直传 delivery_order_code 等,后续版本移除),文档按 token+key 新接口展示。",
|
||||
"代码变更:app/service/systems/workbench.js#packOrderByToken 与 #business(packOrder) 分支恢复旧参数回退;回归测试 test/workbench_pack_waybill_dimension.test.cjs(21 用例,含旧参数兼容)。"
|
||||
],
|
||||
"module": "workbench"
|
||||
},
|
||||
{
|
||||
"version": "2026.09.21-workbench.packOrder-key-only",
|
||||
"date": "2026-09-21",
|
||||
"type": "updated",
|
||||
"summary": "workbench.packOrder 除 token、key 外不再接收任何订单相关信息:订单参数一律由后端从打包上下文缓存拉取(防篡改)",
|
||||
"methods": [
|
||||
"workbench.packOrder",
|
||||
"workbench.business"
|
||||
],
|
||||
"notes": [
|
||||
"workbench.packOrder 入参收敛为 token + key,移除旧参数(delivery_order_code/waybill_code/wave_no/status/pack_time/wave_total_orders/items_count/items_total),body 传入其它字段一律忽略;缺 key 返回 400、key 过期返回 400、跨仓库/跨工作台使用返回 403。",
|
||||
"workbench.business 的 packOrder 分支同样只接受 key(订单信息取自缓存,仓库/工作台取缓存值)。",
|
||||
"代码变更:app/service/systems/workbench.js 新增 _loadPackCtx(凭 key 拉取缓存,缺 key/过期抛错);packOrderByToken 只取 token+key 并捕获 _loadPackCtx 异常转 400;business(packOrder) 分支改走 key 消费。",
|
||||
"回归测试 test/workbench_pack_waybill_dimension.test.cjs(21 用例,含缺 key 400、business 只接受 key、body 订单参数忽略)。"
|
||||
],
|
||||
"module": "workbench"
|
||||
},
|
||||
{
|
||||
"version": "2026.09.21-workbench.packOrder-key-mode",
|
||||
"date": "2026-09-21",
|
||||
"type": "updated",
|
||||
"summary": "workbench.queryOrder 返回打包上下文 key(20 分钟缓存);workbench.packOrder 精简为 token+key 消费缓存参数(旧参数模式保留兼容)",
|
||||
"methods": [
|
||||
"workbench.queryOrder",
|
||||
"workbench.packOrder"
|
||||
],
|
||||
"notes": [
|
||||
"workbench.queryOrder 扫码查询成功时生成打包上下文 key(wpck 前缀 + 32 位随机段),缓存 key workbench:packctx:{key}、TTL 1200s,内容含 warehouse_id/workbench_id/order_id/delivery_order_code/wave_no/waybill_code/is_sandan,响应新增 key 字段;缓存写入失败仅告警不阻断查询。",
|
||||
"workbench.packOrder 推荐只传 token + key:后端按 key 拉取缓存参数执行打包(数量参数后端复查兜底),跨仓库/跨工作台消费他人 key 返回 403、key 过期返回 400(提示重新扫码);旧参数模式(不传 key 直接传 delivery_order_code 等)保留兼容。",
|
||||
"代码变更:app/service/systems/workbench.js 新增 WORKBENCH_PACK_CTX_CACHE_PREFIX/TTL/KEY_PREFIX 常量、generatePackCtxKey、getWorkbenchPackCtxCacheKey;_queryOrder 步骤7 写打包上下文缓存并返回 key(新增 workbench_id 入参);packOrderByToken 增加 key 消费与归属校验;queryOrderByToken 注入 workbench_id。",
|
||||
"回归测试 test/workbench_pack_waybill_dimension.test.cjs(19 用例,含 key 模式/过期/跨仓/跨台/旧模式兼容)。"
|
||||
],
|
||||
"module": "workbench"
|
||||
},
|
||||
{
|
||||
"version": "2026.09.21-workbench.packOrder-remove-users-param",
|
||||
"date": "2026-09-21",
|
||||
"type": "updated",
|
||||
"summary": "workbench.packOrder 移除 users 入参:打包人一律由服务端取该工作台绑定成员(wms_workbench_member)回填",
|
||||
"methods": [
|
||||
"workbench.packOrder"
|
||||
],
|
||||
"notes": [
|
||||
"打包人数据源收敛为工作台绑定成员(bindMember/removeMember 登入登出链路持久化到 wms_workbench_member),packOrder 不再接收 users 入参,写入 wms_pack_task_packer 与 operator_text 的打包人一律由服务端按 workbench_id 回填;旧设备端传 users 将被忽略。",
|
||||
"代码变更:app/service/systems/workbench.js#_packOrder 移除 users 解构与上报优先分支,步骤7 直接回填绑定成员;回归测试 test/workbench_pack_waybill_dimension.test.cjs 更新(13 用例,含「旧设备端仍传 users:一律忽略」)。"
|
||||
],
|
||||
"module": "workbench"
|
||||
},
|
||||
{
|
||||
"version": "2026.09.21-workbench.removeMember-auto-finish-pack",
|
||||
"date": "2026-09-21",
|
||||
"type": "updated",
|
||||
"summary": "workbench.packOrder 打包人缺省自动回填工作台绑定成员;workbench.removeMember 成员全部登出后自动结束未结束的打包任务",
|
||||
"methods": [
|
||||
"workbench.packOrder",
|
||||
"workbench.removeMember"
|
||||
],
|
||||
"notes": [
|
||||
"workbench.packOrder 的 users 入参缺省/为空时,后端自动查询该工作台绑定成员(wms_workbench_member)回填 wms_pack_task_packer 与 operator_text,打包人数据源单一,设备端无需重复上报;上报时优先使用上报值。",
|
||||
"workbench.removeMember 软删除成员行后统计剩余成员,剩余为 0 时自动结束该工作台所有未结束打包任务(status<2 → 2 并写 end_time),同步订单打包状态(散单按订单、团购按波次,与 _finishPack 语义一致)、写完成操作日志、复位摄像头 OSD、失效 token 缓存;响应新增 auto_finished_pack(finished/task_ids)。",
|
||||
"代码变更:app/service/systems/workbench.js#_packOrder(步骤7 成员回填)、#removeWorkbenchMember(登出后剩余成员检查)、新增 #_finishAllPackTasksByMemberLogout;回归测试 test/workbench_pack_waybill_dimension.test.cjs(13 用例)。"
|
||||
],
|
||||
"module": "workbench"
|
||||
},
|
||||
{
|
||||
"version": "2026.09.21-workbench.packOrder-waybill-dimension",
|
||||
"date": "2026-09-21",
|
||||
"type": "updated",
|
||||
"summary": "workbench.packOrder 支持运单维度打包流水(一单多号:主单号/子单号流水互不覆盖),workbench.queryOrder 的 pack_flag 改为运单维度判定",
|
||||
"methods": [
|
||||
"workbench.packOrder",
|
||||
"workbench.queryOrder",
|
||||
"workbench.business"
|
||||
],
|
||||
"notes": [
|
||||
"背景:一单多号订单(wms_order_express 同 order_id 下 business_key=1 主单号 / >1 子单号)此前按订单维度打包,任一运单打包后订单 pack_status 非 none,导致另一运单被误判为已打包、无法写入打包流水。",
|
||||
"workbench.packOrder 新增可选入参 waybill_code:散单按「订单+运单号」维度写入 wms_pack_task.waybill_code 并去重(同时清理同订单历史 waybill_code 为空的旧流水),主/子单号流水互不覆盖;未传运单号(旧设备端)保持订单维度;团购为波次维度,不使用运单号。",
|
||||
"workbench.queryOrder 的 pack_flag 改为运单维度判定:查询该运单号是否已有打包流水(waybill_code 命中,或历史订单级流水 waybill_code 为空兜底),流水查询异常时降级为订单级 pack_status 判定。",
|
||||
"代码变更:app/service/systems/workbench.js#_packOrder(步骤2.5 运单归属解析、步骤5 去重、packData.waybill_code、步骤7.5 OSD 优先展示打包运单号)、#_queryOrder(步骤6 pack_flag 运单级判定);回归测试 test/workbench_pack_waybill_dimension.test.cjs(8 用例)。"
|
||||
],
|
||||
"module": "workbench"
|
||||
},
|
||||
{
|
||||
"version": "2026.09.20-workbench-pack-backfill-confirm-print",
|
||||
"date": "2026-09-20",
|
||||
|
||||
@ -1,8 +1,8 @@
|
||||
{
|
||||
"module": "system",
|
||||
"description": "系统接口标准入口,method 对应系统内置方法,全部使用 POST 请求,参数统一放在 body 内",
|
||||
"version": "0.3.142",
|
||||
"updatedAt": "2026-09-19",
|
||||
"version": "0.3.143",
|
||||
"updatedAt": "2026-09-21",
|
||||
"headers": [
|
||||
{
|
||||
"name": "platform",
|
||||
@ -33808,7 +33808,7 @@
|
||||
},
|
||||
{
|
||||
"method": "workbench.business",
|
||||
"description": "工作台业务入口(免登录免鉴权,入参 name + data)。name 支持 queryOrder/query(条码查订单,data 需 barcode+warehouseId)、packOrder(开始打包)、finishPack(结束打包)、sendWeight(称重);不支持的业务名称报错。以下响应结构为 queryOrder/query(条码查订单)的返回。",
|
||||
"description": "工作台业务入口(免登录免鉴权,入参 name + data)。name 支持 queryOrder/query(条码查订单,data 需 barcode+warehouseId)、packOrder(开始打包,凭 key 从后端缓存取订单信息防篡改;不传 key 时旧参数模式过渡兼容)、finishPack(结束打包)、sendWeight(称重);不支持的业务名称报错。以下响应结构为 queryOrder/query(条码查订单)的返回。",
|
||||
"isNeedAuth": false,
|
||||
"isNeedLogin": false,
|
||||
"headers": [],
|
||||
@ -33983,7 +33983,7 @@
|
||||
{
|
||||
"name": "pack_flag",
|
||||
"type": "number",
|
||||
"description": "打包标志(仅散单 isSandan=1 返回,团购不返回):打包状态(pack_status)不等于 none 时为 1,等于 none 时为 0"
|
||||
"description": "打包标志(仅散单 isSandan=1 返回,团购不返回):按运单维度判定——该运单号已有打包流水(wms_pack_task.waybill_code 命中,或历史订单级流水 waybill_code 为空兜底)时为 1,否则为 0;主单号/子单号互不影响"
|
||||
}
|
||||
]
|
||||
},
|
||||
@ -34306,7 +34306,7 @@
|
||||
"name": "current_orders",
|
||||
"type": "array",
|
||||
"required": true,
|
||||
"description": "当前正在打包的订单数组(该工作台全部未结束任务(status<2)按任务 id 倒序,逐单按 current→dispatch 分表补发货单号;无进行中任务或查询异常时为空数组)"
|
||||
"description": "当前正在打包的订单数组(该工作台全部未结束任务(status<2)按任务 id 倒序,逐单按 current→dispatch 分表补发货单号,散单任务另补货主备注(store_remark)与运单信息(express:物流公司/称重重量/包材名称,与 workbench.queryOrder 口径一致);无进行中任务或查询异常时为空数组)"
|
||||
},
|
||||
{
|
||||
"name": "current_orders[].task_id",
|
||||
@ -34386,6 +34386,42 @@
|
||||
"required": true,
|
||||
"description": "货主ID(订单分表未命中时为 0)"
|
||||
},
|
||||
{
|
||||
"name": "current_orders[].store_remark",
|
||||
"type": "string",
|
||||
"required": false,
|
||||
"description": "货主备注(合约表 wms_store_warehouse.store_remask;仅散单任务返回,团购为空字符串,与 workbench.queryOrder 的 store_remark 口径一致)"
|
||||
},
|
||||
{
|
||||
"name": "current_orders[].express",
|
||||
"type": "object",
|
||||
"required": false,
|
||||
"description": "运单信息(仅散单任务返回,团购为 null;与 workbench.queryOrder 的 express 口径一致)"
|
||||
},
|
||||
{
|
||||
"name": "current_orders[].express.waybill_code",
|
||||
"type": "string",
|
||||
"required": false,
|
||||
"description": "运单号"
|
||||
},
|
||||
{
|
||||
"name": "current_orders[].express.logistics_name",
|
||||
"type": "string",
|
||||
"required": false,
|
||||
"description": "物流公司名称"
|
||||
},
|
||||
{
|
||||
"name": "current_orders[].express.weighing_weight",
|
||||
"type": "number",
|
||||
"required": false,
|
||||
"description": "称重重量(克)"
|
||||
},
|
||||
{
|
||||
"name": "current_orders[].express.package_material_name",
|
||||
"type": "string",
|
||||
"required": false,
|
||||
"description": "包材名称(wms_order_express.package_material_name_snapshot,无包材为空字符串)"
|
||||
},
|
||||
{
|
||||
"name": "current_orders[].items_count",
|
||||
"type": "number",
|
||||
@ -34589,7 +34625,7 @@
|
||||
},
|
||||
{
|
||||
"method": "workbench.removeMember",
|
||||
"description": "移除工作台成员(免登录、免鉴权,以工作台 token 鉴权):入参成员行 ids 与工作台 token,token 优先校验(无 token 返回 401、token 无效返回 403),按 token 解析工作台后仅软删除归属于该工作台的成员行(wms_workbench_member 副表,user_id 可为空兼容非系统账号用户),返回移除数量与行ID列表",
|
||||
"description": "移除工作台成员(免登录、免鉴权,以工作台 token 鉴权):入参成员行 ids 与工作台 token,token 优先校验(无 token 返回 401、token 无效返回 403),按 token 解析工作台后仅软删除归属于该工作台的成员行(wms_workbench_member 副表,user_id 可为空兼容非系统账号用户),返回移除数量与行ID列表;移除后该工作台已无任何成员时自动结束其所有未结束的打包任务(wms_pack_task.status<2 置 2 并写 end_time,同步回写订单打包状态与补确认打印状态、写完成操作日志、复位摄像头 OSD、失效 token 缓存,与 finishPack 语义一致),响应附 auto_finished_pack",
|
||||
"isNeedAuth": false,
|
||||
"isNeedLogin": false,
|
||||
"headers": [],
|
||||
@ -34621,6 +34657,24 @@
|
||||
"type": "array",
|
||||
"required": true,
|
||||
"description": "实际移除的成员行ID列表"
|
||||
},
|
||||
{
|
||||
"name": "auto_finished_pack",
|
||||
"type": "object",
|
||||
"required": false,
|
||||
"description": "成员全部登出后的自动结束打包结果(仅移除后该工作台无成员时才有实际动作;其余情况 finished=0)"
|
||||
},
|
||||
{
|
||||
"name": "auto_finished_pack.finished",
|
||||
"type": "number",
|
||||
"required": true,
|
||||
"description": "自动结束的打包任务数量"
|
||||
},
|
||||
{
|
||||
"name": "auto_finished_pack.task_ids",
|
||||
"type": "array",
|
||||
"required": true,
|
||||
"description": "自动结束的打包任务ID列表"
|
||||
}
|
||||
],
|
||||
"errors": [
|
||||
@ -34718,7 +34772,7 @@
|
||||
},
|
||||
{
|
||||
"method": "workbench.packOrder",
|
||||
"description": "工作台打包上报(免登录、免权限、免鉴权,以工作台 token 鉴权):仓库与工作台均由服务端从 token 解析注入(body 传入 warehouse_id/workbench_id 一律忽略,禁止前端传值),入参发货单号、波次号、状态、打包时间、波次总订单数、SKU 品种数、商品总件数、打包人员(以上数量以服务端复查为准,设备上报仅交叉校验);按发货单号定位订单(current→dispatch 分表),同一工作台存在上一个未结束任务时先关闭(同步回写旧订单打包状态并补确认打印状态,并将工作台绑定摄像头 OSD 复位为「无任务」,新任务 OSD 在其后串行下发避免被复位覆盖),散单按 order_id、团购按 wave_no 去重后创建打包任务(wms_pack_task,缺失/非法 status 归一化为 1=打包中),写入打包人员(wms_pack_task_packer)与 operator_text、下发 OSD 到工作台绑定摄像头(散单显示运单号、团购显示波次号+订单总量,并写 Redis osd_{workbenchId} 缓存)、写操作日志;打包状态变更后主动失效对应工作台 token 缓存,保证 getWorkbenchInfo 尽快返回最新打包信息;团购单(isSandan=0)响应附 batch 波次信息(波次订单数为 current+dispatch 分表实时统计);拦截流程中的订单不允许打包(散单直接拒绝、团购波次静默跳过并视为完成);保留系统日志(systemInit 未声明免日志);成功返回 flag=success、code=200",
|
||||
"description": "工作台打包上报(免登录、免权限、免鉴权,以工作台 token 鉴权):推荐只传 token + key,订单相关信息(订单号/波次号/运单号)由后端从缓存拉取(前端先经 workbench.queryOrder 扫码拿到 key,20 分钟有效,防篡改);不传 key 时旧参数模式(delivery_order_code 等直传)过渡兼容,后续版本将移除;仓库与工作台均由服务端从 token 解析注入(禁止前端传值);跨仓库/跨工作台消费他人 key 返回 403、key 缺失或过期返回 400(请重新扫码)。打包流程:按发货单号定位订单(current→dispatch 分表),同一工作台存在上一个未结束任务时先关闭(同步回写旧订单打包状态并补确认打印状态,并将工作台绑定摄像头 OSD 复位为「无任务」,新任务 OSD 在其后串行下发避免被复位覆盖),散单去重(传运单号按 order_id+waybill_code、未传按 order_id)、团购按 wave_no 去重后创建打包任务(wms_pack_task,status 归一化为 1=打包中,散单传运单号时 waybill_code 写入流水),写入打包人员(wms_pack_task_packer,自动取该工作台绑定成员 wms_workbench_member)与 operator_text、下发 OSD 到工作台绑定摄像头(散单优先展示打包运单号、团购显示波次号+订单总量,并写 Redis osd_{workbenchId} 缓存)、写操作日志;打包状态变更后主动失效对应工作台 token 缓存,保证 getWorkbenchInfo 尽快返回最新打包信息;团购单(isSandan=0)响应附 batch 波次信息(波次订单数为 current+dispatch 分表实时统计);拦截流程中的订单不允许打包(散单直接拒绝、团购波次静默跳过并视为完成);保留系统日志(systemInit 未声明免日志);成功返回 flag=success、code=200",
|
||||
"isNeedAuth": false,
|
||||
"isNeedLogin": false,
|
||||
"isNeedRight": false,
|
||||
@ -34732,60 +34786,11 @@
|
||||
"description": "工作台 token(64 位,工作台身份凭证;仓库与工作台由服务端从 token 解析注入)"
|
||||
},
|
||||
{
|
||||
"name": "delivery_order_code",
|
||||
"name": "key",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"source": "body",
|
||||
"description": "发货单号(必填,用于定位订单)"
|
||||
},
|
||||
{
|
||||
"name": "wave_no",
|
||||
"type": "string",
|
||||
"required": false,
|
||||
"source": "body",
|
||||
"description": "波次号(不传时取订单 wave_no)"
|
||||
},
|
||||
{
|
||||
"name": "status",
|
||||
"type": "number",
|
||||
"required": false,
|
||||
"source": "body",
|
||||
"description": "打包状态(缺失或非法时归一化为 1=打包中;>=2 视为完成并写 end_time)"
|
||||
},
|
||||
{
|
||||
"name": "pack_time",
|
||||
"type": "number",
|
||||
"required": false,
|
||||
"source": "body",
|
||||
"description": "打包时间(秒级时间戳,缺省为当前时间)"
|
||||
},
|
||||
{
|
||||
"name": "wave_total_orders",
|
||||
"type": "number",
|
||||
"required": false,
|
||||
"source": "body",
|
||||
"description": "波次总订单数(仅交叉校验日志,落库以服务端复查为准:团购取 current+dispatch 分表实时统计的波次订单数)"
|
||||
},
|
||||
{
|
||||
"name": "items_count",
|
||||
"type": "number",
|
||||
"required": false,
|
||||
"source": "body",
|
||||
"description": "SKU 品种数(仅交叉校验日志,落库以服务端复查为准:散单取订单 item_count、团购取波次商品 SKU 聚合数)"
|
||||
},
|
||||
{
|
||||
"name": "items_total",
|
||||
"type": "number",
|
||||
"required": false,
|
||||
"source": "body",
|
||||
"description": "商品总件数(仅交叉校验日志,落库以服务端复查为准:散单取订单 items_total、团购取波次商品 SKU 聚合件数)"
|
||||
},
|
||||
{
|
||||
"name": "users",
|
||||
"type": "array",
|
||||
"required": false,
|
||||
"source": "body",
|
||||
"description": "打包人员数组,元素含 wms_account_id(或 id,账号ID,可空)与 real_name(姓名);写入 wms_pack_task_packer 并回写 operator_text"
|
||||
"description": "打包上下文 key(来自 workbench.queryOrder 响应,20 分钟有效;凭 key 由后端从缓存拉取订单号/波次号/运单号,参数后端维护防篡改,跨仓库/跨工作台使用返回 403、过期返回 400)"
|
||||
}
|
||||
],
|
||||
"response": [
|
||||
@ -35081,7 +35086,7 @@
|
||||
},
|
||||
{
|
||||
"method": "workbench.queryOrder",
|
||||
"description": "工作台条码查询订单(免登录、免权限、免鉴权,以工作台 token 鉴权):仓库与工作台均由服务端从 token 解析注入(body 传入 warehouse_id/workbench_id 一律忽略,禁止前端传值,防止跨仓库查单),入参条码(运单号);条码→运单记录(wms_order_express,按 waybill_code+warehouse_id+status=1 精确匹配)→ 序列表定位优先、未命中按 current→dispatch 回退遍历订单分表 → 组装查询结果(barcode/waybill_code/isSandan/store_remark/express/order/items/source_table);散单(isSandan=1)order 附拦截/打包 0/1 标志 intercept_flag/pack_flag(拦截/打包状态空值归一化为 none,非 none 记 1);团购(isSandan=0,波次类型 wave_type=1)附 batch 波次信息(wave_id/wave_no/wave_type/total_orders,total_orders 为 current+dispatch 分表实时统计并带 15s 短缓存兜底);items 逐项合并 stock 详情(sku_property/stock_unit/barcodes/image_url/packing_requirements/need_recheck(是否需要复核:Y=需要 N=不需要(免验)));store_remark 来自合约表 store_warehouse.store_remask;只读查询,不涉及缓存失效;保留系统日志(systemInit 未声明免日志);成功返回 flag=success、code=200",
|
||||
"description": "工作台条码查询订单(免登录、免权限、免鉴权,以工作台 token 鉴权):仓库与工作台均由服务端从 token 解析注入(body 传入 warehouse_id/workbench_id 一律忽略,禁止前端传值,防止跨仓库查单),入参条码(运单号);条码→运单记录(wms_order_express,按 waybill_code+warehouse_id+status=1 精确匹配)→ 序列表定位优先、未命中按 current→dispatch 回退遍历订单分表 → 组装查询结果(barcode/waybill_code/isSandan/store_remark/express/order/items/source_table);散单(isSandan=1)order 附拦截/打包 0/1 标志 intercept_flag/pack_flag(拦截标志:拦截状态空值归一化为 none,非 none 记 1;打包标志:按运单维度判定,该运单号已有打包流水 wms_pack_task.waybill_code 命中或历史订单级流水 waybill_code 为空兜底时为 1,否则 0,主单号/子单号互不影响);团购(isSandan=0,波次类型 wave_type=1)附 batch 波次信息(wave_id/wave_no/wave_type/total_orders,total_orders 为 current+dispatch 分表实时统计并带 15s 短缓存兜底);items 逐项合并 stock 详情(sku_property/stock_unit/barcodes/image_url/packing_requirements/need_recheck(是否需要复核:Y=需要 N=不需要(免验)));store_remark 来自合约表 store_warehouse.store_remask;只读查询,不涉及缓存失效;保留系统日志(systemInit 未声明免日志);成功返回 flag=success、code=200;查询成功时生成打包上下文 key(wpck 前缀 + 随机段,Redis 缓存 workbench:packctx:{key},TTL 20 分钟,内容含订单号/波次号/运单号/归属仓库与工作台,后端维护防篡改)并在响应返回 key,供 workbench.packOrder 凭 key 打包",
|
||||
"isNeedAuth": false,
|
||||
"isNeedLogin": false,
|
||||
"isNeedRight": false,
|
||||
@ -35103,6 +35108,12 @@
|
||||
}
|
||||
],
|
||||
"response": [
|
||||
{
|
||||
"name": "key",
|
||||
"type": "string",
|
||||
"required": false,
|
||||
"description": "打包上下文 key(20 分钟有效,凭此 key 调用 workbench.packOrder 打包,参数后端维护防篡改;缓存写入失败时缺省)"
|
||||
},
|
||||
{
|
||||
"name": "barcode",
|
||||
"type": "string",
|
||||
@ -35299,7 +35310,7 @@
|
||||
"name": "order.pack_flag",
|
||||
"type": "number",
|
||||
"required": false,
|
||||
"description": "打包标志(仅散单 isSandan=1 返回):打包状态空值归一化为 none,非 none 记 1 否则 0"
|
||||
"description": "打包标志(仅散单 isSandan=1 返回):按运单维度判定——该运单号已有打包流水(wms_pack_task.waybill_code 命中,或历史订单级流水 waybill_code 为空兜底)时为 1,否则为 0;主单号/子单号互不影响"
|
||||
},
|
||||
{
|
||||
"name": "items",
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user