66 lines
4.0 KiB
YAML
66 lines
4.0 KiB
YAML
openapi: 3.0.3
|
||
info:
|
||
title: 外接登记与整车履约衔接
|
||
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: 实收后复用或生成排车并原子排入本车
|
||
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:
|
||
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}
|