DB32-T 3826-2020公务用车信息化平台数据交换技术应用规范-（高清现行）

1、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-2020 PAGE * ROMAN III目次 HYPERLINK l _bookmark0 前言III HYPERLINK l _bookmark1 范围1 HYPERLINK l _bookmark2 规范性引用

2、文件1 HYPERLINK l _bookmark3 术语和定义1 HYPERLINK l _bookmark4 缩略语2 HYPERLINK l _bookmark5 数据交换信息内容2 HYPERLINK l _bookmark6 基础数据2 HYPERLINK l _bookmark7 定位数据2 HYPERLINK l _bookmark8 数据交换形式与要求2 HYPERLINK l _bookmark9 接口要求2 HYPERLINK l _bookmark10 数据传输加密3 HYPERLINK l _bookmark11 基础数据交换3 HYPERLINK l _bookmar

3、k12 定位数据交换3 HYPERLINK l _bookmark13 基础信息交换接口说明4 HYPERLINK l _bookmark14 状态码定义4 HYPERLINK l _bookmark15 登录接口4 HYPERLINK l _bookmark16 单位基本信息接口6 HYPERLINK l _bookmark17 单车基本信息接口7 HYPERLINK l _bookmark18 超标准配备车辆信息接口9 HYPERLINK l _bookmark19 驾驶员基本信息接口10 HYPERLINK l _bookmark20 派车信息接口11 HYPERLINK l _book

4、mark21 车辆维保信息接口13 HYPERLINK l _bookmark22 车辆年检信息接口14 HYPERLINK l _bookmark23 车辆能耗信息接口14 HYPERLINK l _bookmark24 车辆保险费用信息接口15 HYPERLINK l _bookmark25 车辆过路过桥费用信息接口16 HYPERLINK l _bookmark26 车辆停车费用信息接口17 HYPERLINK l _bookmark27 车辆其他费用信息接口18 HYPERLINK l _bookmark28 监督检查情况信息接口19 HYPERLINK l _bookmark29 7

5、.16 12345 投诉信息接口20 HYPERLINK l _bookmark30 社会车辆租赁派车信息接口21 HYPERLINK l _bookmark31 车辆违章情况信息接口22 HYPERLINK l _bookmark32 车辆处置情况信息接口23附录 A（规范性附录） 接口反馈内容25 HYPERLINK l _bookmark33 附录 B（规范性附录） 数据字典规范26前言本标准按照GB/T 1.1-2009给出的规则编写。本标准由江苏省机关事务管理局提出并归口。本标准起草单位：江苏省机关事务管理局、中电鸿信信息科技有限公司。本标准主要起草人：徐华明、左晓刚、李角榆、白金龙

6、、罗 星、伍 薇、陶思蓉、顾新贤、李声祥、左 军、司奉彦。DB32/T 3826-2020 PAGE 26公务用车信息化平台数据交换技术规范范围本标准规定了公务用车信息化平台数据交换的术语和定义、缩略语、数据交换内容、交换形式和要 求以及基础信息交换接口说明。本标准适用于公务用车信息化平台数据交换。规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 2260 中华人民共和国行政区划代码JT/T 808-2013 道路运输车辆卫星定位系统 北斗兼容车载终端通讯协议技

7、术规范术语和定义下列术语和定义适用于本文件。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。缩略语下列缩略语适用于本文件。

8、JSON JS对象标记（Java Script Object Notation）UTF-8 针对Unicode的可变长度字符编码（8-bit Unicode Transformation Format）； HTTP 超文本传输协议(HyperText Transfer Protocol)POST 是HTTP协议中的一个重要组成部分。POST方法一般用来向目的服务器发出更新请求，并附有请求实体向指定的资源提交要被处理的数据（Power On Self Test）UDP HYPERLINK /s?wd=%E7%94%A8%E6%88%B7%E6%95%B0%E6%8D%AE%E6%8A%A5%E5

9、%8D%8F%E8%AE%AE&tn=SE_PcZhidaonwhc_ngpagmjz&rsv_dl=gh_pc_zhidao 用户数据报协议(User Datagram Protocol)数据交换信息内容基础数据下级平台交换的基础数据内容应包括：单位基本信息；单车基本信息；超标准配备车辆信息；驾驶员基本信息；派车信息；车辆维保信息；车辆年检信息；车辆能耗信息；车辆保险费用信息；车辆过路过桥费用信息；车辆停车费用信息；车辆其他费用信息；监督检查情况信息；12345 投诉信息；社会车辆租赁派车信息；车辆违章情况信息车辆处置情况信息各类基础数据的详细字段要求见第 7 章。定位数据交换的车辆定位数据

10、内容应包含报警标志、状态、经度、纬度、高程、速度、方向、定位时间、里 程等信息，详细交换内容应满足JT/T 808-2013中8.18节的要求。数据交换形式与要求接口要求下级平台基础数据发生变化、定位终端上报定位数据时，均应实时传输到数据交换平台。在调用基础信息交换接口推送数据时，若接口返回错误，则需要根据返回的状态码/描述重新调 用接口实现数据重发。在调用基础信息交换接口推送数据时，若等待 10 秒接口无响应，需要重新调用接口重传该条数据。若数据交换过程中出现网络/接口中断情况，需要在网络/接口恢复正常后补传中断时间内所有 基础数据及定位数据。数据传输加密公务用车终端应采用支持 SM3 算法

11、的国密级芯片对用车数据进行加密后上传至各级公务用车平台，平台接收数据后进行解密存储。公务用车基础数据及定位数据进行平台间数据传输时，下级平台应对公务用车数据使用国密 SM3 算法进行数据加密后上传至上级平台，上级平台接收数据后进行解密存储。基础数据交换数据交换方式应采用 web service 接口作为数据传输机制。调用接口数据之前，应将数据转换成规定的数据类型和格式，数据类型和格式见第 7 章，传入数据由 json 格式组成。所有请求数据格式应采用 UTF-8 格式。应采用 HTTP 协议，POST 请求。返回的数据根据具体接口定义 JSON 数据信息，反馈形式见附录 A。定位数据交换通讯机

12、制采用 UDP 方式，下级平台通过 UDP 方式将定位数据发送至上级平台，平台的通讯连接及重发机制应遵循 JT/T 808-2013 中第 5 章及第 6 章的协议规定。定位数据传输协议符合 JT/T 808-2013 中的注册、鉴权、位置信息汇报、终端通用应答、平台通用应答协议部分的要求，数据格式见表 1，主要包括如下内容：终端注册：下级平台往上级平台发送车辆定位数据前，下级平台的车载定位终端在未注册状态 下，应首先进行注册，注册成功后下级平台将获得上级平台的鉴权码并进行保存；终端鉴权：下级平台收到上级平台反馈的注册成功信息后，应立即进行鉴权。鉴权成功前下级 平台不得上报车载定位终端的其它消

13、息。上级平台收到终端鉴权信息后回复下级平台通用应答 消息；位置信息汇报：下级平台应向上级平台实时发送位置信息汇报消息；终端通用应答；平台通用应答。表 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的要求基础信息交换接口说明状态码定义接口状态码定义对照表如表2所示。表 2 接口状态码定义对照表序号应答/错误代码应答/

14、错误描述1100成功2102失败3103推送的JSON格式错误4104数据验证错误5105异常错误6106所属部门不存在7107车辆类型不存在8108车牌号不存在9109驾驶员不存在10110租赁公司不存在11111区域编码不存在12112用户名或者密码不对登录接口接口描述登录接口描述见表3。表 3 登录接口描述表接口名称登录接口（api/login）通信承载协议HTTP POST提供者上级平台主要使用者下级平台接口传入参数说明登录接口传入参数说明见表4。表 4 登录接口传入参数说明表参数名称参数含义数据类型长度备注userName用户名称StringV50必填，省平台统一编码,统一为行政区域

15、编码，按照GB/T 2260相关要求执行，如南京市级平台：320100userPass用户密码StringV50必填，省平台统一编码接口传入参数格式第7章各类接口传入参数格式如下所示，各个参数名称和排列顺序应与传入参数说明表中参数名称和排列顺序保持一致，接口传入参数格式如下所示（第7章各类接口传入参数格式按照以下格式编写）：Info:参数名称 1:数值,参数名称 2:数值 ,参数名称 3:数值 ,参数名称 n:数值示例：Info:userName:320100, /320100：用户名称userPass:123456/123456：用户密码接口返回参数说明登录接口返回参数说明见表5。表 5 登

16、录接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码token返回令牌StringV50访问后续接口的令牌，请求后续接口需要放到请求头里message返回信息StringV50具体描述接口返回参数格式各个参数名称和排列顺序应与返回参数说明表中参数名称和排列顺序保持一致，接口返回参数格式 如下所示（第8章各类接口返回参数格式按照以下格式编写）：参数名称 1:数值,参数名称 2:数值 ,参数名称 3:数值 ,参数名称 n:数值示例：result:success,resu

17、ltCode:100,token:eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJmaGdqIiwiYXV0aCI6InVzZXJJZC1mY2YzZWIxOC1iYzQ1LTQ4NGQtOG E5Z S1jZjkxZjM1OGJlMzciLCJ1c2VyRGF0YSI6eyJjb21wYW55SWQiOiJhZWIyZjllMi1jYmExLTQ3NTMtYmNjNy1mOTFjYTEyOGFk ZWIiLCJ1c2VySWQiOiIxMDM5NjNiMi03ZmRmLTRiZGMtYTllNS04YzQzNmViMjM3YzgifX0.bXNFb8RcYD_oLG3Yl9b

18、bnWQ3h2304JqIXurDAJG8jDvDKx3STIeA5NjaOLY9ZA1XW6PnwTBrYq9WZcZRvQwN5A,message:登录成功单位基本信息接口接口描述单位基本信息接口描述如表6所示。表 6 单位基本信息接口描述表接口名称单位基本信息接口（api/editGroup）通信承载协议HTTP POST提供者上级平台主要使用者下级平台接口传入参数说明单位基本信息接口传入参数说明如表7所示。表 7 单位基本信息接口传入参数说明表参数名称参数含义数据类型长度备注regionCode区域编码StringV50必填，如：南京：320100groupName单位名称String

19、V50必填，单位名称全称superGroup上级直属单位名称StringV50必填，无上级直属单位的情况，为NULLsocialCreditCode统一社会信用代码StringV50必填，18 位阿拉伯数字/英文；如果没有，填无structureNature机构性质Number-必填，详情见附录B.1structureLevel机构级别Number-必填，详情见附录B.2groupAddress单位地址StringV100必填groupOrganizationNumber单位编制人数Number-必填，大于等于 0groupFactNumber单位编内实有人数Number-必填，大于等于 0g

20、roupOtherNumber单位编外实有人数Number-必填，大于等于 0organizationCarNumber编制车辆数(辆)Number-必填，大于等于 0，经公务用车主管部门核定的编制车辆数；事业单位为保留车辆数；车辆产权不在本单位的，填 0.factCarNumber实有车辆数(辆)Number-必填，大于等于 0purchaseEquipmentCarNumber全年购置车辆数(辆)Number-必填，大于等于 0updateEquipmentCarNumber全年更新车辆数(辆)Number-必填，大于等于 0表 7 单位基本信息接口传入参数说明表（续）参数名称参数含义数据

21、类型长度备注 HYPERLINK /link?url=RDW21rCDbpSN8eAKmkC5LFcCOe1Zg1Q97wkmNAivM1lWhQp8PatpDmLrra8vo8vNDXaeskBoIPzRhsfQt9_b_uYNlwuTJW3PDjQOh5DKSAa adjustEquipmentCarNumber全年调剂车辆数(辆)Number-必填，大于等于 0，该字段表示其他单位调剂到本单位的车辆superiorEquipmentCarNumber全年上级下拨车辆数(辆)Number-必填，大于等于 0acceptanceEquipmentCarNumber全年接受捐赠车辆数(辆)Nu

22、mber-必填，大于等于 0otherEquipmentCarNumber全年其他方式配置车辆数(辆)Number-必填，大于等于 0auctionManageCarNumber全年拍卖车辆数(辆)Number-必填，大于等于 0scrapManageCarNumber全年报废车辆数(辆)Number-必填，大于等于 0recoveryManageCarNumber全年厂家回收车辆数(辆)Number-必填，大于等于 0 HYPERLINK /link?url=RDW21rCDbpSN8eAKmkC5LFcCOe1Zg1Q97wkmNAivM1lWhQp8PatpDmLrra8vo8vNDXa

23、eskBoIPzRhsfQt9_b_uYNlwuTJW3PDjQOh5DKSAa adjustManageCarNumber全年调剂处置车辆数（辆）Number-必填，大于等于 0，该字段表示通过调剂处理的车辆数量otherManageCarNumber全年其他方式处置车辆数(辆)Number-必填，大于等于 0responsiblePersonName车管负责人姓名StringV50必填responsiblePersonPhone车管负责人联系方式StringV50必填dispatchPersonName车辆调度员姓名StringV50必填dispatchPersonPhone车辆调度员联系

24、方式StringV50必填chargingPilesNumber充电桩数Number-必填，大于等于 0接口返回参数说明单位基本信息接口返回参数说明如表8所示。表 8 单位基本信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述单车基本信息接口接口描述单车基本信息接口描述如表9所示。表 9 单车基本信息接口描述表接口名称单车基本信息接口（api/editCar）通信承载协议HTTP POST提供者上级平台主要使用者下

25、级平台接口传入参数说明单车基本信息传入参数说明如表10所示。表 10 单车基本信息接口传入参数说明表参数名称参数含义数据类型长度备注regionCode区域编码StringV50必填，如：南京：320100carNo车牌号码StringV50必填，第一个字必须是汉字，字母自动大写carNoColor车牌颜色Number-必填，详情见附录 B.3groupName所属单位名称StringV50必填superGroup上级直属单位名称StringV50必填carColor车辆颜色StringV50必填Brand品牌型号StringV50必填，如别克 君威等vehicleType车辆类型Number

26、-必填，详情见附录 B.4Category使用性质Number-必填，详情见附录 B.5Vin车辆识别代号（车架号）StringV50必填，仅限阿拉伯数字和英文字母，字母自动大写engineNum发动机号码StringV50必填，字母数字组合powerType动力类型Number-必填，详情见附录 B.6discharge排气量Number-必填，小型、中型燃油车必填，从 1.0 到 5.0；新能源车填 0loadingNumber核载人数Number-必填，阿拉伯数字，单位：人，大于 0purchasePrice购置价格（万元）Number-必填，精确到小数点后两位，大于 0.00obtai

27、nDate注册日期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 年计算depreciat

28、ionPeriod折旧年限Number-必填,从购车到现在的年数，大于 0paperPrice账面价格（万元）Number-必填，精确到小数点后两位，折旧后的价格大于 0.00，折旧年限大于 8 年填 0.00timerNumber行驶里程（公里）Number-必填，阿拉伯数字，大于 0，实时码表里程，每年年底terminalkeyid车载终端 IDStringV20必填，对应定位终端手机号码接口返回参数说明单车基本信息接口返回参数说明如表11所示。表 11 单车基本信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：fa

29、ilresultCode返回码Number-自定义返回码message返回信息StringV50具体描述超标准配备车辆信息接口接口描述超标准配备车辆信息接口描述如表12所示。表 12 超标准配备车辆信息接口描述表接口名称超标准配备车辆信息接口（api/editStandardCar）通信承载协议HTTP POST提供者上级平台主要使用者下级平台接口传入参数说明超标准配备车辆信息接口传入参数说明如表13所示。表 13 超标准配备车辆信息接口传入参数说明表参数名称参数含义数据类型长度备注regionCode区域编码StringV50必填，如：南京：320100carNo车牌号码StringV50必

30、填，参考车辆信息填写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

31、.0；新能源车填 0purchasePrice购置价格（万元）Number-必填，精确到小数点后两位，大于 0.00timerNumber行驶里程（公里）Number-必填，阿拉伯数字，大于 0，实时码表里程approvalGroup批准单位StringV50必填vin车辆识别代号（车架号）StringV50必填，仅限阿拉伯数字和英文字母，字母自动大写表 13 超标准配备车辆信息接口传入参数说明表（续）参数名称参数含义数据类型长度备注obtainDate注册日期Date-必 填 , 车 辆 购 置 日 期 ，yyyy-MM-ddHH:mm:ss ， 例如:2019-10-29 12:30:00

32、obtainType取得方式Number-必填，详情见附录 B.7接口返回参数说明超标准配备车辆信息接口返回参数说明如表14所示。表 14 超标准配备车辆信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述驾驶员基本信息接口接口描述驾驶员基本信息接口描述如表15所示。表 15 驾驶员基本信息接口描述表接口名称驾驶员基本信息接口（api/editDriver）通信承载协议HTTP POST提供者上级平台主要使用者下级平

33、台接口传入参数说明驾驶员基本信息接口传入参数说明如表16所示。表 16 驾驶员基本信息接口传入参数说明表参数名称参数含义数据类型长度备注regionCode区域编码StringV50必填，如：南京：320100driverName驾驶员姓名StringV50必填Sex性别Number-必填，1：男，2：女groupName所属单位名称StringV50必填superGroup上级直属单位名称StringV50必填idCard驾驶证号StringV50必填（18 位字母数字组合）drivingType准驾车型Number-必填，详情见附录 B.11fristIssueDate初次领证日期Date

34、-必 填 ,yyyy-MM-dd HH:mm:ss( 例如:2019-10-29 12:30:00)表 16 驾驶员基本信息接口传入参数说明表（续）参数名称参数含义数据类型长度备注changeIssueDate换证日期Date必 填 :yyyy-MM-dd HH:mm:ss( 例如:2019-10-29 12:30:00)，未换证填写除此领证日期employmentNature用工性质Number-必填，详情见附录 B.12if HYPERLINK /link?url=J8o6kvfoQV8P97q5_DXYVV1AFmJ7bGAqS3KZDBK96o53EZIDP_IlWfqoABLMJ28

35、JF5Au27GxIu28PrEbn2dUDNwIjYy53YWhXeZvTcQRBFC fulltime是否专职Number-0：非专职，1：专职phoneNum联系方式StringV50必填接口返回参数说明驾驶员基本信息接口返回参数说明如表17所示。表 17 驾驶员基本信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述派车信息接口接口描述派车信息接口描述如表18所示。表 18 派车信息接口描述表接口名称派车信息

36、接口（api/editCarSend）通信承载协议HTTP POST提供者上级平台主要使用者下级平台接口传入参数说明派车信息接口传入参数说明如表19所示。表 19 派车信息接口传入参数说明表参数名称参数含义数据类型长度备注regionCode区域编码StringV50必填，如：南京：320100carSendId派车单号StringV50必填，各子平台自动推送，同一平台下不能重复applyId申请单号StringV50必填，各子平台自动推送，同一平台下不能重复carNo车牌号码StringV50必填carNoColor车牌颜色Number-必填，详情见附录 B.3表19 派车信息接口传入参数说

37、明表（续）参数名称参数含义数据类型长度备注orderDate订单时间Date-必 填 ,yyyy-MM-dd HH:mm:ss( 例如:2019-10-29 12:30:00)vehicleType车辆类型Number-必填，详情见附录 B.4orderType订单状态Number-必填，详情见附录 B.13applyPersonName申请人姓名StringV50必填applyPersonPhone申请人联系方式StringV50必填usePersonName用车人姓名StringV50必填usePersonPhone用车人联系方式StringV50必填useDept用车单位StringV5

38、0必填superGroup上级直属单位名称StringV50必填useNumber用车人数Number-必填,大于 0useReason用车事由Number-必填，详情见附录 B.14mileage订单里程（公里）Number-必填（阿拉伯数字），大于等于 0，表明是该次订单的订单里程startDate报到时间Date-必 填 ,yyyy-MM-dd HH:mm:ss( 例如:2019-10-29 12:30:00)startPlace报到地点StringV50必填toPlace目的地StringV50必填estimatedreturnDate预计回场时间Date-必 填 ,yyyy-MM-d

39、d HH:mm:ss( 例如:2019-10-29 12:30:00)returnDate返回时间Date-必 填 ,yyyy-MM-dd HH:mm:ss( 例如:2019-10-29 12:30:00)driverName驾驶员姓名StringV50必填driverPhone驾驶员联系方式StringV50必填parkingRateCost停车费用（元）Number-非必填，精确到小数点后两位，大于等于 0passageCost过路过桥费用（元）Number-非必填，精确到小数点后两位，大于等于 0oilCost燃油/充电费（元）Number-非必填，燃油车填写燃油费，新能源车填写充电费，

40、精确到小数点后两位，大于等于 0，正常完成订单该项需大于 0otherCost其他费用（元）Number-非必填，精确到小数点后两位，大于等于 0useAssess用车评价Number-必填，从 0 到 5 分remark备注stringV200非必填接口返回参数说明派车信息接口返回参数说明如表20所示。表 20 派车信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述车辆维保信息接口接口描述车辆维保信息接口描述如表

41、21所示。表 21 车辆维保信息接口描述表接口名称车辆维保信息接口（api/editMaintenance）通信承载协议HTTP POST提供者上级平台主要使用者下级平台接口传入参数说明车辆维保信息接口传入参数说明如表22所示。表 22 车辆维保信息接口传入参数说明表参数名称参数含义数据类型长度备注regionCode区域编码StringV50必填，如：南京：320100carNo车牌号码StringV50必填，参考车辆信息填写carNoColor车牌颜色Number-必填，详情见附录 B.3maintenanceId维保单编号StringV50必填，各子平台自动推送，同一平台下不能重复mai

42、ntenanceType维保类型Number-详情见附录 B.23maintenanceStartDate维保开始日期Date-必 填 ,yyyy-MM-dd HH:mm:ss( 例如:2019-10-29 12:30:00)maintenanceEndDate维保结束日期Date-必 填 ,yyyy-MM-dd HH:mm:ss( 例如:2019-10-29 12:30:00)maintenanceShop维修厂名称StringV50必填maintenancePrice维保费用（元）Number-必填，精确到小数点后两位，大于0接口返回参数说明车辆维保信息接口返回参数说明如表23所示。表 2

43、3 车辆维保信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述车辆年检信息接口接口描述车辆年检信息接口描述如表24所示。表 24 车辆年检信息接口描述表接口名称车辆年检信息接口（api/editInspection）通信承载协议HTTP POST提供者上级平台主要使用者下级平台接口传入参数说明车辆年检信息接口传入参数说明如表25所示。表 25 车辆年检信息接口传入参数说明表参数名称参数含义数据类型长度备注carNo

44、车牌号码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-必填，精确到小数点后两位，大于 0接口返回参数说明车辆年检信息接口返回参数说明

45、如表26所示。表 26 车辆年检信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述车辆能耗信息接口接口描述车辆能耗信息接口描述如表27所示。表 27 车辆能耗信息接口描述表接口名称车辆能耗信息接口（api/editOil）通信承载协议HTTP POST提供者上级平台主要使用者下级平台接口传入参数说明车辆能耗信息接口传入参数说明如表28所示。表 28 车辆能耗信息接口传入参数说明表参数名称参数含义数据类型长度备注ca

46、rNo车牌号码StringV50必填，参考车辆信息填写carNoColor车牌颜色Number-必填，详情见附录 B.3oilType能源种类Number-必填，详情见附录 B.15oilDate能源加充时间Date-必 填 ,yyyy-MM-dd HH:mm:ss( 例如:2019-10-29 12:30:00)oilPlace加充地点StringV200必填oilCardId加冲卡号StringV50必填，燃油车填写加油卡号，新能源车填写充电卡号oilRise加充数量Number-必填（精确到小数点后一位），大于0.0，燃油车单位为升（L），新能源车为度oilPrice加充费用（元）Num

47、ber-必填，精确到小数点后两位，大于0driverName驾驶员姓名StringV50必填driverPhone驾驶员联系方式StringV50必填接口返回参数说明车辆能耗信息接口返回参数说明如表29所示。表 29 车辆能耗信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述车辆保险费用信息接口接口描述车辆保险费用信息接口描述如表30所示。表 30 车辆保险费用信息接口描述表接口名称车辆保险费用信息接口（api/e

48、ditInsuranceCost）通信承载协议HTTP POST提供者上级平台主要使用者下级平台接口传入参数说明车辆保险费用信息接口传入参数说明如表31所示。表 31 车辆保险费用信息接口传入参数说明表参数名称参数含义数据类型长度备注carNo车牌号码StringV50必填，参考车辆信息填写carNoColor车牌颜色Number-必填，详情见附录 B.3insuranceGroup保险公司StringV50必填insuranceType保险种类Number-必填，详情见附录 B.16insuranceId保险单号StringV50必填insuranceValidityStartTime保险有

49、效期开始时间Date-必 填 ,yyyy-MM-dd HH:mm:ss( 例如:2019-10-29 12:30:00)insuranceValidityEndTime保险有效期结束时间Date-必 填 ,yyyy-MM-dd HH:mm:ss( 例如:2019-10-29 12:30:00)insuranceTotalPrice保险总费用（元）Number-必填，精确到小数点后两位，大于 0remark备注StringV200必填接口返回参数说明车辆保险费用信息接口返回参数说明如表32所示。表 32 车辆保险费用信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果Strin

50、gV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述车辆过路过桥费用信息接口接口描述车辆过路过桥费用信息接口描述如表33所示。表 33 车辆过路过桥费用信息接口描述表接口名称车辆过路过桥费用信息接口（api/editPassageCost）通信承载协议HTTP POST提供者上级平台主要使用者下级平台接口传入参数说明车辆过路过桥费用信息接口传入参数说明如表34所示。表 34 车辆过路过桥费用信息接口传入参数说明表参数名称参数含义数据类型长度备注carNo车牌号码StringV50必填，参考车辆信

51、息填写carNoColor车牌颜色Number-必填，详情见附录B.3costGenerationTime费用产生时间Date-必 填 ,yyyy-MM-dd HH:mm:ss( 例如:2019-10-29 12:30:00)billNumber票据张数Number-必填,大于等于 0price费用（元）Number-必填，精确到小数点后两位，大于 0driverName驾驶员姓名StringV50必填driverPhone驾驶员联系方式StringV50必填接口返回参数说明车辆过路过桥费用信息接口返回参数说明如表35所示。表 35 车辆过路过桥费用信息接口返回参数说明表参数名称参数含义类型长

52、度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述车辆停车费用信息接口接口描述车辆停车费用信息接口描述如表36所示。表 36 车辆停车费用信息接口描述表接口名称车辆停车费用信息接口（api/editParkingCost）通信承载协议HTTP POST提供者上级平台主要使用者下级平台接口传入参数说明车辆停车费用信息接口传入参数说明如表37所示。表 37 车辆停车费用信息接口传入参数说明表参数名称参数含义数据类型长度备注carNo车牌号码StringV50必填

53、，参考车辆信息填写carNoColor车牌颜色Number-必填，详情见附录B.3表 37 车辆停车费用信息接口传入参数说明表（续）参数名称参数含义数据类型长度备注parkingStartDate停车开始时间Date-必 填 ,yyyy-MM-dd HH:mm:ss( 例如:2019-10-29 12:30:00)parkingEndDate停车结束时间Date-必 填 ,yyyy-MM-dd HH:mm:ss( 例如:2019-10-29 12:30:00)parkingPlace停车地点StringV50必填billNumber票据张数Number-必填,大于等于 0parkingPric

54、e停车费用（元）Number-必填，精确到小数点后两位，大于 0driverName驾驶员姓名StringV50必填driverPhone驾驶员联系方式StringV50必填接口返回参数说明车辆停车费用信息接口返回参数说明如表38所示。表 38 车辆停车费用信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述车辆其他费用信息接口接口描述车辆其他费用信息接口描述如表39所示。表 39 车辆其他费用信息接口描述表接口名称

55、车辆其他费用信息接口（api/editOtherCost）通信承载协议HTTP POST提供者上级平台主要使用者下级平台接口传入参数说明车辆其他费用信息接口传入参数说明如表40所示。表 40 车辆其他费用信息接口传入参数说明表参数名称参数含义数据类型长度备注carNo车牌号码StringV50必填，参考车辆信息填写carNoColor车牌颜色Number-必填，详情见附录 B.3startDate开始时间Date-必 填 ,yyyy-MM-dd HH:mm:ss( 例如:2019-10-29 12:30:00)表 40 车辆其他费用信息接口传入参数说明表（续）参数名称参数含义数据类型长度备注e

56、ndDate结束时间Date-必 填 ,yyyy-MM-dd HH:mm:ss( 例如:2019-10-29 12:30:00)place地点StringV100必填reason原因StringV500必填billNumber票据张数Number-必填,大于等于 0price费用（元）Number-必填，精确到小数点后两位，大于 0driverName驾驶员姓名StringV50必填driverPhone驾驶员联系方式StringV50必填接口返回参数说明车辆其他费用信息接口返回参数说明如表41所示。表 41 车辆其他费用信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果S

57、tringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述监督检查情况信息接口接口描述监督检查情况信息接口描述如表42所示。表 42 监督检查情况信息接口描述表接口名称监督检查情况信息接口（api/editMonitoringInspect）通信承载协议HTTP POST提供者上级平台主要使用者下级平台接口传入参数说明监督检查情况信息接口传入参数说明如表43所示。表 43 监督检查情况信息接口传入参数说明表参数名称参数含义数据类型长度备注firstInspectGroup检查牵头单位Strin

58、gV50必填，省、市、县+单位名称，如:江苏省南京市中共纪委办公厅carNo车牌号码StringV50必填，参考车辆信息填写carNoColor车牌颜色Number-必填，详情见附录 B.3happenDate发生时间Date-必 填 ,yyyy-MM-ddHH:mm:ss( 例如:2019-10-29 12:30:00)表 43 监督检查情况信息接口传入参数说明表（续）参数名称参数含义数据类型长度备注problemType问题类别Number-必填,详情见附录B.17handleType监督检查处理类别StringV50必填,详情见附录 B.18；数据字典选择（7：其他）时，填写具体处理措施

59、handleDate处理时间Date-必填,yyyy-MM-dd HH:mm:ss(例如:2019-10-29 12:30:00)接口返回参数说明监督检查情况信息接口返回参数说明如表44所示。表 44 监督检查情况信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息StringV50具体描述12345 投诉信息接口接口描述12345投诉信息接口描述如表45所示。表 45 12345 投诉信息接口描述表接口名称12345 投诉信息接口（api/

60、editComplain）通信承载协议HTTP POST提供者上级平台主要使用者下级平台接口传入参数说明12345投诉信息接口传入参数说明如表46所示。表 46 12345 投诉信息接口传入参数说明表参数名称参数含义数据类型长度备注carNo车牌号码StringV50必填，参考车辆信息填写carNoColor车牌颜色Number-必填，详情见附录 B.3date时间Date-必 填 ,yyyy-MM-dd HH:mm:ss( 例如:2019-10-29 12:30:00)place地点StringV100必填driverName驾驶员姓名StringV50必填isFact是否属实Number-