33 · 车务派车协议价快照与对账取价口径（Issue #4797）

日期：2026-07-06
影响端：管理后台车务模块
后端版本：dev-v3 已合并/部署后的 fleet 接口

变更结论

派车时新增/明确 protocolPrice 协议价日单价快照，单位：元/车天。前端在派车弹窗有明确协议价时传入；不传时后端会按所选车辆车型 + 用车开始日从价格日历兜底。保存后写入 fleet_assignment.protocol_price，后续看板、矩阵、当天订单和内部查询均回显该快照。

对账 prep 生成时优先使用派单快照；历史派单快照为空时才回退价格日历。快照为空且价格日历也缺价时，仍返回 605607。

1. 创建派单

POST /admin/fleet/assignments

请求新增/明确字段：

字段	类型	必填	说明
`protocolPrice`	string	否	协议价日单价，元/车天，金额字符串。不能小于 0。

请求示例：

{
  "orderId": "1934567890123456789",
  "orderNo": "26-0503",
  "requirementId": "1934567890123456790",
  "fleetItemIndex": 0,
  "vehicleId": "1934567890123456701",
  "driverId": "1934567890123456702",
  "startDate": "2026-05-06",
  "endDate": "2026-05-11",
  "pickupAt": "hailar",
  "dropoffAt": "hailar",
  "headcount": 6,
  "protocolPrice": "1300.00",
  "holdMode": 1,
  "fromEntry": "from-board",
  "skipCityJunctionException": false,
  "strictSeats": false,
  "requestId": "fleet-assign-20260706-001"
}

响应示例：

{
  "code": 200,
  "data": {
    "id": "2073746962003144705",
    "assignmentStatus": "holding",
    "protocolPrice": "1300.00",
    "holdSentAt": "2026-05-04T09:00:00+08:00"
  },
  "message": "已锁定排车(holding),待司机回执"
}

2. 回显接口

以下接口都会回显 protocolPrice：

接口	字段路径
`GET /admin/fleet/board/orders/{orderId}`	`data.currentAssignment.protocolPrice`
`GET /admin/fleet/matrix/grid`	`data.vehicles[].assignments[].protocolPrice`
`GET /admin/fleet/matrix/day-orders`	`data[].assignments[].protocolPrice`
`GET /internal/fleet/assignment-by-order`	`data.currentAssignment.protocolPrice`、`data.history[].protocolPrice`

矩阵示例：

{
  "id": "2073746962003144705",
  "orderId": "1934567890123456789",
  "customerName": "张先生一家",
  "headcountLabel": "2大1小",
  "startDay": 6,
  "endDay": 11,
  "vehicleCategory": "suv",
  "categoryLabel": "SUV",
  "requiredSource": "order_product",
  "assignmentStatus": "assigned",
  "protocolPrice": "1300.00",
  "productName": "草原沙漠精华6日"
}

3. 对账口径

对账接口本身不新增字段，但 GET /admin/fleet/reconciliation/cars 中的金额已经按 prep 快照聚合。

取价优先级：

fleet_assignment.protocol_price
历史空快照回退 fleet_pricing_calendar.day_price
两者都没有时，生成 prep 抛 605607

前端注意：

展示历史派单时，直接展示接口返回的 protocolPrice，不要用当前价格日历覆盖。
protocolPrice=null 是合法历史/缺价状态，不代表接口失败。
负数协议价会走参数校验失败，前端输入框应限制为非负金额。

3.2 KiB 原始文件 Blame 文件历史 Unescape Escape

33 · 车务派车协议价快照与对账取价口径（Issue #4797）

变更结论

1. 创建派单

2. 回显接口

3. 对账口径

3.2 KiB

原始文件 Blame 文件历史