提交

2026-10-15 18:25:53 +08:00
parent caff693ad8
commit cda5f3dc32
10 changed files with 109 additions and 16 deletions
@@ -33,7 +33,7 @@ paths:
  /api/pda/v1/last-leg/warehouse-transfers/{transferNo}/cartons/count:
    post:
      summary: 转运逐箱测量与清点
-      description: 仅限 lastleg:pda:operate 与 OVERSEAS_WAREHOUSE_PDA_OPERATOR，绑定仓由统一Token确定。先创建本单托盘号，每箱选择所属托盘并按申报SKU记录实点件数，托盘体积重量由分配箱子汇总，全部实收箱子测量清点后才可完成打托入库，打托箱数与已清点实收箱数核平；短收箱保留未收到事实，超收生成系统箱号；差异需原因。事务锁定转运单；原键原载荷重试不重复写入，同键不同载荷拒绝，已确认事实不可覆盖。
+      description: 仅限 lastleg:pda:operate 与 OVERSEAS_WAREHOUSE_PDA_OPERATOR，绑定仓由统一Token确定。先创建本单托盘号，每箱选择所属托盘，可包含多个本单预报SKU，逐项记录实点件数；同箱SKU不可重复，尺寸重量和实收箱数按实物箱计算一次，托盘体积重量由分配箱子汇总，全部实收箱子测量清点后才可完成打托入库，打托箱数与已清点实收箱数核平；短收箱保留未收到事实，超收生成系统箱号；差异需原因。事务锁定转运单；原键原载荷重试不重复写入，同键不同载荷拒绝，已确认事实不可覆盖。
      parameters:
        - {name: transferNo, in: path, required: true, schema: {type: string}}
      requestBody:
@@ -52,7 +52,7 @@ paths:
                  maxItems: 5000
                  items:
                    type: object
-                    required: [transferPalletId, length, width, height, weight, skuCode, quantity]
+                    required: [transferPalletId, length, width, height, weight, items]
                    properties:
                      cartonMark: {type: string, maxLength: 255, nullable: true, description: 已有箱号；新增超收箱不传，由服务端生成}
                      transferItemId: {type: integer, format: int64, nullable: true, description: 新增超收箱所属本单申报明细}
@@ -61,10 +61,19 @@ paths:
                      width: {type: number, minimum: 0.01, description: 箱宽厘米}
                      height: {type: number, minimum: 0.01, description: 箱高厘米}
                      weight: {type: number, minimum: 0.01, description: 箱重千克}
-                      skuCode: {type: string, maxLength: 255}
-                      quantity: {type: integer, minimum: 1, maximum: 2147483647, description: 箱内实点件数}
+                      items:
+                        type: array
+                        minItems: 1
+                        maxItems: 200
+                        description: 本箱实际SKU明细，仅限本单预报SKU，同箱不可重复
+                        items:
+                          type: object
+                          required: [skuCode, quantity]
+                          properties:
+                            skuCode: {type: string, maxLength: 255}
+                            quantity: {type: integer, minimum: 1, maximum: 2147483647, description: 本SKU箱内实点件数}
      responses:
-        '200': {description: 统一业务响应，成功data为转运详情，cartons含逐箱尺寸重量件数及清点操作人时间}
+        '200': {description: 统一业务响应，成功data为转运详情，cartons含逐箱尺寸重量、quantity合计件数、items逐SKU明细（transferItemId/skuCode/quantity）及清点操作人时间}
  /api/platform/v1/last-leg/inventory/balances/{balanceId}:
    get:
      summary: 查询单条库存余额详情