修复费用审核前调整和运输取消及对账明细约束

lastleg-service/src/main/resources/openapi/overseas-finance-fees-v1.yaml

@@ -17,7 +17,7 @@ paths:
         - { in: query, name: businessType, schema: { $ref: '#/components/schemas/BusinessType' } }
         - { in: query, name: businessNo, schema: { type: string } }
         - { in: query, name: containerBookingId, description: 精确查询真实来源柜下全部客户的费用；可再传customerId收窄到单个客户, schema: { type: string, pattern: '^[1-9][0-9]*$' } }
-      responses: { '200': { description: '当前版本列表；voidStatus为NOT_REQUESTED、PENDING_FINANCE、FINANCE_ATTENTION或CONFIRMED，批量查询作废确认状态，不逐行读取。等待或拒绝时sourceStatus保留ACTIVE，只有Finance持久化确认后为VOIDED。' } }
+      responses: { '200': { description: '当前版本列表；voidStatus为NOT_REQUESTED、PENDING_FINANCE、FINANCE_ATTENTION或CONFIRMED，批量查询作废确认状态，不逐行读取。业务流程发起的已发布账单作废，等待或拒绝时sourceStatus保留ACTIVE，只有Finance持久化确认后为VOIDED；人工费用审核前作废直接为VOIDED，无需账单作废确认。' } }
     post:
       summary: 创建人工费用并锁定资金
       description: 需platform:finance:fee-source:edit。创建即PENDING。应收仅当前LASTLEG_ORDER且orderType=FIRST_LEG采用BILL，其余业务（含ONE_CLICK_DROPSHIP、退货、转运、柜级费用）为WALLET，发送异步FREEZE，本土卡车、本土散板应收同采购一样使用客户余额及授信扣款；余额及授信不足显示FREEZE_FAILED，不可审核通过。原USD按业务月有效汇率固化为CNY后冻结；原币与汇率快照保留。采购主单OVERSEAS_PROCUREMENT复用本入口，未传结算方式默认WALLET；旧PROCUREMENT_FEE子费用仍只由原采购节点处理。业务ID、客户、单号与补充订单/入仓关联由服务端核对；真实柜要求businessId=containerBookingId且businessNo=containerNo。调用重放不重复冻结。
@@ -86,7 +86,7 @@ paths:
     post:
       summary: 提交、审核、调整、作废或处理资金
       x-headleg-delivery-review: 首版头程派送费由审核员核对原报价是否已包含；当前未实现自动识别。已含费用不应再建单或通过审核，另收费用人工添加后审核进入头程账单。
-      description: 编辑动作需platform:finance:fee-source:edit，review与void需platform:finance:fee-source:review。WALLET通过审核只发送SETTLE，实际匹配成功回执含冻结与账本引用后才PUBLISHED，此时仅本地费用完成、不推送财务账单；失败为SETTLE_FAILED，保持未收。驳回释放冻结，冻结在途时回执成功后自动释放。驳回后的费用只读，不能继续操作；如需重新收费应在业务单据中新增费用。头程BILL审核通过推送结算；已发布BILL作废等待Finance持久化确认才VOIDED。历史无资金记录的海外费用必须重新提交完成冻结，不允许审核绕过。采购主单费用沿此审核扣款链，旧PROCUREMENT_FEE子费用仍由原采购节点处理。
+      description: 编辑动作需platform:finance:fee-source:edit，review与void需platform:finance:fee-source:review。WALLET通过审核只发送SETTLE，实际匹配成功回执含冻结与账本引用后才PUBLISHED，此时仅本地费用完成、不推送财务账单；失败为SETTLE_FAILED，保持未收。驳回释放冻结，冻结在途时回执成功后自动释放。驳回后的费用只读，不能继续操作；如需重新收费应在业务单据中新增费用。头程BILL审核通过推送结算。人工费用仅ACTIVE、UNPUBLISHED且DRAFT或PENDING时允许ADJUST、VOID；已审核通过、已扣款或已发布均不允许这两个动作。调整关闭原费用并使用独立资金身份创建待审核费用，原冻结立即或收到迟到成功回执后释放；审核前作废直接关闭并释放冻结，不向Finance发送账单作废事件。冻结或扣款快照不可覆盖，版本、权限和幂等键仍须校验。历史无资金记录的海外费用必须重新提交完成冻结，不允许审核绕过。采购主单费用沿此审核扣款链，旧PROCUREMENT_FEE子费用仍由原采购节点处理。
       security: [{ bearerAuth: [] }]
       parameters:
         - { in: path, name: sourceFeeId, required: true, schema: { type: string } }
@@ -204,7 +204,7 @@ components:
         deliveryKind: { type: string, nullable: true, enum: [FEE, FUNDING] }
         deliveryEventId: { type: string, nullable: true, description: 当前原事件ID，重试时必须原样提交 }
         deliveryErrorMessage: { type: string, nullable: true }
-        allowedActions: { type: array, items: { type: string, enum: [SUBMIT, APPROVE, REJECT, ADJUST, ADJUST_RENT, VOID, RETRY_FREEZE, RETRY_SETTLE, RETRY_RELEASE, RETRY_PUBLISH, RETRY_FUNDING_DELIVERY] } }
+        allowedActions: { description: '人工费用ADJUST和VOID仅在审核前返回；已通过或已收款不返回，实际操作仍校验状态、版本与权限。', type: array, items: { type: string, enum: [SUBMIT, APPROVE, REJECT, ADJUST, ADJUST_RENT, VOID, RETRY_FREEZE, RETRY_SETTLE, RETRY_RELEASE, RETRY_PUBLISH, RETRY_FUNDING_DELIVERY] } }
         reviewerId: { type: string, nullable: true, description: 审核人ID }
         reviewerName: { type: string, nullable: true, description: 审核人名称快照 }
         reviewedAt: { type: string, format: date-time, nullable: true, description: 审核时间，UTC 且携带 Z 时区 }