版權(quán)說(shuō)明:本文檔由用戶提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請(qǐng)進(jìn)行舉報(bào)或認(rèn)領(lǐng)
文檔簡(jiǎn)介
ICS35.240.60L73T/CEC電動(dòng)汽車充換電服務(wù)信息交換第3部分:業(yè)務(wù)信息交換規(guī)范FORMTEXTInteractiveofchargingandbatteryswapserviceinformationforelectricvehicles
Part3:Businessinformationexchangespecification(征求意見(jiàn)稿)2019-06-19FORMTEXTXXXX-FORMTEXTXX-FORMTEXTXX發(fā)布FORMTEXTXXXX-FORMTEXTXX-FORMTEXTXX實(shí)施中國(guó)電力企業(yè)聯(lián)合會(huì)發(fā)布T/CEC102.3—2016T/CEC102.3—2016電動(dòng)汽車充換電服務(wù)信息交換第3部分:業(yè)務(wù)信息交換規(guī)范范圍本部分規(guī)定了電動(dòng)汽車充換電業(yè)務(wù)信息服務(wù)交換的方法,包括業(yè)務(wù)信息交換的接口流程、接口功能和接口協(xié)議。本部分適用于不同運(yùn)營(yíng)商服務(wù)平臺(tái)之間的充換電服務(wù)信息交換,以及電動(dòng)汽車充換電服務(wù)平臺(tái)與第三方服務(wù)及管理平臺(tái)之間的信息交換。規(guī)范性引用文件下列文件對(duì)于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件,僅注日期的版本適用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改單)適用于本文件。GB/T19596—2004電動(dòng)汽車術(shù)語(yǔ)GB/T29317—2012電動(dòng)汽車充換電設(shè)施術(shù)語(yǔ)T/CEC102.1—2016電動(dòng)汽車充換電服務(wù)信息交換第1部分:總則T/CEC102.2—2016電動(dòng)汽車充換電服務(wù)信息交換第2部分:公共信息交換規(guī)范術(shù)語(yǔ)和定義GB/T19596—2004、GB/T29317—2012以及T/CEC102.1—201*屆定的以及下列術(shù)語(yǔ)和定義適用于本文件。客戶側(cè)發(fā)起業(yè)務(wù)交互EVdriver’sserviceoperatorinitiatedinteraction用戶采用手機(jī)APP等方式,由客戶運(yùn)營(yíng)商發(fā)起電動(dòng)汽車充換電服務(wù)信息交換的過(guò)程。設(shè)備側(cè)發(fā)起業(yè)務(wù)交互EVIserviceoperatorinitiatedinteraction用戶采用刷卡等方式,由基礎(chǔ)設(shè)施歸屬運(yùn)營(yíng)商發(fā)起電動(dòng)汽車充換電服務(wù)信息交換的過(guò)程。業(yè)務(wù)信息交換流程客戶側(cè)發(fā)起業(yè)務(wù)交互流程客戶側(cè)發(fā)起業(yè)務(wù)交互由用戶發(fā)起,客戶歸屬運(yùn)營(yíng)商的電動(dòng)汽車充換電服務(wù)平臺(tái)向基礎(chǔ)設(shè)施運(yùn)營(yíng)商的電動(dòng)汽車充換電服務(wù)平臺(tái)發(fā)起信息交換業(yè)務(wù),實(shí)現(xiàn)此業(yè)務(wù)的7項(xiàng)業(yè)務(wù)交互流程如圖1所示,具體業(yè)務(wù)時(shí)序參見(jiàn)附錄A中的圖A.1。客戶側(cè)發(fā)起業(yè)務(wù)交互流程圖具體業(yè)務(wù)功能包括設(shè)備認(rèn)證服務(wù)、查詢業(yè)務(wù)策略服務(wù)(可選)、啟動(dòng)充電服務(wù)、充電監(jiān)控服務(wù)(可選)、充電停止服務(wù)(可選)、充電訂單服務(wù)、訂單對(duì)賬服務(wù)。設(shè)備側(cè)發(fā)起業(yè)務(wù)交互流程設(shè)備側(cè)發(fā)起業(yè)務(wù)交互由用戶發(fā)起,基礎(chǔ)設(shè)施運(yùn)營(yíng)商的電動(dòng)汽車充換電服務(wù)平臺(tái)向客戶歸屬運(yùn)營(yíng)商的電動(dòng)汽車充換電服務(wù)平臺(tái)發(fā)起信息交換業(yè)務(wù),實(shí)現(xiàn)此業(yè)務(wù)的6項(xiàng)業(yè)務(wù)交互流程如圖2所示,具體業(yè)務(wù)時(shí)序參見(jiàn)附錄A中的圖A.2。設(shè)備側(cè)發(fā)起業(yè)務(wù)交互流程圖具體業(yè)務(wù)功能包括用戶認(rèn)證服務(wù)、查詢業(yè)務(wù)策略服務(wù)(可選)、充電監(jiān)控服務(wù)(可選)、充電停止服務(wù)(可選)、充電訂單服務(wù)、訂單對(duì)賬服務(wù)。業(yè)務(wù)信息交換功能業(yè)務(wù)信息交換功能分類業(yè)務(wù)信息交換規(guī)范共設(shè)計(jì)7個(gè)業(yè)務(wù)功能,分別是:設(shè)備認(rèn)證服務(wù)查詢業(yè)務(wù)策略服務(wù)啟動(dòng)充電服務(wù)充電監(jiān)控服務(wù)充電停止服務(wù)充電訂單服務(wù)訂單對(duì)賬服務(wù)設(shè)備認(rèn)證服務(wù)設(shè)備認(rèn)證數(shù)據(jù)流程圖設(shè)備認(rèn)證服務(wù)用于客戶歸屬運(yùn)營(yíng)商向基礎(chǔ)設(shè)施運(yùn)營(yíng)商查詢電動(dòng)汽車充電基礎(chǔ)設(shè)施的可用狀態(tài),業(yè)務(wù)流程參見(jiàn)圖3。主要包含請(qǐng)求設(shè)備認(rèn)證接口。查詢業(yè)務(wù)策略服務(wù)a)客戶側(cè)發(fā)起流程b)基礎(chǔ)設(shè)施側(cè)發(fā)起業(yè)務(wù)策略數(shù)據(jù)數(shù)據(jù)流程圖查詢業(yè)務(wù)策略服務(wù)用于客戶歸屬運(yùn)營(yíng)商向基礎(chǔ)設(shè)施運(yùn)營(yíng)商查詢充電基礎(chǔ)設(shè)施的計(jì)費(fèi)信息或基礎(chǔ)設(shè)施運(yùn)營(yíng)商向客戶歸屬運(yùn)營(yíng)商查詢用戶計(jì)費(fèi)信息,業(yè)務(wù)流程參見(jiàn)圖4。主要包含查詢業(yè)務(wù)策略信息接口。啟動(dòng)充電服務(wù)啟動(dòng)充電服務(wù)數(shù)據(jù)流程圖啟動(dòng)充電服務(wù)用于客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)請(qǐng)求啟動(dòng)充電,基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)完成啟動(dòng)充電后推送啟動(dòng)充電結(jié)果,業(yè)務(wù)流程參見(jiàn)圖5。主要包含請(qǐng)求啟動(dòng)充電接口和推送啟動(dòng)充電結(jié)果接口。啟動(dòng)充電推送信息需要及時(shí)發(fā)送給客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)。。充電監(jiān)控服務(wù)(可選)充電監(jiān)控服務(wù)用于電動(dòng)汽車充電基礎(chǔ)設(shè)施變化狀態(tài)的查詢或推送,基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)推送業(yè)務(wù)流程參見(jiàn)圖6,客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)查詢業(yè)務(wù)流程參見(jiàn)圖7。主要包含推送充電狀態(tài)接口和查詢充電狀態(tài)接口。充電業(yè)務(wù)服務(wù)推送數(shù)據(jù)流程圖充電業(yè)務(wù)服務(wù)查詢數(shù)據(jù)流程圖充電停止服務(wù)(可選)充電停止服務(wù)數(shù)據(jù)流程圖充電停止服務(wù)用于客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)請(qǐng)求停止充電,基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)停止充電后及時(shí)推送停止充電結(jié)果,業(yè)務(wù)流程參見(jiàn)圖8。主要包含請(qǐng)求停止充電接口和推送停止充電結(jié)果接口。充電訂單服務(wù)充電訂單服務(wù)數(shù)據(jù)流程圖充電訂單服務(wù)用于基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)向客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)推送充電訂單信息,業(yè)務(wù)流程參見(jiàn)圖9。主要包含推送充電訂單信息接口。訂單對(duì)賬服務(wù)充電停止服務(wù)數(shù)據(jù)流程圖訂單對(duì)賬服務(wù)用于基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)向客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)推送訂單對(duì)賬信息,業(yè)務(wù)流程參見(jiàn)圖10。主要包含推送訂單對(duì)賬信息接口。業(yè)務(wù)信息交換接口協(xié)議概述業(yè)務(wù)信息交換共分為10個(gè)接口,分別為:請(qǐng)求設(shè)備認(rèn)證查詢業(yè)務(wù)策略信息請(qǐng)求啟動(dòng)充電推送啟動(dòng)充電結(jié)果查詢充電狀態(tài)推送充電狀態(tài)請(qǐng)求停止充電推送停止充電結(jié)果推送充電訂單信息推送訂單對(duì)賬信息請(qǐng)求設(shè)備認(rèn)證概述此接口用于客戶歸屬運(yùn)營(yíng)商請(qǐng)求充電基礎(chǔ)設(shè)施的認(rèn)證信息。接口定義接口名稱:query_equip_auth接口使用方法:由基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)實(shí)現(xiàn)此接口,客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)方調(diào)用。輸入?yún)?shù)請(qǐng)求認(rèn)證接口的主要輸入?yún)?shù)為設(shè)備認(rèn)證流水號(hào)和充電設(shè)備接口編碼,具體內(nèi)容參見(jiàn)表1。表SEQ表\*ARABIC1請(qǐng)求設(shè)備認(rèn)證的輸入?yún)?shù)表參數(shù)名稱定義參數(shù)類型描述設(shè)備認(rèn)證流水號(hào)EquipAuthSeq字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64字符充電設(shè)備接口編碼ConnectorID字符串參見(jiàn)T/CEC102.2返回值請(qǐng)求認(rèn)證接口的主要返回值為設(shè)備認(rèn)證流水號(hào)、充電設(shè)備接口編碼、操作結(jié)果和失敗原因,具體內(nèi)容參見(jiàn)表2。表SEQ表\*ARABIC2請(qǐng)求設(shè)備認(rèn)證的返回值表參數(shù)名稱定義參數(shù)類型描述設(shè)備認(rèn)證流水號(hào)EquipAuthSeq字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64字符,與6.2.3中相同充電設(shè)備接口編碼ConnectorID字符串參見(jiàn)T/CEC102.2操作結(jié)果SuccStat整型0:成功;1:失敗失敗碼FailReasonCode整型0.無(wú)1.此設(shè)備尚未插槍2.設(shè)備檢測(cè)失敗3.設(shè)備離網(wǎng)4.設(shè)備故障5.參數(shù)錯(cuò)誤6.設(shè)備不存在50~99:自定義各廠家根據(jù)實(shí)際情況定義失敗信息FailReasonMsg字符串失敗原因的描述。示例{"Ret":0,"Msg":"","Data":{"EquipAuthSeq":"12345678920160514083059","ConnectorID":"10000000000000000000000001","SuccStat":0,"FailReasonCode":0,"FailReasonMsg":""},"Sig":"7130B533249635CD17F113B1D55C2911"}查詢計(jì)費(fèi)策略信息概述此接口用于客戶歸屬運(yùn)營(yíng)商向基礎(chǔ)設(shè)施運(yùn)營(yíng)商查詢充電樁計(jì)費(fèi)策略信息。接口定義接口名稱:query_equip_business_policy接口使用方法:由基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)實(shí)現(xiàn)此接口,客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)方調(diào)用。輸入?yún)?shù)查詢業(yè)務(wù)策略信息接口的主要輸入?yún)?shù)為業(yè)務(wù)策略查詢流水號(hào)和充電設(shè)備接口編碼,具體內(nèi)容參見(jiàn)表3。表SEQ表\*ARABIC3查詢業(yè)務(wù)策略信息的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述業(yè)務(wù)策略查詢流水號(hào)EquipBizSeq是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64字符充電設(shè)備接口編碼ConnectorID是字符串參見(jiàn)T/CEC102.2返回值查詢業(yè)務(wù)策略信息接口的主要返回值為業(yè)務(wù)的計(jì)費(fèi)策略,采用多時(shí)段計(jì)費(fèi)方式,每個(gè)時(shí)段均包含一個(gè)單項(xiàng)業(yè)務(wù)策略信息體列表,返回值參見(jiàn)表4,單項(xiàng)業(yè)務(wù)策略信息體的參數(shù)和內(nèi)容參見(jiàn)表5。表SEQ表\*ARABIC4查詢業(yè)務(wù)策略信息的返回值表參數(shù)名稱定義必填參數(shù)類型描述業(yè)務(wù)策略查詢流水號(hào)EquipBizSeq是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64字符,與6.3.3中相同充電設(shè)備接口編碼ConnectorID是字符串參見(jiàn)T/CEC102.2操作結(jié)果SuccStat是整型0:成功;1:失敗失敗碼FailReason是整型0:無(wú);1:此充電樁業(yè)務(wù)策略不存在時(shí)段數(shù)NSumPeriod是整型范圍:0~32計(jì)費(fèi)信息PolicyInfos是policyInfos數(shù)組單項(xiàng)業(yè)務(wù)策略信息體表SEQ表\*ARABIC5單項(xiàng)業(yè)務(wù)策略信息體的參數(shù)表參數(shù)名稱定義必填參數(shù)類型描述時(shí)段起始時(shí)間點(diǎn)StartTime是字符串格式“HHmmss”,6字符基礎(chǔ)電費(fèi)價(jià)格ElecPrice是浮點(diǎn)型單位:元/度,小數(shù)點(diǎn)后4位?;A(chǔ)服務(wù)費(fèi)價(jià)格ServicePrice是浮點(diǎn)型單位:元/度,小數(shù)點(diǎn)后4位。協(xié)議電費(fèi)價(jià)格DiscountElecPrice是浮點(diǎn)型單位:元/度,小數(shù)點(diǎn)后4位?;A(chǔ)設(shè)施運(yùn)營(yíng)商和客戶歸屬運(yùn)營(yíng)商協(xié)議電價(jià)。無(wú)協(xié)議電價(jià),則填寫(xiě)基礎(chǔ)電費(fèi)價(jià)格。協(xié)議服務(wù)費(fèi)價(jià)格DiscountServicePrice是浮點(diǎn)型單位:元/度,小數(shù)點(diǎn)后4位?;A(chǔ)設(shè)施運(yùn)營(yíng)商和客戶歸屬運(yùn)營(yíng)商協(xié)議服務(wù)費(fèi)。無(wú)協(xié)議服務(wù)費(fèi),則填寫(xiě)基礎(chǔ)服務(wù)費(fèi)。示例{"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"}請(qǐng)求啟動(dòng)充電概述此接口用于客戶歸屬運(yùn)營(yíng)商請(qǐng)求設(shè)備歸屬運(yùn)營(yíng)商啟動(dòng)充電信息,發(fā)送啟動(dòng)充電命令,不代表啟動(dòng)充電成功。接口定義接口名稱:start_charge接口使用方法:由基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)實(shí)現(xiàn)此接口,客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)方調(diào)用。輸入?yún)?shù)請(qǐng)求啟動(dòng)充電接口的主要輸入?yún)?shù)為充電訂單號(hào)、充電設(shè)備接口編碼和二維碼其他信息,具體內(nèi)容參見(jiàn)表6。表SEQ表\*ARABIC6請(qǐng)求啟動(dòng)充電的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符充電設(shè)備接口編碼ConnectorID是字符串參見(jiàn)T/CEC102.2二維碼其他信息QRCode是字符串參見(jiàn)T/CEC102.2,二維碼中含有自定義部分的,需要將自定義部分的原文傳輸。具體二維碼數(shù)據(jù)參考基礎(chǔ)設(shè)施運(yùn)營(yíng)商要求。用戶編號(hào)UserNo否字符串長(zhǎng)度不超過(guò)32個(gè)字符手機(jī)號(hào)Phone否字符串長(zhǎng)度11個(gè)字符車牌號(hào)LicensePlate否字符串長(zhǎng)度不超過(guò)20個(gè)字符車輛識(shí)別碼VIN否字符串參照GB/T27930標(biāo)準(zhǔn)規(guī)定,長(zhǎng)度17位字符預(yù)凍結(jié)金額PreFrozenAmount否浮點(diǎn)型客戶歸屬運(yùn)營(yíng)商采用預(yù)付費(fèi)方式時(shí),充電總費(fèi)用接近此預(yù)付金額時(shí),建議充電設(shè)施運(yùn)營(yíng)商主動(dòng)停止充電,防止過(guò)充情況。返回值請(qǐng)求啟動(dòng)充電接口的主要返回值包含充電訂單號(hào)、充電訂單狀態(tài)、充電設(shè)備接口編碼、操作結(jié)果和失敗原因,具體內(nèi)容參見(jiàn)表7。表SEQ表\*ARABIC7請(qǐng)求啟動(dòng)充電的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符。充電訂單狀態(tài)OrderStatus是整型1、啟動(dòng)中2、充電中3、停止中4、充電完成5、訂單掛起6、充電異常結(jié)束7、啟動(dòng)失敗充電設(shè)備接口編碼ConnectorID是字符串參見(jiàn)T/CEC102.2操作結(jié)果SuccStat是整型0:成功;1:失敗充電啟動(dòng)超時(shí)時(shí)間OverTime是整形單位:秒,參數(shù)范圍建議不超過(guò)900s,實(shí)際充電啟動(dòng)結(jié)果的超時(shí)判斷時(shí)間。失敗碼FailReasonCode是整型0:無(wú)1:此設(shè)備不存在(設(shè)備已下線或站點(diǎn)非正常使用狀態(tài)時(shí),認(rèn)為設(shè)備不存在)2:此設(shè)備離線3:無(wú)此設(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"}推送啟動(dòng)充電結(jié)果概述此接口用于設(shè)備歸屬運(yùn)營(yíng)商向客戶歸屬運(yùn)營(yíng)商推送啟動(dòng)充電結(jié)果信息。接口定義接口名稱:notification_start_charge_result接口使用方法:由客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)實(shí)現(xiàn)此接口,基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)方調(diào)用。輸入?yún)?shù)推送啟動(dòng)充電結(jié)果接口的主要輸入?yún)?shù)為充電訂單號(hào)、充電設(shè)備接口編碼和充電啟動(dòng)時(shí)間,具體內(nèi)容參見(jiàn)表8。表SEQ表\*ARABIC8推送啟動(dòng)充電結(jié)果的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符充電訂單狀態(tài)OrderStatus是整型1、啟動(dòng)中2、充電中3、停止中4、充電完成5、訂單掛起6、充電異常結(jié)束7、啟動(dòng)失敗充電設(shè)備接口編碼ConnectorID是字符串參見(jiàn)T/CEC102.2充電啟動(dòng)時(shí)間StartTime是字符串格式“yyyy-MM-ddHH:mm:ss”,啟動(dòng)失敗后為當(dāng)前時(shí)間值,接收方可忽略。停止充電驗(yàn)證碼IdentCode否字符串啟動(dòng)充電時(shí)收到的驗(yàn)證碼,用于充電樁手動(dòng)停止充電時(shí)間戳PushTimeStamp是字符串格式“yyyy-MM-ddHH:mm:ss”,推送信息的推送時(shí)間。失敗碼FailReasonCode否整型0:無(wú);1:此設(shè)備不存在(設(shè)備已下線或站點(diǎn)非正常使用狀態(tài)時(shí),認(rèn)為設(shè)備不存在)2:此設(shè)備離線3:無(wú)此設(shè)備使用權(quán)限4:此設(shè)備正忙50-99:自定義失敗信息FailReasonMsg否字符串失敗原因的描述返回值推送啟動(dòng)充電結(jié)果接口的主要返回值為充電訂單號(hào)、操作結(jié)果、失敗原因和停止充電驗(yàn)證碼,具體內(nèi)容參見(jiàn)表9。表SEQ表\*ARABIC9推送啟動(dòng)充電結(jié)果的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符操作結(jié)果SuccStat是整型0:成功;1:失敗失敗原因FailReasonMsg是字符串失敗原因的描述示例{"Ret":0,"Msg":"","Data":{"OrderNo":"123456789201605140830591234","SuccStat":0,"FailReasonMsg":"",},"Sig":"7130B533249635CD17F113B1D55C2911"}查詢訂單狀態(tài)概述此接口用于客戶歸屬運(yùn)營(yíng)商請(qǐng)求設(shè)備歸屬運(yùn)營(yíng)商充電訂單狀態(tài)信息。接口定義接口名稱:query_equip_charge_status接口使用方法:由基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)實(shí)現(xiàn)此接口,客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)方調(diào)用。輸入?yún)?shù)查詢充電訂單狀態(tài)接口的主要輸入?yún)?shù)為充電訂單號(hào),具體內(nèi)容參見(jiàn)表10。表SEQ表\*ARABIC10查詢充電訂單狀態(tài)的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符返回值查詢充電訂單狀態(tài)接口的主要返回值為充電訂單號(hào)、充電訂單狀態(tài)、充電設(shè)備接口編碼、相關(guān)狀態(tài)信息和充電明細(xì)信息體列表,具體內(nèi)容參見(jiàn)表11,充電明細(xì)信息體內(nèi)容參見(jiàn)表12。表SEQ表\*ARABIC11查詢充電狀態(tài)的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符用戶編號(hào)UserNo否字符串長(zhǎng)度不超過(guò)255手機(jī)號(hào)Phone否字符串長(zhǎng)度11個(gè)字符車牌號(hào)LicensePlate否字符串長(zhǎng)度不超過(guò)20個(gè)字符車輛識(shí)別碼VIN否字符串參照GB/T27930標(biāo)準(zhǔn)規(guī)定充電訂單狀態(tài)OrderStatus是整型1、啟動(dòng)中2、充電中3、停止中4、充電完成5、訂單掛起6、充電異常結(jié)束7、啟動(dòng)失敗充電設(shè)備接口編碼ConnectorID是字符串參見(jiàn)T/CEC102.2—2016充電設(shè)備接口狀態(tài)ConnectorStatus是整型1:空閑;2:占用(未充電);3:占用(充電中);4:占用(預(yù)約鎖定);255:故障A相電流CurrentA是浮點(diǎn)型單位:A,默認(rèn):0含直流(輸出)A相電壓VoltageA是浮點(diǎn)型單位:V,默認(rèn):0含直流(輸出)B相電流CurrentB否浮點(diǎn)型單位:A,默認(rèn):0B相電壓VoltageB否浮點(diǎn)型單位:V,默認(rèn):0C相電流CurrentC否浮點(diǎn)型單位:A,默認(rèn):0C相電壓VoltageC否浮點(diǎn)型單位:V,默認(rèn):0電池剩余電量Soc是浮點(diǎn)型默認(rèn):0,小數(shù)點(diǎn)后1位開(kāi)始充電時(shí)間StartTime是字符型格式“yyyy-MM-ddHH:mm:ss”本次采樣時(shí)間EndTime是字符型格式“yyyy-MM-ddHH:mm:ss”累計(jì)充電量TotalPower是浮點(diǎn)型單位:度,小數(shù)點(diǎn)后3位累計(jì)電費(fèi)ElecMoney否浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位累計(jì)服務(wù)費(fèi)SeviceMoney否浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位累計(jì)總金額TotalMoney否浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位時(shí)段數(shù)NSumPeriod否整型范圍:0~32充電明細(xì)信息ChargeDetails否ChargeDetails數(shù)組單時(shí)段充電明細(xì)信息,見(jiàn)6.6.4表SEQ表\*ARABIC12充電明細(xì)信息體的參數(shù)表參數(shù)名稱定義必填參數(shù)類型描述開(kāi)始時(shí)間DetailStartTime是字符串格式“yyyy-MM-ddHH:mm:ss”結(jié)束時(shí)間DetailEndTime是字符串格式“yyyy-MM-ddHH:mm:ss”時(shí)段電價(jià)ElecPrice否浮點(diǎn)型單位:元/度,小數(shù)點(diǎn)后4位時(shí)段服務(wù)費(fèi)價(jià)格SevicePrice否浮點(diǎn)型單位:元/度,小數(shù)點(diǎn)后4位時(shí)段充電量DetailPower是浮點(diǎn)型單位:度,小數(shù)點(diǎn)后2位時(shí)段電費(fèi)DetailElecMoney否浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位時(shí)段服務(wù)費(fèi)DetailSeviceMoney否浮點(diǎn)型單位:元,小數(shù)點(diǎn)后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è)備歸屬運(yùn)營(yíng)商向客戶歸屬運(yùn)營(yíng)商推送充電設(shè)備的充電狀態(tài)。接口定義接口名稱:notification_equip_charge_status接口使用方法:由客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)實(shí)現(xiàn)此接口,基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)方調(diào)用。輸入?yún)?shù)推送充電狀態(tài)接口的主要輸入?yún)?shù)為充電訂單號(hào)、充電訂單狀態(tài)、充電設(shè)備接口編碼、相關(guān)狀態(tài)信息和充電明細(xì)信息體列表,具體內(nèi)容參見(jiàn)表13。表SEQ表\*ARABIC13推送充電狀態(tài)的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符用戶編號(hào)UserNo否字符串長(zhǎng)度不超過(guò)255手機(jī)號(hào)Phone否字符串長(zhǎng)度11個(gè)字符車牌號(hào)LicensePlate否字符串長(zhǎng)度不超過(guò)20個(gè)字符車輛識(shí)別碼VIN否字符串參照GB/T27930標(biāo)準(zhǔn)規(guī)定充電訂單狀態(tài)OrderStatus是整型1、啟動(dòng)中2、充電中3、停止中4、充電完成5、訂單掛起6、充電異常結(jié)束7、啟動(dòng)失敗充電設(shè)備接口編碼ConnectorID是字符串參見(jiàn)T/CEC102.2—2016時(shí)間戳PushTimeStamp是字符串格式“yyyy-MM-ddHH:mm:ss”,推送時(shí)間充電設(shè)備接口狀態(tài)ConnectorStatus是整型1:空閑;2:占用(未充電);3:占用(充電中);4:占用(預(yù)約鎖定);255:故障A相電流CurrentA是浮點(diǎn)型單位:A,默認(rèn):0含直流(輸出)A相電壓VoltageA是浮點(diǎn)型單位:V,默認(rèn):0含直流(輸出)B相電流CurrentB否浮點(diǎn)型單位:A,默認(rèn):0B相電壓VoltageB否浮點(diǎn)型單位:V,默認(rèn):0C相電流CurrentC否浮點(diǎn)型單位:A,默認(rèn):0C相電壓VoltageC否浮點(diǎn)型單位:V,默認(rèn):0電池剩余電量SOC是浮點(diǎn)型參數(shù)范圍:0.0-100.0開(kāi)始充電時(shí)間StartTime是字符型格式“yyyy-MM-ddHH:mm:ss”本次采樣時(shí)間EndTime是字符型格式“yyyy-MM-ddHH:mm:ss”累計(jì)充電量TotalPower是浮點(diǎn)型單位:度,小數(shù)點(diǎn)后3位累計(jì)電費(fèi)ElecMoney否浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位累計(jì)服務(wù)費(fèi)SeviceMoney否浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位累計(jì)總金額TotalMoney否浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位累計(jì)協(xié)議電費(fèi)DiscountElecMoney是浮點(diǎn)型單位:元/度,小數(shù)點(diǎn)后2位。充電設(shè)施運(yùn)營(yíng)商和客戶運(yùn)營(yíng)商協(xié)議電價(jià)計(jì)費(fèi)。無(wú)協(xié)議電價(jià),則填寫(xiě)為累計(jì)電費(fèi)。累計(jì)協(xié)議服務(wù)費(fèi)DiscountServiceMoney是浮點(diǎn)型單位:元/度,小數(shù)點(diǎn)后2位。充電設(shè)施運(yùn)營(yíng)商和客戶運(yùn)營(yíng)商協(xié)議服務(wù)費(fèi)計(jì)費(fèi)。無(wú)協(xié)議服務(wù)費(fèi),則填寫(xiě)為累計(jì)服務(wù)費(fèi)。時(shí)段數(shù)NSumPeriod否整型參數(shù)范圍:0~32充電明細(xì)信息ChargeDetails否ChargeDetails數(shù)組單時(shí)段充電明細(xì)信息,見(jiàn)6.6.4返回值推送充電狀態(tài)接口的主要返回值為充電訂單號(hào)和操作結(jié)果,具體內(nèi)容參見(jiàn)表14。表SEQ表\*ARABIC14推送充電狀態(tài)的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符操作結(jié)果SuccStat是整型0:成功;1:失敗失敗原因FailReasonMsg是字符串失敗原因的描述示例{"Ret":0,"Msg":"","Data":{"OrderNo":"123456789201605140830591234","SuccStat":0,"FailReasonMsg":""},"Sig":"7130B533249635CD17F113B1D55C2911"}請(qǐng)求停止充電概述此接口用于客戶歸屬運(yùn)營(yíng)商請(qǐng)求設(shè)備歸屬運(yùn)營(yíng)商設(shè)備停止充電信息。接口定義接口名稱:stop_charge接口使用方法:由基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)實(shí)現(xiàn)此接口,客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)方調(diào)用。輸入?yún)?shù)請(qǐng)求停止充電接口的主要輸入?yún)?shù)為充電訂單號(hào)、充電設(shè)備接口編碼,具體內(nèi)容參見(jiàn)表15。表SEQ表\*ARABIC15請(qǐng)求停止充電的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符充電設(shè)備接口編碼ConnectorID是字符串參見(jiàn)T/CEC102.2返回值請(qǐng)求停止充電接口的主要返回值為充電訂單號(hào)、充電訂單狀態(tài)、操作結(jié)果和失敗原因,具體內(nèi)容參見(jiàn)表16。表SEQ表\*ARABIC16請(qǐng)求停止充電的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符充電訂單狀態(tài)OrderStatus是整型1、啟動(dòng)中2、充電中3、停止中4、充電完成5、訂單掛起6、充電異常結(jié)束7、啟動(dòng)失敗操作結(jié)果SuccStat是整型0:成功;1:失敗充電停止超時(shí)時(shí)間OverTime是整形單位:秒,參數(shù)范圍建議不超過(guò)900s,實(shí)際充電停止結(jié)果的超時(shí)判斷時(shí)間。失敗碼FailReasonCode是整型0:無(wú);1:此設(shè)備不存在;2:此設(shè)備離線(設(shè)備無(wú)響應(yīng)時(shí),認(rèn)為是離線)3:設(shè)備已停止充電4:無(wú)權(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è)備歸屬運(yùn)營(yíng)商向客戶歸屬運(yùn)營(yíng)商推送停止充電結(jié)果信息。1)客戶運(yùn)營(yíng)商發(fā)送請(qǐng)求停止充電成功后,設(shè)備運(yùn)營(yíng)商才進(jìn)行推送停止充電結(jié)果。2)另外由設(shè)備發(fā)起充電停止時(shí),也會(huì)由設(shè)備運(yùn)營(yíng)商推送停止充電結(jié)果。接口定義接口名稱:notification_stop_charge_result接口使用方法:由客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)實(shí)現(xiàn)此接口,基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)方調(diào)用。輸入?yún)?shù)推送充電停止接口的主要輸入?yún)?shù)為充電訂單號(hào)、充電訂單狀態(tài)、充電設(shè)備接口編碼、相關(guān)狀態(tài)信息和充電明細(xì)信息體列表,具體內(nèi)容參見(jiàn)表17。表SEQ表\*ARABIC17推送停止充電結(jié)果的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符充電訂單狀態(tài)OrderStatus是整型1、啟動(dòng)中2、充電中3、停止中4、充電完成5、訂單掛起6、充電異常結(jié)束7、啟動(dòng)失敗充電設(shè)備接口編碼ConnectorID是字符串參見(jiàn)T/CEC102.2成功標(biāo)識(shí)SuccStat是整型0:成功;1:失敗時(shí)間戳PushTimeStamp是字符串格式“yyyy-MM-ddHH:mm:ss”,推送時(shí)間停止失敗碼FailReasonCode是整型0:無(wú);1:此設(shè)備不存在;2:此設(shè)備離線:3:設(shè)備已停止充電;50~99:自定義停止失敗信息FailReasonMsg是字符串停止失敗原因描述返回值推送停止充電結(jié)果接口的主要返回值為充電訂單號(hào)、操作結(jié)果和失敗原因,具體內(nèi)容參見(jiàn)表18。表SEQ表\*ARABIC18推送停止充電結(jié)果的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符操作結(jié)果SuccStat是整型0:成功;1:失敗失敗原因FailReason是整型0:無(wú);1:接收失?。皇纠齵"Ret":0,"Msg":"","Data":{"OrderNo":"123456789201605140830591234","SuccStat":0,"FailReason":0},"Sig":"7130B533249635CD17F113B1D55C2911"}推送充電訂單信息概述此接口用于設(shè)備歸屬運(yùn)營(yíng)商向客戶歸屬運(yùn)營(yíng)商推送充電訂單信息。接口定義接口名稱:notification_charge_order_info接口使用方法:由客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)實(shí)現(xiàn)此接口,基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)調(diào)用。輸入?yún)?shù)推送充電訂單信息接口的主要輸入?yún)?shù)為充電訂單號(hào)、充電設(shè)備接口編碼、訂單的電量信息、訂單的費(fèi)用信息、訂單結(jié)束原因和充電明細(xì)信息體列表,具體內(nèi)容參見(jiàn)表19。表SEQ表\*ARABIC19推送充電訂單信息的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符充電設(shè)備接口編碼ConnectorID是字符串參見(jiàn)T/CEC102.2—2016用戶編號(hào)UserNo否字符串長(zhǎng)度不超過(guò)32個(gè)字符手機(jī)號(hào)Phone否字符串長(zhǎng)度11個(gè)字符車牌號(hào)LicensePlate否字符串長(zhǎng)度不超過(guò)20個(gè)字符車輛識(shí)別碼VIN否字符串參照GB/T27930標(biāo)準(zhǔn)規(guī)定,長(zhǎng)度17個(gè)字符賬務(wù)日期AccountDate否字符串格式“yyyy-MM-dd”,訂單的對(duì)賬日期。開(kāi)始充電時(shí)間StartTime是字符串格式“yyyy-MM-ddHH:mm:ss”結(jié)束充電時(shí)間EndTime是字符串格式“yyyy-MM-ddHH:mm:ss”累計(jì)充電量TotalPower是浮點(diǎn)型單位kWh,小數(shù)點(diǎn)后3位尖階段電量CuspElect否浮點(diǎn)型單位kWh,小數(shù)點(diǎn)后3位尖總金額CuspMoney否浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位峰階段電量PeakElect否浮點(diǎn)型單位kWh,小數(shù)點(diǎn)后3位峰總金額PeakMoney否浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位平階段電量FlatElect否浮點(diǎn)型單位kWh,小數(shù)點(diǎn)后3位平總金額FlatMoney否浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位谷階段電量ValleyElect否浮點(diǎn)型單位kWh,小數(shù)點(diǎn)后3位谷總金額ValleyMoney否浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位時(shí)間戳PushTimeStamp是字符串格式“yyyy-MM-ddHH:mm:ss”總電費(fèi)TotalElecMoney是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位總服務(wù)費(fèi)TotalSeviceMoney是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位累計(jì)總金額TotalMoney是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位時(shí)段協(xié)議電費(fèi)DiscountElecMoney否浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位時(shí)段協(xié)議服務(wù)費(fèi)DiscountServiceMoney否浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位時(shí)段協(xié)議總金額DiscountTotalMoney否浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位充電結(jié)束原因StopReason是整型0:用戶手動(dòng)停止充電1:客戶歸屬地運(yùn)營(yíng)商平臺(tái)停止充電2:BMS停止充電;3:充電機(jī)設(shè)備故障;4:連接器斷開(kāi)5-99:自定義時(shí)段數(shù)NSumPeriod否整型范圍:0~32充電明細(xì)信息ChargeDetails否ChargeDetails數(shù)組單時(shí)段充電明細(xì)信息,見(jiàn)6.6.4返回值推送充電訂單信息接口的主要返回值為充電訂單號(hào)、充電設(shè)備接口編碼和確認(rèn)結(jié)果,具體內(nèi)容參見(jiàn)表20。表SEQ表\*ARABIC20推送充電訂單信息的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符充電設(shè)備接口編碼ConnectorID是字符串參見(jiàn)T/CEC102.2確認(rèn)結(jié)果ConfirmResult否整型0:成功,表示對(duì)此訂單的對(duì)賬確認(rèn)。1:失敗爭(zhēng)議原因DisputeReason否字符串爭(zhēng)議訂單出現(xiàn)的原因確認(rèn)時(shí)間ConfirmTime是字符串格式“yyyy-MM-ddHH:mm:ss”示例{"Ret":0,"Msg":"","Data":{"OrderNo":"123456789201605140830591234","ConnectorID":"10000000000000000000000001","ConfirmResult":0,"DisputeReason":"無(wú)","ConfirmTime":"2020-04-1815:20:40"},"Sig":"7130B533249635CD17F113B1D55C2911"}推送訂單賬務(wù)日期(可選)概述客戶歸屬運(yùn)營(yíng)商在訂單推送時(shí)無(wú)法確認(rèn)賬務(wù)日期時(shí),可由基礎(chǔ)設(shè)施運(yùn)營(yíng)商向客戶歸屬運(yùn)營(yíng)商推送賬務(wù)日期。接口定義接口名稱:notification_order_check_date 接口使用方法:由客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)實(shí)現(xiàn)此接口,基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)方調(diào)用。輸入?yún)?shù)推送訂單對(duì)賬日期接口的主要輸入?yún)?shù)為充電訂單號(hào)、賬務(wù)日期,具體內(nèi)容參見(jiàn)表1。表1推送充電訂單信息的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符賬務(wù)日期AccountDate是字符串格式“yyyy-MM-dd”返回值推送充電訂單賬戶日期接口的主要返回值為充電訂單號(hào)和確認(rèn)結(jié)果,具體內(nèi)容參見(jiàn)表2。表2推送充電訂單信息的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符確認(rèn)結(jié)果ConfirmResult是整型0:成功1:訂單不存在示例{"Ret":0,"Msg":"","Data":{"OrderNo":"123456789201605140830591234","ConfirmResult":0},"Sig":"7130B533249635CD17F113B1D55C2911"}推送充電訂單確認(rèn)結(jié)果(可選)概述此接口用于客戶歸屬運(yùn)營(yíng)商推送單筆訂單的確認(rèn)結(jié)果信息給設(shè)備歸屬運(yùn)營(yíng)商。接口定義接口名稱:notification_charge_order_confirm接口使用方法:由基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)方實(shí)現(xiàn)此接口,客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)方調(diào)用。輸入?yún)?shù)推送充電訂單確認(rèn)結(jié)果接口的主要輸入?yún)?shù)為充電訂單號(hào),具體內(nèi)容參見(jiàn)表。表21推送充電訂單確認(rèn)結(jié)果的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符返回值推送充電訂單確認(rèn)結(jié)果接口的主要返回值為充電訂單號(hào)、充電設(shè)備接口編碼和確認(rèn)結(jié)果,具體內(nèi)容參見(jiàn)表。表22推送充電訂單確認(rèn)結(jié)果的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符確認(rèn)結(jié)果ConfirmResult是整型0:成功1:爭(zhēng)議訂單爭(zhēng)議原因DisputeReason否整型爭(zhēng)議訂單出現(xiàn)的原因。如果對(duì)賬確認(rèn)結(jié)果失敗,此項(xiàng)必填1:電量不一致2:電費(fèi)不一致3:服務(wù)費(fèi)不一致4:客戶運(yùn)營(yíng)商無(wú)此訂單5:設(shè)施運(yùn)營(yíng)商無(wú)此訂單50-99:其他,各級(jí)運(yùn)營(yíng)商可以自定義確認(rèn)時(shí)間ConfirmTime是字符串格式“yyyy-MM-ddHH:mm:ss”示例{"Ret":0,"Msg":"","Data":{"OrderNo":"123456789201605140830591234","ConfirmResult":0"DisputeReason":"無(wú)","ConfirmTime":"2016-03-0401:23:51" },"Sig":"7130B533249635CD17F113B1D55C2911"}查詢充電訂單確認(rèn)結(jié)果(可選)概述此接口用于設(shè)備歸屬運(yùn)營(yíng)商向客戶歸屬運(yùn)營(yíng)商查詢單筆訂單的確認(rèn)結(jié)果。接口定義接口名稱:query_charge_order_confirm_result接口使用方法:由客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)實(shí)現(xiàn)此接口,基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)方調(diào)用。輸入?yún)?shù)查詢通知充電訂單確認(rèn)結(jié)果接口的主要輸入?yún)?shù)為充電訂單號(hào),具體內(nèi)容參見(jiàn)表23。表23查詢充電訂單確認(rèn)結(jié)果的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符返回值查詢充電訂單確認(rèn)結(jié)果接口的主要返回值為充電訂單號(hào)、確認(rèn)結(jié)果、爭(zhēng)議原因、確認(rèn)原因,具體內(nèi)容參見(jiàn)表24。表24查詢充電訂單確認(rèn)結(jié)果的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符確認(rèn)結(jié)果ConfirmResult是整型0:成功1:爭(zhēng)議交易爭(zhēng)議原因DisputeReason否整型爭(zhēng)議訂單的原因。如果對(duì)賬確認(rèn)結(jié)果失敗,此項(xiàng)必填0:平賬1:電量不一致2:電費(fèi)不一致3:服務(wù)費(fèi)不一致4:客戶運(yùn)營(yíng)商無(wú)此訂單5:設(shè)施運(yùn)營(yíng)商無(wú)此訂單50-99:其他,各級(jí)運(yùn)營(yíng)商可以自定義確認(rèn)時(shí)間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ù)信息(可選)概述此接口用于客戶歸屬運(yùn)營(yíng)商向設(shè)備歸屬運(yùn)營(yíng)商查詢輔助業(yè)務(wù)信息。接口定義接口名稱:query_other_policy接口使用方法:由設(shè)備歸屬運(yùn)營(yíng)商平臺(tái)方實(shí)現(xiàn)此接口,客戶歸屬運(yùn)營(yíng)商平臺(tái)方調(diào)用。輸入?yún)?shù)查詢輔助業(yè)務(wù)信息接口的主要輸入?yún)?shù)為輔助業(yè)務(wù)信息查詢流水號(hào)、輔助業(yè)務(wù)代碼,具體內(nèi)容參見(jiàn)表25。表25查詢輔助業(yè)務(wù)信息的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述輔助業(yè)務(wù)信息查詢流水號(hào)EquipBizSeq是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符輔助業(yè)務(wù)代號(hào)ServiceCode是整型1:地鎖業(yè)務(wù)50-99自定義返回值查詢輔助業(yè)務(wù)信息接口的主要返回值為其他業(yè)務(wù)的計(jì)費(fèi)策略,采用多時(shí)段計(jì)費(fèi)方式,每個(gè)時(shí)段均包含一個(gè)單項(xiàng)業(yè)務(wù)策略信息體列表,返回值參見(jiàn)表4,單項(xiàng)業(yè)務(wù)策略信息體的參數(shù)和內(nèi)容參見(jiàn)表5。表26查詢輔助業(yè)務(wù)信息的返回值表參數(shù)名稱定義必填參數(shù)類型描述輔助業(yè)務(wù)信息查詢流水號(hào)EquipBizSeq是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符輔助業(yè)務(wù)代號(hào)ServiceCode是整型1:地鎖業(yè)務(wù)50-99自定義操作結(jié)果SuccStat是整型0:成功;1:失敗失敗碼FailReason是整型0:無(wú);1:不存在其他業(yè)務(wù)策略時(shí)段數(shù)NSumPeriod是整型范圍:0~32計(jì)費(fèi)信息PolicyInfos是PolicyInfos數(shù)組單項(xiàng)業(yè)務(wù)策略信息體表27單項(xiàng)業(yè)務(wù)策略信息體的參數(shù)表參數(shù)名稱定義必填參數(shù)類型描述時(shí)段起始時(shí)間點(diǎn)StartTime是字符串格式“HHmmss”,6字符時(shí)段結(jié)束時(shí)間點(diǎn)EndTime是字符串格式“HHmmss”,6字符時(shí)段服務(wù)費(fèi)ServicePrice是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后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ùn)營(yíng)商向客戶歸屬運(yùn)營(yíng)商推送輔助業(yè)務(wù)訂單信息。接口定義接口名稱:notification_other_order_info接口使用方法:由客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)實(shí)現(xiàn)此接口,基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)方調(diào)用。輸入?yún)?shù)推送輔助業(yè)務(wù)訂單信息接口的主要輸入?yún)?shù)為訂單號(hào)、輔助業(yè)務(wù)訂單號(hào)、賬務(wù)日期、訂單開(kāi)始時(shí)間、訂單結(jié)束時(shí)間、訂單的費(fèi)用信息,具體內(nèi)容參見(jiàn)表28。表28推送輔助業(yè)務(wù)訂單的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符輔助業(yè)務(wù)類型ServiceCode是整型1:地鎖業(yè)務(wù)50-99自定義賬務(wù)日期AccountDate是字符串格式“yyyy-MM-dd”訂單開(kāi)始時(shí)間StartTime是字符串格式“yyyy-MM-ddHH:mm:ss”訂單結(jié)束時(shí)間EndTime是字符串格式“yyyy-MM-ddHH:mm:ss”時(shí)間戳PushTimeStamp是字符串格式“yyyy-MM-ddHH:mm:ss”,推送時(shí)間總服務(wù)費(fèi)TotalSeviceMoney是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位累計(jì)總金額TotalMoney是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位返回值推送輔助業(yè)務(wù)訂單信息接口的主要返回值為充電訂單號(hào)、確認(rèn)結(jié)果,具體內(nèi)容參見(jiàn)表29。表29推送輔助業(yè)務(wù)訂單信息的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符確認(rèn)結(jié)果ConfirmResult是整型0:成功1:失敗示例{"Ret":0,"Msg":"","Data":{"OrderNo":"123456789201605140830591234","ConfirmResult":0},"Sig":"7130B533249635CD17F113B1D55C2911"}推送日對(duì)賬文件下載地址概述該接口用于設(shè)施運(yùn)營(yíng)商向客戶歸屬運(yùn)營(yíng)商推送日對(duì)賬訂單文件下載地址。接口定義接口名稱:notification_charge_bills接口使用方法:由客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)方實(shí)現(xiàn)此接口,基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)方調(diào)用。輸入?yún)?shù)推送日對(duì)賬文件下載地址接口的主要輸入?yún)?shù)為日賬單流水號(hào)、文件路徑、賬務(wù)日期,具體內(nèi)容參見(jiàn)表30。表30推送日對(duì)賬文件下載地址的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述日賬單流水號(hào)BillsNo是字符串格式“運(yùn)營(yíng)商ID_日期(yyyyMMdd)_唯一編號(hào)”,不超過(guò)64字符文件路徑BillDownloadUrl是字符串對(duì)賬文件下載路徑,文件名稱由業(yè)務(wù)雙方進(jìn)行自定義賬務(wù)日期AccountDate是字符串格式“yyyy-MM-dd”返回值推送日對(duì)賬文件下載地址接口的返回值為確認(rèn)結(jié)果,具體內(nèi)容參見(jiàn)表31。表31推送日對(duì)賬文件下載地址的返回值表參數(shù)名稱定義必填參數(shù)類型描述確認(rèn)結(jié)果ConfirmResult是整型0:成功1:失敗示例{"Ret":0,"Msg":"","Data":{"ConfirmResult":0},"Sig":"7130B533249635CD17F113B1D55C2911"}對(duì)賬文件對(duì)賬文件應(yīng)符合附件A.2日對(duì)賬文件要求查詢?nèi)諏?duì)賬文件下載地址(可選)概述該接口用于客戶歸屬運(yùn)營(yíng)商向設(shè)施運(yùn)營(yíng)商查詢?nèi)諏?duì)賬訂單文件下載地址信息。接口定義接口名稱:query_charge_bills接口使用方法:由基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)方實(shí)現(xiàn)此接口,客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)方調(diào)用。輸入?yún)?shù)查詢?nèi)諏?duì)賬文件下載地址接口的主要輸入?yún)?shù)為賬務(wù)日期,具體內(nèi)容參見(jiàn)表32表32查詢?nèi)諏?duì)賬文件下載地址的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述賬務(wù)日期AccountDate是字符串格式“yyyy-MM-dd”返回值查詢?nèi)諏?duì)賬文件下載地址接口的返回值為賬單狀態(tài)、賬單失敗原因、日賬單流水號(hào)、文件路徑、賬務(wù)日期,具體內(nèi)容參見(jiàn)表33。表33查詢?nèi)諏?duì)賬文件下載地址的返回值表參數(shù)名稱定義必填參數(shù)類型描述賬單狀態(tài)SuccStat是整型0:已生成;1:未生成賬單失敗原因FailReason是整型0:無(wú)1:賬單未生成2:賬單不存在日賬單流水號(hào)BillsNo是字符串格式“運(yùn)營(yíng)ID_日期(yyyyMMdd)_唯一編號(hào)”,不超過(guò)64字符文件路徑BillDownloadUrl是字符串對(duì)賬文件下載路徑,文件名稱由業(yè)務(wù)雙方進(jìn)行自定義賬務(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"}對(duì)賬文件對(duì)賬文件應(yīng)符合附件A.2日對(duì)賬文件要求推送日對(duì)賬確認(rèn)文件下載地址概述該接口用于客戶歸屬運(yùn)營(yíng)商向設(shè)施歸屬運(yùn)營(yíng)商推送日對(duì)賬確認(rèn)文件下載地址信息。接口定義接口名稱:notification_charge_bills_confirm接口使用方法:由基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)方實(shí)現(xiàn)此接口,客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)方調(diào)用。輸入?yún)?shù)推送日對(duì)賬確認(rèn)文件下載地址接口的主要輸入?yún)?shù)為日賬單流水號(hào)、文件路徑、賬務(wù)日期,具體內(nèi)容參見(jiàn)表34表34推送日對(duì)賬確認(rèn)文件下載地址的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述日賬單流水號(hào)BillsNo是字符串格式“運(yùn)營(yíng)商ID_日期(yyyyMMdd)_唯一編號(hào)”,不超過(guò)64字符文件路徑BillDownloadUrl是字符串對(duì)賬文件下載路徑,文件名稱由業(yè)務(wù)雙方進(jìn)行自定義賬務(wù)日期AccountDate是字符串格式“yyyy-MM-dd”返回值推送日對(duì)賬確認(rèn)文件下載地址接口的返回值為確認(rèn)結(jié)果,具體內(nèi)容參見(jiàn)表35。表35推送日對(duì)賬確認(rèn)文件下載地址的返回值表參數(shù)名稱定義必填參數(shù)類型描述確認(rèn)結(jié)果ConfirmResult是整型0:成功1:失敗示例{"Ret":0,"Msg":"","Data":{"ConfirmResult":0},"Sig":"7130B533249635CD17F113B1D55C2911"}對(duì)賬文件對(duì)賬文件應(yīng)符合附件A.2日對(duì)賬文件要求查詢?nèi)諏?duì)賬確認(rèn)文件下載地址(可選)概述該接口用于設(shè)施運(yùn)營(yíng)商向客戶歸屬運(yùn)營(yíng)商查詢?nèi)諏?duì)賬確認(rèn)文件下載地址。接口定義接口名稱:query_charge_bills_confirm接口使用方法:由客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)方實(shí)現(xiàn)此接口,基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)方調(diào)用。輸入?yún)?shù)查詢?nèi)諏?duì)賬確認(rèn)文件下載地址接口的主要輸入?yún)?shù)為賬務(wù)日期,具體內(nèi)容參見(jiàn)表36。表36查詢?nèi)諏?duì)賬確認(rèn)文件下載地址的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述賬務(wù)日期AccountDate是字符串格式“yyyy-MM-dd”返回值查詢?nèi)諏?duì)賬確認(rèn)文件下載地址接口的返回值為賬單狀態(tài)、失敗原因、日賬單流水號(hào)、文件路徑、賬務(wù)日期,具體內(nèi)容參見(jiàn)表37。表37查詢?nèi)諏?duì)賬確認(rèn)文件下載地址的返回值表參數(shù)名稱定義必填參數(shù)類型描述賬單狀態(tài)SuccStat是整型0:已生成;1:未生成失敗原因FailReason是整型0:無(wú)1:賬單未生成2:賬單不存在日賬單流水號(hào)BillsNo是字符串格式“運(yùn)營(yíng)商ID_日期(yyyyMMdd)_唯一編號(hào)”,不超過(guò)64字符文件路徑BillDownloadUrl是字符串對(duì)賬文件下載路徑,文件名稱由業(yè)務(wù)雙方進(jìn)行自定義賬務(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"}對(duì)賬文件對(duì)賬文件應(yīng)符合附件A.2日對(duì)賬文件要求
(資料性附錄)
電動(dòng)汽車充換電業(yè)務(wù)信息交換接口(Iserv)流程時(shí)序圖用戶側(cè)發(fā)起充電流程時(shí)序圖圖A.1用戶側(cè)發(fā)起充電流程時(shí)序圖客戶歸屬運(yùn)營(yíng)商與基礎(chǔ)設(shè)施運(yùn)營(yíng)商對(duì)賬時(shí)序圖圖A.2客戶歸屬運(yùn)營(yíng)商與基礎(chǔ)設(shè)施運(yùn)營(yíng)商對(duì)賬時(shí)序圖對(duì)賬文件概述由設(shè)備運(yùn)營(yíng)商平臺(tái)實(shí)現(xiàn)生成賬單文件,用戶運(yùn)營(yíng)商完成對(duì)賬動(dòng)作后,生成賬單回復(fù)文件。對(duì)賬文件傳輸方式使用http/https協(xié)議傳輸,訪問(wèn)方式為GET。文件名以文件路徑為主,不做限制。文件路徑格式不做限制,可包含http/httpsGET參數(shù)實(shí)現(xiàn)運(yùn)營(yíng)商訪問(wèn)權(quán)限控制。文件路徑訪問(wèn)次數(shù)與過(guò)期時(shí)間由文件生成運(yùn)營(yíng)商自定義。建議訪問(wèn)次數(shù):3次以內(nèi),過(guò)期時(shí)間:12小時(shí)。文件路徑失效后,可通過(guò)“query_charge_bills”,“query_charge_bills_confirm”接口,重新查詢獲得有效的文件路徑。日對(duì)賬文件參數(shù)說(shuō)明參數(shù)名稱定義必填參數(shù)類型描述賬務(wù)日期AccountDate是字符串格式“yyyy-MM-dd”當(dāng)天累計(jì)總充電訂單數(shù)SumChargeNum是整型單位:個(gè)當(dāng)天累計(jì)總充電量SumPower是浮點(diǎn)型單位:度,小數(shù)點(diǎn)后3位當(dāng)天累計(jì)總電費(fèi)SumElecMoney是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位當(dāng)天累計(jì)總服務(wù)費(fèi)SumSeviceMoney是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位當(dāng)天累計(jì)總金額SumMoney是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位互聯(lián)互通充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符設(shè)備運(yùn)營(yíng)商訂單號(hào)EquipOrderNo否字符串不超過(guò)64個(gè)字符充電設(shè)備接口編碼ConnectorID是字符串參見(jiàn)T/CEC102.2訂單累計(jì)總充電量TotalPower是浮點(diǎn)型單位:度,小數(shù)點(diǎn)后3位訂單累計(jì)總電費(fèi)TotalElecMoney是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位訂單累計(jì)總服務(wù)費(fèi)TotalSeviceMoney是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位訂單累計(jì)總金額TotalMoney是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位日對(duì)賬確認(rèn)文件參數(shù)說(shuō)明參數(shù)名稱定義必填參數(shù)類型描述賬務(wù)日期AccountDate是字符串格式“yyyy-MM-dd”當(dāng)天累計(jì)充電訂單對(duì)賬成功數(shù)SumChargeNumSuccess是整型單位:個(gè)當(dāng)天累計(jì)充電訂單對(duì)賬失敗數(shù)SumChargeNumFail是整型單位:個(gè)當(dāng)天累計(jì)對(duì)賬成功總充電量SumPowerSuccess是浮點(diǎn)型單位:度,小數(shù)點(diǎn)后3位當(dāng)天累計(jì)對(duì)賬失敗總充電量SumPowerFail是浮點(diǎn)型單位:度,小數(shù)點(diǎn)后3位當(dāng)天累計(jì)對(duì)賬成功總電費(fèi)SumElecMoneySuccess是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位當(dāng)天累計(jì)對(duì)賬失敗總電費(fèi)SumElecMoneyFail是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位當(dāng)天累計(jì)對(duì)賬成功總服務(wù)費(fèi)SumSeviceMoneySuccess是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位當(dāng)天累計(jì)對(duì)賬失敗總服務(wù)費(fèi)SumSeviceMoneyFail是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位當(dāng)天累計(jì)對(duì)賬成功總金額SumMoneySuccess是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位當(dāng)天累計(jì)對(duì)賬失敗總金額SumMoneyFail是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位互聯(lián)互通充電訂單號(hào)OrderNo是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符設(shè)備運(yùn)營(yíng)商訂單號(hào)EquipOrderNo否字符串不超過(guò)64個(gè)字符充電設(shè)備接口編碼ConnectorID是字符串參見(jiàn)T/CEC102.2對(duì)賬確認(rèn)結(jié)果ConfirmResult是整型0:成功,平賬;1:爭(zhēng)議;對(duì)賬爭(zhēng)議原因DisputeReason否整型爭(zhēng)議訂單出現(xiàn)的原因。對(duì)賬確認(rèn)結(jié)果為爭(zhēng)議時(shí),此項(xiàng)必填1:電量不一致2:電費(fèi)不一致3:服務(wù)費(fèi)不一致4:客戶運(yùn)營(yíng)商無(wú)此訂單5:設(shè)施運(yùn)營(yíng)商無(wú)此訂單6-99:其他,運(yùn)營(yíng)商可以自定義對(duì)賬確認(rèn)時(shí)間ConfirmTime是字符串格式“yyyy-MM-ddHH:mm:ss”用戶運(yùn)營(yíng)商訂單累計(jì)總充電量TotalPower是浮點(diǎn)型單位:度,小數(shù)點(diǎn)后3位用戶運(yùn)營(yíng)商訂單累計(jì)總電費(fèi)TotalElecMoney是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位用戶運(yùn)營(yíng)商訂單累計(jì)總服務(wù)費(fèi)TotalSeviceMoney是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位用戶運(yùn)營(yíng)商訂單累計(jì)總金額TotalMoney是浮點(diǎn)型單位:元,小數(shù)點(diǎn)后2位充電輔助業(yè)務(wù)流程圖A.4調(diào)用輔助業(yè)務(wù)接口圖啟動(dòng)輔助業(yè)務(wù)概述此接口用于客戶歸屬運(yùn)營(yíng)商向設(shè)備歸屬運(yùn)營(yíng)商啟動(dòng)輔助業(yè)務(wù)。接口定義:接口名稱:enable_other_assistant接口使用方法:由基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)方實(shí)現(xiàn)此接口,客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)方調(diào)用。輸入?yún)?shù)啟動(dòng)輔助業(yè)務(wù)接口的主要輸入?yún)?shù)為充電設(shè)備接口編碼、輔助業(yè)務(wù)類型,具體內(nèi)容參見(jiàn)表38。表38啟動(dòng)輔助業(yè)務(wù)的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電設(shè)備接口編碼ConnectorID是字符串參見(jiàn)T/CEC102.2輔助業(yè)務(wù)類型ServiceCode是整型1:地鎖業(yè)務(wù)50-99自定義返回值啟動(dòng)輔助業(yè)務(wù)接口的返回值為充電設(shè)備接口編碼、輔助業(yè)務(wù)類型、輔助業(yè)務(wù)訂單編號(hào)、操作結(jié)果、失敗碼、失敗信息,具體內(nèi)容參見(jiàn)表39。表39啟動(dòng)輔助業(yè)務(wù)的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電設(shè)備接口編碼ConnectorID是字符串參見(jiàn)T/CEC102.2輔助業(yè)務(wù)類型ServiceCode是整型1:地鎖業(yè)務(wù)2-99自定義輔助業(yè)務(wù)訂單編號(hào)UnLockSeq是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符操作結(jié)果SuccStat是整型0:成功;1:失敗失敗碼FailReasonCode是整型0:無(wú);1:此設(shè)施不存在(地鎖已下線或站點(diǎn)非正常使用狀態(tài)時(shí),認(rèn)為地鎖不存在)2:此設(shè)施離線3:無(wú)此設(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ù)概述此接口用于客戶歸屬運(yùn)營(yíng)商向設(shè)備歸屬運(yùn)營(yíng)商發(fā)起結(jié)束輔助業(yè)務(wù)。接口定義:接口名稱:disable_other_assistant接口使用方法:由基礎(chǔ)設(shè)施運(yùn)營(yíng)商服務(wù)平臺(tái)方實(shí)現(xiàn)此接口,客戶歸屬運(yùn)營(yíng)商服務(wù)平臺(tái)方調(diào)用。輸入?yún)?shù)停止輔助業(yè)務(wù)接口的主要輸入?yún)?shù)為充電設(shè)備接口編碼、輔助業(yè)務(wù)類型、輔助業(yè)務(wù)訂單編號(hào),具體內(nèi)容參見(jiàn)表40。表40停止輔助業(yè)務(wù)的輸入?yún)?shù)表參數(shù)名稱定義必填參數(shù)類型描述充電設(shè)備接口編碼ConnectorID是字符串參見(jiàn)T/CEC102.2輔助業(yè)務(wù)類型ServiceCode是整型1:地鎖業(yè)務(wù)50-99自定義輔助業(yè)務(wù)訂單編號(hào)UnLockSeq是字符串格式“運(yùn)營(yíng)商ID+唯一編號(hào)”,不超過(guò)64個(gè)字符返回值停止輔助業(yè)務(wù)接口的返回值為充電設(shè)備接口編碼、輔助業(yè)務(wù)類型、操作結(jié)果、失敗碼、失敗信息,具體內(nèi)容參見(jiàn)表41。表41停止輔助業(yè)務(wù)的返回值表參數(shù)名稱定義必填參數(shù)類型描述充電設(shè)備接口編碼ConnectorID是字符串參見(jiàn)T/CEC102.2輔助業(yè)務(wù)類型ServiceCode是整型1:地鎖業(yè)務(wù)50-99自定義操作結(jié)果SuccStat是整型0:成功;1:失敗失敗碼FailReasonCode是整型0:無(wú);1:此地鎖不存在(地鎖已下線或站點(diǎn)非正常使用狀態(tài)時(shí),認(rèn)為地鎖不存在)2:此地鎖離線3:無(wú)此地鎖使用權(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)說(shuō)明啟動(dòng)中訂單狀態(tài)為“啟動(dòng)中”,表明充電運(yùn)營(yíng)商已經(jīng)正確收到了啟動(dòng)請(qǐng)求,并已將指令下發(fā)到了設(shè)備,正在等待充電設(shè)備和車輛進(jìn)行交互,但此時(shí)并不表示本次充電已經(jīng)成功開(kāi)啟。充電中訂單狀態(tài)為“充電中”,表明該設(shè)備正在為該訂單充電。停止中訂單狀態(tài)為“停止中”,表明充電運(yùn)營(yíng)商已經(jīng)收到了停止請(qǐng)求,并已下發(fā)到了設(shè)備,正在等待設(shè)備停止充電,但此時(shí)并不表示本次充電已成功停止。訂單完成訂單狀態(tài)為“訂單完成”,表明本次充電已全部完成,是一種終態(tài)。訂單掛起訂單狀態(tài)為“訂單掛起”,表明充電運(yùn)營(yíng)商不能明確判斷本次充電的當(dāng)前狀態(tài)。充電異常結(jié)束訂單狀態(tài)為“充電異常結(jié)束”,表明該訂單已結(jié)束,但處于異常狀態(tài)。需要在后續(xù)的運(yùn)維、對(duì)賬環(huán)節(jié)進(jìn)行處理。是一種終態(tài)。啟動(dòng)失敗訂單狀態(tài)為“啟動(dòng)失敗”,表明充電運(yùn)營(yíng)商確認(rèn)充電啟動(dòng)失敗,該訂單未產(chǎn)生充電行為。是一種終態(tài)。
訂單狀態(tài)流轉(zhuǎn)充電運(yùn)營(yíng)商狀態(tài)流轉(zhuǎn)圖客戶運(yùn)營(yíng)商狀態(tài)流轉(zhuǎn)圖啟動(dòng)中充電運(yùn)營(yíng)商狀態(tài)流轉(zhuǎn)判斷出訂單啟動(dòng)成功,設(shè)備正在為該訂單提供充電服務(wù)時(shí),將訂單狀態(tài)流轉(zhuǎn)到“充電中”。收到或觸發(fā)了停止指令并成功執(zhí)行,將訂單狀態(tài)流轉(zhuǎn)到“停止中”。收到設(shè)備上報(bào)的充電記錄,將訂單狀態(tài)流轉(zhuǎn)到“充電完成”。超時(shí)X秒(X秒小于等于啟動(dòng)接口返回的超時(shí)時(shí)間)或判斷出設(shè)備進(jìn)入到離線等不確定狀態(tài),將訂單狀態(tài)流轉(zhuǎn)到“訂單掛起”。確認(rèn)本次充電啟動(dòng)失敗,將訂單狀態(tài)流轉(zhuǎn)到“啟動(dòng)失敗”??蛻暨\(yùn)營(yíng)商狀態(tài)流轉(zhuǎn)收到充電運(yùn)營(yíng)商的啟動(dòng)充電結(jié)果的狀態(tài)為“充電中”,或查詢到訂單狀態(tài)為“充電中”時(shí),將訂單狀態(tài)流轉(zhuǎn)到“充電中”。由于客戶點(diǎn)擊停止或觸發(fā)停止規(guī)則等情況,向充電運(yùn)營(yíng)商發(fā)起了停止指令,并且返回成功,將訂單狀態(tài)流轉(zhuǎn)到“停止中”。收到充電運(yùn)營(yíng)商推送的訂單信息,或查到過(guò)程信息的訂單狀態(tài)為“充電完成”,將訂單狀態(tài)流轉(zhuǎn)到“充電完成”。收到充電運(yùn)營(yíng)商的啟動(dòng)充電結(jié)果推送狀態(tài)為“訂單掛起”,或查詢到訂單狀態(tài)為“訂單掛起”時(shí),將訂單狀態(tài)流轉(zhuǎn)到“訂單掛起”。超時(shí)A秒(A為充電運(yùn)營(yíng)商
溫馨提示
- 1. 本站所有資源如無(wú)特殊說(shuō)明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請(qǐng)下載最新的WinRAR軟件解壓。
- 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請(qǐng)聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
- 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁(yè)內(nèi)容里面會(huì)有圖紙預(yù)覽,若沒(méi)有圖紙預(yù)覽就沒(méi)有圖紙。
- 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
- 5. 人人文庫(kù)網(wǎng)僅提供信息存儲(chǔ)空間,僅對(duì)用戶上傳內(nèi)容的表現(xiàn)方式做保護(hù)處理,對(duì)用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對(duì)任何下載內(nèi)容負(fù)責(zé)。
- 6. 下載文件中如有侵權(quán)或不適當(dāng)內(nèi)容,請(qǐng)與我們聯(lián)系,我們立即糾正。
- 7. 本站不保證下載資源的準(zhǔn)確性、安全性和完整性, 同時(shí)也不承擔(dān)用戶因使用這些下載資源對(duì)自己和他人造成任何形式的傷害或損失。
最新文檔
- 二零二五版工業(yè)地皮購(gòu)置與交易全程稅務(wù)籌劃合同3篇
- 二零二五年教育培訓(xùn)機(jī)構(gòu)兼職教師雇傭協(xié)議書(shū)3篇
- 蘇州工業(yè)園區(qū)服務(wù)外包職業(yè)學(xué)院《電液控制工程》2023-2024學(xué)年第一學(xué)期期末試卷
- 二零二五版生態(tài)環(huán)保型建筑材料銷售合同3篇
- 二零二五年度定制化餐盒包裝解決方案合同3篇
- 2025年度高新技術(shù)企業(yè)研發(fā)項(xiàng)目財(cái)務(wù)擔(dān)保合同會(huì)計(jì)處理細(xì)則3篇
- 2024版茶樓活動(dòng)策劃合同2篇
- 二零二五年服裝店導(dǎo)購(gòu)員培訓(xùn)與激勵(lì)合同范本3篇
- 山西鐵道職業(yè)技術(shù)學(xué)院《矯正社會(huì)工作》2023-2024學(xué)年第一學(xué)期期末試卷
- 廈門(mén)海洋職業(yè)技術(shù)學(xué)院《創(chuàng)意表現(xiàn)圖案》2023-2024學(xué)年第一學(xué)期期末試卷
- 公路工程施工現(xiàn)場(chǎng)安全檢查手冊(cè)
- 公司組織架構(gòu)圖(可編輯模版)
- 1汽輪機(jī)跳閘事故演練
- 陜西省銅川市各縣區(qū)鄉(xiāng)鎮(zhèn)行政村村莊村名居民村民委員會(huì)明細(xì)
- 禮品(禮金)上交登記臺(tái)賬
- 北師大版七年級(jí)數(shù)學(xué)上冊(cè)教案(全冊(cè)完整版)教學(xué)設(shè)計(jì)含教學(xué)反思
- 2023高中物理步步高大一輪 第五章 第1講 萬(wàn)有引力定律及應(yīng)用
- 青少年軟件編程(Scratch)練習(xí)題及答案
- 浙江省公務(wù)員考試面試真題答案及解析精選
- 系統(tǒng)性紅斑狼瘡-第九版內(nèi)科學(xué)
- 全統(tǒng)定額工程量計(jì)算規(guī)則1994
評(píng)論
0/150
提交評(píng)論