提交

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

@@ -3,6 +3,27 @@ info:
   title: Lastleg Overseas Business API
   version: 1.0.0
 paths:
+  /api/platform/v1/last-leg/orders:
+    get:
+      summary: 分页查询尾程订单
+      description: 权限 platform:overseas-warehouse:order:list；平台管理员省略 customerId 时查询全部客户。
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - { name: page, in: query, schema: { type: integer, minimum: 1, default: 1 } }
+        - { name: size, in: query, schema: { type: integer, minimum: 1, maximum: 200, default: 20 } }
+        - { name: orderNo, in: query, schema: { type: string } }
+        - { name: orderType, in: query, schema: { type: string, enum: [FIRST_LEG, RELABEL_APPLICATION, WAREHOUSE_TRANSFER, LOCAL_LOOSEBOARD, RETURN_RELABEL, ONE_CLICK_DROPSHIP] } }
+        - { name: currentStatus, in: query, schema: { type: string } }
+        - { name: inboundCode, in: query, schema: { type: string } }
+        - { name: sourceOrderNo, in: query, schema: { type: string } }
+        - { name: containerNo, in: query, schema: { type: string } }
+        - { name: warehouse, in: query, schema: { type: string } }
+        - { name: transferWarehouseCode, in: query, schema: { type: string } }
+        - { name: abnormal, in: query, schema: { type: boolean } }
+        - { name: detained, in: query, schema: { type: boolean } }
+        - { name: createdFrom, in: query, schema: { type: string, format: date-time } }
+        - { name: createdTo, in: query, schema: { type: string, format: date-time } }
+      responses: { '200': { description: 统一 ApiResponse 包装的尾程订单分页 } }
   /api/platform/v1/last-leg/dispatches:
     get:
       summary: 分页查询排车单
@@ -35,6 +56,13 @@ paths:
       description: 权限 platform:overseas-warehouse:inbound-order:list；服务端解析唯一客户范围，仅返回尚未被有效排车锁定的计划或已实收托盘，前端不传 customerId。
       security: [{ bearerAuth: [] }]
       parameters:
+        - name: planIds
+          in: query
+          required: true
+          description: 已选入库计划 ID，逗号分隔；服务端据此解析并校验唯一客户范围。
+          schema: { type: array, minItems: 1, maxItems: 500, items: { type: integer, format: int64 } }
+          style: form
+          explode: false
         - { name: orderNo, in: query, schema: { type: string } }
         - { name: fbaWarehouseCode, in: query, schema: { type: string } }
         - { name: sourceStage, in: query, schema: { type: string, enum: [PLAN, RECEIVED] } }
@@ -45,7 +73,7 @@ paths:
   /api/platform/v1/last-leg/dispatches/pre-arrange:
     post:
       summary: 创建智能预排车单
-      description: 权限 platform:overseas-warehouse:inbound-order:edit；服务端解析唯一客户范围，锁定同一海外仓的所选托盘并创建 PENDING_DEPARTURE 排车单，前端不传 customerId；不开放编辑、取消、depart、PDA 出库或派送。
+      description: 权限 platform:overseas-warehouse:inbound-order:smart-dispatch；服务端根据所选托盘解析并校验唯一客户范围，锁定同一海外仓的托盘并创建 PENDING_DEPARTURE 排车单，前端不传 customerId；不开放编辑、取消、depart、PDA 出库或派送。
       security: [{ bearerAuth: [] }]
       requestBody:
         required: true