优化

2026-08-30 17:02:19 +08:00
parent 0aa77327d5
commit ca9e7b60e8
40 changed files with 1471 additions and 6 deletions
@@ -414,6 +414,29 @@ paths:
        - {name: bookingId, in: query, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
        - {name: warehouseId, in: query, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
      responses: {'200': {description: 成功，data 为入仓码级候选列表}}
+  /api/platform/v1/first-leg/loading-associations/summary:
+    get:
+      summary: 查询入仓片段的装柜与国内PDA关联摘要
+      description: >-
+        需要 platform:firstleg:smart-loading:list 权限。inboundId 与 inboundCode 必须且只能提供一个；
+        inboundCode 是订单当前有效入仓片段业务号。响应优先提供 orderNo、loadingPlanNo、cabinetNo/containerNo、
+        loadingStatus、pdaTaskStatus 与 coLoadGroupNo 供页面展示；loadingPlanId、containerBookingId、taskId、
+        coLoadGroupId 和 items[].itemId 仅为技术关联，不得替代业务号作为UI主标识。
+      parameters:
+        - {name: inboundId, in: query, required: false, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
+        - {name: inboundCode, in: query, required: false, schema: {type: string, minLength: 1, maxLength: 40}}
+      responses:
+        '200':
+          description: 成功或业务失败；未进入装柜时仍返回 inboundId/inboundCode，其余关联字段为空
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [code, message, data]
+                properties:
+                  code: {type: string, example: '200'}
+                  message: {type: string}
+                  data: {$ref: '#/components/schemas/LoadingAssociationSummary'}
  /api/platform/v1/first-leg/smart-loading/plans/{planId}:
    get:
      summary: 查询智能装柜草稿详情
@@ -1682,6 +1705,31 @@ components:
        expectedPlanVersion: {type: integer, minimum: 0}
        expectedItemVersion: {type: integer, minimum: 0}
        operationId: {type: string, minLength: 1, maxLength: 128}
+    LoadingAssociationSummary:
+      type: object
+      required: [inboundId, inboundCode, orderNo, items]
+      properties:
+        inboundId: {type: string, pattern: '^[1-9][0-9]*$', description: 入仓片段内部技术ID}
+        inboundCode: {type: string, minLength: 1, maxLength: 40, description: 订单当前入仓片段业务号，UI主展示}
+        orderNo: {type: string, nullable: true, description: 订单业务号，UI主展示}
+        loadingPlanId: {type: string, pattern: '^[1-9][0-9]*$', nullable: true, description: 装柜计划技术关联ID}
+        loadingPlanNo: {type: string, nullable: true, pattern: '^LP-[0-9]{6}-[0-9]{4}$', description: 装柜计划业务号，UI主展示}
+        containerBookingId: {type: string, pattern: '^[1-9][0-9]*$', nullable: true, description: 柜次技术关联ID}
+        cabinetNo: {type: string, nullable: true, description: 稳定柜次业务号，UI主展示}
+        containerNo: {type: string, nullable: true, description: 真实集装箱号，UI主展示}
+        loadingStatus: {type: string, enum: [EDITING, LOADING, COMPLETED], nullable: true}
+        taskId: {type: string, pattern: '^[1-9][0-9]*$', nullable: true, description: 国内PDA任务技术关联ID}
+        pdaTaskStatus: {type: string, enum: [UNASSIGNED, IN_PROGRESS, AWAITING_REVIEW, PROCESSING, COMPLETION_FAILED, COMPLETED], nullable: true, description: 国内PDA任务业务状态}
+        coLoadGroupId: {type: string, pattern: '^[1-9][0-9]*$', nullable: true, description: 同柜不可拆组技术关联ID}
+        coLoadGroupNo: {type: string, nullable: true, description: 同柜不可拆组业务号，UI主展示}
+        items:
+          type: array
+          description: 装柜明细技术关联；不作为UI主展示
+          items:
+            type: object
+            required: [itemId]
+            properties:
+              itemId: {type: string, pattern: '^[1-9][0-9]*$'}
    SmartLoadingPlan:
      type: object
      required: [id, planNo, status, bookingId, version, canAssign, canEdit, finalCompletionStatus, items]