提交

2026-10-14 13:57:04 +08:00
parent d017f5d881
commit 1425b284dd
9 changed files with 196 additions and 32 deletions
@@ -220,9 +220,44 @@ paths:
  /api/pda/v1/last-leg/pallet-operations/relabel-disassemble:
    post:
      summary: 按换标箱唛拆托并绑定目标托盘
-      description: PDA选择原入仓单库存行并扫描实际来源托盘，输入拆出箱数，核对本批cartonMarks后扫描目标托盘。传actualSource时以其数量和版本为准，同入仓余额及批次内原子调整本单冻结记账位置，再移动冻结库存和换标明细；不新增入库、不改变库存归属、不占用其他单据冻结量。每次一个来源库存行，可分批处理多个托盘。已有出库单时不允许此数量重分配。未传actualSource的箱唛模式仍要求已有来源仓位一致。
+      description: PDA选择原入仓单库存行并扫描实际来源托盘，输入拆出箱数，核对本批cartonMarks后扫描目标托盘。传actualSource时以其数量和版本为准，同入仓余额及批次内原子调整本单冻结记账位置，再移动冻结库存和换标明细；不新增入库、不改变库存归属、不占用其他单据冻结量。每次一个来源库存行，可分批处理多个托盘。已有出库单时不允许此数量重分配。未传actualSource的箱唛模式仍要求已有来源仓位一致。普通库存整托全部换标允许目标与来源为同一托盘，校验整托数量和本单冻结归属后仅记录绑定、不搬移库存；部分换标必须使用新托盘。货物和包装不变时可继承原托盘测量，拆合托后新托盘和原托余货均须重新实测。
      requestBody: { required: true, content: { application/json: { schema: { $ref: '#/components/schemas/RelabelPalletDisassemble' } } } }
      responses: { '200': { description: 箱唛级拆托绑定结果 }, '409': { description: 箱唛、库存或托盘版本冲突 } }
+  /api/pda/v1/last-leg/pallet-operations/relabel-pallet-measurements:
+    post:
+      summary: 查询仓储转运换标涉及托盘的最终测量及库存版本
+      description: 权限 lastleg:pda:operate 及海外PDA角色；仅Token绑定仓。整托原托盘且没有拆合托流水、箱数未变时沿用原始测量；新托盘和拆合托后的原托盘余货需要补测。测量保存为PALLET_MEASURE作业历史，库存版本变化后失效。
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [relabelNo]
+              properties:
+                relabelNo: { type: string, maxLength: 64 }
+      responses: { '200': { description: 托盘业务码、箱数、stockVersion、长宽高cm、毛重kg、体积m³及inherited；其他来源换标返回空列表 }, '409': { description: 不属于当前仓 } }
+  /api/pda/v1/last-leg/pallet-operations/relabel-pallet-measure:
+    post:
+      summary: 确认仓储转运换标托盘最终实测
+      description: 已认领的操作员可在处理中保存；待出库但未排车亦可补测。保存当前stockVersion及实测长宽高、毛重，服务端计算体积；相同幂等键异载荷拒绝，库存变化要求刷新。原托盘包装变化同样使用此接口重新测量。排车前核验所有相关非空托盘，包括原托盘余货。
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [relabelNo, palletCode, stockVersion, idempotencyKey, lengthCm, widthCm, heightCm, grossWeightKg]
+              properties:
+                relabelNo: { type: string, maxLength: 64 }
+                palletCode: { type: string, maxLength: 128 }
+                stockVersion: { type: string, description: 查询返回的当前库存版本指纹 }
+                idempotencyKey: { type: string, maxLength: 128 }
+                lengthCm: { type: number, minimum: 0.01, multipleOf: 0.01 }
+                widthCm: { type: number, minimum: 0.01, multipleOf: 0.01 }
+                heightCm: { type: number, minimum: 0.01, multipleOf: 0.01 }
+                grossWeightKg: { type: number, minimum: 0.01, multipleOf: 0.001 }
+      responses: { '200': { description: 已保存并返回全部相关托盘测量 }, '409': { description: 版本、归属、状态、认领人或幂等载荷冲突 } }
  /api/pda/v1/last-leg/pallet-operations/swap:
    post:
      summary: 将整托库存更换到空目标托盘