优化

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

@@ -243,6 +243,27 @@ paths:
       responses:
         '200': {description: 成功或状态、版本、重复号冲突}
         '403': {description: 无货柜编辑权限}
+  /api/platform/v1/containers/{id}/clearance:
+    get:
+      summary: 查询货柜目的港清关资料
+      parameters: [{$ref: '#/components/parameters/ContainerBookingId'}]
+      responses: {'200': {description: 成功或货柜不存在}}
+  /api/platform/v1/containers/{id}/clearance/document:
+    post:
+      summary: 上传或替换货柜目的港清关资料
+      parameters: [{$ref: '#/components/parameters/ContainerBookingId'}, {$ref: '#/components/parameters/IdempotencyKey'}]
+      requestBody:
+        required: true
+        content: {application/json: {schema: {$ref: '#/components/schemas/ContainerDocumentAttachRequest'}}}
+      responses: {'200': {description: 成功、文件归属不匹配或版本冲突}}
+  /api/platform/v1/containers/{id}/clearance/complete:
+    post:
+      summary: 点击完成目的港清关
+      parameters: [{$ref: '#/components/parameters/ContainerBookingId'}, {$ref: '#/components/parameters/IdempotencyKey'}]
+      requestBody:
+        required: true
+        content: {application/json: {schema: {$ref: '#/components/schemas/ContainerDocumentCompleteRequest'}}}
+      responses: {'200': {description: 成功、未上传资料或版本冲突}}
   /api/platform/v1/first-leg/smart-loading/plans/by-booking/{bookingId}:
     get:
       summary: 按货柜恢复智能装柜草稿
@@ -1034,6 +1055,19 @@ components:
         voyageNo: {type: string, maxLength: 64, nullable: true}
         version: {type: integer, minimum: 0}
         reason: {type: string, maxLength: 500}
+    ContainerDocumentAttachRequest:
+      type: object
+      required: [fileId, expectedVersion]
+      properties:
+        fileId: {type: string, pattern: '^[1-9][0-9]*$'}
+        expectedVersion: {type: integer, minimum: 0}
+        operationReason: {type: string, maxLength: 500, nullable: true}
+    ContainerDocumentCompleteRequest:
+      type: object
+      required: [expectedVersion]
+      properties:
+        expectedVersion: {type: integer, minimum: 0}
+        operationReason: {type: string, maxLength: 500, nullable: true}
     MerchantInboundBillingEnvelope:
       type: object
       properties: