提交

lastleg-service/src/main/resources/openapi/relabel-quantities-v1.yaml

@@ -4,6 +4,17 @@ info:
   version: 1.0.0
   description: 全部筛选结果汇总，不受 page/size 影响。件、箱、SKU分别统计；未知不能解释为零，禁止固定箱规换算。
 paths:
+  /api/platform/v1/last-leg/relabel-applications/inventory-candidates:
+    get:
+      operationId: platformRelabelInventoryCandidates
+      description: 平台代客创建候选；权限platform:overseas-warehouse:relabel:create。客户和公共作业仓均必须显式选择，返回与客户创建端相同的InventoryCandidate结构。
+      parameters:
+        - {name: customerId, in: query, required: true, schema: {type: string}}
+        - {name: operationWarehouseId, in: query, required: true, schema: {type: string}}
+        - {name: inboundCode, in: query, schema: {type: string}}
+      responses:
+        '200':
+          description: 标准ApiResponse，data为正式库存候选数组；普通库存包含inventoryBalanceId/inboundOrderId/positions，退货包含returnCartonId/cartonMark/cartonSkuItems/cartonAvailablePackages。所有Long ID为十进制字符串。
   /api/platform/v1/last-leg/relabel-applications/quantity-summary:
     get:
       operationId: platformRelabelQuantitySummary
@@ -61,12 +72,16 @@ components:
       type: object
       required: [orderCount, skuCount, knownLabelPieceCount, unknownPieceOrders, knownCartonCount, unknownCartonOrders, orders]
       properties:
-        orderCount: {type: integer, format: int64, minimum: 0}
-        skuCount: {type: integer, format: int64, minimum: 0, description: 全部筛选结果的不同旧SKU数}
-        knownLabelPieceCount: {type: integer, format: int64, minimum: 0}
-        unknownPieceOrders: {type: integer, format: int64, minimum: 0}
-        knownCartonCount: {type: integer, format: int64, minimum: 0}
-        unknownCartonOrders: {type: integer, format: int64, minimum: 0}
+        orderCount: {type: string, pattern: '^[0-9]+$'}
+        skuCount: {type: string, pattern: '^[0-9]+$', description: 全部筛选结果的不同旧SKU数}
+        knownLabelPieceCount: {type: string, pattern: '^[0-9]+$'}
+        unknownPieceOrders: {type: string, pattern: '^[0-9]+$'}
+        knownCartonCount: {type: string, pattern: '^[0-9]+$'}
+        unknownCartonOrders: {type: string, pattern: '^[0-9]+$'}
+        knownSourcePalletCount: {type: string, pattern: '^[0-9]+$', description: 已知完整原托快照按仓库和托盘码在全部筛选单据间去重}
+        unknownSourcePalletOrders: {type: string, pattern: '^[0-9]+$'}
+        knownTargetPalletCount: {type: string, pattern: '^[0-9]+$', description: 本轮完整目标快照按仓库和托盘码去重；返工旧轮目标不计}
+        unknownTargetPalletOrders: {type: string, pattern: '^[0-9]+$'}
         orders:
           type: object
           description: 以换标业务单号为键，覆盖全部筛选单据
@@ -74,10 +89,15 @@ components:
     Quantity:
       type: object
       properties:
-        labelPieceCount: {type: integer, format: int64, nullable: true, description: 按件任务采用通知件数；箱任务采用SKU子项件数；重复关联或缺失为null}
-        cartonCount: {type: integer, format: int64, nullable: true, description: 箱级任务按箱唛去重；按件来源标识不作为箱数}
+        labelPieceCount: {type: string, pattern: '^[0-9]+$', nullable: true, description: 按件任务采用通知件数；箱任务采用SKU子项件数；重复关联或缺失为null}
+        cartonCount: {type: string, pattern: '^[0-9]+$', nullable: true, description: 箱级任务按箱唛去重；按件任务仅在全部精确来源快照都是BOX时按来源主键去重，PALLET/PARCEL不冒充箱数}
         skuCount: {type: integer, minimum: 0}
         duplicateCarton: {type: boolean, description: 历史重复任务关联提示，不将同一来源不同SKU按件任务视为重复}
         quantityUnit: {type: string, enum: [PIECE, CARTON, UNKNOWN]}
-        sourcePalletCount: {type: integer, format: int64, nullable: true, description: 缺少不可变原托快照时为null}
-        targetPalletCount: {type: integer, format: int64, nullable: true, description: 未提供汇总，详情以本轮有效绑定历史为准}
+        sourcePalletCount: {type: string, pattern: '^[0-9]+$', nullable: true, description: 缺少不可变原托快照时为null}
+        targetPalletCount: {type: string, pattern: '^[0-9]+$', nullable: true, description: 每个任务本轮最后一次可信绑定的不同目标托盘数；未绑定完整为null}
+        sourceUnitCounts:
+          type: object
+          nullable: true
+          description: 首次认领时已清点且精确关联的退货来源主键按BOX/PARCEL/PALLET分类去重；任一来源缺失时为null，不按标识外形猜测
+          additionalProperties: {type: string, pattern: '^[0-9]+$'}