提交

2026-08-26 11:05:26 +08:00
parent 3bf68c1083
commit 270372f56a
13 changed files with 290 additions and 2 deletions
@@ -138,6 +138,29 @@ paths:
        - { name: createdFrom, in: query, schema: { type: string, format: date-time } }
        - { name: createdTo, in: query, schema: { type: string, format: date-time } }
      responses: { '200': { description: 统一 ApiResponse 包装的尾程订单分页；列表行 destinationType 为 FBA 或 OVERSEAS } }
+  /api/platform/v1/last-leg/orders/{id}:
+    get:
+      summary: 查询尾程订单详情
+      description: 权限 platform:overseas-warehouse:last-mile-order:list；返回订单、货物、状态历史、费用明细和操作记录。
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - { name: id, in: path, required: true, schema: { type: integer, format: int64 } }
+      responses:
+        '200': { description: 统一 ApiResponse 包装的尾程订单详情 }
+        '404': { description: 尾程订单不存在或不属于查询客户 }
+  /api/platform/v1/last-leg/orders/{id}/fees:
+    post:
+      summary: 新增尾程订单费用
+      description: 权限 platform:overseas-warehouse:last-mile-order:edit；在订单客户范围内新增费用并记录操作人和处理结果。
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - { name: id, in: path, required: true, schema: { type: integer, format: int64 } }
+      requestBody:
+        required: true
+        content: { application/json: { schema: { $ref: '#/components/schemas/LastMileFeeCreate' } } }
+      responses:
+        '200': { description: 新增后的费用明细, content: { application/json: { schema: { $ref: '#/components/schemas/LastMileFeeApiResponse' } } } }
+        '404': { description: 尾程订单不存在或不属于操作客户 }
  /api/platform/v1/last-leg/dispatches:
    get:
      summary: 分页查询排车单
@@ -513,6 +536,37 @@ paths:
      responses: { '200': { description: 统一 ApiResponse 包装的换标单详情 }, '409': { description: 非法状态迁移或关联尾程单缺失 } }
 components:
  schemas:
+    LastMileFeeCreate:
+      type: object
+      required: [feeItem, currency, amount, status]
+      properties:
+        feeItem: { type: string, minLength: 1, maxLength: 128 }
+        currency: { type: string, pattern: '^[A-Z]{3}$', example: USD }
+        amount: { type: number, format: decimal, minimum: 0.01 }
+        status: { type: string, enum: [PENDING_REVIEW, APPROVED, REJECTED] }
+        supplierDescription: { type: string, maxLength: 500 }
+    LastMileFee:
+      type: object
+      required: [id, customerId, orderId, feeItem, currency, amount, status, createdBy, createdAt, updatedAt]
+      properties:
+        id: { type: integer, format: int64 }
+        customerId: { type: string }
+        orderId: { type: integer, format: int64 }
+        feeItem: { type: string }
+        currency: { type: string }
+        amount: { type: number, format: decimal }
+        status: { type: string }
+        supplierDescription: { type: string, nullable: true }
+        createdBy: { type: string }
+        createdAt: { type: string, format: date-time }
+        updatedAt: { type: string, format: date-time }
+    LastMileFeeApiResponse:
+      type: object
+      required: [code, message, data]
+      properties:
+        code: { type: string }
+        message: { type: string }
+        data: { $ref: '#/components/schemas/LastMileFee' }
    PdaWarehouseScan:
      type: object
      required: [code]