DB32 T 3826-2020 公务用车信息化平台数据交换技术规范.pdf
《DB32 T 3826-2020 公务用车信息化平台数据交换技术规范.pdf》由会员分享,可在线阅读,更多相关《DB32 T 3826-2020 公务用车信息化平台数据交换技术规范.pdf(30页珍藏版)》请在麦多课文档分享上搜索。
1、ICS 35.240.99 L 76 DB32 江苏省 地 方 标 准 DB 32/T 3826-2020 公务用车信息化平台数据交换技术规范 Data interchange specification in official vehicle information platform 2020 - 07 - 14 发布 2020 - 08 - 14 实施 江苏省市场监督管理局 发布 DB32/T 3826-2020 I 目 次 前言 . III 1 范围 . 1 2 规范性引用文件 . 1 3 术语和定义 . 1 4 缩略语 . 2 5 数据交换信息内容 . 2 5.1 基础数据 . 2 5
2、.2 定位数据 . 2 6 数据交换形式与要求 . 2 6.1 接口要求 . 2 6.2 数据传输加密 . 3 6.3 基础数据交换 . 3 6.4 定位数据交换 . 3 7 基础信息交换接口说明 . 4 7.1 状态码定义 . 4 7.2 登录接口 . 4 7.3 单位基本信息接口 . 6 7.4 单车基本信息接口 . 7 7.5 超标准配备车辆信息接口 . 9 7.6 驾驶员基本信息接口 . 10 7.7 派车信息接口 . 11 7.8 车辆维保信息接口 . 13 7.9 车辆年检信息接口 . 14 7.10 车辆能耗信息接口 . 14 7.11 车辆保险费用信息接口 . 15 7.12
3、车辆过路过桥费用信息接口 . 16 7.13 车辆停车费用信息接口 . 17 7.14 车辆其他费用信息接口 . 18 7.15 监督检查情况信息接口 . 19 7.16 12345 投诉信息接口 . 20 7.17 社会车辆租赁派车信息接口 . 21 7.18 车辆违章情况信息接口 . 22 7.19 车辆处置情况信息接口 . 23 附录 A(规范性附录) 接口反馈内容 . 25 DB32/T 3826-2020 II 附录 B(规范性附录) 数据字典规范 . 26 DB32/T 3826-2020 III 前 言 本标准按照 GB/T 1.1-2009给出的规则编写。 本标准由江苏省机关事
4、务管理局提出并归口。 本标准起草单位:江苏省机关事务管理局、 中电鸿信信息科技有限公司 。 本标准主要起草人:徐华明、左晓刚、李角榆、白金龙、罗 星、伍 薇、陶思蓉、顾新贤、李声 祥、左 军、司奉彦。 DB32/T 3826-2020 1 公务用车信息化平台数据交换技术规范 1 范围 本标准规定了公务用车信息化平台数据交换的术语和定义、缩略语、数据交换内容、交换形式和要 求以及基础信息 交换接口说明。 本标准适用于公务用车信息化平台数据交换。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅所注日期的版本适用于本文 件。凡是不注日期的引用文件,其最新版本(包括
5、所有的修改单)适用于本文件。 GB/T 2260 中华人民共和国行政区划代码 JT/T 808-2013 道路运输车辆卫星定位系统 北斗兼容车载终端通讯协议技术规范 3 术语和定义 下列术语和定义适用于本文件。 3.1 数据交换 data interchange 在不同系统和设备间进行的数据传输与处理的过程。 3.2 电子数据交换 electronic data interchange(EDI) 采用标准格式,利用计算机网络进行业务数据的传输与处理。 GB/T 18354-2006,定义 5.22 3.3 上级平台 superior platform 接收数据平台 。 3.4 下级平台 inf
6、erior platform 发送数据平台。 3.5 车牌号 number plate 公安交通管理部门颁发的机动车车牌管理号码 , 不包括车辆牌照的颜色 。 例 : 苏 AJ3030。 DB32/T 3826-2020 2 4 缩略语 下列缩略语适用于本文件。 JSON JS对象标记( Java Script Object Notation) UTF-8 针对 Unicode的可变长度字符编码( 8-bit Unicode Transformation Format); HTTP 超文本传输协议 (HyperText Transfer Protocol) POST 是 HTTP协议中的一个重
7、要组成部分。 POST方法一般用来向目的服务器发出更新请求,并附 有请求实体向指定的资源提交要被处理的数据 ( Power On Self Test) UDP 用户数据报协议 (User Datagram Protocol) 5 数据交换信息内容 5.1 基础数据 5.1.1 下级平台交换的基础数据内容应包括: 单位基本信息; 单车基本信息; 超标准配备 车辆信息; 驾驶员基本信息; 派车信息; 车辆维保信息; 车辆年检信息; 车辆能耗信息; 车辆保险费用信息; 车辆过路过桥费用信息; 车辆停车费用信息; 车辆其他费用信息; 监督检查情况信息; 12345 投诉信息; 社会车辆租赁派车信息;
8、车辆违章情况信息 车辆处置情况信息 5.1.2 各类基础数据的详细字段要求见第 7 章。 5.2 定位数据 交换的车辆定位数据内容应包含报警标志、状态、经度、纬度、高程、速度、方向、定位时间、里 程等信息,详细交换内容应满足 JT/T 808-2013中 8.18节的要求。 6 数据交换形式与要求 6.1 接口要 求 6.1.1 下级平台基础数据发生变化、定位终端上报定位数据时,均应实时传输到数据交换平台。 DB32/T 3826-2020 3 6.1.2 在调用基础信息交换接口推送数据时,若接口返回错误,则需要根据返回的状态码 /描述重新调 用接口实现数据重发。 6.1.3 在调用基础信息交
9、换接口推送数据时,若等待 10 秒接口无响应,需要重新调用接口重传该条数 据。 6.1.4 若数据交换过程中出现网络 /接口中断情况,需要在网络 /接口恢复正常后补传中断时间内所有 基础数据及定位数据。 6.2 数据传输加密 6.2.1 公务用车终端应采用支持 SM3 算法的 国密级芯片对用车数据进行加密后上传至各级公务用车平 台,平台接收数据后进行解密存 储。 6.2.2 公务用车基础数据及定位数据进行平台间数据传输时,下级平台应对公务用车数据使用 国密 SM3 算法进行数据加密后上传至上级平台 , 上级平台接收数据后进行解密存储 。 6.3 基础数据交换 6.3.1 数据交换方式应采用 w
10、eb 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 定位数据传输协
11、议符合 JT/T 808-2013 中的注册、鉴权、位置信息汇报、终端通用应答、平台 通用应答协议部分的要求,数据格式见表 1,主要包括如下内容: a) 终端注册:下级平台往上级平台发送车辆定位数据前,下级平台的车载定位终端在未注册状态 下,应首先进行注册,注册成功后下级平台将获得上级平台的鉴权码并进行保存; b) 终端鉴权:下级平台收到上级平台反馈的注册成功信息后,应立 即进行鉴权。鉴权成功前下级 平台不得上报车载定位终端的其它消息。上级平台收到终端鉴权信息后回复下级平台通用应答 消息; c) 位置信息汇报:下级平台应向上级平台实时发送位置信息汇报消息; d) 终端通用应答; e) 平台通用
12、应答。 表 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-2020 4 7 基础信息交换接口说明 7.1 状态码定义 接口状态码定义对照表如表 2所示。 表 2 接口状态码定义对照表 序号 应答 /错误代码 应答 /错误描述 1
13、 100 成功 2 102 失败 3 103 推送的 JSON格式错误 4 104 数据验证错误 5 105 异常错误 6 106 所属部门不存在 7 107 车辆类型不存在 8 108 车牌号不存在 9 109 驾驶员不存在 10 110 租赁公司不存在 11 111 区域编码不 存在 12 112 用户名或者密码不对 7.2 登录接口 7.2.1 接口描述 登录接口描述见表 3。 表 3 登录接口描述表 接口名称 登录接口( api/login) 通信承载协议 HTTP POST 提供者 上级平台 主要使用者 下级平台 7.2.2 接口传入参数说明 登录接口传入参数说明见表 4。 表 4
14、登录接口传入参数说明表 参数名称 参数含义 数据类型 长度 备注 userName 用户名称 String V50 必填,省平台统一编码 ,统一为行政区域编码 ,按照 GB/T 2260相关要求执行, 如南京市级平台 : 320100 userPass 用户密码 String V50 必填,省平台统一编码 7.2.3 接口传入参数格式 DB32/T 3826-2020 5 第 7章各类接口传入参数格式如下所示,各个参数名称和排列顺序应与传入参数说明表中参数名称 和排列顺序保持一致,接口传入参数格式如下所示(第 7章各类接口传入参数格式按照以下格式编写): Info: 参数名称 1:数值 , 参
15、数名称 2:数值 , 参数名称 3:数值 , 参数名称 n:数值 示例: Info: userName:320100, /320100: 用户名称 userPass:123456 /123456: 用户密码 7.2.4 接口返回参数说明 登录接口返回参数说明见表 5。 表 5 登录接口返回参数说明表 参数名称 参数含义 类型 长度 说明 result 返回结果 String V50 操作成功: success;失败返回: fail resultCode 返回码 Number - 自定义返回码 token 返回令牌 String V50 访问后续接口的令牌,请求后续接口需要放到请求头里 mess
16、age 返回信息 String V50 具体描述 7.2.5 接口返回参数格式 各个参数名称和排列顺序应与返回参数说明表中参数名称和排列顺序保持一致,接口返回参数格式 如下所示(第 8章各类接口返回参数格式按照以下格式编写): 参数名称 1:数值 , 参数名称 2:数值 , 参数名称 3:数值 , 参数名称 n:数值 示例: result:success, resultCode:100, DB32/T 3826-2020 6 token:eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJmaGdqIiwiYXV0aCI6InVzZXJJZC1mY2YzZWIxOC1iYzQ1LT
17、Q4NGQtOG E5Z S1jZjkxZjM1OGJlMzciLCJ1c2VyRGF0YSI6eyJjb21wYW55SWQiOiJhZWIyZjllMi1jYmExLTQ3NTMtYmNjNy1mOTFjYTEyOGFk ZWIiLCJ1c2VySWQiOiIxMDM5NjNiMi03ZmRmLTRiZGMtYTllNS04YzQzNmViMjM3YzgifX0.bXNFb8RcYD_oLG3Yl9bbnWQ3h23 04JqIXurDAJG8jDvDKx3STIeA5NjaOLY9ZA1XW6PnwTBrYq9WZcZRvQwN5A, message:登录成功 7.3 单位基本信息接口
18、7.3.1 接口描述 单位基本信息接口描述如表 6所示。 表 6 单位基本信息接口描述表 接口名称 单位基本信息接口( api/editGroup) 通信承载协议 HTTP POST 提供者 上级平台 主要使用者 下级平台 7.3.2 接口传入参数说明 单位基本信息接口传入参数说明如表 7所示。 表 7 单位基本信息接口传入参数说明表 参数名称 参数含义 数据类型 长度 备注 regionCode 区域编码 String V50 必填,如:南京: 320100 groupName 单位名 称 String V50 必填,单位名称全称 superGroup 上级 直属 单位名称 String V
19、50 必填,无上级直属单位的情况,为 NULL socialCreditCode 统一社会信用代码 String V50 必填, 18 位阿拉伯数字 /英文;如果没有,填无 structureNature 机构性质 Number - 必填,详情见附录 B.1 structureLevel 机构级别 Number - 必填,详情见附录 B.2 groupAddress 单位地址 String V100 必填 groupOrganizationNumber 单位编制人数 Number - 必填 ,大于等于 0 groupFactNumber 单位编内实有人数 Number - 必填 ,大于等于 0
20、 groupOtherNumber 单位编外实有人数 Number - 必填 ,大于等于 0 organizationCarNumber 编制车辆数 (辆 ) Number - 必填 ,大于等于 0,经公务用 车主管部门核定的编制车辆 数;事业单位为保留车辆数; 车辆产权不在本单位的,填 0. factCarNumber 实有车辆数 (辆 ) Number - 必填 ,大于等于 0 purchaseEquipmentCarNumber 全年购置车辆数 (辆 ) Number - 必填 ,大于等于 0 updateEquipmentCarNumber 全年更新车辆数 (辆 ) Number -
- 1.请仔细阅读文档,确保文档完整性,对于不预览、不比对内容而直接下载带来的问题本站不予受理。
- 2.下载的文档,不会出现我们的网址水印。
- 3、该文档所得收入(下载+内容+预览)归上传者、原创作者;如果您是本文档原作者,请点此认领!既往收益都归您。
下载文档到电脑,查找使用更方便
5000 积分 0人已下载
下载 | 加入VIP,交流精品资源 |
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB32 3826-2020 公务用车信息化平台数据交换技术规范 3826 2020 公务用车 信息化 平台 数据 交换 技术规范
