84 lines
4.4 KiB
YAML
84 lines
4.4 KiB
YAML
|
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: 未提供汇总，详情以本轮有效绑定历史为准}
|