Merge remote-tracking branch 'origin/test' into test

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

@@ -822,6 +822,30 @@ paths:
         - { name: warehouseId, in: query, schema: { type: string } }
         - { name: status, in: query, schema: { type: string } }
       responses: { '200': { description: 出库单分页 } }
+  /api/platform/v1/last-leg/outbound-orders/return:
+    post:
+      summary: 创建退货出库单，支持单SKU全部或部分件数
+      description: 权限 platform:overseas-warehouse:outbound:create；单SKU来源须为纯SKU可用箱或散件。混合SKU箱须先拆箱。按箱唛排序分配件数，未拣货前占用整个使用来源；拣货后原箱余数恢复可用。相同幂等键改数量拒绝。
+      security: [{ bearerAuth: [] }]
+      parameters: [{ name: customerId, in: query, required: true, schema: { type: string } }]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [recipient, overseasWarehouseId, returnNo, cartonMarks, idempotencyKey]
+              properties:
+                recipient: { type: string, maxLength: 1000 }
+                overseasWarehouseId: { type: string, maxLength: 128 }
+                returnNo: { type: string, maxLength: 128 }
+                cartonMarks: { type: array, minItems: 1, maxItems: 200, uniqueItems: true, items: { type: string, maxLength: 128 } }
+                skuCode: { type: string, maxLength: 128, nullable: true }
+                quantity: { type: integer, format: int64, minimum: 1, nullable: true, description: 单SKU计划件数，不得超过所选来源总数；省略出全部，只允许skuCode已填且非PALLET维度，不接受小数 }
+                unitType: { type: string, enum: [BOX, PALLET], nullable: true }
+                remark: { type: string, maxLength: 1000, nullable: true }
+                idempotencyKey: { type: string, maxLength: 255 }
+      responses: { '200': { description: 退货出库PDA任务 }, '400': { description: 数量或请求格式错误 }, '409': { description: 来源占用、库存或幂等冲突 } }
   /api/platform/v1/last-leg/outbound-orders/one-click-dropship:
     post:
       summary: 创建一件代发出库单

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

@@ -875,6 +875,8 @@ components:
         outboundPalletItemId: { type: string, pattern: '^[0-9]+$' }
         inventoryPositionId: { type: string, nullable: true, pattern: '^[0-9]+$', description: 普通库存使用真实仓位键；退货箱库存没有该仓位，提交 null，不提交空字符串或退货库存内部ID }
         packages: { type: integer, format: int64, minimum: 1 }
+        productQuantity: { type: integer, format: int64, minimum: 1, nullable: true, description: 单SKU退货明细存在returnSkuQuantity时必填且必须等于计划件数；不接受小数。历史无快照明细可省略 }
+        skuCode: { type: string, maxLength: 128, nullable: true, description: PARCEL散件单SKU扫码值；已装箱来源必须扫描箱唛 }
         idempotencyKey: { type: string, minLength: 1, maxLength: 255 }
         cartonMarks:
           type: array
@@ -911,6 +913,7 @@ components:
               outboundPalletItemId: { type: string, description: pick请求提交键，不作为用户展示编号 }
               palletNo: { type: string, nullable: true, description: Warehouse 权威实物托盘码；退货箱明细不伪造托盘码 }
               skuCode: { type: string, nullable: true }
+              returnSkuQuantity: { type: integer, format: int64, nullable: true, minimum: 1, description: 本来源计划出库件数快照；部分拣货后余数保留原箱，PDA不得改变计划件数 }
               inboundCode: { type: string }
               packageCount: { type: integer }
               pickedPackageCount: { type: integer }