暂存提交

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

@@ -42,6 +42,62 @@ paths:
           description: 幂等键冲突、请求处理中或订单状态冲突
         '503':
           description: 仓库或往来单位下游服务异常
+  /api/platform/v1/orders/first-leg:
+    post:
+      summary: 平台代客创建订单草稿
+      parameters:
+        - $ref: '#/components/parameters/TenantId'
+        - $ref: '#/components/parameters/IdempotencyKey'
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+      responses:
+        '200':
+          description: 创建成功或同请求重放成功
+        '403':
+          description: 需要 platform:order:create 权限
+        '409':
+          description: 幂等键冲突或请求仍在处理
+  /api/platform/v1/orders/first-leg/{id}/submit:
+    post:
+      summary: 平台代客提交指定订单
+      parameters:
+        - $ref: '#/components/parameters/OrderId'
+        - $ref: '#/components/parameters/TenantId'
+        - $ref: '#/components/parameters/IdempotencyKey'
+      responses:
+        '200':
+          description: 提交成功或同请求重放成功
+        '403':
+          description: 需要 platform:order:submit 权限
+        '404':
+          description: 订单不存在
+        '409':
+          description: 幂等键冲突或当前订单不可提交
+  /api/platform/v1/orders/first-leg/{id}:
+    put:
+      summary: 平台编辑指定订单草稿
+      parameters:
+        - $ref: '#/components/parameters/OrderId'
+        - $ref: '#/components/parameters/TenantId'
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+      responses:
+        '200':
+          description: 编辑成功
+        '403':
+          description: 需要 platform:order:edit 权限
+        '404':
+          description: 订单不存在
+        '409':
+          description: 当前订单不可编辑
 components:
   securitySchemes:
     bearerAuth:
@@ -49,6 +105,13 @@ components:
       scheme: bearer
       bearerFormat: JWT
   parameters:
+    TenantId:
+      name: tenantId
+      in: query
+      required: true
+      schema:
+        type: integer
+        format: int64
     OrderId:
       name: id
       in: path