提交

lastleg-service/src/main/resources/db/lastleg.sql

@@ -22,7 +22,7 @@ CREATE TABLE IF NOT EXISTS ll_order (
   id BIGINT NOT NULL COMMENT '雪花 ID',
   order_no VARCHAR(32) NOT NULL COMMENT '尾程单号',
   customer_id VARCHAR(128) NOT NULL COMMENT '租户/客户账号标识',
-  order_type VARCHAR(32) NOT NULL DEFAULT 'FIRST_LEG' COMMENT '订单类型',
+  order_type VARCHAR(32) NOT NULL DEFAULT 'FIRST_LEG' COMMENT '订单类型：FIRST_LEG头程订单、RELABEL_APPLICATION换标下单、WAREHOUSE_TRANSFER仓储转运、LOCAL_LOOSEBOARD本土散板、RETURN_RELABEL退货换标、ONE_CLICK_DROPSHIP一件代发',
   inbound_code VARCHAR(128) NOT NULL COMMENT '入仓码',
   source_region VARCHAR(32) NOT NULL COMMENT '来源区域/系统',
   source_inbound_id VARCHAR(128) NOT NULL COMMENT '最终实装 LOADED 分片 ID，建单幂等键',
@@ -57,7 +57,7 @@ CREATE TABLE IF NOT EXISTS ll_order (
   relabel_order_no VARCHAR(128) COMMENT '换标单号',
   relabel_status VARCHAR(32) COMMENT '换标状态',
   pallet_merge_flag VARCHAR(32) COMMENT '合托标记',
-  current_status VARCHAR(32) NOT NULL DEFAULT 'PENDING_ASSIGNMENT' COMMENT '当前业务状态',
+  current_status VARCHAR(32) NOT NULL DEFAULT 'PENDING_ASSIGNMENT' COMMENT '当前业务状态：PENDING_ASSIGNMENT待分配、PENDING_INBOUND待入库、INBOUND_COMPLETED入库完成、PENDING_DELIVERY待派送、DELIVERING派送中、DELIVERED派送完成',
   sub_order_status VARCHAR(255) NULL COMMENT '子单据状态汇总',
   private_remark VARCHAR(1000) COMMENT '备注（仅自己）',
   customer_remark VARCHAR(1000) COMMENT '备注（客户）',

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

@@ -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