提交

lastleg-service/src/main/resources/openapi/fleet-trips-v1.yaml

@@ -27,6 +27,36 @@ info:
 security:
   - bearerAuth: []
 paths:
+  /api/platform/v1/last-leg/fleet/trips/{tripNo}/resource-occupancy:
+    get:
+      summary: 批量读取当前下拉候选的实际车辆或司机占用
+      description: 仅平台且须platform:fleet:trip:list。本车已占用仍可保留；别车占用不可选。只反映占用，不代表证照或容量合格，不产生资源预留，保存分配时再次复验。
+      parameters:
+        - {in: path, name: tripNo, required: true, schema: {type: string}}
+        - {in: query, name: kind, required: true, schema: {type: string, enum: [VEHICLE, DRIVER]}}
+        - in: query
+          name: resourceIds
+          required: true
+          style: form
+          explode: false
+          schema: {type: array, minItems: 1, maxItems: 100, items: {type: string, pattern: '^[1-9][0-9]*$'}}
+      responses:
+        '200':
+          description: 标准业务响应；data为候选占用数组，HTTP200亦需检查code。业务无权限、参数错误及资源不存在沿统一错误码。
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  code: {type: string}
+                  data:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        resourceId: {type: string}
+                        occupiedTripNo: {type: string, nullable: true}
+                        available: {type: boolean}
   /api/platform/v1/last-leg/fleet/trips/calendar:
     get:
       summary: 读取美国车次用车日历来源
@@ -746,6 +776,7 @@ components:
       type: object
       properties:
         tripNo: {type: string}
+        tripPurpose: {type: string, enum: [DELIVERY, PICKUP], description: 派送车次或入仓取货车次}
         status: {type: string, enum: [PLANNED, IN_TRANSIT, COMPLETED, CANCELLED]}
         warehouseId: {type: string}
         warehouseCode: {type: string}