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}