提交

lastleg-service/src/main/resources/openapi/order-budgets-v1.yaml

@@ -2,7 +2,7 @@ openapi: 3.0.3
 info:
   title: 海外客户下单预估资金校验
   version: 1.0.0
-  description: Finance异步冻结成功后才能创建客户采购/本土卡车订单。余额优先、授信补足及不足判断由Finance原子执行；本服务不自行修改钱包。创建订单须使用相同幂等键、金额及币种。未绑定预占15分钟过期；订单终态释放，释放失败重试。预占独立于最终人工费用结算。
+  description: 客户订单先原子落库并进入资金处理中，资金冻结通过Outbox异步执行。冻结成功后进入待审核，失败进入资金失败并可在原订单上重试；平台仅可审核待审核订单。余额优先、授信补足及不足判断由Finance原子执行；本服务不自行修改钱包。预算预占、订单和冻结指令在同一事务内写入，订单终态释放。
 security:
   - bearerAuth: []
 paths:
@@ -11,7 +11,7 @@ paths:
       - {name: kind, in: path, required: true, schema: {type: string, enum: [procurement, trucking]}}
       - {name: key, in: path, required: true, schema: {type: string, minLength: 1, maxLength: 128}}
     post:
-      summary: 发起冻结或读取原请求，失败后可用原键重试
+      summary: 兼容接口：发起或读取预算冻结请求
       description: 客户身份仅来自认证。procurement需要merchant:cross-border:procurement:create，trucking需要merchant:cross-border:domestic-trucking:create；权限不能交叉使用。采购金额是预算单价乘采购数量，免费样品零金额不发资金指令；卡车金额必须大于0。重试禁止更改金额或币种。
       requestBody:
         required: true
@@ -28,10 +28,29 @@ paths:
         '403': {description: 身份或业务创建权限不足}
     get:
       summary: 读取当前客户本次下单的权威资金回执
-      description: 与POST相同创建权限；只有usable=true才允许继续下单。FREEZE_PENDING处理期间应轮询，超时保留原键重试；失败显示Finance返回原因。
+      description: 与POST相同创建权限；该接口保留用于旧客户端兼容。新客户端应直接创建订单，并通过订单资金状态接口读取异步结果。
       responses:
         '200': {$ref: '#/components/responses/Result'}
         '403': {description: 身份或业务创建权限不足}
+  /api/merchant/v1/last-leg/order-budgets/{kind}/orders/{orderNo}:
+    parameters:
+      - {name: kind, in: path, required: true, schema: {type: string, enum: [procurement, trucking]}}
+      - {name: orderNo, in: path, required: true, schema: {type: string, minLength: 1, maxLength: 128}}
+    get:
+      summary: 读取订单资金状态
+      description: 仅当前客户可读。FUNDING_PENDING期间客户端可短暂轮询；FUNDING_FAILED展示失败原因并允许重试。只有PENDING_REVIEW允许平台审核。
+      responses:
+        '200': {$ref: '#/components/responses/Result'}
+  /api/merchant/v1/last-leg/order-budgets/{kind}/orders/{orderNo}/retry:
+    parameters:
+      - {name: kind, in: path, required: true, schema: {type: string, enum: [procurement, trucking]}}
+      - {name: orderNo, in: path, required: true, schema: {type: string, minLength: 1, maxLength: 128}}
+    post:
+      summary: 重试订单资金冻结
+      description: 仅当前客户可重试FUNDING_FAILED订单，沿用原金额和币种；重复请求幂等。
+      responses:
+        '200': {$ref: '#/components/responses/Result'}
+
 components:
   securitySchemes:
     bearerAuth: {type: http, scheme: bearer, bearerFormat: JWT}