DB32∕T 3826-2020 公务用车信息化平台数据交换技术应用规范.doc

ICS35.240.99L 76DB32江苏省地方标准DB 32/T 3826-2020公务用车信息化平台数据交换技术规范Data interchange specification in official vehicle information platform2020 - 07 - 14发布2020 - 08 - 14实施江苏省市场监督管理局发布目次前言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（规范性附录）接口反馈内容25附录B（规范性附录）数据字典规范26前言本标准按照GB/T 1.1-2009给出的规则编写。本标准由江苏省机关事务管理局提出并归口。本标准起草单位：江苏省机关事务管理局、中电鸿信信息科技有限公司。本标准主要起草人：徐华明、左晓刚、李角榆、白金龙、罗 星、伍 薇、陶思蓉、顾新贤、李声祥、左 军、司奉彦。公务用车信息化平台数据交换技术规范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。4 缩略语下列缩略语适用于本文件。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 用户数据报协议(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 下级平台基础数据发生变化、定位终端上报定位数据时，均应实时传输到数据交换平台。6.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的要求7 基础信息交换接口说明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 接口传入参数格式第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,token: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-必填，大于等于0表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所示。表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-dd HH:mm:ss，例如:2019-10-29 12:30:00 obtainType取得方式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所示。表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必填，仅限阿拉伯数字和英文字母，字母自动大写表13 超标准配备车辆信息接口传入参数说明表（续）参数名称参数含义数据类型长度备注obtainDate注册日期Date-必填, 车辆购置日期，yyyy-MM-dd HH: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-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.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.3表19 派车信息接口传入参数说明表（续）参数名称参数含义数据类型长度备注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用车单位StringV50必填superGroup上级直属单位名称StringV50必填useNumber用车人数Number-必填,大于0useReason用车事由Number-必填，详情见附录B.14 mileage订单里程（公里）Number-必填（阿拉伯数字），大于等于0，表明是该次订单的订单里程startDate报到时间Date-必填,yyyy-MM-dd HH:mm:ss(例如:2019-10-29 12:30:00)startPlace报到地点StringV50必填toPlace目的地StringV50必填estimatedreturnDate预计回场时间Date-必填,yyyy-MM-dd 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-非必填，燃油车填写燃油费，新能源车填写充电费，精确到小数点后两位，大于等于0，正常完成订单该项需大于0otherCost其他费用（元）Number-非必填，精确到小数点后两位，大于等于0useAssess用车评价Number-必填，从0到5分remark备注stringV200非必填7.7.3 接口返回参数说明派车信息接口返回参数说明如表20所示。表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-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-必填，精确到小数点后两位，大于07.8.3 接口返回参数说明车辆维保信息接口返回参数说明如表23所示。表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-dd HH:mm:ss(例如:2019-10-29 12:30:00)inspectionValidityEndTime年检有效期结束时间Date-必填,yyyy-MM-dd HH:mm:ss(例如:2019-10-29 12:30:00)inspectionPrice年检费用（元）Number-必填，精确到小数点后两位，大于07.9.3 接口返回参数说明车辆年检信息接口返回参数说明如表26所示。表26 车辆年检信息接口返回参数说明表参数名称参数含义类型长度说明result返回结果StringV50操作成功：success；失败返回：failresultCode返回码Number-自定义返回码message返回信息String