Til Danske netvirksomheder og elleverandører Datakonsistenstjek (v2) Beskrivelse af snitflader mellem Energinet.dk og netvirksomheder/elleverandører 21. oktober 2015 XPBE/XMSH/ Version 1.0 Dok. 13/100809-26 1/17
Indholdsfortegnelse 1. Overblik og formål... 3 2. Kommunikation og principper for filudveksling mellem aktør og Energinet.dk... 4 3. Serviceportal og opsætning af parametre for datasammenligning... 6 3.1 Opsætning af parametre på serviceportal... 6 3.2 Tilvalg af yderligere felter til konsistenstjek (de valgfrie)... 7 4. Kørsel af import og dataanalyse... 8 4.1 Formatbeskrivelse af dataeksport fra ekstern aktørs system... 8 4.1.1 Placering af filer på FTPS-server... 8 4.1.2 Fil for Metadata... 8 4.1.3 Snitflade for sammenligning af Masterdata (MASTERDATA fællessnitflade for både El og Net)... 10 4.1.4 Snitflade for sammenligning af kontaktadresser (CONTACT fællessnitflade for både El og Net)... 13 4.1.5 Snitflade for sammenligning af Abonnementer og tariffer (LINKS fællessnitflade for både El og Net)... 13 5. Resultat af datasammenligning (formater)... 14 5.1 Målepunktsuoverenstemmelser... 14 5.1.1 Formatet for MP_ uoverensstemmelser_links.csv... 15 5.1.2 Formatet for MP_ uoverensstemmelser_contact.csv. 15 5.2 Format for resultatfil... 16 5.2.1 Format af resultatfil for stamdatasammenligning (MASTERDATA fællessnitflade for både El og Net)... 16 5.2.2 Format af resultatfil for kontaktadressesammenligning (CONTACT fællessnitflade for både El og Net)... 17 5.2.3 Format af resultatfil for abonnement- og tarifsammenligning (LINKS fællessnitflade for både El og Net)... 17 Dok. 13/100809-26 2/17
1. Overblik og formål Energinet.dk tilbyder i dag aktørerne i markedet (elleverandører og netvirksomheder) en løsning for kontrol af datakonsistens mellem registreringer i aktørens system og registreringer i DataHub. Dette sker ved at aktøren indsender en fil til Energinet.dk, som herefter gennemfører en sammenligning; denne løsning betegnes som Datakonsistenstjek (v1). Energinet.dk fremsender resultatet af eventuelle afvigelser til aktøren, hvorefter det er aktørens ansvar at behandle disse. Datakonsistenstjek (v1) udfører alene kontrol på afregningsrelevante stamdatafelter, varierende efter om aktøren har rolle som netvirksomhed eller elleverandør. Datakonsistenstjek (v1) kan alene anvendes frem til 31. marts 2016. Med indførsel af Engrosmodellen 1. april 2016 sker der en betydelig udvidelse af stamdataoplysninger i DataHub og der tilføjes en række nye afregningsrelevante data. Denne berigelse er netvirksomhederne pt. godt i gang med gennem datamigreringen. Med Engrosmodellen er der behov for en konsistensløsning, hvor man kan gennemføre konsistenstjek på de nye felter, herunder ikke mindst priser og pristilknytninger. Løsningen betegnes som Datakonsistenstjek (v2). Da Datakonsistenstjek (v2) allerede nu kan anvendes til kontrol af migrerede data, vil Energinet.dk fra oktober 2015 stille denne løsning til rådighed for aktørerne. Datakonsistenstjek (v2) vil uden ændringer kunne anvendes efter 1.april 2016, hvor Datakonsistenstjek (v1) udgår. Datakonsistenstjek (v2) er i relation til stamdata opbygget som en udvidelse af antallet af felter i Datakonsistenstjek (v1). Herudover vil det i Datakonsistenstjek (v2) være muligt at tjekke konsistensen på samtlige stamdatafelter - altså ikke kun de afregningsrelevante, som det er tilfældet i Datakonsistenstjek (v1). I Datakonsistenstjek (v2) kan aktøren også udføre konsistenstjek af prislinks (obligatorisk efter 1. april 2016) samt konsistenstjek af kontaktoplysninger. Tjek af prislinks og kontakter sker ved indsendelse af særskilte filer se mere afsnit 2, 4 og 5. BEMÆRK Et Datakonsistenstjek giver ingen garanti for datakvalitet - konsistens er alene sikkerhed for, at indholdet er lige godt eller dårligt i såvel aktørsystemet som DataHub. Aktøren skal derfor på anden vis sikre sig at kvaliteten af data er i orden. Dok. 13/100809-26 3/17
2. Kommunikation og principper for filudveksling mellem aktør og Energinet.dk Datakonsistenstjekket er baseret på, at aktøren indsender data ved hjælp af filer til et selvstændigt datakonsistenssystem. Udveksling af filer vedrørende datakonsistens sker via den almindelige FTPS-server på adressen: ftps.energinet.dk Når aktøren ønsker at anvende det nye datakonsistenssystem fremsender Energinet.dk brugernavn og login. Henvendelser eller spørgsmål vedrørende datakonsistens sker på: datakonsistens@energinet.dk Der udføres alene konsistenstjek på aktuelle data dvs. den indsendte fil er et øjebliksbillede til kontrol mod registreringer i DataHub. Energinet.dk danner udtræk fra DataHub fra samme tidspunkt dog mindst 24 timer senere. Når Energinet.dk venter 24 timer er det for at sikre, at eventuelle aktørbeskeder afsendt op til dannelsen af filen er modtaget og registreret i DataHub. Ud over denne tidsforskydning vil afvikling af konsistenstjek desuden alene ske uden for normal arbejdstid. For aktøren vil et flow derfor se således ud: Energinet. dk modtager fil med angivelse af udtræk sket tirsdag kl. 17:00 Tidligst onsdag kl. 17:00 danner Energinet.dk fil med data i Datahub tirsdag kl. 17.00. Onsdag kl. 24.00 Afvikling af sammenligning Torsdag morgen: Svarfiler klar til aktør Figur 1: Tidsforskydning ved udtræk af filer BEMÆRK Energinet.dk anbefaler, at aktøren trækker fil til datakonsistens umiddelbart efter afsendelse af stamdatabeskeder til Datahub. Energinet.dk indlæser løbende de modtagne filer og gør disse klar til behandling, jf. ovenstående figur. Efter indlæsning modtager aktøren en kvitteringsmail, alternativt en fejlbesked hvis filen ikke kan indlæses. Datoer fra før 2013-01-01 kan af historiske årsager ikke forventes at være konsistente mellem de eksterne aktørers systemer og DataHub. Derfor vil afvigelser blive ignoreret i de tilfælde, hvor både datoen fra aktørsystemet og datoen fra DataHub er ældre end 2013-01-01. Dette sker for at undgå store mængder af afvigelser på gamle datoer. Følgende filer udveksles mellem Energinet.dk og de eksterne aktører: Filer ind (til Energinet.dk fra ekstern aktør) Dok. 13/100809-26 4/17
o Metadata-fil (oplysning om tidspunkt for udtræk) o Aktørens udtræk af stamdata på målepunkter o Aktørens udtræk af prislinks på målepunkter o Evt. aktørens udtræk af kontakter på målepunkter Filer ud (fra Energinet.dk til ekstern aktør) disse kommer i op til tre typer for hver konsistenssammenligning o MP_ uoverensstemmelser_<filtype>.csv med konstaterede uoverensstemmelser mellem målepunktsnumre indeholdt i aktørens fil og målepunktsnumre tilhørende aktøren i DataHub. o Sammenligning_<FILTYPE>.csv med fundne datadifferencer i stamdata o Fejl (error.txt) Hvis indlæsning af den leverede fil fra den eksterne aktør er fejlet (fx grundet uoverensstemmelse i filformat) genereres en fil med oplysninger om fejlen (Err01). Denne vil være at finde på FTPS -server i samme folder, hvori importfilen oprindeligt blev placeret af den eksterne aktør. Der vil tillige i dette tilfælde blive fremsendt e- mail med oplysning om, at der er sket en fejl. Udvekslingsfilerne skal gemmes i UTF8 semikolonsepareret format. Det er derfor vigtigt at eventuelle semikolontegn, som indgår som data, slettes inden fremsendelse til konsistenstjek. Det samme gør sig gældende for linjeskift og cursor retur ( \r \n (0x0A og 0x0D)). Såfremt disse ikke slettes, kan det medføre flere fejl, herunder at indlæsningen af den fremsendte fil fejler. Som eventuel decimaltalsseparator anvendes "." Format for filer og mappestruktur er nærmere beskrevet under afsnit 4 og 5, ligesom den gældende formatbeskrivelse kan findes på hjemmesiden eller ved at klikke her. Efter endt sammenligning af data vil der blive fremsendt en e-mail til den eksterne aktør med overordnet status på sammenligningen. På serviceportalen er det muligt at angive kontakt-e-mail for notifikationsmail. Herom mere i afsnit 3.1. Fortrolige detaljer vil ikke blive fremsendt via e-mail. Gennem serviceportalen vil det for den enkelte aktør være muligt dels at definere opsætning, dels at se information om de individuelle kørsler. Endelig er der adgang til analyse/status over de seneste kørsler. Figur 2: Snitflader mellem Energinet.dk og ekstern aktør Dok. 13/100809-26 5/17
3. Serviceportal og opsætning af parametre for datasammenligning Den eksterne aktør gives via websitet https://services.datahub.dk mulighed for at ændre konfigurationen for datakonsistenssammenligningen via en parameteropsætning. I det følgende beskrives de enkelte muligheder og deres konsekvens for datasammenligningen. 3.1 Opsætning af parametre på serviceportal I udgangspunktet er datakonsistenstjekket en hård 1:1 sammenligning mellem data i den indsendte fil og produktionsdata i DataHub på samme dato, som indsendelsesfilen er trukket. Er der forskel i registrerede værdier, vil dette resultere i at værktøjet giver en konsistensfejl. Via menuen Indstilling (se skærmbillede nedenfor) har aktøren mulighed for at justere hårdheden af datasammenligningen på nogle parametre, ligesom det er muligt at vælge nogle af de nye felter til. Figur 3: Skærmbillede over menu i datasammenligning Forskellig fortolkning af slut- og starttidspunkt, anvendelse eller manglende anvendelse af UTC-tid m.m. er desværre en væsentlig kilde til forskelle i tidsangivelser. Ved at afkrydse feltet Ignorer dataforskelle på +/- 24 timer, resulterer differencer, som ligger inden for dette tidsrum, ikke i en konsistensfejl. Afkrydses feltet Accepter %-afvigelse på Estimeret årsforbrug, er det muligt at angive en procent i intervallet 5 25%. Feltet er en mulighed for at acceptere mindre afvigelser i det estimerede årsforbrug uden at dette giver konsistensfejl. Anvendelse af ovenstående optioner øger dog samtidig risikoen for at reelle konsistensfejl overses, og brugen heraf bør derfor nøje vurderes. Ved at afkrydse feltet Anvend engelske kolonnenavne i output filer vil de modtagne resultatfiler have engelske kolonnebetegnelser. Dok. 13/100809-26 6/17
Feltet Generér læsevenlig resultatfil har alene betydning for Datakonsistenstjek (v1). I Datakonsistenstjek (v2) modtager aktøren altid værdier for samtlige felter, hvis der er inkonsistens på et af de obligatoriske felter eller ved tilvalg af valgfrie felter til konsistenskontrol. I feltet Anvendt emailadresse for notifikationer har du mulighed for at angive de emailadresser, som notifikationer fremsendes til i relation til datakonsistens. Der kan angives mere end én mailadresse disse skal i så fald være adskilt med et semikolon. Opsætningen gemmes og vil således være gældende indtil aktøren evt. måtte ændre i parameteropsætningen. 3.2 Tilvalg af yderligere felter til konsistenstjek (de valgfrie) I Datakonsistenstjek (v2) kan der gennemføres konsistenstjek på næsten alle felter (se screen dump nedenfor). Obligatoriske felter skal indsendes og vil altid blive konsistenstjekket. For Links er alle felter obligatoriske, mens det for såvel filtyperne Masterdata og Contact er muligt at vælge de valgfrie felter til for konsistenstjek. Figur 4: Skærmbillede over valgfrie felter i konsistenstjek Først vælges snitflade; dvs. enten Masterdata eller Contact. For hvert af de valgfrie felter er det muligt at afkrydse dette for konsistenstjek. Det er endvidere muligt at vælge, at hvis indholdet af et felt er enten 0, null eller blankt, så skal konsistenstjekket opfatte disse som ens værdier. Kun valgfrie felter, der er afkrydset, kommer med i resultatfil. Dok. 13/100809-26 7/17
4. Kørsel af import og dataanalyse 4.1 Formatbeskrivelse af dataeksport fra ekstern aktørs system I forbindelse med indsendelse af data fra de eksterne aktører fremsendes altid mindst to filer (og maks. fem filer) til Energinet.dk. På Energinet.dk s FTPSserver opretter aktøren en folder med dato for udtræk, som beskrevet herunder. De fremsendte filer placeres i den netop oprettede folder. For at sikre datakvaliteten er det i forbindelse med udtræk af data fra det eksterne aktørsystem vigtigt at sikre, at udtrækket indeholder alle aktive målepunkter for udtrækstidspunktet. Ligeledes er det af afgørende betydning, at udtrækstidspunktet stemples korrekt i metadatafilen. Den samlede leverance fra den eksterne aktør til Energinet.dk vil således bestå af en metadatafil og en.csv-fil (pr. sammenligningstype), som rummer det egentlige dataindhold. I de følgende afsnit herunder er de respektive filtyper beskrevet mere i detaljer. 4.1.1 Placering af filer på FTPS-server Den eksterne aktør vil via sit login til FTPS-serveren få adgang til en undermappe, der beskriver aktørens identitet. Hvis aktør X således logger på FTPSserveren, kommer aktøren ind i en folderstruktur, der hedder: GLN-DDQ / DDM. Herunder opretter aktøren en mappe med tidsstempling for dataudtrækket Foldestruktur: <Org id(gln nr)-rolle(ddq,ddm)-d> (denne folder er givet af aktørens login, og kan ikke modificeres) <dato-tid(yyyy-mm-dd-hh-mi-ss)> (denne folder skal aktøren oprette) <csv-fil> <meta data fil> 4.1.2 Fil for Metadata Uagtet om der fremsendes data til sammenligning i snitfladerne før eller efter Engrosmodellen, skal der altid fremsendes en metadatafil. Metadatafilen skal rumme følgende oplysninger, som ligger fast: den fulde folderstruktur kommer derfor til at se ud som angivet nedenfor, selv om de eksterne aktører kun vil kunne se fra folderens rolle (DDQ,DDM) og nedefter. kolonne nr Feltnavn i fil Information Format Obligatorisk TimeStart 1 Export- Udtrækstidspunkt start yyyymm-dd hh:mi:ss Eksempel x 2014-10-20 14:28:00 3 ExecutedBy Udført af 40 (AN) Finn Jensen Tabel 1: Oplysninger i metadatafil Ex- eller portjob 2 Role Rolle 3 (AN) x DDQ (elleverandør), eller DDM (Netvirksomhed) Dok. 13/100809-26 8/17
Metadatafilen er en semikolonsepareret fil. På hjemmesiden findes et eksempel på filformatet. Eksemplet hedder 570000000015-DDM_metadata.csv. Eksempelfiler findes under mappen Eksempelfilen til Datakonsistenstjek (v2) vejledning klik her. Metadatafilen skal navngives således: <orgid>-<rolle(ddq/ddm)>_metadata.csv eksempel på navngivning: 5700000000085-DDQ _metadata.csv Da det til Datakonsistenstjek er muligt at indsende flere filtyper til sammenligning på samme tid, kan der være behov for at angive forskellige tidspunkter for udtræk. Dette er muligt ved at tilføje en ekstra kolonne per aktuel filtype, som vist nedenfor: specifikt udtrækstidspunkt for MASTERDATA Hvis specifikt udtrækstidspunkt ønskes opgivet for filen MASTERDATA tilføjes en kolonne ved navn MASTERDATAEXPORTTIME Det er ikke afgørende om denne kolonne ligger som nr. 4, 5 eller 6. Tidspunktet angives i formatet yyyy-mm-dd hh:mi:ss specifikt udtrækstidspunkt for CONTACT Hvis specifikt udtrækstidspunkt ønskes opgivet for filen CONTACT tilføjes en kolonne ved navn CONTACTEXPORTTIME Det er ikke afgørende om denne kolonne ligger som nr. 4, 5 eller 6. Tidspunktet angives i formatet yyyy-mm-dd hh:mi:ss specifikt udtrækstidspunkt for LINKS Hvis specifikt udtrækstidspunkt ønskes opgivet for filen LINKS tilføjes en kolonne ved navn LINKSEXPORTTIME Det er ikke afgørende om denne kolonne ligger som nr. 4, 5 eller 6. Tidspunktet angives i formatet yyyy-mm-dd hh:mi:ss Dok. 13/100809-26 9/17
Kolonne nr. 1 ExportTimeStart Udtrækstidspunkt start yyyymm-dd hh:mi: ss Feltnavn i fil Information Format Obligatorisk Eksempel X 2014-10-20 ell 2014-10-20 12:24:03 3 ExecutedBy Udført af 40 (AN) 4 MASTERDATAEXPORT TIME 5 CONTACTEXPORTTIM E Finn Jensen eller ExportJob Udtrækstidspunkt start for MASTERDATA Udtrækstidspunkt start for CONTACT 6 LINKSEXPORTTIME Udtrækstidspunkt start for LINKS yyyymm-dd hh:mi: ss yyyymm-dd hh:mi: ss yyyymm-dd hh:mi: ss Tabel 2: Eksempel på format for metadatafil med flere tidsangivelser 2 Role Rolle 3 (AN) X DDQ (elleverandør), eller DDM (Netvirksomhed) 2014-10-20 ell 2014-10-20 14:28:00 2014-10-20 ell 2014-10-20 15:52:25 2014-10-20 ell 2014-10-20 16:05:46 Såfremt der ikke specifikt opgives et tidspunkt for den aktuelle filtype, vil værdien i første kolonne (ExportTimeStart) blive anvendt i stedet. På hjemmesiden findes et eksempel på det udvidede filformat. Eksemplet hedder 5790002240447-DDQ_metadata.csv. Eksempelfiler findes under mappen Eksempelfilen til Datakonsistenstjek (v2) vejledning klik her. 4.1.3 Snitflade for sammenligning af Masterdata (MASTERDATA fællessnitflade for både El og Net) I forbindelse med indførelse af Engrosmodellen kommer der en række nye stamdatafelter. I den forbindelse er der udarbejdet en ny udvidet snitflade til fremsendelse af disse felter, og herved kan der også udføres konsistenstjek af nye felter. Masterdatafilen består af 75 felter, som skal medsendes evt. som blanke. Se eksempel nedenfor. Dok. 13/100809-26 10/17
Felt nr. Feltnavn Datatype Eksempel Obligatorisk (O) / Valgfri (V) om tjek skal udføres Netvirksomhed Elleverandør 1 Målepunkt ID number(18) 571313113161134029 O O 2 Målepunkttype string(3) E17 O O 3 Tilslutningsstatus string(3) E22 O V 4 Netområde nr. string(3) 023 O O 5 Netvirksomhed number(16) 5790001089030 V V 6 Fysisk målepunkt string(1) 1 V V 7 Nettoafregningsgruppe number(1) 1 O O 8 DE branchekode string(6) 1244 V V 9 Enhed string (3) KWH V V 10 Produkt string(13) 1234567890123 V V 11 Afregningsform string(3) E01 O O 12 Aflæsningsfrekvens string (5) PT15M V V 13 Forventet årsforbrug number(18) 13200 O O 14 Aflæsningsform string (3) D02 V V 15 Forbrug over grænse tilladt number(1) 1 V V 16 Indsendelsesfrekvens number(3) 30 V V 17 Vejkode string(4) 0004 V V 18 Vejnavn string(40) Aalborgvej V V 19 Husnummer string(6) 14 V V 20 Etage string(2) 2 V V 21 Dørbetegnelse string(4) th V V 22 By string(25) Stenrøgel V V 23 Postnummer string(10) 8620 V V 24 Postdistrikt string(25) Kjellerup V V 25 Kommunekode string(3) 740 V V 26 Land string(2) DK V V 27 Disponent 1 string(132) Finn Jensen V V 28 Fødselsdato 1 string(10) 1936-10-18 V V 29 Disponent 2 string(132) Anna Jensen V V 30 Fødselsdato 2 string(10) 1937-09-05 V V 31 CVR string(8) 12345678 V V 32 Fra net string(3) 023 O V 33 Til net string(3) 032 O V 34 VærksGSRN number(18) 571313113131313131 V V 35 Brændselsart string(1) 0 V V 36 PSO-fritaget string(1) 1 V V 37 Målepunktsart string (2) M1 V V 38 Planlagt måleraflæsningsdato 1 string(4) 0131 V V 39 Planlagt måleraflæsningsdato 2 string(4) 0228 V V 40 Planlagt måleraflæsningsdato 3 string(4) 0331 V V 41 Planlagt måleraflæsningsdato 4 string(4) 0430 V V 42 Planlagt måleraflæsningsdato 5 string(4) 0531 V V 43 Planlagt måleraflæsningsdato 6 string(4) 0630 V V 44 Planlagt måleraflæsningsdato 7 string(4) 0731 V V 45 Planlagt måleraflæsningsdato 8 string(4) 0831 V V 46 Planlagt måleraflæsningsdato 9 string(4) 0930 V V 47 Planlagt måleraflæsningsdato 10 string(4) 1031 V V 48 Planlagt måleraflæsningsdato 11 string(4) 1130 V V 49 Planlagt måleraflæsningsdato 12 string(4) 1231 V V 50 Webadgangskode string(35) 123X4K445 Ikke Relevant V 51 Elleverandør GLN string(16) 5790001406530 Ikke Relevant V 52 Elleverandør startdato Date 2015-02-01 (yyyy-mm-dd) Ikke Relevant O Dok. 13/100809-26 11/17
Felt nr. Feltnavn Datatype Eksempel Netvirksomhed Elleverandør 53 Balanceansvarlig Aktør Part GLN string(16) 5790001406530 Ikke Relevant O 54 Afbrydelsesart string (3) D01 V V 55 Tilslutningstype string (3) D01 V V 56 Effektgrænse Ampere number(3) 350 V V 57 Effektgrænse kw number(6) 3500 V V 58 Anlægskapacitet string(8) 6 V V 59 Parent målepunkts ID number(18) 571313113161134030 O O 60 TimeData string(1) 0 V V 61 Aftagepligt string(1) 1 Ikke Relevant V 62 Målepunktskommentar string(60) Bygning nr. 2 V V 63 Målepunktsart - engrosmodel string(3) D01 O O 64 Målercifre number(8,4) 5.2 V V 65 Måleromregningsfaktor number(12,4) 1.03 V V 66 Målerenhed string(3) KWH V V 67 Målernummer string(15) 303039 O O 68 Målertype string(3) D01 V V 69 Dataadgangs CVRnr. string(8) 22668845 V V 70 Elvarme string(1) 1 O O 71 Elvarmeafgiftsstartdato Date 2015-02-01 (yyyy-mm-dd) O O 72 Vaskeanvisning string (3) D01 V V 73 Tom Felt Blank 74 Tom Felt Blank 75 Fremtidig målepunkttype - engrosmodel. Udgår og erstattes af felt 2 1. april 2016 string(3) D05 Ikke Relevant V Figur 5: Felter i masterdatafil Obligatorisk (O) / Valgfri (V) om tjek skal udføres Felter markeret med O er obligatorisk at indsende for den respektive aktør. Et V angiver at feltet er valgfrit og kan vælges til under opsætning i serviceportalen. Såfremt et felt ikke er obligatorisk, og man ikke ønsker at udføre kontrol af feltet, indsendes dette felt blankt (tomt). Indsendes der værdier for valgfrie felter som ikke er valgt til, vil sammenligningsværktøjet ignorere feltet. Felter, som er skraveret med gråt, er ikke relevante fra 1.april 2016. Det er i den forbindelse vigtigt at understrege, at felternes manglende relevans ikke har nogen konsekvens for format af filen. Efter 1. april 2016 vil format fortsat bestå af 75 felter felter skraveret med gråt skal så blot indsendes uden værdi. BEMÆRK Hver record skal altså bestå af samtlige 75 felter semikolonsepareret. Felterne, der er markeret obligatorisk orange, er obligatoriske i Datakonsistenstjek (v2) efter 1. april 2016. Frem til 1. april 2016 er de orange felter valgfrie men skal med, hvis man ønsker at gennemføre et tjek af migrerede data. Ønskes de orange felter konsistenstjekket inden 1. april 2016, skal dette markeres under opsætning i serviceportal. Dataudtrækket fremsendes i CSV fil med følgende navngivning: <orgid>-<rolle>_masterdata.csv Eksempel: 5700000000085-DDQ_MASTERDATA.csv Dok. 13/100809-26 12/17
4.1.4 Snitflade for sammenligning af kontaktadresser (CONTACT fællessnitflade for både El og Net) Med indførsel af Engrosmodellen bliver det muligt at tilknytte fire kontaktadresser til et målepunkt. I den forbindelse er der udarbejdet en ny snitflade til fremsendelse af disse til konsistenstjek; nemlig Contact-filen, som består af 18 felter. Felt nr. Feltnavn Tabel 3: Felter i Contact-fil Datatype Eksempel Obligatorisk (O) / Valgfri (V) om tjek skal udføres 1 Målepunkt ID number(18) 579150000000000029 O 2 Adressetype string(3) D01 O 3 Kontakt navn 1 string(132) Anders Jensen V 4 Kontakt navn 2 string(132) Pia Jensen V 5 Identisk med MP Adresse number(1) 1 V 6 Vejkode string(4) 2335 V 7 Vejnavn string(40) Haydnsvej V 8 Husnummer string(6) 22 V 9 Etage string(2) St V 10 Dør string(4) C V 11 Postnr string(10) 7500 V 12 Postdistrikt string(25) Holstebro V 13 Supplerende bynavn string(25) Mejdal V 14 Kommunekode string(3) 661 V 15 Landekode string(2) DK V 16 Email string(60) 123@email.dk V 17 Tlf string(20) 12345678 V 18 Mobil string(20) 87654321 V Basalt er det valgfrit, hvorvidt aktøren ønsker at gennemføre konsistenstjek på kontaktadresser, men ønskes der gennemført konsistenstjek er felt 1 og 2 obligatorisk. Dataudtrækket fremsendes i CSV-fil med følgende navngivning: <orgid>-<rolle>_contact.csv Eksempel: 5700000000085-DDQ_CONTACT.csv 4.1.5 Snitflade for sammenligning af Abonnementer og tariffer (LINKS fællessnitflade for både El og Net) Foruden kontaktadresser er det i Engrosmodellen muligt at tilknytte tariffer, abonnementer og gebyrer på et målepunkt. I den forbindelse er der udarbejdet en ny snitflade til fremsendelse af disse til konsistenstjek. Filen til konsistenstjek af Links indeholder fem felter. Samtlige felter i denne snitflade er obligatoriske, ligesom det er obligatorisk at udføre konsistenstjek på links. Dok. 13/100809-26 13/17
Felt nr. Feltnavn Datatype Tabel 4: Fil til konsistenstjek af Links Eksempel Obligatorisk (O) / Valgfri (V) om tjek skal udføres 1 Målepunkt ID number(18) 579150000000000029 O 2 PrisTypeID string(10) B1-udveksl O 3 Antal number(9) 1 O 4 Aktør string(16) 5790001100520 O 5 Pristype string(3) D03 O Dataudtrækket fremsendes i CSV fil med følgende navngivning: <orgid>-<rolle>_links.csv Eksempel: 5700000000085-DDQ_LINKS.csv 5. Resultat af datasammenligning (formater) Når en aktør fremsender data til sammenligning, tager sammenligningsværktøjet på samme dato, som fremgår af den indsendte fil, et øjebliksbillede af Data- Hub. Alle de målepunkter som både er fremsendt af aktøren og findes i DataHub med tilknytning til pågældende aktør (den grønne fællesmængde i billedet herunder), vil blive sammenlignet. For hver filtype dannes en resultatfil, som har navnet Sammenligning_<Filtype>.csv. Figur 6: Sammenligning af data Ud over selve sammenligningen genereres også en fil, som viser hvilke målepunkter der ikke kunne sammenlignes. Det sker hvis målepunktet ikke kan findes i begge systemer. Dvs. at målepunkter som i figuren enten er i det blå eller gule medtages i en fil kaldet MP_uoverensstemmelser_<filtype>.csv. 5.1 Målepunktsuoverenstemmelser Formatet af denne fil vil være en semikolonsepareret.csv- fil. Filens navn: MP_uoverensstemmelser.csv (for snitfladen for Engrosmodellen vil filens navn være) MP_ uoverensstemmelser_masterdata.csv Dok. 13/100809-26 14/17
Efter endt sammenligning kan filen findes i den samme folder, som blev oprettet til kørslen (tidspunkt for dataudtræk fremgår her af mappenavnet). I filen vil identifikationsid et og årsagen til at målepunktet er med i filen fremgå. Nedenstående tre årsager kan findes: 1 : Målepunktet er ikke oprettet i DataHub. 2 : Målepunktet findes i DataHub, men er registreret under en anden aktør. 3 : Målepunktet står registreret i DataHub under den rette aktør, men målepunktet fremgår ikke af det fremsendte dataudtræk fra aktøren. Figur 7: Eksempel på resultatfil med uoverensstemmelser i målepunktregistrering BEMÆRK Der findes også en fil med uoverensstemmelser for Links og Kontaktadresser, som viser hvilke data, der ikke har kunnet sammenlignes. Princippet er for disse sammenligningstyper identisk, men eftersom målepunktsid et i disse tilfælde ikke alene udgør den unikke nøgle, ser formatet en smule anderledes ud. 5.1.1 Formatet for MP_ uoverensstemmelser_links.csv Filen vil indeholde målepunktsid, PristypeId, Aktør og Pristype for pågældende element. Herudover vil årsagskode og årsagsbeskrivelse tillige fremgå. Nedenstående to årsager kan findes: 1 : Linket blev ikke fundet i DataHub 2 : Linket blev ikke fundet i den fremsendte liste, men findes i DataHub Figur 8: Eksempel på resultatfil med uoverensstemmelser i målepunktsregistrering - links 5.1.2 Formatet for MP_ uoverensstemmelser_contact.csv I filen vil målepunktsid et og adressekoden for det manglende element fremgå. Herudover vil årsagskode og årsagsbeskrivelse tillige være at finde. Nedenstående to mulige årsager kan findes: 1 : Adressen blev ikke fundet i DataHub 2 : Adressen blev ikke fundet i den fremsendte liste, men findes i DataHub. Dok. 13/100809-26 15/17
Figur 9: Eksempel på resultatfil med uoverensstemmelser i målepunktsregistrering - contact 5.2 Format for resultatfil Formatet af denne fil vil være en semikolonsepareret.csv-fil. Resultatfilen placeres i den mappe på FTPS-serveren, som den eksterne aktør oprettede og placerede sit dataudtræk på. Resultatfilens navn: Sammenligning_<Filtype>.csv Formatet tilpasses i forhold til, om aktøren er en netvirksomhed eller elleverandør. 5.2.1 Format af resultatfil for stamdatasammenligning (MASTERDATA fællessnitflade for både El og Net) I resultatfilen vises alle målepunkter, hvorpå der er konstateret forskelle i data. For hver kolonne i den fremsendte Masterdatafil, findes der 3 kolonner i resultatfilen. Først vises hvilken værdi den eksterne aktør har fremsendt på målepunktet, herefter vises hvilken værdi der står i DataHub, og endelig findes en kolonne som angiver, om de to kolonner er identiske. BEMÆRK Alle felter, der ikke er udført sammenligning på, er tomme i resultatfilen. Dette er for at gøre filen mere overskuelig. Resultatfilens navn vil være følgende: Sammenligning_MASTERDATA.csv Se et eksempel på resultatfil med navnet Sammenligning_MASTERDATA.csv på hjemmesiden ved at klikke her. I dette eksempel er ikke alle felter blevet sammenlignet, hvorfor der ikke står data i alle felter. Dok. 13/100809-26 16/17
5.2.2 Format af resultatfil for kontaktadressesammenligning (CONTACT fællessnitflade for både El og Net) I resultatfilen vises alle målepunkter, hvorpå der er konstateret forskelle i data. For hver kolonne i den fremsendte CONTACT-fil, findes der tre kolonner i resultatfilen. Først vises hvilken værdi den eksterne aktør har fremsendt på målepunktet, herefter vises hvilken værdi der står i DataHub, og endelig findes en kolonne som angiver, om de to kolonner er identiske. BEMÆRK Alle felter, der ikke er udført sammenligning på, er tomme i resultatfilen. Dette er for at gøre filen mere overskuelig. Resultatfilens navn vil være følgende: Sammenligning_CONTACT.csv Eksempel på en resultatfil for kontakter hedder Sammenligning_CONTACT.csv. 5.2.3 Format af resultatfil for abonnement- og tarifsammenligning (LINKS fællessnitflade for både El og Net) I resultatfilen vises alle målepunkter, hvorpå der er konstateret forskelle i data. For hver kolonne i den fremsendte LINKS-fil, findes der tre kolonner i resultatfilen. Først vises hvilken værdi den eksterne aktør har fremsendt på målepunktet, herefter vises hvilken værdi der står i DataHub, og endelig findes en kolonne som angiver, om de to kolonner er identiske. Resultatfilens navn vil være følgende: Sammenligning_LINKS.csv Eksempel på en resultatfil for abonnement- og tarifsammenligning hedder Sammenligning_LINKS.csv. Dok. 13/100809-26 17/17