feat(lastleg): retain receipt and redispatch history on exceptions

2026-10-04 10:45:05 +08:00
parent 446fad33d0
commit dc993c9713
5 changed files with 194 additions and 4 deletions
@@ -871,10 +871,10 @@ paths:
  /api/platform/v1/last-leg/exception-orders/{exceptionNo}:
    get:
      summary: 查询异常订单详情与冻结退回明细
-      description: 权限 platform:overseas-warehouse:exception-order:list；返回 version 和服务端 allowedActions。
+      description: 权限 platform:overseas-warehouse:exception-order:list；返回 version 和服务端 allowedActions。returnReceipts 保留当前异常全部实收批次及按冻结退回凭据关联的重派排车/派送，包括已耗尽库存；每批及每次重派分别返回数量，不能把候选库存或可变尾程当前单号当历史关联。
      security: [{ bearerAuth: [] }]
      parameters: [{ name: exceptionNo, in: path, required: true, schema: { type: string } }]
-      responses: { '200': { description: 异常订单详情 }, '404': { description: 异常订单不存在 } }
+      responses: { '200': { description: 异常订单详情, content: { application/json: { schema: { $ref: '#/components/schemas/ExceptionOrderDetailResponse' } } } }, '404': { description: 异常订单不存在 } }
  /api/platform/v1/last-leg/exception-orders/{exceptionNo}/start-processing:
    post:
      summary: 开始处理异常订单
@@ -1748,6 +1748,46 @@ paths:
      responses: { '200': { description: 退货箱唛打印数据 }, '404': { description: 当前仓没有该退货箱 } }
 components:
  schemas:
+    ExceptionOrderDetailResponse:
+      type: object
+      properties:
+        code: { type: string }
+        data:
+          type: object
+          required: [order, returnSources, returnReceipts]
+          properties:
+            order: { type: object }
+            returnSources: { type: array, items: { type: object }, description: 当前异常剩余可收来源，不是实收历史 }
+            returnReceipts:
+              type: array
+              description: 全部真实退回实收批次；无实收时为空数组，不因库存耗尽而隐藏
+              items:
+                type: object
+                required: [receiptNo, receivedPackages, receivedAt, redispatches]
+                properties:
+                  receiptNo: { type: string }
+                  receivedPackages: { type: string, pattern: '^[0-9]+$', description: 本批实际实收箱数，Java long按统一JSON合同返回字符串 }
+                  receivedAt: { type: string, format: date-time }
+                  redispatches:
+                    type: array
+                    description: 本凭据关联的全部重派排车；尚未关联时为空数组
+                    items:
+                      type: object
+                      required: [dispatchNo, status, selectedPackages, pickedPackages, deliveries]
+                      properties:
+                        dispatchNo: { type: string }
+                        status: { type: string }
+                        selectedPackages: { type: string, pattern: '^[0-9]+$', description: 本凭据在该排车冻结选定箱数，按排车项去重 }
+                        pickedPackages: { type: string, pattern: '^[0-9]+$', description: 本凭据在该排车的实际PDA拣货箱数，未拣为0 }
+                        deliveries:
+                          type: array
+                          description: 仅关联该退回排车项目的地的派送，不返回同排车其他目的地单据
+                          items:
+                            type: object
+                            required: [deliveryNo, status]
+                            properties:
+                              deliveryNo: { type: string }
+                              status: { type: string }
    DeliveryOrderRow:
      type: object
      required: [deliveryNo, packageCount, signedPackages]