奥升充电|互联互通协议解析(3)——业务信息交换规范

一、查询业务策略信息

1. 接口描述

接口名称:查询业务策略信息结果query_equip_business_policy

接口说明:通过流水号和充电设备接口编码查询充电桩业务策略信息

请求格式:json

请求方式:post

2. 注意事项

  • 该接口符合互联互通标准,需要在消息头中配置Content-Type为application/json、Authorization为Bearer token,消息体中必须包括OperatorID,Data,TimeStamp,Seq,Sig,并且对Data部分进行加密,详细说明请参照AES128位加密和MD5签名。
  • 测试环境业务策略数据仅做格式参考,不代表真实数据。

3. 接口示例

请求Data参数说明:

参数名称

定义

必填

参数类型

描述

业务策略查询流水号

EquipBizSeq

字符串

格式“运营商ID+唯一编号”,27字符

充电设备接口编码

ConnectorID

字符串

格式“6位行政区编码,4位电站编码,3位终端编码”,13位字符

请求示例:

https://orise.trytowish.cn/evcs/v1/query_equip_business_policy
{
    "OperatorID": "123456789",
    "Data":     "C3z0fu4xW72dJMOsgcVyPrbHOqzQcIwSexeW7b4wPcAV8qQvECycER60lBJpW5v7+Ex6pAYvDgrImQh3fhqEujP4AICBew296s71WAwpOBM=",
    "TimeStamp": "20180508162919",
    "Seq": "0001",
    "Sig": "92A192D753BBEF609136620FFA7E9069"
}

Data加密前:

{
	"EquipBizSeq": "123456789201805081628123456",
	"ConnectorID": "3702120244401"
}

返回Data参数说明:

采用多时段计费方式:

参数名称

定义

必填

参数类型

描述

业务策略查询流水号

EquipBizSeq

字符串

格式“运营商ID+唯一编号”,27字符,

充电设备接口编码

ConnectorID

字符串

格式“6位行政区编码,4位电站编码,3位终端编码”,13位字符

操作结果

SuccStat

整型

0:成功;

1:失败

失败原因

FailReason

整型

0:无;

1:此充电桩业务策略不存在;

时段数N

SumPeriod

整型

范围:0~32

计费信息

PolicyInfos

policyInfos数组

单项业务策略信息体

单项业务策略信息体(policyInfo):

参数名称

定义

必填

参数类型

描述

时段起始时间点

StartTime

整型

格式“HHmmss”,6字符

时段电费

ElecPrice

浮点型

小数点后4位

时段服务费

SevicePrice

浮点型

小数点后4位

JSON返回示例:  

{
	"Ret": 0,
	"Msg": "",
	"Data": "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",
	"Sig": "2B8DA24F80693D7CB0B4B7A73F527291"
}

Data解密后: 

{
	"EquipBizSeq": "123456789201805081628123456",
	"ConnectorID": "3702120244401",
	"SuccStat": 0,
	"FailReason": 0,
	"SumPeriod": 15,
	"PolicyInfos": [{
			"StartTime": "090000",
			"ElecPrice": "0.5000",
			"SevicePrice": "0.4000"
		},
		{
			"StartTime": "120000",
			"ElecPrice": "1.5000",
			"SevicePrice": "1.0000"
		},
		{
			"StartTime": "123000",
			"ElecPrice": "0.8000",
			"SevicePrice": "0.6000"
		},
		{
			"StartTime": "130000",
			"ElecPrice": "0.5000",
			"SevicePrice": "0.4000"
		},
		{
			"StartTime": "000000",
			"ElecPrice": "0.5000",
			"SevicePrice": "0.4000"
		},
		{
			"StartTime": "003000",
			"ElecPrice": "0.8000",
			"SevicePrice": "0.6000"
		},
		{
			"StartTime": "140000",
			"ElecPrice": "1.5000",
			"SevicePrice": "1.0000"
		},
		{
			"StartTime": "110000",
			"ElecPrice": "0.5000",
			"SevicePrice": "0.4000"
		},
		{
			"StartTime": "113000",
			"ElecPrice": "0.8000",
			"SevicePrice": "0.6000"
		},
		{
			"StartTime": "133000",
			"ElecPrice": "2.0000",
			"SevicePrice": "1.5000"
		},
		{
			"StartTime": "143000",
			"ElecPrice": "0.8000",
			"SevicePrice": "0.6000"
		},
		{
			"StartTime": "103000",
			"ElecPrice": "0.8000",
			"SevicePrice": "0.6000"
		},
		{
			"StartTime": "100000",
			"ElecPrice": "0.5000",
			"SevicePrice": "0.4000"
		},
		{
			"StartTime": "150000",
			"ElecPrice": "2.0000",
			"SevicePrice": "1.5000"
		},
		{
			"StartTime": "093000",
			"ElecPrice": "0.8000",
			"SevicePrice": "0.6000"
		}
	]
}

二、请求设备认证

1. 接口描述

接口名称:请求设备认证query_equip_auth

接口说明:根据设备认证流水号和设备编码进行设备认证。设备认证之前先获取终端状态为2的终端编号。

请求格式:json

请求方式:post

2. 注意事项

        该接口符合互联互通标准,需要在消息头中配置Content-Type为application/json、Authorization为Bearer token,消息体中必须包括OperatorID,Data,TimeStamp,Seq,Sig,并且对Data部分进行加密,详细说明请参照AES128位加密和MD5签名。

3. 接口示例

请求Data参数说明:

参数名称

定义

参数类型

描述

设备认证流水号

EquipAuthSeq

字符串

格式“运营商ID+唯一编号”,27字符

充电设备接口编码

ConnectorID

字符串

格式“6位行政区编码,4位电站编码,3位终端编码”,13位字符

请求示例:http://hlht.wyqcd.cn:9501/evcs/v20161110/query_equip_auth 

https://orise.trytowish.cn/evcs/v1/query_equip_auth 
{
	"OperatorID": "123456789",
	"Data": "fngkRhzHsmpJU0aL5Y6/pipOyja3lXteJDXtmaHU4VWNAuOZiVstjWBqfnKAD141PBY8SLI0xWqgMCt0QHUwAwzLNw4XhLqZ/4z+t6UBAeNN33FLXaKpXpQCTuOYHQJz",
	"TimeStamp": "20180507163059",
	"Seq": "0001",
	"Sig": "10CF7CECA85C5D5955C0DF0F49853EBD"
}

Data加密前:

{
	"EquipAuthSeq": "123456789201805071630123456",
	"ConnectorID": "3702120244102"
}

返回Data参数说明:

参数名称

定义

参数类型

描述

设备认证流水号

EquipAuthSeq

字符串

格式“运营商ID+唯一编号”,27字符

充电设备接口编码

ConnectorID

字符串

参见《电动汽车充换电服务信息交换 第2部分:公共信息交换规范》

操作结果

SuccStat

整型

0:成功;

1:失败

失败原因

FailReason

整型

0:无;

1:此设备尚未插枪;

2:设备检测失败:

3~99:自定义

JSON返回示例:   

{
	"Ret": 0,
	"Msg": "",
	"Data": "R8D9TwEbYBlfcvkZcjCAmTgcd9Dz49QBPZAZMpeP8KIf1mNIw2p9AN7sFc60XgP+Bg9ocuMNlkXl2uIWhxUmonLWYGhrbLRAfjTpJd7PGhBqbhWV/yEMHlqxOKE9O2mkgG0KZucysFGtJn9SKYCqgpJaUldGRn66RLi7GiGN/kE=",
	"Sig": "09CC158DACD26737B664010716B5871A"
}

Data解密后:

{
	"EquipAuthSeq": "123456789201805071630123456",
	"ConnectorID": "3702120244102",
	"FailReason": 0,
	"SuccStat": 0
}

三、请求启动充电

1. 接口描述

接口名称:请求启动充电 query_start_charge

接口说明:通过充电订单号、设备接口编码、二维码,请求启动充电信息。

请求格式:json

请求方式:post

2. 注意事项

  • 该接口符合互联互通标准,需要在消息头中配置Content-Type为application/json、Authorization为Bearer token,消息体中必须包括OperatorID,Data,TimeStamp,Seq,Sig,并且对Data部分进行加密,详细说明请参照AES128位加密和MD5签名。
  • 为了记录充电用户的订单,方便后续进行支付和开票,在互联互通标准的基础上扩展了手机号字段,个人支付必填。
  • 为了互联互通用户享受充电停车减免,在互联互通标准的基础上扩展了车牌号字段,停车减免必填。

3. 接口示例

  请求Data参数说明:

参数名称

定义

必填

参数类型

描述

充电订单号

StartChargeSeq

字符串

格式“运营商ID+唯一编号”,27字符

充电设备接口编码

ConnectorID

字符串

格式“6位行政区编码,4位电站编码,3位终端编码”,13位字符

二维码其他信息

QRCode

字符串

二维码中含有自定义部分的,需要将二维码自定义部分的原文传输。

手机号

PhoneNum

字符串

个人支付必传,格式确保正确

                  车牌号

               PlateNum

                     否                  字符串停车减免必传,格式确保正确

请求示例:

https://orise.trytowish.cn/evcs/v1/query_start_charge
{
	"OperatorID": "123456789",
	"Data": "MdtylP2lneRGc9XzcskU+HpnDiRE6mKdB49bQGL2wf0Q8l5p08h9yX2F53tVLX8vTeSD6IRRQ786wh+dSlmkO5yBCMXjsNeki8IMFaDPfwyUPu/hStG4ccraXjvEPB9FJdxMu7MFXaExT6v5rfDWl2O/MfoI/GVEsRAnF4K6J50=",
	"TimeStamp": "20180303113914",
	"Seq": "0001",
	"Sig": "25F01B3F8BFED20384BB05B6C2288084"
}

Data加密前:

{
	"StartChargeSeq": "123456789201704111645011",
	"ConnectorID": "3702120244416",
	"QRCode": "QRCode",
	"PhoneNum": "13698689669"
}

返回Data参数说明:

参数名称

定义

必填

参数类型

描述

充电订单号

StartChargeSeq

字符串

格式“运营商ID+唯一编号”,27字符

充电订单状态

StartChargeSeqStat

整型

1:启动中

2:充电中

3:停止中

4:已结束

5:未知

充电设备接口编码

ConnectorID

字符串

参见《电动汽车充换电服务信息交换 第2部分:公共信息交换规范》

操作结果

SuccStat

整型

0:成功;

1:失败

失败原因

FailReason

整型

0:无;

1:此设备不存在;

2:此设备离线:

3~99:自定义

90:车辆未备案

91:该车辆充电中

JSON返回示例: 

{
	"Ret": 0,
	"Msg": "",
	"Data": "txMrDfBisaaKVMtgyjeN5HboJnv1/FU6mKi7FhjyfLPjUnNZp06k1liio5Cdhn8wVoqqmSCH8jTWBCGEk6ooANuywHCAXhFTjPPa3O1I7NxFWk3aYrJrQGOvjDQuT1VN5WbO6POJeH887uJcZVthSNWx0Z5KC2etg1olPlRBTA8shr1lRwmbqVJYEZRJkS8cbBa0cjIr0eD/uVFslUL8Hw==",
	"Sig": "0BFDBAF99152EDAF2A0EC56FED6B5BF5"
}

Data解密后:

{
	"StartChargeSeqStat": 1,
	"StartChargeSeq": "123456789201704111645011",
	"ConnectorID": "3702120244416",
	"SuccStat": 0,
	"FailReason": 0
}

四、推送启动充电结果

1. 接口描述

接口名称:推送启动充电结果notification_start_charge_result

接口说明:发起充电后,由特来电方推送启动充电结果,包括充电订单号、订单状态、充电设备接口编码、充电启动时间。

请求格式:json

请求方式:post

2. 注意事项

        该接口符合互联互通标准,需要在消息头中配置Content-Type为application/json、Authorization为Bearer token,消息体中必须包括OperatorID,Data,TimeStamp,Seq,Sig,并且对Data部分进行加密,详细说明请参照AES128位加密和MD5签名。

3. 接口示例

请求Data参数说明:

参数名称

定义

必填

参数类型

描述

充电订单号

StartChargeSeq

字符串

格式“运营商ID+唯一编号”,27字符

充电订单状态

StartChargeSeqStat

整型

1:启动中

2:充电中

3:停止中

4:已结束

5:未知

充电设备接口编码

ConnectorID

字符串

格式“6位行政区编码,4位电站编码,3位终端编码”,13位字符

充电启动时间                    StartTime                     是                  字符串格式“yyyy-MM-dd HH:mm:ss”

验证码

IdentCode

字符串

特来电将该字段作为启动充电失败原因错误码

请求示例:

https://orise.trytowish.cn/evcs/v1/notification_start_charge_result
{
	"OperatorID": "395815801",
	"Data":     "MdtylP2lneRGc9XzcskU+I+sLFM0lW0OmxV4yRCW7Yoqy7XWGbN4g0sNMxyALuT59PsBJ1Oy4uNbCcvjTD2eJFnSSx0UDBOMu4KFkIjYrJp2IWroDD/960epFXvTEldX+c92DmO2HI9yUiVDYMHdt3P4in69l4RVRUy9Czos7H4T5GApCizy42jXEGv1UgON",
	"TimeStamp": "20180517090848",
	"Seq": "0001",
	"Sig": "AD80102D05D1C31C2056DE130333A8CE"
}

Data加密前:

{
	"StartChargeSeqStat": 2,
	"StartChargeSeq": "123456789201805141125123456",
	"ConnectorID": "3702120244403",
	"StartTime": "2018-05-17 09:08:00"
}

 返回Data参数说明:

参数名称

定义

必填

参数类型

描述

充电订单号

StartChargeSeq

字符串

格式“运营商ID+唯一编号”,27字符

操作结果

SuccStat

整型

0:成功;

1:失败

失败原因

FailReason

整型

0:无;

1:接收失败;

JSON返回示例: 

{
	"Ret": 0,
	"Msg": "",
	"Data": "txMrDfBisaaKVMtgyjeN5ED3C4v51eBE6StYXbAXYy6UF03mjDNSuQcX/GWeiOQd213GIavE+SSNOoYRpDfaxtFmt3RyAHnnK02Sh3Bce1XcjChujzolipzU0RzeG8Ob",
	"Sig": "FFCCC966009B0478A77B489797B0A280"
}

Data解密后:

{
	"StartChargeSeq": "123456789201805141125123456",
	"SuccStat": 0,
	"FailReason": 0
}

五、查询充电状态

1. 接口描述

接口名称:查询充电状态query_equip_charge_status

接口说明:通过充电订单号查询充电状态。

请求格式:json

请求方式:post

2. 注意事项

(1)该接口符合互联互通标准,需要在消息头中配置Content-Type为application/json、Authorization为Bearer token,消息体中必须包括OperatorID,Data,TimeStamp,Seq,Sig,并且对Data部分进行加密,详细说明请参照AES128位加密和MD5签名。

(2)返回数据全部是0:没有启动充电成功。

(3)充电订单号格式:运营商ID+年月日时间+编号

3. 接口示例

请求Data参数说明:

参数名称

定义

必填

参数类型

描述

充电订单号

StartChargeSeq

字符串

格式“运营商ID+唯一编号”,27字符

请求示例:

https://orise.trytowish.cn/evcs/v1/query_equip_charge_status 
{
	"OperatorID": "395815801",
	"Data": "MdtylP2lneRGc9XzcskU+IhZh5yOtroXMW7rHjA9zCP1qc5QDTjBL5dQwgeGTaQ8gHtmHpJTuxovEXmqvYH279y5KsA71X7gs43tggDxdKjGqS+mdFgN3FEo400Eu7UwGJTdxWg+6zo0H+plAlyNO4qsc4tzUJF06mWYcIRJR+RNxm8esvbb3tBLoqXS023sof5qqvzYF8bz23MQ5X8nT5Lbvw+6Ltz6lFOTkKwBW2/jS4LMy4u6LKBbKMOid1aKtZYA4TpMwq167OvZhrEd5ZYN//llSaMythMvYfw8e9yqGnb24U4opQcIyBvKjVuF+mwLKSxRvb0pUP7QnvEBpKRyXGr2TQaL5qWnIo4EYdn40FHASmh2fBPCFpPejReE",
	"TimeStamp": "20180508142408",
	"Seq": "0001",
	"Sig": "D559A351155EA4CC918E5D5F70297D90"
}

Data加密前:

{
	"StartChargeSeq": "123456789201712121131011234"
}

返回Data参数说明:

参数名称

定义

必填

参数类型

描述

充电订单号

StartChargeSeq

字符串

格式“运营商ID+唯一编号”,27字符

充电订单状态

StartChargeSeqStat

整型

1:启动中

2:充电中

3:停止中

4:已结束

5:未知

充电设备接口编码

ConnectorID

字符串

参见《电动汽车充换电服务信息交换   第2部分:公共信息交换规范》

充电设备接口状态

ConnectorStatus

整型

1:空闲

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

电池剩余电量

Soc

浮点型

默认:0

开始充电时间

StartTime

字符型

格式“yyyy-MM-dd HH:mm:ss”

本次采样时间

EndTime

字符型

格式“yyyy-MM-dd HH:mm:ss”

累计充电量

TotalPower

浮点型

单位:度,小数点后3位

累计电费

ElecMoney

浮点型

单位:元,小数点后2位

累计服务费

SeviceMoney

浮点型

单位:元,小数点后2位

累计总金额

TotalMoney

浮点型

单位:元,小数点后2位

时段数N

SumPeriod

整型

范围:0~32

充电明细信息

ChargeDetails

ChargeDetails数组

单时段充电明细信息

充电明细信息体(ChargeDetails)

参数名称

定义

必填

参数类型

描述

开始时间

DetailStartTime

字符串

格式“yyyy-MM-dd HH:mm:ss”

结束时间

DetailEndTime

字符串

格式“yyyy-MM-dd HH:mm:ss”

时段电价

ElecPrice

浮点型

小数点后4位

时段服务费价格

SevicePrice

浮点型

小数点后4位

时段充电量

DetailPower

浮点型

单位:度,小数点后3位

时段电费

DetailElecMoney

浮点型

小数点后2位

时段服务费

DetailSeviceMoney

浮点型

小数点后2位

JSON返回示例: 

{
	"Ret": 0,
	"Msg": "",
	"Data": "y4MAW3YF9ZltQsdZoQwpXAA5FBo+uKyPuU92MLkYYzJPI20WffgZW9ZetNxqFIkbrnWrx1LczaK/9ceUlgnr6cPEIi/xcyB/4cIMZrYL7zovxuW6ZnDNvrQMZn3yxn1B6KBl2JQDlUhjHjb+xETMY34TaiWRM8iMH/lg+Hsl82ruHLxRap5VD1QWhzPsuZqfRmeXzlO1qD1PhyEPka0i/qk5yr/2UVvSC02VTU1ceqh5vVZqCMBN9lGRMfPubAPfCZCUiZLBMi85kbQ2lDHBdiaRdf951CUmpzqg2pcGJ6E3XfkvpK4uycWYWdDyoH7ZyWsS4RxC9CfNfwpCLesnzAQP2kf7Qcvp2MxQ37N7+RM+/cEmTbygOk2txH5O2rlM2dd3HxR29NejtCc6hK+fdEkOBmHEB45uWkxqSwlSl+7ZvN25QrYkfGGanYEvD5dXKY01uSacU6gRmDbFVKIFmRONWy7xFhDAV0wit7ofNeQKhgx1MMnWcwYgg9bBsc1Elh3+nk0Kws6/UCH0EHodgT2s93kgccdYlG4IyFaeFB5yGVxNx159Gg7up5TzxHv4b6D6qhwgjVyOkxVwbs2MXrpNhDEgBKXdasY+XmQr5mIER1l5DdSjsgC8b9pUD0oTyh2WwI/J1ZCs8lvII/AjqvrdOY15j4hW4/T1ekKJyDYkul5OJk9rkkN2PIRnnHF2gVCd2eyrLti/19Rl65/VDVpZTCA2Q2+e8spzlVS4cIE7dZwEZISvC0iV68iz/r0ambPFqZ4ba/TasWE+4ikHIgoBMDkyBF5hc6lSTP1ha0Mx06dIK+RfGsmTHPc3cIlEwkRwHfmd94MLH34uunUttwb4EiOJ/iIp7IlsFu1+rQAHMihSw8T3BiHFiIjSgNiAPtfzR9HnrFhi9qRRmxVXXsPpSRGRupE7f0xwZzPXEl47XQsjYdw8bim3kF+5Uu8BcJc3gr5D6EpIUpyJbdEp0g==",
	"Sig": "3A9C8F5814A1F00B4FAB5DC70DE2BD29"
}

Data解密后: 

{
	"StartChargeSeqStat": 2,
	"StartChargeSeq": "123456789201712121131011234",
	"ConnectorID": "3702120244401",
	"ConnectorStatus": 3,
	"CurrentA": 78.1,
	"CurrentB": 0.0,
	"CurrentC": 0.0,
	"VoltageA": 575.3,
	"VoltageB": 0.0,
	"VoltageC": 0.0,
	"Soc": 5.0,
	"StartTime": "2018-02-06 16:54:38",
	"EndTime": "2018-02-06 17:25:00",
	"TotalPower": 3.54,
	"ElecMoney": 4.956,
	"SeviceMoney": 0.0,
	"TotalMoney": 4.956,
	"SumPeriod": 1,
	"ChargeDetails": [{
		"DetailStartTime": "2018-02-06 16:54:38",
		"DetailEndTime": "2018-02-06 17:25:00",
		"ElecPrice": 1.4,
		"SevicePrice": 0.0,
		"DetailPower": 3.54,
		"DetailElecMoney": 4.956,
		"DetailSeviceMoney": 0.0
	}]
}

六、推送充电状态

1. 接口描述

接口名称:推送充电状态notification_equip_charge_status

接口说明:启动充电后,由特来电每五分钟推一次充电状态。

请求格式:json

请求方式:post

2. 注意事项

        该接口符合互联互通标准,需要在消息头中配置Content-Type为application/json、Authorization为Bearer token,消息体中必须包括OperatorID,Data,TimeStamp,Seq,Sig,并且对Data部分进行加密,详细说明请参照AES128位加密和MD5签名。

3. 接口示例

请求Data参数说明:

参数名称

定义

必填

参数类型

描述

充电订单号

StartChargeSeq

字符串

格式“运营商ID+唯一编号”,27字符

充电订单状态

StartChargeSeqStat

整型

1:启动中

2:充电中

3:停止中

4:已结束

5:未知

充电设备接口编码

ConnectorID

字符串

格式“6位行政区编码,4位电站编码,3位终端编码”,13位字符

充电设备接口状态

ConnectorStatus

整型

1:空闲

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

电池剩余电量

Soc

浮点型

默认:0

开始充电时间

StartTime

字符型

格式“yyyy-MM-dd HH:mm:ss”

本次采样时间

EndTime

字符型

格式“yyyy-MM-dd HH:mm:ss”

累计充电量

TotalPower

浮点型

单位:度,小数点后3位

累计电费

ElecMoney

浮点型

单位:元,小数点后2位

累计服务费

SeviceMoney

浮点型

单位:元,小数点后2位

累计总金额

TotalMoney

浮点型

单位:元,小数点后2位

时段数N

SumPeriod

整型

范围:0~32

充电明细信息

ChargeDetails

ChargeDetails数组

单时段充电明细信息

充电明细信息体(ChargeDetails)

参数名称

定义

必填

参数类型

描述

开始时间

DetailStartTime

字符串

格式“yyyy-MM-dd HH:mm:ss”

结束时间

DetailEndTime

字符串

格式“yyyy-MM-dd HH:mm:ss”

时段电价

ElecPrice

浮点型

小数点后4位

时段服务费价格

SevicePrice

浮点型

小数点后4位

时段充电量

DetailPower

浮点型

单位:度,小数点后3位

时段电费

DetailElecMoney

浮点型

小数点后2位

时段服务费

DetailSeviceMoney

浮点型

小数点后2位

请求示例:

https://orise.trytowish.cn/evcs/v1/notification_equip_charge_status
{
	"OperatorID": "395815801",
	"Data": "y4MAW3YF9ZltQsdZoQwpXAA5FBo+uKyPuU92MLkYYzJPI20WffgZW9ZetNxqFIkbrnWrx1LczaK/9ceUlgnr6dB+/7S5I41ygpKoZkVCEcySnc8CjaKxFz1WSOK7hM4dOVlv/7sFnxpEkIvtrVen+l+WuGpLkibXqoK+8uvO3Bx31pvCk1Yv1rXHP5aAG8k3PSDjYun214ef9OqlVFn3HWRr/UVoK1NKcw2hcoyJCZiHJbKDLk8vcaEk06nPHSOOWbSyJ83KwZi8omPiRzwuDftZ6qm+wkBPEqMFAlLSh3VI5tPOye/7UikkchEq1/GYtzu8gx/RdtYTEHubfKNWiyVYw/pRzk7nsy2tttNjnx+mVN37T5fu82F8fYx0UeCDBLhY/m4IIg18YkinikL6BVdpCgRfcHelFR6T94NMh5cxZwnS98G6ak2YD60gJ1WxWAamBC2W/oSxFowWzKYa2uGnGql+z9wQz/HZWURdTLW1BdSIa5PZHr0LnGAw6KNeHZI/9Gt84HpyTzqIagSGvIUkKMq266hoV9P3ADU9AdAoeprcPFCUGCtmSLqSUNcCNoFBA/LQjYBgyVA0sDZN/4l8L957jMvSDIHFAAR6ry36fFtBkcFRKRbo8SsiSJ9NQ+gYB7hgCnCZ2oTFNYP9lPElmPvttkWacnjSHhXpN6tcsIR80rzSqP7oRLLu4TuCVjH4Dwx3BGhsQ49cXN92RmdIEMs45FDGgrVQr4PDWv5G+zWkOUl/MRYzBpbw/RoIIbK/VhNkASb/+CbeUGo97/Rv3N8ZdEw60LcKNFNNn14p1UnUAJEEPrZSekfkVDzwNx3LxR4O/hfjjZz5+6tTnTaAa0x2pZowB+aPKRUxZGziaecLr31xqLQv6llBSXVpqossiuntvYv8AkmYSgz92/0HTERWbXxOk5/h2vDnM4ikiloaOELsT8zy5rT272srKC6zLQxqL+OOyLQXjucgzw==",
	"TimeStamp": "20180517115611",
	"Seq": "0001",
	"Sig": "A2EF181411E3ADB632396EF1166861EE"
}

Data加密前: 

{
	"StartChargeSeqStat": 2,
	"StartChargeSeq": "123456789201712121131123456",
	"ConnectorID": "3702120244401",
	"ConnectorStatus": 3,
	"CurrentA": 78.1,
	"CurrentB": 0.0,
	"CurrentC": 0.0,
	"VoltageA": 575.3,
	"VoltageB": 0.0,
	"VoltageC": 0.0,
	"Soc": 5.0,
	"StartTime": "2018-02-06 16:54:38",
	"EndTime": "2018-02-06 17:25:00",
	"TotalPower": 3.54,
	"ElecMoney": 4.95,
	"SeviceMoney": 0.00,
	"TotalMoney": 4.95,
	"SumPeriod": 1,
	"ChargeDetails": [{
		"DetailStartTime": "2018-02-06 16:54:38",
		"DetailEndTime": "2018-02-06 17:25:00",
		"ElecPrice": 1.4000,
		"SevicePrice": 0.0000,
		"DetailPower": 3.54,
		"DetailElecMoney": 4.95,
		"DetailSeviceMoney": 0.00
	}]
}

返回Data参数说明:

参数名称

定义

必填

参数类型

描述

充电订单号

StartChargeSeq

字符串

格式“运营商ID+唯一编号”,27字符

操作结果

SuccStat

整型

0:成功;

1:失败

JSON返回示例:  

{
	"Ret": 0,
	"Msg": "",
	"Data": "txMrDfBisaaKVMtgyjeN5ED3C4v51eBE6StYXbAXYy5LNjZyUyJVhR0IqqfO2Ex7bVgj1yEQMMouxF9WhrBDN7Y45zxAVo1mxjVynq34So8=",
	"Sig": "AB13FF6E1DBF35F5CC2B2DC2A255F24C"
}

Data解密后: 

{
	"StartChargeSeq": "123456789201712121131123456",
	"SuccStat": 0
}

七、请求停止充电

1. 接口描述

接口名称:请求停止充电query_stop_charge

接口说明:通过充电订单号、设备接口编码,请求停止充电。

请求格式:json

请求方式:post

2. 注意事项

        该接口符合互联互通标准,需要在消息头中配置Content-Type为application/json、Authorization为Bearer token,消息体中必须包括OperatorID,Data,TimeStamp,Seq,Sig,并且对Data部分进行加密,详细说明请参照AES128位加密和MD5签名。

3. 接口示例

请求Data参数说明:

参数名称

定义

必填

参数类型

描述

充电订单号

StartChargeSeq

字符串

格式“运营商ID+唯一编号”,27字符

充电设备接口编码

ConnectorID

字符串

格式“6位行政区编码,4位电站编码,3位终端编码”,13位字符

  请求示例:

https://orise.trytowish.cn/evcs/v1/query_stop_charge
{
	"OperatorID": "123456789",
	"Data":   "MdtylP2lneRGc9XzcskU+HpnDiRE6mKdB49bQGL2wf0zYfXaVbd7q9DvqRMcuHCJPrlx7YJlRaqX/zT6GVY1Vv4XzmPO/1l8Xv/gwnACAX48Z0eBWGK3A/7ZLbvD62d+QPIP624BrwCZeI7bCGwabg==",
	"TimeStamp": "20171212113129",
	"Seq": "0001",
	"Sig": "5364D7655DDDFFA3466F79CD90233C2E"
}

Data加密前:

{
	"StartChargeSeq": "12345678920171212113101",
	"ConnectorID": "3702120244401"
}

返回Data参数说明:

参数名称

定义

必填

参数类型

描述

充电订单号

StartChargeSeq

字符串

格式“运营商ID+唯一编号”,27字符

充电订单状态

StartChargeSeqStat

整型

1:启动中

2:充电中

3:停止中

4:已结束

5:未知

操作结果

SuccStat

整型

0:成功;

1:失败

失败原因

FailReason

整型

0:无;

1:此设备不存在;

2:此设备离线:

3:设备已停止充电;

4~99:自定义

JSON返回示例: 

{
	"Ret": 0,
	"Msg": "",
	"Data": "txMrDfBisaaKVMtgyjeN5HboJnv1/FU6mKi7FhjyfLPjUnNZp06k1liio5Cdhn8wVoqqmSCH8jTWBCGEk6ooAMzZb3aLzVfbWB2MpeVW8XUI4m6X2hoIQWtyRY24VY9zyaw9QwO5Z6bpWjJ0YrVennVyz9a4C29uxp8ui0oWg+9TAcy+zPLF1C6Hcj1zk3dLiGi8ZWuttZmBWWs8DoGl5g==",
	"Sig": "8208691E4DDEBAB4CE96A95FC607D49C"
}

Data解密后: 

{
	"StartChargeSeqStat": 1,
	"StartChargeSeq": "12345678920171212113101",
	"ConnectorID": "3702120244401",
	"SuccStat": 0,
	"FailReason": 0
}

八、推送停止充电结果

1. 接口描述

接口名称:推送停止充电结果notification_stop_charge_result

接口说明:发起停止充电请求后,由特来电方推送停止充电结果,包括充电订单号、订单状态、充电设备接口编码、充电启动时间。

请求格式:json

请求方式:post

2. 注意事项

        该接口符合互联互通标准,需要在消息头中配置Content-Type为application/json、Authorization为Bearer token,消息体中必须包括OperatorID,Data,TimeStamp,Seq,Sig,并且对Data部分进行加密,详细说明请参照AES128位加密和MD5签名。

3. 接口示例

请求Data参数说明:

参数名称

定义

必填

参数类型

描述

充电订单号

StartChargeSeq

字符串

格式“运营商ID+唯一编号”,27字符

充电订单状态

StartChargeSeqStat

整型

1:启动中

2:充电中

3:停止中

4:已结束

5:未知

充电设备接口编码

ConnectorID

字符串

格式“6位行政区编码,4位电站编码,3位终端编码”,13位字符

成功标识

SuccStat

整型

0:成功;

1:失败

停止失败原因

FailReason

整型

0:无;

1:此设备不存在;

2:此设备离线:

3:设备已停止充电;

4~99:自定义

请求示例:

https://orise.trytowish.cn/evcs/v1/notification_stop_charge_result
{
	"OperatorID": "395815801",
	"Data": "y4MAW3YF9ZltQsdZoQwpXEtIUyfjfvhZKKanQYvBqh1zsL8iV1X9KW1YQ9CO6LPw0spcwc6cRhkQtWTunpl11wjehIEIg5B8Ucu85EqtX1CxtkmvUcrjSRIY6EbQmOzUyjS01r3t6PmMX70OMZ7AhfUQpx+hhbfmuNKn6nrZXFiA+mUIHExOPSttoRQHn8yAvMckJaazGFuIxK15+9YKVg==",
	"TimeStamp": "20180517091324",
	"Seq": "0001",
	"Sig": "19AE8C3B5383CF20D586AC408048D135"
}

Data加密前: 

{
	"StartChargeSeq": "123456789201805141125123456",
	"StartChargeSeqStat": 4,
	"ConnectorID": "3702120244403",
	"SuccStat": 0,
	"FailReason": 0
}

返回Data参数说明:

参数名称

定义

必填

参数类型

描述

充电订单号

StartChargeSeq

字符串

格式“运营商ID+唯一编号”,27字符,与6.5.3章节相同

操作结果

SuccStat

整型

0:成功;

1:失败

失败原因

FailReason

整型

0:无;

1:接收失败;

JSON返回示例:  

{
	"Ret": 0,
	"Msg": "",
	"Data": "txMrDfBisaaKVMtgyjeN5ED3C4v51eBE6StYXbAXYy6UF03mjDNSuQcX/GWeiOQd213GIavE+SSNOoYRpDfaxtFmt3RyAHnnK02Sh3Bce1XcjChujzolipzU0RzeG8Ob",
	"Sig": "FFCCC966009B0478A77B489797B0A280"
}

Data解密后:

{
	"StartChargeSeq": "123456789201805141125123456",
	"SuccStat": 0,
	"FailReason": 0
}

九、推送充电订单信息

1. 接口描述

接口名称:推送充电订单信息notification_charge_order_info

接口说明:结束充电后,由特来电推送充电订单信息。

请求格式:json

请求方式:post

2. 注意事项

        该接口符合互联互通标准,需要在消息头中配置Content-Type为application/json、Authorization为Bearer token,消息体中必须包括OperatorID,Data,TimeStamp,Seq,Sig,并且对Data部分进行加密,详细说明请参照AES128位加密和MD5签名。

3. 接口示例

请求Data参数说明:

参数名称

定义

必填

参数类型

描述

充电订单号

StartChargeSeq

字符串

格式“运营商ID+唯一编号”,27字符

充电设备接口编码

ConnectorID

字符串

格式“6位行政区编码,4位电站编码,3位终端编码”,13位字符

开始充电时间

StartTime

字符串

格式“yyyy-MM-dd HH:mm:ss”

结束充电时间

EndTime

字符串

格式“yyyy-MM-dd HH:mm:ss”

累计充电量

TotalPower

浮点型

单位:度,小数点后3位

总电费

TotalElecMoney

浮点型

单位:元,小数点后2位

总服务费

TotalSeviceMoney

浮点型

单位:元,小数点后2位

累计总金额

TotalMoney

浮点型

单位:元,小数点后2位

充电结束原因

StopReason

整型

0:用户手动停止充电

1:客户归属地运营商平台停止充电

2:BMS停止充电;

3:充电机设备故障;

4:连接器断开

5-99自定义

时段数N

SumPeriod

整型

范围:0~32

充电明细信息

ChargeDetails

ChargeDetails数组

单时段充电明细信息

请求示例:

https://orise.trytowish.cn/evcs/v1/notification_charge_order_info
{
	"OperatorID": "395815801",
	"Data": "MdtylP2lneRGc9XzcskU+IhZh5yOtroXMW7rHjA9zCP1qc5QDTjBL5dQwgeGTaQ8gHtmHpJTuxovEXmqvYH279y5KsA71X7gs43tggDxdKjGqS+mdFgN3FEo400Eu7UwGJTdxWg+6zo0H+plAlyNO4qsc4tzUJF06mWYcIRJR+RNxm8esvbb3tBLoqXS023sof5qqvzYF8bz23MQ5X8nT5Lbvw+6Ltz6lFOTkKwBW2/jS4LMy4u6LKBbKMOid1aKtZYA4TpMwq167OvZhrEd5ZYN//llSaMythMvYfw8e9yqGnb24U4opQcIyBvKjVuF+mwLKSxRvb0pUP7QnvEBpKRyXGr2TQaL5qWnIo4EYdn40FHASmh2fBPCFpPejReE",
	"TimeStamp": "20180508142408",
	"Seq": "0001",
	"Sig": "D559A351155EA4CC918E5D5F70297D90"
}

Data加密前: 

{
	"StartChargeSeq": "395815801201708081212000874",
	"ConnectorID": "3702120244206",
	"StartTime": "2017-08-08 11:29:29",
	"EndTime": "2017-08-08 11:30:30",
	"TotalPower": 0.00,
	"TotalElecMoney": 0.00,
	"TotalSeviceMoney": 0.00,
	"TotalMoney": 0.00,
	"StopReason": 2,
	"SumPeriod": 0,
	"ChargeDetails": []
}

返回Data参数说明:

参数名称

定义

必填

参数类型

描述

充电订单号

StartChargeSeq

字符串

格式“运营商ID+唯一编号”,27字符

充电设备接口编码

ConnectorID

字符串

格式“6位行政区编码,4位电站编码,3位终端编码”,13位字符

确认结果

ConfirmResult

整型

0:成功

1:争议交易

2~99:自定义

JSON返回示例:  

{
	"Ret": 0,
	"Msg": "",
	"Data": "txMrDfBisaaKVMtgyjeN5FANrPW8n3hMti3/goA3YYWF2TzfTi4NRh4qAKEjS5GKNsPUqhjc4SciRyTU31gcMSJJx5H6O8ePMHmUPHiGvbb0o8XvR8hFMWMcvxD+p/uk4nIsPnPfcuVjwVD93L8vltamIsC7I286I/ne5XmMH8Y=",
	"Sig": "79CCB062AE00D471F79925FE916D7C61"
}

Data解密后:

{
	"StartChargeSeq": "395815801201708081212000874",
	"ConnectorID": "3702120244206",
	"ConfirmResult": 0
}

参考标准


T/CEC 102.1-2016 电动汽车充换电服务信息交换 第1部分:总则
T/CEC 102.2-2016 电动汽车充换电服务信息交换 第2部分: 公共信息交换规范
T/CEC 102.3-2016 电动汽车充换电服务信息交换 第3部分: 业务信息交换规范
T/CEC 102.4-2016 电动汽车充换电服务信息交换 第4部分: 数据传输及安全

相关链接

奥升充电|互联互通协议解析(1)——平台认证-CSDN博客

奥升充电|互联互通协议解析(2)——公共信息交换规范-CSDN博客

奥升充电|互联互通协议解析(3)——业务信息交换规范-CSDN博客

奥升充电|互联互通协议解析(4)——常见问题-CSDN博客

奥升新能源技术服务平台icon-default.png?t=N7T8https://orise.trytowish.cn/

仓库后端前端小程序
Github充电平台微服务源码充电管理后台源码充电小程序源码
GitCode充电平台微服务源码充电管理后台源码充电小程序源码
Gitee充电平台微服务源码
充电平台微服务源码(备用)
充电管理后台源码充电小程序源码

  • 17
    点赞
  • 7
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值