2026-10-09 22:04:49 +08:00
|
|
|
|
openapi: 3.0.3
|
|
|
|
|
|
info:
|
2026-10-20 10:35:52 +08:00
|
|
|
|
title: 外接登记与整车履约衔接
|
2026-10-09 22:04:49 +08:00
|
|
|
|
version: 1.0.0
|
|
|
|
|
|
security:
|
|
|
|
|
|
- bearerAuth: []
|
|
|
|
|
|
paths:
|
|
|
|
|
|
/api/platform/v1/last-leg/fleet/capacity-offers/inquiries/{bookingNo}/save-and-confirm:
|
|
|
|
|
|
parameters: [{$ref: './fleet-trips-v1.yaml#/components/parameters/BookingNo'}]
|
|
|
|
|
|
post:
|
|
|
|
|
|
summary: 同窗补齐登记资料并原子确认承运
|
|
|
|
|
|
description: '权限：platform:fleet:capacity-offer:manage。复用InquiryWrite，更新资料、创建唯一商业订单及占位同事务；任何阶段失败全部回滚，不把保存当成交。同键同载荷返回原结果。'
|
|
|
|
|
|
requestBody:
|
|
|
|
|
|
required: true
|
|
|
|
|
|
content:
|
|
|
|
|
|
application/json:
|
|
|
|
|
|
schema: {$ref: './fleet-capacity-offers-v1.yaml#/components/schemas/InquiryWrite'}
|
|
|
|
|
|
responses:
|
|
|
|
|
|
'200': {description: '统一ApiResponse，data为InquiryResult'}
|
|
|
|
|
|
/api/platform/v1/last-leg/fleet/capacity-offers/inquiries/{bookingNo}/fulfillment:
|
|
|
|
|
|
parameters: [{$ref: './fleet-trips-v1.yaml#/components/parameters/BookingNo'}]
|
|
|
|
|
|
get:
|
|
|
|
|
|
summary: 从原登记查看本票履约进度
|
|
|
|
|
|
description: '权限：platform:fleet:capacity-offer:list或platform:fleet:capacity-offer:manage。销售仅本人；返回本票booking、preview及plannedDepartureAt，不返回整车司机或他人货物。preview含tripRecordVersion、recordVersion、incoming，未安排时incoming为null。'
|
|
|
|
|
|
responses:
|
|
|
|
|
|
'200': {description: '统一ApiResponse，data为Fulfillment'}
|
|
|
|
|
|
/api/platform/v1/last-leg/fleet/capacity-offers/inquiries/{bookingNo}/incoming:
|
|
|
|
|
|
parameters: [{$ref: './fleet-trips-v1.yaml#/components/parameters/BookingNo'}]
|
|
|
|
|
|
post:
|
|
|
|
|
|
summary: 从原登记明确安排来货
|
|
|
|
|
|
description: '权限：platform:fleet:capacity-offer:manage和platform:fleet:trip:booking-edit。复用版本及幂等门禁，未填时间时沿用登记预计到仓，仍缺失则拒绝，不自动减两小时猜测。承运确认不自动调用此命令。'
|
|
|
|
|
|
requestBody:
|
|
|
|
|
|
required: true
|
|
|
|
|
|
content:
|
|
|
|
|
|
application/json:
|
|
|
|
|
|
schema: {$ref: './fleet-trips-v1.yaml#/components/schemas/BookingIncoming'}
|
|
|
|
|
|
responses:
|
|
|
|
|
|
'200': {$ref: './fleet-trips-v1.yaml#/components/responses/BookingResult'}
|
|
|
|
|
|
/api/platform/v1/last-leg/fleet/capacity-offers/inquiries/{bookingNo}/receipt-confirmation:
|
|
|
|
|
|
parameters: [{$ref: './fleet-trips-v1.yaml#/components/parameters/BookingNo'}]
|
|
|
|
|
|
post:
|
|
|
|
|
|
summary: 原登记核对真实实收与约定运费
|
|
|
|
|
|
description: '权限：platform:fleet:capacity-offer:manage和platform:fleet:trip:booking-confirm。沿实际receiptHash/托盘和三维容量校验；不以预报覆盖实收。'
|
|
|
|
|
|
requestBody:
|
|
|
|
|
|
required: true
|
|
|
|
|
|
content:
|
|
|
|
|
|
application/json:
|
|
|
|
|
|
schema: {$ref: './fleet-trips-v1.yaml#/components/schemas/BookingAcceptReceipt'}
|
|
|
|
|
|
responses:
|
|
|
|
|
|
'200': {$ref: './fleet-trips-v1.yaml#/components/responses/BookingResult'}
|
|
|
|
|
|
/api/platform/v1/last-leg/fleet/capacity-offers/inquiries/{bookingNo}/arrange-dispatch:
|
|
|
|
|
|
parameters: [{$ref: './fleet-trips-v1.yaml#/components/parameters/BookingNo'}]
|
|
|
|
|
|
post:
|
|
|
|
|
|
summary: 实收后复用或生成排车并原子排入本车
|
2026-10-19 17:56:36 +08:00
|
|
|
|
description: '权限：platform:fleet:capacity-offer:manage、platform:fleet:trip:booking-edit、platform:fleet:trip:edit和platform:overseas-warehouse:dispatch:create。核对本车唯一排车主单与本票真实客户来货，校验实收快照、车辆及有效容量；货物加入该唯一主单，不能另建或挂入第二张客户排车。校验或整车加货失败整体回滚。同键重放不重复建单。成功将预留替换为BOUND，旧计划失效待核对，仍需审核和现场作业。'
|
2026-10-09 22:04:49 +08:00
|
|
|
|
requestBody:
|
|
|
|
|
|
required: true
|
|
|
|
|
|
content:
|
|
|
|
|
|
application/json:
|
|
|
|
|
|
schema: {$ref: './fleet-trips-v1.yaml#/components/schemas/BookingCommand'}
|
|
|
|
|
|
responses:
|
|
|
|
|
|
'200': {$ref: './fleet-trips-v1.yaml#/components/responses/BookingResult'}
|
|
|
|
|
|
components:
|
|
|
|
|
|
securitySchemes:
|
|
|
|
|
|
bearerAuth: {type: http, scheme: bearer, bearerFormat: JWT}
|
