优化

firstleg/src/main/resources/openapi/fba-pricing-v1.yaml

@@ -112,6 +112,13 @@ paths:
       parameters: [{$ref: '#/components/parameters/VersionId'}]
       requestBody: {required: true, content: {application/json: {schema: {$ref: '#/components/schemas/PriceBookConfirmationRequest'}}}}
       responses: {'200': {description: 成功或业务失败}, '403': {description: 无权限}}
+  /api/platform/v1/fba-pricing/carrier-rates/price-books/{versionId}/void:
+    post:
+      summary: 作废待确认船期价格表版本
+      description: 仅允许作废 PENDING_CONFIRMATION 版本；保留版本、原始文件和审计记录，作废后不可再确认生效。需要 firstleg:fba-pricing:rate:edit 权限。
+      parameters: [{$ref: '#/components/parameters/VersionId'}]
+      requestBody: {required: true, content: {application/json: {schema: {$ref: '#/components/schemas/PriceBookVoidRequest'}}}}
+      responses: {'200': {description: 成功或业务失败}, '403': {description: 无权限}}
   /api/platform/v1/fba-pricing/carrier-rates/price-books/{versionId}/source:
     get:
       summary: 下载船期价格表原始文件
@@ -528,7 +535,7 @@ components:
         effectiveTo: {type: string, format: date-time, nullable: true}
     PriceBookStatus:
       type: string
-      enum: [PENDING_CONFIRMATION, ACTIVE, SUPERSEDED, FAILED]
+      enum: [PENDING_CONFIRMATION, ACTIVE, SUPERSEDED, VOIDED, FAILED]
     PriceModel:
       type: string
       enum: [FBA_WAREHOUSE_RATE, REGION_WEIGHT_TIER]
@@ -564,6 +571,9 @@ components:
         publishedBy: {type: string, pattern: '^[1-9][0-9]*$', nullable: true}
         publishedAt: {type: string, format: date-time, nullable: true}
         supersededAt: {type: string, format: date-time, nullable: true}
+        voidedBy: {type: string, pattern: '^[1-9][0-9]*$', nullable: true}
+        voidedAt: {type: string, format: date-time, nullable: true}
+        voidReason: {type: string, maxLength: 500, nullable: true}
     PriceBookVersionDetail:
       type: object
       required: [version, channels, rates, issues]
@@ -600,6 +610,11 @@ components:
           type: array
           maxItems: 2
           items: {$ref: '#/components/schemas/PriceBookOverseasMapping'}
+    PriceBookVoidRequest:
+      type: object
+      required: [reason]
+      properties:
+        reason: {type: string, minLength: 1, maxLength: 500, description: 人工作废原因}
     PriceBookOriginMapping:
       type: object
       required: [originWarehouseCode, warehouseId]