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

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

## 变更结论

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

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

## 1. 创建派单

`POST /admin/fleet/assignments`

请求新增/明确字段：

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

请求示例：

```json
{
  "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"
}
```

响应示例：

```json
{
  "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` |

矩阵示例：

```json
{
  "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 快照聚合。

取价优先级：

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

前端注意：

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