装柜

firstleg/src/main/resources/openapi/loading-lists-v1.yaml

@@ -7,7 +7,7 @@ paths:
   /api/platform/v1/first-leg/loading-plans:
     get:
       summary: 分页查询预装清单
-      description: 仅返回预装柜中或预装柜完成的计划，计划为平台作业数据，客户账号仅作为明细筛选条件。
+      description: 仓库作业清单必须按仓库查询，返回该仓库全部客户的装柜计划；客户账号仅用于展示货物归属。
       x-permission: platform:firstleg:preload:list
       parameters:
         - {$ref: '#/components/parameters/Page'}
@@ -17,7 +17,6 @@ paths:
           in: query
           description: 预装状态
           schema: {type: string, enum: [LOADING]}
-        - {$ref: '#/components/parameters/AccountId'}
         - {$ref: '#/components/parameters/WarehouseId'}
         - {$ref: '#/components/parameters/CreatedFrom'}
         - {$ref: '#/components/parameters/CreatedTo'}
@@ -28,7 +27,7 @@ paths:
       summary: 查询预装清单详情
       description: 返回同一装柜计划的汇总、冻结明细和完整操作历史。
       x-permission: platform:firstleg:preload:view
-      parameters: [{$ref: '#/components/parameters/PlanId'}]
+      parameters: [{$ref: '#/components/parameters/PlanId'}, {$ref: '#/components/parameters/WarehouseId'}]
       responses:
         '200': {$ref: '#/components/responses/PreloadDetailResponse'}
   /api/platform/v1/first-leg/loading-plans/{planId}/transport:
@@ -38,6 +37,7 @@ paths:
       x-permission: platform:firstleg:preload:edit
       parameters:
         - {$ref: '#/components/parameters/PlanId'}
+        - {$ref: '#/components/parameters/WarehouseId'}
         - {$ref: '#/components/parameters/IdempotencyKey'}
       requestBody:
         required: true
@@ -64,13 +64,12 @@ paths:
   /api/platform/v1/first-leg/loading-lists:
     get:
       summary: 分页查询装柜清单
-      description: 读取同一个装柜计划聚合，仅返回 COMPLETED 状态记录。
+      description: 必须按仓库查询，只返回该仓库的 COMPLETED 装柜计划，包含全部客户单据。
       x-permission: platform:firstleg:loading-list:list
       parameters:
         - {$ref: '#/components/parameters/Page'}
         - {$ref: '#/components/parameters/Size'}
         - {$ref: '#/components/parameters/Keyword'}
-        - {$ref: '#/components/parameters/AccountId'}
         - {$ref: '#/components/parameters/WarehouseId'}
         - {$ref: '#/components/parameters/CreatedFrom'}
         - {$ref: '#/components/parameters/CreatedTo'}
@@ -81,7 +80,7 @@ paths:
       summary: 查询装柜清单详情
       description: 返回已确认计划的汇总、冻结明细和操作历史，全部只读。
       x-permission: platform:firstleg:loading-list:view
-      parameters: [{$ref: '#/components/parameters/PlanId'}]
+      parameters: [{$ref: '#/components/parameters/PlanId'}, {$ref: '#/components/parameters/WarehouseId'}]
       responses:
         '200': {$ref: '#/components/responses/ConfirmedDetailResponse'}
 components:
@@ -113,15 +112,11 @@ components:
       in: query
       description: 按预装单号、集装箱号或柜号模糊查询
       schema: {type: string, maxLength: 128}
-    AccountId:
-      name: accountId
-      in: query
-      description: 客户账号 ID 筛选条件，计划本身仍属于平台作业数据
-      schema: {$ref: '#/components/schemas/LongId'}
     WarehouseId:
       name: warehouseId
       in: query
-      description: 仓库 ID
+      required: true
+      description: 仓库 ID；同一仓库内全部客户单据均可见
       schema: {$ref: '#/components/schemas/LongId'}
     CreatedFrom:
       name: createdFrom