一、查询业务策略信息
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部分: 数据传输及安全
相关链接
奥升充电|互联互通协议解析(2)——公共信息交换规范-CSDN博客
奥升充电|互联互通协议解析(3)——业务信息交换规范-CSDN博客
奥升新能源技术服务平台https://orise.trytowish.cn/
仓库 | 后端 | 前端 | 小程序 |
---|---|---|---|
Github | 充电平台微服务源码 | 充电管理后台源码 | 充电小程序源码 |
GitCode | 充电平台微服务源码 | 充电管理后台源码 | 充电小程序源码 |
Gitee | 充电平台微服务源码 充电平台微服务源码(备用) | 充电管理后台源码 | 充电小程序源码 |