《辽宁省新能源汽车监管平台与车辆企业平台数据对接说明书.docx》由会员分享，可在线阅读，更多相关《辽宁省新能源汽车监管平台与车辆企业平台数据对接说明书.docx（33页珍藏版）》请在课桌文档上搜索。
1、辽宁省新能源汽车监管平台与车辆企业平台数据对接说明书文档修改控制序号版本内容描述日期作者11新建2020/07/28李亚敏目录目录Hi一、 概述11.1 对接地址11.2 企业对接流程11.3 车辆数据上传标准31.3.1 车辆静态数据31.3.2 车辆电池数据31.3.3 车辆实时数据31.3.4 接口分类3二、 企业注册流程4三、 企业平台联调流程53.1 车型注册73.2 车辆数据测试83.3 实时信息测试8四、 车型联调流程144.1 车型注册154.2 车型联调16五、 车辆静态数据接口195.1 header请求参数195.2 body请求参数195.3 响应参数225.4 状态码
2、对应表225.5 加密方式225.5.1 公钥235.5.2 加密及签名规则235.6 示例23六、 车辆电池数据接口246.1 header请求参数256.2body请求参数256.3示例266.3.1数据结构26一、概述新能源汽车公共数据平台系统是通过，车企平台将车辆数据上传到平台，以达到监管新能源汽车行驶和充电行为，并建立相关大数据平台的目的。企业将数据对接到新能源汽车公共数据平台，需要遵循一定的流程和标准。流程包括：企业注册流程、平台联调流程、车型接入流程。标准包括：车辆静态数据接口标准、车辆电池数据接口标准和国标GBT32960.3-2016标准。1.1 对接地址平台联调测试环境对接
3、地址：gateway.I:8101平台正式生产环境对接地址：gateway.I:323331.2 企业对接流程车企对接平台须首先进行企业注册和一次平台联调。企业每接入一种新车型之前，必须进行车型接入测试。总流程如下:企业对接流程车企监控平台is打开网站在线填写车企注册信息T市核试:审核未通过段上审核线下签署平台接入协议填写预约平台联调信息平台联调在姣填写车型注册信息,提交审核通运审核未通过提交审核未通过提交-il-线上审核线上审核线上审核T审核通过上传正式车辆辞态数据上传正式车辆电池数据接入车辆实时数据车型改为正式车型1.3 车辆数据上传标准企业上传的车辆数据包含3种类型:车辆静态数据、车辆电
4、池数据和车辆实时数据。13.1 车辆静态数据车辆静态数据即车辆Vin号、车辆型号、iccid号、车牌号等车辆静态信息，只需上传一次。具体流程见下文车辆静态数据上传接口。13.2 车辆电池数据车辆电池数据即车辆电池编码、电芯编码、电池包生产企业、电池包额定电压等电池相关信息，只需上传一次。具体流程见下文车辆电池数据上传接口。13.3 车辆实时数据车辆的实时数据：即国标GB/T32960.3-2016，中所定义的实时信息上报数据。包括：整车数据、驱动电机数据、燃料电池数据、发动机数据、车辆位置数据、极值数据、报警数据，等七大部分。134接口分类车辆静态数据和电池数据的接口采用RESTfUlAPI方
5、式定义接口,采用RSA加密算法，对数据进行加密。通过数据签名保证数据的完整性。车辆实时数据采用TCP方式，按照国标GB/T32960.3-2016标准所定义的通讯协议和数据格式，上传实时数据到监控平台。二、企业注册流程车企在使用监控平台前，需要先注册用户，再完成企业资料的申请审核流程，才可以正式登陆监控平台。企业注册流程分为以下几个步骤：1、 使用浏览器打开监控平台网站，网址：2、 填写用户注册信息3、 填写企业资料信息4、 填写车企平台运营商信息5、 车企提交信息等待审核6、 如审核失败需要重新填写相关信息，并提交再次审核7、 审核通过后，企业需线下和监控平台签署协议。8、 协议签署完成后，
6、企业平台完成整个注册流程9、 企业在监控平台注册信息审核通过后，会收到监控平台发送的动态数据接入的平台登录用户名及密码的邮件流程图如下：企业注册流程车企监控平台打开企业注册页面在线查看接入协议三、企业平台联调流程企业注册成功，首先必须申请进行平台联调。平台联调是为了验证企业平台，是否正确理解了监控平台的接入要求，是否满足国标GBT32960.3-2016的技术要求，是否具备基本的平台对接能力。每个企业必须首先通过平台联调，才可以开展后续接入真实车辆的工作。平台联调只须完成一次。平台联调分为三个子流程：车型注册审核、车辆数据测试、实时信息测试。平台联调流程如下：平台联调流程车企监控平台平台生成测
7、试车型，审核通逆审核未通过实时信息测试提交一，审核通过3.1 车型注册车企预约平台过检后，监控平台会自动生成测试车型，在此阶段企业只需填入虚拟的车型信息，不要求真实。车企车型注册字段定义。填写完成后提交管理平台审核。平台审核通过后，进入车辆数据测试步骤。平台审核失败后，需要重新开始新的平台联调申请。3.2 车辆数据测试在此阶段企业调用上传车辆数据的接口，将车辆的静态数据上传到平台上。需要上传车辆的数据。上传成功后，线下通知管理平台人员进行审核。平台审核通过后，进入平台测试步骤。平台审核失败后，需要重新开始新的平台联调申请。3.3 实时信息测试3.3.1 实时信息测试说明实时信息测试的目的，是模
8、拟真实情况下企业向平台发送的消息是否符合要求。实时信息测试项目包括：1、 平台登录登出验证(1)企业平台发送登录报文，成功在监控平台完成登入操作(2)企业平台发送登出报文，在监控平台完成登出操作(3)多次登入时，流水号递增(4)同一次登录登出流水号一致2、 车辆登录登出验证(1)转发车辆登录登出报文(2)多次登入时，流水号递增(3)同一次登录登出流水号一致(4)车辆登录流水号每天清零3、 车辆行驶数据验证(1)转发车辆行驶状态下实时数据(2)车辆实时数据不应出现违反国家标准或超出合理范围的数据(3)车辆实时数据要符合实车数据状态(4)监控平台与企业进行数据核对4、 车辆充电数据验证(1)转发车
9、辆充电状态下实时数据(2)车辆实时数据不应出现违反国家标准或超出合理范围的数据(3)车辆实时数据要符合实车数据状态(4)监控平台与企业进行数据核对5、 车辆满电数据验证(1)转发车辆SOClo0%状态下实时数据(2)车辆实时数据不应出现违反国家标准或超出合理范围的数据(3)车辆实时数据要符合实车数据状态（4）监控平台与企业进行数据核对6、 车辆报警数据验证（1）触发车辆报警，并转发车辆报警状态下实时数据（2）需测试国标19项报警（3）报警数据满足前后30s数据1秒1条上报（4）监控平台与企业进行数据核对7、 车辆补发数据验证（1）转发车辆补发数据（2）车辆实时数据不应出现违反国家标准或超出合理
10、范围的数据（3）车辆实时数据要符合实车数据状态（4）监控平台与企业进行数据核对8、 平台补发数据验证（1）使企业平台与监控平台断开链接，恢复链接后平台补发车辆实时数据（2）车辆实时数据不应出现违反国家标准或超出合理范围的数据（3）车辆实时数据要符合实车数据状态（4）监控平台与企业进行数据核对3.3.2 实时信息测试步骤平台实时信息测试步骤:1、 执行平台登入、平台登出操作，共计5个循环a）平台登入登出之间要保持3分钟车辆数据传输2、 执行车辆登入、车辆登出操作，共计5个循环a）车辆登入登出之间要保持3分钟车辆数据传输3、 发送车辆行驶数据，车辆行驶数据维持发送15分钟以上4、 发送车辆充电数据
11、，车辆充电数据维持发送15分钟以上5、 发送车辆满电数据，车辆满电数据维持发送5分钟以上6、 发送车辆报警数据a）需逐个触发车辆19项报警数据b）每项报警需维持2分钟7、 发送车辆补发数据，车辆补发数据维持发送15分钟8、 发送平台补发数据，平台补发数据维持发送10分钟9、 填写车辆联调记录表，文档如下QXXX公司实时信息测试步骤时间记录10、将车辆联调记录表及车企平台日志文件以线下的方式提供到监控平台11、监控平台审核车企数据，审核结果会以邮件方式提供给车企a）测试仅提供结果、错误步骤，不提供错误细节及技术指导，望车企知悉b）检测完成后，应第一时间主动提供测试记录表及服务器日志,日志内容应包
12、括服务器发送时间，报文时间，国标报文及Vin整体测试流程图如下:测试开始邮件发送审核未通过审核通过-测试结束联招四、车型联调流程企业在通过平台联调后，即可申请进行，正式车型接入的测试。车型接入测试是为了验证，企业接入车型的车辆上报数据，是否满足监控平台的要求。车型接入分为两个子流程：车型注册、车型联调。车型联调流程图如下：录入车辆静态数据录入车辆电池数据T审核通过4.1 车型注册在此阶段企业必须填入真实的车型信息。填写完成后提交管理平台审核。平台审核通过后，进入接入测试步骤。平台审核失败后，需要重新开始新的车型注册申请。4.2 车型联调企业注册车型通过审核后，即可默认添加进车型联调批次。车型联
13、调时需准备一台实车，并将车辆静态信息和电池信息通过接口上传到监控平台。车型联调步骤：1、 执行平台登入2、 执行车辆登入、车辆登出操作，共计5个循环a）车辆登入登出之间要保持3分钟车辆数据传输3、 发送车辆行驶数据，车辆行驶数据维持发送15分钟以上4、 发送车辆充电数据，车辆充电数据维持发送15分钟以上5、 发送车辆满电数据，车辆满电数据维持发送5分钟以上6、 发送车辆报警数据a）需逐个触发车辆19项报警数据b）每项报警需维持2分钟7、 发送车辆补发数据，车辆补发数据维持发送15分钟8、 执行平台登出9、 填写车辆联调记录表，文档如下CXXX公司车型联调测试步骤时间记录10、将车辆联调记录表及
14、车企平台日志文件以线下的方式提供到监控平台IK监控平台审核车企数据，审核结果会以邮件方式提供给车企a）测试仅提供结果、错误步骤，不提供错误细节及技术指导，望车企知悉b）检测完成后，应第一时间主动提供测试记录表及服务器日志,日志内容应包括服务器发送时间，报文时间，国标报文及Vin车型联调流程图如下：车型联调测试流程测试开始%ID-J、S石栋帐坯邮件发送审核未通过五、车辆静态数据接口企业平台在上传车辆的实时数据之前，必须将车辆相关的基本信息，通过该接口上传到监控平台。规范用于指导车企平台合理调用该接口上传车辆静态相关数据。请求方式：httppost接口组成：由服务URL、请求参数和车辆数据组成。其
15、中请求参数放在http的header部分。车辆数据放在http的body部分。响应参数：json服务URL：5.1header请求参数参数名参数类型必须默认值描述appKeyStringY平台登入用户名secretStringYRS取值范围：RSA（RSA加密）,NA（不加密）signtlongY调用接口时间戳，精确到亳秒signStringY签名accessTypeStringY接入类型类型，正式：1,测试：05.2body请求参数由车辆注册数据字段构成的json数组。车辆注册数据字段说明如下：序号属性类型是否必填备注（取值说明等）1vehicleRecordMode1StringY车型型号
16、（备案车型型号）2vinStringY车架号（17位）3iccidStringY4VehiclellseStringY车辆用途公交客车-111801通勤客车-111802旅游客车-111803公路客车-111804公务乘用车-111805出租乘用车-111806租赁乘用车-111807私人乘用车-111808邮政特种车-111809物流特种车-111810环卫特种车-111811工程特种车-1118125ProductionDatelongY车辆生产日期6saleDatelongY销售日期7packCodeStringY可充电储能系统编码（多个逗号分隔）8PackProcDatelongY动力
17、蓄电池生产日期（多个逗号分隔）9motorModelStringY驱动电机序号（多个逗号分隔）10CngineNumberStringY发动机编号11tboxCodeStringY车载终端编号12accessDatelongY接入日期13accessTypeStringY接入类型（0：测试，1：正式）14firstOnlineDatelongY上线日期15lateNoStringY车牌号16OperatingUnitStringY运营单位17StorageLocationStringY存放地点18contactpersonStringY联系人19ContactNumberStringY联系电话
18、20CompanyUniqueStringY车企唯一标识21drivingLiCenseNumberStringY行驶证号22buyerCountyStringY购车人居住地所在区县23operatIonCorporateNajneStringY单位法人代表24OperationPhoneStringY法人代表手机25FegisteredPlaceStringY运营单位地址26actualPlaceStringY运营地址27ChargingPileAddrStringY对应车辆充电桩地址28tboxTypeStringY终端类型（0：tbox1：其他）29tboxCompanyStringY终
19、端厂商30areaCodeStringY上牌区域注：.productionDateSaIeDatepackProcDateaccessDatefirstOnlineDate赋值为String型如：yyyy-MM-dd二.车企唯一标识规则建议：车企所在城市邮编+VIN前三位+2位序号+0000005.3响应参数参数名称参数类型是否必填参数描述statusStringY见状态码定义表errorCodeintNerrorMessageStringN5.4状态码对应表状态码返回信息含义200Ok服务器成功返回用户请求的数据201Created新建或修改数据成功400InvalidRequest请求参数
20、非法，服务器没有进行新建或修改数据的操作401Unauthorized用户授权错误（令牌、用户名、密码、签名错误）403Forbidden表示用户得到授权（与401错误相对），但是访问是被禁止的（未通过白名单）404NotFound发出的请求针对的记录不存在，服务器没有进行操作406NotAcceptable用户请求的格式不可得（比如用户请求XML格式,但是只有JSON格式）500InternalServerError服务器发生错误，客户端将发出的请求没有成功501NotImplemented服务器不支持客户端所请求功能5.5加密方式采用RSA加密方式加密。MIGfMA0GCSqGSIb3DQ
21、EBAQUAA4GNADCBiQKBgQCQJsYPa+wqnRqLjcDAXtYod0qAUD2ZXleeapQh6QUPIyL8+9iQZFAIBnQ5t3s0hQJiU9UR7Z4YNtnMb4ahwtqDsGUT7e6dsc8vU6BR8vdwMdXb0D0JjYS+ky5UDsbYLelDEdW1+kZZxIgOAdh6HmY920pm0qftZOEMoaBfKwIDAQAB5.5.2加密及签名规则1 .按顺序拼接输入参数得到字符串A。2 .对拼接的字符串A做MD5加密运算得到字符串B。3 .设置header中Sign参数值为该字符串B。4 .body参数加密。5 .6不例为描述方便
22、，假设有一个第三方车企： 国标协议平台登录用户名为：， 国标协议平台登录密码为：abcdefghIjklmnopqrstuvwxyz123456 调用接口APl时间戳为：421、按顺序拼接参数得到字符串：appKey=,secret=RSA,signt=42,secretKey=abcdefghiJklmnopqrstuvwxyz1234562、对拼接的字符串做MD5加密运算得到字符串为b8d90655abd3566al7Iaba7bd7eca273设置header中sign参数值为:b8d90655abd3566al71aba7b0d7eca274body参数加密假定车企想注册2辆车,得到j
23、son串为：iccid：，Virr:12356,vin:1235使用公钥将JSOnString进行RSA公钥加密，再将加密结果进行base64编码得到加密串，将得到加密密文放到body里传输,后台使用私钥解密，加密串为：wWLth8ZuifMdY15tymlpbVEX35S+LWovKEA13sqEIAQQDlJ296EiSKDuBIYky5BFj7R0bL8IZwWcDZnwUxanFNXPgrjDCWLwZqDMqTTY5yfGZ0sxk6npJq5K0WDG6522G0oVey28bWY0pXP61Pk9p7t0CmDDgJDGNXONWHTO二六、车辆电池数据接口规范用于指导车企平台合
24、理调用该接口上传电池相关数据。（注：车辆静态数据重新上传后，需要重新上传对应车辆的电池数据。）请求方式：httppost接口组成：由服务URL、请求参数和车辆数据组成。其中请求参数放在http的header部分。车辆数据放在http的body部分。响应参数：json服务URL：6.1header请求参数参数名参数类型必须默认值描述If-None-MatchStringY592d6db2-219accessNameStringY平台登入用户名accessCodeStringY平台登入密码accessTypeStringY接入类型类型，正式：L测试：OContent-TypeStringYappl
25、ication/json6.2body请求参数参数名参数类型必须默认值描述BatteryDataDTOListListY电池信息列表list,详细数据均放置在list中对应的元素中vinStringY车辆Vin码（17位）batteryTypeStringY电池类型1:磷酸铁锂电池/2:镒酸锂电池/3:钻酸锂电池/4:三元材料电池/5:聚合物锂离子电池/6:超级电容/7:钛酸锂电池/8:燃料电池/9:其他电池类型batIeryCodingStandardStringY电池编码标准1:国标/2:企业自己的标准batteryManufacturerStringY电池包生产企业PackVoltage
26、StringY电池包额定电压(V)PackCapacityStringY电池包额定容量(AH)PackCodeStringY电池包编码PackProcDateStringY电池包生产日期(yyyy-MM-dd)moduleVoltagcStringY电池模组额定电压(V)moduIeCapacityStringY电池模组额定容量(AH)batteryModuIeCodeStringY电池模组编码moduleManufacturerStringY模组生产企业cel!ManufacturerStringY电芯生产企业CellVoltageStringY电芯额定电压(V)CellCapacitySt
27、ringY电芯额定容量(AH)cellCodeStringY电芯编码6.3示例6.3.1数据结构Headers:If-None-Match：592d6db2-219accessName：exa7d3a2testaccessCode：exa5bd3f7f745499testaccessType：1Content-Type：application/json(,batteryDataDTOList*:,zvin,z:LLLLLLLLLLLLLLL”,“batteryType”:1,z,batteryCodingStandardz,:“1，z,batteryManufacturer,z:XXXX电池包
28、生产有限公司”,“packVoltagc:2,PackCapacity:1,“packCodc”:XXCOOX,PackProcDatezz:2017-07-26,/batteryModuleDataList/，:,moduIeVoltagezz:12,“moduleCapacity:10,modulcCode*:XXCOOz,moduIeManufacturerz,:xxxx电池模组生产有限公司”,zbatteryCelIDataListz:celIUanufacturer:XXX电芯生产企业”，celIVoltage:12.1”,z,celICapacityzz:10.2”,cel!Cod
29、e:XXXABC1”),(celIManufacturer:XXX电芯生产企业”，celIVoltage:12.1”,z,celICapacityzz:10.2”,cel!Code:XXXABC1”),(,moduIeVoItage*:“12,“moduleCapacity:10,modulcCode*:XXCOOz,moduIeManufacturerz,:xxxx电池模组生产有限公司”,zbatteryCelIDataListz:celIUanufacturer:XXX电芯生产企业”，celIVoltage:12.1”,z,celICapacityzz:10.2”,cel!Code:XXX
30、ABC1”),(celIManufacturer:XXX电芯生产企业”，celIVoltage:12.1”,z,celICapacityzz:10.2”,cel!Code:XXXABC1”),(vin:LLLLLLLLLLLLLLL”,“batteryType”:T,“batteryCodingStandard:1,batteryManufacturcr:XXXX电池包生产有限公司”，“packVoltage:2,PackCapacity:1,packCodezz:XXCOOX,PackProcDate:2017-07-26，,batteryModuleDataListz:,modulcVol
31、tagez:12”,moduleCapacity*:“10,“moduleCOde：XXCOOz,oduIeManufacturcr*:xxxx电池模组生产有限公司”,zbatteryCelIDataListw:(z,cel!Manufacturer:XXX电芯生产企业”，celIVoltage:12.1”,z,celICapacityz,:“10.2，cel!Code:XXXABC1”),(celIManufacturer:XXX电芯生产企业”，celIVoltage:12.1”,z,ceIlCapacityzz:“10.2，cel!Code:XXXABC),(z,cel!Manufactu
32、rer:XXX电芯生产企业”，celIVoltage:12.1”,z,celICapacityzz:10.2”,cel!Code:XXXABC1”),(celIManufacturer:XXX电芯生产企业”，celIVoltage:12.1”,yyCellCapacityzz:10.2”,cel!Code:XXXABC),(,moduleVoltage*:“12,“moduIcCapacity:10,modulcCode*:XXCOOz,moduIeManufacturer*:xxxx电池模组生产有限公司”,zbatteryCelIDataListz:(z,cel!Manufacturer:X
33、XX电芯生产企业”，celIVoltage:12.1”,z,celICapacityzz:10.2”,cel!Code:XXXABC1”*celIManufacturerzz:XXX电芯生产企业”,cellVoltage:12.1”,“cel!.Capacity:10.2”,cel!Code:XXXABC),(z,cel!Manufacturer:XXX电芯生产企业”,cel!Voltage:12.1”,“celICapacity:“10.2，cel!Code:XXXABC1”),(celIManufacturer:XXX电芯生产企业”,celIVoltage:12.1”,z,celICapacityzz:10.2”,cellCodez,:XXXABC1”)
