优化

2026-08-13 17:14:46 +08:00
parent b004edaf9e
commit e9564a21a2
5 changed files with 186 additions and 12 deletions
@@ -537,12 +537,25 @@ paths:
  /api/platform/v1/inbounds/{inboundId}/measurements/approve:
    post:
      summary: 审核通过测量
-      description: 需要 firstleg:inbound:measurement-review 权限；客服审核通过后自动计费、发布费用给客户并完成入库，客户无需确认。
+      description: 需要 firstleg:inbound:measurement-review 权限。审核事务提交后服务端自动执行计费、费用发布和入库编排并返回费用快照；若后续编排失败，审核结果保持已提交，使用同一 Idempotency-Key 重试将从持久化阶段继续，接口不会伪造 WAIT_SPLIT。
      parameters:
        - {name: inboundId, in: path, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
+        - {name: tenantId, in: query, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
        - {name: Idempotency-Key, in: header, required: true, schema: {type: string}}
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [measurementId, expectedVersion]
+              properties:
+                measurementId: {type: string, pattern: '^[1-9][0-9]*$'}
+                expectedVersion: {type: integer, minimum: 0}
+                reason: {type: string, maxLength: 1000}
      responses:
-        '200': {description: 成功或业务失败}
+        '200': {description: 成功或业务失败；成功 data 为 FeeSnapshotResponse，nextStatus=WAIT_SPLIT}
+        '409': {description: 审核已提交但自动编排尚未完成、版本冲突或费用/仓库门禁失败；不得据此推断 WAIT_SPLIT}
  /api/platform/v1/inbounds/{inboundId}/measurements/reject:
    post:
      summary: 驳回测量