openapi: 3.0.3
info:
  title: 贴标申请数量维度
  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
      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: 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: 以换标业务单号为键，覆盖全部筛选单据
          additionalProperties: {$ref: '#/components/schemas/Quantity'}
    Quantity:
      type: object
      properties:
        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: 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]+$'}