From c46f388641b68d9033bef96d4adf4e9e3c67c19e Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Mon, 6 Jul 2026 10:40:45 +0800 Subject: [PATCH] docs: clarify fleet frontend contracts --- ...¦åŠ¡èœå•å…¨æŽ¥å£éªŒæ”¶ä¸Žå‰ç«¯å¥‘约收å£-管ç†åŽå°.md | 301 +++++++++++++++++- ...¸æœºé™©è‡ªåŠ¨æŠ•é€€ä¿é—­çŽ¯ä¸Žä¿é™©èœå•å¥‘约-管ç†åŽå°.md | 9 + 2 files changed, 293 insertions(+), 17 deletions(-) diff --git a/changelogs-v2/2026-07/25_4756_车务èœå•å…¨æŽ¥å£éªŒæ”¶ä¸Žå‰ç«¯å¥‘约收å£-管ç†åŽå°.md b/changelogs-v2/2026-07/25_4756_车务èœå•å…¨æŽ¥å£éªŒæ”¶ä¸Žå‰ç«¯å¥‘约收å£-管ç†åŽå°.md index 6d936ce..cf03a5c 100644 --- a/changelogs-v2/2026-07/25_4756_车务èœå•å…¨æŽ¥å£éªŒæ”¶ä¸Žå‰ç«¯å¥‘约收å£-管ç†åŽå°.md +++ b/changelogs-v2/2026-07/25_4756_车务èœå•å…¨æŽ¥å£éªŒæ”¶ä¸Žå‰ç«¯å¥‘约收å£-管ç†åŽå°.md @@ -22,6 +22,7 @@ | 场景 | å‰ç«¯å¤„ç† | |------|----------| | 当å‰è§’色 | 车务èœå•åªèƒ½ç”± `VEHICLE_MANAGER` 或 `SUPER_ADMIN` 访问；`wx/CUSTOMIZER` 访问 `/admin/fleet/**` 返回 `403`，æ示切æ¢è½¦åŠ¡è§’色。 | +| è½¦åŠ¡å·¥ä½œå° | `GET /admin/profile/dashboard?period=today` 在 `VEHICLE_MANAGER` 角色下由 user-service ä»£ç† fleet 真实看æ¿æ•°æ®ï¼›ä¸è¦å†è¯»æ—§è®¢å•ç»Ÿè®¡æˆ–本地 mock。 | | å¸æœºç»“ç®—æ–¹å¼ | å¸æœºæ–°å¢ž/编辑/导入使用字典 `driver_settlement_mode`：`direct`=直接结算，`captain`=车队长结算。 | | 待审核详情 ID | `GET /admin/fleet/drivers/pending/{pendingId}` å“应主键字段是 `id`，ä¸æ˜¯ `pendingId`；路径å˜é‡ä»å« `pendingId`。 | | æ´¾å•é‡å¤ç¡®è®¤ | `POST /admin/fleet/assignments/{assignmentId}/confirm` åªå…许 `holding -> assigned`ï¼›éž `holding` 返回 `605020`。 | @@ -41,6 +42,7 @@ | èœå• | å…³é”®æŽ¥å£ | |------|----------| +| è½¦åŠ¡å·¥ä½œå° | `/admin/profile/dashboard?period=today` | | æ´¾å•çœ‹æ¿ | `/admin/fleet/board/summary`, `/orders`, `/orders/{orderId}`, `/timeline`, `/expiry`, `/assignments/**` | | çŸ©é˜µæ´¾å• | `/admin/fleet/matrix/grid`, `/unassigned-orders`, `/day-orders` | | 车队对账 | `/admin/fleet/reconciliation/cars`, `/insurance`, `/periods`, `/actual`, `/close`, `/reopen`, `/pending-compensations/**`, `/export/cars` | @@ -94,6 +96,80 @@ Content-Type: application/json > 说明：下é¢ç¤ºä¾‹æ¥è‡ªæœ¬æ¬¡æµ‹è¯•æœçœŸå®ž API 回归结构，手机å·ã€tokenã€éƒ¨åˆ† ID åšäº†è„±æ•æˆ–å ä½ã€‚å‰ç«¯å¤„ç†é•¿æ•´åž‹ ID 时建议按字符串ä¿å­˜ï¼Œé¿å… JS 精度问题。 +### 4.4 分页与全é‡æŽ¥å£çº¦å®š + +- 公共分页对象 `page/pageSize` 的上é™ä»ä¸º `100`，车务模å—ä¸ç»•è¿‡å…¬å…±ä¸Šé™ã€‚ +- 页é¢åˆ—表ã€å¼¹çª—选择ã€è¿œç¨‹æœç´¢åˆ—表继续调用分页接å£ï¼Œå‰ç«¯åˆ†é¡µé€‰é¡¹ä¸è¦è¶…过 `100`。 +- 下拉ã€ç­›é€‰ã€æ ‘形选择等“需è¦å…¨é‡é€‰é¡¹â€çš„场景ä¸è¦ç”¨ `pageSize=200/1000` 拉分页接å£ï¼Œåº”改用对应的éžåˆ†é¡µè½»é‡ç«¯ç‚¹ã€‚ +- 当å‰å¯ç”¨éžåˆ†é¡µç«¯ç‚¹ï¼š + +```http +GET /admin/fleet/vehicle-types +GET /admin/fleet/vehicle-types/list +GET /admin/fleet/drivers/options?keyword=王&limit=20 +GET /admin/fleet/message-templates +GET /admin/fleet/reconciliation/periods?fromMonth=2026-01 +``` + +| 场景 | æ­£ç¡®æŽ¥å£ | ä¸è¦è¿™ä¹ˆè°ƒ | +|------|----------|------------| +| 车辆列表页/车辆档案分页 | `GET /admin/fleet/vehicles/page?page=1&pageSize=24` | ä¸è¦ `pageSize>100` | +| æ´¾å•å¼¹çª—选择车辆 | `GET /admin/fleet/vehicles/page?page=1&pageSize=10&vehicleStatus=idle` | ä¸è¦ç”¨ä¸€ä¸ªä¸‹æ‹‰ä¸€æ¬¡æ‹‰å…¨éƒ¨è½¦è¾† | +| 车型大类筛选下拉 | `GET /admin/fleet/vehicle-types/list` | ä¸è¦ `/vehicle-types/page?pageSize=1000` | +| 大类+åž‹å·æ ‘选择 | `GET /admin/fleet/vehicle-types` | ä¸è¦æŒ‰æ¯ä¸ªå¤§ç±»å†æ‰¹é‡æ‰« `/models/page` | +| å¸æœºè¿œç¨‹æœç´¢ä¸‹æ‹‰ | `GET /admin/fleet/drivers/options?keyword=王&limit=20` | ä¸è¦ `/drivers/page?pageSize=1000` | +| 车管模æ¿åˆ—表 | `GET /admin/fleet/message-templates` | 该接å£æœ¬èº«ä¸åˆ†é¡µï¼Œä¸è¦æ‹¼ page/pageSize | +| è½¦é˜Ÿå¯¹è´¦ä¸»æ•°æ® | `GET /admin/fleet/reconciliation/cars` / `insurance` | 主数æ®ä¸åˆ†é¡µï¼Œä¸è¦è‡ªå·±ä»Žè½¦è¾†/å¸æœºåˆ†é¡µæŽ¥å£æ‹¼ mock | + +如果åŽç»­å‰ç«¯å‡ºçŽ°æ–°çš„“确实需è¦å…¨é‡è½¦è¾†é€‰é¡¹â€çš„页é¢ï¼Œä¸è¦æ‰©å¤§ `/vehicles/page` 上é™ï¼›å…ˆæ需求补一个窄字段的车辆 options 接å£ï¼Œé™å®šå­—段和筛选æ¡ä»¶ã€‚ + +### 4.5 è½¦åŠ¡å·¥ä½œå° + +车务首页入å£ä»èµ°ç”¨æˆ·æœåŠ¡çš„角色分å‘接å£ï¼›å½“å‰ç™»å½•è§’色必须是 `VEHICLE_MANAGER`： + +```http +GET /admin/profile/dashboard?period=today +``` + +å“应： + +```json +{ + "code": 200, + "message": "æˆåŠŸ", + "success": true, + "data": { + "pendingArrangeVehicle": 3, + "upcomingTrips": [ + { + "orderId": "70123456789", + "assignmentId": "80123456789", + "orderNo": "HL202607010001", + "productName": "呼伦è´å°” 6 æ—¥", + "customerName": "张先生", + "departureDate": "2026-07-10", + "endDate": "2026-07-15", + "headcount": 4, + "status": "unassigned_urgent", + "statusLabel": "å¾…æ´¾", + "urgentBadge": "T-1" + } + ] + } +} +``` + +字段å£å¾„： + +| 字段 | 说明 | +|------|------| +| `pendingArrangeVehicle` | æ¥æº fleet æ´¾å•çœ‹æ¿ `pendingCount`，å³å½“å‰å¾…æ´¾å•æ•°ï¼Œå«ç´§æ€¥å¾…派。 | +| `upcomingTrips` | æ¥æº fleet æ´¾å•çœ‹æ¿åˆ—表，近 7 天游程，最多 5 æ¡ã€‚ | +| `status` | 车务派å•æ€ï¼š`unassigned`ã€`unassigned_urgent`ã€`holding`ã€`holding_urgent`ã€`assigned`。 | +| `orderId` / `assignmentId` | 长整型按字符串处ç†ï¼Œå‰ç«¯ä¸è¦è½¬ JS Number。 | + +è¿™ä¸æ˜¯åˆ†é¡µä¸è¶³é—®é¢˜ï¼›å·¥ä½œå°ä¸åº”从 `/admin/fleet/vehicles/page` 或旧 `DashboardStats` 拼数æ®ï¼Œä¹Ÿä¸åº”使用本地 `useFleetStore` mock。 + --- ## 5. 订å•å‰ç½®ï¼šæ–°å»ºè®¢å•ã€å‡ºè¡Œäººã€å¤§äº¤é€šã€ç”¨è½¦éœ€æ±‚ @@ -1405,6 +1481,8 @@ POST /admin/fleet/drivers/pending/{pendingId}/reject ## 13. 车队对账 +å‰ç«¯å½“å‰è‹¥ä»ç”¨æœ¬åœ° `useFleetStore` / mock 计算车队对账，需è¦åˆ‡åˆ°æœ¬èŠ‚接å£ï¼›åŽç«¯ä¸»æ•°æ®ä¸æ˜¯åˆ†é¡µæŽ¥å£ï¼Œè¿”回结构也ä¸æ˜¯æ—§çš„ `records/total`。 + ### 13.1 查询车费ã€ä¿é™©ã€å¯¹è´¦æœŸ ```http @@ -1419,24 +1497,152 @@ GET /admin/fleet/reconciliation/export/cars?periodStart=2026-07-01&periodEnd=202 ```json { "code": 200, + "message": "æˆåŠŸ", "success": true, "data": { - "records": [ + "periodLabel": "2026-07", + "periodStart": "2026-07-01", + "periodEnd": "2026-07-31", + "fleets": [ { "fleet": "own", "fleetName": "自有车队", - "assignmentCount": 1, - "estimated": "888.00", - "payableEstimated": "888.00", - "actualAmount": "123.45", - "diff": "-764.55" + "orderCount": 3, + "estimatedTotal": "27000.00", + "payableTotal": "27000.00", + "actualTotal": "26000.00", + "settleMode": "OWN_COST", + "diff": "-1000.00", + "closed": false, + "vehicles": [ + { + "vehicleId": "2064991856994758657", + "plate": "è’™A-88888", + "modelName": "丰田汉兰达", + "seats": 7, + "orderCount": 3, + "days": 18, + "avgPerDay": "1500.00", + "amount": "27000.00", + "payableAmount": "27000.00" + } + ] } ], - "total": 1 + "grandTotal": { + "estimated": "27000.00", + "payable": "27000.00", + "actual": "26000.00", + "diff": "-1000.00", + "totalDays": 18, + "totalOrderCount": 3 + } } } ``` +字段å£å¾„： + +| 字段 | 说明 | +|------|------| +| `fleets[].orderCount` | 车队内订å•æ•°ï¼ŒåŽç«¯å·²æŒ‰ `orderNo` åŽ»é‡ | +| `fleets[].estimatedTotal` | 对客报价åˆè®¡ï¼Œåˆ©æ¶¦åˆ†æžç”¨ | +| `fleets[].payableTotal` | 对车队应付åˆè®¡ï¼Œè½¦é˜Ÿæˆæœ¬åŸºå‡† | +| `fleets[].actualTotal` | 车务/财务手工录入实付，未录为 `null` | +| `fleets[].diff` | `actualTotal - payableTotal`，未录实付为 `null` | +| `fleets[].closed` | 整月关账状æ€ï¼›éžè‡ªç„¶æœˆæŸ¥è¯¢æ’为 `false` | +| `vehicles[].days` | 车天，æ¥è‡ª active prep 行数 | +| `vehicles[].avgPerDay` | `payableAmount / days` | +| `grandTotal.totalOrderCount` | 全车队订å•æ•°ï¼ŒåŽç«¯è·¨è½¦é˜Ÿå…¨å±€åŽ»é‡ï¼Œå‰ç«¯ä¸è¦ç”¨æ˜Žç»†æ±‚å’Œ | + +ä¿é™©å“应： + +```json +{ + "code": 200, + "message": "æˆåŠŸ", + "success": true, + "data": { + "periodLabel": "2026-07", + "grandTotal": "250.00", + "fleets": [ + { + "fleet": "own", + "sourceSubtotals": { + "manual": "120.00", + "baoyou": "130.00" + }, + "typeCounts": { + "annual": 1, + "perTrip": 1, + "none": 0 + }, + "drivers": [ + { + "driverId": "188800000000000001", + "name": "王师傅", + "phone": "138****1234", + "insuranceType": "annual", + "insuranceSource": "MANUAL", + "billingMethod": "å¹´ä¿é™©æŒ‰æ—¥æ‘Šé”€", + "annualPremium": "3650.00", + "perDayRate": null, + "totalPremium": null, + "orderCount": 2, + "days": 12, + "insuranceAmount": "120.00" + }, + { + "driverId": "188800000000000002", + "name": "æŽå¸ˆå‚…", + "phone": "139****5678", + "insuranceType": "", + "insuranceSource": "BAOYOU", + "billingMethod": "ä¿æ¸¸ç½‘实际出å•", + "annualPremium": null, + "perDayRate": null, + "totalPremium": "130.00", + "orderCount": 1, + "days": 3, + "insuranceAmount": "130.00" + } + ] + } + ] + } +} +``` + +ä¿é™©å­—段å£å¾„： + +| 字段 | 说明 | +|------|------| +| `insuranceSource` | åˆ†ç»„ä¸»é”®ï¼Œå– `MANUAL/BAOYOU/NONE`ï¼›ä¸è¦ç”¨ `insuranceType` 分组 | +| `insuranceType` | å¸æœºé…置类型，`annual/perTrip/none`ï¼›ä¿æ¸¸å®žé™…出å•è¡Œå¯èƒ½ä¸ºç©ºå­—符串 | +| `sourceSubtotals.manual` | 手填年ä¿è´¹/行程险摊销å°è®¡ | +| `sourceSubtotals.baoyou` | ä¿æ¸¸å®žé™…出å•æ‘Šé”€å°è®¡ | +| `typeCounts` | 车队内å¸æœºä¿é™©ç±»åž‹è®¡æ•° | +| `grandTotal` | 全车队ä¿é™©æˆæœ¬åˆè®¡ï¼Œä¸å« `NONE` | + +对账期å“应： + +```json +{ + "code": 200, + "message": "æˆåŠŸ", + "success": true, + "data": [ + { + "label": "2026-07", + "periodStart": "2026-07-01", + "periodEnd": "2026-07-31", + "closed": false, + "reopened": false + } + ] +} +``` + ### 13.2 录入实付ã€å…³è´¦ã€é‡å¼€ã€è¡¥å¿ ```http @@ -1454,7 +1660,7 @@ POST /admin/fleet/reconciliation/pending-compensations/{id}/resolve "periodStart": "2026-07-01", "periodEnd": "2026-07-31", "fleet": "own", - "actualAmount": 123.45, + "actualAmount": "26000.00", "note": "èœå•éªŒæ”¶å½•å…¥" } ``` @@ -1464,13 +1670,70 @@ POST /admin/fleet/reconciliation/pending-compensations/{id}/resolve ```json { "code": 200, + "message": "æˆåŠŸ", "success": true, "data": { - "id": "2026-07-own", - "estimated": "888.00", - "payableEstimated": "888.00", - "actualAmount": "123.45", - "diff": "-764.55" + "id": "2073749573041356801", + "diff": "-1000.00", + "payableEstimated": "27000.00", + "estimated": "27000.00" + } +} +``` + +清空实付：`actualAmount` ä¼  `null` 或çœç•¥ï¼ŒåŽç«¯è½¯åˆ è¯¥ `(periodStart, fleet)` 实付行，å“应中 `diff` è¿” `null`。 + +è¡¥å¿åˆ—表å“应： + +```json +{ + "code": 200, + "message": "æˆåŠŸ", + "success": true, + "data": { + "page": 1, + "pageSize": 5, + "total": 1, + "records": [ + { + "compId": "2073749573041356802", + "assignmentId": "2073749573041356803", + "orderId": "2073749536638992386", + "periodLabel": "2026-07", + "opType": "TRUNCATE", + "serviceDateFrom": "2026-07-20", + "reason": "æå‰å®Œç»“截断触åŠå·²å…³è´¦æœŸ 2026-07", + "status": "PENDING", + "createTime": "2026-07-06T10:00:00", + "resolvedAt": null, + "resolvedBy": null, + "resolveRemark": null + } + ] + } +} +``` + +处置补å¿è¯·æ±‚： + +```json +{ + "remark": "已线下补对账，差é¢è®¡å…¥ 2026-08 调整" +} +``` + +处置补å¿å“应： + +```json +{ + "code": 200, + "message": "æˆåŠŸ", + "success": true, + "data": { + "compId": "2073749573041356802", + "status": "RESOLVED", + "resolvedAt": "2026-07-06T10:30:00", + "resolvedBy": "1001" } } ``` @@ -1509,6 +1772,8 @@ POST /admin/fleet/reconciliation/pending-compensations/{id}/resolve ## 14. è½¦ç®¡æ¨¡æ¿ +模æ¿åˆ—表是éžåˆ†é¡µæŽ¥å£ï¼›å‰ç«¯é¡µé¢ä¸è¦ä¼  `page/pageSize`。测试æœå¦‚果返回空数组，表示当å‰åº“没有é…置模æ¿ï¼Œä¸æ˜¯åˆ†é¡µé—®é¢˜ã€‚ + ```http GET /admin/fleet/message-templates GET /admin/fleet/message-templates?templateType=hold_notify @@ -1552,9 +1817,9 @@ DELETE /admin/fleet/message-templates/{templateId} ```json { - "orderNo": "HL20260705204312543", - "driverName": "API师傅", - "vehiclePlate": "è’™A-69665" + "orderId": "2073749536638992386", + "driverId": "2073749573041356803", + "vehicleId": "2073749573041356804" } ``` @@ -1565,12 +1830,14 @@ DELETE /admin/fleet/message-templates/{templateId} "code": 200, "success": true, "data": { - "renderedBody": "您好 APIå¸ˆå‚…ï¼Œè®¢å• HL20260705204312543 已派车，车牌 è’™A-69665", + "renderedBody": "您好 APIå¸ˆå‚…ï¼Œè®¢å• å·²æ´¾è½¦ï¼Œè½¦ç‰Œ è’™A-69665", "variablesUsed": ["driver.name", "order.no", "vehicle.plate"] } } ``` +è¯´æ˜Žï¼šå½“å‰ `driver.*`ã€`vehicle.*` å¯æŒ‰ ID 渲染；`order.*` / `itinerary.*` 本期ä»èµ°å ä½ç«¯å£ï¼Œç¼ºå€¼ä¼šæ›¿æ¢ä¸ºç©ºä¸²ï¼Œä¸æŠ¥é”™ã€‚å‰ç«¯ä¸è¦ä¼  `orderNo/driverName/vehiclePlate`，这些ä¸æ˜¯è¯¥æŽ¥å£å…¥å‚字段。 + å˜é‡ç¼ºå¤±ï¼š ```json diff --git a/changelogs-v2/2026-07/26_4760_车务å¸æœºé™©è‡ªåŠ¨æŠ•é€€ä¿é—­çŽ¯ä¸Žä¿é™©èœå•å¥‘约-管ç†åŽå°.md b/changelogs-v2/2026-07/26_4760_车务å¸æœºé™©è‡ªåŠ¨æŠ•é€€ä¿é—­çŽ¯ä¸Žä¿é™©èœå•å¥‘约-管ç†åŽå°.md index a100400..4375193 100644 --- a/changelogs-v2/2026-07/26_4760_车务å¸æœºé™©è‡ªåŠ¨æŠ•é€€ä¿é—­çŽ¯ä¸Žä¿é™©èœå•å¥‘约-管ç†åŽå°.md +++ b/changelogs-v2/2026-07/26_4760_车务å¸æœºé™©è‡ªåŠ¨æŠ•é€€ä¿é—­çŽ¯ä¸Žä¿é™©èœå•å¥‘约-管ç†åŽå°.md @@ -11,6 +11,7 @@ - 车务ä¿é™©èœå•åªå±•ç¤ºå¸æœºé™©ä»»åŠ¡ï¼Œä¸å±•ç¤ºæ¸¸å®¢ä¿é™©ã€è®¢å•ä¿é™©ã€å®¢æˆ·é€€æ¬¾ä¿é™©æ˜Žç»†ã€‚ - `insurance.type=perTrip` çš„å¸æœºåœ¨æ´¾å•ç¡®è®¤è¿›å…¥ `assigned` åŽï¼ŒåŽç«¯æŒ‰ `driverId + serviceDate` 自动一日一ä¿æŠ•ä¿ã€‚ +- `insurance.type=annual` çš„å¸æœºä¸ä¼šè‡ªåŠ¨æŒ‰å•ä¹°é™©ï¼Œä½†æ´¾å•ç¡®è®¤æ—¶åŽç«¯ä¼šé€æœåŠ¡æ—¥æ ¡éªŒå¹´ä¿è¦†ç›–；年ä¿åˆ°æœŸæˆ–覆盖ä¸è¶³ä¼šç”Ÿæˆè½¦åŠ¡ä¿é™©å¾…办。 - åŒä¸€å¸æœºåŒä¸€æœåŠ¡æ—¥åªèƒ½æœ‰ä¸€ä»½å¸æœºé™©ï¼›å‰åŽè®¢å•ç›¸æŽ¥åŒæ—¥ä¸é‡å¤ä¹°ã€‚ - å–消/æå‰å®Œç»“åŽï¼Œåªé€€è¯¥å¸æœºè¯¥æœåŠ¡æ—¥å·²æ— å…¶å®ƒ active æ´¾å•å ç”¨çš„å•æ—¥é™©ã€‚ - å¸æœºé™©åªè¿›å…¥è½¦é˜Ÿ/å¸æœºæˆæœ¬ï¼Œä¸è¿›å…¥å®¢æˆ·é€€æ¬¾ã€è®¢å•æ”¶æ¬¾ã€æ¸¸å®¢ä¿é™©æˆ–åˆåŒä¿é™©ã€‚ @@ -275,6 +276,9 @@ POST /admin/fleet/insurance/tasks/{taskId}/ignore | 场景 | åŽç«¯è¡Œä¸º | å‰ç«¯å…³æ³¨ | |------|----------|----------| | æ´¾å•ç¡®è®¤ `holding -> assigned` | perTrip å¸æœºæŒ‰æœåŠ¡æ—¥é€æ—¥æŠ•ä¿ | 确认派å•æˆåŠŸä¸ä»£è¡¨ä¿é™©ä¸€å®šæˆåŠŸï¼Œéœ€çœ‹ä¿é™©ä»»åŠ¡ | +| æ´¾å•ç¡®è®¤æ—¶å¸æœºé…置年ä¿ä¸”æœåŠ¡æ—¥å…¨éƒ¨è¢« `annualStart~annualEnd` 覆盖 | ä¸ä¹°æŒ‰å•é™©ï¼Œä¸ç”Ÿæˆå¾…办 | ä¿é™©æˆæœ¬æŒ‰å¹´ä¿æ‘Šé”€è¿›è½¦é˜Ÿæˆæœ¬ | +| æ´¾å•ç¡®è®¤æ—¶å¸æœºé…置年ä¿ä½†éƒ¨åˆ†æœåŠ¡æ—¥ä¸è¢«è¦†ç›– | 对未覆盖æœåŠ¡æ—¥ç”Ÿæˆ `PENDING` 投ä¿å¾…åŠžï¼Œé”™è¯¯ç  `540033` | æ示车务续ä¿/修正年ä¿èµ·æ­¢ï¼Œæˆ–改按行程险åŽé‡è¯• | +| å¸æœºå¹´ä¿ä¸ºæ‰‹å·¥/线下æ¥æºä¸”与线上ä¿å•ä¸ä¸€è‡´ | ç”Ÿæˆ `PENDING` æ ¸å¯¹å¾…åŠžï¼Œé”™è¯¯ç  `540034` | æ示上传线下凭è¯æˆ–修正ä¿å•ä¿¡æ¯ | | 已有线上ä¿å•è¦†ç›–åŒå¸æœºåŒæ—¥ | ä¸é‡å¤è´­ä¹°ï¼Œå†™ `SUCCESS` 幂等æµæ°´ | ä¸è¦æ示é‡å¤æŠ•ä¿ | | 已有手工/å¹´ä¿è¦†ç›–åŒå¸æœºåŒæ—¥ | ä¸ä¹°æŒ‰å•é™©ï¼Œå†™ `PENDING` æ醒核对 | 展示 `suggestedAction` | | æ´¾å•å–消 | åªé€€è¯¥å¸æœºè¯¥æœåŠ¡æ—¥æ— å…¶å®ƒ active æ´¾å•å ç”¨çš„å•æ—¥é™© | åŒæ—¥ä»æœ‰å…¶å®ƒè®¢å•æ—¶ä¸ä¼šé€€ | @@ -291,6 +295,7 @@ POST /admin/fleet/insurance/tasks/{taskId}/ignore - ä¸è¦åœ¨å‰ç«¯æ‹¼é‡è¯•ä¸šåŠ¡å‚数，é‡è¯•åªä¼  `taskId`。 - ä¸è¦åœ¨è½¦åŠ¡ä¿é™©èœå•å±•ç¤ºè®¢å•æ¸¸å®¢é™©ã€‚ - ä¸è¦æŠŠ `SUCCESS` 自动æµæ°´å½“æˆå¾…办æ示；待办åªçœ‹ `PENDING/PROCESSING`。 +- ä¸è¦åªçœ‹å¸æœºä¿é™©ç±»åž‹æ˜¯ `annual` 就认为无需处ç†ï¼›å¿…须以åŽç«¯ä»»åŠ¡çŠ¶æ€ä¸ºå‡†ã€‚å¹´ä¿åˆ°æœŸã€è¡Œç¨‹å¢žåŠ ä¸€å¤©ã€æ¢å¸æœºåŽéƒ½ä¼šé‡æ–°æŒ‰æœåŠ¡æ—¥æ ¡éªŒã€‚ --- @@ -302,6 +307,8 @@ POST /admin/fleet/insurance/tasks/{taskId}/ignore | `100502` | 幂等ä¿æŠ¤ï¼Œé‡å¤æ交 | “正在处ç†ï¼Œè¯·å‹¿é‡å¤æ交†| | `540007` | ä¿é™©è®¡åˆ’缺费率 | “请维护ä¿é™©è®¡åˆ’费率åŽé‡è¯•â€ | | `540032` | åŒå¸æœºæœåŠ¡æ—¥å·²æœ‰ä¿å•è¦†ç›– | “已有ä¿å•è¦†ç›–，请核对åŽå¤„ç†â€ | +| `540033` | å¸æœºé…置年ä¿ä½†æœåŠ¡æ—¥ä¸åœ¨å¹´ä¿èµ·æ­¢å†… | “å¸æœºå¹´ä¿æœªè¦†ç›–当å‰æœåŠ¡æ—¥ï¼Œè¯·ç»­ä¿/修正年ä¿åŽé‡è¯•ï¼Œæˆ–改按行程险处ç†â€ | +| `540034` | 手工年ä¿/线下ä¿å•ä¸Žçº¿ä¸Šè¦†ç›–ä¿¡æ¯ä¸ä¸€è‡´ | “请核对线下ä¿å•å¹¶ä¸Šä¼ å‡­è¯ï¼Œç¡®è®¤åŽæ ‡è®°çº¿ä¸‹å®Œæˆâ€ | | `605601` | ä¿é™©æœåŠ¡ä¸å¯ç”¨ | “ä¿é™©æœåŠ¡æš‚ä¸å¯ç”¨ï¼Œè¯·ç¨åŽé‡è¯•æˆ–线下处ç†â€ | --- @@ -313,6 +320,8 @@ POST /admin/fleet/insurance/tasks/{taskId}/ignore - æ–°å»ºè®¢å• -> 补出行人 -> 补大交通 -> æ用车需求 -> 车务派å•ç¡®è®¤ -> ä¿é™©ä»»åŠ¡ç”Ÿæˆã€‚ - åŒä¸€å¸æœºåŒä¸€æœåŠ¡æ—¥å¤šè®¢å•ï¼Œä¸é‡å¤ä¹°ä¿é™©ã€‚ - å–消派å•æ—¶ï¼ŒåŒå¸æœºåŒæ—¥è¿˜æœ‰å…¶å®ƒ active æ´¾å•åˆ™ä¸é€€ä¿ã€‚ +- å¹´ä¿å¸æœºåœ¨æœåŠ¡æœŸå†…ä¸ä¹°æŒ‰å•é™©ï¼›æœåŠ¡æ—¥è¶…过年ä¿åˆ°æœŸæ—¥æ—¶ç”Ÿæˆ `540033` 待办。 +- å¹´ä¿ç»­ä¿åŽé‡è¯• `540033` 任务，应å˜ä¸º `SUCCESS`，且ä¸èƒ½äº§ç”Ÿé‡å¤æŒ‰å•é™©ã€‚ - 投ä¿å¤±è´¥åŽé‡è¯•æˆåŠŸã€‚ - 线下完æˆå¿…须上传凭è¯ã€‚ - 定制师角色ä¸å¯è§è½¦åŠ¡ä¿é™©èœå•ã€‚