2019电动汽车充换电服务信息交换 第2部分：公共信息交换规范.doc

电动汽车充换电服务信息交换第2部分：公共信息交换规范目次前言III引言IV1 范围52 规范性引用文件53 术语和定义54 公共信息对象64.1 公共信息对象关系概述64.2 充电运营商信息（ChargeOperatorInfo）64.3 充电站信息(StationInfo)64.4 充电设备信息(EquipmentInfo)84.5 充电设备接口信息(ConnectorInfo)84.6 充电设备接口状态（ConnectorStatusInfo）94.7 充电站状态信息（StationStatusInfo）94.8 充电设备接口统计信息（ConnectorStatsInfo）94.9 充电站统计信息（StationStatsInfo）105 业务流程定义105.1 概述105.2 更新运营商信息105.3 备案充换电设施信息105.4 设备状态同步流程115.5 收集充电站统计数据流程126 接口定义126.1 概述126.2 查询运营商信息126.3 查询充电站信息136.4 设备状态变化推送156.5 设备状态查询156.6 查询统计信息16附录一 二维码规范18引言为加快电动汽车充电基础设施建设，促进不同充电服务平台互联互通，构建充电基础设施信息服务信息交换体系架构，统一信息接口通信协议，实现不同充电运营企业、不同区域的充电服务设施、第三方平台信息资源等互联和充分利用，实现充电设备网络服务平台间数据交换，充电系统服务功能跨平台信息交换服务，特制定本标准。18电动汽车充换电服务信息交换 第二部分：公共信息交换规范1 范围本部分规定了电动汽车充换电业务信息服务交换规范，涵盖公共信息结构定义，实现电动汽车充换电服务信息交换 第1部分：总则公共信息接口（Icomm）。本部分适用于归属不同运营商的电动汽车充换电运营服务平台之间的充换电服务信息交换，以及电动汽车充换电运营服务平台与其他第三方服务及管理平台之间的信息交换。2 规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 19596-2004：电动汽车术语GB/T 29317-2012：电动汽车充换电设施术语GB/T 18487.3：电动车辆传导充电系统电动车辆交流/直流充电机（站）GB/T 18487.3-2001 电动车辆传导充电系统 电动车辆交流/直流充电机(站)GB/T 28569-2012 电动汽车交流充电桩电能计量GB/T 29316-2012 电动汽车充换电设施电能质量技术要求GB/T 29318-2012 电动汽车非车载充电机电能计量GB/T 2659-2000 世界各国和地区名称代码GB/T 2260-2002 中华人民共和国行政区划代码GB/T 18391.1-2002 信息技术数据元的规范与标准化第1部分：数据元的规范与标准化框架GB/T 2261.1-2003 个人基本信息分类与代码GB/T 7408-2005 数据元和交换格式信息交换日期和时间表示法GB/T 22239-2008 信息安全技术信息系统安全等级保护基本要求GB/T 25070-2010 信息安全技术信息系统等级保护安全设计技术要求GB/T 20271-2006 信息安全技术信息系统安全通用技术要求GB/T 20988-2007 信息安全技术信息系统灾难恢复规范GA 36-2007 中华人民共和国机动车号牌NB/T 33007-2013：电动汽车充电站/电池更换站监控系统与充换电设施通信协议NB/T33001-2010 电动汽车非车载传导式充电机技术条件NB/T33002-2010 电动汽车交流充电桩技术条件NB/T 33003-2010 电动汽车非车载充电机监控单元与电池管理系统通信协议NB/T 33008.1-2013 电动汽车充电设备检验试验规范第1部分：非车载充电机NB/T 33008.2-2013 电动汽车充电设备检验试验规范第2部分：交流充电桩NB/T 33020-2014电动汽车动力蓄电池箱用充电机技术条件3 术语和定义3.1 布尔型本部分使用0代表false,1代表true3.2 示例如无特殊说明，为返回值示例4 公共信息对象4.1 公共信息对象关系概述公共信息的对象包括：充电运营商信息、充电站信息、充电设备信息、充电设备接口信息、充电站统计信息、充电设备接口统计信息、充电站实时状态、充电设备接口实时状态。相关实体及其之间的关系如图1所示。图1 公共信息对象关系图如图1所示，一个充电运营商至少运营一个充电站，每个充电站至少包含一个充电设备，每个充电设备会有一个和多个充电接口。充换电设施的实时状态，应该以充电设备接口的实时状态为最小上报单位，在批量查询的时候，为了提高效率，可以以充电站为单位，查询对应的充电设备的实时状态。在进行数据统计时，应以某个充电站为单位，定期查询统计数据。4.2 充电运营商信息（OperatorInfo）用于描述充电运营商的一些基础信息，其中运营商ID使用组织机构代码（去掉”-“符号的9位字符，下文提及组织机构代码与此相同），运营商电话至少填写一个，方便用户联系运营商。运营商字段描述必填类型长度运营商IDoperatorID组织机构代码是字符串9字符运营商名称operatorName机构全称是字符串<=64字符运营商电话1operatorTel1运营商客服电话1是字符串<=32字符运营商电话2operatorTel2运营商客服电话2否字符串<=32字符运营商注册地址operatorRegAddress运营商注册地址否字符串<=64字符备注operatorNote备注信息否字符串<=255字符其中对于新营业执照(三码合一)组织机构代码为社会信用代码去掉前八位和最后一位，中间的数字4.3 充电站信息(StationInfo)用于描述充电站的信息，包含充电站的基本信息、服务信息、支付信息等，其中基本信息的设备所属方ID为充电设备所属放的组织机构代码，如果不是代运营充电站，应填入和运营商ID一样的值。站点类型分为三大类：公共、个人、专用、其他，其中专用里面有：公交、环卫、物流、出租车。名称字段描述必填类型长度充电站IDstationID运营商自定义的唯一编码，不足长度在前方补0是字符串20字符运营商IDoperatorID运营商ID是字符串9字符设备所属方IDequipmentOwnerID设备所属运营平台组织机构代码是字符串9字符充电站名称stationName充电站名称的描述是字符串<=50字符充电站国家代码countryCode比如CN是字符串2字符充电站省市辖区编码areaCode填写内容为参照GB/T2260-2013是字符串20字符详细地址address是字符串<=50字符站点电话stationTel能够联系场站工作人员进行协助的联系电话否字符串<=30字符服务电话serviceTel平台服务电话，例如400的电话是字符串<=30字符站点类型stationType1：公共50：个人100：公交（专用）101：环卫（专用）102：物流（专用）103：出租车（专用）255：其他是整型站点状态stationStatus0：未知1：建设中5：关闭下线6：维护中50：正常使用是整型车位数量parkNums可停放进行充电的车位总数，默认：0 未知是整型经度stationLngGCJ-02坐标系是浮点型保留小数点后6位纬度stationLatGCJ-02坐标系是浮点型保留小数点后6位站点引导siteGuide描述性文字，用于引导车主找到充电车位否字符串<=100字符建设场所construction1：居民区2：公共机构3：企事业单位4：写字楼5：工业园区6：交通枢纽7：大型文体设施8：城市绿地9：大型建筑配建停车场10：路边停车位11：城际高速服务区255：其他是整型站点照片pictures充电设备照片、充电车位照片、停车场入口照片否字符串数组使用车型描述matchCars描述该站点接受的车大小以及类型，如大巴、物流车、私家乘用车、出租车等否字符串<=100字符车位楼层及数量描述parkInfo车位楼层以及数量信息否字符串<=100字符营业时间busineHours营业时间描述否字符串<=100字符充电电费率electricityFee充电费描述否字符串<=100字符服务费率serviceFee服务费率描述否字符串<=100字符停车费parkFee停车费率描述否字符串<=100字符支付方式payment支付方式:刷卡、线上、现金否字符串<=20字符是否支持预约supportOrder充电设备是否需要提前预约后才能使用，默认值0，不需要预约否布尔型备注remark其他备注信息否字符串<=100字符充电设备信息列表equipmentInfos该充电站所有充电设备信息对象集合是EquipmentInfo，参照4.44.4 充电设备信息(EquipmentInfo)对充电设备的描述，包含设备编码、设备生厂商组织机构代码、设备型号、设备生产日期、设备类型、充电设备经纬度等。名称字段描述必填类型长度/范围设备编码equipmentID设备唯一编码，对同一运营商，保证唯一是字符串23字符设备生产商组织机构代码manufacturerID设备生产商组织机构代码是字符串9字符设备型号equipmentModel由设备生厂商定义的设备型号是字符串<=20字符设备生产日期productionDateYYYY-MM-DD否字符串10字符设备类型equipmentType1：直流设备2：交流设备3：交直流一体设备是整型充电设备接口列表connectorInfos该充电设备所有的充电设备接口的信息对象集合ConnectorInfo，参照4.5充电设备经度equipmentLngGCJ-02坐标系否浮点型保留小数点后6位充电设备纬度equipmentLatGCJ-02坐标系否浮点型保留小数点后6位4.5 充电设备接口信息(ConnectorInfo)对充电设备接口的基本信息对象的描述，包含充电设备接口编码、充电设备接口名称、充电设备接口类型、额定电压、额定电流、额定功率等。如果设备为交流，其中额定电压上限以及额定电压下限可填入一样的值。名称字段描述必填类型长度/范围充电设备接口编码connectorID充电设备接口编码，同一运营商内唯一是字符串26字符充电设备接口名称connectorName否字符串30字符充电设备接口类型connectorType1：家用插座（模式2）2：交流接口插座（模式3，连接方式B ）3：交流接口插头（带枪线，模式3，连接方式C）4：直流接口枪头（带枪线，模式4）是整型额定电压上限voltageUpperLimits单位：V是整型额定电压下限voltageLowerLimits单位：V是整型额定电流current单位：A是整型额定功率power单位：kW是浮点型保留小数点后一位车位号parkNo停车场车位编号否字符串10字符4.6 充电设备接口状态（ConnectorStatusInfo）对充电设备接口实时状态对象的描述，包含充电设备接口编码、充电设备接口状态等。直流设备输出复用A相字段。名称字段描述必填类型长度/范围充电设备接口编码connectorID充电设备接口编码，同一运营商内唯一是字符串26字符充电设备接口状态status1：空闲2：占用（未充电）3：占用（充电中）4：占用（预约锁定）255：故障是整型A相电流currentA单位：A，默认：0 含直流(输出)是整型B相电流currentB单位：A，默认：0否整型C相电流currentC单位：A，默认：0否整型A相电压voltageA单位：V，默认：0含直流(输出)是整型B相电压voltageB单位：V，默认：0否整型C相电压voltageC单位：V，默认：0否整型车位状态parkStatus0：未知10：空闲50：占用否整型地锁状态lockStatus0：未知10：已解锁50：已上锁否整型剩余电量soc默认：0否浮点型保留小数点后一位4.7 充电站状态信息（StationStatusInfo）对充电设备接口实时状态对象的描述，包含充电设备接口编码、充电设备接口状态等。名称字段描述必填类型长度/范围充电站IDstationID运营商自定义的唯一编码，不足长度在前方补0是字符串20字符充电设备接口状态列表connectorStatusInfos所有充电设备接口的状态是ConnectorStatusInfo，参照4.64.8 充电站统计信息（StationStatsInfo）对充电站进行统计分析时使用的对象，包含站点编号、开始日期、结束日期，运营商累计电量、设备编码、充电设备接口编码以及充电设备接口累计电量等。名称字段描述必填类型长度/范围充电站IDstationID站点编号是字符串20字符统计的开始时间startTime格式“yyyy-MM-dd”是字符串10字符统计结束时间endTime格式“yyyy-MM-dd”是字符串10字符充电站累计电量stationElectricity累计电量，单位kWh，精度0.1是浮点型保留小数点后一位充电设备统计信息列表equipmentStatsInfos充电站中所有充电设备的统计对象集合是EquipmentStatsInfo ，参照4.94.9 充电设备统计信息(EquipmentStatsInfo)名称字段描述必填类型长度/范围设备编码equipmentID设备唯一编码，对同一运营商，保证唯一是字符串23字符充电设备接口累计电量equipmentElectricity累计电量，单位kWh，精度0.1是浮点型保留小数点后一位充电设备接口统计信息列表connectorStatsInfos充设备的所有充电设备接口统计对象集合是ConnectorStatsInfo ，参照4.104.10 充电设备接口统计信息（ConnectorStatsInfo）对充电站进行统计分析时使用的对象，统计某个充电设备接口的充电电量等。名称字段描述必填类型长度/范围充电设备接口编码connectorID充电设备接口编码，同一运营商内唯一是字符串26字符充电设备接口累计电量connectorElectricity累计电量，单位kWh，精度0.1否浮点型保留小数点后一位5 业务流程定义5.1 概述公共信息接口共支持4个业务流程，分别是：l 更新运营商信息l 备案充换电设施信息l 收集充电站统计信息l 同步充电设备运行状态5.2 更新运营商信息运营商信息的备案在线下进行，当双方签署协议后，互相备案运营方信息。5.3 备案充换电设施信息图2 备案充换电设施信息流程图数据需求方应定期调用充电运营商的“查询充电站”的接口，查询所有充电站的信息。同时在一定的周期内，应按照一定频率，定期调用充电运营商的“查询充电站”的接口来更新充电站的最新的信息。因为电站的数量量较大，“查询充电站”接口应提供分页的支持。以保证接口调用时不会因为充电站信息的数据量太大造成接口调用超时等问题。5.4 设备状态同步流程图3 推送设备状态流程当充电设备接口状态发生变化时，充电运营商应把此充电设备接口的最新状态通过调用数据需求方的“设备状态变化”接口，告知数据需求方某一个充电设备接口的状态发生了变化。图4 查询设备状态流程数据需求方也可通过调用充电运营商的“设备状态查询”的接口，批量查询一批电站的充电设备接口状态。5.5 收集充电站统计数据流程图5 收集充电站统计数据流程图数据需求方应定期获取电站的统计信息，这个周期是由数据需求方决定。调用时，应针对每一个电站调用充电运营商的“查询统计信息”的接口，查询运营商信息。6 接口定义6.1 概述为了满足上述业务流程的定义，一共有4个接口，分别为：l 查询充电站信息l 查询统计信息l 设备状态变化l 设备状态查询6.2 查询充电站信息6.2.1 概述此接口用于查询运营商的充电站的信息。6.2.2 接口定义接口名称：query_stationsInfo接口使用方法：由充电运营商方实现此接口，数据需求方调用。6.2.3 输入参数参数名称定义参数类型描述上次查询时间lastQueryTime字符串格式“yyyy-MM-dd HH:mm:ss”，可以为空，如果不填写，则查询所有的充电站信息查询页码pageNo整型不填写默认为1每页数量pageSize整型不填写默认为106.2.4 返回值参数名称定义参数类型描述当前页数pageNo整型如果查询页码大于页码总数，返回查询页码数页码总数pageCount整型总页数总记录条数itemSize整型符合条件的电站总数充电站信息列表stationInfosStationInfo数组类型“StationInfo”参照4.3、4.4、4.5如: "ret": 0, "msg": "", "data": "itemSize": 1, "pageCount": 1, "pageNo": 1, "stationInfos": "operationID": "123456789", "platformID": "123456789", "stationID": "000000000000001", "stationName": "u5145u7535u7ad9u540du79f0", "countryCode": "CN", "areaCode": "441781","address": "u5730u5740","serviceTel":"123456789", "stationType": 1, "stationStatus": 50, "parkNums": 3, "lng": 119.97049, "lat": 31.717877, "construction": 1, "pictures": "http:/uploads/plugs/e5/eb/cd/f0469308d9bbd99496618d6d87", "http:/uploads/plugs/7c/0c/81/a8ed867ffdfb597abaf9982b2c" , "equipmentInfos": "equipmentID": "10000000000000000000003", "manufacturerID": "123456789", "equipmentModel": "p3", "productionDate": "2016-04-26", "equipmentType": 3, "connectorInfos": "connectorID": "1", "connectorType": 1,"voltageUpperLimits": 220,"voltageLowerLimits": 220, "current": 15, "power": 3.3 6.3 设备状态变化推送6.3.1 概述当设备状态发生变化，推送最新的状态通知到合作方6.3.2 接口定义接口名称： notification_stationStatus接口使用方法：由数据需求方实现此接口，充电运营商方调用。6.3.3 输入参数参数名称定义参数类型描述充电设备接口状态connectorStatusInfoConnectorStatusInfo6.3.4 返回值 "ret": 0,6.4 设备接口状态查询6.4.1 概述此接口用于批量查询设备实时状态6.4.2 接口定义接口名称： query_station_status接口使用方法：由充电运营商方实现此接口，数据需求方调用。6.4.3 输入参数参数名称定义参数类型描述充电站ID 列表stationIDs字符串数组长度不超过506.4.4 返回值参数名称定义参数类型描述充电站信息stationStatusInfosStationStatusInfo根据查询条件设备状态 类型“StationStatusInfo”参照4.96.4.5 示例 "ret": 0, "msg": "", "data": "total": 1, "stationStatusInfos": "stationID": "111111111111111", "connectorStatusInfos": "connectorID": "1","status": 4,"currentA": 0,"currentB": 0,"currentC": 0,"voltageA": 0,"voltageB": 0,"voltageC": 0,"soc": 10, 6.5 查询统计信息6.5.1 概述此查询用于定期获取每个充电站，在某个周期内的统计信息6.5.2 接口定义接口名称： query_station_stats接口使用方法：由充电运营商方实现此接口，数据需求方调用。6.5.3 输入参数参数名称定义参数类型描述充电站IDstationID字符串需要统计的电站 统计开始时间startTime字符串格式“yyyy-MM-dd”日期偏移offset 整型> 06.5.4 返回值参数名称定义参数类型描述充电站统计信息stationStatsStationStatsInfo根据查询条件统计出来的充电站的汇总数据类型“StationStatsInfo”参照4.9如： "ret": 0, "msg": "", "data": "pageNo": 1, "pageCount": 10, "itemSize": 1, "stationStats": "stationID": "111111111111111", "startTime": "2015-10-01 00:00:00", "endTime": "2015-10-02 00:00:00", "equipmentStatsInfos": "equipmentID": "100000000000000000000001", "equipmentElectricity": 100,"connectorStatsInfos": "connectorID": "10000000000000000000000101", "connectorElectricity": 100, 附录一 二维码规范使用URI（Uniform Resource Identifier，是一个用于标示某一互联网资源名称的字符串，该种标示允许用户对任何资源通过特定的协议进行交互操作）的进行编码。格式如下： hlht:/充电设备接口ID.运营商ID/自定义