《辽宁省新能源汽车监管平台与车辆企业平台数据对接说明书(DOC 30页)》由会员分享，可在线阅读，更多相关《辽宁省新能源汽车监管平台与车辆企业平台数据对接说明书(DOC 30页)（31页珍藏版）》请在金锄头文库上搜索。
1、辽宁省新能源汽车监管平台与车辆企业平台数据对接说明书文档修改控制序号版本内容描述日期作者11新建2020/07/28李亚敏27目录目录iii一、概述11.1对接地址11.2企业对接流程11.3车辆数据上传标准31.3.1车辆静态数据31.3.2车辆电池数据31.3.3车辆实时数据31.3.4接口分类3二、企业注册流程4三、企业平台联调流程53.1 车型注册83.2 车辆数据测试83.3 实时信息测试8四、车型联调流程144.1 车型注册154.2 车型联调16五、车辆静态数据接口195.1 header 请求参数195.2 body 请求参数195.3 响应参数225.4 状态码对应表225.
2、5 加密方式235.5.1 公钥235.5.2 加密及签名规则235.6 示例23六、车辆电池数据接口246.1 header 请求参数256.2 body 请求参数256.3 示例266.3.1 数据结构26一、 概述新能源汽车公共数据平台系统是通过，车企平台将车辆数据上传到平台，以达到监管新能源汽车行驶和充电行为，并建立相关大数据平台的目的。企业将数据对接到新能源汽车公共数据平台，需要遵循一定的流程和标准。流程包括：企业注册流程、平台联调流程、车型接入流程。标准包括：车辆静态数据接口标准、车辆电池数据接口标准和国标GBT 32960.3-2016 标准。1.1 对接地址平台联调测试环境对接
3、地址：:8101平台正式生产环境对接地址：:323331.2 企业对接流程车企对接平台须首先进行企业注册和一次平台联调。企业每接入一种新车型之前，必须进行车型接入测试。总流程如下：1.3 车辆数据上传标准企业上传的车辆数据包含3种类型:车辆静态数据、车辆电池数据和车辆实时数据。1.3.1 车辆静态数据车辆静态数据即车辆vin号、车辆型号、iccid号、车牌号等车辆静态信息，只需上传一次。具体流程见下文车辆静态数据上传接口。1.3.2 车辆电池数据车辆电池数据即车辆电池编码、电芯编码、电池包生产企业、电池包额定电压等电池相关信息，只需上传一次。具体流程见下文车辆电池数据上传接口。1.3.3 车辆
4、实时数据车辆的实时数据：即国标GB/T 32960.3-2016，中所定义的实时信息上报数据。包括：整车数据、驱动电机数据、燃料电池数据、发动机数据、车辆位置数据、极值数据、报警数据，等七大部分。1.3.4 接口分类车辆静态数据和电池数据的接口采用RESTful API 方式定义接口，采用RSA 加密算法，对数据进行加密。通过数据签名保证数据的完整性。车辆实时数据采用TCP 方式，按照国标GB/T 32960.3-2016标准所定义的通讯协议和数据格式，上传实时数据到监控平台。二、 企业注册流程车企在使用监控平台前，需要先注册用户，再完成企业资料的申请审核流程，才可以正式登陆监控平台。企业注册
5、流程分为以下几个步骤：1、 使用浏览器打开监控平台网站，网址：2、 填写用户注册信息3、 填写企业资料信息4、 填写车企平台运营商信息5、 车企提交信息等待审核6、 如审核失败需要重新填写相关信息，并提交再次审核7、 审核通过后，企业需线下和监控平台签署协议。8、 协议签署完成后，企业平台完成整个注册流程9、 企业在监控平台注册信息审核通过后，会收到监控平台发送的动态数据接入的平台登录用户名及密码的邮件流程图如下：三、 企业平台联调流程企业注册成功，首先必须申请进行平台联调。平台联调是为了验证企业平台，是否正确理解了监控平台的接入要求，是否满足国标GBT 32960.3-2016的技术要求，是
6、否具备基本的平台对接能力。每个企业必须首先通过平台联调，才可以开展后续接入真实车辆的工作。平台联调只须完成一次。平台联调分为三个子流程：车型注册审核、车辆数据测试、实时信息测试。平台联调流程如下：3.1 车型注册车企预约平台过检后，监控平台会自动生成测试车型，在此阶段企业只需填入虚拟的车型信息，不要求真实。车企车型注册字段定义。填写完成后提交管理平台审核。平台审核通过后，进入车辆数据测试步骤。平台审核失败后，需要重新开始新的平台联调申请。3.2 车辆数据测试在此阶段企业调用上传车辆数据的接口，将车辆的静态数据上传到平台上。需要上传车辆的数据。上传成功后，线下通知管理平台人员进行审核。平台审核通
7、过后，进入平台测试步骤。平台审核失败后，需要重新开始新的平台联调申请。3.3 实时信息测试3.3.1 实时信息测试说明实时信息测试的目的，是模拟真实情况下企业向平台发送的消息是否符合要求。实时信息测试项目包括：1、 平台登录登出验证（1） 企业平台发送登录报文，成功在监控平台完成登入操作（2） 企业平台发送登出报文，在监控平台完成登出操作（3） 多次登入时，流水号递增（4） 同一次登录登出流水号一致2、 车辆登录登出验证(1) 转发车辆登录登出报文(2) 多次登入时，流水号递增(3) 同一次登录登出流水号一致(4) 车辆登录流水号每天清零3、 车辆行驶数据验证（1） 转发车辆行驶状态下实时数据
8、（2） 车辆实时数据不应出现违反国家标准或超出合理范围的数据（3） 车辆实时数据要符合实车数据状态（4） 监控平台与企业进行数据核对4、 车辆充电数据验证（1） 转发车辆充电状态下实时数据（2） 车辆实时数据不应出现违反国家标准或超出合理范围的数据（3） 车辆实时数据要符合实车数据状态（4） 监控平台与企业进行数据核对5、 车辆满电数据验证（1） 转发车辆soc100%状态下实时数据（2） 车辆实时数据不应出现违反国家标准或超出合理范围的数据（3） 车辆实时数据要符合实车数据状态（4） 监控平台与企业进行数据核对6、 车辆报警数据验证（1） 触发车辆报警，并转发车辆报警状态下实时数据（2） 需
9、测试国标19项报警（3） 报警数据满足前后30s数据1秒1条上报（4） 监控平台与企业进行数据核对7、 车辆补发数据验证（1） 转发车辆补发数据（2） 车辆实时数据不应出现违反国家标准或超出合理范围的数据（3） 车辆实时数据要符合实车数据状态（4） 监控平台与企业进行数据核对8、 平台补发数据验证（1） 使企业平台与监控平台断开链接，恢复链接后平台补发车辆实时数据（2） 车辆实时数据不应出现违反国家标准或超出合理范围的数据（3） 车辆实时数据要符合实车数据状态（4） 监控平台与企业进行数据核对3.3.2 实时信息测试步骤平台实时信息测试步骤：1、 执行平台登入、平台登出操作，共计5个循环a)
10、平台登入登出之间要保持3分钟车辆数据传输2、 执行车辆登入、车辆登出操作，共计5个循环a) 车辆登入登出之间要保持3分钟车辆数据传输3、 发送车辆行驶数据，车辆行驶数据维持发送15分钟以上4、 发送车辆充电数据，车辆充电数据维持发送15分钟以上5、 发送车辆满电数据，车辆满电数据维持发送5分钟以上6、 发送车辆报警数据a) 需逐个触发车辆19项报警数据b) 每项报警需维持2分钟7、 发送车辆补发数据，车辆补发数据维持发送15分钟8、 发送平台补发数据，平台补发数据维持发送10分钟9、 填写车辆联调记录表，文档如下10、 将车辆联调记录表及车企平台日志文件以线下的方式提供到监控平台11、 监控平
11、台审核车企数据，审核结果会以邮件方式提供给车企a) 测试仅提供结果、错误步骤，不提供错误细节及技术指导，望车企知悉b) 检测完成后，应第一时间主动提供测试记录表及服务器日志，日志内容应包括服务器发送时间，报文时间，国标报文及vin整体测试流程图如下：四、 车型联调流程企业在通过平台联调后，即可申请进行，正式车型接入的测试。车型接入测试是为了验证，企业接入车型的车辆上报数据，是否满足监控平台的要求。车型接入分为两个子流程：车型注册、车型联调。车型联调流程图如下：4.1 车型注册在此阶段企业必须填入真实的车型信息。填写完成后提交管理平台审核。平台审核通过后，进入接入测试步骤。平台审核失败后，需要重
12、新开始新的车型注册申请。4.2 车型联调企业注册车型通过审核后，即可默认添加进车型联调批次。车型联调时需准备一台实车，并将车辆静态信息和电池信息通过接口上传到监控平台。车型联调步骤：1、 执行平台登入2、 执行车辆登入、车辆登出操作，共计5个循环a) 车辆登入登出之间要保持3分钟车辆数据传输3、 发送车辆行驶数据，车辆行驶数据维持发送15分钟以上4、 发送车辆充电数据，车辆充电数据维持发送15分钟以上5、 发送车辆满电数据，车辆满电数据维持发送5分钟以上6、 发送车辆报警数据a) 需逐个触发车辆19项报警数据b) 每项报警需维持2分钟7、 发送车辆补发数据，车辆补发数据维持发送15分钟8、 执
13、行平台登出9、 填写车辆联调记录表，文档如下10、 将车辆联调记录表及车企平台日志文件以线下的方式提供到监控平台11、 监控平台审核车企数据，审核结果会以邮件方式提供给车企a) 测试仅提供结果、错误步骤，不提供错误细节及技术指导，望车企知悉b) 检测完成后，应第一时间主动提供测试记录表及服务器日志，日志内容应包括服务器发送时间，报文时间，国标报文及vin车型联调流程图如下：五、 车辆静态数据接口企业平台在上传车辆的实时数据之前，必须将车辆相关的基本信息，通过该接口上传到监控平台。规范用于指导车企平台合理调用该接口上传车辆静态相关数据。l 请求方式：http postl 接口组成：由服务URL、
14、请求参数和车辆数据组成。其中请求参数放在http 的header 部分。车辆数据放在http 的body 部分。l 响应参数：json服务URL：5.1 header 请求参数参数名参数类型必须默认值描述appKeyStringY平台登入用户名secretStringYRSA取值范围:RSA（RSA 加密）,NA（不加密）signtlongY调用接口时间戳,精确到毫秒signStringY签名accessTypeStringY接入类型类型，正式：1，测试：05.2 body 请求参数由车辆注册数据字段构成的json 数组。车辆注册数据字段说明如下：序号属性类型是否必填备注（取值说明等）1vehicleRecordModel StringY车型型号（备案车型型号）2vinStringY车架号（17位）3iccidStringY4
