Databeskrivelse for Eloverblik og Tredjepartsadgang til Data- Hub

Transkript

1 Databeskrivelse for Eloverblik og Tredjepartsadgang til Data- Hub Dette dokument beskriver, hvilke data fra DataHub der er tilgængelige via Eloverblik og Tredjepartsadgang til DataHub, og i hvilke formater. 1. Indledning september 2017 JLI/JLI 2. Generelt om data Data på Eloverblik Mine målere Eksportér måledata Data i Tredjepartsadgang til DataHub Tredjepartsadgang webløsning/gui Tredjepartsadgang API Dok. 15/ v. 5 Klassificering:OF - Til offentligt brug 1/21

2 1. Indledning DataHub indeholder handelsrelevant data for landets elkunder, producenter og aktører. Slutkunder og tredjeparter (herunder elleverandører som ønsker at give tilbud til en kunde) har særskilt adgang til DataHub via henholdsvis Eloverblik og Tredjepartsadgang til DataHub. Denne vejledning beskriver, hvilke data fra DataHub som vises og kan hentes via den kundestyrede adgang til data (Eloverblik og Tredjepartsadgang), og hvordan dataene skal tolkes. Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 2/21

3 2. Generelt om data Data hentes direkte fra DataHub, men kan på Eloverblik og Tredjepartsadgangen være anderledes formateret eller leveret i en særlig aggregering/summering. Energinet.dk ejer og driver DataHub, men ansvaret for korrekte og rettidige data ligger hos elleverandører og netselskaber. Energinet.dk nedsætter forskrifter, som forpligter til korrekt og rettidig registrering af data. Du kan læse mere herom, særligt i forskrift H1 og Forskrift I. Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 3/21

4 3. Data på Eloverblik I dette afsnit beskrives de data, som vises og kan eksporteres fra Eloverblik. Hvert af de overordnede afsnit (3.1 og 3.2) svarer til et menupunkt på Eloverblik. 3.1 Mine målere Under menupunktet Mine målere er der adgang til specifikke målepunkter. For et specifikt målepunkt stilles der en række data til rådighed på Eloverblik. De enkelte datatyper er beskrevet i det følgende inddelt i underafsnit svarende til undermenuer og overskrifter på Eloverblik Kundeoplysninger Elmåler 1) MålepunktsID: 18-cifret målepunktsid, som entydigt identificerer et målepunkt. 2) Målernummer Hvis der er tilknyttet en måler til målepunktet, angives et 8-cifret målernummer. 3) Netvirksomhed Navnet på den netvirksomhed, der ejer og varetager distributionen i det netområde, som målepunktet befinder sig i. 4) Målepunktstype Følgende målepunktstyper kan ses på Eloverblik: Forbrugsmålepunkt Produktionsmålepunkt Udvekslingsmålepunkt VE-produktion Analysemålepunkt Overskudproduktion gruppe 6 Nettoproduktion Leveret til net Forbrugt fra net Afregningsgrundlag/information Egenproduktion Netto fra net Netto til net Bruttoforbrug Nettabskorrektion Elvarmemålepunkt Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 4/21

5 5) Status Følgende statusangivelser kan ses på Eloverblik: Nyoprettet Tilsluttet Afbrudt 6) Aflæsningsfrekvens Der kan ses følgende aflæsningsfrekvenser på Eloverblik: Aflæsningsfrekvens Kvarter Time Måned Andet Beskrivelse Angiver at målepunktet er kvartersaflæst Angiver at målepunktet er timeaflæst Angiver at målepunktet er månedsaflæst Angiver at målepunktet er periodisk aflæst (pr. måned/kvartal/år) 7) Alias Angiver det alias (alternative navn), som brugeren kan tildele målepunktet under Mine Målere. Childmålepunkter kan ikke have et alias tilknyttet Afregning 1) Forventet årsforbrug Angiver det samlede forventede årsforbrug på målepunktet. 2) Aflæsningsform Følgende aflæsningsformer kan ses på Eloverblik: Aflæsningsform Fjernaflæst Manuelt Beskrivelse Målepunktet aflæses automatisk Målepunktet aflæses manuelt Kunde og aftale 1) Kunde 1 Navn på den primære kunde på målepunktet - enten navnet på en privat forbruger eller et virksomhedsnavn. Navnet på en evt. sekundær kunde vil ikke blive vist. 2) CVR CVR-nummer på den kunde, som ejer målepunktet. Vises kun, hvis målepunktet er ejet af en virksomhed. 3) Dataadgangs-CVR Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 5/21

6 Et sekundært CVR-nr., som kunden på målepunktet har fået tilknyttet til målepunktet via elleverandøren. Virksomheden med det pågældende CVR kan ligesom kunden på målepunktet få adgang til målepunktet via Eloverblik eller give tredjepartsadgang til målepunktet. 4) Elleverandør Angiver hvilken elleverandør, som har en aftale med kunden om leverance af el. 5) Startdato for aftale Startdato for aktuel aftale med elleverandør. Vises i formatet DD-MM- ÅÅÅÅ, fx Måledata Under menupunktet Måledata kan der fremsøges måledata, som er registreret på målepunktet inden for den periode, hvor målepunktet har været registreret til den nuværende ejer af/kunde på målepunktet Summeringsvalg Ved fremsøgning af måledata kan der afhængigt af målepunktets afregningsform og aflæsningsfrekvens vælges mellem forskellige summeringsniveauer (time, dag, måned eller år). For månedsaflæste målepunkter uden afregningsform kan der vælges mellem summeringsniveau Måned eller År. For de følgende typer af målepunkter kan der vælges mellem summeringsniveau Time, Dag, Måned eller År : flexafregnede målepunkter timeregnede målepunkter skabelonafregnede målepunkter, som er kvarters- eller timeaflæst målepunkter uden afregningsfrom, som er kvarters- eller timeaflæst For skabelonafregnede målepunkter med anden aflæsningsfrekvens end kvarter/time kan der ikke vælges summering Summeringsvisning Hvad der returneres ved valg af de forskellige summeringsniveauer afhænger af, hvilke aflæsninger der findes på målepunktet. Der skelnes på overordnet niveau mellem skabelonaflæsninger/forbrugsopgørelser (som findes på skabelonafregnede forbrugsmålepunkter) og tidsserier (som findes på timeaflæste skabelonafregnede forbrugsmålepunkter, på time- og flexafregnede forbrugsmålepunkter samt på alle øvrige målepunktstyper). I det følgende er beskrevet, hvad der returneres i de enkelte tilfælde. Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 6/21

7 1) Målepunkt med tidsserier 1) Valgt summering: Time Findes der kvarters- eller timeaflæste værdier på målepunktet, returneres disse i timeopløsning (dvs. kvartersværdierne summeres pr. time og timeværdierne vises, som de er aflæst). Findes der månedsaflæste værdier på målepunktet, returneres disse ikke, da der divideres ned til timeopløsning. 2) Valgt summering: Dag Findes der kvarters- eller timeaflæste værdier på målepunktet, returneres disse i døgnopløsning (dvs. værdierne summeres op pr. døgn). Findes der månedsaflæste værdier på målepunktet, returneres disse ikke, da der ikke divideres ned til døgnopløsning. 3) Valgt summering: Måned Findes der kvarters-, time- eller månedsaflæste værdier på målepunktet, returneres disse i månedsopløsning (dvs. kvarters- og timeværdierne summeres op pr. måned, og månedsværdierne vises, som de er aflæst) 4) Valgt summering: År Findes der kvarters-, time- eller månedsaflæste værdier på målepunktet returneres disse i årsopløsning (dvs. værdierne summeres op pr. år) 2) Målepunkt med skabelonaflæsninger Hvis der findes skabelonaflæsninger på målepunktet, returneres disse som de er aflæst, dvs. uden summering. Skabelonaflæsningerne vises på en separat fane Præsentation af måledata Når måledataene (hvad enten det er tidsserier eller skabelonaflæsninger) præsenteres for brugeren, vises følgende data: 1) Fra Angiver fra-datoen for aflæsningen i formatet dd-mm-åååå tt:mm:ss. 2) Til Angiver til-datoen for aflæsningen i formatet dd-mm-åååå tt:mm:ss. 3) Værdi Angiver den målte værdi i den relevante enhed afhængigt af målepunktstypen, typisk KWh Leverandørskift Under menupunktet Leverandørskift findes leverandørhistorik for målepunktet i den periode, hvor målepunktet har været registreret til den nuværende ejer/kunde. Der vises følgende data: Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 7/21

8 1) Fra Viser fra-datoen for den pågældende leveranceperiode i formatet dd-mmåååå. 2) Til Viser til-datoen for den pågældende leveranceperiode i formatet dd-mmåååå. 3) Elleverandør Navnet på elleverandøren i perioden Forespørgsler Under menupunktet Forespørgsler ses data for forespørgsler på målepunktet. Følgende data vises: 1) Dato Datoen for forespørgslen i formatet dd-mm-åååå. 2) Forespurgt af Navn på den elleverandør eller netvirksomhed, som har lavet forespørgslen. 3) Type af forespørgsel Forespørgslens type, fx Fremsøgt elmåler. 3.2 Eksportér måledata Under menupunktet Eksportér måledata kan det vælges, hvilken periode der skal hentes måledata for, og hvilken summering dataene skal vises i. I det følgende beskrives hvilke data der returneres afhængigt af de valgte summeringer og perioder Summering Der kan vælges mellem nedenstående summeringsniveauer ved eksport af måledata: Time Dag Måned År Hvad der returneres ved valg af de forskellige summeringsniveauer afhænger af, hvilke aflæsninger der findes på målepunktet. Nærmere information findes i afsnit Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 8/21

9 3.2.2 Periode Der kan vælges mellem 3 forskellige perioder ved eksport af måledata. I det følgende beskrives, hvad der returneres ved valg af de forskellige perioder: 1) Måned Der hentes data for perioden fra dags dato og 1 måned tilbage. Hvis der fx bestilles data d , vil der blive returneret tilgængelige måledata for perioden Hvis der findes skabelonaflæsninger, som helt eller delvist overlapper den nævnte periode, vil disse også blive returneret. Hvis der fx bestilles data d , og der findes en skabelonaflæsning for perioden (delvist overlap), vil denne aflæsning blive returneret. 2) Kvartal Der hentes data hentes for perioden fra dags dato og 3 måneder tilbage. Hvis der fx bestilles data d , vil der blive returneret tilgængelige måledata for perioden Hvis der findes skabelonaflæsninger, som helt eller delvist overlapper den nævnte periode, vil disse også blive returneret. Hvis der fx bestilles data d , og der findes en skabelonaflæsning for perioden (delvist overlap), vil denne aflæsning blive returneret. 3) År Der hentes data for perioden fra dags dato og 1 år tilbage. Hvis der fx bestilles data d , vil der blive returneret tilgængelige måledata for perioden Hvis der findes skabelonaflæsninger, som helt eller delvist overlapper den nævnte periode, vil disse også blive returneret. Hvis der fx bestilles data d , og der findes en skabelonaflæsning for perioden (delvist overlap), vil denne aflæsning blive returneret Præsentation af måledata Følgende data findes i eksportfilen: 1) ID Unikt ID for den pågældende række i eksportfilen. 2) Maaler 18-cifret målepunktsid, som entydigt identificerer et målepunkt. 3) Fra Viser fra-datoen i formatet dd-mm-åååå tt:mm:ss. 4) Til Viser til-datoen i formatet dd-mm-åååå tt:mm:ss. Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 9/21

10 5) Værdi Den aflæste/målte værdi. 6) Enhed Enhed for værdien, typisk kwh. 7) Aflæsningstype Der kan ses følgende aflæsningstyper: Aflæsningstype Time Andet Beskrivelse Angiver at der er tale om en tidsserie. Værdien kan være enten kvarters-, time-, eller månedsaflæst. Angiver at der er tale om en skabelonaflæsning. Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 10/21

11 4. Data i Tredjepartsadgang til DataHub I dette afsnit beskrives de data, som vises og kan eksporteres fra Tredjepartsadgangen til DataHub. 4.1 Tredjepartsadgang webløsning/gui I det følgende beskrives de data, som vises og kan eksporteres fra webløsningen/gui en til Tredjepartsadgangen. Hvert af de overordnede afsnit (4.1.1 og 4.1.2) svarer til em fane i GUI en/webløsningen til Tredjepartsadgangen Fuldmagter Fanen Fuldmagter indeholder en liste over fuldmagter samt mulighed for at hente måledata, målepunktsstamdata og fuldmagtsstamdata. De relevante data for disse områder er beskrevet i de følgende afsnit Fuldmagtsliste Fuldmagtslisten indeholder følgende data: 1) Kundenavn Kundens navn enten personnavn (ved privatkunde) eller virksomhedsnavn (ved erhvervskunde). 2) CVR kunde CVR-nummer på kunden. Vises kun, hvis målepunktet er ejet af en virksomhed. 3) Tredjepart nøgle En kode defineret af tredjeparten (tredjepartsnøgle) bestående 1-25 cifre, der udgøres af tal og/eller bogstaver (ingen specialtegn, herunder ÆØÅ), som tredjeparten evt. anvender til identifikation af slutkunden. 4) Løbende fuldmagt Angiver den tidsopløsning, som fuldmagten er givet til (time, dag, måned, år) samt den periode, fuldmagten gælder for, fx 30. november november ) Antal målere Antal målepunkter omfattet af fuldmagten Hent data Funktionen Hent data på fanen Fuldmagter returnerer følgende data: 1) ID Et entydigt ID for den pågældende fuldmagt (fuldmagtsid). Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 11/21

12 2) Maaler 18-cifret målepunktsid, som entydig identificerer et målepunkt. 3) Fra Angiver fra-datoen for aflæsningen i formatet dd-mm-åååå tt:mm:ss. 4) Til Angiver til-datoen for aflæsningen i formatet dd-mm-åååå tt:mm:ss. 5) Værdi Angiver den aflæste/målte værdi. 6) Enhed Enhed for værdien, typisk kwh. 7) Aflæsningstype Der kan ses følgende aflæsningstyper: Aflæsningstype Time Andet Beskrivelse Angiver at der er tale om en tidsserie. Værdien kan være enten kvarters-, time-, eller månedsaflæst. Angiver at der er tale om en skabelonaflæsning Hent målepunktsstamdata Funktionen Hent målepunktsstamdata på fanen Fuldmagter returnerer følgende data: 1) MålepunktsID 18 cifret målepunktsid som entydig identifikation af et målepunkt. 2) Parent-målepunktsID Angiver med et 18-cifret målepunktsid, om målepunktet har en såkaldt parent, dvs. et overordnet målepunkt. Når målepunktet har en parent, er målepunktet selv et såkaldt child-målepunkt (underordnet målepunkt) og indgår det i en parent/child-struktur, hvor målepunktet er tilknyttet et andet målepunkt (parent-målepunktet), fx i en solcelleinstallation, hvor der er flere sammenhængende målepunkter. 3) Vejnavn Vejnavn i den adresse, som målepunktet er tilknyttet. 4) Husnummer Husnummer i den adresse, som målepunktet er tilknyttet. 5) Etage Etageangivelse i den adresse, som målepunktet er tilknyttet. Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 12/21

13 6) Dørbetegnelse Dørbetegnelse i den adresse, som målepunktet er tilknyttet. 7) Postnummer Postnummer i den adresse, som målepunktet er tilknyttet. 8) Bynavn Bynavn i den adresse, som målepunktet er tilknyttet. 9) Målepunktstype Følgende målepunktstyper kan ses i målepunktsstamdataudtræk: Forbrugsmålepunkt Produktionsmålepunkt Udvekslingsmålepunkt VE-produktion Analysemålepunkt Overskudproduktion gruppe 6 Nettoproduktion Leveret til Net Forbrugt fra Net Afregningsgrundlag/information Egenproduktion Netto fra net Netto til net Bruttoforbrug Nettabskorrektion Elvarmemålepunkt 10) Nettoafregningsgruppe Angiver, om målepunktet er omfattet af nettoafregningsreglerne, og i så fald hvilken nettoafregningsgruppe, der er tale om. 11) Dataadgangs-CVR Et sekundært CVR-nr., som kunden på målepunktet har fået tilknyttet til målepunktet via elleverandøren. Virksomheden med det pågældende CVR kan ligesom kunden på målepunktet få adgang til målepunktet via Eloverblik eller give tredjepartsadgang til målepunktet. 12) CVR CVR-nummer på kunden, som ejer målepunktet. Vises kun, hvis målepunktet er ejet af en virksomhed. 13) Produkt Angiver en energiproduktklassifikation for målepunktet. 14) Afregningsform Angiver, om målepunktet er flex-, skabelon- eller timeafregnet. Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 13/21

14 15) Aflæsningsfrekvens Angiver aflæsningsfrekvensen for målepunktet (kvarter, time, måned eller Andet). 16) Enhed Enhed for måledata på målepunktet, typisk kwh. 17) Forventet årsforbrug Det samlede forventede årsforbrug på målepunktet Hent stamdata for alle fuldmagter Funktionen Hent stamdatafor alle fuldmagter på fanen Fuldmagter returnerer følgende data: 1) ThirdpartyID ID, der identificerer tredjeparten. 2) ThirdPartyName Tredjepartens virksomhedsnavn. 3) ThirdPartKey En kode defineret af tredjeparten (tredjepartsnøgle) bestående 1-25 cifre, der udgøres af tal og/eller bogstaver (ingen specialtegn, herunder ÆØÅ), som tredjeparten evt. anvender til identifikation af slutkunden. 4) StartDate Startdato/-klokkeslæt for fuldmagtsperioden angivet i formatet dd-mmåååå tt:mm:ss. 5) EndDate Slutdato/-klokkeslæt for fuldmagtsperioden angivet i formatet dd-mmåååå tt:mm:ss. 6) Name Kundens navn enten personnavn (ved privatkunde) eller virksomhedsnavn (ved erhvervskunde). 7) HistoricData Angiver, om kunden har givet fuldmagt til historiske data (fra fuldmagtsdatoen) eller ej: True False Kunden har givet tredjeparten fuldmagt til historiske data Kunden har ikke givet tredjeparten fuldmagt til historiske data 8) CurrentDataResolution Angiver, om kunden har givet fuldmagt til løbende/fremtidige data (fra fuldmagtsdatoen), og i så fald i hvilken tidsopløsning/summering: Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 14/21

15 0 Kunde har ikke givet fuldmagt til løbende/fremtidige data Hour Day Month Year Kunden har givet fuldmagt til data i timeopløsning/-summering Kunden har givet fuldmagt til data i døgnopløsningen/- summering Kunden har givet fuldmagt til data i månedsopløsning/- summering Kunden har givet fuldmagt til data i årsopløsning/-summering Historiske fuldmagter Fanen Historiske fuldmagter indeholder en liste over fuldmagter samt mulighed for at hente måledata samt fuldmagtsstamdata. De relevante data for disse områder er beskrevet i de følgende afsnit Fuldmagtsliste Fuldmagtslisten indeholder følgende data: 1) Kundenavn Kundens navn enten personnavn (ved privatkunde) eller virksomhedsnavn (ved erhvervskunde). 2) CVR kunde En afkrydsningsboks angiver, om kunden er en virksomhed eller privatperson. Er boksen krydset af, er kunden en virksomhed. 3) Tredjepart Nøgle En kode defineret af tredjeparten (tredjepartsnøgle) bestående 1-25 cifre, der udgøres af tal og/eller bogstaver (ingen specialtegn, herunder ÆØÅ), som tredjeparten evt. anvender til identifikation af slutkunden. 4) Antal målere Antal målepunkter omfattet af fuldmagten Hent data Funktionen Hent data på fanen Historiske fuldmagter returnerer samme data, som beskrevet i afsnit Hent stamdata for alle fuldmagter Funktionen Hent stamdata for alle fuldmagter på fanen Historiske fuldmagter returnerer samme data, som beskrevet i afsnit Tredjepartsadgang API I det følgende beskrives de data, som kan hentes via API et til Tredjepartsadgangen. Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 15/21

16 4.2.1 GET: /authorizations-kaldet Følgende data returneres med GET: /authorizations-kaldet: 1) Id Et entydigt ID for den pågældende fuldmagt (fuldmagtsid). 2) Guid Unik nøgle som anvendes af Energinet.dk. 3) ThirdPartyId ID, der identificerer tredjeparten. 4) ThirdPartyKey En kode defineret af tredjeparten (tredjepartsnøgle) bestående 1-25 cifre, der udgøres af tal og/eller bogstaver (ingen specialtegn, herunder ÆØÅ), som tredjeparten evt. anvender til identifikation af slutkunden. 5) ThirdPartyName Tredjepartens virksomhedsnavn. 6) ThirdPartyCVR Tredjepartsvens CVR-nummer. 7) StartDate Startdato/-klokkeslæt for fuldmagtsperioden angivet i formatet åååå-mmddttt.mm:ss.00. 8) EndDate Slutdato/-klokkeslæt for fuldmagtsperioden angivet i formatet åååå-mmddttt.mm:ss.00. 9) Name Kundens navn enten personnavn (ved privatkunde) eller virksomhedsnavn (ved erhvervskunde). 10) HistoricData Angiver, om kunden har givet fuldmagt til historiske data (fra fuldmagtsdatoen) eller ej: True False Kunden har givet tredjeparten fuldmagt til historiske data Kunden har ikke givet tredjeparten fuldmagt til historiske data 11) CurrentDataResolution Angiver, om kunden har givet fuldmagt til løbende/fremtidige data (fra fuldmagtsdatoen), og i så fald i hvilken tidsopløsning/summering: Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 16/21

17 0 Kunde har ikke givet fuldmagt til løbende/fremtidige data Hour Day Month Year Kunden har givet fuldmagt til data i timeopløsning/-summering Kunden har givet fuldmagt til data i døgnopløsningen/- summering Kunden har givet fuldmagt til data i månedsopløsning/- summering Kunden har givet fuldmagt til data i årsopløsning/-summering 12) DeleteExistingAuthorizations Angiver, om kunden har valgt at overskrive eksisterende fuldmagter eller ej: True False Kunden har valgt at overskive eksisterende fuldmagter Kunden har valgt ikke at overskive eksisterende fuldmagter 13) ToBeSignedHtml Viser html-versionen af det fuldmagtsdokument, som kunden har accepteret ved afgivelse af fuldmagten. 14) SignedXml Viser xml-versionen af det fuldmagtsdokument, som kunden har accepteret ved afgivelse af fuldmagten. 15) SignedBy Angiver hvilket PID (ved privatkunde) eller CVR/RID (ved erhvervskunde), som har underskrevet fuldmagten. 16) SignedTimeStamp Angiver tidspunkt for underskrift af fuldmagt angivet i formatet åååå-mmddttt.mm:ss ) DeleteDate Her returneres altid null, da kun fuldmagter med DeleteDate = null, returneres i kaldet. Slettede fuldmagter, som ikke returneres, har i Delete- Date angivet det tidspunkt fuldmagten, hvor blev slettet. 18) ListOfMeteringPoints Returnerer en liste over 18 cifrede målepunktsid er, som indgår i fuldmagten. Omfatter kun parentmålepunkter 1 samt standalonemålepunkter 2, men ingen childmålepunkter 3. 19) MeteringPointIdentification 18 cifret målepunktsid, som entydigt identificerer et målepunkt. 1 Målepunkter, der har underordnede målepunkter (childmålepunkter) tilknyttet. 2 Målepunkter uden tilknyttede underordnede målepunkter (childmålepunkter). 3 Underordnede målepunkter. Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 17/21

18 4.2.2 GET: /meteringpointdetails-kaldet Følgende data returneres med GET: / meteringpointdetails -kaldet: 1) MeteringPointIdentification 18 cifret målepunktsid, som entydigt identificerer et målepunkt. 2) ParentMeteringPointIdentification Angiver med et 18-cifret målepunktsid, om målepunktet har en såkaldt parent, dvs. et overordnet målepunkt. Når målepunktet har en parent, er målepunktet selv et såkaldt childmålepunkt (underordnet målepunkt) og indgår det i en parent/child-struktur, hvor målepunktet er tilknyttet et andet målepunkt (parentmålepunktet), fx i en solcelleinstallation, hvor der er flere sammenhængende målepunkter. Hvis der ikke findes noget parentmålepunkt, returneres null. 3) StreetName Vejnavn i den adresse, som målepunktet er tilknyttet. 4) BuildingNumber Husnummer i den adresse, som målepunktet er tilknyttet. 5) FloorIdentification Etageangivelse i den adresse, som målepunktet er tilknyttet. Hvis der ikke findes nogen dørbetegnelse, returneres null. 6) RoomId Dørbetegnelse i den adresse, som målepunktet er tilknyttet. Hvis der ikke findes nogen dørbetegnelse, returneres null. 7) Postcode Postnummer i den adresse, som målepunktet er tilknyttet. 8) CityName Bynavn i den adresse, som målepunktet er tilknyttet. 9) TypeOfMeteringPoint Følgende målepunktstyper kan returneres: Kode E17 E18 E20 D01 Målepunktstype Forbrugsmålepunkt Produktionsmålepunkt Udvekslingsmålepunkt VE-produktion D02 Analysemålepunkt D04 Overskudproduktion gruppe 6 D05 Nettoproduktion Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 18/21

19 D06 D07 D08 D09 D10 D11 D12 D13 D14 D99 Leveret til net Forbrugt fra net Afregningsgrundlag/information Egenproduktion Netto fra net Netto til net Brutto forbrug Nettabskorrektion Elvarmemålepunkt Internt brug 10) NetSettlementGroup Følgende nettoafregningsgrupper kan returneres: Kode NSG0 Nettoafregningsgruppe Ingen nettoafregning NSG1 Nettoafregningsgruppe 1 NSG2 Nettoafregningsgruppe 2 NSG4 Nettoafregningsgruppe 4 NSG5 Nettoafregningsgruppe 5 NSG6 Nettoafregningsgruppe 6 11) DataAccessCVR Et sekundært CVR-nr., som kunden på målepunktet har fået tilknyttet til målepunktet via elleverandøren. Virksomheden med det pågældende CVR kan ligesom kunden på målepunktet få adgang til målepunktet via Eloverblik eller give tredjepartsadgang til målepunktet. Hvis der ikke findes noget dataadgangscvr, returneres null. 12) ConsumerCVR CVR-nummer på den kunde, som ejer målepunktet. Hvis dre ikke findes noget CVR, dvs. hvis målepunktet er ejet af en privatperson, returneres null. 13) Product Følgende energiproduktklassifikationskoder kan returneres: 14) SettlementMethod Følgende afregningsformer kan returneres: Kode D01 E01 E02 Afregningsform Flexafregnet Skabelonafregnet Timeafregnet Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 19/21

20 15) MeterReadingOccurrence Følgende aflæsningsfrekvenser kan returneres: Kode ANDET PT1H Aflæsningsfrekvens Andet Pr. time PT15M Kvarter P1M Måned 16) EnergyTimeSeriesMeasureUnit Følgende enheder kan returneres: Kode Dansk AMP H87 K3 KWH Z14 Ampere Antal styk kvarh kwh MAW MW MWH MWh TNE Z03 KWT KT (tarifkode) Tons MVAr kw 17) EstimatedAnnualVolume Angiver tallet for det samlede årsforbrug for målepunktet GET: /timeseries-kaldet Følgende data returneres med GET: /timeseries-kaldet: 1) Meteringpoint 18-cifret målepunktsid, som entydig identificerer et målepunkt. 2) DateFrom Angiver fra-datoen for aflæsningen i formatet åååå-mm-ddttt:mm:ss. 3) DateTo Angiver til-datoen for aflæsningen i formatet åååå-mm-ddttt:mm:ss. 4) Usage Den aflæste/målte værdi. 5) Unit Enhed for værdien, typisk kwh. Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 20/21

21 6) Type Angiver, om der er tale om en profiled måleværdi (skabelonaflæsning eller en non-profiled måleværdi (tidsserie). Dvs. de mulige værdier er altså: Profiled Non-profiled Skabelonaflæsninger (Type = Profiled) vil typisk bestå af måneds-, kvartals- eller årsaflæsninger (planlagte/periodiske/ordinære aflæsninger), men at de også kan være ekstra/aperiodiske aflæsninger, f.eks. i fbm. leverandørskift, skift af afregningsform eller målerskifte på et målepunkt. Tidsserier (Type = Non-profiled) vil i langt de fleste tilfælde bestå af timeværdier, men kan i enkelte tilfælde være månedsværdier. Sidstnævnte gælder kun visse specielle målepunktstyper, som man som tredjepart typisk ikke vil have behov for eller interesse i at hente data på. Dok. 15/ v. 5 Klassificering: Klassificering: Til arbejdsbrug/restricted 21/21