提交

lastleg-service/src/main/resources/openapi/dispatch-looseboard-execution-v1.yaml

@@ -4,20 +4,40 @@ info:
   version: 1.0.0
   description: >-
     仅同客户权威关联的本土散板明细进入照片节点。全车为散板且尚无真实扫码时，审核通过后逐票保存取货照片，
-    自动从LOADING进入DELIVERING；不生成库存、PDA拣货或仓库出库事实。逐票保存送达照片后自动DELIVERED并结案释放车辆司机。
-    混排从AFTER_LOADING或DELIVERING可逐票保存取货及送达照片；同票须先取货再送达，不同票不限制取送顺序。
-    装车后保存照片保持原阶段，保留原PDA出库及装车资料齐全后进入派送的链路；全部仓内货签收且散板照片齐全才可整车完结。既有真实扫码不可抹除或倒改。
+    全部齐全才显示取货完成按钮；显式确认后从LOADING进入DELIVERING。不生成库存、PDA拣货或仓库出库事实。逐票保存送达照片后自动DELIVERED并结案释放车辆司机。
+    混排从AFTER_LOADING或DELIVERING可逐票保存取货及送达照片；异地货同票须先取货再送达，不同票不限制取送顺序。
+    仓内实托走原出库签收链，不要求散板节点照片；页面按pickupRequired仅展示本趟上门取货货物，送货到仓尚未入库则保留warehouseNotice提示。
+    混排仓内真实装车确认后即发运仓内货，不等待异地取货或五类装车照片；剩余装车资料可以补传。
+    仓内已发运而异地货尚未确认取齐时，同时展示在装车后和派送中，两页签计数允许重叠但总数不重复。
+    取货照片齐全不自动完成取货；点击取货完成后仅在派送中展示，异地货量只在该确认动作计入。全部仓内货签收且散板确认取货并送达照片齐全才可整车完结。
     图片只接受10MiB以内JPG或PNG，每票每节点最多20张。保存提交该节点完整保留列表，支持追加和逐张删除；空列表代表删除最后一张。
     整车已完结的节点及已有送达照片的取货节点至少保留一张凭证，可先追加再删除；修改照片不撤销已执行的取货、发运或送达，不重复累计货量。
     上传不等于保存，保存用公共版本和幂等键，失败同事务回滚。历史照片列表保留审计，仅最新列表授权预览。
     本土散板号只用LB原单，不生成入仓码、柜号或虚构派送单号。分车运输按已保存送达照片的明细去重累计箱数，整票送达后才完成原单。
 paths:
+  /api/platform/v1/last-leg/dispatches/{number}/looseboard-execution/pickup-complete:
+    parameters:
+      - { name: number, in: path, required: true, schema: { type: string } }
+    post:
+      summary: 人工确认本车全部上门取货完成
+      description: 需要platform:overseas-warehouse:dispatch:edit。逐票取货照片齐全、当前阶段允许且本轮尚未确认时才允许提交。公共版本及幂等键保护，失败回滚确认历史、数量及发运。返回Detail包含canCompletePickup及pickupCompleted。
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [recordVersion, idempotencyKey]
+              properties:
+                recordVersion: { type: integer, format: int64, minimum: 0 }
+                idempotencyKey: { type: string, minLength: 8, maxLength: 128 }
+      responses: { '200': { description: 当前照片与人工取货确认状态 } }
   /api/platform/v1/last-leg/dispatches/{number}/looseboard-execution:
     parameters:
       - { name: number, in: path, required: true, schema: { type: string } }
     get:
       summary: 读取散板逐票照片与节点资格
-      description: 需要platform:overseas-warehouse:dispatch:list。data包含dispatchNo、recordVersion、stage、direct和items；items包含itemId、customerId、orderNo、destination、packages、pickupPhotos、arrivalPhotos、canPickup、canArrive。
+      description: 需要platform:overseas-warehouse:dispatch:list。data包含dispatchNo、recordVersion、stage、direct和items；items包含itemId、customerId、orderNo、destination、packages、pickupPhotos、arrivalPhotos、canPickup、canArrive、warehouseNotice、pickupRequired。pickupRequired仅未入仓且选择上门取货的票为true。warehouseNotice仅送货到仓且尚无入仓实托时返回带原单号的待入仓提示，其他情况为null。
       responses: { '200': { description: 统一ApiResponse } }
   /api/platform/v1/last-leg/dispatches/{number}/looseboard-execution/{itemId}/{phase}/uploads:
     parameters: