优化提交

lastleg-service/src/main/resources/openapi/overseas-pda-operations-v1.yaml

@@ -154,6 +154,12 @@ paths:
       summary: 扫码查询托盘及库存内容
       requestBody: { required: true, content: { application/json: { schema: { $ref: '#/components/schemas/ScanCode' } } } }
       responses: { '200': { description: Token绑定仓托盘内容 }, '404': { description: 托盘不存在（统一响应实际 HTTP 200，body.code=A0404）, content: { application/json: { schema: { $ref: '#/components/schemas/ApiResponse' } } } } }
+  /api/pda/v1/last-leg/pallet-operations/relabel-pallet-label:
+    post:
+      summary: 为换标拆托幂等生成并返回可打印的新托盘标签
+      description: 返回空托盘编码、初始版本和打印HTML；随后可将该托盘作为relabel-disassemble的target。库存移入后仍继承原库存余额对应的客户和入库单。
+      requestBody: { required: true, content: { application/json: { schema: { $ref: '#/components/schemas/NewRelabelPallet' } } } }
+      responses: { '200': { description: 新托盘及可打印标签 }, '409': { description: 换标单未确认或不属于Token绑定仓 } }
   /api/pda/v1/last-leg/pallet-operations/assemble:
     post:
       summary: 将多个来源托盘的指定库存行组到目标托盘
@@ -411,14 +417,14 @@ components:
         inventoryPositionCount: { type: integer }
     WarehousePallet:
       type: object
-      required: [palletId, palletCode, status, version, locationId, locationCode, occupiedPackages, inventoryPositionCount, inventory]
+      required: [palletId, palletCode, status, version, occupiedPackages, inventoryPositionCount, inventory]
       properties:
         palletId: { type: string, pattern: '^[0-9]+$' }
         palletCode: { type: string }
         status: { type: string }
         version: { type: integer }
-        locationId: { type: string, pattern: '^[0-9]+$' }
-        locationCode: { type: string }
+        locationId: { type: string, pattern: '^[0-9]+$', nullable: true }
+        locationCode: { type: string, nullable: true }
         occupiedPackages: { type: integer, format: int64 }
         inventoryPositionCount: { type: integer }
         inventory: { type: array, items: { $ref: '#/components/schemas/InventoryItem' } }
@@ -548,6 +554,12 @@ components:
       type: object
       required: [code]
       properties: { code: { type: string, minLength: 1, maxLength: 128 } }
+    NewRelabelPallet:
+      type: object
+      required: [relabelNo, idempotencyKey]
+      properties:
+        relabelNo: { type: string, minLength: 1, maxLength: 64 }
+        idempotencyKey: { type: string, minLength: 1, maxLength: 128 }
     IdempotentAction:
       type: object
       required: [idempotencyKey]