Udkast til dataudveksling med elleverandører og andre tredjeparter via kundestyret dataadgang 14.04.2015 USS/XSTJ Version 1.2. 1. Indledning... 2 2. Proces for kundestyret dataadgang... 2 2.1 Fuldmagtsgivning for privat kunde (CPR-nr.)... 2 2.2 Proces for juridisk kunde (CVR-nr.)... 3 2.3 Fuldmagtstyper og gyldighed... 5 2.4 Dataudveksling... 8 2.5 Fuldmagtsophør... 8 2.6 Praktisk hjemtagelse af data... 9 2.6.1 Indhentning af data via webside... 9 2.6.2 Indhentning af data via Webservice... 9 Bilag 1: Eksempel på output format (fuldt format opdateres senere):... 11 Dok. 1/11
1. Indledning Indførelsen af en kundestyret dataadgang betyder, at ingen aktører kan få adgang til kundens data, uden at kunden 1 eksplicit har givet tilladelse. En mundtlig accept fra kunden, som tidligere har været nok for mæglere og elleverandører for at få adgang til alle data, er altså ikke længere tilstrækkelig. For elleverandører betyder det konkret, at hvis de ønsker at afgive et tilbud til en kunde, kan de fremover ikke hente timedata i DataHub, uden at kunden har givet sin tilladelse i form af en elektronisk fuldmagt. De samme regler vil gælde for andre såkaldte tredjeparter, som har behov for adgang til kundens stameller måledata for at yde en aftalt service. Det kunne fx være mæglere og energirådgivere. Elleverandører kan dog fortsat med kundens mundtlige accept indhente information om det seneste årsforbrug summeret på et givet målepunkt via forretningsproces BRS-024 i DataHub. 2. Proces for kundestyret dataadgang 2.1 Fuldmagtsgivning for privat kunde (CPR-nr.) Processen for at give elektronisk fuldmagt til en elleverandør eller en anden tredjepart igangsættes via dennes hjemmeside. For kunden betyder det følgende trin: 1. Tredjeparts hjemmeside 2. Fuldmagts hjemmeside (Energinet.dk) 3. Retur til tredjepartshjemmeside Kunden igangsætter fuldmagtsdeling via link på elleverandørens eller anden tredjeparts hjemmeside Elleverandør eller anden tredjepart anmoder om data i DataHub via eget virksomheds Nem-ID Kunden verificerer sin identitet via. Nem- ID/Digital signatur overfor Energinet.dk Kunden udvælger målepunkter og omfanget af data der skal udleveres til elleverandøren eller anden tredjepart For private personer med CPR-nrskal processen for at give fuldmagt igangsættes fra elleverandørens eller anden tredjeparts hjemmeside. Her kan elleverandøren eller anden tredjepart indsamle eventuelle oplysninger til egne formål, inden kunden henvises til fuldmagtshjemmesiden fuldmagt.eloverblik.dk, hvor kunden skal logge ind med sit NemID hos Energinet.dk. Siden (fuld- 1 Juridiske kunder med CVR-nr., kan udvælge en dataadgangsansvarlig, som vil være ansvarlig for at give tilladelse til en elleverandør eller anden tredjepart. Dok. 14-11439-4 2/11
magt.eloverblik.dk) vil være placeret på samme domæne som DataHub Kundeportal, men vil ikke have nogen direkte tilknytning hertil. Første gang kunden logger ind hos Energinet.dk med sit NemID, for at give adgang til en elleverandør eller anden tredjepart, vil kunden blive bedt om at tilknytte sit målepunkt til det benyttede NemID. Dette vil i praksis ske ved brug at målepunkts ID og webadgangskode, som i forvejen eksisterer i DataHub i dag. Er der to kunder på målepunktet vil det være først til mølle princippet der gælder, dvs. tilknytningen sker enten til kunde 1 eller kunde 2. Har kunden i forvejen tilknyttet sit målepunkts ID til NemID i DataHub (fx ved brug af DataHub Kundeportal) dirigeres kunden direkte til en webside, hvor det/de tilknyttede målepunkter vises. Her bedes kunden markere de målepunkter, som den elektroniske fuldmagt skal omfatte. Kunden skal samtidig beslutte hvilke data fuldmagten skal give tilladelse til at indhente jf. afsnit 2.3. 2.2 Proces for juridisk kunde (CVR-nr.) Adgangsfuldmagten for erhvervskunder kontrolleres af det CVR-nummer, der er markeret som dataadgangsansvarlig på målepunktet (Dataadgangs-CVR-nr) 2. Et moderselskab kan således give adgang til data for alle datterselskaber i en arbejdsgang så længe at moderselskabets CVR-nr. er indsat som dataadgangs- CVR-nr. på alle de datterselskaber, som der ønskes adgang til. 2 Dataadgangs-CVR-nr. bruges i DataHub udelukkende til at tildele adgang til måledata til elleverandører og andre tredjeparter. Dok. 14-11439-4 3/11
På samme måde, som for private kunder, igangsættes processen for fuldmagtsgivning ved, at elleverandører og andre tredjeparter gennem egen hjemmeside henviser den dataadgangsansvarlige til at logge ind på fuldmagtshjemmesiden fuldmagt.eloverblik.dk med sin Digitale Signatur. Dok. 14-11439-4 4/11
Den dataadgangsansvarlige vil efter login få vist de målepunkter, som der kan videregives fuldmagt til. Listen af målepunkter vil være baseret på et match mellem det Dataadgangs-CVR-nr. der er registreret i DataHub og det CVR-nr., som den Digitale Signatur er registreret på. Den dataadgangsansvarlige kan vælge alle målepunkter på én gang, eller selektere i listen af målepunkter. Hvis den dataadgangsansvarlige ikke får vist den forventede liste af målepunkter, som følge af manglende opdatering af Dataadgangs-CVR-nr. i DataHub, skal Dataadgangs-CVR-nr. opdateres i DataHub af elleverandøren på målepunktet. 2.3 Fuldmagtstyper og gyldighed Efter den private kunde (CPR-nr.) eller den dataadgangsansvarlige (herefter under ét betegnet som den dataadgangsansvarlige) har udvalgt de målepunkter, som fuldmagten skal omfatte, skal den dataadgangsansvarlige angive i hvilke data fuldmagten skal give tilladelse til at indhente: 1. Historisk (kun timeværdier): 3 måneders tilladelse for elleverandøren eller anden tredjepart til at indhente et års historiske timeværdier. Dvs. timeværdier for seneste løbende år (fra og med seneste måned og 13 måneder tilbage) og/eller: 2. Løbende (timeværdier eller summer): 365 kalenderdages tilladelse for elleverandøren eller anden tredjepart til at indhente løbende måledata.. Måledata vil blive udleveret pr. time eller summeret pr. hele dag, måned eller år afhængig af, hvad den dataadgangsansvarlige har givet tilladelse til. Den første fuldmagtstype er skræddersyet til tilbudssituationen, mens den anden type primært er relevant for tredjeparter, der leverer diverse services. Hvil- Dok. 14-11439-4 5/11
ke data der specifikt returneres til elleverandøren eller anden tredjepart ved de to fuldmagtstyper fra DataHub fremgår af afsnit 2.4. Hvis der allerede findes én eller flere fuldmagter til elleverandøren eller anden tredjepart, og den dataadgangsansvarlige ønsker at oprette en ny, vil systemet som sidste trin i oprettelsen af fuldmagten spørge, om de(n) eksisterende fuldmagt(er) skal overskrives. Der er dog ingen begrænsninger ift. hvor mange fuldmagter en dataadgangsansvarlig kan give til en elleverandør eller anden tredjepart. Herudover vil den dataadgangsansvarlige skulle acceptere vilkårene for deling af data med elleverandør eller anden tredjepart, herunder at efterfølgende fortrydelse af en fuldmagt skal iværksættes via DataHub Kundeportal. En evt. fortrydelse meddeles ikke direkte til elleverandøren eller anden tredjepart, men der vil blive gjort opmærksom herpå ved næstkommende forespørgsel på data. Dok. 14-11439-4 6/11
Ved signering af fuldmagten (samme princip som ved betaling af en regning i netbank) returneres den dataadgangsansvarlige til elleverandørens eller anden tredjeparts hjemmeside. Returadressen kunne fx se således ud: https://minelleverandør.dk/elforbrug/registrering?thirdpartykey=abcd1234&stat us=endk1 Af returadressen vil der være fremgå en statuskode, som angiver om fuldmagtsregisteringen blev gennemført. Statuskoderne er: Endk1: Der blev registreret fuldmagt Endk3: Kunden trykkede cancel Endk4: Der opstod en teknisk fejl Dok. 14-11439-4 7/11
2.4 Dataudveksling Elleverandøren eller anden tredjepart kan efter modtaget bekræftelse på fuldmagten indhente data på de målepunkter, der er omfattet af fuldmagten. Ved fuldmagt til historisk dataadgang vil DataHub returnere følgende data: 8760 timeværdier for seneste 365 kalenderdage. Dvs. forespørges 15. maj 2015 returneres 24 timeværdier pr. dag startende den 14. maj 2015 tilbage til 14. maj 2014. Ved fuldmagt til løbende dataadgang kan der anmodes om måledata jf. nedenstående. Den dataadgangsansvarlige vil i tildelingen af fuldmagten til elleverandøren eller anden tredjepart have angivet om måledata skal fremsendes som timeværdier, eller som summer pr. hele dag, måned eller år. 1. Timedata: 24 timeværdier pr. dag for de seneste 31 kalenderdage. 2. Dagsdata: 31 dagssummer for de seneste 31 kalenderdage. Forespørges 15. maj 2015, returneres 14. april til 14. maj. 3. Månedsdata: 13 månedssummer, dvs. seneste hele måned og 13 måneder tilbage. Forespørges i maj 2015, returneres april 2014 til april 2015. 4. Årsdata: 1 årssum, dvs. sum fra og med seneste hele måned og 12 måneder tilbage. Forespørges i maj 2015, returneres sum af perioden april 2014 til april 2015. Elleverandøren eller anden tredjepart kan dog til enhver tid i anmodning af data angive om data skal returneres fra og med datoen for fuldmagtsudstedelsen. 2.5 Fuldmagtsophør på et målepunkt Efter en elleverandør eller anden tredjepart har fået elektronisk fuldmagt, kan de løbende anmode om data i DataHub efter behov. Fuldmagten vil imidlertid ophøre på et målepunkt, hvis: 1. Fuldmagten udløber (hhv. efter 3 måneder eller 365 kalenderdage) 2. Fuldmagten annulleres via DataHub Kundeportalen 3. Elleverandøren gennemfører leveranceophør, eller til- eller fraflytning på målepunktet. Ift. punkt 3 vil fuldmagten kun ophøre for det givne målepunkt. Eventuelt øvrige målepunkter omfattet af fuldmagten vil ikke blive berørt. En udløbet eller annulleret fuldmagt kan ikke forlænges. Ønsker den dataadgangsansvarlige inden for fuldmagtens gyldighedsperiode at ændre i målepunkterne omfattet af fuldmagten, skal den dataadgangsansvarlige på ny igangsætte processen for fuldmagtsgivning til elleverandøren eller anden tredjepart, og evt. slette eller overskrive eksisterende fuldmagt(er). Dok. 14-11439-4 8/11
2.6 Praktisk hjemtagelse af data Elleverandøren eller anden tredjepart kan indhente data enten via webside eller via. direkte dataudveksling (webservices). Uanset hvilken metode der benyttes for at indhente data skal elleverandøren eller anden tredjepart identificere sig overfor Energinet.dk (DataHub) via NemID. Data som returneres fra DataHub vil altid være baseret på aktuelle værdier. 2.6.1 Indhentning af data via webside Elleverandør eller anden tredjepart logger ind med virksomheds NemID. Efter login vises en tabel med de målepunkter, som der er gyldig fuldmagt til at indhente data på. Elleverandør/tredjepart udvælger de målepunkter, der skal indhentes data på, og downloader data. Afhængig af det valgte antal målepunkter, kan der være ventetid på indhentningen af dataudtrækket. Elleverandør eller anden tredjepart kan indtaste sin mailadresse, hvortil der sendes notifikation når data er behandlet og klar til download. Dataudtrækket vil være i CSV format. 2.6.2 Indhentning af data via Webservice Ift. direkte dataudveksling stilles to webservices til rådighed, hhv. WS1 og WS2. Webservice 1 (WS1) returnerer målepunkter, som fuldmagten er omfattet af, herunder følgende informationer: Målepunkt ID Parent målepunkt ID (Der kan kun gives fuldmagter til parent målepunkter. Med en fuldmagt til et parent målepunkt medfølger fuldmagt til alle child målepunkter, og feltet vil være en reference til parent målepunktet.) Afregningsform Produkt (aktiv, reaktiv eller brændsel) Energienhed (kwh) Opløsning (kvartal, time, dag, måned, år) Målepunktstype Nettoafregningsgruppe Dataadgangs CVR Kunde CVR Målepunktsadresse Elleverandør/tredjepart kalder WS1, som vil returnere det målepunkt ID (samt øvrige ovenstående felter), som skal bruges i det efterfølgende kald. Webservice 2 (WS2) returnerer måledata for de målepunkter, som fuldmagten er omfattet af, herunder: Målepunkt ID Periode Position Dok. 14-11439-4 9/11
Tidsserier Elleverandør/Tredjepart skal kalde WS2 én gang pr. målepunkt. Herudover vil følgende regler være gældende: Den samme kombination af certifikat, målepunkt ID og periode kan kun forespørges maksimalt tre gange inden for samme døgn. Det er muligt at have 5 samtidige webservicekald fra samme IP-adresse af gangen. Dok. 14-11439-4 10/11
Bilag 1: Eksempel på output format (fuldt format opdateres senere): Webservice 1 (WS1): Input: NemId token/certifikat Output: Målepunkt Id + stamdata XML: <meteringpoints> <meteringpointid>1200000000000123</meteringpointid> <typeofmp>type 1</typeOfMP> <streetname>danmarksgade</streetname> <etc>...</etc> <meteringpointid>1200000000000123</meteringpointid> <typeofmp>type 1</typeOfMP> <streetname>danmarksgade</streetname> <etc>...</etc> <meteringpointid>1200000000000123</meteringpointid> <typeofmp>type 1</typeOfMP> <streetname>danmarksgade</streetname> <etc>...</etc> </meteringpoints> Webservice 2 (WS2) Input: NemId-token-certifikat, målepunkt ID, fuldmagt ID, historik(ja/nej) Output: Timeværdier XML: <meteringpoints> <from>23-11-2011 00:00</from> <meteringpointid>1200000000000123</meteringpointid> <to>23-11-2011 01:00</to> <usage>1234,0 KwH</usage> <from>23-11-2011 01:00</from> <meteringpointid>1200000000000126</meteringpointid> <to>23-11-2011 02:00</to> <usage>1234,0 KwH</usage> <from>23-11-2011 02:00</from> <meteringpointid>1200000000000129</meteringpointid> <to>23-11-2011 03:00</to> <usage>1234,0 KwH</usage> </meteringpoints> Dok. 14-11439-4 11/11