技术解析2024-08-09

奥升充电｜互联互通协议解析（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": "<redacted_base64>=",
	"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": "<redacted_base64>",
	"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位字符

请求示例：

https://orise.trytowish.cn/evcs/v1/query_equip_auth

{
	"OperatorID": "123456789",
	"Data": "<redacted_base64>",
	"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": "<redacted_base64>=",
	"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": "<redacted_base64>=",
	"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": "<redacted_base64>==",
	"Sig": "0BFDBAF99152EDAF2A0EC56FED6B5BF5"
}

Data 解密后：

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

四、推送启动充电结果

1. 接口描述

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

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

请求格式：json

请求方式：post

2. 注意事项

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": "<redacted_base64>",
	"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": "<redacted_base64>",
	"Sig": "FFCCC966009B0478A77B489797B0A280"
}

Data 解密后：

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

五、查询充电状态

1. 接口描述

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

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

请求格式：json

请求方式：post

2. 注意事项

该接口符合互联互通标准，需要在消息头中配置 Content-Type 为 application/json、Authorization 为 Bearer token，消息体中必须包括 OperatorID, Data, TimeStamp, Seq, Sig, 并且对 Data 部分进行加密，详细说明请参照 AES128位加密和 MD5签名。
返回数据全部是0：没有启动充电成功。
充电订单号格式：运营商ID+年月日时间+编号

3. 接口示例

请求 Data 参数说明：

参数名称	定义	必填	参数类型	描述
充电订单号	StartChargeSeq	是	字符串	格式“运营商ID+唯一编号”，27字符

请求示例：

https://orise.trytowish.cn/evcs/v1/query_equip_charge_status

{
	"OperatorID": "395815801",
	"Data": "<redacted_base64>",
	"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": "<redacted_base64>==",
	"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. 注意事项

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": "<redacted_base64>=",
	"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": "<redacted_base64>=",
	"Sig": "AB13FF6E1DBF35F5CC2B2DC2A255F24C"
}

Data 解密后：

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

七、请求停止充电

1. 接口描述

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

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

请求格式：json

请求方式：post

2. 注意事项

3. 接口示例

请求 Data 参数说明：

参数名称	定义	必填	参数类型	描述
充电订单号	StartChargeSeq	是	字符串	格式“运营商ID+唯一编号”，27字符
充电设备接口编码	ConnectorID	是	字符串	格式“6位行政区编码，4位电站编码，3位终端编码”，13位字符

请求示例：

https://orise.trytowish.cn/evcs/v1/query_stop_charge

{
	"OperatorID": "123456789",
	"Data": "<redacted_base64>=",
	"TimeStamp": "20171212113129",
	"Seq": "0001",
	"Sig": "5364D7655DDDFFA3466F79CD90233C2E"
}

Data 加密前：

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

返回 Data 参数说明：

参数名称	定义	必填	参数类型	描述
充电订单号	StartChargeSeq	是	字符串	格式“运营商ID+唯一编号”，27字符
充电订单状态	StartChargeSeqStat	是	整型	1：启动中；2：充电中；3：停止中；4：已结束；5：未知
充电设备接口编码	ConnectorID	是	字符串	参见《电动汽车充换电服务信息交换第2部分：公共信息交换规范》
操作结果	SuccStat	是	整型	0:成功；1:失败
失败原因	FailReason	是	整型	0:无；1:此设备不存在；2:此设备离线；3:设备已停止充电；4～99:自定义

JSON 返回示例：

{
	"Ret": 0,
	"Msg": "",
	"Data": "<redacted_base64>=",
	"Sig": "8208691E4DDEBAB4CE96A95FC607D49C"
}

Data 解密后：

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

八、推送停止充电结果

1. 接口描述

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

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

请求格式：json

请求方式：post

2. 注意事项

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": "<redacted_base64>=",
	"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": "<redacted_base64>=",
	"Sig": "FFCCC966009B0478A77B489797B0A280"
}

Data 解密后：

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

九、推送充电订单信息

1. 接口描述

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

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

请求格式：json

请求方式：post

2. 注意事项

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": "<redacted_base64>=",
	"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": "<redacted_base64>=",
	"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部分: 数据传输及安全

需要针对你的场站做评估？

提供场站规模与电力条件，我们可以给出方案思路与投资估算。

提交项目需求