提交

2026-10-20 11:33:20 +08:00
parent 16ac817524
commit 6fa5d281ec
61 changed files with 31358 additions and 8 deletions
@@ -0,0 +1,83 @@
+openapi: 3.0.3
+info:
+  title: 贴标申请数量维度
+  version: 1.0.0
+  description: 全部筛选结果汇总，不受 page/size 影响。件、箱、SKU分别统计；未知不能解释为零，禁止固定箱规换算。
+paths:
+  /api/platform/v1/last-leg/relabel-applications/quantity-summary:
+    get:
+      operationId: platformRelabelQuantitySummary
+      description: 平台列表权限 platform:overseas-warehouse:relabel:list；范围遵循平台认证访问域。
+      parameters:
+        - $ref: '#/components/parameters/RelabelNo'
+        - $ref: '#/components/parameters/CustomerOrderNo'
+        - $ref: '#/components/parameters/SkuCode'
+        - $ref: '#/components/parameters/Status'
+        - $ref: '#/components/parameters/Warehouse'
+        - $ref: '#/components/parameters/CreatedFrom'
+        - $ref: '#/components/parameters/CreatedTo'
+      responses:
+        '200':
+          $ref: '#/components/responses/Summary'
+  /api/merchant/v1/last-leg/relabel-applications/quantity-summary:
+    get:
+      operationId: merchantRelabelQuantitySummary
+      description: 仅认证客户范围；不接受请求参数覆盖客户身份。权限 merchant:warehouse:relabel:list。
+      parameters:
+        - $ref: '#/components/parameters/RelabelNo'
+        - $ref: '#/components/parameters/CustomerOrderNo'
+        - $ref: '#/components/parameters/SkuCode'
+        - $ref: '#/components/parameters/Status'
+        - $ref: '#/components/parameters/Warehouse'
+        - $ref: '#/components/parameters/CreatedFrom'
+        - $ref: '#/components/parameters/CreatedTo'
+      responses:
+        '200':
+          $ref: '#/components/responses/Summary'
+components:
+  parameters:
+    RelabelNo: {name: relabelNo, in: query, schema: {type: string}, description: 单号模糊匹配}
+    CustomerOrderNo: {name: customerOrderNo, in: query, schema: {type: string}}
+    SkuCode: {name: skuCode, in: query, schema: {type: string}, description: 旧SKU字段或SKU子项匹配}
+    Status: {name: status, in: query, schema: {type: string}, description: PENDING_PROCESSING精确匹配；COMPLETED包含READY_FOR_OUTBOUND与COMPLETED}
+    Warehouse: {name: overseasWarehouseId, in: query, schema: {type: string}}
+    CreatedFrom: {name: createdFrom, in: query, schema: {type: string, format: date-time}}
+    CreatedTo: {name: createdTo, in: query, schema: {type: string, format: date-time}}
+  responses:
+    Summary:
+      description: 标准ApiResponse；code为200时读取data
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              code: {type: string}
+              message: {type: string}
+              requestId: {type: string}
+              traceId: {type: string}
+              data: {$ref: '#/components/schemas/Totals'}
+  schemas:
+    Totals:
+      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}
+        orders:
+          type: object
+          description: 以换标业务单号为键，覆盖全部筛选单据
+          additionalProperties: {$ref: '#/components/schemas/Quantity'}
+    Quantity:
+      type: object
+      properties:
+        labelPieceCount: {type: integer, format: int64, nullable: true, description: 按件任务采用通知件数；箱任务采用SKU子项件数；重复关联或缺失为null}
+        cartonCount: {type: integer, format: int64, nullable: true, description: 箱级任务按箱唛去重；按件来源标识不作为箱数}
+        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: 未提供汇总，详情以本轮有效绑定历史为准}