電動汽車充換電服務(wù)信息交換 第3部分:業(yè)務(wù)信息交換規(guī)范_第1頁
電動汽車充換電服務(wù)信息交換 第3部分:業(yè)務(wù)信息交換規(guī)范_第2頁
電動汽車充換電服務(wù)信息交換 第3部分:業(yè)務(wù)信息交換規(guī)范_第3頁
電動汽車充換電服務(wù)信息交換 第3部分:業(yè)務(wù)信息交換規(guī)范_第4頁
電動汽車充換電服務(wù)信息交換 第3部分:業(yè)務(wù)信息交換規(guī)范_第5頁
已閱讀5頁,還剩46頁未讀 繼續(xù)免費閱讀

下載本文檔

版權(quán)說明:本文檔由用戶提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請進行舉報或認領(lǐng)

文檔簡介

ICS35.240.60L73T/CEC電動汽車充換電服務(wù)信息交換第3部分:業(yè)務(wù)信息交換規(guī)范FORMTEXTInteractiveofchargingandbatteryswapserviceinformationforelectricvehicles

Part3:Businessinformationexchangespecification(征求意見稿)2019-06-19FORMTEXTXXXX-FORMTEXTXX-FORMTEXTXX發(fā)布FORMTEXTXXXX-FORMTEXTXX-FORMTEXTXX實施中國電力企業(yè)聯(lián)合會發(fā)布T/CEC102.3—2016T/CEC102.3—2016電動汽車充換電服務(wù)信息交換第3部分:業(yè)務(wù)信息交換規(guī)范范圍本部分規(guī)定了電動汽車充換電業(yè)務(wù)信息服務(wù)交換的方法,包括業(yè)務(wù)信息交換的接口流程、接口功能和接口協(xié)議。本部分適用于不同運營商服務(wù)平臺之間的充換電服務(wù)信息交換,以及電動汽車充換電服務(wù)平臺與第三方服務(wù)及管理平臺之間的信息交換。規(guī)范性引用文件下列文件對于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件,僅注日期的版本適用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改單)適用于本文件。GB/T19596—2004電動汽車術(shù)語GB/T29317—2012電動汽車充換電設(shè)施術(shù)語T/CEC102.1—2016電動汽車充換電服務(wù)信息交換第1部分:總則T/CEC102.2—2016電動汽車充換電服務(wù)信息交換第2部分:公共信息交換規(guī)范術(shù)語和定義GB/T19596—2004、GB/T29317—2012以及T/CEC102.1—201*屆定的以及下列術(shù)語和定義適用于本文件??蛻魝?cè)發(fā)起業(yè)務(wù)交互EVdriver’sserviceoperatorinitiatedinteraction用戶采用手機APP等方式,由客戶運營商發(fā)起電動汽車充換電服務(wù)信息交換的過程。設(shè)備側(cè)發(fā)起業(yè)務(wù)交互EVIserviceoperatorinitiatedinteraction用戶采用刷卡等方式,由基礎(chǔ)設(shè)施歸屬運營商發(fā)起電動汽車充換電服務(wù)信息交換的過程。業(yè)務(wù)信息交換流程客戶側(cè)發(fā)起業(yè)務(wù)交互流程客戶側(cè)發(fā)起業(yè)務(wù)交互由用戶發(fā)起,客戶歸屬運營商的電動汽車充換電服務(wù)平臺向基礎(chǔ)設(shè)施運營商的電動汽車充換電服務(wù)平臺發(fā)起信息交換業(yè)務(wù),實現(xiàn)此業(yè)務(wù)的7項業(yè)務(wù)交互流程如圖1所示,具體業(yè)務(wù)時序參見附錄A中的圖A.1??蛻魝?cè)發(fā)起業(yè)務(wù)交互流程圖具體業(yè)務(wù)功能包括設(shè)備認證服務(wù)、查詢業(yè)務(wù)策略服務(wù)(可選)、啟動充電服務(wù)、充電監(jiān)控服務(wù)(可選)、充電停止服務(wù)(可選)、充電訂單服務(wù)、訂單對賬服務(wù)。設(shè)備側(cè)發(fā)起業(yè)務(wù)交互流程設(shè)備側(cè)發(fā)起業(yè)務(wù)交互由用戶發(fā)起,基礎(chǔ)設(shè)施運營商的電動汽車充換電服務(wù)平臺向客戶歸屬運營商的電動汽車充換電服務(wù)平臺發(fā)起信息交換業(yè)務(wù),實現(xiàn)此業(yè)務(wù)的6項業(yè)務(wù)交互流程如圖2所示,具體業(yè)務(wù)時序參見附錄A中的圖A.2。設(shè)備側(cè)發(fā)起業(yè)務(wù)交互流程圖具體業(yè)務(wù)功能包括用戶認證服務(wù)、查詢業(yè)務(wù)策略服務(wù)(可選)、充電監(jiān)控服務(wù)(可選)、充電停止服務(wù)(可選)、充電訂單服務(wù)、訂單對賬服務(wù)。業(yè)務(wù)信息交換功能業(yè)務(wù)信息交換功能分類業(yè)務(wù)信息交換規(guī)范共設(shè)計7個業(yè)務(wù)功能,分別是:設(shè)備認證服務(wù)查詢業(yè)務(wù)策略服務(wù)啟動充電服務(wù)充電監(jiān)控服務(wù)充電停止服務(wù)充電訂單服務(wù)訂單對賬服務(wù)設(shè)備認證服務(wù)設(shè)備認證數(shù)據(jù)流程圖設(shè)備認證服務(wù)用于客戶歸屬運營商向基礎(chǔ)設(shè)施運營商查詢電動汽車充電基礎(chǔ)設(shè)施的可用狀態(tài),業(yè)務(wù)流程參見圖3。主要包含請求設(shè)備認證接口。查詢業(yè)務(wù)策略服務(wù)a)客戶側(cè)發(fā)起流程b)基礎(chǔ)設(shè)施側(cè)發(fā)起業(yè)務(wù)策略數(shù)據(jù)數(shù)據(jù)流程圖查詢業(yè)務(wù)策略服務(wù)用于客戶歸屬運營商向基礎(chǔ)設(shè)施運營商查詢充電基礎(chǔ)設(shè)施的計費信息或基礎(chǔ)設(shè)施運營商向客戶歸屬運營商查詢用戶計費信息,業(yè)務(wù)流程參見圖4。主要包含查詢業(yè)務(wù)策略信息接口。啟動充電服務(wù)啟動充電服務(wù)數(shù)據(jù)流程圖啟動充電服務(wù)用于客戶歸屬運營商服務(wù)平臺請求啟動充電,基礎(chǔ)設(shè)施運營商服務(wù)平臺完成啟動充電后推送啟動充電結(jié)果,業(yè)務(wù)流程參見圖5。主要包含請求啟動充電接口和推送啟動充電結(jié)果接口。啟動充電推送信息需要及時發(fā)送給客戶歸屬運營商服務(wù)平臺。。充電監(jiān)控服務(wù)(可選)充電監(jiān)控服務(wù)用于電動汽車充電基礎(chǔ)設(shè)施變化狀態(tài)的查詢或推送,基礎(chǔ)設(shè)施運營商服務(wù)平臺推送業(yè)務(wù)流程參見圖6,客戶歸屬運營商服務(wù)平臺查詢業(yè)務(wù)流程參見圖7。主要包含推送充電狀態(tài)接口和查詢充電狀態(tài)接口。充電業(yè)務(wù)服務(wù)推送數(shù)據(jù)流程圖充電業(yè)務(wù)服務(wù)查詢數(shù)據(jù)流程圖充電停止服務(wù)(可選)充電停止服務(wù)數(shù)據(jù)流程圖充電停止服務(wù)用于客戶歸屬運營商服務(wù)平臺請求停止充電,基礎(chǔ)設(shè)施運營商服務(wù)平臺停止充電后及時推送停止充電結(jié)果,業(yè)務(wù)流程參見圖8。主要包含請求停止充電接口和推送停止充電結(jié)果接口。充電訂單服務(wù)充電訂單服務(wù)數(shù)據(jù)流程圖充電訂單服務(wù)用于基礎(chǔ)設(shè)施運營商服務(wù)平臺向客戶歸屬運營商服務(wù)平臺推送充電訂單信息,業(yè)務(wù)流程參見圖9。主要包含推送充電訂單信息接口。訂單對賬服務(wù)充電停止服務(wù)數(shù)據(jù)流程圖訂單對賬服務(wù)用于基礎(chǔ)設(shè)施運營商服務(wù)平臺向客戶歸屬運營商服務(wù)平臺推送訂單對賬信息,業(yè)務(wù)流程參見圖10。主要包含推送訂單對賬信息接口。業(yè)務(wù)信息交換接口協(xié)議概述業(yè)務(wù)信息交換共分為10個接口,分別為:請求設(shè)備認證查詢業(yè)務(wù)策略信息請求啟動充電推送啟動充電結(jié)果查詢充電狀態(tài)推送充電狀態(tài)請求停止充電推送停止充電結(jié)果推送充電訂單信息推送訂單對賬信息請求設(shè)備認證概述此接口用于客戶歸屬運營商請求充電基礎(chǔ)設(shè)施的認證信息。接口定義接口名稱:query_equip_auth接口使用方法:由基礎(chǔ)設(shè)施運營商服務(wù)平臺實現(xiàn)此接口,客戶歸屬運營商服務(wù)平臺方調(diào)用。輸入?yún)?shù)請求認證接口的主要輸入?yún)?shù)為設(shè)備認證流水號和充電設(shè)備接口編碼,具體內(nèi)容參見表1。表SEQ表\*ARABIC1請求設(shè)備認證的輸入?yún)?shù)表參數(shù)名稱定義參數(shù)類型描述設(shè)備認證流水號EquipAuthSeq字符串格式“運營商ID+唯一編號”,不超過64字符充電設(shè)備接口編碼ConnectorID字符串參見T/CEC102.2返回值請求認證接口的主要返回值為設(shè)備認證流水號、充電設(shè)備接口編碼、操作結(jié)果和失敗原因,具體內(nèi)容參見表2。表SEQ表\*ARABIC2請求設(shè)備認證的返回值表參數(shù)名稱定義參數(shù)類型描述設(shè)備認證流水號EquipAuthSeq字符串格式“運營商ID+唯一編號”,不超過64字符,與6.2.3中相同充電設(shè)備接口編碼ConnectorID字符串參見T/CEC102.2操作結(jié)果SuccStat整型0:成功;1:失敗失敗碼FailReasonCode整型0.無1.此設(shè)備尚未插槍2.設(shè)備檢測失敗3.設(shè)備離網(wǎng)4.設(shè)備故障5.參數(shù)錯誤6.設(shè)備不存在50~99:自定義各廠家根據(jù)實際情況定義失敗信息FailReasonMsg字符串失敗原因的描述。示例{"Ret":0,"Msg":"","Data":{"EquipAuthSeq":"12345678920160514083059","ConnectorID":"10000000000000000000000001","SuccStat":0,"FailReasonCode":0,"FailReasonMsg":""},"Sig":"7130B533249635CD17F113B1D55C2911"}查詢計費策略信息概述此接口用于客戶歸屬運營商向基礎(chǔ)設(shè)施運營商查詢充電樁計費策略信息。接口定義接口名稱:query_equip_business_policy接口使用方法:由基礎(chǔ)設(shè)施運營商服務(wù)平臺實現(xiàn)此接口,客戶歸屬運營商服務(wù)平臺方調(diào)用。輸入?yún)?shù)查詢業(yè)務(wù)策略信息接口的主要輸入?yún)?shù)為業(yè)務(wù)策略查詢流水號和充電設(shè)備接口編碼,具體內(nèi)容參見表3。表SEQ表\*ARABIC3查詢業(yè)務(wù)策略信息的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述業(yè)務(wù)策略查詢流水號EquipBizSeq是字符串格式“運營商ID+唯一編號”,不超過64字符充電設(shè)備接口編碼ConnectorID是字符串參見T/CEC102.2返回值查詢業(yè)務(wù)策略信息接口的主要返回值為業(yè)務(wù)的計費策略,采用多時段計費方式,每個時段均包含一個單項業(yè)務(wù)策略信息體列表,返回值參見表4,單項業(yè)務(wù)策略信息體的參數(shù)和內(nèi)容參見表5。表SEQ表\*ARABIC4查詢業(yè)務(wù)策略信息的返回值表參數(shù)名稱定義必填參數(shù)類型描述業(yè)務(wù)策略查詢流水號EquipBizSeq是字符串格式“運營商ID+唯一編號”,不超過64字符,與6.3.3中相同充電設(shè)備接口編碼ConnectorID是字符串參見T/CEC102.2操作結(jié)果SuccStat是整型0:成功;1:失敗失敗碼FailReason是整型0:無;1:此充電樁業(yè)務(wù)策略不存在時段數(shù)NSumPeriod是整型范圍:0~32計費信息PolicyInfos是policyInfos數(shù)組單項業(yè)務(wù)策略信息體表SEQ表\*ARABIC5單項業(yè)務(wù)策略信息體的參數(shù)表參數(shù)名稱定義必填參數(shù)類型描述時段起始時間點StartTime是字符串格式“HHmmss”,6字符基礎(chǔ)電費價格ElecPrice是浮點型單位:元/度,小數(shù)點后4位?;A(chǔ)服務(wù)費價格ServicePrice是浮點型單位:元/度,小數(shù)點后4位。協(xié)議電費價格DiscountElecPrice是浮點型單位:元/度,小數(shù)點后4位?;A(chǔ)設(shè)施運營商和客戶歸屬運營商協(xié)議電價。無協(xié)議電價,則填寫基礎(chǔ)電費價格。協(xié)議服務(wù)費價格DiscountServicePrice是浮點型單位:元/度,小數(shù)點后4位。基礎(chǔ)設(shè)施運營商和客戶歸屬運營商協(xié)議服務(wù)費。無協(xié)議服務(wù)費,則填寫基礎(chǔ)服務(wù)費。示例{"Ret":0,"Msg":"","Data":{"EquipBizSeq":"12345678920160514083059","ConnectorID":"10000000000000000000000001","SuccStat":0,"FailReason":0,"SumPeriod":1,"PolicyInfos":[{"StartTime":"030234","ElecPrice":1.2731,"SevicePrice":0.3713,"DiscountElecPrice":1.2731,"DiscountServicePrice":0.3713}]},"Sig":"7130B533249635CD17F113B1D55C2911"}請求啟動充電概述此接口用于客戶歸屬運營商請求設(shè)備歸屬運營商啟動充電信息,發(fā)送啟動充電命令,不代表啟動充電成功。接口定義接口名稱:start_charge接口使用方法:由基礎(chǔ)設(shè)施運營商服務(wù)平臺實現(xiàn)此接口,客戶歸屬運營商服務(wù)平臺方調(diào)用。輸入?yún)?shù)請求啟動充電接口的主要輸入?yún)?shù)為充電訂單號、充電設(shè)備接口編碼和二維碼其他信息,具體內(nèi)容參見表6。表SEQ表\*ARABIC6請求啟動充電的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符充電設(shè)備接口編碼ConnectorID是字符串參見T/CEC102.2二維碼其他信息QRCode是字符串參見T/CEC102.2,二維碼中含有自定義部分的,需要將自定義部分的原文傳輸。具體二維碼數(shù)據(jù)參考基礎(chǔ)設(shè)施運營商要求。用戶編號UserNo否字符串長度不超過32個字符手機號Phone否字符串長度11個字符車牌號LicensePlate否字符串長度不超過20個字符車輛識別碼VIN否字符串參照GB/T27930標準規(guī)定,長度17位字符預(yù)凍結(jié)金額PreFrozenAmount否浮點型客戶歸屬運營商采用預(yù)付費方式時,充電總費用接近此預(yù)付金額時,建議充電設(shè)施運營商主動停止充電,防止過充情況。返回值請求啟動充電接口的主要返回值包含充電訂單號、充電訂單狀態(tài)、充電設(shè)備接口編碼、操作結(jié)果和失敗原因,具體內(nèi)容參見表7。表SEQ表\*ARABIC7請求啟動充電的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符。充電訂單狀態(tài)OrderStatus是整型1、啟動中2、充電中3、停止中4、充電完成5、訂單掛起6、充電異常結(jié)束7、啟動失敗充電設(shè)備接口編碼ConnectorID是字符串參見T/CEC102.2操作結(jié)果SuccStat是整型0:成功;1:失敗充電啟動超時時間OverTime是整形單位:秒,參數(shù)范圍建議不超過900s,實際充電啟動結(jié)果的超時判斷時間。失敗碼FailReasonCode是整型0:無1:此設(shè)備不存在(設(shè)備已下線或站點非正常使用狀態(tài)時,認為設(shè)備不存在)2:此設(shè)備離線3:無此設(shè)備使用權(quán)限4:此設(shè)備正忙50-999:自定義失敗信息FailReasonMsg是字符串失敗原因的描述示例{"Ret":0,"Msg":"","Data":{"OrderNo":"123456789201605140830591234","OrderStatus":1,"ConnectorID":"10000000000000000000000001","SuccStat":0,"OverTime":300,"FailReasonCode":0,"FailReasonMsg":""},"Sig":"7130B533249635CD17F113B1D55C2911"}推送啟動充電結(jié)果概述此接口用于設(shè)備歸屬運營商向客戶歸屬運營商推送啟動充電結(jié)果信息。接口定義接口名稱:notification_start_charge_result接口使用方法:由客戶歸屬運營商服務(wù)平臺實現(xiàn)此接口,基礎(chǔ)設(shè)施運營商服務(wù)平臺方調(diào)用。輸入?yún)?shù)推送啟動充電結(jié)果接口的主要輸入?yún)?shù)為充電訂單號、充電設(shè)備接口編碼和充電啟動時間,具體內(nèi)容參見表8。表SEQ表\*ARABIC8推送啟動充電結(jié)果的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符充電訂單狀態(tài)OrderStatus是整型1、啟動中2、充電中3、停止中4、充電完成5、訂單掛起6、充電異常結(jié)束7、啟動失敗充電設(shè)備接口編碼ConnectorID是字符串參見T/CEC102.2充電啟動時間StartTime是字符串格式“yyyy-MM-ddHH:mm:ss”,啟動失敗后為當前時間值,接收方可忽略。停止充電驗證碼IdentCode否字符串啟動充電時收到的驗證碼,用于充電樁手動停止充電時間戳PushTimeStamp是字符串格式“yyyy-MM-ddHH:mm:ss”,推送信息的推送時間。失敗碼FailReasonCode否整型0:無;1:此設(shè)備不存在(設(shè)備已下線或站點非正常使用狀態(tài)時,認為設(shè)備不存在)2:此設(shè)備離線3:無此設(shè)備使用權(quán)限4:此設(shè)備正忙50-99:自定義失敗信息FailReasonMsg否字符串失敗原因的描述返回值推送啟動充電結(jié)果接口的主要返回值為充電訂單號、操作結(jié)果、失敗原因和停止充電驗證碼,具體內(nèi)容參見表9。表SEQ表\*ARABIC9推送啟動充電結(jié)果的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符操作結(jié)果SuccStat是整型0:成功;1:失敗失敗原因FailReasonMsg是字符串失敗原因的描述示例{"Ret":0,"Msg":"","Data":{"OrderNo":"123456789201605140830591234","SuccStat":0,"FailReasonMsg":"",},"Sig":"7130B533249635CD17F113B1D55C2911"}查詢訂單狀態(tài)概述此接口用于客戶歸屬運營商請求設(shè)備歸屬運營商充電訂單狀態(tài)信息。接口定義接口名稱:query_equip_charge_status接口使用方法:由基礎(chǔ)設(shè)施運營商服務(wù)平臺實現(xiàn)此接口,客戶歸屬運營商服務(wù)平臺方調(diào)用。輸入?yún)?shù)查詢充電訂單狀態(tài)接口的主要輸入?yún)?shù)為充電訂單號,具體內(nèi)容參見表10。表SEQ表\*ARABIC10查詢充電訂單狀態(tài)的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符返回值查詢充電訂單狀態(tài)接口的主要返回值為充電訂單號、充電訂單狀態(tài)、充電設(shè)備接口編碼、相關(guān)狀態(tài)信息和充電明細信息體列表,具體內(nèi)容參見表11,充電明細信息體內(nèi)容參見表12。表SEQ表\*ARABIC11查詢充電狀態(tài)的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符用戶編號UserNo否字符串長度不超過255手機號Phone否字符串長度11個字符車牌號LicensePlate否字符串長度不超過20個字符車輛識別碼VIN否字符串參照GB/T27930標準規(guī)定充電訂單狀態(tài)OrderStatus是整型1、啟動中2、充電中3、停止中4、充電完成5、訂單掛起6、充電異常結(jié)束7、啟動失敗充電設(shè)備接口編碼ConnectorID是字符串參見T/CEC102.2—2016充電設(shè)備接口狀態(tài)ConnectorStatus是整型1:空閑;2:占用(未充電);3:占用(充電中);4:占用(預(yù)約鎖定);255:故障A相電流CurrentA是浮點型單位:A,默認:0含直流(輸出)A相電壓VoltageA是浮點型單位:V,默認:0含直流(輸出)B相電流CurrentB否浮點型單位:A,默認:0B相電壓VoltageB否浮點型單位:V,默認:0C相電流CurrentC否浮點型單位:A,默認:0C相電壓VoltageC否浮點型單位:V,默認:0電池剩余電量Soc是浮點型默認:0,小數(shù)點后1位開始充電時間StartTime是字符型格式“yyyy-MM-ddHH:mm:ss”本次采樣時間EndTime是字符型格式“yyyy-MM-ddHH:mm:ss”累計充電量TotalPower是浮點型單位:度,小數(shù)點后3位累計電費ElecMoney否浮點型單位:元,小數(shù)點后2位累計服務(wù)費SeviceMoney否浮點型單位:元,小數(shù)點后2位累計總金額TotalMoney否浮點型單位:元,小數(shù)點后2位時段數(shù)NSumPeriod否整型范圍:0~32充電明細信息ChargeDetails否ChargeDetails數(shù)組單時段充電明細信息,見6.6.4表SEQ表\*ARABIC12充電明細信息體的參數(shù)表參數(shù)名稱定義必填參數(shù)類型描述開始時間DetailStartTime是字符串格式“yyyy-MM-ddHH:mm:ss”結(jié)束時間DetailEndTime是字符串格式“yyyy-MM-ddHH:mm:ss”時段電價ElecPrice否浮點型單位:元/度,小數(shù)點后4位時段服務(wù)費價格SevicePrice否浮點型單位:元/度,小數(shù)點后4位時段充電量DetailPower是浮點型單位:度,小數(shù)點后2位時段電費DetailElecMoney否浮點型單位:元,小數(shù)點后2位時段服務(wù)費DetailSeviceMoney否浮點型單位:元,小數(shù)點后2位示例{"Ret":0,"Msg":"","Data":{"OrderNo":"123456789201605140830591234","UserNo":"12345679","Phone":,"LicensePlate":"京PXXXX","VIN":"1234567890","OrderNoStat":2,"ConnectorID":"10000000000000000000000001","ConnectorStatus":3,"CurrentA":10,"CurrentB":10,"CurrentC":10,"VoltageA":220,"VoltageB":220,"VoltageC":220,"Soc":10.1,"StartTime":"2016-05-1420:30:21","EndTime":"2016-05-1420:35:21","TotalPower":1.525,"ElecMoney":1.00,"SeviceMoney":0.52,"TotalMoney":1.52,"SumPeriod":0},"Sig":"7130B533249635CD17F113B1D55C2911"}推送充電狀態(tài)概述此接口用于設(shè)備歸屬運營商向客戶歸屬運營商推送充電設(shè)備的充電狀態(tài)。接口定義接口名稱:notification_equip_charge_status接口使用方法:由客戶歸屬運營商服務(wù)平臺實現(xiàn)此接口,基礎(chǔ)設(shè)施運營商服務(wù)平臺方調(diào)用。輸入?yún)?shù)推送充電狀態(tài)接口的主要輸入?yún)?shù)為充電訂單號、充電訂單狀態(tài)、充電設(shè)備接口編碼、相關(guān)狀態(tài)信息和充電明細信息體列表,具體內(nèi)容參見表13。表SEQ表\*ARABIC13推送充電狀態(tài)的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符用戶編號UserNo否字符串長度不超過255手機號Phone否字符串長度11個字符車牌號LicensePlate否字符串長度不超過20個字符車輛識別碼VIN否字符串參照GB/T27930標準規(guī)定充電訂單狀態(tài)OrderStatus是整型1、啟動中2、充電中3、停止中4、充電完成5、訂單掛起6、充電異常結(jié)束7、啟動失敗充電設(shè)備接口編碼ConnectorID是字符串參見T/CEC102.2—2016時間戳PushTimeStamp是字符串格式“yyyy-MM-ddHH:mm:ss”,推送時間充電設(shè)備接口狀態(tài)ConnectorStatus是整型1:空閑;2:占用(未充電);3:占用(充電中);4:占用(預(yù)約鎖定);255:故障A相電流CurrentA是浮點型單位:A,默認:0含直流(輸出)A相電壓VoltageA是浮點型單位:V,默認:0含直流(輸出)B相電流CurrentB否浮點型單位:A,默認:0B相電壓VoltageB否浮點型單位:V,默認:0C相電流CurrentC否浮點型單位:A,默認:0C相電壓VoltageC否浮點型單位:V,默認:0電池剩余電量SOC是浮點型參數(shù)范圍:0.0-100.0開始充電時間StartTime是字符型格式“yyyy-MM-ddHH:mm:ss”本次采樣時間EndTime是字符型格式“yyyy-MM-ddHH:mm:ss”累計充電量TotalPower是浮點型單位:度,小數(shù)點后3位累計電費ElecMoney否浮點型單位:元,小數(shù)點后2位累計服務(wù)費SeviceMoney否浮點型單位:元,小數(shù)點后2位累計總金額TotalMoney否浮點型單位:元,小數(shù)點后2位累計協(xié)議電費DiscountElecMoney是浮點型單位:元/度,小數(shù)點后2位。充電設(shè)施運營商和客戶運營商協(xié)議電價計費。無協(xié)議電價,則填寫為累計電費。累計協(xié)議服務(wù)費DiscountServiceMoney是浮點型單位:元/度,小數(shù)點后2位。充電設(shè)施運營商和客戶運營商協(xié)議服務(wù)費計費。無協(xié)議服務(wù)費,則填寫為累計服務(wù)費。時段數(shù)NSumPeriod否整型參數(shù)范圍:0~32充電明細信息ChargeDetails否ChargeDetails數(shù)組單時段充電明細信息,見6.6.4返回值推送充電狀態(tài)接口的主要返回值為充電訂單號和操作結(jié)果,具體內(nèi)容參見表14。表SEQ表\*ARABIC14推送充電狀態(tài)的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符操作結(jié)果SuccStat是整型0:成功;1:失敗失敗原因FailReasonMsg是字符串失敗原因的描述示例{"Ret":0,"Msg":"","Data":{"OrderNo":"123456789201605140830591234","SuccStat":0,"FailReasonMsg":""},"Sig":"7130B533249635CD17F113B1D55C2911"}請求停止充電概述此接口用于客戶歸屬運營商請求設(shè)備歸屬運營商設(shè)備停止充電信息。接口定義接口名稱:stop_charge接口使用方法:由基礎(chǔ)設(shè)施運營商服務(wù)平臺實現(xiàn)此接口,客戶歸屬運營商服務(wù)平臺方調(diào)用。輸入?yún)?shù)請求停止充電接口的主要輸入?yún)?shù)為充電訂單號、充電設(shè)備接口編碼,具體內(nèi)容參見表15。表SEQ表\*ARABIC15請求停止充電的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符充電設(shè)備接口編碼ConnectorID是字符串參見T/CEC102.2返回值請求停止充電接口的主要返回值為充電訂單號、充電訂單狀態(tài)、操作結(jié)果和失敗原因,具體內(nèi)容參見表16。表SEQ表\*ARABIC16請求停止充電的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符充電訂單狀態(tài)OrderStatus是整型1、啟動中2、充電中3、停止中4、充電完成5、訂單掛起6、充電異常結(jié)束7、啟動失敗操作結(jié)果SuccStat是整型0:成功;1:失敗充電停止超時時間OverTime是整形單位:秒,參數(shù)范圍建議不超過900s,實際充電停止結(jié)果的超時判斷時間。失敗碼FailReasonCode是整型0:無;1:此設(shè)備不存在;2:此設(shè)備離線(設(shè)備無響應(yīng)時,認為是離線)3:設(shè)備已停止充電4:無權(quán)限停止充電5:訂單不存在50-999:自定義失敗信息FailReasonMsg是字符串失敗原因的描述示例{"Ret":0,"Msg":"","Data":{"OrderNo":"123456789201605140830591234","OrderNoStat":3,"SuccStat":0,"OverTime":15,"FailReasonCode":0,"FailReasonMsg":""},"Sig":"7130B533249635CD17F113B1D55C2911"}推送停止充電結(jié)果概述此接口用于設(shè)備歸屬運營商向客戶歸屬運營商推送停止充電結(jié)果信息。1)客戶運營商發(fā)送請求停止充電成功后,設(shè)備運營商才進行推送停止充電結(jié)果。2)另外由設(shè)備發(fā)起充電停止時,也會由設(shè)備運營商推送停止充電結(jié)果。接口定義接口名稱:notification_stop_charge_result接口使用方法:由客戶歸屬運營商服務(wù)平臺實現(xiàn)此接口,基礎(chǔ)設(shè)施運營商服務(wù)平臺方調(diào)用。輸入?yún)?shù)推送充電停止接口的主要輸入?yún)?shù)為充電訂單號、充電訂單狀態(tài)、充電設(shè)備接口編碼、相關(guān)狀態(tài)信息和充電明細信息體列表,具體內(nèi)容參見表17。表SEQ表\*ARABIC17推送停止充電結(jié)果的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符充電訂單狀態(tài)OrderStatus是整型1、啟動中2、充電中3、停止中4、充電完成5、訂單掛起6、充電異常結(jié)束7、啟動失敗充電設(shè)備接口編碼ConnectorID是字符串參見T/CEC102.2成功標識SuccStat是整型0:成功;1:失敗時間戳PushTimeStamp是字符串格式“yyyy-MM-ddHH:mm:ss”,推送時間停止失敗碼FailReasonCode是整型0:無;1:此設(shè)備不存在;2:此設(shè)備離線:3:設(shè)備已停止充電;50~99:自定義停止失敗信息FailReasonMsg是字符串停止失敗原因描述返回值推送停止充電結(jié)果接口的主要返回值為充電訂單號、操作結(jié)果和失敗原因,具體內(nèi)容參見表18。表SEQ表\*ARABIC18推送停止充電結(jié)果的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符操作結(jié)果SuccStat是整型0:成功;1:失敗失敗原因FailReason是整型0:無;1:接收失??;示例{"Ret":0,"Msg":"","Data":{"OrderNo":"123456789201605140830591234","SuccStat":0,"FailReason":0},"Sig":"7130B533249635CD17F113B1D55C2911"}推送充電訂單信息概述此接口用于設(shè)備歸屬運營商向客戶歸屬運營商推送充電訂單信息。接口定義接口名稱:notification_charge_order_info接口使用方法:由客戶歸屬運營商服務(wù)平臺實現(xiàn)此接口,基礎(chǔ)設(shè)施運營商服務(wù)平臺調(diào)用。輸入?yún)?shù)推送充電訂單信息接口的主要輸入?yún)?shù)為充電訂單號、充電設(shè)備接口編碼、訂單的電量信息、訂單的費用信息、訂單結(jié)束原因和充電明細信息體列表,具體內(nèi)容參見表19。表SEQ表\*ARABIC19推送充電訂單信息的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符充電設(shè)備接口編碼ConnectorID是字符串參見T/CEC102.2—2016用戶編號UserNo否字符串長度不超過32個字符手機號Phone否字符串長度11個字符車牌號LicensePlate否字符串長度不超過20個字符車輛識別碼VIN否字符串參照GB/T27930標準規(guī)定,長度17個字符賬務(wù)日期AccountDate否字符串格式“yyyy-MM-dd”,訂單的對賬日期。開始充電時間StartTime是字符串格式“yyyy-MM-ddHH:mm:ss”結(jié)束充電時間EndTime是字符串格式“yyyy-MM-ddHH:mm:ss”累計充電量TotalPower是浮點型單位kWh,小數(shù)點后3位尖階段電量CuspElect否浮點型單位kWh,小數(shù)點后3位尖總金額CuspMoney否浮點型單位:元,小數(shù)點后2位峰階段電量PeakElect否浮點型單位kWh,小數(shù)點后3位峰總金額PeakMoney否浮點型單位:元,小數(shù)點后2位平階段電量FlatElect否浮點型單位kWh,小數(shù)點后3位平總金額FlatMoney否浮點型單位:元,小數(shù)點后2位谷階段電量ValleyElect否浮點型單位kWh,小數(shù)點后3位谷總金額ValleyMoney否浮點型單位:元,小數(shù)點后2位時間戳PushTimeStamp是字符串格式“yyyy-MM-ddHH:mm:ss”總電費TotalElecMoney是浮點型單位:元,小數(shù)點后2位總服務(wù)費TotalSeviceMoney是浮點型單位:元,小數(shù)點后2位累計總金額TotalMoney是浮點型單位:元,小數(shù)點后2位時段協(xié)議電費DiscountElecMoney否浮點型單位:元,小數(shù)點后2位時段協(xié)議服務(wù)費DiscountServiceMoney否浮點型單位:元,小數(shù)點后2位時段協(xié)議總金額DiscountTotalMoney否浮點型單位:元,小數(shù)點后2位充電結(jié)束原因StopReason是整型0:用戶手動停止充電1:客戶歸屬地運營商平臺停止充電2:BMS停止充電;3:充電機設(shè)備故障;4:連接器斷開5-99:自定義時段數(shù)NSumPeriod否整型范圍:0~32充電明細信息ChargeDetails否ChargeDetails數(shù)組單時段充電明細信息,見6.6.4返回值推送充電訂單信息接口的主要返回值為充電訂單號、充電設(shè)備接口編碼和確認結(jié)果,具體內(nèi)容參見表20。表SEQ表\*ARABIC20推送充電訂單信息的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符充電設(shè)備接口編碼ConnectorID是字符串參見T/CEC102.2確認結(jié)果ConfirmResult否整型0:成功,表示對此訂單的對賬確認。1:失敗爭議原因DisputeReason否字符串爭議訂單出現(xiàn)的原因確認時間ConfirmTime是字符串格式“yyyy-MM-ddHH:mm:ss”示例{"Ret":0,"Msg":"","Data":{"OrderNo":"123456789201605140830591234","ConnectorID":"10000000000000000000000001","ConfirmResult":0,"DisputeReason":"無","ConfirmTime":"2020-04-1815:20:40"},"Sig":"7130B533249635CD17F113B1D55C2911"}推送訂單賬務(wù)日期(可選)概述客戶歸屬運營商在訂單推送時無法確認賬務(wù)日期時,可由基礎(chǔ)設(shè)施運營商向客戶歸屬運營商推送賬務(wù)日期。接口定義接口名稱:notification_order_check_date 接口使用方法:由客戶歸屬運營商服務(wù)平臺實現(xiàn)此接口,基礎(chǔ)設(shè)施運營商服務(wù)平臺方調(diào)用。輸入?yún)?shù)推送訂單對賬日期接口的主要輸入?yún)?shù)為充電訂單號、賬務(wù)日期,具體內(nèi)容參見表1。表1推送充電訂單信息的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符賬務(wù)日期AccountDate是字符串格式“yyyy-MM-dd”返回值推送充電訂單賬戶日期接口的主要返回值為充電訂單號和確認結(jié)果,具體內(nèi)容參見表2。表2推送充電訂單信息的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符確認結(jié)果ConfirmResult是整型0:成功1:訂單不存在示例{"Ret":0,"Msg":"","Data":{"OrderNo":"123456789201605140830591234","ConfirmResult":0},"Sig":"7130B533249635CD17F113B1D55C2911"}推送充電訂單確認結(jié)果(可選)概述此接口用于客戶歸屬運營商推送單筆訂單的確認結(jié)果信息給設(shè)備歸屬運營商。接口定義接口名稱:notification_charge_order_confirm接口使用方法:由基礎(chǔ)設(shè)施運營商服務(wù)平臺方實現(xiàn)此接口,客戶歸屬運營商服務(wù)平臺方調(diào)用。輸入?yún)?shù)推送充電訂單確認結(jié)果接口的主要輸入?yún)?shù)為充電訂單號,具體內(nèi)容參見表。表21推送充電訂單確認結(jié)果的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符返回值推送充電訂單確認結(jié)果接口的主要返回值為充電訂單號、充電設(shè)備接口編碼和確認結(jié)果,具體內(nèi)容參見表。表22推送充電訂單確認結(jié)果的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符確認結(jié)果ConfirmResult是整型0:成功1:爭議訂單爭議原因DisputeReason否整型爭議訂單出現(xiàn)的原因。如果對賬確認結(jié)果失敗,此項必填1:電量不一致2:電費不一致3:服務(wù)費不一致4:客戶運營商無此訂單5:設(shè)施運營商無此訂單50-99:其他,各級運營商可以自定義確認時間ConfirmTime是字符串格式“yyyy-MM-ddHH:mm:ss”示例{"Ret":0,"Msg":"","Data":{"OrderNo":"123456789201605140830591234","ConfirmResult":0"DisputeReason":"無","ConfirmTime":"2016-03-0401:23:51" },"Sig":"7130B533249635CD17F113B1D55C2911"}查詢充電訂單確認結(jié)果(可選)概述此接口用于設(shè)備歸屬運營商向客戶歸屬運營商查詢單筆訂單的確認結(jié)果。接口定義接口名稱:query_charge_order_confirm_result接口使用方法:由客戶歸屬運營商服務(wù)平臺實現(xiàn)此接口,基礎(chǔ)設(shè)施運營商服務(wù)平臺方調(diào)用。輸入?yún)?shù)查詢通知充電訂單確認結(jié)果接口的主要輸入?yún)?shù)為充電訂單號,具體內(nèi)容參見表23。表23查詢充電訂單確認結(jié)果的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符返回值查詢充電訂單確認結(jié)果接口的主要返回值為充電訂單號、確認結(jié)果、爭議原因、確認原因,具體內(nèi)容參見表24。表24查詢充電訂單確認結(jié)果的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符確認結(jié)果ConfirmResult是整型0:成功1:爭議交易爭議原因DisputeReason否整型爭議訂單的原因。如果對賬確認結(jié)果失敗,此項必填0:平賬1:電量不一致2:電費不一致3:服務(wù)費不一致4:客戶運營商無此訂單5:設(shè)施運營商無此訂單50-99:其他,各級運營商可以自定義確認時間ConfirmTime是字符串格式“yyyy-MM-ddHH:mm:ss”示例{"Ret":0,"Msg":"","Data":{"OrderNo":"123456789201605140830591234","ConfirmResult":0"DisputeReason":0,"ConfirmTime":"2016-03-0401:23:51"},"Sig":"7130B533249635CD17F113B1D55C2911"}查詢輔助業(yè)務(wù)信息(可選)概述此接口用于客戶歸屬運營商向設(shè)備歸屬運營商查詢輔助業(yè)務(wù)信息。接口定義接口名稱:query_other_policy接口使用方法:由設(shè)備歸屬運營商平臺方實現(xiàn)此接口,客戶歸屬運營商平臺方調(diào)用。輸入?yún)?shù)查詢輔助業(yè)務(wù)信息接口的主要輸入?yún)?shù)為輔助業(yè)務(wù)信息查詢流水號、輔助業(yè)務(wù)代碼,具體內(nèi)容參見表25。表25查詢輔助業(yè)務(wù)信息的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述輔助業(yè)務(wù)信息查詢流水號EquipBizSeq是字符串格式“運營商ID+唯一編號”,不超過64個字符輔助業(yè)務(wù)代號ServiceCode是整型1:地鎖業(yè)務(wù)50-99自定義返回值查詢輔助業(yè)務(wù)信息接口的主要返回值為其他業(yè)務(wù)的計費策略,采用多時段計費方式,每個時段均包含一個單項業(yè)務(wù)策略信息體列表,返回值參見表4,單項業(yè)務(wù)策略信息體的參數(shù)和內(nèi)容參見表5。表26查詢輔助業(yè)務(wù)信息的返回值表參數(shù)名稱定義必填參數(shù)類型描述輔助業(yè)務(wù)信息查詢流水號EquipBizSeq是字符串格式“運營商ID+唯一編號”,不超過64個字符輔助業(yè)務(wù)代號ServiceCode是整型1:地鎖業(yè)務(wù)50-99自定義操作結(jié)果SuccStat是整型0:成功;1:失敗失敗碼FailReason是整型0:無;1:不存在其他業(yè)務(wù)策略時段數(shù)NSumPeriod是整型范圍:0~32計費信息PolicyInfos是PolicyInfos數(shù)組單項業(yè)務(wù)策略信息體表27單項業(yè)務(wù)策略信息體的參數(shù)表參數(shù)名稱定義必填參數(shù)類型描述時段起始時間點StartTime是字符串格式“HHmmss”,6字符時段結(jié)束時間點EndTime是字符串格式“HHmmss”,6字符時段服務(wù)費ServicePrice是浮點型單位:元,小數(shù)點后4位示例{"Ret":0,"Msg":"","Data":{"EquipBizSeq":"12345678920160514083059","ServiceCode":1,"SuccStat":0,"FailReason":0,"SumPeriod":1,"PolicyInfos":[{"StartTime":"030234","EndTime":040234,"SevicePrice":0.3713}]},"Sig":"7130B533249635CD17F113B1D55C2911"}推送輔助業(yè)務(wù)訂單(可選)概述此接口用于設(shè)備歸屬運營商向客戶歸屬運營商推送輔助業(yè)務(wù)訂單信息。接口定義接口名稱:notification_other_order_info接口使用方法:由客戶歸屬運營商服務(wù)平臺實現(xiàn)此接口,基礎(chǔ)設(shè)施運營商服務(wù)平臺方調(diào)用。輸入?yún)?shù)推送輔助業(yè)務(wù)訂單信息接口的主要輸入?yún)?shù)為訂單號、輔助業(yè)務(wù)訂單號、賬務(wù)日期、訂單開始時間、訂單結(jié)束時間、訂單的費用信息,具體內(nèi)容參見表28。表28推送輔助業(yè)務(wù)訂單的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符輔助業(yè)務(wù)類型ServiceCode是整型1:地鎖業(yè)務(wù)50-99自定義賬務(wù)日期AccountDate是字符串格式“yyyy-MM-dd”訂單開始時間StartTime是字符串格式“yyyy-MM-ddHH:mm:ss”訂單結(jié)束時間EndTime是字符串格式“yyyy-MM-ddHH:mm:ss”時間戳PushTimeStamp是字符串格式“yyyy-MM-ddHH:mm:ss”,推送時間總服務(wù)費TotalSeviceMoney是浮點型單位:元,小數(shù)點后2位累計總金額TotalMoney是浮點型單位:元,小數(shù)點后2位返回值推送輔助業(yè)務(wù)訂單信息接口的主要返回值為充電訂單號、確認結(jié)果,具體內(nèi)容參見表29。表29推送輔助業(yè)務(wù)訂單信息的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符確認結(jié)果ConfirmResult是整型0:成功1:失敗示例{"Ret":0,"Msg":"","Data":{"OrderNo":"123456789201605140830591234","ConfirmResult":0},"Sig":"7130B533249635CD17F113B1D55C2911"}推送日對賬文件下載地址概述該接口用于設(shè)施運營商向客戶歸屬運營商推送日對賬訂單文件下載地址。接口定義接口名稱:notification_charge_bills接口使用方法:由客戶歸屬運營商服務(wù)平臺方實現(xiàn)此接口,基礎(chǔ)設(shè)施運營商服務(wù)平臺方調(diào)用。輸入?yún)?shù)推送日對賬文件下載地址接口的主要輸入?yún)?shù)為日賬單流水號、文件路徑、賬務(wù)日期,具體內(nèi)容參見表30。表30推送日對賬文件下載地址的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述日賬單流水號BillsNo是字符串格式“運營商ID_日期(yyyyMMdd)_唯一編號”,不超過64字符文件路徑BillDownloadUrl是字符串對賬文件下載路徑,文件名稱由業(yè)務(wù)雙方進行自定義賬務(wù)日期AccountDate是字符串格式“yyyy-MM-dd”返回值推送日對賬文件下載地址接口的返回值為確認結(jié)果,具體內(nèi)容參見表31。表31推送日對賬文件下載地址的返回值表參數(shù)名稱定義必填參數(shù)類型描述確認結(jié)果ConfirmResult是整型0:成功1:失敗示例{"Ret":0,"Msg":"","Data":{"ConfirmResult":0},"Sig":"7130B533249635CD17F113B1D55C2911"}對賬文件對賬文件應(yīng)符合附件A.2日對賬文件要求查詢?nèi)諏~文件下載地址(可選)概述該接口用于客戶歸屬運營商向設(shè)施運營商查詢?nèi)諏~訂單文件下載地址信息。接口定義接口名稱:query_charge_bills接口使用方法:由基礎(chǔ)設(shè)施運營商服務(wù)平臺方實現(xiàn)此接口,客戶歸屬運營商服務(wù)平臺方調(diào)用。輸入?yún)?shù)查詢?nèi)諏~文件下載地址接口的主要輸入?yún)?shù)為賬務(wù)日期,具體內(nèi)容參見表32表32查詢?nèi)諏~文件下載地址的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述賬務(wù)日期AccountDate是字符串格式“yyyy-MM-dd”返回值查詢?nèi)諏~文件下載地址接口的返回值為賬單狀態(tài)、賬單失敗原因、日賬單流水號、文件路徑、賬務(wù)日期,具體內(nèi)容參見表33。表33查詢?nèi)諏~文件下載地址的返回值表參數(shù)名稱定義必填參數(shù)類型描述賬單狀態(tài)SuccStat是整型0:已生成;1:未生成賬單失敗原因FailReason是整型0:無1:賬單未生成2:賬單不存在日賬單流水號BillsNo是字符串格式“運營ID_日期(yyyyMMdd)_唯一編號”,不超過64字符文件路徑BillDownloadUrl是字符串對賬文件下載路徑,文件名稱由業(yè)務(wù)雙方進行自定義賬務(wù)日期AccountDate是字符串格式“yyyy-MM-dd”示例{"Ret":0,"Msg":"","Data":{"SuccStat":0,"FailReason":0,"BillsNo":"MX123456_20200418_123456","BillDownloadUrl":"https://domain/location","AccountDate":"2020-04-18"},"Sig":"7130B533249635CD17F113B1D55C2911"}對賬文件對賬文件應(yīng)符合附件A.2日對賬文件要求推送日對賬確認文件下載地址概述該接口用于客戶歸屬運營商向設(shè)施歸屬運營商推送日對賬確認文件下載地址信息。接口定義接口名稱:notification_charge_bills_confirm接口使用方法:由基礎(chǔ)設(shè)施運營商服務(wù)平臺方實現(xiàn)此接口,客戶歸屬運營商服務(wù)平臺方調(diào)用。輸入?yún)?shù)推送日對賬確認文件下載地址接口的主要輸入?yún)?shù)為日賬單流水號、文件路徑、賬務(wù)日期,具體內(nèi)容參見表34表34推送日對賬確認文件下載地址的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述日賬單流水號BillsNo是字符串格式“運營商ID_日期(yyyyMMdd)_唯一編號”,不超過64字符文件路徑BillDownloadUrl是字符串對賬文件下載路徑,文件名稱由業(yè)務(wù)雙方進行自定義賬務(wù)日期AccountDate是字符串格式“yyyy-MM-dd”返回值推送日對賬確認文件下載地址接口的返回值為確認結(jié)果,具體內(nèi)容參見表35。表35推送日對賬確認文件下載地址的返回值表參數(shù)名稱定義必填參數(shù)類型描述確認結(jié)果ConfirmResult是整型0:成功1:失敗示例{"Ret":0,"Msg":"","Data":{"ConfirmResult":0},"Sig":"7130B533249635CD17F113B1D55C2911"}對賬文件對賬文件應(yīng)符合附件A.2日對賬文件要求查詢?nèi)諏~確認文件下載地址(可選)概述該接口用于設(shè)施運營商向客戶歸屬運營商查詢?nèi)諏~確認文件下載地址。接口定義接口名稱:query_charge_bills_confirm接口使用方法:由客戶歸屬運營商服務(wù)平臺方實現(xiàn)此接口,基礎(chǔ)設(shè)施運營商服務(wù)平臺方調(diào)用。輸入?yún)?shù)查詢?nèi)諏~確認文件下載地址接口的主要輸入?yún)?shù)為賬務(wù)日期,具體內(nèi)容參見表36。表36查詢?nèi)諏~確認文件下載地址的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述賬務(wù)日期AccountDate是字符串格式“yyyy-MM-dd”返回值查詢?nèi)諏~確認文件下載地址接口的返回值為賬單狀態(tài)、失敗原因、日賬單流水號、文件路徑、賬務(wù)日期,具體內(nèi)容參見表37。表37查詢?nèi)諏~確認文件下載地址的返回值表參數(shù)名稱定義必填參數(shù)類型描述賬單狀態(tài)SuccStat是整型0:已生成;1:未生成失敗原因FailReason是整型0:無1:賬單未生成2:賬單不存在日賬單流水號BillsNo是字符串格式“運營商ID_日期(yyyyMMdd)_唯一編號”,不超過64字符文件路徑BillDownloadUrl是字符串對賬文件下載路徑,文件名稱由業(yè)務(wù)雙方進行自定義賬務(wù)日期AccountDate是字符串格式“yyyy-MM-dd”示例{"Ret":0,"Msg":"","Data":{"SuccStat":0,"FailReason":0,"BillsNo":"MX123456_20200418_123456","BillDownloadUrl":"https://domain/location","AccountDate":"2020-04-18"},"Sig":"7130B533249635CD17F113B1D55C2911"}對賬文件對賬文件應(yīng)符合附件A.2日對賬文件要求

(資料性附錄)

電動汽車充換電業(yè)務(wù)信息交換接口(Iserv)流程時序圖用戶側(cè)發(fā)起充電流程時序圖圖A.1用戶側(cè)發(fā)起充電流程時序圖客戶歸屬運營商與基礎(chǔ)設(shè)施運營商對賬時序圖圖A.2客戶歸屬運營商與基礎(chǔ)設(shè)施運營商對賬時序圖對賬文件概述由設(shè)備運營商平臺實現(xiàn)生成賬單文件,用戶運營商完成對賬動作后,生成賬單回復(fù)文件。對賬文件傳輸方式使用http/https協(xié)議傳輸,訪問方式為GET。文件名以文件路徑為主,不做限制。文件路徑格式不做限制,可包含http/httpsGET參數(shù)實現(xiàn)運營商訪問權(quán)限控制。文件路徑訪問次數(shù)與過期時間由文件生成運營商自定義。建議訪問次數(shù):3次以內(nèi),過期時間:12小時。文件路徑失效后,可通過“query_charge_bills”,“query_charge_bills_confirm”接口,重新查詢獲得有效的文件路徑。日對賬文件參數(shù)說明參數(shù)名稱定義必填參數(shù)類型描述賬務(wù)日期AccountDate是字符串格式“yyyy-MM-dd”當天累計總充電訂單數(shù)SumChargeNum是整型單位:個當天累計總充電量SumPower是浮點型單位:度,小數(shù)點后3位當天累計總電費SumElecMoney是浮點型單位:元,小數(shù)點后2位當天累計總服務(wù)費SumSeviceMoney是浮點型單位:元,小數(shù)點后2位當天累計總金額SumMoney是浮點型單位:元,小數(shù)點后2位互聯(lián)互通充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符設(shè)備運營商訂單號EquipOrderNo否字符串不超過64個字符充電設(shè)備接口編碼ConnectorID是字符串參見T/CEC102.2訂單累計總充電量TotalPower是浮點型單位:度,小數(shù)點后3位訂單累計總電費TotalElecMoney是浮點型單位:元,小數(shù)點后2位訂單累計總服務(wù)費TotalSeviceMoney是浮點型單位:元,小數(shù)點后2位訂單累計總金額TotalMoney是浮點型單位:元,小數(shù)點后2位日對賬確認文件參數(shù)說明參數(shù)名稱定義必填參數(shù)類型描述賬務(wù)日期AccountDate是字符串格式“yyyy-MM-dd”當天累計充電訂單對賬成功數(shù)SumChargeNumSuccess是整型單位:個當天累計充電訂單對賬失敗數(shù)SumChargeNumFail是整型單位:個當天累計對賬成功總充電量SumPowerSuccess是浮點型單位:度,小數(shù)點后3位當天累計對賬失敗總充電量SumPowerFail是浮點型單位:度,小數(shù)點后3位當天累計對賬成功總電費SumElecMoneySuccess是浮點型單位:元,小數(shù)點后2位當天累計對賬失敗總電費SumElecMoneyFail是浮點型單位:元,小數(shù)點后2位當天累計對賬成功總服務(wù)費SumSeviceMoneySuccess是浮點型單位:元,小數(shù)點后2位當天累計對賬失敗總服務(wù)費SumSeviceMoneyFail是浮點型單位:元,小數(shù)點后2位當天累計對賬成功總金額SumMoneySuccess是浮點型單位:元,小數(shù)點后2位當天累計對賬失敗總金額SumMoneyFail是浮點型單位:元,小數(shù)點后2位互聯(lián)互通充電訂單號OrderNo是字符串格式“運營商ID+唯一編號”,不超過64個字符設(shè)備運營商訂單號EquipOrderNo否字符串不超過64個字符充電設(shè)備接口編碼ConnectorID是字符串參見T/CEC102.2對賬確認結(jié)果ConfirmResult是整型0:成功,平賬;1:爭議;對賬爭議原因DisputeReason否整型爭議訂單出現(xiàn)的原因。對賬確認結(jié)果為爭議時,此項必填1:電量不一致2:電費不一致3:服務(wù)費不一致4:客戶運營商無此訂單5:設(shè)施運營商無此訂單6-99:其他,運營商可以自定義對賬確認時間ConfirmTime是字符串格式“yyyy-MM-ddHH:mm:ss”用戶運營商訂單累計總充電量TotalPower是浮點型單位:度,小數(shù)點后3位用戶運營商訂單累計總電費TotalElecMoney是浮點型單位:元,小數(shù)點后2位用戶運營商訂單累計總服務(wù)費TotalSeviceMoney是浮點型單位:元,小數(shù)點后2位用戶運營商訂單累計總金額TotalMoney是浮點型單位:元,小數(shù)點后2位充電輔助業(yè)務(wù)流程圖A.4調(diào)用輔助業(yè)務(wù)接口圖啟動輔助業(yè)務(wù)概述此接口用于客戶歸屬運營商向設(shè)備歸屬運營商啟動輔助業(yè)務(wù)。接口定義:接口名稱:enable_other_assistant接口使用方法:由基礎(chǔ)設(shè)施運營商服務(wù)平臺方實現(xiàn)此接口,客戶歸屬運營商服務(wù)平臺方調(diào)用。輸入?yún)?shù)啟動輔助業(yè)務(wù)接口的主要輸入?yún)?shù)為充電設(shè)備接口編碼、輔助業(yè)務(wù)類型,具體內(nèi)容參見表38。表38啟動輔助業(yè)務(wù)的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電設(shè)備接口編碼ConnectorID是字符串參見T/CEC102.2輔助業(yè)務(wù)類型ServiceCode是整型1:地鎖業(yè)務(wù)50-99自定義返回值啟動輔助業(yè)務(wù)接口的返回值為充電設(shè)備接口編碼、輔助業(yè)務(wù)類型、輔助業(yè)務(wù)訂單編號、操作結(jié)果、失敗碼、失敗信息,具體內(nèi)容參見表39。表39啟動輔助業(yè)務(wù)的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電設(shè)備接口編碼ConnectorID是字符串參見T/CEC102.2輔助業(yè)務(wù)類型ServiceCode是整型1:地鎖業(yè)務(wù)2-99自定義輔助業(yè)務(wù)訂單編號UnLockSeq是字符串格式“運營商ID+唯一編號”,不超過64個字符操作結(jié)果SuccStat是整型0:成功;1:失敗失敗碼FailReasonCode是整型0:無;1:此設(shè)施不存在(地鎖已下線或站點非正常使用狀態(tài)時,認為地鎖不存在)2:此設(shè)施離線3:無此設(shè)施使用權(quán)限4:此設(shè)施正忙50-99:自定義"失敗信息FailReasonMsg是字符串失敗原因的描述示例:{"Ret":0,"Msg":"","Data":{"ConnectorID":"10000000000000000000000001","ServiceCode":1,"UnLockSeq":"12345678920160514083059","SuccStat":0,"FailReasonCode":0,"FailReasonMsg":""},"Sig":"7130B533249635CD17F113B1D55C2911"}停止輔助業(yè)務(wù)概述此接口用于客戶歸屬運營商向設(shè)備歸屬運營商發(fā)起結(jié)束輔助業(yè)務(wù)。接口定義:接口名稱:disable_other_assistant接口使用方法:由基礎(chǔ)設(shè)施運營商服務(wù)平臺方實現(xiàn)此接口,客戶歸屬運營商服務(wù)平臺方調(diào)用。輸入?yún)?shù)停止輔助業(yè)務(wù)接口的主要輸入?yún)?shù)為充電設(shè)備接口編碼、輔助業(yè)務(wù)類型、輔助業(yè)務(wù)訂單編號,具體內(nèi)容參見表40。表40停止輔助業(yè)務(wù)的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電設(shè)備接口編碼ConnectorID是字符串參見T/CEC102.2輔助業(yè)務(wù)類型ServiceCode是整型1:地鎖業(yè)務(wù)50-99自定義輔助業(yè)務(wù)訂單編號UnLockSeq是字符串格式“運營商ID+唯一編號”,不超過64個字符返回值停止輔助業(yè)務(wù)接口的返回值為充電設(shè)備接口編碼、輔助業(yè)務(wù)類型、操作結(jié)果、失敗碼、失敗信息,具體內(nèi)容參見表41。表41停止輔助業(yè)務(wù)的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電設(shè)備接口編碼ConnectorID是字符串參見T/CEC102.2輔助業(yè)務(wù)類型ServiceCode是整型1:地鎖業(yè)務(wù)50-99自定義操作結(jié)果SuccStat是整型0:成功;1:失敗失敗碼FailReasonCode是整型0:無;1:此地鎖不存在(地鎖已下線或站點非正常使用狀態(tài)時,認為地鎖不存在)2:此地鎖離線3:無此地鎖使用權(quán)限4:此地鎖正忙50-99:自定義"失敗信息FailReasonMsg是字符串失敗原因的描述示例:{"Ret":0,"Msg":"","Data":{"ConnectorID":"10000000000000000000000001","ServiceCode":1,"SuccStat":0,"FailReasonCode":0,"FailReasonMsg":""},"Sig":"7130B533249635CD17F113B1D55C2911"}充電輔助業(yè)務(wù)流程訂單狀態(tài)說明啟動中訂單狀態(tài)為“啟動中”,表明充電運營商已經(jīng)正確收到了啟動請求,并已將指令下發(fā)到了設(shè)備,正在等待充電設(shè)備和車輛進行交互,但此時并不表示本次充電已經(jīng)成功開啟。充電中訂單狀態(tài)為“充電中”,表明該設(shè)備正在為該訂單充電。停止中訂單狀態(tài)為“停止中”,表明充電運營商已經(jīng)收到了停止請求,并已下發(fā)到了設(shè)備,正在等待設(shè)備停止充電,但此時并不表示本次充電已成功停止。訂單完成訂單狀態(tài)為“訂單完成”,表明本次充電已全部完成,是一種終態(tài)。訂單掛起訂單狀態(tài)為“訂單掛起”,表明充電運營商不能明確判斷本次充電的當前狀態(tài)。充電異常結(jié)束訂單狀態(tài)為“充電異常結(jié)束”,表明該訂單已結(jié)束,但處于異常狀態(tài)。需要在后續(xù)的運維、對賬環(huán)節(jié)進行處理。是一種終態(tài)。啟動失敗訂單狀態(tài)為“啟動失敗”,表明充電運營商確認充電啟動失敗,該訂單未產(chǎn)生充電行為。是一種終態(tài)。

訂單狀態(tài)流轉(zhuǎn)充電運營商狀態(tài)流轉(zhuǎn)圖客戶運營商狀態(tài)流轉(zhuǎn)圖啟動中充電運營商狀態(tài)流轉(zhuǎn)判斷出訂單啟動成功,設(shè)備正在為該訂單提供充電服務(wù)時,將訂單狀態(tài)流轉(zhuǎn)到“充電中”。收到或觸發(fā)了停止指令并成功執(zhí)行,將訂單狀態(tài)流轉(zhuǎn)到“停止中”。收到設(shè)備上報的充電記錄,將訂單狀態(tài)流轉(zhuǎn)到“充電完成”。超時X秒(X秒小于等于啟動接口返回的超時時間)或判斷出設(shè)備進入到離線等不確定狀態(tài),將訂單狀態(tài)流轉(zhuǎn)到“訂單掛起”。確認本次充電啟動失敗,將訂單狀態(tài)流轉(zhuǎn)到“啟動失敗”??蛻暨\營商狀態(tài)流轉(zhuǎn)收到充電運營商的啟動充電結(jié)果的狀態(tài)為“充電中”,或查詢到訂單狀態(tài)為“充電中”時,將訂單狀態(tài)流轉(zhuǎn)到“充電中”。由于客戶點擊停止或觸發(fā)停止規(guī)則等情況,向充電運營商發(fā)起了停止指令,并且返回成功,將訂單狀態(tài)流轉(zhuǎn)到“停止中”。收到充電運營商推送的訂單信息,或查到過程信息的訂單狀態(tài)為“充電完成”,將訂單狀態(tài)流轉(zhuǎn)到“充電完成”。收到充電運營商的啟動充電結(jié)果推送狀態(tài)為“訂單掛起”,或查詢到訂單狀態(tài)為“訂單掛起”時,將訂單狀態(tài)流轉(zhuǎn)到“訂單掛起”。超時A秒(A為充電運營商

溫馨提示

  • 1. 本站所有資源如無特殊說明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
  • 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
  • 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁內(nèi)容里面會有圖紙預(yù)覽,若沒有圖紙預(yù)覽就沒有圖紙。
  • 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
  • 5. 人人文庫網(wǎng)僅提供信息存儲空間,僅對用戶上傳內(nèi)容的表現(xiàn)方式做保護處理,對用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對任何下載內(nèi)容負責(zé)。
  • 6. 下載文件中如有侵權(quán)或不適當內(nèi)容,請與我們聯(lián)系,我們立即糾正。
  • 7. 本站不保證下載資源的準確性、安全性和完整性, 同時也不承擔(dān)用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。

評論

0/150

提交評論