优化

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

@@ -608,6 +608,46 @@ paths:
         '400': {$ref: '#/components/responses/BadRequest'}
         '403': {$ref: '#/components/responses/Forbidden'}
         '409': {$ref: '#/components/responses/Conflict'}
+  /internal/iam/required-qualification-packages:
+    post:
+      tags: [IAM Resources / IAM 资源]
+      summary: 商户必填资质包登记
+      description: 仅供 File Service 调用；在一个 IAM 事务中登记营业执照、统一社会信用代码和法人身份证。
+      security: []
+      parameters:
+        - {$ref: '#/components/parameters/InternalServiceToken'}
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: {$ref: '#/components/schemas/RequiredQualificationPackageRequest'}
+      responses:
+        '200':
+          description: 统一响应；仅 data 非空且 code 为 200 表示资质包已完整登记
+          content:
+            application/json:
+              schema: {$ref: '#/components/schemas/RequiredQualificationPackageApiResponse'}
+        '403': {$ref: '#/components/responses/Forbidden'}
+  /internal/iam/platform-required-qualification-packages:
+    post:
+      tags: [IAM Resources / IAM 资源]
+      summary: 平台代客户必填资质包登记
+      description: 仅供 File Service 调用；与商户入口使用相同的三项事务保存规则。
+      security: []
+      parameters:
+        - {$ref: '#/components/parameters/InternalServiceToken'}
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: {$ref: '#/components/schemas/RequiredQualificationPackageRequest'}
+      responses:
+        '200':
+          description: 统一响应；仅 data 非空且 code 为 200 表示资质包已完整登记
+          content:
+            application/json:
+              schema: {$ref: '#/components/schemas/RequiredQualificationPackageApiResponse'}
+        '403': {$ref: '#/components/responses/Forbidden'}
   /internal/exports/v1/CUSTOMER_LIST/batches:
     post:
       tags: [Internal Export Provider]
@@ -650,6 +690,11 @@ components:
       scheme: bearer
       bearerFormat: JWT
   parameters:
+    InternalServiceToken:
+      name: X-Internal-Service-Token
+      in: header
+      required: true
+      schema: {type: string}
     Id:
       name: id
       in: path
@@ -838,6 +883,33 @@ components:
         validTo: {type: string, format: date, nullable: true}
         status: {type: string, enum: [PENDING, APPROVED, REJECTED, SUPERSEDED]}
         reviewComment: {type: string}
+    RequiredQualificationPackageRequest:
+      type: object
+      required: [tenantId, unifiedSocialCreditCode, businessLicenseDocumentUrl, replaceBusinessLicense, legalPersonIdDocumentUrl, replaceLegalPersonId]
+      properties:
+        tenantId: {type: string, pattern: '^\d+$'}
+        unifiedSocialCreditCode: {type: string, pattern: '^[0-9A-Za-z]{18}$'}
+        businessLicenseDocumentUrl: {type: string, minLength: 1}
+        businessLicenseValidTo: {type: string, format: date, nullable: true}
+        replaceBusinessLicense: {type: boolean}
+        legalPersonIdDocumentUrl: {type: string, minLength: 1}
+        legalPersonIdValidTo: {type: string, format: date, nullable: true}
+        replaceLegalPersonId: {type: boolean}
+    RequiredQualificationPackageResponse:
+      type: object
+      required: [businessLicenseQualificationId, legalPersonIdQualificationId, tenantStatus]
+      properties:
+        businessLicenseQualificationId: {type: string, pattern: '^\d+$'}
+        legalPersonIdQualificationId: {type: string, pattern: '^\d+$'}
+        tenantStatus: {type: string, enum: [PROFILE_REQUIRED, REJECTED]}
+        replacedBusinessLicenseDocumentUrl: {type: string, nullable: true}
+        replacedLegalPersonIdDocumentUrl: {type: string, nullable: true}
+    RequiredQualificationPackageApiResponse:
+      allOf:
+        - {$ref: '#/components/schemas/ApiResponse'}
+        - type: object
+          properties:
+            data: {$ref: '#/components/schemas/RequiredQualificationPackageResponse'}
     RegisterRequest:
       type: object
       required: [tenantName, legalName, legalRepresentative, contactName, contactPhone, servicePackage]
@@ -845,7 +917,6 @@ components:
         tenantName: {type: string, example: 深圳虫虫出海科技有限公司}
         legalName: {type: string, example: 深圳虫虫出海科技有限公司}
         legalRepresentative: {type: string, maxLength: 64, example: 张三}
-        unifiedSocialCreditCode: {type: string, nullable: true, pattern: '^[0-9A-Za-z]{18}$', example: 91440300MA5ABCDE12, description: 创建草稿时选填，送审前必填}
         contactName: {type: string, example: 李四}
         contactPhone: {type: string, example: '13800138000'}
         contactEmail: {type: string, format: email, example: contact@example.com}