中国电力企业联合会标准 T/CEC 102.2-2016

第2部分:公共信息交换规范



1 范围

本部分规定了电动汽车充换电业务信息服务交换规范,涵盖公共信息交换的功能描述、信息模型及接口协议,定义了T/CEC102.1-2016中的公共信息接口(Icomm)。

本部分适用于归属不同运营商的电动汽车充换电运营服务平台之间的充换电服务信息交换,以及电动汽车充换电运营服务平台与第三方服务及管理平台之间的信息交换。

2 规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。

GB/T 2260-2007 中华人民共和国行政区划代码

T/CEC 102.1-2016 电动汽车充换电服务信息交换 第1部分:总则

3 术语和定义

T/CEC 102.1-2016界定的术语和定义适用于本部分。

4 功能描述

公共信息接口共支持3个功能,分别是:

a)获取充换电设施信息。

获取充换电设施信息是指支持数据需求方可以查询基础设施运营商的充电站信息,查询充电站的范围是双方提前约定好的充电站范围。需要支持全部查询和增量查询的方式。

b)同步充电设备运行状态。

同步充电设备运行状态是实现数据需求方将基础设施运营商的充电站的运行状态同步到数据需求方。

c)收集充电站统计信息。

收集充电站统计信息是数据需求方可以查询基础设施运营商的某些场站运行情况的统计信息。

公共信息交换的业务流程见附录A。

5 公共信息对象

5.1 公共信息对象关系定义

公共信息的对象包括:基础设施运营商信息、充电站信息、充电设备信息、充电设备接口信息、充电站统计信息、充电设备统计信息、充电设备接口统计信息、充电站状态信息、充电设备接口状态。

如图1所示,一个基础设施运营商至少运营一个充电站,每个充电站至少包含一个充电设备,每个充电设备会有一个和多个充电接口。

充换电设施的实时状态,应该以充电设备接口的实时状态为最小上报单位,在批量查询的时候,为了提高效率,可以以充电站为单位,查询对应的充电设备的实时状态。

在进行数据统计时,应以某个充电站为单位,定期查询统计数据。

图1 公共信息对象关系图

5.2 基础设施运营商信息(OperatorInfo)

用于描述设备运营商的一些基础信息,其中运营商ID使用组织机构代码(去掉“-”符号的9位字符,下文提及组织机构代码与此相同),运营商电话至少填写一个,方便用户联系运营商。详细定义请参见表1。

表1 基础设施运营商信息

运营商字段描述必填类型长度
运营商IDOperatorID组织机构代码字符串9字符
运营商名称OperatorName机构全称字符串<= 64字符
运营商电话1OperatorTell运营商客服电话1字符串<= 32字符
运营商电话2OperatorTel2运营商客服电话2字符串<= 32字符
运营商注册地址OperatorRegAddress运营商注册地址字符串<= 64字符
备注OperatorNote备注信息字符串<= 255字符

其中,对于新营业执照(三码合一),其组织机构代码为社会信用代码去掉前八位和最后一位后的中间的数字。

5.3 充电站信息(StationInfo)

用于描述充电站的信息,包含充电站的基本信息、服务信息、支付信息等,其中基本信息的设备所属方ID为充电设备所属方的组织机构代码,如果不是代运营充电站,应填入和运营商ID一样的值。

站点类型分为公共、个人、专用、其他四大类,其中专用分为公交、环卫、物流、出租车几类。详细定义请参见表2。

表2 充电站信息

名称字段描述必填类型长度
充电站IDStationID运营商自定义的唯一编码字符串<= 20字符
运营商IDOperatorID运营商ID字符串9字符
设备所属方IDEquipmentOwnerID设备所属运营平台组织机构代码字符串9字符
充电站名称StationName充电站名称的描述字符串<= 50字符
充电站国家代码CountryCode比如CN字符串2字符
充电站省市辖区编码AreaCode填写内容为参照 GB/T 2260-2007字符串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字符
建设场所Construction 1:居民区;2:公共机构;3:企事业单位;4:写字楼;5:工业园区;6:交通枢纽;7:大型文体设施;8:城市绿地;9:大型建筑配建停车场;10:路边停车位;11:城际高速服务区;255:其他 整型
站点照片Pictures充电设备照片、充电车位照片、停车场入口照片字符串数组
使用车型描述MatchCars描述该站点接受的车大小以及类型,如大巴、物流车、私家乘用车、出租车等字符串<= 100字符
车位楼层及数量描述ParkInfo车位楼层以及数量信息字符串<= 100字符
营业时间BusineHours营业时间描述字符串<= 100字符
充电电费率ElectricityFee充电费描述字符串<= 256字符
服务费率ServiceFee服务费率描述字符串<= 100字符
停车费ParkFee停车费率描述字符串<= 100字符
支付方式Payment支付方式:刷卡、线上、现金。其中电子钱包类卡为刷卡,身份鉴权卡、微信/支付宝、APP为线上字符串<= 20字符
是否支持预约SupportOrder充电设备是否需要提前预约后才能使用。0为不支持预约;1为支持预约。不填默认为0整型
备注Remark其他备注信息字符串<= 100字符
充电设备信息列表EquipmentInfos该充电站所有充电设备信息对象集合EquipmentInfo[]

5.4 充电设备信息(EquipmentInfo)

对充电设备的描述,包含设备编码、设备生产商组织机构代码、设备型号、设备生产日期、设备类型、充电设备经纬度等。详细定义请参见表3。

表3 充电设备信息

名称字段描述必填类型长度/范围
设备编码EquipmentID设备唯一编码,对同一运营商,保证唯一字符串<= 23字符
设备生产商组织机构代码ManufacturerID设备生产商组织机构代码字符串9字符
设备生产商名称ManufacturerName设备生产商的名称字符串<= 30字符
设备型号EquipmentModel由设备生产商定义的设备型号字符串<= 20字符
设备生产日期ProductionDateYYYY-MM-DD字符串10字符
设备类型EquipmentType1:直流设备;2:交流设备;3:交直流一体设备;4:无线设备;5:其他整型
充电设备接口信息列表ConnectorInfos该充电设备所有的充电设备接口的信息对象集合ConnectorInfo[]
充电设备经度EquipmentLngGCJ-02坐标系浮点型保留小数点后6位
充电设备纬度EquipmentLatGCJ-02坐标系浮点型保留小数点后6位
充电设备总功率Power单位:kW浮点型保留小数点后1位
充电设备名称EquipmentName字符串<= 30字符

5.5 充电设备接口信息(ConnectorInfo)

对充电设备接口的基本信息对象的描述,包含充电设备接口编码、充电设备接口名称、充电设备接口类型、额定电压、额定电流、额定功率等。

如果设备为交流,其中额定电压上限以及额定电压下限可填入一样的值。详细定义请参见表4。

表4 充电设备接口信息

名称字段描述必填类型长度/范围
充电设备接口编码ConnectorID充电设备接口编码,同一运营商内唯一字符串<= 26字符
充电设备接口名称ConnectorName字符串30字符
充电设备接口类型ConnectorType 1:家用插座(模式2);2:交流接口插座(模式3,连接方式B);3:交流接口插头(带枪线,模式3,连接方式C);4:直流接口枪头(带枪线,模式4);5:无线充电座;6:其他 整型
额定电压上限VoltageUpperLimits单位:V整型
额定电压下限VoltageLowerLimits单位:V整型
额定电流Current单位:A整型
额定功率Power单位:kW浮点型保留小数点后一位
车位号ParkNo停车场车位编号字符串10字符
国家标准NationalStandard1:2011;2:2015整型

5.6 充电设备接口状态(ConnectorStatusInfo)

对充电设备接口实时状态对象的描述,包含充电设备接口编码、充电设备接口状态等。详细定义请参见表5。

表5 充电设备接口状态

名称字段描述必填类型长度/范围
充电设备接口编码ConnectorID充电设备接口编码,同一运营商内唯一字符串<= 26字符
充电设备接口状态Status0:离网;1:空闲;2:占用(未充电);3:占用(充电中);4:占用(预约锁定);255:故障整型
车位状态ParkStatus0:未知;10:空闲;50:占用整型
地锁状态LockStatus0:未知;10:已解锁;50:已上锁整型

5.7 充电站状态信息(StationStatusInfo)

对充电站的状态描述,包含充电站ID、充电设备接口状态列表等。详细定义请参见表6。

表6 充电站状态信息

名称字段描述必填类型长度/范围
充电站IDStationID运营商自定义的唯一编码,不足长度在前方补0字符串<= 20字符
充电设备接口状态列表ConnectorStatusInfos所有充电设备接口的状态 ConnectorStatusInfo[]

5.8 充电站统计信息(StationStatsInfo)

对充电站进行统计分析时使用的对象,包含站点编号、开始日期、结束日期,运营商累计电量、设备编码、充电设备接口编码以及充电设备接口累计电量等。详细定义请参见表7。

表7 充电站统计信息

名称字段描 述必填类型长度/范围
充电站IDStationID站点编号字符串<= 20字符
统计的开始时间StartTime格式“yyyy-MM-dd”字符串10字符
统计结束时间EndTime格式“yyyy-MM-dd”字符串10字符
充电站累计电量StationElectricity累计电量,单位为kWh,精度为0.1浮点型保留小数点后一位
充电设备统计信息列表EquipmentStatsInfos充电站中所有充电设备的统计对象集合EquipmentStatsInfo[]

5.9 充电设备统计信息(EquipmentStatsInfo)

对充电站的设备进行统计分析时使用的对象,统计某个充电设备的充电电量。详细定义请参见表8。

表8 充电设备统计信息

名称字段描述必填类型长度/范围
设备编码EquipmentID设备唯一编码,对同一运营商,保证唯一字符串<= 23字符
充电设备接口累计电量EquipmentElectricity累计电量,单位为kWh,精度为0.1浮点型保留小数点后一位
充电设备接口统计信息列表ConnectorStatsInfos充设备的所有充电设备接口统计对象集合ConnectorStatsInfo[]

5.10 充电设备接口统计信息(ConnectorStatsInfo)

对充电站的设备接口进行统计分析时使用的对象,统计某个充电设备接口的充电电量等。详细定义请参见表9。

表9 充电设备接口统计信息

名称字段描 述必填类型长度/范围
充电设备接口编码ConnectorID充电设备接口编码,同一运营商内唯一字符串<= 26字符
充电设备接口累计电量ConnectorElectricity累计电量,单位为kWh,精度为0.1浮点型保留小数点后一位

6 接口规范

6.1 概述

为了满足上述业务流程的定义,一共有4个接口,分别为:
a)查询充电站信息。
b)查询统计信息。
c)设备状态变化。
d)设备状态查询。

6.2 查询充电站信息

6.2.1 概述

此接口用于查询运营商的充电站的信息。

6.2.2 接口定义

接口名称:query_stations_info。

接口使用方法:由基础设施运营商方实现此接口,数据需求方调用。

查询时需要比对电站、充电设备、充电接口的基本信息的最后修改时间,三者只要有一处修改,就认为是最新修改时间,然后与输入参数lastQueryTime进行对比。

6.2.3 输入参数

输入参数定义请参见表10。

表10 查询充电站信息输入参数

参数名称定义参数类型描 述
上次查询时间LastQueryTime字符串格式 yyyy-MM-dd HH:mm:ss,可以为空,如果不填写,则查询所有的充电站信息
查询页码PageNo整型不填写默认为1
每页数量PageSize整型不填写默认为10
6.2.4 返回值

返回值定义请参见表11。

表11 查询充电站信息返回值

参数名称定义参数类型描 述
当前页数PageNo整型如果查询页码大于页码总数,返回查询页码数
页码总数PageCount整型总页数
总记录条数ItemSize整型符合条件的电站总数
充电站信息列表StationInfosStationInfo []类型“StationInfo”,参照5.3~5.5
6.2.5 示例
{
  "ItemSize": 1,
  "PageCount": 1,
  "PageNo": 1,
  "StationInfos": [
    {
      "OperationID": "123456789",
      "StationID": "000000000000001",
      "StationName": "测试场站名称",
      "EquipmentOwnerID": "123456789",
      "CountryCode": "CN",
      "AreaCode": "441781",
      "Address": "测试场站实际地址",
      "ServiceTel": "123456789",
      "StationType": 1,
      "StationStatus": 50,
      "ParkNums": 3,
      "StationLng": 119.97049,
      "StationLat": 31.717877,
      "Construction": 1,
      "Pictures": [
        "http:Wwww.xxx.comVuploadsVplugsVe5VebVcdVf0469308d9bbd99496618d6d87",
        "http:Wwww.xxx.comVuploadsVplugsV7cV0cV81Va8ed867ffdfb597abaf9982b2c"
      ],
      "EquipmentInfos": [
        {
          "EquipmentID": "10000000000000000000003",
          "ManufacturerID": "123456789",
          "EquipmentModel": "p3",
          "ProductionDate": "2016-04-26",
          "EquipmentType": 3,
          "Power": "3.3",
          "EquipmentName": "一号桩",
          "ConnectorInfos": [
            {
              "ConnectorID": "1",
              "ConnectorType": 1,
              "VoltageUpperLimits": 220,
              "VoltageLowerLimits": 220,
              "Current": 15,
              "NationalStandard": 1,
              "Power": 3.3
            }
          ]
        }
      ]
    }
  ]
}

6.3 设备状态变化推送

6.3.1 概述

当设备状态发生变化时,推送最新的状态到合作方。

6.3.2 接口定义

接口名称:notification_stationStatus。

接口使用方法:由数据需求方实现此接口,基础设施运营商方调用。

6.3.3 输入参数

输入参数定义请参见表12。

表12 设备状态变化推送输入参数

参数名称定义参数类型描 述
充电设备接口状态ConnectorStatusInfoConnectorStatusInfo
6.3.4 返回值

返回值定义请参见表13。

表13 设备状态变化推送返回值

参数名称定义参数类型描 述
状态Status整型0:接受;1:丢弃/忽略,不需要重试
6.3.5 示例
{
  "Status": 0
}

6.4 设备接口状态查询

6.4.1 概述

此接口用于批量查询设备实时状态。

6.4.2 接口定义

接口名称:query_station_status。

接口使用方法:由基础设施运营商方实现此接口,数据需求方调用。

6.4.3 输入参数

输入参数定义请参见表14。

表14 设备接口状态查询输入参数

参数名称定义参数类型描 述
充电站ID列表StationIDs字符串[]数组长度不超过50
6.4.4 返回值

返回值定义请参见表15。

表15 设备接口状态查询返回值

参数名称定义参数类型描 述
充电站信息StationStatusInfos StationStatusInfo [] 类型“StationStatusInfo”,参照5.7
6.4.5 示例
{
  "Total": 1,
  "StationStatusInfos": [
    {
      "StationID": "111111111111111",
      "ConnectorStatusInfos": [
        {
          "ConnectorID": "1",
          "Status": 4
        }
      ]
    }
  ]
}

6.5 查询统计信息

6.5.1 概述

此查询用于定期获取每个充电站,在某个周期内的统计信息。

6.5.2 接口定义

接口名称:query_station_stats。

接口使用方法:由基础设施运营商方实现此接口,数据需求方调用。

6.5.3 输入参数

输入参数定义请参见表16。

表16 查询统计信息输入参数

参数名称定义参数类型描 述
充电站IDStationID字符串需要统计的电站
统计开始时间StartTime字符串格式“yyyy-MM-dd”
统计结束时间EndTime字符串格式“yyyy-MM-dd”
6.5.4 返回值

返回值定义请参见表17。

表17 查询统计信息返回值

参数名称定义参数类型描 述
充电站统计信息StationStatsStationStatsInfo根据查询条件统计出来的充电站的汇总数据。类型StationStatsInfo,参照5.8
6.5.5 示例
{
  "StationStats": {
    "StationID": "111111111111111",
    "StartTime": "2015-10-01",
    "EndTime": "2015-10-02",
    "EquipmentStatsInfos": [
      {
        "EquipmentID": "100000000000000000000001",
        "EquipmentElectricity": 100,
        "ConnectorStatsInfos": [
          {
            "ConnectorID": "10000000000000000000000101",
            "ConnectorElectricity": 100
          }
        ]
      }
    ]
  }
}

附录A (规范性附录)

公共信息交换的业务流程

A.1 概述

针对本部分需要支持的功能,可以采用以下业务流程实现:
a)备案充换电设施信息流程。
b)同步充电设备运行状态流程。
c)收集充电站统计信息流程。

A.2 备案充换电设施信息

如图A.1 所示,数据需求方可定期调用基础设施运营商的“查询充电站”的接口,查询所有充电站的信息。同时在一定的周期内,按照一定频率,定期调用基础设施运营商的“查询充电站”的接口来更新充电站的最新的信息。

图A.1 备案充换电设施信息流程图

因为电站的数据量较大,“查询充电站”接口应提供分页的支持。以保证接口调用时不会因为充电站信息的数据量太大造成接口调用超时等问题。

A.3 设备状态同步流程

如图A.2 所示,数据需求方按照一定周期,通过调用基础设施运营商的“设备状态查询”的接口,更新所有电站的充电设备接口状态。由于运营商电站数量较多,应在每次系统初始化的时候调用。

在两次调用周期期间,当充电设备接口状态、车位状态、地锁状态发生变化时,基础设施运营商应把此充电设备接口的最新状态立刻通过调用数据需求方的“设备状态变化”接口告知数据需求方。

图A.2 推送设备状态流程

A.4 收集充电站统计数据流程

如图A.3 所示,数据需求方应定期获取充电站的统计信息,这个周期是由数据需求方决定的。调用时,应针对每一个充电站调用基础设施运营商的“查询统计信息”的接口,查询运营商信息。

图A.3 收集充电站统计数据流程图

与我联系 | 意见反馈

Copyright © charge-box.cn | All rights reserved.

京ICP备 2024088673号