This commit is contained in:
2026-10-19 17:56:36 +08:00
parent bb917c954c
commit dcfba1053c
232 changed files with 15655 additions and 6005 deletions
@@ -5,28 +5,6 @@ info:
security:
- bearerAuth: []
paths:
/api/platform/v1/last-leg/fleet/trips/prepare:
post:
summary: 原子新建或加入车次并关联所选排车单
description: '权限:platform:fleet:trip:edit;新建另需platform:fleet:trip:create和platform:fleet:trip:assign。新建、资源分配和全部关联在同一事务,失败回滚;幂等键同载荷重放原结果,异载荷拒绝。同仓、未执行、未绑定其他车次;不确认容量、不审批、不发车。'
requestBody:
required: true
content:
application/json:
schema: {$ref: '#/components/schemas/Prepare'}
responses:
'200': {description: '统一ApiResponse,data为FleetTripModels.Detail;code=200才成功'}
/api/platform/v1/last-leg/fleet/trips/{tripNo}/dispatch-candidates:
parameters: [{$ref: './fleet-trips-v1.yaml#/components/parameters/TripNo'}]
get:
summary: 本仓未关联且未开始执行的排车候选
description: '权限:platform:fleet:trip:list。数据库筛选后分页,绑定时重新锁定校验。候选不代表预约、装载或审核已完成。'
parameters:
- {name: keyword, in: query, schema: {type: string}}
- {name: page, in: query, schema: {type: integer, minimum: 1, default: 1}}
- {name: size, in: query, schema: {type: integer, minimum: 1, maximum: 100, default: 20}}
responses:
'200': {description: '统一分页data:records含dispatchNo、customerId、warehouseId、packageCount、route及total/page/size/pages;内部身份不作为用户业务编号'}
/api/platform/v1/last-leg/fleet/capacity-offers/inquiries/{bookingNo}/save-and-confirm:
parameters: [{$ref: './fleet-trips-v1.yaml#/components/parameters/BookingNo'}]
post:
@@ -74,7 +52,7 @@ paths:
parameters: [{$ref: './fleet-trips-v1.yaml#/components/parameters/BookingNo'}]
post:
summary: 实收后复用或生成排车并原子排入本车
description: '权限:platform:fleet:capacity-offer:manage、platform:fleet:trip:booking-edit、platform:fleet:trip:edit和platform:overseas-warehouse:inbound-order:smart-dispatch。锁原车次和本票来货,先校验实收快照、车辆、有效容量;来源有多张排车或不完整时拒绝,不另建。无排车时复用真实预排命令;任何校验或绑定失败整体回滚。同键重放不重复建单。成功将预留替换为BOUND,旧计划失效待核对,仍需审核和现场作业。'
description: '权限:platform:fleet:capacity-offer:manage、platform:fleet:trip:booking-edit、platform:fleet:trip:edit和platform:overseas-warehouse:dispatch:create。核对本车唯一排车主单与本票真实客户来货,校验实收快照、车辆及有效容量;货物加入该唯一主单,不能另建或挂入第二张客户排车。校验或整车加货失败整体回滚。同键重放不重复建单。成功将预留替换为BOUND,旧计划失效待核对,仍需审核和现场作业。'
requestBody:
required: true
content: