fix(firstleg): align coload group eligibility

This commit is contained in:
2026-08-29 12:44:42 +08:00
parent 0cf76df168
commit bfcb80b326
11 changed files with 97 additions and 140 deletions
@@ -2,14 +2,14 @@ openapi: 3.0.3
info:
title: Firstleg Coload Group API
version: 1.0.0
description: 同柜且不可拆组平台管理契约;跨客户成组,但仓库、渠道和目的仓港必须一致。
description: 同柜且不可拆组平台管理契约;允许跨客户及不同目的仓港成组,仅要求国内仓和渠道一致。
paths:
/api/platform/v1/first-leg/coload-groups:
post:
summary: 创建同柜不可拆组
description: >-
需要 platform:firstleg:smart-loading:assign。orderIds 至少2项;服务端解析每个订单唯一当前权威入库单,
要求 WAIT_SPLIT、原始MASTER、未拆分、未分配、无子单或拆分批次,并冻结全部成员满箱数。
需要 platform:firstleg:smart-loading:assign。orderIds 至少2项;服务端解析每个订单全部 WAIT_SPLIT、
未分配且未属于其他活动组的可用入库片段,要求国内仓和渠道一致,并冻结全部片段及其满箱数。
parameters:
- $ref: '#/components/parameters/IdempotencyKey'
requestBody:
@@ -130,23 +130,19 @@ components:
ColoadGroup:
type: object
additionalProperties: false
required: [groupId, groupNo, status, warehouseId, channelCode, destinationType,
version, members, fullPackageCount, createdAt, updatedAt]
required: [groupId, groupNo, status, warehouseId, channelCode, version, members,
fullPackageCount, createdAt, updatedAt]
properties:
groupId: {type: string, pattern: '^[1-9][0-9]*$'}
groupNo: {type: string, pattern: '^CLG-[1-9][0-9]*$'}
status: {type: string, enum: [ACTIVE, LOCKED, CONSUMED, CANCELLED]}
warehouseId: {type: string, pattern: '^[1-9][0-9]*$'}
channelCode: {type: string}
destinationType: {type: string}
destinationWarehouseId: {type: string, nullable: true}
destinationCode: {type: string, nullable: true}
lockedPlanId: {type: string, nullable: true}
version: {type: integer, minimum: 0}
members:
type: array
minItems: 2
maxItems: 100
items: {$ref: '#/components/schemas/ColoadGroupMember'}
fullPackageCount: {type: integer, minimum: 2, description: 全部成员满箱数之和}
createdAt: {type: string, format: date-time}
@@ -154,8 +150,7 @@ components:
OrderColoadGroupInfo:
type: object
additionalProperties: false
required: [orderId, inboundId, group]
required: [orderId, group]
properties:
orderId: {type: string, pattern: '^[1-9][0-9]*$'}
inboundId: {type: string, pattern: '^[1-9][0-9]*$'}
group: {$ref: '#/components/schemas/ColoadGroup'}