（高清正版）DB32_T3826-2020公务用车信息化平台数据交换技术应用规范.pdf

ICS 35.240.99L 76DB32江苏省地方标准DB 32/T 3826-2020公务用车信息化平台数据交换技术规范Data interchange specification in official vehicle information platform2020-07-14 发布2020-08-14 实施江苏省市场监督管理局发 布DB32/T 3826-2020I目次前言.III1范围.12规范性引用文件.13术语和定义.14缩略语.25数据交换信息内容.25.1基础数据.25.2定位数据.26数据交换形式与要求.26.1接口要求.26.2数据传输加密.36.3基础数据交换.36.4定位数据交换.37基础信息交换接口说明.47.1状态码定义.47.2登录接口.47.3单位基本信息接口.67.4单车基本信息接口.77.5超标准配备车辆信息接口.97.6驾驶员基本信息接口.107.7派车信息接口.117.8车辆维保信息接口.137.9车辆年检信息接口.147.10车辆能耗信息接口.147.11车辆保险费用信息接口.157.12车辆过路过桥费用信息接口.167.13车辆停车费用信息接口.177.14车辆其他费用信息接口.187.15监督检查情况信息接口.197.1612345 投诉信息接口.207.17社会车辆租赁派车信息接口.217.18车辆违章情况信息接口.227.19车辆处置情况信息接口.23附录 A（规范性附录）接口反馈内容.25DB32/T 3826-2020II附录 B（规范性附录）数据字典规范.26DB32/T 3826-2020III前言本标准按照GB/T 1.1-2009给出的规则编写。本标准由江苏省机关事务管理局提出并归口。本标准起草单位：江苏省机关事务管理局、中电鸿信信息科技有限公司。本标准主要起草人：徐华明、左晓刚、李角榆、白金龙、罗星、伍薇、陶思蓉、顾新贤、李声祥、左军、司奉彦。DB32/T 3826-20201公务用车信息化平台数据交换技术规范1范围本标准规定了公务用车信息化平台数据交换的术语和定义、缩略语、数据交换内容、交换形式和要求以及基础信息交换接口说明。本标准适用于公务用车信息化平台数据交换。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 2260中华人民共和国行政区划代码JT/T 808-2013道路运输车辆卫星定位系统 北斗兼容车载终端通讯协议技术规范3术语和定义下列术语和定义适用于本文件。3.1数据交换 data interchange在不同系统和设备间进行的数据传输与处理的过程。3.2电子数据交换 electronic data interchange(EDI)采用标准格式，利用计算机网络进行业务数据的传输与处理。GB/T 18354-2006，定义5.223.3上级平台superior platform接收数据平台。3.4下级平台inferior platform发送数据平台。3.5车牌号 number plate公安交通管理部门颁发的机动车车牌管理号码，不包括车辆牌照的颜色。例：苏AJ3030。DB32/T 3826-202024缩略语下列缩略语适用于本文件。JSONJS对象标记（Java Script Object Notation）UTF-8针对Unicode的可变长度字符编码（8-bit Unicode Transformation Format）；HTTP超文本传输协议(HyperText Transfer Protocol)POST是HTTP协议中的一个重要组成部分。POST方法一般用来向目的服务器发出更新请求，并附有请求实体向指定的资源提交要被处理的数据（Power On Self Test）UDP用户数据报协议(User Datagram Protocol)5数据交换信息内容5.1基础数据5.1.1下级平台交换的基础数据内容应包括：单位基本信息；单车基本信息；超标准配备车辆信息；驾驶员基本信息；派车信息；车辆维保信息；车辆年检信息；车辆能耗信息；车辆保险费用信息；车辆过路过桥费用信息；车辆停车费用信息；车辆其他费用信息；监督检查情况信息；12345 投诉信息；社会车辆租赁派车信息；车辆违章情况信息车辆处置情况信息5.1.2各类基础数据的详细字段要求见第 7 章。5.2定位数据交换的车辆定位数据内容应包含报警标志、状态、经度、纬度、高程、速度、方向、定位时间、里程等信息，详细交换内容应满足JT/T 808-2013中8.18节的要求。6数据交换形式与要求6.1接口要求6.1.1下级平台基础数据发生变化、定位终端上报定位数据时，均应实时传输到数据交换平台。DB32/T 3826-202036.1.2在调用基础信息交换接口推送数据时，若接口返回错误，则需要根据返回的状态码/描述重新调用接口实现数据重发。6.1.3在调用基础信息交换接口推送数据时，若等待 10 秒接口无响应，需要重新调用接口重传该条数据。6.1.4若数据交换过程中出现网络/接口中断情况，需要在网络/接口恢复正常后补传中断时间内所有基础数据及定位数据。6.2数据传输加密6.2.1公务用车终端应采用支持 SM3 算法的国密级芯片对用车数据进行加密后上传至各级公务用车平台，平台接收数据后进行解密存储。6.2.2公务用车基础数据及定位数据进行平台间数据传输时，下级平台应对公务用车数据使用国密SM3 算法进行数据加密后上传至上级平台，上级平台接收数据后进行解密存储。6.3基础数据交换6.3.1数据交换方式应采用 web service 接口作为数据传输机制。调用接口数据之前，应将数据转换成规定的数据类型和格式，数据类型和格式见第 7 章，传入数据由 json 格式组成。6.3.2所有请求数据格式应采用 UTF-8 格式。6.3.3应采用 HTTP 协议，POST 请求。6.3.4返回的数据根据具体接口定义 JSON 数据信息，反馈形式见附录 A。6.4定位数据交换6.4.1通讯机制采用 UDP 方式，下级平台通过 UDP 方式将定位数据发送至上级平台，平台的通讯连接及重发机制应遵循 JT/T 808-2013 中第 5 章及第 6 章的协议规定。6.4.2定位数据传输协议符合 JT/T 808-2013 中的注册、鉴权、位置信息汇报、终端通用应答、平台通用应答协议部分的要求，数据格式见表 1，主要包括如下内容：a)终端注册：下级平台往上级平台发送车辆定位数据前，下级平台的车载定位终端在未注册状态下，应首先进行注册，注册成功后下级平台将获得上级平台的鉴权码并进行保存；b)终端鉴权：下级平台收到上级平台反馈的注册成功信息后，应立即进行鉴权。鉴权成功前下级平台不得上报车载定位终端的其它消息。上级平台收到终端鉴权信息后回复下级平台通用应答消息；c)位置信息汇报：下级平台应向上级平台实时发送位置信息汇报消息；d)终端通用应答；e)平台通用应答。表 1定位数据交换数据格式表序号定位数据数据格式要求1终端注册符合JT/T 808-2013中表7的要求2终端鉴权符合JT/T 808-2013中表9的要求3位置信息汇报符合JT/T 808-2013中表23的要求4终端通用应答消息体符合JT/T 808-2013中表4的要求5平台通用应答消息体符合JT/T 808-2013中表5的要求DB32/T 3826-202047基础信息交换接口说明7.1状态码定义接口状态码定义对照表如表2所示。表 2接口状态码定义对照表序号应答/错误代码应答/错误描述1100成功2102失败3103推送的JSON格式错误4104数据验证错误5105异常错误6106所属部门不存在7107车辆类型不存在8108车牌号不存在9109驾驶员不存在10110租赁公司不存在11111区域编码不存在12112用户名或者密码不对7.2登录接口7.2.1接口描述登录接口描述见表3。表 3登录接口描述表接口名称登录接口（api/login）通信承载协议HTTP POST提供者上级平台主要使用者下级平台7.2.2接口传入参数说明登录接口传入参数说明见表4。表 4登录接口传入参数说明表参数名称参数含义数据类型长度备注userName用户名称StringV50必填，省平台统一编码,统一为行政区域编码，按照GB/T 2260相关要求执行，如南京市级平台：320100userPass用户密码StringV50必填，省平台统一编码7.2.3接口传入参数格式DB32/T 3826-20205第7章各类接口传入参数格式如下所示，各个参数名称和排列顺序应与传入参数说明表中参数名称和排列顺序保持一致，接口传入参数格式如下所示（第7章各类接口传入参数格式按照以下格式编写）：Info:参数名称 1:数值,参数名称 2:数值,参数名称 3:数值,参数名称 n:数值示例：Info:userName:320100,/320100：用户名称userPass:123456/123456：用户密码7.2.4接口返回参数说明登录接口返回参数说明见表5。表 5登录接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码token返回令牌StringV50访问后续接口的令牌，请求后续接口需要放到请求头里message返回信息StringV50具体描述7.2.5接口返回参数格式各个参数名称和排列顺序应与返回参数说明表中参数名称和排列顺序保持一致，接口返回参数格式如下所示（第8章各类接口返回参数格式按照以下格式编写）：参数名称 1:数值,参数名称 2:数值,参数名称 3:数值,参数名称 n:数值示例：result:success,resultCode:100,DB32/T 3826-20206token:eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJmaGdqIiwiYXV0aCI6InVzZXJJZC1mY2YzZWIxOC1iYzQ1LTQ4NGQtOGE5ZS1jZjkxZjM1OGJlMzciLCJ1c2VyRGF0YSI6eyJjb21wYW55SWQiOiJhZWIyZjllMi1jYmExLTQ3NTMtYmNjNy1mOTFjYTEyOGFkZWIiLCJ1c2VySWQiOiIxMDM5NjNiMi03ZmRmLTRiZGMtYTllNS04YzQzNmViMjM3YzgifX0.bXNFb8RcYD_oLG3Yl9bbnWQ3h2304JqIXurDAJG8jDvDKx3STIeA5NjaOLY9ZA1XW6PnwTBrYq9WZcZRvQwN5A,message:登录成功7.3单位基本信息接口7.3.1接口描述单位基本信息接口描述如表6所示。表 6单位基本信息接口描述表接口名称单位基本信息接口（api/editGroup）通信承载协议HTTP POST提供者上级平台主要使用者下级平台7.3.2接口传入参数说明单位基本信息接口传入参数说明如表7所示。表 7单位基本信息接口传入参数说明表参数名称参数含义数据类型长度备注regionCode区域编码StringV50必填，如：南京：320100groupName单位名称StringV50必填，单位名称全称superGroup上级直属单位名称StringV50必填，无上级直属单位的情况，为 NULLsocialCreditCode统一社会信用代码StringV50必填，18 位阿拉伯数字/英文；如果没有，填无structureNature机构性质Number-必填，详情见附录 B.1structureLevel机构级别Number-必填，详情见附录 B.2groupAddress单位地址StringV100必填groupOrganizationNumber单位编制人数Number-必填，大于等于 0groupFactNumber单位编内实有人数Number-必填，大于等于 0groupOtherNumber单位编外实有人数Number-必填，大于等于 0organizationCarNumber编制车辆数(辆)Number-必填，大于等于 0，经公务用车主管部门核定的编制车辆数；事业单位为保留车辆数；车辆产权不在本单位的，填 0.factCarNumber实有车辆数(辆)Number-必填，大于等于 0purchaseEquipmentCarNumber全年购置车辆数(辆)Number-必填，大于等于 0updateEquipmentCarNumber全年更新车辆数(辆)Number-必填，大于等于 0DB32/T 3826-20207表 7单位基本信息接口传入参数说明表（续）参数名称参数含义数据类型长度备注adjustEquipmentCarNumber全年调剂车辆数(辆)Number-必填，大于等于 0，该字段表示其他单位调剂到本单位的车辆superiorEquipmentCarNumber全年上级下拨车辆数(辆)Number-必填，大于等于 0acceptanceEquipmentCarNumber全年接受捐赠车辆数(辆)Number-必填，大于等于 0otherEquipmentCarNumber全年其他方式配置车辆数(辆)Number-必填，大于等于 0auctionManageCarNumber全年拍卖车辆数(辆)Number-必填，大于等于 0scrapManageCarNumber全年报废车辆数(辆)Number-必填，大于等于 0recoveryManageCarNumber全年厂家回收车辆数(辆)Number-必填，大于等于 0adjustManageCarNumber全年调剂处置车辆数（辆）Number-必填，大于等于 0，该字段表示通过调剂处理的车辆数量otherManageCarNumber全年其他方式处置车辆数(辆)Number-必填，大于等于 0responsiblePersonName车管负责人姓名StringV50必填responsiblePersonPhone车管负责人联系方式StringV50必填dispatchPersonName车辆调度员姓名StringV50必填dispatchPersonPhone车辆调度员联系方式StringV50必填chargingPilesNumber充电桩数Number-必填，大于等于 07.3.3接口返回参数说明单位基本信息接口返回参数说明如表8所示。表 8单位基本信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述7.4单车基本信息接口7.4.1接口描述单车基本信息接口描述如表9所示。表 9单车基本信息接口描述表接口名称单车基本信息接口（api/editCar）通信承载协议HTTP POST提供者上级平台主要使用者下级平台7.4.2接口传入参数说明单车基本信息传入参数说明如表10所示。DB32/T 3826-20208表 10单车基本信息接口传入参数说明表参数名称参数含义数据类型长度备注regionCode区域编码StringV50必填，如：南京：320100carNo车牌号码StringV50必填，第一个字必须是汉字，字母自动大写carNoColor车牌颜色Number-必填，详情见附录 B.3groupName所属单位名称StringV50必填superGroup上级直属单位名称StringV50必填carColor车辆颜色StringV50必填Brand品牌型号StringV50必填，如别克 君威等vehicleType车辆类型Number-必填，详情见附录 B.4Category使用性质Number-必填，详情见附录 B.5Vin车辆识别代号（车架号）StringV50必填，仅限阿拉伯数字和英文字母，字母自动大写engineNum发动机号码StringV50必填，字母数字组合powerType动力类型Number-必填，详情见附录 B.6discharge排气量Number-必填，小型、中型燃油车必填，从 1.0 到 5.0；新能源车填 0loadingNumber核载人数Number-必填，阿拉伯数字，单位：人，大于 0purchasePrice购置价格（万元）Number-必填，精确到小数点后两位，大于 0.00obtainDate注册日期Date-必 填,车 辆 购 置 日 期，yyyy-MM-ddHH:mm:ss，例如:2019-10-29 12:30:00obtainType取得方式Number-必填，详情见附录 B.7etcCardETC 卡号StringV50必填；如果没有 ETC 卡号，填无oilCard加油卡号StringV100必填，有多张加油卡每张之间用逗号分隔；如果没有加油卡号，填无identification车辆标识Number-必填，详情见附录 B.8depreciationType折旧方式StringV50必填，暂定为平均年限法折旧方法，折旧年限为 8 年计算depreciationPeriod折旧年限Number-必填,从购车到现在的年数，大于 0paperPrice账面价格（万元）Number-必填，精确到小数点后两位，折旧后的价格大于 0.00，折旧年限大于 8 年填 0.00timerNumber行驶里程（公里）Number-必填，阿拉伯数字，大于 0，实时码表里程，每年年底terminalkeyid车载终端 IDStringV20必填，对应定位终端手机号码7.4.3接口返回参数说明单车基本信息接口返回参数说明如表11所示。DB32/T 3826-20209表 11单车基本信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述7.5超标准配备车辆信息接口7.5.1接口描述超标准配备车辆信息接口描述如表12所示。表 12超标准配备车辆信息接口描述表接口名称超标准配备车辆信息接口（api/editStandardCar）通信承载协议HTTP POST提供者上级平台主要使用者下级平台7.5.2接口传入参数说明超标准配备车辆信息接口传入参数说明如表13所示。表 13超标准配备车辆信息接口传入参数说明表参数名称参数含义数据类型长度备注regionCode区域编码StringV50必填，如：南京：320100carNo车牌号码StringV50必填，参考车辆信息填写carNoColor车牌颜色Number-必填，详情见附录 B.3groupName所属单位名称StringV50必填superGroup上级直属单位名称StringV50必填groupLevel机构级别Number-必填，详情见附录 B.2brand品牌型号StringV50必填，如别克 君威等vehicleType车辆类型Number-必填，详情见附录 B.4category使用性质Number-必填，详情见附录 B.5carOriginPlace车辆产地Number-必填，详情见附录 B.10discharge排气量Number-小型、中型燃油车必填，从 1.0到 5.0；新能源车填 0purchasePrice购置价格（万元）Number-必填，精确到小数点后两位，大于 0.00timerNumber行驶里程（公里）Number-必填，阿拉伯数字，大于 0，实时码表里程approvalGroup批准单位StringV50必填vin车辆识别代号（车架号）StringV50必填，仅限阿拉伯数字和英文字母，字母自动大写DB32/T 3826-202010表 13超标准配备车辆信息接口传入参数说明表（续）参数名称参数含义数据类型长度备注obtainDate注册日期Date-必 填,车 辆 购 置 日 期，yyyy-MM-ddHH:mm:ss，例如:2019-10-29 12:30:00obtainType取得方式Number-必填，详情见附录 B.77.5.3接口返回参数说明超标准配备车辆信息接口返回参数说明如表14所示。表 14超标准配备车辆信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述7.6驾驶员基本信息接口7.6.1接口描述驾驶员基本信息接口描述如表15所示。表 15驾驶员基本信息接口描述表接口名称驾驶员基本信息接口（api/editDriver）通信承载协议HTTP POST提供者上级平台主要使用者下级平台7.6.2接口传入参数说明驾驶员基本信息接口传入参数说明如表16所示。表 16驾驶员基本信息接口传入参数说明表参数名称参数含义数据类型长度备注regionCode区域编码StringV50必填，如：南京：320100driverName驾驶员姓名StringV50必填Sex性别Number-必填，1：男，2：女groupName所属单位名称StringV50必填superGroup上级直属单位名称StringV50必填idCard驾驶证号StringV50必填（18 位字母数字组合）drivingType准驾车型Number-必填，详情见附录 B.11fristIssueDate初次领证日期Date-必 填,yyyy-MM-ddHH:mm:ss(例如:2019-10-29 12:30:00)DB32/T 3826-202011表 16 驾驶员基本信息接口传入参数说明表（续）参数名称参数含义数据类型长度备注changeIssueDate换证日期Date必 填:yyyy-MM-ddHH:mm:ss(例如:2019-10-29 12:30:00)，未换证填写除此领证日期employmentNature用工性质Number-必填，详情见附录 B.12iffulltime是否专职Number-0：非专职，1：专职phoneNum联系方式StringV50必填7.6.3接口返回参数说明驾驶员基本信息接口返回参数说明如表17所示。表 17驾驶员基本信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述7.7派车信息接口7.7.1接口描述派车信息接口描述如表18所示。表 18派车信息接口描述表接口名称派车信息接口（api/editCarSend）通信承载协议HTTP POST提供者上级平台主要使用者下级平台7.7.2接口传入参数说明派车信息接口传入参数说明如表19所示。表 19派车信息接口传入参数说明表参数名称参数含义数据类型长度备注regionCode区域编码StringV50必填，如：南京：320100carSendId派车单号StringV50必填，各子平台自动推送，同一平台下不能重复applyId申请单号StringV50必填，各子平台自动推送，同一平台下不能重复carNo车牌号码StringV50必填carNoColor车牌颜色Number-必填，详情见附录 B.3DB32/T 3826-202012表19派车信息接口传入参数说明表（续）参数名称参数含义数据类型长度备注orderDate订单时间Date-必 填,yyyy-MM-ddHH:mm:ss(例如:2019-10-29 12:30:00)vehicleType车辆类型Number-必填，详情见附录 B.4orderType订单状态Number-必填，详情见附录 B.13applyPersonName申请人姓名StringV50必填applyPersonPhone申请人联系方式StringV50必填usePersonName用车人姓名StringV50必填usePersonPhone用车人联系方式StringV50必填useDept用车单位StringV50必填superGroup上级直属单位名称StringV50必填useNumber用车人数Number-必填,大于 0useReason用车事由Number-必填，详情见附录 B.14mileage订单里程（公里）Number-必填（阿拉伯数字），大于等于 0，表明是该次订单的订单里程startDate报到时间Date-必 填,yyyy-MM-ddHH:mm:ss(例如:2019-10-29 12:30:00)startPlace报到地点StringV50必填toPlace目的地StringV50必填estimatedreturnDate预计回场时间Date-必 填,yyyy-MM-ddHH:mm:ss(例如:2019-10-29 12:30:00)returnDate返回时间Date-必 填,yyyy-MM-ddHH:mm:ss(例如:2019-10-29 12:30:00)driverName驾驶员姓名StringV50必填driverPhone驾驶员联系方式StringV50必填parkingRateCost停车费用（元）Number-非必填，精确到小数点后两位，大于等于 0passageCost过路过桥费用（元）Number-非必填，精确到小数点后两位，大于等于 0oilCost燃油/充电费（元）Number-非必填，燃油车填写燃油费，新能源车填写充电费，精确到小数点后两位，大于等于 0，正常完成订单该项需大于 0otherCost其他费用（元）Number-非必填，精确到小数点后两位，大于等于 0useAssess用车评价Number-必填，从 0 到 5 分remark备注stringV200非必填7.7.3接口返回参数说明派车信息接口返回参数说明如表20所示。DB32/T 3826-202013表 20派车信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述7.8车辆维保信息接口7.8.1接口描述车辆维保信息接口描述如表21所示。表 21车辆维保信息接口描述表接口名称车辆维保信息接口（api/editMaintenance）通信承载协议HTTP POST提供者上级平台主要使用者下级平台7.8.2接口传入参数说明车辆维保信息接口传入参数说明如表22所示。表 22车辆维保信息接口传入参数说明表参数名称参数含义数据类型长度备注regionCode区域编码StringV50必填，如：南京：320100carNo车牌号码StringV50必填，参考车辆信息填写carNoColor车牌颜色Number-必填，详情见附录 B.3maintenanceId维保单编号StringV50必填，各子平台自动推送，同一平台下不能重复maintenanceType维保类型Number-详情见附录 B.23maintenanceStartDate维保开始日期Date-必 填,yyyy-MM-ddHH:mm:ss(例如:2019-10-29 12:30:00)maintenanceEndDate维保结束日期Date-必 填,yyyy-MM-ddHH:mm:ss(例如:2019-10-29 12:30:00)maintenanceShop维修厂名称StringV50必填maintenancePrice维保费用（元）Number-必填，精确到小数点后两位，大于07.8.3接口返回参数说明车辆维保信息接口返回参数说明如表23所示。DB32/T 3826-202014表 23车辆维保信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述7.9车辆年检信息接口7.9.1接口描述车辆年检信息接口描述如表24所示。表 24车辆年检信息接口描述表接口名称车辆年检信息接口（api/editInspection）通信承载协议HTTP POST提供者上级平台主要使用者下级平台7.9.2接口传入参数说明车辆年检信息接口传入参数说明如表25所示。表 25车辆年检信息接口传入参数说明表参数名称参数含义数据类型长度备注carNo车牌号码StringV50必填，参考车辆信息填写carNoColor车牌颜色Number-必填，详情见附录 B.3inspectionValidityStartTime年检有效期开始时间Date-必填,yyyy-MM-ddHH:mm:ss(例如:2019-10-29 12:30:00)inspectionValidityEndTime年检有效期结束时间Date-必填,yyyy-MM-ddHH:mm:ss(例如:2019-10-29 12:30:00)inspectionPrice年检费用（元）Number-必填，精确到小数点后两位，大于 07.9.3接口返回参数说明车辆年检信息接口返回参数说明如表26所示。表 26车辆年检信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述7.10车辆能耗信息接口7.10.1接口描述DB32/T 3826-202015车辆能耗信息接口描述如表27所示。表 27车辆能耗信息接口描述表接口名称车辆能耗信息接口（api/editOil）通信承载协议HTTP POST提供者上级平台主要使用者下级平台7.10.2接口传入参数说明车辆能耗信息接口传入参数说明如表28所示。表 28车辆能耗信息接口传入参数说明表参数名称参数含义数据类型长度备注carNo车牌号码StringV50必填，参考车辆信息填写carNoColor车牌颜色Number-必填，详情见附录 B.3oilType能源种类Number-必填，详情见附录 B.15oilDate能源加充时间Date-必 填,yyyy-MM-ddHH:mm:ss(例如:2019-10-29 12:30:00)oilPlace加充地点StringV200必填oilCardId加冲卡号StringV50必填，燃油车填写加油卡号，新能源车填写充电卡号oilRise加充数量Number-必填（精确到小数点后一位），大于0.0，燃油车单位为升（L），新能源车为度oilPrice加充费用（元）Number-必填，精确到小数点后两位，大于0driverName驾驶员姓名StringV50必填driverPhone驾驶员联系方式StringV50必填7.10.3接口返回参数说明车辆能耗信息接口返回参数说明如表29所示。表 29车辆能耗信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述7.11车辆保险费用信息接口7.11.1接口描述车辆保险费用信息接口描述如表30所示。DB32/T 3826-202016表 30车辆保险费用信息接口描述表接口名称车辆保险费用信息接口（api/editInsuranceCost）通信承载协议HTTP POST提供者上级平台主要使用者下级平台7.11.2接口传入参数说明车辆保险费用信息接口传入参数说明如表31所示。表 31车辆保险费用信息接口传入参数说明表参数名称参数含义数据类型长度备注carNo车牌号码StringV50必填，参考车辆信息填写carNoColor车牌颜色Number-必填，详情见附录 B.3insuranceGroup保险公司StringV50必填insuranceType保险种类Number-必填，详情见附录 B.16insuranceId保险单号StringV50必填insuranceValidityStartTime保险有效期开始时间Date-必 填,yyyy-MM-ddHH:mm:ss(例如:2019-10-29 12:30:00)insuranceValidityEndTime保险有效期结束时间Date-必 填,yyyy-MM-ddHH:mm:ss(例如:2019-10-29 12:30:00)insuranceTotalPrice保险总费用（元）Number-必填，精确到小数点后两位，大于 0remark备注StringV200必填7.11.3接口返回参数说明车辆保险费用信息接口返回参数说明如表32所示。表 32车辆保险费用信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述7.12车辆过路过桥费用信息接口7.12.1接口描述车辆过路过桥费用信息接口描述如表33所示。表 33车辆过路过桥费用信息接口描述表接口名称车辆过路过桥费用信息接口（api/editPassageCost）通信承载协议HTTP POST提供者上级平台主要使用者下级平台DB32/T 3826-2020177.12.2接口传入参数说明车辆过路过桥费用信息接口传入参数说明如表34所示。表 34车辆过路过桥费用信息接口传入参数说明表参数名称参数含义数据类型长度备注carNo车牌号码StringV50必填，参考车辆信息填写carNoColor车牌颜色Number-必填，详情见附录 B.3costGenerationTime费用产生时间Date-必 填,yyyy-MM-ddHH:mm:ss(例如:2019-10-29 12:30:00)billNumber票据张数Number-必填,大于等于 0price费用（元）Number-必填，精确到小数点后两位，大于 0driverName驾驶员姓名StringV50必填driverPhone驾驶员联系方式StringV50必填7.12.3接口返回参数说明车辆过路过桥费用信息接口返回参数说明如表35所示。表 35车辆过路过桥费用信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述7.13车辆停车费用信息接口7.13.1接口描述车辆停车费用信息接口描述如表36所示。表 36车辆停车费用信息接口描述表接口名称车辆停车费用信息接口（api/editParkingCost）通信承载协议HTTP POST提供者上级平台主要使用者下级平台7.13.2接口传入参数说明车辆停车费用信息接口传入参数说明如表37所示。表 37车辆停车费用信息接口传入参数说明表参数名称参数含义数据类型长度备注carNo车牌号码StringV50必填，参考车辆信息填写carNoColor车牌颜色Number-必填，详情见附录 B.3DB32/T 3826-202018表 37车辆停车费用信息接口传入参数说明表（续）参数名称参数含义数据类型长度备注parkingStartDate停车开始时间