优化

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

@@ -833,6 +833,26 @@ paths:
             application/json:
               schema: {$ref: '#/components/schemas/MerchantInboundBillingEnvelope'}
         '403': {description: 非当前客户或无订单查看权限}
+  /api/platform/v1/loading-plans/{loadingPlanId}/fee-details/{feeId}/adjust:
+    post:
+      summary: 调整已审核柜次费用的日期和金额
+      description: >-
+        仅 ACTIVE、APPROVED 且 sourceVersion 匹配的费用可调整。成功后 sourceVersion 加一并重新进入
+        PENDING；费用方向、费用项目、往来单位、币种、参与结算和备注保持原快照。身份或结算字段需要变化时，
+        必须作废原费用并新增。同一 expectedSourceVersion、businessDate、amount 的原样重试只读返回已生成的
+        PENDING 版本；旧版本异参、已作废或非已审核状态返回 A0409 且零写入。
+      parameters:
+        - {name: accountId, in: query, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
+        - {name: loadingPlanId, in: path, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
+        - {name: feeId, in: path, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: {$ref: '#/components/schemas/ContainerFeeAdjustRequest'}
+      responses:
+        '200': {description: 成功时 data 为调整后柜次费用；业务冲突通过响应体 A0409 返回}
+        '403': {description: 无 firstleg:inbound:fee-detail:edit 权限}
 components:
   securitySchemes:
     bearerAuth:
@@ -1793,3 +1813,11 @@ components:
       properties:
         expectedVersion: {type: integer, minimum: 0}
         reason: {type: string, minLength: 1, maxLength: 500}
+    ContainerFeeAdjustRequest:
+      type: object
+      additionalProperties: false
+      required: [expectedSourceVersion, businessDate, amount]
+      properties:
+        expectedSourceVersion: {type: integer, minimum: 1}
+        businessDate: {type: string, format: date}
+        amount: {type: number, minimum: 0}