DB32T3826-2020公务用车信息化平台数据交换技术应用规范

ICS35.240.99

L76DB32

江苏省地方标准

DB32/T3826-2020

公务用车信息化平台数据交换技术规范

Datainterchangespecificationinofficialvehicleinformationplatform

2020-07-14发布2020-08-14实施

江苏省市场监督管理局发布

DB32/T3826-2020

前  言

本标准按照GB/T1.1-2009给出的规则编写。

本标准由江苏省机关事务管理局提出并归口。

本标准起草单位：江苏省机关事务管理局、中电鸿信信息科技有限公司。

本标准主要起草人：徐华明、左晓刚、李角榆、白金龙、罗星、伍薇、陶思蓉、顾新贤、李声

祥、左军、司奉彦。

III

DB32/T3826-2020

公务用车信息化平台数据交换技术规范

1范围

本标准规定了公务用车信息化平台数据交换的术语和定义、缩略语、数据交换内容、交换形式和要

求以及基础信息交换接口说明。

本标准适用于公务用车信息化平台数据交换。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文

件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GB/T2260中华人民共和国行政区划代码

JT/T808-2013道路运输车辆卫星定位系统北斗兼容车载终端通讯协议技术规范

3术语和定义

下列术语和定义适用于本文件。

3.1

数据交换datainterchange

在不同系统和设备间进行的数据传输与处理的过程。

3.2

电子数据交换electronicdatainterchange(EDI)

采用标准格式，利用计算机网络进行业务数据的传输与处理。

[GB/T18354-2006，定义5.22]

3.3

上级平台superiorplatform

接收数据平台。

3.4

下级平台inferiorplatform

发送数据平台。

3.5

车牌号numberplate

公安交通管理部门颁发的机动车车牌管理号码，不包括车辆牌照的颜色。例：苏AJ3030。

1

DB32/T3826-2020

4缩略语

下列缩略语适用于本文件。

JSONJS对象标记（JavaScriptObjectNotation）

UTF-8针对Unicode的可变长度字符编码（8-bitUnicodeTransformationFormat）；

HTTP超文本传输协议(HyperTextTransferProtocol)

POST是HTTP协议中的一个重要组成部分。POST方法一般用来向目的服务器发出更新请求，并附

有请求实体向指定的资源提交要被处理的数据（PowerOnSelfTest）

UDP用户数据报协议(UserDatagramProtocol)

5数据交换信息内容

5.1基础数据

5.1.1下级平台交换的基础数据内容应包括：

——单位基本信息；

——单车基本信息；

——超标准配备车辆信息；

——驾驶员基本信息；

——派车信息；

——车辆维保信息；

——车辆年检信息；

——车辆能耗信息；

——车辆保险费用信息；

——车辆过路过桥费用信息；

——车辆停车费用信息；

——车辆其他费用信息；

——监督检查情况信息；

——12345投诉信息；

——社会车辆租赁派车信息；

——车辆违章情况信息

——车辆处置情况信息

5.1.2各类基础数据的详细字段要求见第7章。

5.2定位数据

交换的车辆定位数据内容应包含报警标志、状态、经度、纬度、高程、速度、方向、定位时间、里

程等信息，详细交换内容应满足JT/T808-2013中8.18节的要求。

6数据交换形式与要求

6.1接口要求

6.1.1下级平台基础数据发生变化、定位终端上报定位数据时，均应实时传输到数据交换平台。

2

DB32/T3826-2020

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数据交换方式应采用webservice接口作为数据传输机制。调用接口数据之前，应将数据转换

成规定的数据类型和格式，数据类型和格式见第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/T808-2013中第5章及第6章的协议规定。

6.4.2定位数据传输协议符合JT/T808-2013中的注册、鉴权、位置信息汇报、终端通用应答、平台

通用应答协议部分的要求，数据格式见表1，主要包括如下内容：

a)终端注册：下级平台往上级平台发送车辆定位数据前，下级平台的车载定位终端在未注册状态

下，应首先进行注册，注册成功后下级平台将获得上级平台的鉴权码并进行保存；

b)终端鉴权：下级平台收到上级平台反馈的注册成功信息后，应立即进行鉴权。鉴权成功前下级

平台不得上报车载定位终端的其它消息。上级平台收到终端鉴权信息后回复下级平台通用应答

消息；

c)位置信息汇报：下级平台应向上级平台实时发送位置信息汇报消息；

d)终端通用应答；

e)平台通用应答。

表1定位数据交换数据格式表

序号定位数据数据格式要求

1终端注册符合JT/T808-2013中表7的要求

2终端鉴权符合JT/T808-2013中表9的要求

3位置信息汇报符合JT/T808-2013中表23的要求

4终端通用应答消息体符合JT/T808-2013中表4的要求

5平台通用应答消息体符合JT/T808-2013中表5的要求

3

DB32/T3826-2020

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）

通信承载协议HTTPPOST

提供者上级平台

主要使用者下级平台

7.2.2接口传入参数说明

登录接口传入参数说明见表4。

表4登录接口传入参数说明表

参数名称参数含义数据类型长度备注

必填，省平台统一编码,统一为行政区域编码，按照GB/T2260

userName用户名称StringV50

相关要求执行，如南京市级平台：320100

userPass用户密码StringV50必填，省平台统一编码

7.2.3接口传入参数格式

4

DB32/T3826-2020

第7章各类接口传入参数格式如下所示，各个参数名称和排列顺序应与传入参数说明表中参数名称

和排列顺序保持一致，接口传入参数格式如下所示（第7章各类接口传入参数格式按照以下格式编写）：

{"Info":

{

"参数名称1":"数值",

"参数名称2":"数值",

"参数名称3":"数值",

……

"参数名称n":"数值"

}

}

示例：

{"Info":

{

"userName":"320100",//320100：用户名称

"userPass":"123456"//123456：用户密码

}

}

7.2.4接口返回参数说明

登录接口返回参数说明见表5。

表5登录接口返回参数说明表

参数名称参数含义类型长度说明

result返回结果StringV50操作成功：success；失败返回：fail

resultCode返回码Number-自定义返回码

token返回令牌StringV50访问后续接口的令牌，请求后续接口需要放到请求头里

message返回信息StringV50具体描述

7.2.5接口返回参数格式

各个参数名称和排列顺序应与返回参数说明表中参数名称和排列顺序保持一致，接口返回参数格式

如下所示（第8章各类接口返回参数格式按照以下格式编写）：

{

"参数名称1":"数值",

"参数名称2":"数值",

"参数名称3":"数值",

……

"参数名称n":"数值"

}

示例：

{

"result":"success",

"resultCode":"100",

5

DB32/T3826-2020

"token":"eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJmaGdqIiwiYXV0aCI6InVzZXJJZC1mY2YzZWIxOC1iYzQ1LTQ4NGQtOG

E5ZS1jZjkxZjM1OGJlMzciLCJ1c2VyRGF0YSI6eyJjb21wYW55SWQiOiJhZWIyZjllMi1jYmExLTQ3NTMtYmNjNy1mOTFjYTEyOGFk

ZWIiLCJ1c2VySWQiOiIxMDM5NjNiMi03ZmRmLTRiZGMtYTllNS04YzQzNmViMjM3YzgifX0.bXNFb8RcYD_oLG3Yl9bbnWQ3h23

04JqIXurDAJG8jDvDKx3STIeA5NjaOLY9ZA1XW6PnwTBrYq9WZcZRvQwN5A",

"message":"登录成功"

}

7.3单位基本信息接口

7.3.1接口描述

单位基本信息接口描述如表6所示。

表6单位基本信息接口描述表

接口名称单位基本信息接口（api/editGroup）

通信承载协议HTTPPOST

提供者上级平台

主要使用者下级平台

7.3.2接口传入参数说明

单位基本信息接口传入参数说明如表7所示。

表7单位基本信息接口传入参数说明表

参数名称参数含义数据类型长度备注

regionCode区域编码StringV50必填，如：南京：320100

groupName单位名称StringV50必填，单位名称全称

必填，无上级直属单位的情

superGroup上级直属单位名称StringV50

况，为NULL

必填，18位阿拉伯数字/英文；

socialCreditCode统一社会信用代码StringV50

如果没有，填无

structureNature机构性质Number-必填，详情见附录B.1

structureLevel机构级别Number-必填，详情见附录B.2

groupAddress单位地址StringV100必填

groupOrganizationNumber单位编制人数Number-必填，大于等于0

groupFactNumber单位编内实有人数Number-必填，大于等于0

groupOtherNumber单位编外实有人数Number-必填，大于等于0

必填，大于等于0，经公务用

车主管部门核定的编制车辆

organizationCarNumber编制车辆数(辆)Number-

数；事业单位为保留车辆数；

车辆产权不在本单位的，填0.

factCarNumber实有车辆数(辆)Number-必填，大于等于0

purchaseEquipmentCarNumber全年购置车辆数(辆)Number-必填，大于等于0

updateEquipmentCarNumber全年更新车辆数(辆)Number-必填，大于等于0

6

DB32/T3826-2020

表7单位基本信息接口传入参数说明表（续）

参数名称参数含义数据类型长度备注

必填，大于等于0，该字段表

adjustEquipmentCarNumber全年调剂车辆数(辆)Number-示其他单位调剂到本单位的

车辆

superiorEquipmentCarNumber全年上级下拨车辆数(辆)Number-必填，大于等于0

acceptanceEquipmentCarNumber全年接受捐赠车辆数(辆)Number-必填，大于等于0

otherEquipmentCarNumber全年其他方式配置车辆数(辆)Number-必填，大于等于0

auctionManageCarNumber全年拍卖车辆数(辆)Number-必填，大于等于0

scrapManageCarNumber全年报废车辆数(辆)Number-必填，大于等于0

recoveryManageCarNumber全年厂家回收车辆数(辆)Number-必填，大于等于0

必填，大于等于0，该字段表

adjustManageCarNumber全年调剂处置车辆数（辆）Number-

示通过调剂处理的车辆数量

otherManageCarNumber全年其他方式处置车辆数(辆)Number-必填，大于等于0

responsiblePersonName车管负责人姓名StringV50必填

responsiblePersonPhone车管负责人联系方式StringV50必填

dispatchPersonName车辆调度员姓名StringV50必填

dispatchPersonPhone车辆调度员联系方式StringV50必填

chargingPilesNumber充电桩数Number-必填，大于等于0

7.3.3接口返回参数说明

单位基本信息接口返回参数说明如表8所示。

表8单位基本信息接口返回参数说明表

参数名称参数含义类型长度说明

result返回结果StringV50操作成功：success；失败返回：fail

resultCode返回码Number-自定义返回码

message返回信息StringV50具体描述

7.4单车基本信息接口

7.4.1接口描述

单车基本信息接口描述如表9所示。

表9单车基本信息接口描述表

接口名称单车基本信息接口（api/editCar）

通信承载协议HTTPPOST

提供者上级平台

主要使用者下级平台

7.4.2接口传入参数说明

单车基本信息传入参数说明如表10所示。

7

DB32/T3826-2020

表10单车基本信息接口传入参数说明表

参数名称参数含义数据类型长度备注

regionCode区域编码StringV50必填，如：南京：320100

carNo车牌号码StringV50必填，第一个字必须是汉字，字母自动大写

carNoColor车牌颜色Number-必填，详情见附录B.3

groupName所属单位名称StringV50必填

superGroup上级直属单位名称StringV50必填

carColor车辆颜色StringV50必填

Brand品牌型号StringV50必填，如别克君威等

vehicleType车辆类型Number-必填，详情见附录B.4

Category使用性质Number-必填，详情见附录B.5

必填，仅限阿拉伯数字和英文字母，字母自

Vin车辆识别代号（车架号）StringV50

动大写

engineNum发动机号码StringV50必填，字母数字组合

powerType动力类型Number-必填，详情见附录B.6

必填，小型、中型燃油车必填，从1.0到5.0；

discharge排气量Number-

新能源车填0

loadingNumber核载人数Number-必填，阿拉伯数字，单位：人，大于0

purchasePrice购置价格（万元）Number-必填，精确到小数点后两位，大于0.00

必填,车辆购置日期，yyyy-MM-dd

obtainDate注册日期Date-

HH:mm:ss，例如:2019-10-2912:30:00

obtainType取得方式Number-必填，详情见附录B.7

etcCardETC卡号StringV50必填；如果没有ETC卡号，填无

必填，有多张加油卡每张之间用逗号分隔；

oilCard加油卡号StringV100

如果没有加油卡号，填无

identification车辆标识Number-必填，详情见附录B.8

必填，暂定为平均年限法折旧方法，折旧年

depreciationType折旧方式StringV50

限为8年计算

depreciationPeriod折旧年限Number-必填,从购车到现在的年数，大于0

必填，精确到小数点后两位，折旧后的价格

paperPrice账面价格（万元）Number-

大于0.00，折旧年限大于8年填0.00

必填，阿拉伯数字，大于0，实时码表里程，

timerNumber行驶里程（公里）Number-

每年年底

terminalkeyid车载终端IDStringV20必填，对应定位终端手机号码

7.4.3接口返回参数说明

单车基本信息接口返回参数说明如表11所示。

8

DB32/T3826-2020

表11单车基本信息接口返回参数说明表

参数名称参数含义类型长度说明

result返回结果StringV50操作成功：success；失败返回：fail

resultCode返回码Number-自定义返回码

message返回信息StringV50具体描述

7.5超标准配备车辆信息接口

7.5.1接口描述

超标准配备车辆信息接口描述如表12所示。

表12超标准配备车辆信息接口描述表

接口名称超标准配备车辆信息接口（api/editStandardCar）

通信承载协议HTTPPOST

提供者上级平台

主要使用者下级平台

7.5.2接口传入参数说明

超标准配备车辆信息接口传入参数说明如表13所示。

表13超标准配备车辆信息接口传入参数说明表

参数名称参数含义数据类型长度备注

regionCode区域编码StringV50必填，如：南京：320100

carNo车牌号码StringV50必填，参考车辆信息填写

carNoColor车牌颜色Number-必填，详情见附录B.3

groupName所属单位名称StringV50必填

superGroup上级直属单位名称StringV50必填

groupLevel机构级别Number-必填，详情见附录B.2

brand品牌型号StringV50必填，如别克君威等

vehicleType车辆类型Number-必填，详情见附录B.4

category使用性质Number-必填，详情见附录B.5

carOriginPlace车辆产地Number-必填，详情见附录B.10

小型、中型燃油车必填，从1.0

discharge排气量Number-

到5.0；新能源车填0

必填，精确到小数点后两位，大

purchasePrice购置价格（万元）Number-

于0.00

必填，阿拉伯数字，大于0，实时

timerNumber行驶里程（公里）Number-

码表里程

approvalGroup批准单位StringV50必填

必填，仅限阿拉伯数字和英文字

vin车辆识别代号（车架号）StringV50

母，字母自动大写

9

DB32/T3826-2020

表13超标准配备车辆信息接口传入参数说明表（续）

参数名称参数含义数据类型长度备注

必填,车辆购置日期，

obtainDate注册日期Date-yyyy-MM-ddHH:mm:ss，例

如:2019-10-2912:30:00

obtainType取得方式Number-必填，详情见附录B.7

7.5.3接口返回参数说明

超标准配备车辆信息接口返回参数说明如表14所示。

表14超标准配备车辆信息接口返回参数说明表

参数名称参数含义类型长度说明

result返回结果StringV50操作成功：success；失败返回：fail

resultCode返回码Number-自定义返回码

message返回信息StringV50具体描述

7.6驾驶员基本信息接口

7.6.1接口描述

驾驶员基本信息接口描述如表15所示。

表15驾驶员基本信息接口描述表

接口名称驾驶员基本信息接口（api/editDriver）

通信承载协议HTTPPOST

提供者上级平台

主要使用者下级平台

7.6.2接口传入参数说明

驾驶员基本信息接口传入参数说明如表16所示。

表16驾驶员基本信息接口传入参数说明表

参数名称参数含义数据类型长度备注

regionCode区域编码StringV50必填，如：南京：320100

driverName驾驶员姓名StringV50必填

Sex性别Number-必填，1：男，2：女

groupName所属单位名称StringV50必填

superGroup上级直属单位名称StringV50必填

idCard驾驶证号StringV50必填（18位字母数字组合）

drivingType准驾车型Number-必填，详情见附录B.11

必填,yyyy-MM-ddHH:mm:ss(例

fristIssueDate初次领证日期Date-

如:2019-10-2912:30:00)

10

DB32/T3826-2020

表16驾驶员基本信息接口传入参数说明表（续）

参数名称参数含义数据类型长度备注

必填:yyyy-MM-ddHH:mm:ss(例

changeIssueDate换证日期Date如:2019-10-2912:30:00)，未换证

填写除此领证日期

employmentNature用工性质Number-必填，详情见附录B.12

iffulltime是否专职Number-0：非专职，1：专职

phoneNum联系方式StringV50必填

7.6.3接口返回参数说明

驾驶员基本信息接口返回参数说明如表17所示。

表17驾驶员基本信息接口返回参数说明表

参数名称参数含义类型长度说明

result返回结果StringV50操作成功：success；失败返回：fail

resultCode返回码Number-自定义返回码

message返回信息StringV50具体描述

7.7派车信息接口

7.7.1接口描述

派车信息接口描述如表18所示。

表18派车信息接口描述表

接口名称派车信息接口（api/editCarSend）

通信承载协议HTTPPOST

提供者上级平台

主要使用者下级平台

7.7.2接口传入参数说明

派车信息接口传入参数说明如表19所示。

表19派车信息接口传入参数说明表

参数名称参数含义数据类型长度备注

regionCode区域编码StringV50必填，如：南京：320100

必填，各子平台自动推送，同一平

carSendId派车单号StringV50

台下不能重复

必填，各子平台自动推送，同一平

applyId申请单号StringV50

台下不能重复

carNo车牌号码String