提交

2026-08-21 10:43:25 +08:00
parent d5e9ba6d4c
commit e17f03e596
55 changed files with 775 additions and 173 deletions
@@ -171,8 +171,84 @@ paths:
        - { name: customerId, in: query, required: true, schema: { type: string, pattern: '^[1-9][0-9]*$' } }
      requestBody: { required: true, content: { application/json: { schema: { type: object, required: [version, status], properties: { version: { type: integer, format: int64, minimum: 0 }, status: { $ref: '#/components/schemas/LooseboardStatus' }, remark: { type: string, nullable: true, maxLength: 1000 } } } } } }
      responses: { '200': { description: 统一 ApiResponse 包装的散板订单详情 }, '409': { description: 非法状态迁移 } }
+  /api/platform/v1/last-leg/relabel-applications:
+    get:
+      summary: 分页查询海外换标单
+      description: 权限 platform:overseas-warehouse:relabel-order:list；平台查询全部换标单，不接收 customerId。
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - { name: page, in: query, schema: { type: integer, minimum: 1, default: 1 } }
+        - { name: size, in: query, schema: { type: integer, minimum: 1, maximum: 200, default: 20 } }
+        - { name: relabelNo, in: query, schema: { type: string, maxLength: 64 } }
+        - { name: customerOrderNo, in: query, schema: { type: string, maxLength: 128 } }
+        - { name: skuCode, in: query, schema: { type: string, maxLength: 128 } }
+        - { name: status, in: query, schema: { $ref: '#/components/schemas/RelabelStatus' } }
+        - { name: overseasWarehouseId, in: query, schema: { type: string, maxLength: 128 } }
+        - { name: createdFrom, in: query, schema: { type: string, format: date-time } }
+        - { name: createdTo, in: query, schema: { type: string, format: date-time } }
+      responses: { '200': { description: 统一 ApiResponse 包装的换标单分页 } }
+    post:
+      summary: 创建海外换标单
+      description: 权限 platform:overseas-warehouse:relabel-order:create；明细与换标文件按请求快照保存，使用 idempotencyKey 幂等。
+      security: [{ bearerAuth: [] }]
+      requestBody: { required: true, content: { application/json: { schema: { $ref: '#/components/schemas/RelabelCreate' } } } }
+      responses: { '200': { description: 统一 ApiResponse 包装的换标单详情 }, '409': { description: 幂等键冲突 } }
+  /api/platform/v1/last-leg/relabel-applications/{relabelNo}:
+    get:
+      summary: 查询海外换标单详情
+      description: 权限 platform:overseas-warehouse:relabel-order:list。
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - { name: relabelNo, in: path, required: true, schema: { type: string, maxLength: 64 } }
+      responses: { '200': { description: 统一 ApiResponse 包装的换标单详情 }, '404': { description: 换标单不存在或不属于当前客户 } }
+  /api/platform/v1/last-leg/relabel-applications/{relabelNo}/status:
+    put:
+      summary: 变更海外换标单状态
+      description: 权限 platform:overseas-warehouse:relabel-order:status；状态按 PENDING_PROCESSING→PROCESSING→COMPLETED/REJECTED/CANCELLED 流转。
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - { name: relabelNo, in: path, required: true, schema: { type: string, maxLength: 64 } }
+      requestBody: { required: true, content: { application/json: { schema: { $ref: '#/components/schemas/RelabelStatusChange' } } } }
+      responses: { '200': { description: 统一 ApiResponse 包装的换标单详情 }, '409': { description: 非法状态迁移或关联尾程单缺失 } }
 components:
  schemas:
+    RelabelStatus: { type: string, enum: [PENDING_PROCESSING, PROCESSING, COMPLETED, REJECTED, CANCELLED] }
+    RelabelCreate:
+      type: object
+      required: [customerOrderNo, overseasWarehouseId, labelDeadline, contactName, contactPhone, idempotencyKey, items]
+      properties:
+        customerOrderNo: { type: string, maxLength: 128 }
+        overseasWarehouseId: { type: string, maxLength: 128 }
+        labelDeadline: { type: string, format: date-time }
+        contactName: { type: string, maxLength: 128 }
+        contactPhone: { type: string, maxLength: 64 }
+        remark: { type: string, nullable: true, maxLength: 1000 }
+        idempotencyKey: { type: string, maxLength: 255 }
+        items: { type: array, minItems: 1, maxItems: 500, items: { $ref: '#/components/schemas/RelabelItem' } }
+    RelabelItem:
+      type: object
+      required: [skuCode, productNameZh, totalPackageCount, notifiedPackageCount, shipmentNo, newSkuCode]
+      properties:
+        skuCode: { type: string, maxLength: 128 }
+        productImageFileId: { type: string, nullable: true, maxLength: 128 }
+        productImageFileName: { type: string, nullable: true, maxLength: 255 }
+        productImageUrl: { type: string, nullable: true, maxLength: 1000 }
+        productNameZh: { type: string, maxLength: 255 }
+        totalPackageCount: { type: integer, minimum: 1 }
+        notifiedPackageCount: { type: integer, minimum: 1 }
+        shipmentNo: { type: string, maxLength: 128 }
+        trackingCode: { type: string, nullable: true, maxLength: 255 }
+        newSkuCode: { type: string, maxLength: 128 }
+        labelRequirement: { type: string, nullable: true, maxLength: 1000 }
+        relabelFileId: { type: string, nullable: true, maxLength: 128 }
+        relabelFileName: { type: string, nullable: true, maxLength: 255 }
+        relabelFileUrl: { type: string, nullable: true, maxLength: 1000 }
+    RelabelStatusChange:
+      type: object
+      required: [status]
+      properties:
+        status: { $ref: '#/components/schemas/RelabelStatus' }
+        remark: { type: string, nullable: true, maxLength: 1000 }
    ProcurementStatus: { type: string, enum: [PENDING_REVIEW, APPROVED, REJECTED] }
    ProcurementCreate:
      type: object