优化

2026-09-11 11:51:26 +08:00
parent d60689ce02
commit d2cff49b9e
45 changed files with 569 additions and 66 deletions
@@ -2,12 +2,13 @@ openapi: 3.0.3
 info:
  title: 一件代发国内清点组托 API
  version: 2.0.0
-  description: 测量、计费后独立下发。箱码逐箱确认 SKU 实收数量；托盘码可先扫或后扫，封托后作为不可拆分柜单元。
+  description: 测量、计费后独立下发。先逐箱确认 SKU 实收数量；全部箱码清点完成后才原子生成、绑定并封存正式 DP 托盘码，随后可打印托盘标签。
 paths:
  /api/platform/v1/first-leg/pda-dropship/tasks/pending:
    get:
      summary: 查询待领取或本人已领取任务
      x-required-authority: platform:firstleg:pda:view
+      parameters: [{$ref: '#/components/parameters/WarehouseId'}, {name: keyword, in: query, required: false, schema: {type: string, maxLength: 64}}]
      responses: {'200': {description: OK}}
  /api/platform/v1/first-leg/pda-dropship/tasks/{taskId}:
    get:
@@ -33,8 +34,8 @@ paths:
      responses: {'200': {description: OK}}
  /api/platform/v1/first-leg/pda-dropship/tasks/{taskId}/cartons/count:
    post:
-      summary: 逐箱确认 SKU 实收数量，可同时绑定当前托盘
-      description: palletNo 为空时进入 COUNTED_UNBOUND；不为空时幂等获取或创建 OPEN 托盘并绑定。数量不一致必须 ACCEPT_VARIANCE 且填写说明。
+      summary: 逐箱确认 SKU 实收数量
+      description: 清点阶段只记录箱级实收并进入 COUNTED_UNBOUND，不得提前生成或绑定托盘码。数量不一致必须 ACCEPT_VARIANCE 且填写说明。
      x-required-authority: platform:firstleg:pda:work
      parameters: [{$ref: '#/components/parameters/TaskId'}]
      requestBody: {required: true, content: {application/json: {schema: {$ref: '#/components/schemas/CountCartonRequest'}}}}
@@ -48,8 +49,8 @@ paths:
      responses: {'200': {description: OK}}
  /api/platform/v1/first-leg/pda-dropship/tasks/{taskId}/pallets/create-and-bind:
    post:
-      summary: 系统生成 DP 托盘码并原子绑定全部待绑箱
-      description: 仅当前仓库本人已领取的待组托任务可执行。没有待绑箱时不发码、不建空托。operationId 在同任务和仓库重放不重复创建；不同任务使用同幂等号拒绝。返回当前 Task。
+      summary: 完成一件代发入库并生成正式 DP 托盘码
+      description: 仅全部箱码已经清点的本人任务可执行；同一事务内生成 DP 托盘码、绑定全部箱、封托并把入仓单推进到待分柜。未完成清点或没有待绑箱时不发码、不建空托。operationId 重放不重复创建；返回已完成 Task。
      x-required-authority: platform:firstleg:pda:work
      parameters: [{$ref: '#/components/parameters/TaskId'}]
      requestBody: {required: true, content: {application/json: {schema: {$ref: '#/components/schemas/CreateAndBindRequest'}}}}
@@ -72,6 +73,17 @@ paths:
        - {name: palletId, in: path, required: true, schema: {type: integer, format: int64}}
      requestBody: {required: true, content: {application/json: {schema: {$ref: '#/components/schemas/SealPalletRequest'}}}}
      responses: {'200': {description: OK}}
+  /api/platform/v1/first-leg/pda-dropship/tasks/{taskId}/pallets/{palletId}/print:
+    get:
+      summary: PDA 打印已封托的一件代发托盘码
+      description: 仅当前仓库、当前操作员可访问；未封托托盘拒绝打印。返回 100mm × 100mm PDF。
+      x-required-authority: platform:firstleg:pda:view
+      parameters:
+        - {$ref: '#/components/parameters/TaskId'}
+        - {name: palletId, in: path, required: true, schema: {type: integer, format: int64}}
+        - {$ref: '#/components/parameters/WarehouseId'}
+      responses:
+        '200': {description: 托盘码 PDF, content: {application/pdf: {schema: {type: string, format: binary}}}}
  /api/platform/v1/first-leg/pda-dropship/inbound-orders/{inboundId}/pallets:
    get:
      summary: Admin 查询入仓单权威托盘结果
@@ -134,7 +146,6 @@ components:
        actualSkuQuantity: {type: integer, minimum: 1}
        discrepancyAction: {type: string, enum: [MATCH, ACCEPT_VARIANCE]}
        discrepancyRemark: {type: string, maxLength: 500, nullable: true}
-        palletNo: {$ref: '#/components/schemas/NullablePalletNo'}
        operationId: {type: string, maxLength: 128}
    BindPendingRequest:
      type: object
@@ -3,6 +3,17 @@ info:
  title: Phase 3 Container PDA Picking API
  version: 1.0.0
 paths:
+  /api/platform/v1/first-leg/pda-loading/warehouses:
+    get:
+      summary: List active domestic warehouses available to the PDA operator
+      responses:
+        '200':
+          description: Warehouse master-data options used to scope PDA pending-task lists
+          content:
+            application/json:
+              schema:
+                type: array
+                items: {$ref: '#/components/schemas/WarehouseOption'}
  /api/platform/v1/first-leg/pda-loading/tasks:
    get:
      summary: Find the active container picking task in one platform warehouse
@@ -18,6 +29,7 @@ paths:
    get:
      summary: List active tasks available to the authenticated PDA operator
      parameters:
+        - {name: warehouseId, in: query, required: true, schema: {type: integer, format: int64, minimum: 1}}
        - {name: keyword, in: query, required: false, schema: {type: string, maxLength: 64}}
      responses:
        '200':
@@ -175,6 +187,13 @@ components:
    TaskId: {name: taskId, in: path, required: true, schema: {type: integer, format: int64, minimum: 1}}
    ItemId: {name: itemId, in: path, required: true, schema: {type: integer, format: int64, minimum: 1}}
  schemas:
+    WarehouseOption:
+      type: object
+      required: [id, warehouseCode, warehouseName]
+      properties:
+        id: {type: integer, format: int64}
+        warehouseCode: {type: string}
+        warehouseName: {type: string}
    Task:
      type: object
      required: [id, loadingPlanId, containerBookingId, inboundId, inboundVersion, loadingVersion, cabinetNo, sourceType, recordStatus, taskStatus, workflowStatus, version, items]