DB31∕T 1265-2020 电动汽车充换电设施公共数据 采集与监测规范_第1页
DB31∕T 1265-2020 电动汽车充换电设施公共数据 采集与监测规范_第2页
DB31∕T 1265-2020 电动汽车充换电设施公共数据 采集与监测规范_第3页
DB31∕T 1265-2020 电动汽车充换电设施公共数据 采集与监测规范_第4页
DB31∕T 1265-2020 电动汽车充换电设施公共数据 采集与监测规范_第5页
已阅读5页,还剩106页未读, 继续免费阅读

下载本文档

版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领

文档简介

ICS43.020CCST47电动汽车充换电设施公共数据采集与监测规范Specificationofpublicdatacollectionandmonitoringofelectricv上海市市场监督管理局IDB31/T1265—2020 V 12规范性引用文件 13术语和定义 14电动汽车充换电服务信息交换体系 24.1体系结构 24.2分层 34.3接口分类 35公共信息对象 45.1公共信息对象关系概述 45.2充电运营商信息 55.3充电站信息 55.4充电设备信息 95.5充电设备接口信息 5.6充电设备接口状态 5.7充电站状态 5.8充电站统计信息 5.9充电设备统计信息 5.10充电设备接口统计信息 135.11订单信息 5.12年检信息 5.13报警信息 5.14地锁信息 6业务流程 6.1概述 6.2运营商信息的备案与更新 6.3备案充换电设施信息 176.4设备状态同步流程 6.5站点统计数据上报 6.6收集充电站统计数据流程 196.7订单信息推送流程 6.8出租车充电相关信息采集 207接口 217.1概述 217.2充电站信息变化推送 217.3查询充电站信息 23ⅡDB31/T1265—20207.4设备状态变化推送 257.5设备接口状态查询 267.6统计信息上报 277.7查询统计信息 297.8订单信息推送 317.9推送充电状态 327.10推送充电订单信息 347.11推送订单结算信息 367.12查询订单结算信息 378数据传输与安全 398.1数据传输体系 398.2平台认证方式及规则 408.3数据传输方式及规则 418.4密钥的使用及管理 8.5参数签名规范 44附录A(规范性)分布式认证的认证接口规范 46A.1概述 46A.2接口定义 46A.3输人参数 46A.4返回值 46附录B(资料性)数字信封秘钥分发方式 48B.1数字信封的定义 48B.2数字信封的原理 48B.3密钥的更换 48附录C(资料性)数据加密解密方式 49C.1数据加解密方法 49C.2数据加解密示例 50参考文献 图1电动汽车充换电服务信息交换体系结构框架 3图2公共信息对象关系图 4图3备案充换电设施信息流程图 图4推送设备状态流程 图5站点统计数据上报流程 19图6收集充电站统计数据流程 20图8出租车充电相关信息采集流程 20图9电动汽车充换电设施公共数据采集与监测信息交换流程 39 40DB31/T1265—2020Ⅲ 41 50表1电动汽车充换电服务信息采集与交换接口列表 2表2充电运营商信息 5表3充电站信息 5表4充电设备信息 9表5充电设备接口信息 表6充电设备接口状态 表7充电站状态 表8充电站统计信息 表9充电设备统计信息 表10充电设备接口统计信息 表12年检信息 表14地锁信息 表15充电站信息变化推送接口输入参数 21表16充电站信息变化推送接口返回值 23表17查询充电站信息接口输入参数 23表18查询充电站信息接口返回值 24表19设备状态变化推送接口输入参数 25表20设备状态变化推送接口返回值 26表21设备接口状态查询输人参数 26表22设备接口状态查询返回值 27表23统计信息上报接口输入参数 28表24统计信息上报接口返回值 29表25查询统计信息接口输入参数 29表26查询统计信息接口返回值 表27订单信息推送接口输入参数 31表28订单信息推送接口返回值 32表29推送充电状态接口输入参数 33表30推送充电状态接口返回值 表31推送订单信息接口输入参数 35表32推送充电订单信息接口返回值 36表33推送订单结算信息接口输入参数 36表34推送订单结算信息接口返回值 37DB31/T1265—2020表35查询订单结算信息接口输人参数 38表36查询订单结算信息接口返回值 38表37消息主体内容表 42表38返回参数编码表 43表A.1认证接口输入参数 46表A.2认证接口返回值 46表C.1密钥及分组长度与轮数的关系 49DB31/T1265—2020V本文件按照GB/T1.1-2020《标准化工作导则第1部分:标准化文件的结构和起草规则》的规定请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由上海市交通委员会提出并组织实施。本文件由上海市交通委员会归口。本文件起草单位:上海电器科学研究所(集团)有限公司。DB31/T1265—20201采集与监测规范本文件规定了上海市参与电动汽车充换电业务的运营商服务平台与上海充换电设施公共数据采集与监测市级平台(以下简称“市级平台”)的信息交换体系、公共信息对象、业务流程、接口功能,以及信息传输与安全。本文件适用于市级平台对在上海市参与电动汽车充换电业务的运营商服务平台进行充换电业务相关的公共数据采集、信息交换及审核。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T2260—2013中华人民共和国行政区划代码GB/T2659—2000世界各国和地区名称代码GB/T9387.1信息技术开放系统互联基本参考模型第1部分:基本模型GB16735--2019道路车辆识别代号(VIN)GB/T19596—2017电动汽车术语GB/T27930电动汽车非车载传导式充电机与电池管理系统之间的通信协议GB/T29317电动汽车充换电设施术语NB/T33001—2018电动汽车非车载传导式充电机技术条件3术语和定义GB16735--2019、GB/T19596—2017、GB/T29317和GB/T27930界定的以及下列术语和定义适用于本文件。3.1电动汽车充换电过程中接入市级平台的相关信息。3.2电动汽车充换电设施运营商EVchargingandbatteryswapfacilityoperator电动汽车充换电设施的运营及日常维护方。2DB31/T1265--20203.3为了识别某一辆车,由车辆制造厂为该车辆指定的一组字码。3.4地锁parkingspacelock一种安装在车位地面上、可通过远程控制升降的机械装置。4电动汽车充换电服务信息交换体系参与电动汽车充换电服务的各业务角色和信息交换功能实体之间应在正常、安全、有效的原则下通过规范的接口进行信息交换,相互协同地向电动汽车用户提供充换电服务。电动汽车充换电服务信息交换功能实体分层结构包括4层,分别是信息接入层、基础设施层、运营服务层和数据共享层。表1中给出了电动汽车充换电服务所涉及的信息接口。表1电动汽车充换电服务信息采集与交换接口列表充电运营服务平台与市级平台之间的公共数据采集与监测的信息交换接口充电运营服务平台与市级平台之间的业务信息采集与交换接口出租车运营管理平台与市级平台间的业务信息采集与交换接口电动汽车使用者与充电运营服务平台之间的身份识别充电运营服务平台、市级平台与支付结算平台之间信息交换接口充换电基础设施与充电运营服务平台之间信息交换接口图1为各个信息交换实体及其之间的信息交换接口的体系结构。DB31/T1265—20203上海市新能源汽车管理平台上海充换电设施公共数据采集与监游市级平台效据共享层上海市新能源汽车管理平台上海充换电设施公共数据采集与监游市级平台IpayIpay_支付结算平台IsuperIsupersuper等等[pay至运曹制运曹制务网络运营般务网络B充换电运营服务平台充换电基础设施充换电运营服务平台hey充换电基础设施充换电基础设施IaclIac2Iacl新能源汽车钾能终端新能源汽车信息接入层充换电服务纯证图1电动汽车充换电服务信息交换体系结构框架4.2分层4.2.1信息接入层由电动汽车用户以及各类信息终端组成。包括电动汽车、智能终端、智能卡、NFC等设备或模块,提供用户身份识别和用户终端服务交互功能。电动汽车使用者可通过多种方式访问充换电设施运营服务网络,完成充换电服务的信息交换。由交流充电桩、非车载充电机及其他充换电设备组成充换电基础设施。充换电基础设施连接到充换电运营服务平台,与信息接人层各类终端进行实时信息交互,完成向电动汽车输送电能量。由充换电运营服务平台、出租车运营管理平台和支付结算平台组成,平台间通过相互协同构成运营服务网络,向用户提供完整的充换电服务。不同平台之间的清分结算能力可由支付结算平台实现。上海充换电设施市级平台。上海充换电设施市级平台应预留对外的数据接口,可提供充换电设施运营服务网络的信息统计、行业服务、对外充电服务等功能。4.3接口分类4.3.1Isuper接口Isuper接口是充换电运营服务平台与市级平台的公共数据采集与监测的信息交换接口,该接口的4DB31/T1265—2020功能应包括但不仅限于以下服务:a)资源信息服务,指基本的充换电设施资源的信息发布、更新、同步等;b)状态信息服务,指充换电设施及充电接口的状态信息发布、更新、同步等;c)统计信息服务,指充换电设施的统计信息上报与发布。该接口的详细定义及实现方式见第7章。4.3.2Iserv接口Iserv接口是归属于不同运营商的充换电运营服务平台与上海充换电设施市级平台的业务信息交换接口,该接口的功能应包括但不仅限于以下服务:a)平台认证服务,指完成运营服务平台鉴权认证,获得平台之间数据访问和业务控制能力许可;b)用户认证服务,指完成归属不同运营商的电动汽车用户身份认证;c)设备认证服务,指完成归属不同充电运营商的设备认证;d)业务策略服务,指完成不同充换电运营服务平台服务策略的交换。例如设备定价方案等;e)充电业务服务,指完成不同充换电运营服务平台间充电过程的信息交换;f)充电订单服务,指完成不同充换电运营服务平台间充电交易记录的信息交换;g)订单对账服务,指完成不同充换电运营服务平台间对账和结算信息交换。该接口的详细定义及实现方式见第7章。4.3.3Ievt接口Ievt接口是出租车运营管理平台与上海充换电设施市级平台的信息交换接口,该接口主要用于上海充换电设施市级平台对出租车的车辆识别代号等相关信息的调用。5公共信息对象5.1公共信息对象关系概述公共信息的对象包括:充电运营商信息、充电站信息、充电设备信息、充电设备接口信息、充电站统计信息、充电设备接口统计信息、充电站实时状态、充电设备接口实时状态。相关实体及其之间的关系见图2。充电站统计信息充电设备统计信息1…充电设备接口统计信息充电站统计信息充电设备统计信息1…定期统计充电站实时状态1…充电站信息充电站实时状态1…充电站信息充电运营商信息Y增量推送订单信息充电设备信息充电设备接口增量推送订单信息充电设备信息信息地锁信息图2公共信息对象关系图一个充电运营商应至少运营一个充电站,一个充电站应至少包含一个充电设备,每个充电设备宜有一个和多个充电接口。充换电设施的实时状态,应该以充电设备接口的实时状态为最小上报单位,在批量查询的时候,为7DB31/T1265—2020了提高效率,可以以充电站为单位,查询对应的充电设备的实时状态。在进行数据统计时,应以某个充电站为单位,定期查询统计数据。5.2充电运营商信息充电运营商信息(OperatorInfo)用于描述充换电设施运营商的一些基础信息。其中运营商ID使用组织机构代码(去掉“一”符号的9位字符,下文提及组织机构代码与此相同),运营商电话至少填写一个,方便用户联系运营商。表2中界定了充电运营商信息的相关字段描述。表2充电运营商信息是字符串是字符串运营商电话1运营商客服电话1是字符串否字符串否字符串备注信息否字符串注:对于新营业执照(三码合一),组织机构代码为社会信用代码去掉前八位和最后一位5.3充电站信息充电站信息(StationInfo)用于描述充电站的信息,包含充电站的基本信息、服务信息、支付信息等,其中基本信息的设备所属方ID为充电设备所属放的组织机构代码,如果不是代运营充电站,应填入和运营商ID一样的值。站点类型分为三大类:公共、个人、专用,及其他。其中专用里面有:公交、环卫、物流、出租车。表3中界定了充电站信息的相关字段描述。表3充电站信息名称字段描述必填类型备注充电站IDStationID运营商自定义的唯一编码是字符串运营商IDOperatorID组织机构代码是字符串设备所属方IDEquipmentOwnerID设备所属方组织机构代码是字符串充电站名称StationName充电站名称的描述是字符串充电站国家代码CountryCode比如CN是字符串GB/T2659—2000充电站省市辖区编码AreaCode充电站点所在的省市辖区的行政区划分代码是字符串GB/T2260-2013表3充电站信息(续)是字符串能够联系场站工作人员否字符串是字符串100:公交(专用)101:环卫(专用)102:物流(专用)103:出租车(专用)104:分时租赁(专用)105:小区共享(专用)106:单位(专用)107:私人共享桩(专用)是当个人桩(50)进专用桩(107)建设时间是字符串投入运营时间是字符串6:维护中50:正常使用是是GCJ-02坐标系是浮点型,保留GCJ-02坐标系是浮点型,保留否字符串7DB31/T1265—2020表3充电站信息(续)是站点照片否否字符串车位楼层以及数量信息否字符串否字符串否字符串是是字符串是8DB31/T1265-2020是保留小数点是保留小数点是否是字符串若免费则填写“免费停车”字符串是是9DB31/T1265—2020表3充电站信息(续)其他备注信息否字符串充电设备信息是5.4充电设备信息充电设备信息(EquipmentInfo)是对充电设备的描述,包含设备编码、设备生厂商组织机构代码、设备型号、设备生产日期、设备类型、充电设备经纬度等。表4中界定了充电设备信息的相关字段描述。表4充电设备信息营商,保证唯一是字符串设备生产商组织机构是字符串否字符串否字符串否字符串建设时间是字符串投入运营时间是字符串是0:未知6:维护中50:正常使用是是浮点型,保留小是DB31/T1265-2020表4充电设备信息(续)设备接口的信息对象是GCJ-02坐标系否浮点型,保留小GCJ-02坐标系否浮点型,保留小年检信息是地锁信息地锁信息否5.5充电设备接口信息充电设备接口信息(ConnectorInfo)是对充电设备接口的基本信息对象的描述,包含充电设备接口编码、充电设备接口名称、充电设备接口类型、额定电压、额定电流、额定功率等。如果设备为交流,其中额定电压上限以及额定电压下限可填入一样的值。表5中界定了充电设备接口信息的相关字段描述。表5充电设备接口信息充电设备接口充电设备接口编码,同运营商内唯一是字符串否字符串1:家用插座(模式2)2:交流接口插座(模式3,连接方式B)线,模式3,连接方式C)线,模式4)是是是是DB31/T1265—2020表5充电设备接口信息(续)是浮点型,保留小否字符串是3:兼容12V与24V是5.6充电设备接口状态充电设备接口状态(ConnectorStatusInfo)是对充电设备接口实时状态对象的描述,包含充电设备接口编码、充电设备接口状态等。直流设备输出复用A相字段。表6中界定了充电设备接口状态的相关字段描述。表6充电设备接口状态充电设备接口运营商内唯一是字符串否字符串充电设备接口0:离网细说明)是故障信息详细说明否见5.13当接口状态为“255”时,应注明故障信息是否DB31/T1265--2020表6充电设备接口状态(续)否是否否则传空串否车位性质0:未知否0:未知否否否否5.7充电站状态充电站状态(StationStatusInfo)是对充电设备接口实时状态对象的描述,包含充电设备接口编码、充电设备接口状态等。表7中界定了充电站状态信息的相关字段描述。表7充电站状态运营商自定义的唯一编是字符串充电设备接口所有充电设备接口的是DB31/T1265—20205.8充电站统计信息充电站统计信息(StationStatsInfo)是对充电站进行统计分析时使用的对象,包含站点编号、开始日期、结束日期,运营商累计电量、设备编码、充电设备接口编码以及充电设备接口累计电量等。表8中界定了充电站统计信息的相关字段描述。表8充电站统计信息是字符串统计的开始时间格式“yyyy-MM-dd”是字符串格式“yyyy-MM-dd”是字符串精度0.1是是5.9充电设备统计信息充电设备统计信息(EquipmentStatsInfo)是对充电站进行统计分析时使用的对象,统计某个充电设施的充电电量。表9中界定了充电设备统计信息的相关字段描述。表9充电设备统计信息营商,保证唯一是字符串精度0.1是充电设备接口是5.10充电设备接口统计信息充电设备接口统计信息(ConnectorStatsInfo)是对充电站进行统计分析时使用的对象,统计某个充电设备接口的充电电量等。表10中界定了充电设备接口统计信息的相关字段描述。DB31/T1265—2020表10充电设备接口统计信息充电设备接口运营商内唯一是字符串充电设备接口精度0.1否订单信息(OrderInfo)是对运营商进行统计分析时使用的对象,包含运营商ID、订单号、充电电量等。表11中界定了订单信息的相关字段描述。表11订单信息名称字段描述必填类型备注运营商IDOperatorID组织机构代码是字符串充电设备接口编码ConnectorID充电设备接口编码,同一运营商内唯一是字符串充电订单号StartChargeSeqyyyyMMddHHmmss十4位随机数”是字符串用户发起充电类型UserChargeType1:运营商APP注册用户2:运营商卡用户3:其他是整型用户手机号MobileNumber若用户发起充电类型为APP,用户手机号必填否字符串推荐接入车辆VINVin车辆识别码,没有则传空串否字符型见GB/T27930关于车辆辨识报文的约定。出租车补贴申请必填本次充电消费总金额Money单位:元否浮点型本次充电电费总金额FlectMoney单位:元否浮点型本次充电服务费金额ServiceMoney单位:元否浮点型本次充电电量Elect是浮点型DB31/T1265—2020表11订单信息(续)否否否否否否否否否否否否否否否否否否否否否否否否格式“yyyy-MM-ddHH:是字符串格式"yyyy-MM-ddHH:是否字符串支付时间支付时间格式“yyyy-MM-ddHH:否字符串DB31/T1265—2020表11订单信息(续)是描述支付的相关优惠信否字符串年检信息(AnnualTestInfo)是充换电设施的年检信息,作为5.4的信息项。表12中界定了年检信息的相关字段描述。表12年检信息255:否是上次检测时间是字符串检测时间是字符串是字符串5.13报警信息报警信息(AlertInfo)是充换电设施的报警信息,作为5.6的可选信息项。表13中界定了报警信息的相关字段描述。表13报警信息05:高温工作'是高温工作:工作环境温度≥50℃;低温工作:工作环境温度≤-20℃是字符串电动汽车充换电设施在额定负载下长期连续运行的DB31/T1265—20205.14地锁信息地锁信息(ParkingLockInfo)是充换电设施所在车位的地锁信息,作为5.4的可选信息项。表14中界定了地锁信息的相关字段描述。表14地锁信息是字符串是字符串否字符串地锁类型是6业务流程公共信息接口共支持7个业务流程,分别是:a)运营商信息的备案与更新;b)备案充换电设施信息;c)同步充电设备运行状态;d)站点统计数据上报;e)收集充电站统计信息;f)推送订单信息;g)出租车充电及补贴信息采集。6.2运营商信息的备案与更新运营商信息的备案与更新均在线下进行,当充换电运营商与市级平台签署协议后,应互相备案双方信息。当运营商信息需要更新时,应提前一周向市级平台提出书面申请,以更改接口信息。6.3备案充换电设施信息图3显示了备案充换电设施信息的流程。充电运营商应向市级平台推送更新的充换电设施信息,每条推送信息推送1个站点。因为充电站的数量较大,充电站信息推送应提供分页的支持,每次发送的充电设备信息数不超过100条,以保证推送时不会因为充电站信息的数据量太大造成接口调用超时等问题。DB31/T1265—2020市级平台充电运营商市级平台充电运营商长周期循环事件推送充换电设施信息处理结果分页查询充换电设施信息询方式统计信息提供增量推送的方式持需支持图3备案充换电设施信息流程图6.4设备状态同步流程图4显示了推送设备状态的流程。当充电设备接口状态、车位状态、地锁状态发生变化时,充电运营商应把此充电设备接口的最新状态立刻通过调用市级平台的“设备状态变化”接口,告知市级平台某一个充电设备接口的状态发生了变化。市级平台通过调用充电运营商的“设备状态查询”的接口,更新所有电站的充电设备接口状态。若在充电中时,当充电设备接口状态、车位状态、地锁状态、SOC的变化推送给市级平台,但是因为电压、电量、电流信息发生变更较为频繁,建议间隔10min推送一次状态。当充电设备接口状态(ConnectorStatusInfo)中(Status)字段状态为255(故障)时,应同步上传报警信息的详细内容(见5.13)。市级平台充电运营商充电设施长周期循环[设备变化]设备状态变化[设备变化]设备状态变化通知状态变化设备状态变化(充电枪状态)通知状态变化提供主动推送的方式提供主动推送的方式设备状态查询(充电站编号列表)查询方式充电站设备状态列表查询方式图4推送设备状态流程DB31/T1265—20206.5站点统计数据上报图5显示了站点统计数据上报的流程。运营商应于次日向市级平台推送充电设施的当日统计信息,调用市级平台的“统计信息上报”(见8.6)的接口,上报统计信息。充电站点的统计数据上报应提供分页的支持,每次发送的充电设备信息数不超过100条。以保证推送时不会因为充电站信息的数据量太大造成接口调用超时等问题。市级平台宜提前确定运营商上报统计数据的时段,分开上报减小市级平台压力。市级平台充电运营商[周期可设置][所有的电站][周期可设置][所有的电站]循环查询统计信息(时间范围,电站ID)查询方式统计信息图5站点统计数据上报流程6.6收集充电站统计数据流程图6显示了收集充电桩统计数据的流程。市级平台定期获取电站的统计信息。调用时,针对每一个电站调用充电运营商的“查询统计信息”的接口,查询运营商信息。市级平台充电运营商[周期可设置][所有的电站][周期可设置][所有的电站]循环查询统计信息(时间范围,电站[D)查询方式统计信息图6收集充电站统计数据流程6.7订单信息推送流程图7显示了推送订单信息的流程。在每次充电业务完成后,充电运营商应在一定时间内,向市级平台推送本次的订单信息,平台不接20DB31/T1265—2020受超过24受超过24h的订单信息推送。若为移动端客户,则订单信息中应该包含充电用户手机号。充电运营商事件循环推送订单信息处理结果增量推送方式市级平台图7推送订单信息流程6.8出租车充电相关信息采集图8显示了出租车充电相关信息的采集流程。出租车用户发起充电请求后,设备启动充电,充电设施与车辆BMS通信获取车辆识别代号,形成包含车辆识别代号的充电订单,并以此判断是否是可补贴订单。由市级平台计算统计,并将订单结算信息推送给运营商平台。市级平台市级平台运营商平台请求设备认证返回设备认证结果请求启动充电返回结果推送启动充电结果信息返回结果推送设备充电中状态(包含VIN码)返回结果请求停止充电返回结果推送停止充电结果信息返回结果推送充电订单信息(包含VIN码)返回处理结果推送订单结算信息返回处理结果图8出租车充电相关信息采集流程DB31/T1265—202021为了满足上述业务流程的定义,除设备认证服务、启动充电服务外,另应有11个接口,分别为:a)充电站信息变化推送;b)查询充电站信息;c)设备状态变化推送;d)设备接口状态查询;e)统计信息上报;f)查询统计信息;g)订单信息推送;h)推送充电状态;i)推送充电订单信息;j)推送订单结算信息;k)查询订单结算信息。7.2充电站信息变化推送当站点信息发生变化时,应推送最新的信息通知到市级平台。市级监管平台中某一充电站编号必须始终唯一。已经通过线下审核的站点或领取过补贴的站点,不允许通过接口直接进行变更,必须先进行申请,市级平台予以通过后方可进行信息维护。接口名称:notification_stationInfo接口使用方法:由市级平台实现此接口,充电运营商方调用。表15中界定了充电站信息变化推送接口的输入参数。表15充电站信息变化推送接口输入参数参数名称定义参数类型描述充电站信息StationInfoStationInfo类型“StationInfo”参见5.3示例:{"StationInfo":{"StationID":"000000000000001","OperatorID":"123456789","EquipmentOwnerID":"123456789","StationName":"\u5145\u7535\u7ad9\u540d\u79f0","CountryCode":"CN",22"[http:\/,"\/uploads\/plugs\/e5\/eb\/cd\/"http:\//%5D,"www.xxx,com\/uploads\/plugs\/7c\/0c\/81\"EquipmentName":"电桩001","ConnectorName":"枪1",DB31/T1265—202023表16充电站信息变化推送接口返回值0:接受;示例:{"Status":0,}7.3查询充电站信息此接口用于查询运营商的充电站的信息。接口名称:query_stations_info接口使用方法:由充电运营商方实现此接口,市级平台调用。查询时需要比对电站、充电设备、充电接口的基本信息的最后修改时间,三者只要有一处修改,就认为是最新修改时间,然后与输入参数lastQueryTime进行对比。表17中界定了查询充电站信息接口的输入参数。表17查询充电站信息接口输入参数上次查询时间字符串不填写默认为1示例:{"LastQueryTime":"2020-07-1500:00:00","PageNo":1,"PageSize":1024表18中界定了查询充电站信息接口的返回值。表18查询充电站信息接口返回值{"StationInfos":[《"StationTel":"139*并*0008",,"StationStatus":50,,DB31/T1265—2020{{}]当设备状态发生变化,推送最新的状态通知到合作方。接口名称:notification_stationStatus接口使用方法:由市级平台实现此接口,充电运营商方表19中界定了设备状态变化推送接口的输入参数。表19设备状态变化推送接口输入参数{26DB31/T1265—2020"Status":4,"CurrentA":0,"CurrentB":0,"CurrentC":0,"VoltageA":0,"VoltageB":0,"VoltageC":0,"ParkStatus":10,"LockStatus":10,"SOC":10}表20中界定了设备状态变化推送接口的返回值。表20设备状态变化推送接口返回值示例:"Status":0,}7.5设备接口状态查询此接口用于批量查询设备实时状态。接口名称:query_station_status接口使用方法:由充电运营商方实现此接口,市级平台调用。表21中界定了设备接口状态查询的输入参数。表21设备接口状态查询输入参数参数名称定义参数类型描述充电站ID列表StationIDs数组长度不超过50个字符示例:{"StationIDs":[DB31/T1265—202027]表22中界定了设备接口状态查询的返回值。表22设备接口状态查询返回值参数类型根据查询条件设备状态类型“StationStatusInfo”参见5.7示例:{"Total":1,"StationStatusInfos":[{"StationID":"000000000000003601","ConnectorStatusInfos";[{"Status":4,"CurrentA":0,"CurrentB":0,"CurrentC":0,"VoltageA":0,"VoltageB":0"VoltageC":0"SOC":101]}7.6统计信息上报此接口用于运营商向市级平台定期上报充电站点的运营统计信息。接口名称:report_station_stats接口使用方法:由市级平台实现此接口,充电运营商方调用。表23中界定了统计信息上报接口的输入参数。28DB31/T1265—2020表23统计信息上报接口输入参数充电站统计信息[]{"StationStats":{"StationID":"111111111111111","StartTime":"2018-01-01","EndTime":"2018-01-02","StationElectricity":100,"EquipmentStatsInfos":[{"EquipmentID":"10000000000000000000001","EquipmentElectricity":100,"ConnectorStatsInfos":[{"ConnectorElectricity":100,]}]"StationStats":{"StationID":"111100000111111","StartTime":"2018-01-01","StationElectricity":50,"EquipmentStatsInfos":[{"EquipmentElectricity":50,"ConnectorStatsInfos":[{"ConnectorElectricity":50,j]表24中界定了统计信息上报接口的返回值。表24统计信息上报接口返回值参数类型0:接受;{"Status":0,}7.7查询统计信息此查询用于定期获取每个充电站,在某个周期内的统计信息。接口使用方法:由充电运营商方实现此接口,市级平台调用。表25中界定了查询统计信息接口的输人参数。表25查询统计信息接口输入参数字符串字符串格式“yyyy-MM-dd”字符串格式“yyyy-MM-dd”{{"StationStats":{30DB31/T1265—2020"EndTime":"2020-08-01","StationElectricity":100,"EquipmentStatsInfos":[{"EquipmentID":"000000000000003601","EquipmentElectricity":100,"ConnectorStatsInfos";[{"ConnectorID":"00000000000000360101","ConnectorElectricity":100]表26中界定了查询统计信息接口的返回值。表26查询统计信息接口返回值示例:{"StationStats":("StationID":"111111111111111","StartTime":"2015-10-01","EndTime":"2015-10-02","StationElectricity":100,"EquipmentStatsInfos":[{"EquipmentID":"100000000000000000000001","EquipmentElectricity":100,"ConnectorStatsInfos":[{"ConnectorID":"10000000000000000000000101","ConnectorElectricity":100,31当运营商平台有新订单完成时,将订单信息推送至市级平台。接口名称:notification_orderInfo接口使用方法:由市级平台实现此接口,充电运营商方调用。表27中界定了订单信息推送接口的输入参数。表27订单信息推送接口输入参数订单信息DB31/T1265—202032"FlatServiceMoney":0,"ValleyElect":0,"ValleyElectPrice":0,"ValleyServicePrice":0,"ValleyMoney":0,"ValleyElectMoney":0,"ValleyServiceMoney":0,"StartTime":"2016-08-0910:00:00","EndTime":"2016-08-0911:00:00","PaymentAmount":"20.80","PayTime":"2016-08-0911:05:58","PayChannel":1,"DiscountInfo":"无"}}表28中界定了订单信息推送接口的返回值。表28订单信息推送接口返回值示例:{"Status":0,}7.9推送充电状态此接口用于运营商平台向市级平台推送充电设备的充电状态。接口名称:notification_equip_charge_status接口使用方法:由市级平台实现此接口,运营商平台调用。表29中界定了推送充电状态接口的输人参数,33表29推送充电状态接口输入参数是字符串订单编码按互联互通规则是1:启动中;2:充电中;3:停止中;4:已结束;5:未知是字符串是否字符串是单位:A,默认:0含直流(输出)否否是单位:V,默认:0含直流(输出)否否是开始充电时间是格式“yyyy-MM-ddHH:mm:ss”本次采样时间是格式“yyyy-MM-ddHH:mm:ss”是是是是否充电明细信息否单时段充电明细信息,见5.11{34DB31/T1265—2020"VoltageA":337.0,"VoltageB":0.0,"VoltageC":0.0,"Soc":68.0,"StartTime":"2019-07-1514:50:40","EndTime":"2019-07-1514:52:43","TotalPower":0.51,"ElecMoney":0.79,"SeviceMoney":0.0,"TotalMoney":0.79,"SumPeriod":0}表30中界定了推送充电状态接口的返回值。表30推送充电状态接口返回值是字符串是示例:{"Ret":0,"Msg":"上传数据成功!","Data":"BPnod+TkspDsr0/ORGaqrA==","Sig":"C608788FE9048470C1714B470B62E6FE"}此接口用于运营商平台向市级平台推送充电订单信息。接口名称:notification_charge_order_info接口使用方法:由市级平台实现此接口,运营商平台调用。35DB31/T1265—2020表31推送订单信息接口输入参数参数类型是字符串订单编码按互联互通规则是字符串否字符串开始充电时间是格式“yyyy-MM-ddHH:mm:ss”是格式“yyyy-MM-ddHH:mm:ss”是是是是充电结束原因是2:BMS停止充电;3:充电机设备故障;否充电明细信息否单时段充电明细信息,见5.11示例:{"StartChargeSeq":"123456789201605140830591234","ConnectorID":"10000000000000000000000001","Vin":"xxoxocx0000000","StartTime":"2019-07-1515:00:54","EndTime":"2019-07-1515:01:28","TotalPower":0.0:"TotalElecMoney":0.0,"TotalSeviceMoney":0.0,"TotalMoney":0.0,"StopReason":0,"SumPeriod":0}37DB31/T1265—2020表32推送充电订单信息接口返回值是字符串订单编码按互联互通规则是字符串是1:争议交易;示例:"Ret":0,"Msg":"","Data":{"StartChargeSeq":"123456789201605140830591234","ConnectorID":"10000000000000000000000001","ConfirmResult":7.11推送订单结算信息7.11.1概述此接口用于市级平台向运营商平台推送订单结算信息。7.11.2接口定义接口名称:notification_order_settlement_info接口使用方法:由运营商平台实现此接口,市级平台调用。7.11.3输入参数表33中界定了推送订单结算信息接口的输人参数。表33推送订单结算信息接口输入参数是字符串订单编码按互联互通规则是字符串是是是0:非出租车订单;否是37DB31/T1265-2020示例:("StartChargeSeq":"123456789201605140830591234","ConnectorID":"10000000000000000000000001","TotalPower":0.51,"TotalMoney":0.79,"TaxiOrder":1,"SubsidyMoney":0.2,"SettlementMoney":0.59}表34中界定了推送订单结算信息接口的返回值。表34推送订单结算信息接口返回值是字符串订单编码按互联互通规则是字符串是1:争议交易;示例:{"Ret":0,"Msg":"","Data":{"StartChargeSeq":"123456789201605140830591234","ConnectorID":"10000000000000000000000001","ConfirmResult":0}}此接口用于运营商平台向市级平台查询订单结算信息。接口名称:query_order_settlement_info接口使用方法:由市级平台实现此接口,运营商平台方调用。38DB31/T1265—2020表35中界定了查询订单结算信息接口的输入参数。表35查询订单结算信息接口输入参数参数名称定义必填参数类型描述充电订单号StartChargeSeq是字符串T/CEC102.3--2019的示例:{"StartChargeSeq":"123456789201605140830591234"表36中界定了查询订单结算信息接口的返回值。表36查询订单结算信息接口返回值是字符串订单编码按互联互通规则是字符串是是是0:非出租车订单;否是示例:{"Ret":0,"Msg":"订单结算信息查询成功","Data":{"StartChargeSeq":"123456789201605140830591234","ConnectorID":"10000000000000000000000001","TotalPower":0.51,"TotalMoney":0.79,"TaxiOrder":1,"SubsidyMoney":0.2,"SettlementMoney":0.59}39DB31/T1265—20208数据传输与安全8.1数据传输体系数据传输体系要求了参与电动汽车充换电服务的各利益相关方之间应在正常、安全、有效的原则下通过规范的接口进行信息交换,相互协同地向电动汽车用户提供充换电服务。电动汽车充换电设施公共数据采集与信息交换通过数据传输接口进行交换,数据传输接口众多,既存在于各个服务逻辑层之间,也存在于同一逻辑层的不同管理域之间,数据传输接口可通过身份认证、访问控制、数据加密、数字签名等安全措施,保障数据传输过程中要保障所传输数据的机密性和安全性。8.1.2数据传输一般流程电动汽车充换电设施公共数据采集与信息交换应符合GB/T9387.1中关于会话连接的要求,一般需要经过平台认证、数据请求和数据返回3个步骤。图9显示了电动汽车充换电设施公共数据采集与监测信息交换流程。平台认证数据请求数据返回图9电动汽车充换电设施公共数据采集与监测信息交换流程8.1.3数据传输接口的基本要求电动汽车充换电设施的公共数据采集与信息交换应遵守国家信息安全等级保护相关要求。充换电设施运营商应提供严格的系统安全保密机制,保障信息交换接口安全、稳定、可靠地运行,包括信息的存取控制、应用系统操作的安全等。必须遵守的基本要求:a)采用身份认证、访间控制、数据加密、数字签名等安全措施;b)采用安全可靠并且普遍使用的加密算法;c)密钥的存贮和交易信息的加密/解密需要在安全的环境中;d)符合GB/T25070、NB/T33017等国家和行业标准中关于数据安全保密的相关要求;e)定期更换密钥;f)具备对报文做来源正确性鉴别的机制(HMAC)。注:并不仅限于基本要求,其他要求可根据具体需求确定。市级平台应为每个运营商分配平台标识(OperatorID)、平台密钥(OperatorSecret)、消息密钥(DataSecret)、消息密钥初始化向量(DataSecretIV)和签名密钥(SigSecret):一平台标识(OperatorID):固定9位,运营商的组织机构代码,作为运营商的唯一标示;-平台密钥(OperatorSecret):可采用32H、48H和64H,由0-F字符组成,为申请认证使用;—消息密钥(DataSecret):用于对所有接口中Data信息进行加密;40DB31/T1265—2020——消息密钥初始化向量(DataSecretIV):固定16位,用户AES加密过程的混合加密;——签名密钥(SigSecret):可采用32H、48H和64H,由0-F字符组成,为签名的加密密钥。8.2平台认证方式及规则电动汽车充换电服务信息交换应具备平台认证服务提供平台之间的鉴权认证功能。平台之间在信图10显示了平台认证采用的中心交换认证模式。中心交换认证模式由市级平台提供鉴权认证服务,运营商与中心认证服务方确定运营商标识(OperatorID)、运营商密钥(OperatorSecret)、消息密钥(DataSecret)、消息密钥初始化向量(DataSecretIV)和签名密钥(SigSecret),具体认证方式由各运营商和认证服务方共同确定。运营服务平台B中心认证服务(运营服务平台A)运营服务平台C)图10中心交换认证模式平台认证宜采取身份认证和访问控制相结合的方式进行。身份认证可采取用户名/口令认证、密钥认证或数字证书认证等方式进行;访问控制可采取IP访问控制、时间访问控制等多种手段结合。用户身份认证成功后授予Token,每次向服务端请求资源的时候需要带着服务端签发的Token,服务端验证Token成功后,才返回请求的数据。Token的有效期由服务方确定,最长不应超过7天,Token丢失或失效后需要再次发起认证服务。DB31/T1265—202041访问控制发送身份信息认证成功认证成功认证服务请求发起方认证服务返回Tcken图11平台认证方式8.3数据传输方式及规则8.3.1数据传输接口规则所有数据传输接口均采用HTTP(S)接口,每个接口的URL均采用如下格式定义:http(s)://[域名]/shevcs/v[版本号]/[接口名称],其中—域名:各接入平台所属域名。—版本号:代表接口版本号,不同的版本地址对应相应版本代码。系统升级期间,新旧版本可同时存在,待所有接入方都切换到新接口,旧接口即可下线。从而达到平滑升级的目的。——接口名称:所请求/调用接口的名称,具体接口名称见接口定义。8.3.2接口调用方式所有接口均使用HTTP(S)/POST方式传输参数,传输过程中应包含消息头和消息主体两部分。消息头一般需包含内容类型(Content-Type)和授权信息(Authorization)。内容类型字段用于标识请求中的消息主体的编码方式,本文件中所规范的信息交换内容均采用JSON的方式,参数信息采用utf-8编码,因此需要配置消息头中的Content-Type为application/json;charset=utf-8。授权信息字段用于证明客户端有权查看某个资源,本文件中所规范的授权信息采用凭证(Token)的方式,因此需要在配置消息头中的Authorization为BearerTonken。8.3.4消息主体规范一般由运营商标识(OperatorID)、参数内容(Data)、时间戳(TimeStamp)、自增序列(Seq)和数字签名(Sig)组成。消息主体内容参照表37。42DB31/T1265—2020表37消息主体内容表参数名说明举例OperatorID运营商标识Data各接口具体参数信息"Data":{"StationInfo":[{"StationID":"000000000000001","OperatorID":"123456789","EquipmentOwnerID":"123456789","StationName":"\u5145\u7535\u7ad9\u540d\u79f0","CountryCode":"CN","AreaCode":"441781","Address":"\u5730\u5740","StationTel":"123456789","ServiceTel":"123456789","StationType":1,"StationStatus":50,"ParkNums":3,"StationLng":119.97049,"StationLat":31.717877,"SiteGuide":"111111","OpenAllDay":1,"MinElectricityPrice":5.5,"Construction":0,"ParkFree":1,"Pictures":["http:\\/V/uploadsVplugs/e5V/ebV/cdVf0469308d9bbd99496618d6d87","http:\\/\/uploads\/plugs\/7c\/0c\/81\/a8ed867ffdfb597abaf9982b2c"],"Payment":"1","SupportOrder":1,"EquipmentInfos":[{"EquipmentID":"10000000000000000000003","EquipmentName":"电桩001","ManufacturerID":"123456789","EquipmentModel":"p3","ProductionDate":"2016-04-26","EquipmentType":3,"EquipmentStatus":50,"EquipmentPower":3.3,"NewNationalStandard":1,DB31/T1265—202043参数名说明举例Data各接口具体参数信息"ConnectorInfos":[{"ConnectorID":"1","ConnectorName":"枪1","ConnectorType":1,"VoltageUpperLimits":220,"VoltageLowerLimits":220,"Current":15,"Power":3.3}TimeStamp时间戳接口请求时时间戳信息,格式为yyyyMM-ddHHmmssSeq自增序列4位自增序列取自时间戳,同一秒内按序列自增长,新秒重计。如0001Sig参数签名返回参数规则数据传输接口的返回参数一般由返回值(Ret)、返回信息(Msg)、参数内容(Data)和数字签名(Sig)组成。a)Ret:必填字段,返回编码参考表38;b)Msg:必填字段,有错误表示具体错误信息,无错误返回成功信息;c)Data:参数内容,具体返回参数见第7章,采用utf-8编码,JSON格式。表38中给出了返回参数编码规则。表38返回参数编码表说明0OperatorID,sig,TimeStam44DB31/T1265—2020数据传输接口中的Data字段可为数组型的JSON格式,数据发送方可通过该字段实现批量数据的传输。各运营商系统间在消息传递时,需要保障传输和接收数据的安全和完整。8.4密钥的使用及管理8.4.1基本安全要求运营商应满足数据安全传输控制方面的要求。运营商应提供严格的系统安全保密机制,保障信息交换接口安全、稳定、可靠地运行,包括信息的存取控制、应用系统操作的安全等。8.4.2密钥的安全要求数据密钥应具备随机产生特性,密钥产生后要检查密钥的有效性,弱密钥和半弱密钥需被剔除。运营商加入信息交换时,必须申请独立的密钥文件,密钥可由运营商协商产生。密钥的分发应该由安全方式进行,可通过线下分发、联机报文或数字信封的方式加密传输。密钥宜保存在硬件加密机内。如果出现在硬件加密机外,则必须密文方式出现。密钥注人、密钥管理和密钥档案的保管应由专人负责。使用密钥和销毁密钥要在监督下进行并应有使用、销毁记录。当新密钥产生后,生命期结束的旧密钥必须从数据库和内存中清除,防止被替换使用;同时所有可能重新构造此密钥的信息也必须清除。新密钥成功启用和旧密钥自动销毁的记录将被更新。8.4.3数据的加密处理消息发送方需要对Data字段中涉及交易及隐私等数据利用消息密钥(DataSecret)进行加密,加密算法宜使用AES128位加密,加密模式采用CBC,填充模式采用PKCS5Padding方式。消息接收方收到消息之后,根据消息密钥(DataSecret)对消息体中的Data数据进行解密,校验参数合法性等后续业务处理。数据传输的加密使用对称加密算法AES加密,具体加解密方法和示例参见附录C。8.5参数签名规范8.5.1参数签名要求参数签名采用HMAC-MD5算法,采用MD5作为散列函数,通过签名密钥(SigSecret)对整个消息DB31/T1265—202045主体进行加密,然后采用Md5信息摘要的方式形成新的密文,参数签名要求大写。参数签名顺序按照消息体顺序拼接后执行,拼接顺序为运营商标识(OperatorID)、参数内容(Data)、时间戳(TimeStamp)、自增序列(Seq)。8.5.2参数签名方法HMAC-MD5算法其中:——K是密钥(OperatorSecret),长度可为64字节,若小于该长度,在密钥后面用“0”补齐;-M是消息内容;--H是散列函数;-opad和ipad分别是由若干个0x5c和0x36组成的字符串;——田表示异或运算;|表示连接操作。HMAC-MD5流程参数签名所用的HMAC-MD5算法流程如下:a)在签名密钥(SigSecret)后面添加0来创建一个长为64字节的字符串(str);b)将上一步生成的字符串(str)与ipad(0x36)做异或运算,形成结果字符串(istr);c)将消息内容data附加到第二步的结果字符串(istr)的末尾;d)做md5运算于第三步生成的数据流(istr);e)将第一步生成的字符串(str)与opad(0x5c)做异或运算,形成结果字符串(ostr);f)再将第四步的结果(istr)附加到第五步的结果字符串(ostr)的末尾;g)做md5运算于第六步生成的数据流(ostr),输出最终结果(out)。示例:运营商标识(OperatorID):123456789参数信息(Data):/时间戳(TimeStamp):20160729142400签名(Sig):745166E8C43C84D37FFECOF529C4136F46DB31/T1265—2020分布式认证的认证接口规范A.1概述此接口用于平台之间认证Token的申请,Token作为全局唯一凭证,调用各接口时均需要使用。A.2接口定义接口使用方法:由服务端实现此接口,需求端调用。A.3输入参数认证接口的输人参数见表A.1。表A.1认证接口输入参数字符串运营商密钥字符串运营商分配的唯一识别密钥示例:{"OperatorID":"987654321","OperatorSecret":"1234567890abcdef"}认证接口的返回值见表A.2。表A.2认证接口返回值字符串字符串失败原因{"OperatorID":"987654321",47}48DB31/T1265—2020(资料性)数字信封密钥分发方式B.1数字信封的定义数字信封是公钥密码体制在实际中的一个应用,是用加密技术来保证只有规定的特定收信人才能阅读通信的内容。B.2数字信封的原理在数字信封中,信息发送方采用对称密钥来加密信息内容,然后将此对称密钥用接收方的公开密钥来加密(这部分称数字信封)之后,将它和加密后的信息一起发送给接收方,接收方先用相应的私有密钥打开数字信封,得到对称密钥,然后使用对称密钥解开加密信

温馨提示

  • 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
  • 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
  • 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
  • 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
  • 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
  • 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
  • 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。

评论

0/150

提交评论