2.2 KiB
2.2 KiB
海外通用资料真实接口边界
三域统一使用共享 http 客户端和浏览器业务路径 /platform/v1/last-leg/master-data，经当前统一 Gateway 对应到服务端 /api/platform/v1/last-leg/master-data。长 ID 始终按字符串处理，分页使用 records/page/size/total/pages，更新与状态操作提交 recordVersion。
- 报价：已接分页、详情、创建、编辑、启停、CSV 导出和
/overseas-quotes/warehouse-options。浏览器不调用国内/internal/warehouses/overseas-partners。 - 汇率：已接摘要、分页、详情、创建、覆盖编辑、状态和 CSV 导出。
- 车辆：已接分页、独立详情、创建、编辑、状态和 CSV 导出。
当前明确边界：
- 报价和车辆 Controller/OpenAPI 没有删除端点，前端不展示删除操作。
- 车辆详情已接保养、加油、维修、故障、救援和异常记录，合同见
fleet-vehicle-records-v1.yaml；派送履约及跨车次更换历史尚未接入，页面提示从现有排车/派送管理查看派送记录，不拼装其他订单数据。 - 权限资源由总控统一写入 IAM/SQL；本模块只使用 canonical
platform:overseas-master-data:{quote|exchange-rate|vehicle}:{list|create|edit|status|export}。 - 报价创建请求包含
warehouseId、versionCode，编辑请求不提交这两个服务端不可编辑字段；所有编辑与状态请求提交当前recordVersion。 - 金额、汇率、里程和版本字段在 API 适配层统一转成
number，报价与车辆长 ID 保持字符串透传。 - CSV 下载只接受真实 Blob；JSON 错误 Blob 转为带
requestId/traceId的业务错误，不保存为文件。
2026-10-17：仓储转运上门取货使用 fleet-transfer-pickup-v1.yaml 新接口，需部署Lastleg及 baiyue_lastleg 结构增量后生效。本轮只操作本机，不据本机验收推定远端已部署；人工页面视觉待验收。
2026-10-17 资源占用辅助查询：GET /fleet/trips/{tripNo}/resource-occupancy，按VEHICLE/DRIVER和本次最多100个ID批量读取；本车资源可保留、其他车次禁选。沿trip:list平台授权；只读、不预留，分配写入口再次锁定复验。前后端需一起更新，无新增数据库结构。