2024電動汽車車網(wǎng)互動平臺與負(fù)荷聚合商平臺信息接口技術(shù)規(guī)范

目錄TOC\o"1-2"\h\u2557前??言 3538電動汽車車網(wǎng)互動平臺與負(fù)荷聚合商平臺信息接口技術(shù)規(guī)范 1247601范圍 1310912規(guī)范性引用文件 1136173術(shù)語和定義 1176854通用要求 133904.1控制要求 1188704.2通信接口 282294.3安全防護(hù) 2228515信息交換流程 263615.1平臺架構(gòu) 2309005.2資產(chǎn)同步 379325.3市場參與 4137026消息體規(guī)范 712666.1請求消息 740986.2權(quán)限認(rèn)證 8111477接口技術(shù)要求 9268067.1公共信息 9286907.2業(yè)務(wù)信息 19電動汽車車網(wǎng)互動平臺與負(fù)荷聚合商平臺信息接口技術(shù)規(guī)范范圍本文件規(guī)定了電動汽車車網(wǎng)互動平臺與負(fù)荷聚合商平臺的通用要求、信息交換流程、消息體規(guī)范及接口技術(shù)要求。本文件適用于電動汽車車網(wǎng)互動平臺與負(fù)荷聚合商平臺信息接口之間的數(shù)據(jù)交互。規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T18487.1電動汽車傳導(dǎo)充電系統(tǒng)第1部分：通用要求GB/T27930電動汽車非車載傳導(dǎo)式充電機(jī)與電池管理系統(tǒng)之間的通信協(xié)議NB/T33028電動汽車充放電設(shè)施術(shù)語NB/T11305.1電動汽車充放電雙向互動第1部分總則術(shù)語和定義GB/T18487.1、GB/T27930、NB/T11305.1和NB/T33028界定的以及下列術(shù)語和定義適用于本文件。車網(wǎng)互動平臺Carnetworkinteractiveplatform對規(guī)?；妱悠囐Y源或負(fù)荷聚合商資源進(jìn)行有效聚合的電動汽車管理平臺，實(shí)現(xiàn)對電動汽車和電網(wǎng)之間的能量交互過程的統(tǒng)一調(diào)度管理。負(fù)荷聚合商平臺aggregatoroperatingplatform用于滿足可調(diào)度充放電資源參與電網(wǎng)調(diào)節(jié)運(yùn)行和市場運(yùn)營業(yè)務(wù)需求，由負(fù)荷聚合商在本地或云端部署的自動化信息系統(tǒng)。負(fù)荷聚合平臺具備對各類用電側(cè)充放電資源實(shí)時信息接入、實(shí)時監(jiān)視、自動功率控制、市場交易申報、協(xié)同指令下達(dá)、操作控制、統(tǒng)計(jì)查詢、計(jì)量計(jì)費(fèi)等功能。通用要求控制要求負(fù)荷聚合商平臺在接收到車網(wǎng)互動平臺的控制數(shù)據(jù)后，應(yīng)根據(jù)控制數(shù)據(jù)調(diào)度所管轄的充放電設(shè)施，完成對控制指令的影響。車網(wǎng)互動平臺支持多種新型用戶側(cè)分布式資源的源、荷高效互動服務(wù)和監(jiān)控系統(tǒng)模塊，實(shí)現(xiàn)多種電動汽車充電裝置、電動汽車V2G設(shè)備的實(shí)時監(jiān)控、靈活接入和智能控制。通信接口負(fù)荷聚合商平臺與車網(wǎng)互動平臺之間的信息接口應(yīng)滿足雙方功能需求，信息接口應(yīng)支持TCP/IP協(xié)議族，并可根據(jù)實(shí)際需求選擇適合的通信協(xié)議。通信協(xié)議應(yīng)確保數(shù)據(jù)的可靠傳輸和安全性。負(fù)荷聚合商平臺與車網(wǎng)互動平臺的信息接口應(yīng)使用標(biāo)準(zhǔn)的數(shù)據(jù)格式進(jìn)行數(shù)據(jù)傳輸，包括但不限于JSON、XML等。數(shù)據(jù)格式應(yīng)滿足雙方系統(tǒng)對數(shù)據(jù)解析和處理的要求。安全防護(hù)信息接口應(yīng)采取適當(dāng)?shù)陌踩胧?，包括?shù)據(jù)加密、身份驗(yàn)證、訪問控制等，以確保數(shù)據(jù)的安全性、保密性、完整性和可用性。針對隱私性較高的數(shù)據(jù)，接口宜采用脫敏加密，實(shí)現(xiàn)對隱私信息的保護(hù)。負(fù)荷聚合商平臺與電動汽車車網(wǎng)互動平臺通信與自動化系統(tǒng)應(yīng)符合電力二次系統(tǒng)安全防護(hù)要求及相關(guān)設(shè)計(jì)規(guī)程。負(fù)荷聚合商平臺與電動汽車車網(wǎng)互動平臺應(yīng)具有足夠的實(shí)時性和穩(wěn)定性，以支持車輛數(shù)據(jù)的實(shí)時監(jiān)控、狀態(tài)更新以及指令的下發(fā)。車網(wǎng)互動服務(wù)信息交換應(yīng)根據(jù)國家信息安全等級保護(hù)相關(guān)要求，針對各個應(yīng)用系統(tǒng)構(gòu)建相應(yīng)的安全保護(hù)等級。應(yīng)根據(jù)車網(wǎng)互動系統(tǒng)的應(yīng)用、數(shù)據(jù)、技術(shù)架構(gòu)，將相同的保護(hù)等級的信息系統(tǒng)適當(dāng)集中，劃分為不同的安全信息域，有區(qū)別地進(jìn)行系統(tǒng)安全保護(hù)。信息交換流程平臺架構(gòu)車網(wǎng)互動系統(tǒng)架構(gòu)主要包含電網(wǎng)調(diào)度交易層、車網(wǎng)互動平臺層和負(fù)荷聚合商層三部分，本文件規(guī)定了車網(wǎng)互動平臺與負(fù)荷聚合商平臺之間的接口交互規(guī)范，車網(wǎng)互動平臺與負(fù)荷聚合商平臺互連架構(gòu)如圖1所示。圖1車網(wǎng)互動平臺與負(fù)荷聚合商平臺信息接口示意圖參與電網(wǎng)互動的充放電設(shè)施運(yùn)營商應(yīng)通過負(fù)荷聚合商平臺完成和車網(wǎng)互動平臺的交互，上報所運(yùn)營的充放電設(shè)施資源數(shù)據(jù)、運(yùn)行數(shù)據(jù)、充放電計(jì)劃數(shù)據(jù)，并能夠通過負(fù)荷聚合商平臺接受車網(wǎng)互動平臺的調(diào)度管理。負(fù)荷聚合商平臺將車網(wǎng)互動平臺的控制計(jì)劃曲線留存，并根據(jù)各代理主體資源的實(shí)時運(yùn)行狀態(tài)，將控制量在各代理用戶之間進(jìn)行分解，并下發(fā)給用戶執(zhí)行。充放電設(shè)施運(yùn)營商在接收到負(fù)荷聚合商平臺的控制數(shù)據(jù)后，應(yīng)根據(jù)控制數(shù)據(jù)調(diào)度所運(yùn)營的充放電設(shè)施，完成對控制指令的響應(yīng)。車網(wǎng)互動平臺和負(fù)荷聚合商平臺之間的信息交互流程主要包括資產(chǎn)同步和市場參與兩大部分。資產(chǎn)同步資產(chǎn)同步流程如圖2所示，共支持2個業(yè)務(wù)流程，分別是：上報設(shè)備檔案信息、召喚設(shè)備檔案信息，負(fù)荷聚合商基礎(chǔ)信息的備案在線上進(jìn)行，負(fù)荷聚合商提交運(yùn)營商檔案信息，監(jiān)管平臺審核確認(rèn)后提交到平臺。上報設(shè)備檔案參數(shù)車網(wǎng)互動平臺每日定時拉取最新充放電設(shè)施信息。此接口用于新建充電場站接入、退運(yùn)、充放電設(shè)施遷移改造等業(yè)務(wù)場景，聚合商需要線上提交資產(chǎn)變更申請，經(jīng)省、市兩級平臺管理部門同意后，在車網(wǎng)互動平臺上進(jìn)行比對操作后確認(rèn)入庫。負(fù)荷聚合商也可以向車網(wǎng)互動平臺推送更新的充換電設(shè)施信息，此接口用于站點(diǎn)信息的變更。召喚設(shè)備檔案參數(shù)車網(wǎng)互動平臺通過調(diào)用負(fù)荷聚合商平臺的“召喚設(shè)備檔案”的接口，用于主動召喚檔案的基礎(chǔ)信息。圖2資產(chǎn)同步流程圖市場參與市場參與主要包括計(jì)劃申報、調(diào)控指令、清分結(jié)算三個流程，流程如圖3所示。圖3市場參與流程圖計(jì)劃申報車網(wǎng)互動平臺按需在日前向負(fù)荷聚合商平臺下發(fā)需求日需求數(shù)據(jù)。參與車網(wǎng)互動平臺調(diào)度的負(fù)荷聚合商平臺，應(yīng)根據(jù)調(diào)度需要上報未來一段時間的可調(diào)節(jié)計(jì)劃（例如日前上報次日的數(shù)據(jù)、實(shí)時上報未來一小時的數(shù)據(jù)等）。負(fù)荷聚合商平臺的可調(diào)節(jié)計(jì)劃應(yīng)該來自于所運(yùn)營站樁可調(diào)節(jié)能力的總加。圖4計(jì)劃申報流程圖調(diào)控指令車網(wǎng)互動平臺下發(fā)出清結(jié)果和實(shí)時調(diào)控指令流程如圖5所示，首先根據(jù)電網(wǎng)調(diào)控系統(tǒng)的需求以及負(fù)荷聚合商平臺申報的計(jì)劃值，車網(wǎng)互動平臺下發(fā)出清結(jié)果到各負(fù)荷聚合平臺，各負(fù)荷聚合平臺接受到指令后對指令進(jìn)行響應(yīng)上送給車網(wǎng)互動平臺。在指令執(zhí)行過程中，負(fù)荷聚合商平臺需要每分鐘上送運(yùn)行數(shù)據(jù)給車網(wǎng)互動平臺，車網(wǎng)互動平臺接收數(shù)據(jù)后將其保存作為后續(xù)考核結(jié)算的依據(jù)。圖5調(diào)控指令下發(fā)流程圖清分結(jié)算車網(wǎng)互動平臺下發(fā)出清結(jié)算數(shù)據(jù)流程如圖6所示。首先各負(fù)荷聚合商平臺需每日申報負(fù)荷調(diào)節(jié)能力，根據(jù)電網(wǎng)調(diào)度系統(tǒng)的需求以及輔助服務(wù)市場的參與條件車網(wǎng)互動平臺會下發(fā)負(fù)荷調(diào)節(jié)指令到各個負(fù)荷聚合商平臺，根據(jù)負(fù)荷聚合商平臺每分鐘上送運(yùn)行數(shù)據(jù)，車網(wǎng)互動平臺接收數(shù)據(jù)后將其保存作為出清結(jié)算的依據(jù)。同時使用遠(yuǎn)程計(jì)量設(shè)備進(jìn)行數(shù)據(jù)校驗(yàn)，滿足調(diào)控能力的負(fù)荷聚合商平臺，車網(wǎng)互動平臺會依據(jù)其調(diào)控參與情況進(jìn)行最終結(jié)算。圖6清分結(jié)算流程圖消息體規(guī)范請求消息所有請求消息主體由3部分參數(shù)組成，分別為：參數(shù)內(nèi)容（date），時間戳（timestamp），數(shù)字簽名（sign）組成。data：各業(yè)務(wù)接口具體參數(shù)信息。timestamp：接口請求時的時間戳，格式為：yyyyMMddHHmmss.sign：參數(shù)HMAC-MD5簽名data（業(yè)務(wù)參數(shù)信息）部分使用AES128位加解密，加密模式采用CBC，填充模式采PKCS5Padding方式。該加密需要使用：消息秘鑰（dataSecret），消息秘鑰初始化向量（dataSecretIV，固定16位），秘鑰由提供服務(wù)方預(yù)定義分配給調(diào)用方使用，調(diào)用方使用該秘鑰加密傳輸，服務(wù)方使用該秘鑰進(jìn)行數(shù)據(jù)解密。sign（簽名）：為防止數(shù)據(jù)被篡改，data（業(yè)務(wù)參數(shù)信息）數(shù)據(jù)加密后，需要跟其他參數(shù)排列組裝后，進(jìn)行md5加密，簽名串默認(rèn)大寫。sign生成規(guī)則為：請求接口:HMAC-MD5(data(AES加密后的串)+timestamp+signSecret)。signSecret：簽名秘鑰，固定為64位字符串，秘鑰由提供服務(wù)方預(yù)定義分配給調(diào)用方使用，調(diào)用方使用該秘鑰加密傳輸，服務(wù)方接受到數(shù)據(jù)時，要求先校驗(yàn)簽名是否正確接口返回參數(shù)由：返回碼（code）,返回信息（msg），參數(shù)內(nèi)容（data），數(shù)字簽名（sign）組成。code：返回碼。-1：系統(tǒng)繁忙，請求方稍后再試。201：請求成功。101：簽名錯誤。102：參數(shù)不合法，缺少必要參數(shù)。103：業(yè)務(wù)參數(shù)不合法，具體參數(shù)各自業(yè)務(wù)接口定義。501：系統(tǒng)錯誤，未知異常。msg：返回信息描述，如成功則返回成功，如失敗則返回對應(yīng)失敗描述。data：各業(yè)務(wù)接口具體返回參數(shù)信息，如無需返回可為空。sign：參數(shù)HMAC-MD5簽名。sign生成規(guī)則為：接口返回：HMAC-MD5（data（AES加密后的串）+code+signSecret）。權(quán)限認(rèn)證接口說明交互雙方互為對方分配服務(wù)商ID和數(shù)據(jù)加密密鑰信息。密鑰信息四個，聚合商密鑰（OperatorSecret）、消息密鑰（DataSecret）、消息密鑰初始化向量（DataSectetIV）、簽名密鑰（SigSecret）。在進(jìn)行數(shù)據(jù)傳遞前，向?qū)Ψ较到y(tǒng)獲取token,在具體業(yè)務(wù)請求header中攜帶（BearerToken:token）。Token有效期為2小時，過期則失效；失效時再次訪問時，需再次獲取token信息。接口名稱：query_token輸入?yún)?shù)如表1所示，輸出參數(shù)如表2所示表1輸入?yún)?shù)參數(shù)名稱類型中文名稱描述OperatorIDstring聚合商ID接口調(diào)用方的聚合商ID，以組織機(jī)構(gòu)代碼作為聚合商ID,組織構(gòu)代碼為統(tǒng)一社會信用碼的9-17位，例如統(tǒng)一社會信用碼為91110190400007201Z，組織機(jī)構(gòu)代碼為：400007201OperatorSecretstring聚合商密鑰響應(yīng)?的OperatorSecret表2輸出參數(shù)參數(shù)名稱類型中文名稱描述DataOperatorIDstring接口調(diào)用方的聚合商ID，以組織機(jī)構(gòu)代碼作為聚合商ID,組織機(jī)構(gòu)代碼為統(tǒng)一社會信用碼的9-17位，例如統(tǒng)一社會信用碼為91110190400007201Z，組織機(jī)構(gòu)代碼為：400007201SuccStatint成功狀態(tài)：0：成功1：失敗AccessTokenstring憑證信息tokenTokenAvailableTimeint憑證有效期，單位為秒FailReasonstring失敗原因：0：?1：?此聚合商2：密鑰錯誤3~99：?定義接口技術(shù)要求所有數(shù)據(jù)傳輸均采?HTTPS接口，全部數(shù)據(jù)采?UTF-8編碼方式。建議使?如下格式：https://[域名]/evcs/v[版本號]/接口名稱。所有接口均使?https的post?式提交參數(shù)，request和response均使?json格式傳輸數(shù)據(jù)。網(wǎng)絡(luò)延時不超過200ms，丟包率不高于0.5%。雙方相互開通防火墻白名單，保障接口訪問安全性。公共信息上報設(shè)備檔案參數(shù)接口說明：用于上報可調(diào)資源的檔案基礎(chǔ)信息，接入后上報一次，僅當(dāng)設(shè)備檔案信息發(fā)生變化時需再次進(jìn)行上報。聚合商、充電站和充電樁檔案分別請求接口上報，其中充電樁檔案數(shù)據(jù)可根據(jù)省份要求選擇是否上報。請求類型及地址：POST${MYURL}/reported/archives。負(fù)荷聚合商信息參數(shù)如表3所示，充電站信息參數(shù)如表4所示，充電樁信息參數(shù)如表5所示。表3聚合商信息字段參數(shù)類型是否必填參數(shù)說明備注systemTimeString必填系統(tǒng)時間戳，格式(yyyy-MM-ddHH:mm:ss)，用于對時creditCodeString必填聚合商唯一標(biāo)識（統(tǒng)一社會信用代碼，共18位），不縮略，全字段上傳eventTypeString必填事件類型，填：“resourceInfo”userNameString必填聚合商中文名稱annualElectricityConsumptionString必填年度用電量，單位：萬度electricityConsumptionCharString必填用電性質(zhì)（一般工商業(yè)、大工業(yè)、農(nóng)業(yè)、居民）operatorString必填聯(lián)系人姓名operatorTel1String必填聚合商聯(lián)系電話operatorAddressString選填聚合商注冊地址operatorRemarkString選填備注表4充電站信息參數(shù)字段參數(shù)類型是否必填參數(shù)說明備注OperatorIDstring是運(yùn)營商ID例如：400007201stationIDString是運(yùn)營系統(tǒng)內(nèi)部站ID運(yùn)營商自定義的唯一編碼，統(tǒng)一使用OperatorID+“-”+StationID，例如：400007201-12345stationNameString是充電站名稱provinceIdInteger是省份區(qū)域代碼填寫內(nèi)容參照GB/T2260cityIdInteger是城市區(qū)域代碼areaIdInteger是地區(qū)區(qū)域代碼longitudeDouble是充電站所在位置的經(jīng)度執(zhí)行GCJ-02坐標(biāo)系latitudeDouble是充電站所在位置的緯度stationCapacityDouble是全站容量(KW)保留3位小數(shù)pileNumberInteger是全站樁數(shù)量stationTypeInteger是站類型0：城市公共；1：單位內(nèi)部；2：公交（專用）；3：環(huán)衛(wèi)（專用）；4：出租車（專用）；5：高速；6：換電站；7：其他；8：物流（專用）；9：岸電；10：私人樁；11：社區(qū)公共。controllableBoolean是是否可控0：不可控；1：可控。站點(diǎn)下設(shè)備是否可以調(diào)節(jié)功率，原則上只要有一臺設(shè)備可調(diào)節(jié)即可控locationString是站點(diǎn)詳細(xì)地址UserIdString是營銷戶號該樁用電時，營銷系統(tǒng)分配的營銷戶號，即交電費(fèi)時的戶號，若有多個，則以英文“,”間隔；若為轉(zhuǎn)供電，則提供最近一級的營銷戶號。archivesTypeInteger是檔案類型：4：充電樁；6：充電站。electricMeterNostring否上級電源表號營銷戶號對應(yīng)電表的表地址碼，若有多個，則以英文“,”間隔。StationStatusint是站點(diǎn)狀態(tài)：0：未知；1：建設(shè)中；3：正常使用；4：維護(hù)中；5：關(guān)閉下線。ParkNumsint是車位數(shù)量，可停放進(jìn)行充電的車位總數(shù)。表5充電樁信息參數(shù)（可選）字段參數(shù)類型是否必填參數(shù)說明備注EquipmentIDString是設(shè)備編碼設(shè)備唯一編碼，統(tǒng)一使用OperatorID+“-”+EquipmentID，例如：400007201-12345pileIdString是運(yùn)營系統(tǒng)內(nèi)部設(shè)備IDpileNameString是充電樁名稱pileCapacityDouble是樁容量(KW)保留3位小數(shù)pileTypeInteger是樁類型：0：未知；1：直流；2：交流；3：交直流一體；4：無線；5：其他。pileManufacturerString否樁廠家investorString否投資方provinceIdInteger是省份區(qū)域編碼填寫內(nèi)容參照GB/T2260cityIdInteger是城市區(qū)域編碼areaIdInteger是地區(qū)區(qū)域編碼longitudeDouble是充電樁所在位置的經(jīng)度執(zhí)行GCJ-02坐標(biāo)系latitudeDouble是充電樁所在位置的緯度controllableBoolean是是否可控：0：不可控；1：可控設(shè)備是否可以調(diào)節(jié)功率stationTypeInteger是樁類型0：城市公共；1：單位內(nèi)部；2：公交（專用）；3：環(huán)衛(wèi)（專用）；4：出租車（專用）；5：高速；7：其他；8：物流（專用）；9：岸電；10：私人樁；11：社區(qū)公共。stationIdString是運(yùn)營系統(tǒng)內(nèi)部站IDUserIdString是營銷戶號該樁用電時，營銷系統(tǒng)分配的營銷戶號archivesTypeInteger是檔案類型：4：充電樁；6：充電站。electricMeterNostring否上級電源表號營銷戶號對應(yīng)電表的表地址碼，若有多個，則以英文“,”間隔StationStatusint是充電樁狀態(tài)：0：未知；1：建設(shè)中；3：正常使用；4：維護(hù)中；5：關(guān)閉下線。表6聚合商請求參數(shù)示例：類型描述json{ "sing":"HMAC-MD5簽名", "timestamp":"yyyyMMddHHmmss", "data":{ "parms"：[{creditCode:“分配給聚合商的唯一標(biāo)識”;eventType:“事件類型”;username:“聚合商商中文名稱”annualElectricityConsumption:“年度用電量”electricityConsumptionChar:“用電性質(zhì)” }] }}表7充電站請求參數(shù)示例：類型描述json{ "sing":"HMAC-MD5簽名", "timestamp":"YYYY-MM-DDhh-mm-ss", "data":{ "parms"：[{ "remoteId":"分配給運(yùn)營商的唯一標(biāo)識","archivesType":"6","stationId":"1", "stationName":"1號充電站", "stationCapacity":1000.660, "pileNumber":"99", "stationType":"0", }] }}表8充電樁請求參數(shù)示例：類型描述json{ "sing":"HMAC-MD5簽名", "timestamp":"YYYY-MM-DDhh-mm-ss", "data":{ "parms"：[{ "remoteId":"分配給運(yùn)營商的唯一標(biāo)識","archivesType":"4", "pileId":"運(yùn)營系統(tǒng)內(nèi)部設(shè)備ID", "pileName":"樁名稱", "pileCapacity":7.000, "pileType":2, }] }}表9響應(yīng)參數(shù)：類型描述json{"code"：201,"msg":“success”,"sign"：“HMAC-MD5簽名”}code結(jié)果編碼-1：系統(tǒng)繁忙，請求方稍后再試201：成功101：簽名錯誤102：參數(shù)不合法，缺少必要參數(shù)501：系統(tǒng)錯誤，未知異常msg結(jié)果說明召喚設(shè)備檔案參數(shù)接口說明：用于主動召喚檔案的基礎(chǔ)信息。請求類型及地址：POST${YOURURL}/query/archives表10聚合商信息字段參數(shù)類型是否必填參數(shù)說明備注systemTimeString必填系統(tǒng)時間戳，格式(yyyy-MM-ddHH:mm:ss)，用于對時creditCodeString必填聚合商唯一標(biāo)識（統(tǒng)一社會信用代碼，共18位），不縮略，全字段上傳eventTypeString必填事件類型，填：“resourceInfo”userNameString必填聚合商中文名稱annualElectricityConsumptionString必填年度用電量，單位：萬度electricityConsumptionCharString必填用電性質(zhì)（一般工商業(yè)、大工業(yè)、農(nóng)業(yè)、居民）operatorString必填聯(lián)系人姓名operatorTel1String必填聚合商聯(lián)系電話1operatorAddressString選填聚合商注冊地址operatorRemarkString選填備注表11充電站信息參數(shù)字段參數(shù)類型是否必填參數(shù)說明備注OperatorIDstring是運(yùn)營商ID例如：400007201stationIDString是運(yùn)營系統(tǒng)內(nèi)部站ID運(yùn)營商自定義的唯一編碼，統(tǒng)一使用OperatorID+“-”+StationID，例如：400007201-12345stationNameString是充電站名稱provinceIdInteger是省份區(qū)域代碼填寫內(nèi)容參照GB/T2260cityIdInteger是城市區(qū)域代碼areaIdInteger是地區(qū)區(qū)域代碼longitudeDouble是充電站所在位置的經(jīng)度執(zhí)行GCJ-02坐標(biāo)系latitudeDouble是充電站所在位置的緯度stationCapacityDouble是全站容量(KW)保留3位小數(shù)pileNumberInteger是全站樁數(shù)量stationTypeInteger是站類型0：城市公共；1：單位內(nèi)部；2：公交（專用）；3：環(huán)衛(wèi)（專用）；4：出租車（專用）；5：高速；6：換電站；7：其他；8：物流（專用）；9：岸電；10：私人樁；11：社區(qū)公共。controllableBoolean是是否可控0：不可控；1：可控。站點(diǎn)下設(shè)備是否可以調(diào)節(jié)功率，原則上只要有一臺設(shè)備可調(diào)節(jié)即可控locationString是站點(diǎn)詳細(xì)地址UserIdString是營銷戶號該樁用電時，營銷系統(tǒng)分配的營銷戶號，即交電費(fèi)時的戶號，若有多個，則以英文“,”間隔；若為轉(zhuǎn)供電，則提供最近一級的營銷戶號。archivesTypeInteger是檔案類型：4：充電樁；6：充電站。electricMeterNostring否上級電源表號營銷戶號對應(yīng)電表的表地址碼，若有多個，則以英文“,”間隔。StationStatusint是站點(diǎn)狀態(tài)：0：未知；1：建設(shè)中；3：正常使用；4：維護(hù)中；5：關(guān)閉下線。ParkNumsint是車位數(shù)量，可停放進(jìn)行充電的車位總數(shù)。表12充電樁信息參數(shù)：字段參數(shù)類型是否必填參數(shù)說明備注EquipmentIDString是設(shè)備編碼設(shè)備唯一編碼，統(tǒng)一使用OperatorID+“-”+EquipmentID，例如：400007201-12345pileIdString是運(yùn)營系統(tǒng)內(nèi)部設(shè)備IDpileNameString是充電樁名稱pileCapacityDouble是樁容量(kW)保留3位小數(shù)pileTypeInteger是樁類型：0：未知；1：直流；2：交流；3：交直流一體；4：無線；5：其他。pileManufacturerString否樁廠家investorString否投資方provinceIdInteger是省份區(qū)域編碼填寫內(nèi)容參照GB/T2260cityIdInteger是城市區(qū)域編碼areaIdInteger是地區(qū)區(qū)域編碼longitudeDouble是充電樁所在位置的經(jīng)度執(zhí)行GCJ-02坐標(biāo)系latitudeDouble是充電樁所在位置的緯度controllableBoolean是是否可控：0：不可控；1：可控設(shè)備是否可以調(diào)節(jié)功率stationTypeInteger是樁類型0：城市公共；1：單位內(nèi)部；2：公交（專用）；3：環(huán)衛(wèi)（專用）；4：出租車（專用）；5：高速；7：其他；8：物流（專用）；9：岸電；10：私人樁；11：社區(qū)公共。stationIdString是運(yùn)營系統(tǒng)內(nèi)部站IDUserIdString是營銷戶號該樁用電時，營銷系統(tǒng)分配的營銷戶號archivesTypeInteger是檔案類型：4：充電樁；6：充電站。electricMeterNostring否上級電源表號營銷戶號對應(yīng)電表的表地址碼，若有多個，則以英文“,”間隔StationStatusint是充電樁狀態(tài)：0：未知；1：建設(shè)中；3：正常使用；4：維護(hù)中；5：關(guān)閉下線。表13聚合商請求參數(shù)示例：類型描述json{ "sing":"HMAC-MD5簽名", "timestamp":"yyyyMMddHHmmss", "data":{ "parms"：[{creditCode:“分配給聚合商的唯一標(biāo)識”;eventType:“事件類型”;username:“運(yùn)營商商中文名稱”annualElectricityConsumption:“年度用電量”electricityConsumptionChar:“用電性質(zhì)” }] }}表14請求參數(shù)示例數(shù)據(jù)類型描述json{"sign"：“HMAC-MD5簽名”,"timestamp":"YYYY-MM-DDhh-mm-ss","data"：{"archivesType"：4（充電樁），6（充電站）}}表15充電站響應(yīng)參數(shù)示例：類型描述json{ "sing":"HMAC-MD5簽名", "timestamp":"YYYY-MM-DDhh-mm-ss", "data":{ "parms"：[{ "remoteId":"分配給運(yùn)營商的唯一標(biāo)識","archivesType":"6","stationId":"1", "stationName":"1號充電站", "stationCapacity":1000.660, "pileNumber":"99", "stationType":"0", }] }}表16充電樁參數(shù)響應(yīng)示例：類型描述json{ "sing":"HMAC-MD5簽名", "timestamp":"YYYY-MM-DDhh-mm-ss", "data":{ "parms"：[{ "remoteId":"分配給運(yùn)營商的唯一標(biāo)識","archivesType":"4", "pileId":"樁編碼", "pileName":"裝名稱", "pileCapacity":7, "pileType":2, }] }}充電站可調(diào)特性信息上報接口說明：電動汽車負(fù)荷聚合商平臺根據(jù)充電站實(shí)時運(yùn)行數(shù)據(jù)信息，上送場站可調(diào)特性數(shù)據(jù)到車網(wǎng)互動平臺，根據(jù)調(diào)度需要上報未來一段時間所聚合可調(diào)節(jié)電動汽車負(fù)荷，信息項(xiàng)見表17。表17充電站可調(diào)特性數(shù)據(jù)信息項(xiàng)字段參數(shù)類型是否必填描述stationId字符串是充電站ID，聚合商充電站唯一標(biāo)識responseLevel整型是響應(yīng)級別，可調(diào)節(jié)資源聚合體當(dāng)前參與調(diào)控的響應(yīng)級別：1：響應(yīng)一級2：響應(yīng)二級3：響應(yīng)三級4：響應(yīng)四級5：響應(yīng)五級6：響應(yīng)六級7：響應(yīng)七級responseDuration整型響應(yīng)持續(xù)時間，可調(diào)節(jié)資源聚合體達(dá)到調(diào)控目標(biāo)后的可持續(xù)響應(yīng)時長：單位：minavailableCurrentPower浮點(diǎn)型是可參與調(diào)節(jié)功率，單位：kW，精確到小數(shù)點(diǎn)后一位availableUpperPower浮點(diǎn)型是可參與上調(diào)空間，單位：kW，精確到小數(shù)點(diǎn)后一位availableDownPower浮點(diǎn)型是可參與下調(diào)空間，單位：kW，精確到小數(shù)點(diǎn)后一位dateTime字符串是數(shù)據(jù)更新時間，格式Y(jié)YYY-MM-DDhh:mm:ss業(yè)務(wù)信息需求數(shù)據(jù)下發(fā)接口說明：由車網(wǎng)互動平臺按需在日前向負(fù)荷聚合商平臺下發(fā)需求日需求數(shù)據(jù)請求類型及地址：Post由聚合商平臺自主實(shí)現(xiàn)${YOURURL}/request/issue表18請求參數(shù)示例參數(shù)數(shù)據(jù)類型必填描述需求響應(yīng)數(shù)據(jù)json是{“sign”:“HMAC-MD5簽名”，“timestamp”:“yyyyMMddHHmmss”，“code”:“需求編碼”，“type”:1，“date”:“需求日期”，“data”:[{“點(diǎn)號”:需求值},{“點(diǎn)號”:需求值},...]}注：type的類型：1為削峰，2為填谷。data中的數(shù)據(jù)為響應(yīng)時間段的需求響應(yīng)量，每15分鐘一個點(diǎn)，每日1到96點(diǎn)。表19響應(yīng)參數(shù)類型描述json{ "code"：200, "msg":“success”,"sign"：“HMAC-MD5簽名”}code結(jié)果編碼-1：系統(tǒng)繁忙，請求方稍后再試201：成功101：簽名錯誤102：參數(shù)不合法，缺少必要參數(shù)501：系統(tǒng)錯誤，未知異常msg結(jié)果說明計(jì)劃申報接口說明:負(fù)荷聚合商平臺需要每日8點(diǎn)之前上報次日計(jì)劃負(fù)荷請求類型及地址：POST${MYURL}/reported/plan表20計(jì)劃申報功率名稱類型中文名稱描述SendTypestring申報類型按時點(diǎn)申報響應(yīng)負(fù)荷ReportDatestring申報日期申報數(shù)據(jù)對應(yīng)的日期MarketIdint市場ID由車網(wǎng)互通平臺提供1string點(diǎn)位1的申報功率點(diǎn)位1位為00:15，每個點(diǎn)位間隔15分鐘nstring點(diǎn)位n的申報功率n取值范圍1-9696string點(diǎn)位96的申報功率點(diǎn)位96為次日00:00表21計(jì)劃申報電量名稱類型中文名稱描述SendTypestring申報類型按時間段申報電量ReportDatestring申報日期申報數(shù)據(jù)對應(yīng)的日期MarketIdint市場ID由車網(wǎng)互通平臺提供ElectricInfosarray時間段電量信息集合元素格式：key:value形式，key為開始時間+“|”+結(jié)束時間（比如10:00|11:00），value為對應(yīng)的電量（單位：kWh）表22請求參數(shù)示例參數(shù)數(shù)據(jù)類型必填描述總加數(shù)據(jù)json是{“sign”:“HMAC-MD5簽名”，“timestamp”:“yyyyMMddHHmmss”，“data”:{ "remoteId":分配給第三方平臺的唯一標(biāo)識, "cmdData":[{ "BSP-組號-1":"值", "BSP-組號-2":"值", …, "BSP-組號-96":"值" }]}}注:BSP為固定值。組號為車網(wǎng)互動分配給各第三方平臺的特定標(biāo)識數(shù)字(4:充電樁),點(diǎn)號(每15分鐘算一個點(diǎn),每日1到96點(diǎn))。值：每15分鐘的計(jì)劃功率值。表23響應(yīng)參數(shù)類型描述json{ "code"：200, "msg":“success”,"sign"：“HMAC-MD5簽名”}code結(jié)果編碼-1：系統(tǒng)繁忙，請求方稍后再試201：成功101：簽名錯誤102：參數(shù)不合法，缺少必要參數(shù)501：系統(tǒng)錯誤，未知異常msg結(jié)果說明出清結(jié)果下發(fā)接口說明：車網(wǎng)互動平臺前一日下發(fā)次日總的計(jì)劃調(diào)控指令到負(fù)荷聚合商平臺，負(fù)荷聚合商平臺實(shí)現(xiàn)總功率拆分到具體設(shè)備完成次日的調(diào)控指標(biāo)。請求類型及地址：Post由負(fù)荷聚合商平臺自主實(shí)現(xiàn)接口${YOURURL}/plan/control表24請求參數(shù)示例：數(shù)據(jù)類型描述json{"sign"：“HMAC-MD5簽名”,"timestamp":"yyyyMMddHHmmss","data"：{"cmdId"：123111,"cmdType"：3（計(jì)劃功率調(diào)控）"cmdData":{ "組號-點(diǎn)號":控制值, "組號-點(diǎn)號":控制值, "組號-點(diǎn)號":控制值}}}cmdId是調(diào)控指令唯一編碼cmdData是調(diào)控指令，以“組號-點(diǎn)號：值”的格式。組號為車網(wǎng)互動分配給各第三方平臺的特定標(biāo)識數(shù)字(4:充電樁),點(diǎn)號(每15分鐘算一個點(diǎn),1到96個點(diǎn))。cmdType調(diào)控類型3:每日下發(fā)一次計(jì)劃功率指令，由第三方平臺自主實(shí)現(xiàn)指令分發(fā)及調(diào)節(jié)策略(當(dāng)有實(shí)時功率調(diào)節(jié)指令時，按實(shí)時功率調(diào)節(jié)指令進(jìn)行調(diào)節(jié))。表25響應(yīng)參數(shù)：類型描述json{"code"：201,"msg":“success”,"sign"：“HMAC-MD5簽名”}code結(jié)果編碼-1：系統(tǒng)繁忙，請求方稍后再試201：成功101：簽名錯誤102：參數(shù)不合法，缺少必要參數(shù)501：系統(tǒng)錯誤，未知異常msg結(jié)果說明實(shí)時調(diào)控指令下發(fā)接口說明：車網(wǎng)互動平臺當(dāng)日下發(fā)實(shí)時調(diào)控指令到負(fù)荷聚合商平臺，由負(fù)荷聚合商平臺實(shí)現(xiàn)總功率拆分到具體設(shè)備完成調(diào)控。（該接口控制時間僅限當(dāng)日，且非全天調(diào)用，該接口未定義的時間點(diǎn)仍按照出清結(jié)果執(zhí)行控制）請求類型及地址：Post由第三方平臺自主實(shí)現(xiàn)接口${YOURURL}/realtime/control表26請求參數(shù)數(shù)據(jù)類型描述json{"sign"：“HMAC-MD5簽名”,"timestamp":"yyyyMMddHHmmss","data"：{"cmdId"：123111,"cmdType"：1（實(shí)時功率調(diào)控）"cmdData":{ "組號-點(diǎn)號":控制值, "組號-點(diǎn)號":控制值, "組號-點(diǎn)號":控制值}}}cmdId是調(diào)控指令唯一編碼cmdData是調(diào)控指令，以“組號-點(diǎn)號：值”的格式。組號為車網(wǎng)互動分配給各第三方平臺的特定標(biāo)識數(shù)字(4:充電樁),點(diǎn)號(每十五分鐘算一個點(diǎn),1到96個點(diǎn))。cmdType調(diào)控類型1:下發(fā)實(shí)時功率調(diào)節(jié)指令,由第三發(fā)平臺自主實(shí)現(xiàn)指令分發(fā)及調(diào)節(jié)策略code結(jié)果編碼-1：系統(tǒng)繁忙，請求方稍后再試201：成功101：簽名錯誤102：參數(shù)不合法，缺少必要參數(shù)501：系統(tǒng)錯誤，未知異常msg結(jié)果說明表27響應(yīng)參數(shù)類型描述json{"code"：201,"msg":“success”,"sign"：“HMAC-MD5簽名”}code結(jié)果編碼-1：系統(tǒng)繁忙，請求方稍后再試201：成功101：簽名錯誤102：參數(shù)不合法，缺少必要參數(shù)501：系統(tǒng)錯誤，未知異常msg結(jié)果說明總加數(shù)據(jù)上報接口(每分鐘上報)概述：各平臺需根據(jù)指定的數(shù)據(jù)格式每分鐘上報充電站的總加數(shù)據(jù)，一次接口請求需上報整站的功率數(shù)據(jù)和站點(diǎn)下所有充電樁各自的功率數(shù)據(jù)（充電站總加數(shù)據(jù)為全部充電樁的有功功率之和，充電樁的總加數(shù)據(jù)為當(dāng)前的有功功率）接口說明：用于各平臺上報總加數(shù)據(jù)請求類型及地址：POST${MYURL}/reported/operating/data/sum表28充電站上報參數(shù)：字段參數(shù)類型是否必填參數(shù)說明備注stationNameString必填站名稱stationActivePowerDouble必填全站有功(KW)保留三位小數(shù)站點(diǎn)所有設(shè)備功率stationAdjustTotalActivePowerDouble必填全站參與調(diào)節(jié)總有功(KW)保留三位小數(shù)站點(diǎn)可調(diào)節(jié)設(shè)備功率stationZeroElectricQuantityDouble選填全站當(dāng)日零點(diǎn)電量(KWh)保留三位小數(shù)stationIdString必填運(yùn)營系統(tǒng)內(nèi)部站IDarchivesTypeInteger必填檔案類型4:充電樁6:站adjustUpdouble選填參與調(diào)節(jié)樁的可上調(diào)容量總加基于當(dāng)前功率，可向上調(diào)節(jié)容量adjustDowndouble選填參與調(diào)節(jié)樁的可下調(diào)容量容量總加基于當(dāng)前功率，可向下調(diào)節(jié)容量pilesDataList必填當(dāng)前站下所有樁的實(shí)時信息表29充電樁上報參數(shù)：字段參數(shù)類型是否必填參數(shù)說明備注pileIdString必填運(yùn)營系統(tǒng)內(nèi)部設(shè)備IDpileNameString必填樁名稱pileActivePowerDouble必填樁有功(KW)保留三位小數(shù)pileElectricCurrentDouble必填樁電流(A)保留三位小數(shù)無數(shù)據(jù)填0pileZeroElectricQuantityDouble選填樁當(dāng)日零點(diǎn)電量(KW)保留三位小數(shù)0點(diǎn)這一刻的累計(jì)電量socinteger選填當(dāng)前socpileOutputVoltageString必填樁電壓保留三位小數(shù)無數(shù)據(jù)填0stationIdString必填運(yùn)營系統(tǒng)內(nèi)部站IDarchivesTypeInteger必填檔案類型4:充電樁6:站controlTypeInteger必填調(diào)控類型1:正常充電2:響應(yīng)調(diào)控（未接到平臺調(diào)控指令為正常充電1，參與調(diào)控接收調(diào)控指令為2）adjustUpdouble選填可上調(diào)容量基于當(dāng)前功率，可向上調(diào)節(jié)容量adjustDowndouble選填可下調(diào)容量基于當(dāng)前功率，可向下調(diào)節(jié)容量remainTimeint選填剩余充電時長直流樁，單位：分鐘socdouble選填車輛SOC值直流樁，單位：%vinString選填VIN碼車輛唯一標(biāo)識表30請求參數(shù)示例參數(shù)數(shù)據(jù)類型必填描述總加數(shù)據(jù)json是{“sign”:“HMAC-MD5簽名”，“timestamp”:“yyyyMMddHHmmss”，"data":{"remoteId":"分配給運(yùn)營商的唯一標(biāo)識","cmdData":{ "站組號-點(diǎn)號":[{"stationName":"","stationActivePower":"""stationAdjustTotalActivePower":"""stationZeroElectricQuantity":"""stationId":"""archivesType":"6""adjustUp":"""adjustDown":"""pilesData":{"樁組號-點(diǎn)號":[{"archivesType":"4","pileId":"1", "pileName":"1號樁", "pileActivePower":1000.66, "pileZeroElectricQuantity

":0, "pileElectricCurrent":100},...]}},...],}}}注:組號為車網(wǎng)互動分配給各站級平臺的特定標(biāo)識數(shù)字(4:充電樁，6:站),點(diǎn)號由車網(wǎng)互動系統(tǒng)定義(每分鐘算一個點(diǎn),每日總計(jì)1440個點(diǎn))。表31響應(yīng)參數(shù)類型描述json{ "code"：200, "msg":“success”,"sign"：“HMAC-MD5簽名”}code結(jié)果編碼-1：系統(tǒng)繁忙，請求方稍后再試201：成功101：簽名錯誤102：參數(shù)不合法，缺少必要參數(shù)501：系統(tǒng)錯誤，未知異常msg結(jié)果說明計(jì)量數(shù)據(jù)推送接口說明：用于各平臺上報計(jì)量數(shù)據(jù)請求類型及地址：/vgs-api-open/charging/pile/measurementdata表32計(jì)量接口參數(shù)字段參數(shù)類型是否必填參數(shù)說明備注operatorNameString必填聚合商名稱文本operatorIdString必填聚合商id社會統(tǒng)一信用代碼pileCodeString必填樁編碼pileTypeInteger必填樁類型0:未知1:直流2:交流stationNameString必填站名稱文本locationString必填充電樁(機(jī))詳細(xì)地址文本orderNoString必填充電訂單號userIdString必填用戶IdvinString必填車輛識別碼vin車輛識別碼vinpileManufacturerString必填充電樁廠家electricMeterManufacturerString選填電表廠家accurac