Datahub tapahtumat

2 (198) Sisällysluettelo Sisällysluettelo... 2 Muutoshistoria... 8 Määritelmät ja lyhenteet... 10 1 Johdanto... 17 1.1 Yleistä... 17 2 Yleiset rajapintamääritykset... 18 2.1 Nimiavaruus (namespace)... 18 2.2 Versiointi... 19 2.2.1 Sanomaversio... 19 2.2.2 Sanoman aliversio... 19 2.2.3 schemalocation... 19 2.3 Sanomarakenne... 20 2.3.1 Otsikko (header)... 20 2.3.2 Prosessi (process)... 21 2.3.3 Tapahtumatiedot (payload)... 21 2.4 Yleiset elementit... 21 2.4.1 Tunnusten ja koodilistojen ylläpitäjät... 21 2.4.2 Osapuolet ja mittausalueet... 22 2.4.3 Käyttöpaikkatunnukset... 22 2.4.4 Aikaleimat ja aikavälit... 22 2.4.5 Arvojen yksiköt... 22 2.4.6 Sanomien tunnukset... 23 2.5 Sanomavalidoinnit... 23

3 (198) 2.5.1 XML schema... 23 2.5.2 Prosessivalidoinnit... 23 2.5.3 Tapahtumavalidoinnit... 23 2.6 Kuittauskäsittely... 23 2.7 Kyselytapahtumat... 25 2.8 Sanomalista... 25 2.9 Peruutussanomat ja -tapahtumat... 29 2.10 Tapahtumien välitys... 30 2.11 Tapahtumien nouto... 31 2.12 Tapahtumien synkronisuus/asynkronisuus... 31 2.12.1 Asynkroniset haut... 32 2.13 Sanomaliikenteen salaus ja pakkaus... 32 3 DH-100-Asiakas- ja käyttöpaikkatietojen ylläpitoprosessit... 33 3.1 DH-111 Asiakastietojen päivitys-myyjä... 34 3.2 DH-112 Asiakastietojen päivityspyyntö - JVH... 38 3.3 DH-113 Asiakastietojen päivityspyyntö - 3.osapuoli... 41 3.4 DH-121 Käyttöpaikan luonti... 44 3.5 DH-122 Käyttöpaikkatietojen päivitys... 48 3.6 DH-123 Käyttöpaikan poisto... 50 3.7 DH-124 Käyttöpaikkatietojen päivityspyyntö... 52 3.8 DH-131 Käyttöpaikkatunnuksen selvitys... 55 3.9 DH-132 Käyttöpaikka ja asiakastietojen haku-nykyinen myyjä... 58 3.10 DH-133 Käyttöpaikka ja asiakastietojen haku-uusi myyjä... 61 3.11 DH-134 Käyttöpaikka ja asiakastietojen haku-jakeluverkonhaltija... 65 3.12 DH-135 Käyttöpaikka ja asiakastietojen haku-3. osapuoli... 68

4 (198) 4 DH-200-Mittaustiedon ylläpitoprosessit... 71 4.1 DH-211 Mittaustiedon ilmoitus... 71 4.2 DH-221, DH-222, DH-223 Mittaustiedon haut... 75 4.3 DH-212 Muistutus mittaustiedon ilmoituksesta... 78 5 DH-300-Sopimusprosessit... 79 5.1 DH-311 Ilmoitus uudesta sopimuksesta... 79 5.1.1 DH-311-1 Uuden sopimuksen tiedot... 82 5.1.2 DH-311-2 Uuden sopimuksen tiedot jakeluverkonhaltijalle... 86 5.1.3 DH-311-3 Ilmoitus myyntisopimuksen päättymisestä nykyiselle myyjälle... 87 5.1.4 DH-311-4 Ulosmuuttoilmoitus tuotantokäyttöpaikan myyjälle... 87 5.1.5 DH-311-5 Ilmoitus myyntisopimuksen peruuntumisesta tulevalle myyjälle... 87 5.1.6 DH-311-6 - DH-311-8 Asiakastietojen päivityksen välitys... 88 5.1.7 DH-311-9 Häviöihin kirjattujen kulutusten nollaus... 88 5.2 DH-312 Verkkosopimuksen vahvistaminen... 89 5.3 DH-321 Myyntisopimuksen tietojen päivitys... 93 5.4 DH-322 Verkkosopimuksen tietojen päivitys... 96 5.5 DH-323 Ilmoitus myyjättömästä käyttöpaikasta... 97 5.6 DH-331 Ilmoitus myyntisopimuksen päättymisestä... 98 5.7 DH-332 Sisäänmuuttokohteen myyjän ilmoitus asiakkaan ulosmuutosta... 101 5.8 DH-333 Ilmoitus verkkosopimuksen päättymisestä... 104 5.9 DH-340 Sopimuksen peruuttaminen... 107 5.9.1 DH-341 Ilmoitus myyntisopimuksen peruuttamisesta... 107 5.9.2 DH-342 Ilmoitus verkkosopimuksen peruuttamisesta... 109 5.9.3 DH-343 Edeltävän myyjän ilmoitus myyntisopimuksen palautuksesta kieltäytymisestä... 110

5 (198) 5.9.4 DH-344 Ilmoitus verkkosopimuksen päättymisestä peruutustilanteessa.... 111 6 DH-400-Kytkentä- ja katkaisuprosessit... 113 6.1 DH-411 Toimituksen kytkentäpyyntö... 113 6.2 DH-412 Ilmoitus toimituksen kytkennästä... 115 6.3 DH-421 Toimituksen katkaisupyyntö... 117 6.4 DH-422 Ilmoitus toimituksen katkaisusta... 119 6.5 DH-413, DH-423 Ilmoitus kytkennän tai katkaisun viivästymisestä... 121 7 DH-500-Taseselvitys... 123 7.1 DH-514, DH-522 Jakeluverkonhaltijan taseselvitystiedot... 124 7.2 DH-515, DH-521 Myyjän taseselvitystiedot... 128 7.3 DH-523 Häviöihin kirjattujen kulutusten ja tuotantojen haku... 131 8 DH-600-Tasevirheiden korjaus... 134 9 DH-700-Tuote- ja laskutustiedon ylläpitoprosessit... 137 9.1 DH-711, DH-712 Tuotetietojen päivitys... 138 9.2 DH-721, DH-722, DH-723 Tuotetietojen haku... 140 9.3 DH-731, DH-732 Laskurivitietojen ilmoitus... 142 9.4 DH-741, DH-742, DH-743 Laskurivitietojen haku... 144 10 DH-800-Valtuutukset... 147 10.1 DH-811, DH-812, DH-813 Asiakkaan valtuutuksesta ilmoitus osapuolelta... 147 10.2 DH-821, DH-822, DH-823 Asiakkaan antamasta valtuutuksesta ilmoitus osapuolelle. 149 11 DH-900-Osapuolitiedot... 151 11.1 DH-910 Osapuolitiedot... 151 11.2 DH-920 Osapuolitietojen haku... 154 12 Sanomatyyppien kuvaukset... 155 12.1 Otsikko... 155

6 (198) 12.2 Prosessi... 156 12.3 Tapahtumatiedot... 156 12.3.1 F01 Rakenteelliset tiedot, asiakas... 156 12.3.2 F02 Käyttöpaikkatunnuksen kysely... 158 12.3.3 F20 Käyttöpaikkalista... 158 12.3.4 E58 Rakenteelliset tiedot, käyttöpaikka... 160 12.3.5 F03 Käyttöpaikkatietokysely... 163 12.3.6 F21 Käyttöpaikkatiedot... 163 12.3.7 F04 Rakenteelliset tiedot, sopimus... 170 12.3.8 F05 Myyjätön käyttöpaikka... 175 12.3.9 F06 Rakenteelliset tiedot, sopimuksen päättäminen... 176 12.3.10 F18 Rakenteelliset tiedot, sopimuksen peruminen... 177 12.3.11 E66 Mittaustiedot... 178 12.3.12 F07 Mittaustietomuistutus... 180 12.3.13 F08 Mittaustiedon haku... 180 12.3.14 F09 Kytkentä-katko... 181 12.3.15 F10 Taseselvitystiedon haku... 183 12.3.16 E31 Taseselvitystiedot... 183 12.3.17 F19 Tasevirhetiedot... 185 12.3.18 F11 Rakenteelliset tiedot, tuote... 186 12.3.19 F12 Tuotetietojen haku... 188 12.3.20 F13 Laskurivitiedot... 188 12.3.21 F14 Laskurivitietojen haku... 189 12.3.22 F15 Valtuutustiedot... 190 12.3.23 F16 Osapuolitiedot... 191

7 (198) 12.3.24 F17 Osapuolihaku... 193 12.4 ACK Kuittaustapahtuma... 193 12.5 F99 Noutotapahtuma... 194 13 Koodilistat... 195

8 (198) Muutoshistoria Päivämäärä Versio Muutokset Muokattu määritelmää anto- ja ottoalueelle, mittausaikasarjalle sekä valtuutukselle. Lisätty määritelmät juridinen toimija, tekninen toimija, mittausvastuullinen alue, rinnakkainen alue ja sanomaliikenneasetus. Täydennetty lukuun 2.6 kuvausta erilaisten kuittausten käytöstä. Tarkennettu lukuun 2.11 sanomien noutomenettelyä. Täydennetty lukuun 2.12 kuvausta tapahtumien synkronisuudesta ja asynkronisuudesta sekä lisätty luku 2.12.1 Asynkroniset haut. Poistettu sanomissa asiointitapa asiakkaan tiedoista ja lisätty se sopimustietoihin. 1.4 Tarkennettu lukuun 4.1 että aikasarja-arvojen tulee olla positiivisia ja rajapisteille ilmoitetaan molemmat suunnat erikseen. Päivitetty tapahtumille DH-220 ja DH-740 uudet asynkronisen haun sekvenssikaaviot. Lisätty tuotteen tietoihin tuotteen kuvaus. Poistettu laskurivitiedoista tuotteen ja tuotekomponentin nimet. Muokattu osapuolitietoihin että osapuolella voi olla useita laskutusosoitteita. Lukuun 12 korjattu esimerkkejä erityyppisille tunnuksille. Uusittu sanoman F21 kuvaus luvussa 12.3.6. 31.5.2017 1.1 Dokumentti siirretty uudelle pohjalle. Terminologiaa korjailtu koko dokumentissa. Tekstiä sanoitettu uudelleen useassa osassa dokumenttia ja vanhentuneita tai ylimääräisiä kommentteja poistettu. Muokattu määritelmiä asiakas, jakeluverkonhaltija, käyttöpaikka, mittausalue, mittaustieto, osapuoli, rajapiste, tuntitieto, tuotantoyksikkö ja valtuutus. Lisätty määritelmät hinta-aikasarja, kalenteriaikasarja, markkinatasealue, mittausaikasarja, ohjattava kuorma, taseselvitysliitos, tasevirhe, tuotantolaite, tuotekomponentti ja varastolaite. Tarkennettu käytettävät tunnukset osapuolten, mittausalueiden ja käyttöpaikkojen tunnuksille (luvut 2.4.2 ja 2.4.3). Tarkennettu osittain hyväksytty -kuittaustyypin kuvausta luvussa 2.6. Sanomalistan (luku 2.8) sarakkeet päivittyneet. Lisätty luku 2.13 Sanomaliikenteen salaus ja pakkaus. Sanomataulukoiden tietokenttiä päivitetty yhtenevämmiksi prosessidokumentin kanssa. Tietokenttiä ja niiden tasoja muutettu keskenään yhteneväisiksi. Sanomat F02 ja F03 jaettu kahdeksi erilliseksi sanomaksi kumpikin. Entinen sanoma F02 on jaettu sanomiksi F02 (käyttöpaikkatunnuksen kysely) ja F20 (käyttöpaikkalista), sanoma F03 on jaettu sanomiksi F03 (käyttöpaikka- ja asiakastietojen haku) ja F21 (vastaus käyttöpaikka- ja asiakastietojen hakuun). Osoitetietojen vapaa teksti -tietokentät päivitetty osoitteen tarkenteiksi. Lisätty 3.osapuolen päivityspyynnöt asiakas- ja käyttöpaikkatiedoille lukuun 3. Täydennetty luvuissa 3.2 ja 3.3, että mikäli asiakkaalla ei ole datahubissa myyntisopimuksia, asiakastiedot päivitetään JVH:n päivityspyynnön pohjalta. Lisätty omat sanomataulukot asiakastietojen päivityspyynnöille lukuihin 3.2 ja uuteen lukuun 3.3. Lisätty asiakastietojen välitys jakeluverkonhaltijalle tapahtumaan DH-112 luvussa 3.2. Selvennetty toimintatapaa asiakas- ja käyttöpaikkatietojen päivityspyynnöissä luvuissa 3.2, 3.3 ja 3.7. Päivitetty tietokenttien pakollisuuksia käyttöpaikkatietojen päivityspyynnössä luvussa 3.7 ja käyttöpaikan rakenteellisten tietojen sanomassa luvussa 12.3.4. Käyttöpaikkatunnuksen selvityssanomaan F02 on lisätty käyttöpaikan tyyppi ja käyttöpaikan alityyppi -kentät luvuissa 3.8 ja 12.3.2. Käyttöpaikkalistasanomaan F20 on lisätty mittausalueen tietoja luvuissa 3.8 ja 12.3.3. Veroluokka on lisätty tapahtuman DH-133 vastaussanomaan luvussa 3.10. ja sanomatyyppiin F21 luvussa 12.3.6.

9 (198) Verkkosopimuksen tiedot on lisätty tapahtuman DH-135 vastaussanomaan luvussa 3.12. Mittaustiedon ilmoituksen sekvenssikaavio päivittynyt luvussa 4.1. Lisätty välitys rajapisteen toiselle osapuolelle. Lisätty tarkennus aikasarjan tunnukselle luvussa 4.1. Lisätty käyttöpaikan tyyppi mittaustietojen hakuun luvuissa 4.2 ja 12.3.13. Muutettu mittaustiedon hakua (huomautus 2 luvussa 4.2) siten, että pätö- ja loistehot palautetaan vain jos niille on annettu haussa yksikkö. Uuden myyntisopimuksen ilmoitusprosessiin lisätty tietojen välityksiä luvussa 5.1. Lisätty tulevaisuudessa alkavan sopimuksen peruutus, asiakastietojen päivitys ja häviöihin kirjattujen kulutusten nollaus. Poistettu sanomasta F04 tuotteen nimi luvuissa 5.1.1, 5.2 ja 12.3.7. Myyntisopimuksen päättymisprosessi päivittynyt luvussa 5.6. Lisätty tiedon välitys 3.osapuolelle ja tulevaisuudessa alkavan sopimuksen peruutus. Sopimuksen päättymisen syy muutettu pakolliseksi tiedoksi tapahtumassa DH-331 luvussa 5.6. Korjattu käyttöpaikan tilaan liittyvät kytkentä-katko sanoman validointisäännöt vastaamaan prosessidokumenttia luvussa 6. Lisätty uusi luku 7.3, jossa kuvataan DH-523 häviöihin kirjattujen kulutusten ja tuotantojen haku. Korjattu tapahtumassa käytettävät sanomatyypit. Lisätty huomautukset 1, 2 ja 3 lukuun 8 tasevirheiden ilmoittamiseen liittyen. Päivitetty sanoman F11 sisältöä luvuissa 9.1 ja 12.3.18 vastaamaan mallia, jossa tuotteella ja tuotekomponentilla voi olla useita erikielisiä nimiä. Muutettu laskurivitietojen ilmoitusta luvussa 9.3 siten, että jokaisella laskurivillä on alku- ja loppuaika sekä lisäksi ilmoituksella on kokonaislaskutusaikaväli. Poistettu maininta online palvelusta luvun 10.1 alusta. Lisätty luku 10.2, asiakkaan antamasta valtuutuksesta osapuolelle ilmoittaminen. Korjattu virheellinen sekvenssikaavio luvussa 11.1. Sanomatyypin F01 tietojen pakollisuuksia muutettu luvussa 12.3.1. 21.3.2016 1.0 Ensimmäinen virallinen versio Lisätty tuotantolajit, taseselvityslajit, käyttäjäryhmät, asiakkaan alityypit, mittaustavat ja mittausalueen tyypit lukuun 13. Lisätty laskutuskanaviin muu laskutuskanava. Lisätty tuotantolajeihin biovoima ja muu tuotanto.

10 (198) Määritelmät ja lyhenteet 3.osapuoli. Sähkön vähittäismarkkinoilla toimiva osapuoli, joka tekee palvelua toimijoille sekä asiakkaille. Aika-askel. Tieto, joka kertoo, millä aikatarkkuudella mittari rekisteröi mittaustietoja. Nykyinen taseselvityksessä käytettävä aika-askel on yksi tunti. Kirjoitushetkellä on käynnissä selvitykset siirtymisestä 15 minuutin aika-askeleeseen taseselvityksessä. Aikaleima. Mittaukseen liittyvä tieto, joka kertoo ajanhetken, jolle mitattu energia rekisteröidään. Antoalue. Mittausalue, josta sähköä siirretään ottoalueelle rajapisteiden mittaustietojen ja rajapistesummien ilmoituksissa. (Mittaustiedon) aikaleima. Mittaustiedon ajallinen kohdistusmerkintä, joka kertoo, minkä aikajakson tiedosta on kyse. Asiakas. Luonnollinen henkilö, yritys, yhdistys tai muu yhteisö esim. kunta, jolla on sähkönmyynti-, sähköntoimitus ja/tai sähkönostosopimus myyjän kanssa ja/tai verkkosopimus jakeluverkonhaltijan kanssa ja joka hankkii tai tuottaa sähköä pääasiassa omaan käyttöönsä. Avoin toimittaja. Toimija, joka toimittaa asiakkaalleen kaiken tämän tarvitseman sähkön tai tasapainottaa asiakkaan sähkön tuotannon ja hankinnan sekä käytön ja toimituksen erotuksen toimittamalla puuttuvan sähkömäärän tai vastaanottamalla ylijäämän kunkin tunnin aikana (Tässä yhteydessä asiakas voi tarkoittaa yllä määritetystä poiketen myös toimijoita). CET-aika. Keski-Euroopan aikavyöhyke (Central European Time). Datahub on sähkön vähittäismarkkinoiden keskitetty tiedonvaihtoratkaisu. ebix. European forum for energy Business Information exchange. Eurooppalainen järjestö, joka kehittää energia-alan tiedonvaihtoa. Edeltävä myyjä. Sähkönmyyjä, jonka myyntisopimus on päättynyt käyttöpaikalla uuden myyjän ilmoittaman uuden myyntisopimuksen seurauksena. esett. Yhteispohjoismaisesta taseselvityksestä vastaava organisaatio. esett ylläpitää Pohjoismaisen taseselvityksen käsikirjaa (engl. NBS Handbook) ET. Energiateollisuus ry on sähkö- ja kaukolämpöalaa edustava elinkeinopoliittinen ja työmarkkinapoliittinen etujärjestö. GLN (Global Location Number). GS1-järjestelmän tunniste, jolla yksilöidään osapuoli datahubissa. GLN-tunnus on 13-merkkinen tunniste, joka muodostuu GS1 yritystunnisteesta, vapaasti valittavista numeroista (3-5 kpl) sekä tarkistusnumerosta.

11 (198) GS1. Kansainvälinen yksilöllisiä organisaatiokohtaisia tunnisteita jakava organisaatio. Suomen maatunnus on 64. Maatunnus ja siihen yhdistetty GS1 Finland Oy:n asiakaspalvelun myöntämä yrityskohtainen tunnus on yhteisnimeltään GS1 yritystunniste (GS1 Company Prefix). Yritystunnisteen avulla voidaan muodostaa muita tunnisteita, kuten GLN- ja GSRN-tunnisteita. GSRN (Global Service Relation Number). GS1-järjestelmän tunniste, jolla yksilöidään käyttöpaikka datahubissa. GSRN tunnus muodostuu GLN-tunnuksesta, sarjanumerosta ja tarkistusnumerosta. Hinta-aikasarja. Määrittää tietyn tuotekomponentin hinnan kullekin säännölliselle aikavälille (esimerkiksi jokaiselle tunnille). Jakeluverkonhaltija. Osapuoli, joka hallinnoi yhtä tai useampaa jakelu- tai suurjännitteistä jakeluverkkoa ja joka harjoittaa luvanvaraista sähköverkkotoimintaa tässä verkossa. (Jakeluverkonhaltijan) taseselvitys. Taseselvitys jakeluverkonhaltijan ja tämän mittausalueiden osalta siten, kuin sähkömarkkinalaissa ja mittausasetuksessa on määritetty. Juridinen toimija. Sanomarajapinnan sanomissa on erikseen määritetty tiedon tekninen ja juridinen toimija. Tekninen toimija vastaa järjestelmäkäyttäjää, joka ilmoittaa tai vastaanottaa sanoman. Juridinen toimija on osapuoli, jonka tietoa sanoma sisältää. Kalenteriaikasarja. Määrittää ne ajanhetket, jolloin tietyn tuotekomponentin (kuten päivä- tai yösähkö) hinta on voimassa. Kuluttaja. Asiakas, joka on luonnollinen henkilö, ja joka hankkii tai tuottaa sähköä pääasiassa muuhun tarkoitukseen kuin harjoittamaansa elinkeinotoimintaa varten. Käyttöpaikka. Fyysiseen sijaintiin, esimerkiksi asuntoon, liittyvä käsite, joka yhdistää asiakkaan verkko- ja myyntisopimuksen kautta jakeluverkonhaltijaan sekä sähkön myyjään ja jossa sähkön kulutusta tai tuotantoa voidaan mitata. Liiketoimintaprosessi. Joukko toisiinsa liittyviä tehtäviä, joita tehdään määritellyn tavoitteen, esimerkiksi asiakkaan myyjän vaihdon, saavuttamiseksi Lukema (tai mittauslukema). Kumulatiivinen mittauslaitteiston rekisteröimä lukema. Lukemamittaus. Mittaus, joka rekisteröi kumulatiivisia lukemia ilman aikaleimatietoa. Läpilaskutus. Toimenpide, jossa myyjä tai jakeluverkonhaltija laskuttaa toiselta osapuolelta omat palvelunsa, jotka tämä osapuoli edelleen laskuttaa asiakkaalta. Markkinatasealue. Maantieteellinen alue, jolle sähkömarkkinat määrittävät yhteisen hinnan kullekin ajanhetkelle (eli hinta-aikasarjan). Markkinatasealue koostuu mittausalueista.

12 (198) (Markkina)prosessi. Tässä dokumentissa kuvattu toimijoiden välinen liiketoimintaprosessi, johon liittyy osapuolten välistä tiedonvaihtoa. Prosesseja ovat sopimusprosessit, kuten muutot ja myyjänvaihdot sekä mittaustiedon toimitus ja taseselvitys. Mittari. Laite tai laitteiden yhdistelmä, joka rekisteröi sähkön kulutuksen tai tuotannon. Mittari saattaa sisältää myös integroidun tai erillisen ohjauslaitteen, jolla voidaan ohjata käyttöpaikan sähkölaitteita tai esimerkiksi kerrostalon muita mittareita. Mittaus(aikasarja). Käsite, jolla tarkoitetaan tiettyyn mittauspisteeseen (käyttöpaikka, rajapiste tai tuotantoyksikkö) liittyviä mittaustietoja ja niihin liittyviä metatietoja, kuten aikasarjan tunnus. Mittausaikasarjat ovat aikasarjoja, joiden mittaustiedot perustuvat liiketoiminnallisesti sähkömittareiden rekisteröimään tietoon, yleensä sähkön kulutukseen tai tuotantoon. Mittausaikasarjoja kutsutaan myös lyhennetyssä muodossa mittauksiksi. Mittausalue. Jakeluverkonhaltijan hallinnoiman sähköverkon alue, joka sisältää mittauspisteitä (käyttöpaikkoja, rajapisteitä ja tuotantoyksiköitä). Mittausalueen rajaavat yksittäiset rajapisteet. Taseselvitys tehdään mittausalueen tasolla. Mittausasetus. Sähkömarkkinalain nojalla säädetty Valtioneuvoston asetus sähköntoimitusten selvityksestä ja mittauksesta (66/2009). Mittauspiste. Piste, jossa sähkön kulutusta, tuotantoa tai siirtoa voidaan määrittää. Määritys voi tapahtua mittaamalla, arvion perusteella tai laskennallisesti. Mittauspiste voi olla käyttöpaikka, rajapiste tai tuotantoyksikkö. Mittausrekisteri. Mittarin sisältämä looginen tai fyysinen kokonaisuus, joka rekisteröi tiettyä mittauskohdetta, kuten pätötehon antoa verkkoon tai loistehon ottoa verkosta. Rekisteri saattaa sisältää tuntitietoja tai lukemamittauksen kumulatiivisia lukemia. Mittaustiedon status. Status kertoo mittauksilla kerätyn tiedon luotettavuuden tiedon vastaanottajalle. Mittaustiedoille käytettäviä statuksia ovat puuttuva, epävarma, arvioitu, OK ja Korjattu-OK. Mittaustieto. Mittarin tuottama tai jakeluverkonhaltijan arvioima/laskema mittausaikasarjan yksittäinen tiettyä aikaväliä koskeva tieto, joihin taseselvitys sekä asiakkaiden laskutus perustuu. Mittausvastuullinen. Osapuoli, joka vastaa tietyn mittauspisteen mittaustietojen keruusta ja ilmoittamisesta datahubiin. Käyttöpaikkojen osalta mittausvastuullinen on aina jakeluverkonhaltija. (Rajapisteen) mittausvastuullinen alue. Rajapisteeseen liittyvistä kahdesta mittausalueesta se, joka on kyseisen rajapisteen osalta mittausvastuullisen osapuolen hallinnassa. (Sähkön)myyjä. Henkilö, yhteisö tai yhtiö, joka myy sähköä tai ostaa (tässä yhteydessä asiakkaan pientuotannon) sähköä.

13 (198) (Sähkön)myyntisopimus. Sopimus, jolla asiakas ostaa ja myyjä myy sähköenergiaa. Sähkön vähittäismyyntinä pidetään sähkönmyyntiä jakeluverkon kautta välittömästi sähkön käyttäjille tai välillisesti käyttäjille kiinteistön tai sitä vastaavan kiinteistöryhmän sisäisen verkon kautta. Myyntituote. Sähkönmyyjän omassa palvelussaan käyttämä sähkötuote. Nykyinen myyjä. Sähkönmyyjä, jonka kanssa asiakkaalla on voimassaoleva sähkönmyyntisopimus sopimusprosessiin liittyvällä käyttöpaikalla prosessin alkaessa. (Käyttöpaikan) Ohjattava kuorma. Tieto käyttöpaikalle asennetusta etäohjattavasta kuormasta (sähkölaitteesta) ja sen ominaisuuksista. Ottoalue. Mittausalue, jolle sähköä siirretään antoalueelta rajapisteiden mittaustietojen ja rajapistesummien ilmoituksissa. Osapuoli. Sähkön vähittäismarkkinoilla yhdessä tai useassa roolissa toimiva yritys tai yhteisö eli sähkömarkkinaosapuoli. Osapuoli voi olla myyjä, jakeluverkonhaltija tai 3.osapuoli ja osapuolella tulee olla sopimus Datahubin kanssa. (Sähkön)ostosopimus. Sopimus, jolla asiakas myy ja myyjä ostaa asiakkaan pientuotannon sähköenergiaa. Pientuotanto. Tarkoitetaan pienimuotoisen tuotantolaitoksen tai usean tuotantolaitoksen muodostamaa kokonaisuutta, joka käsitellään taseselvityksessä kulutustaseen puolella. Tällä hetkellä kulutustaseen puolella käsitellään tuotantolaitokset, joiden nimellisteho on enintään 1 MVA. Pientuotannon verkkopalvelusopimus. Erikseen tehtävä jakeluverkonhaltijan ja asiakkaan välinen sopimus sähkön syöttämisestä jakeluverkonhaltijan verkkoon. Profiili. Taseselvityksessä käytettävä mittaustietoon tai vuosikäyttöarvioon perustuva (tunti)aikasarja, joka muodostetaan niille mittauspisteille, joilla sähkön kulutusta, tuotantoa tai siirtoa ei rekisteröidä tunneittain (tai muulla taseselvityksessä käytettävällä aika-askeleella). Rajapiste. Kahden mittausalueen rajalla oleva piste, jossa näiden mittausalueiden välinen sähkön siirto mitataan tai muuten määritetään. Rajapistemittaus on mittaus, joka liittyy rajapisteeseen. (Rajapisteen) rinnakkainen alue. Rajapisteeseen liittyvistä kahdesta mittausalueesta se, joka ei ole kyseisen rajapisteen osalta mittausvastuullisen osapuolen hallinnassa. Sanomaliikenneasetus. Sähkömarkkinalain nojalla säädetty Valtioneuvoston asetus sähköntoimitusten selvitykseen liittyvästä tiedonvaihdosta (273/2016). Siirtotuote. ks. Verkkotuote Sisäänmuuttokohde. Käyttöpaikka, jonne asiakas on muuttamassa.

14 (198) Sopimuksen irtisanominen. Sopimuksen toisen osapuolen suorittama irtisanominen sopimuksessa määritettyjen ehtojen mukaisesti. Sopimuksen purkaminen. Yksipuolinen sopimuksen välitön purkaminen toisen osapuolen sopimusrikkomuksen tai muun purkamiseen oikeuttavan tapahtuman johdosta. Sopimusprosessi. Myyntisopimuksen solmimiseen ja ilmoittamiseen, sopimustiedon ylläpitämiseen, sopimuksen päättämiseen tai peruuttamiseen liittyvä markkinaprosessi. Sopimustieto. Käyttöpaikan tieto, joka kertoo, millä sähkönmyyjällä on voimassaoleva myyntisopimus kullekin aikavälille. Sähkömarkkinalaki. Merkittävin sähkömarkkinoita sääntelevä laki (588/2013). (Sähkö)tase. Taseselvityksessä määritettävä tunneittainen (tai muun taseselvityksessä käytettävän aika-askeleen mukainen) tieto toimijan sähkön tuotannon ja hankinnan sekä käytön ja toimituksen erotuksesta. (Mittausalueen) Tasepoikkeama. Mittausalueelle toimitetun ja sieltä pois siirretyn sähkön (sisältäen häviöt) summa. Jos raportoidut tiedot ovat oikein, laskennan tulos on nolla. (esett Handbookin määritelmä) Taseselvitys. Tarkoittaa kunkin taseselvitysjakson aikana toteutuneiden sähkökauppojen selvittämistä, jonka tuloksena saadaan kunkin sähkömarkkinoiden osapuolen sähkötase. Taseselvitysikkuna. Aika, jonka sisällä tuntitietoihin voidaan tehdä muutoksia ennen sähkötaseiden sulkeutumista. Taseselvitysliitos. Käsitteellinen tieto, joka yhdistää taseselvitysaikasarjan rakenteellisiin tietoihin (kuten mittausalue), joihin kyseessä oleva taseselvitysaikasarja liittyy. Tasetieto. Käyttöpaikkakohtainen tieto, joka kertoo, millä sähkönmyyjällä on voimassaoleva tasevastuu kullekin aikavälille. Tasetieto sisältää tasevirheiden korjaukseen liittyen myös edellä mainitun aikavälin tunneittaiset mittaustiedot. Tasevirhe. Taseselvitysikkunan ulkopuoliselle ajalle jääneen virheen jälkikäteen tehty korjaus, joka voi johtua käyttöpaikan virheellisestä mittaustiedosta tai myyjätiedosta. Tasevirheiden käsittely. Menettely, jossa suoritetaan rahallinen myyjä- ja mittausaluekohtainen korjaus taseselvitysikkunan sulkeutumisen jälkeen oikaistujen mittausvirheiden ja tasetietojen johdosta. Tasoituslaskenta. Nykyisin käytössä oleva lukemamittauskohteisiin liittyvä laskenta, jossa selvitetään sähkötaseeseen mittausasetuksessa määritetyllä tyyppikuormituskäyrämenettelyllä viedyn energian ja mittauksessa todetun energian erotus. Ennen hubin käyttöönottoa laskennan toteutuksesta vastaa jakeluverkonhaltija. Jakeluverkonhaltija laskuttaa tai hyvittää myyjää laskennan perusteella.

15 (198) Tekninen toimija. Sanomarajapinnan sanomissa on erikseen määritetty tiedon tekninen ja juridinen toimija. Tekninen toimija vastaa järjestelmäkäyttäjää, joka ilmoittaa tai vastaanottaa sanoman. Juridinen toimija on osapuoli, jonka tietoa sanoma sisältää. Toimija. Sähkönmyyjä, jakeluverkonhaltija tai mittausvastuullinen. (Sähkön)toimitus. Tarkoitetaan sähkön myyntiä käyttöä tai jälleenmyyntiä varten. (Sähkön)toimitussopimus. Sähköntoimitussopimus on sellainen myyjän ja asiakkaan välinen sopimus, jossa myyjä ottaa vastattavakseen myös verkkopalvelusta. Myyjä sopii tarvittaessa verkkopalvelusta jakeluverkonhaltijan kanssa. Tuntimittaus. Tarkoittaa tunneittain (tunnin aika-askeleella) tapahtuvaa sähkön määrän mittausta ja tämän mittaustiedon rekisteröintiä mittauslaitteiston muistiin. Tuntimitattu käyttöpaikka. Käyttöpaikka, jonne asennettu energiamittari rekisteröi ja toimittaa eteenpäin tuntitietoja. Tuntitieto. Mittaustieto, jossa mittauksen aikaväli on tunti.tuotantoyksikkö. Pohjoismaisessa taseselvityksessä käytettävä käsite, johon liittyy tuotantotaseen puolella käsiteltävää tuotantotietoa. (Sähkö)tuote. Myynti- tai verkkotuote Tuotekomponentti. Sähkötuotteeseen kuuluva tuotteen osa, jonka mukaan laskutetaan tietty osa kokonaispalvelusta. Ulosmuuttokohde. Käyttöpaikka, josta asiakas on muuttamassa pois. Uusi myyjä. Sähkönmyyjä, joka käynnistää sopimusprosessin tietylle käyttöpaikalle. Uusi myyjä voi olla samalla myös käyttöpaikan nykyinen myyjä. (Mittaustiedon) validointi. Tarkoittaa etäluettavilta mittalaitteilta kerättyjen mittaustietojen laadun tarkastamista, mikä tehdään yleensä mittaustiedon hallinta- tai luentajärjestelmässä. Tyypillisiä tarkastuksia ovat muun muassa puuttuvien tietojen toteaminen, negatiivisten arvojen tarkastaminen, ylisuurten tuntitehojen tarkastaminen ja pitkien nolla-arvosarjojen tarkastaminen. Valtuutus. Asiakkaan osapuolelle antama lupa saada tietoonsa itseensä liittyvää tietoa datahubista. Osapuolella tulee olla todiste (esimerkiksi valtakirja) asiakkaan antamasta valtuutuksesta. (Käyttöpaikan) Varastolaite. Tieto käyttöpaikalle asennetusta sähkön varastointiin, eli sähkön lataamiseen ja purkamiseen, soveltuvasta sähkölaitteesta ja sen ominaisuuksista. (Sähkö)verkkosopimus. Jakeluverkonhaltijan ja asiakkaan välinen sopimus, joka koskee asiakkaan tarvitsemaa verkkopalvelua. Verkkotuote. Jakeluverkonhaltijan verkkopalvelussa käyttämä sähkötuote.

16 (198) Yritysasiakas tai Yritys. Asiakas, joka ei ole kuluttaja-asiakas. Pääsääntöisesti yritysasiakas on asiakas, joka hankkii tai tuottaa sähköä osana yritystoimintaa. Yritysasiakkaalla voidaan kuitenkin tarkoittaa myös muuta oikeushenkilöä, kuten yhdistystä tai julkisyhteisöä.

17 (198) 1 Johdanto 1.1 Yleistä Tämä dokumentti sisältää datahubin tiedonvaihtoon liittyvät rajapintakuvaukset. Dokumentti perustuu datahubin liiketoimintaprosesseihin ja tietomalliin. Dokumentaatio on tuotettu tiiviissä yhteistyössä toimialan kanssa datahubin teknisen asiantuntijaryhmän toimesta. Toimialalle annettiin mahdollisuus myös kommentoida dokumenttia sen valmistuttua. Teknisen työryhmän jäseninä toimivat Fingridin projektiryhmän lisäksi seuraavat henkilöt: Jari Arve, Ari Hallikainen, Jari Hirvonen, Mikko Horsmanheimo, Marko Juslin Arttu Lahtinen, Esa Pietarinen Marjut Puukangas Joni Räsänen, Merja Toikko, Satapirkan Sähkö Oy Enoro Oy (työpajojen fasilitointi) Fingrid Oyj (ryhmän puheenjohtaja) Caruna Oy Fingrid Oyj Fortum Markets Oy Fingrid Oyj Fingrid Oyj Tieto Oyj Enfo Zender Oy Luvussa 2 on esitetty sanomiin ja tapahtumiin liittyviä yleisiä sääntöjä, jotka koskevat rajapintoja yleisesti. Luvuissa 3-11 on kuvattu eri datahub-tapahtumissa käytettävä tietosisältö, tapahtumien välitysketjut sekä alustavat tapahtumavalidoinnit. Dokumentissa esitetyt tapahtumavalidoinnit ovat alustavia ja validoinnit tullaan tarkentamaan järjestelmän suunnittelu- ja toteutusvaiheessa. Listattujen tarkistusten lisäksi tapahtumavalidoinnissa tarkistetaan tapahtumakohtaiset tietojen pakollisuudet ja enumeraatiot eli koodilistat. Virheellisistä tapahtumista palautetaan negatiivinen kuittaus. Luvussa 12 on kuvattu yleiset sanomatyypit, joilla luvuissa 3-11 kuvatut tapahtumat toteutetaan. XML-määritykset tullaan tekemään tämän luvun mukaisesti.

18 (198) 2 Yleiset rajapintamääritykset Rajapintamääritysten perustana on käytetty ebix -sanomamäärityksiä (www.ebix.org), yhteispohjoismaisen vähittäismarkkinan (Harmonised Nordic Retail project / HNR) sekä Norjan datahub-projektin (Elhub) määrityksiä ja dokumentaatiota. Yllä esitettyjä standardeja ja sanomamäärityksiä on sovellettu mahdollisuuksien mukaan. Suomen datahubin toiminnallinen kokonaisuus on kuitenkin huomattavasti laajempi, joten olemassa olevien määritysten suora sellaisenaan hyödyntäminen jää rajalliseksi. Elhubiin verrattuna Suomen datahubissa mallinnetaan tarkemmalla tasolla keskitetty asiakasrekisteri, myynti- ja verkkosopimusten tiedot, tuote- ja hintatiedot sekä laskurivitiedot. Lisäksi Suomen datahub perustuu kokonaisuudessaan tuntipohjaiseen mittaustietoon, kun Elhubissa käsitellään myös profiilikäyttöpaikkojen lukemamittauksia. Edellä kuvatuista syistä johtuen rajapintoihin on jouduttu tekemään merkittävä määrä kansallisia laajennuksia. Koska tarvittavien laajennusten määrä on merkittävä, on tietyissä tilanteissa myös yksinkertaistettu sanomarakennetta verrattuna ebixsanomamäärityksiin. Kuittaussanomana käytetään ebix-rakennetta hyödyntävää kuittaussanomaa, joka on määritelty datahubin tarpeisiin. 2.1 Nimiavaruus (namespace) XML-nimiavaruuden avulla yksilöidään sanomien ja tapahtumien elementit ja attribuutit. Datahubsanomissa käytetään nimiavaruudelle määritystä: urn:fi:datahub:mif:<package>:<message name>:<major version> Package - Käytetään seuraavia arvoja: Masterdata - Rakenteellisten tietojen päivityksiin liittyvät sanomat Metering - Mittaustietoihin liittyvät sanomat Billing - Laskutukseen liittyvät sanomat Query - Kyselyihin liittyvät sanomat Message name määrittää sanoman nimen. Major version määrittää sanomaversion, käytetään etuliitettä v. Lisäksi sanomaan määritellään nimiavaruus abie yleisille entiteeteille ja koodilistoille, joita käytetään sanomissa. Esimerkki:

19 (198) <rsm: MasterDataCustomer xmlns:rsm="urn:fi:datahub:mif:masterdata: MasterDataCustomer:v1" xmlns:abie="urn:fi:datahub:mif:common:aggregatedbusinessinformationentities:v1" <rsm:header> <abie:identification>123e4567-e89b-12d3-a456-426655440000</abie:identification> 2.2 Versiointi 2.2.1 Sanomaversio Sanomaversio esitetään xml-tiedoston nimiavaruusmäärityksissä. Sanomaversio tullaan päivittämään tilanteessa, jolloin sanomiin tehdään muutoksia, jotka eivät takaa enää taaksepäin yhteensopivuutta edelliseen sanomaversioon nähden. Tällaisia muutoksia ovat esimerkiksi: Enumeraatio-arvojen poistaminen tai muuttaminen Muutokset elementtien, tyyppien tai attribuuttien nimiin Muutokset sanoman rakenteeseen tai järjestykseen Pakollisten elementtien tai attribuuttien poistaminen tai lisääminen Elementtien tai attribuuttien muuttaminen pakolliseksi 2.2.2 Sanoman aliversio Sanomamäärityksiä voidaan päivittää aliversiolla ilman versiopäivitystä silloin, kun sanomien taaksepäin yhteensopivuus säilyy. Nämä muutokset esitetään XML-schema määrityksessä xsd:version attribuutilla schema-tiedostossa (.xsd). Enumeraatio-arvojen lisääminen Ei-pakolliset sanoman laajennukset 2.2.3 schemalocation Viittaus käytettävään schema-tiedostoon (.xsd) esitetään xsi:schemalocation määrityksessä muodossa <nimiavaruus> <xsd tiedosto>. Esimerkki: xmlns:xsi=http://www.w3.org/2001/xmlschema-instance xsi:schemalocation="urn:fi:datahub:mif:masterdata:masterdatacustomer:v1 MasterDataCustomer.xsd">

20 (198) 2.3 Sanomarakenne Kaikki datahubin sanomat rakentuvat seuraavista osista: Sanoman otsikkotiedot Prosessin tiedot Tapahtumatiedot 2.3.1 Otsikko (header) Sanoman otsikkotiedot sisältävät seuraavat tiedot. Tietokenttä Taso Pakollisuus Kommentti Huom: Otsikkotiedot 1 1..1 [1] Sanoman tunnus 2 1..1 Sanoman yksilöivä tunnus [2] Sanoman tyyppi 2 1..1 Sanoman luontiaika 2 1..1 Sanoman tekninen lähettäjä Sanoman juridinen lähettäjä Sanoman tekninen vastaanottaja Sanoman juridinen vastaanottaja 2 0..1 2 1..1 2 0..1 2 1..1 Lähettäjän reititystieto 2 0..1 Huom: [1] [2] [3] Tarkennus Yksittäiset kentät on kuvattu luvussa 12. Yksittäiset kentät on kuvattu luvussa 12. Yksittäiset kentät on kuvattu luvussa 12. Yksittäiset kentät on kuvattu luvussa 12. Lähettäjän asettama reititystieto Datahubin sanomaliikenteessä kaikille vastaanotetuille sanomille muodostetaan kuittaussanoma. Kuittauspyyntöä ei esitetä sanomaotsikossa. Sanoman tunnus tulee olla lähettäjäkohtaisesti aina yksilöllinen. Datahub hylkää sanoman, jos samalla sanoman tunnuksella on jo vastaanotettu sanoma samalta lähettäjältä. Uudelleenlähetys tehdään aina uudella sanomatunnuksella sekä korjatuille tiedoille että myös tilanteessa, jolloin lähetetään samat tiedot uudestaan. Sanoman teknisellä toimijalla tarkoitetaan osapuolta, joka toimittaa/vastaanottaa sanoman. Sanoman juridisella toimijalla tarkoitetaan osapuolta, jonka tietoja sanomassa käsitellään. Esimerkiksi jos palveluntarjoaja huolehtii mittaustiedon keruusta ja toimittamisesta datahubiin (jakeluverkonhaltijan puolesta), tekninen lähettäjä on palveluntarjoaja ja juridinen lähettäjä on jakeluverkonhaltija. Teknisellä toimijalla tulee olla aina juridisen toimijan valtuutus kyseiseen prosessiin. [3] [3] [3] [3] [4]

21 (198) [4] Sanoman lähettäjä voi asettaa reititystiedon sanomaan, joka palautetaan kuittaussanomassa. Reititystietoa voidaan hyödyntää vastaanotetun kuittauksen reitityksessä alkuperäisen sanoman lähettämälle järjestelmälle. Otsikon tarkempi kuvaus on esitetty luvussa 12.1. 2.3.2 Prosessi (process) Sanoman prosessitiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Prosessi 1 1..1 Prosessin tunnus 2 1..1 Tiedonvaihdon rooli 2 1..1 Toimiala 2 1..1 Sähkö Käytetään datahubin tapahtumatunnuksia (esim. DH- 111-1) Prosessitietojen tekninen kuvaus on esitetty sanomakuvausosiossa luvussa 12.2. 2.3.3 Tapahtumatiedot (payload) Prosesseihin liittyvät tapahtumat ja tietosisältö on kuvattu tapahtumakohtaisesti luvuissa 3-11. Tekniset kuvaukset yleisille sanomatyypeille, joilla luvuissa 3-11 kuvatut tapahtumat toteutetaan, on kuvattu luvussa 12.3. 2.4 Yleiset elementit Tässä kappaleessa kuvataan sanomiin ja tapahtumiin yleisesti sovellettavia sääntöjä. Säännöt pätevät kaikkiin jäljempänä esitettyihin tapahtumakuvauksiin, ellei yksittäisessä kuvauksessa erikseen muuta mainita. 2.4.1 Tunnusten ja koodilistojen ylläpitäjät Sanomissa ja tapahtumissa käytetään seuraavia tunnusten ja koodilistojen ylläpitäjiä: Tunnusten ylläpitäjät: EIC, schemeagencyidentifer = 305 GS1, schemeagencyidentifer = 9

22 (198) ebix ja kansallinen tunnus, schemeagencyidentifier = 260 Koodilistojen ylläpitäjät: UN/CEFACT, listagencyidentifer = 6 ISO, listagencyidentifer = 5 ebix, listagencyidentifer = 260. Kansallinen koodi, listagencyidentifer = NFI 2.4.2 Osapuolet ja mittausalueet Osapuolitunnusten osalta käytetään GS1-järjestelmän GLN-tunnuksia ja mittausalueiden osalta EIC-koodeja. 2.4.3 Käyttöpaikkatunnukset Käyttöpaikkatunnusten osalta käytetään GS1-järjestelmän GSRN-tunnuksia. 2.4.4 Aikaleimat ja aikavälit Kaikki aikaleimat esitetään UTC-ajassa (Coordinated Universal Time) ja XML-muodossa YYYY- MM-DDTHH:MM:SS+00:00 tai YYYY-MM-DDTHH:MM:SSZ. Esimerkki: 2015-06-12T21:00:00+00:00 2015-06-12T21:00:00Z Oletusarvoisesti voimassaoloajat (alkuaika ja loppuaika) asetetaan vuorokauden rajalle (Suomen virallinen aika). Mittaustiedoissa aikaleimat asetetaan täysille tunneille. Sanoman luontiajat (ja muut vastaavat tekniset tapahtuma-ajat) esitetään sekunnin tarkkuudella. Voimassaolojen päättymisajat (esim. sopimuksen päättymispäivämäärä) esitetään päättymisajanhetkenä. Esimerkiksi, jos sopimuksen viimeinen voimassaolopäivä on 31.12.2015, päättymisajanhetki on 2015-12-31T22:00:00+00:00 (Suomen virallisessa ajassa ajanhetki 01.01.2016 00:00). 2.4.5 Arvojen yksiköt Arvojen yksikkötunnuksina käytetään SI-järjestelmän mukaisia tunnuksia, esim kw, MW, kwh, MWh, kvar, Mvar, kvarh, Mvarh.

23 (198) 2.4.6 Sanomien tunnukset Sanomien tunnuksina käytetään UUID-tunnuksia (Universally Unique Identifiers). 2.5 Sanomavalidoinnit Datahub validoi sanomia alla esitetyillä kolmella eri tasolla. 2.5.1 XML schema XML schema validoinnissa sanoma tarkistetaan teknisellä tasolla schemaa vastaan. Validointi tarkistaa sanomarakenteen, elementtien ja attribuuttien pakollisuuden ja tietomuodon oikeellisuuden (formaatti ja kentän maksimipituus) sekä tietojen enumeraatiot. Virhetilanteessa palautetaan SOAP tason hylkäys (SOAP Fault). 2.5.2 Prosessivalidoinnit Prosessivalidoinnissa tarkastetaan prosessitason tiedot, prosessin tunnus ja rooli sekä osapuolen oikeudet ilmoittaa kyseinen prosessitapahtuma. Sanomien lähettäjien roolit on listattu kappaleessa Sanomalista. Virhetilanteessa palautetaan SOAP tason hylkäys (SOAP Fault). 2.5.3 Tapahtumavalidoinnit Tapahtumavalidointi sisältää tapahtumakohtaiset, markkinaprosessin mukaiset validoinnit, joita ei XML schema - ja prosessivalidoinneissa validoida. Tapahtumavalidoinnissa validoidaan ilmoituksen attribuuttien välisien riippuvuuksien ja aikarajojen täyttymistä. Lisäksi ilmoitettuja arvoja validoidaan datahubin tietosisältöä vasten. Validoinnit läpäisseelle tapahtumalle palautetaan positiivinen kuittaussanoma. Virheellisille sanomille palautetaan negatiivinen kuittaus sisältäen virheilmoituksen (virhekoodi ja virheteksti). Tapahtumavalidoinnin yhteydessä validoidaan myös ilmoitettujen attribuuttien arvot datastandardin sarakkeessa "sallitut arvot" määriteltyjä sääntöjä vasten. Suomalaisen henkilötunnuksen tulee esimerkiksi täyttää sille lainsäädännön asettamat vaatimukset (http://www.finlex.fi/fi/laki/ajantasa/2010/20100128). Tapahtumakohtaisissa kuvauksissa (luvut 3-11) on listattu kyseiseen tapahtumaan liittyvät tapahtumavalidoinnit. 2.6 Kuittauskäsittely Datahub kuittaa osapuolten pyyntöihin kahdella eri tasolla: teknisellä tasolla sekä prosessitasolla. Teknisellä tasolla datahubin rajapinta vastaa aina jokaiseen osapuolen pyyntöön ilmoittaen, onko pyyntö ymmärretty ja kokonaisuudessaan vastaanotettu vai ei. Tämä on rajapinnan ns. tekninen

24 (198) kuittaus, joka on erillinen esimerkiksi sekvenssikaavioissa esitetyistä liiketoiminnallisista ns. prosessitason kuittauksista. Näitä teknisiä kuittauksia ei ole mallinnettu sekvenssikaavioihin. Datahub toimittaa vastaanotetuille sanomille aina joko positiivisen tai negatiivisen kuittauksen myös prosessitasolla. Kyselytapahtumissa palautettavat tiedot toimivat positiivisena kuittauksena ja virhetilanteesta palautetaan negatiivinen kuittaussanoma. Negatiivisessa kuittauksessa ilmoitetaan luvussa 2.5 kuvattujen prosessi- ja tapahtumavalidoinnissa ilmentyneet virheet. Synkronisten palveluiden osalta prosessitason kuittaus palautetaan osapuolelle sen jälkeen, kun datahub on kokonaisuudessaan käsitellyt palvelupyynnön. Asynkronisten palveluiden osalta datahub palauttaa ensin teknisen kuittauksen pyynnön hyväksynnästä ja myöhemmin asynkronisen prosessitason kuittauksen itse tapahtuman käsittelystä. Asynkroniset palvelut ja niiden kuittauskäsittelyt on kuvattu tarkemmin luvussa 2.12. Datahub-rajapinnassa käytetään aina kuittaussanomaa siten, että sanoman otsikkotiedoissa ei määritellä erikseen, halutaanko kuittaus vai ei. Noudettaessa sanomia datahubista noutavan osapuolen tulee kuitata sanomien vastaanotto erillisellä kuittaussanomalla luvussa 2.11 kuvatun mukaisesti. Datahub-rajapinnassa sovelletaan prosessitason kuittauksissa ebix-rakenteen mukaista kuittaussanomaa, joka sisältää otsikon, prosessin ja kuittaustapahtuman. Sanoman prosessiosio on sisällöltään sama kuin kuitattavassa alkuperäisessä sanomassa. Kuittaustapahtuman sisältö on seuraava. Tietokenttä Taso Pakollisuus Kommentti Huom: Kuittaustapahtuma 1..9999 Kuittausaika 1 1..1 Alkuperäisen sanoman tunnus Alkuperäisen sanoman lähettäjä 1 1..1 1 1..1 Selite 1 0..1 Tapahtumatason kuittaus 1 1..n Kuittauksen tyyppi 2 1..1 Kuittauksen teksti 2 0..1 Päivityksen tyyppi 2 0..1 Hyväksytty Osittain hyväksytty Hylätty Virheteksti, jos tapahtuma ei ole hyväksytty Sopimuksen vaihto Myyjän vaihto Sisäänmuutto [1] [2] Aikasarjatason kuittaus 2 0..9999 Käytetään vain mittaustiedolle

25 (198) Lähettäjän aikasarjatunnus 3 1..1 Kuittauksen tyyppi 3 1..1 Virhekoodi Kuittauksen teksti 3 1..1 Virheteksti Huom: [1] [2] Tarkennus Osittain hyväksytty-kuittaustyyppiä käytetään mittaustietosanomissa datahubin vastaanottaessa mittaustietoja. Tällöin hylätyt aikasarjat raportoidaan aikasarjatason kuittauksessa. Haettaessa mittaustietoja datahubista tätä kuittaustyyppiä ei käytetä Osittain hyväksytty - kuittaustyyppiä käytetään myös asiakas ja käyttöpaikkatietojen valtuutuksessa, mikäli asiakkaalla ei ole sopimusta osapuolen valtuutusilmoituksessa (DH- 810) ilmoitettuun käyttöpaikkaan. Tällöin ilmoittava osapuoli saa valtuutuksen ainoastaan asiakkaan tietoihin. Käytetään positiivisessa kuittauksessa ilmaisemaan päivityksen tyyppi datahubissa. Esim: Uuden myyntisopimuksen kuittauksessa palautetaan datahubin päättelemä myyntisopimuksen syy (sopimuksen vaihto, myyjän vaihto, sisäänmuutto). Kuittaussanoman tekninen kuvaus on esitetty luvussa 12.4. 2.7 Kyselytapahtumat Kyselytapahtumien tekstimuotoisissa tietokentissä arvot voidaan syöttää sekä isoilla että pienillä kirjaimilla. Haku ei tee eroa isojen ja pienten kirjainten välillä. Käyttöpaikkatunnuksen selvitys-haussa tuetaan kadunnimen hakuarvossa tähteä (*) jokerimerkkinä arvon alussa ja lopussa (esim Syy*, *riankatu, *yy*ia*). Jokerimerkkiä tuetaan myös talonumero ja porrastunnus -kentille. 2.8 Sanomalista Alla olevassa taulukossa on esitetty yhteenveto markkinaprosessien tapahtumista ja niissä käytettävistä sanomista. Taulukon sanoma-sarake viittaa yleisiin sanomatyyppeihin. Yleistä sanomatyyppiä voidaan hyödyntää yhdessä tai useammassa markkinaprosessissa. Luvussa 12 kuvataan näiden sanomatyyppien tietosisältö, tietokenttien formaatti, esimerkkitieto, tiedon XMLviittaus sekä tietokenttien tasot ja pakollisuudet XML-sanoman ja scheman kannalta. Prosessikohtaiset tietosisällöt, tietokenttien tasot ja pakollisuudet sekä prosessikohtaiset kommentit on esitetty luvuissa 3-11. Aikasarjatyyppisissä sanomissa käytetään NBS-määritysten pohjalta sovellettuja ebix-sanomia (E66 mittaustiedoille ja E31 taseselvitystiedoille). Muiden tapahtumien osalta riittävää vastaavuutta ebix-määrityksistä löytyi vain käyttöpaikan rakenteellisille tiedoille (E58). Muiden sanomien osalta on päädytty määrittämään erikseen kansalliset datahub -sanomat (Fxx sanomat).

26 (198) Prosessi Lähettäjä Vastaanottajat Sanomatyypin tunnus Sanomatyypin kuvaus Datahub DH-111 Asiakastietojen päivitys-myyjä Myyjä Jakeluverkonhaltija Myyjä F01 Rakenteelliset tiedot, asiakas 3. osapuoli DH-112 Asiakastietojen päivityspyyntö Jakeluverkonhaltija Datahub Myyjä F01 Rakenteelliset tiedot, asiakas DH-121 Käyttöpaikan luonti Jakeluverkonhaltija Datahub E58 Rakenteelliset tiedot, käyttöpaikka DH-122 Käyttöpaikkatietojen päivitys Jakeluverkonhaltija Datahub Myyjä 3. osapuoli E58 Rakenteelliset tiedot, käyttöpaikka DH-123 Käyttöpaikan poisto Jakeluverkonhaltija Datahub E58 Rakenteelliset tiedot, käyttöpaikka DH-124 Käyttöpaikkatietojen päivityspyyntö Myyjä Datahub Jakeluverkonhaltija E58 Rakenteelliset tiedot, käyttöpaikka DH-131 Käyttöpaikkatunnuksen selvitys Myyjä Jakeluverkonhaltija 3. osapuoli Datahub F02 F20 Käyttöpaikkatunnuksen kysely Käyttöpaikkalista DH-132 Käyttöpaikka ja asiakastietojen hakunykyinen myyjä Myyjä Datahub F03 F21 Käyttöpaikkatietokysely Käyttöpaikkatiedot DH-133 Käyttöpaikka ja asiakastietojen haku-uusi myyjä Myyjä Datahub F03 F21 Käyttöpaikkatietokysely Käyttöpaikkatiedot DH-134 Käyttöpaikka ja asiakastietojen hakujakeluverkonhaltija Jakeluverkonhaltija Datahub F03 F21 Käyttöpaikkatietokysely Käyttöpaikkatiedot DH-135 Käyttöpaikka ja asiakastietojen haku-3. osapuoli 3. osapuoli Datahub F03 F21 Käyttöpaikkatietokysely Käyttöpaikkatiedot DH-211 Mittaustiedon ilmoitus Jakeluverkonhaltija 3. osapuoli Datahub Myyjä 3. osapuoli E66 Mittaustiedot DH-221, DH-222, DH- 223 Mittaustiedon haut Myyjä Jakeluverkonhaltija 3. osapuoli Datahub F08 Mittaustiedon haku DH-212 Muistutus mittaustiedon toimituksesta Datahub Jakeluverkonhaltija F07 Mittaustietomuistutus DH-311 Ilmoitus uudesta sopimuksesta Myyjä Datahub Jakeluverkonhaltija (Myyjä) F04 Rakenteelliset tiedot, sopimus

27 (198) Prosessi Lähettäjä Vastaanottajat Sanomatyypin tunnus Sanomatyypin kuvaus DH-312 Verkkosopimuksen vahvistaminen Jakeluverkonhaltija Datahub Myyjä F04 Rakenteelliset tiedot, sopimus DH-321 Myyntisopimuksen tietojen päivitys Myyjä Datahub Jakeluverkonhaltija F04 Rakenteelliset tiedot, sopimus DH-322 Verkkosopimuksen tietojen päivitys Jakeluverkonhaltija Datahub Myyjä F04 Rakenteelliset tiedot, sopimus DH-323 Ilmoitus myyjättömästä käyttöpaikasta Datahub Jakeluverkonhaltija F05 Myyjätön käyttöpaikka DH-331 Ilmoitus myyntisopimuksen päättymisestä Myyjä Datahub Jakeluverkonhaltija Myyjä F06 Rakenteelliset tiedot, sopimuksen päättäminen DH-332 Sisäänmuuttokohteen myyjän ilmoitus asiakkaan ulosmuutosta Myyjä Datahub Jakeluverkonhaltija F06 Rakenteelliset tiedot, sopimuksen päättäminen DH-333 Ilmoitus verkkosopimuksen päättymisestä Jakeluverkonhaltija Datahub Myyjä F06 Rakenteelliset tiedot, sopimuksen päättäminen DH-341 Ilmoitus myyntisopimuksen peruuttamisesta Myyjä Datahub Jakeluverkonhaltija Myyjä F18 Rakenteelliset tiedot, sopimuksen peruminen DH-342 Ilmoitus verkkosopimuksen peruuttamisesta Jakeluverkonhaltija Datahub Myyjä F18 Rakenteelliset tiedot, sopimuksen peruminen DH-343 Edeltävän myyjän ilmoitus myyntisopimuksen palatutuksesta kieltäytymisestä Myyjä Datahub Jakeluverkonhaltija F06 Rakenteelliset tiedot, sopimuksen päättäminen DH-344 Ilmoitus verkkosopimuksen päättymisestä peruutustilanteessa. Jakeluverkonhaltija Datahub Myyjä F06 Rakenteelliset tiedot, sopimuksen päättäminen DH-411 Toimituksen kytkentäpyyntö Myyjä Datahub Jakeluverkonhaltija F09 Kytkentä-katko -pyyntö DH-412 Ilmoitus toimituksen kytkennästä Jakeluverkonhaltija Datahub Myyjä F09 Kytkentä-katko -ilmoitus DH-421 Toimituksen katkaisupyyntö Myyjä Datahub Jakeluverkonhaltija F09 Kytkentä-katko -pyyntö DH-422 Ilmoitus toimituksen katkaisusta Jakeluverkonhaltija Datahub Myyjä F09 Kytkentä-katko -ilmoitus

28 (198) Prosessi Lähettäjä Vastaanottajat Sanomatyypin tunnus Sanomatyypin kuvaus DH-413, DH-423 Ilmoitus kytkennän tai katkaisun viivästymisestä Jakeluverkonhaltija Datahub Myyjä F09 Kytkentä-katko -ilmoitus DH-514 Jakeluverkonhaltijan taseselvitystietojen ilmoitus DH-515 Myyjän taseselvitystietojen ilmoitus Datahub Jakeluverkonhaltija E31 Taseselvitystiedot Datahub Myyjä E31 Taseselvitystiedot DH-522 Jakeluverkonhaltijan taseselvitystietojen haku Jakeluverkonhaltija Datahub F10 E31 Taseselvitystiedon haku Taseselvitystiedot DH-523 Häviöihin kirjattujen kulutusten ja tuotantojen haku Jakeluverkonhaltija Datahub F08 E66 Mittaustiedon haku Mittaustiedot DH-521 Myyjän taseselvitystietojen haku Myyjä Datahub F10 E31 Taseselvitystiedon haku Taseselvitystiedot DH-600-Tasevirheiden korjaus Datahub Myyjä Jakeluverkonhaltija F19 Tasevirhetiedot DH-711, DH-712 Tuotetietojen päivitys Myyjä Jakeluverkonhaltija Datahub F11 Rakenteelliset tiedot, tuote DH-721, DH-722, DH- 723 Tuotetietojen haku Myyjä Jakeluverkonhaltija 3. osapuoli Datahub F12 F11 Tuotetietojen haku Datahub DH-731, DH-732 Laskutustietojen päivitys Myyjä Jakeluverkonhaltija Jakeluverkonhaltija Myyjä F13 Laskurivitiedot 3. osapuoli DH-741, DH-742, DH- 743 Laskutustietojen haku Myyjä Jakeluverkonhaltija 3. osapuoli Datahub F14 F13 Laskurivitietojen haku DH-811, DH-812, DH- 813 Asiakkaan valtuutus osapuolelta Myyjä Jakeluverkonhaltija 3. osapuoli Datahub F15 Valtuutustiedot DH-821, DH-822, D-823 Asiakkaan valtuutus asiakkaalta Datahub Myyjä Jakeluverkonhaltija 3. osapuoli F15 Valtuutustiedot Myyjä DH-910 Osapuolitiedot Datahub Jakeluverkonhaltija F16 Osapuolitiedot 3. osapuoli

29 (198) Prosessi Lähettäjä Vastaanottajat Sanomatyypin tunnus Sanomatyypin kuvaus DH-920 Osapuolitietojen haku Myyjä Jakeluverkonhaltija 3. osapuoli Datahub F17 F16 Osapuolitietojen haku Osapuolitiedot Myyjä Myyjä Kuittaustapahtuma Jakeluverkonhaltija 3. osapuoli Jakeluverkonhaltija 3. osapuoli ACK Kuittaustapahtuma Datahub Datahub Noutotapahtuma Myyjä Jakeluverkonhaltija 3. osapuoli Datahub F99 Noutotapahtuma Peruutustapahtuma Myyjä Jakeluverkonhaltija Datahub E67 Alkuperäinen tapahtuma, ks. 2.9 2.9 Peruutussanomat ja -tapahtumat Peruutuskäytännöt eri tapahtumille on kuvattu alla olevassa taulukossa. Peruutusehdot, eli säännöt joiden puitteissa peruutus voidaan suorittaa, on kuvattu tapahtumakohtaisesti prosessidokumentissa. Peruutussanomaa käytettäessä lähetetään alkuperäisen sanoman tiedot sanoman tyypillä E67. Lisäksi voidaan välittää peruutuksen selitetieto. Prosessi Sanoma Peruutustapa DH-111 Asiakastietojen päivitysmyyjä DH-112 Asiakastietojen päivityspyyntö DH-121 Käyttöpaikan luonti F01 F01 E58 Peruutus tehdään uudella päivitysilmoituksella. Peruutussanoma Käyttöpaikan luonti voidaan perua käyttöpaikan poistolla (DH-123) mikäli käyttöpaikalle ei ole vielä kohdistunut muita tapahtumia. DH-122 Käyttöpaikkatietojen päivitys E58 Peruutus tehdään uudella päivitysilmoituksella. DH-124 Käyttöpaikkatietojen päivityspyyntö E58 Peruutussanoma DH-211 Mittaustiedon toimitus E66 Peruutus tehdään uudella päivitysilmoituksella. DH-311 Ilmoitus uudesta sopimuksesta DH-312 Verkkosopimuksen vahvistaminen DH-321 Myyntisopimuksen tietojen päivitys DH-322 Verkkosopimuksen tietojen päivitys F04 F04 F04 F04 Erikseen määritetty peruutussanoma (DH-341) Erikseen määritetty peruutussanoma (DH-342) Peruutus tehdään uudella päivitysilmoituksella. Peruutus tehdään uudella päivitysilmoituksella.

30 (198) Prosessi Sanoma Peruutustapa DH-331 Ilmoitus myyntisopimuksen päättymisestä DH-333 Ilmoitus verkkosopimuksen päättymisestä F06 F06 Peruutussanoma Peruutussanoma DH-411 Toimituksen kytkentäpyyntö F09 Peruutussanoma DH-412 Ilmoitus toimituksen kytkennästä F09 Peruutussanoma DH-421 Toimituksen katkaisupyyntö F09 Peruutussanoma DH-422 Ilmoitus toimituksen katkaisusta DH-413, DH-423 Ilmoitus kytkennän tai katkaisun viivästymisestä DH-711, DH-712 Tuotetietojen päivitys DH-731, DH-732 Laskutustietojen ylläpito DH-811, DH-812, DH-813 Asiakkaan valtuutuksen Ilmoitus F09 F09 F11 F13 F15 Peruutussanoma Peruutus tehdään kytkentä/katkaisuilmoituksella Peruutus tehdään uudella päivitysilmoituksella. Peruutus tehdään korjausriveillä (riveillä, joissa laskutettava määrä on käänteinen alkuperäisiin riveihin nähden). Peruutussanoma Yleiselle peruutustapahtumalle (E67) tehdään seuraavat validoinnit: # Tapahtumavalidointi 1 Alkuperäinen peruutettava sanoma on vastaanotettu järjestelmään. Peruutussanomassa viitataan alkuperäiseen sanomaan elementillä Alkuperäisen sanoman tunnus. 2 Peruutussanoman lähettäjä on sama kuin alkuperäisen sanoman lähettäjä. 3 Peruutussanoman ja alkuperäisen sanoman Voimaantulopäivämäärä on sama. 2.10 Tapahtumien välitys Datahub välittää vastaanotetut tapahtumat tarvittaville osapuolille. Oletusarvoisesti välitetään samat tiedot kuin vastaanotetussa sanomassa. Jos tietosisältö eroaa, on se erikseen mainittu. Sopimustapahtumien (sopimusten luonti- ja päivitystapahtumat) osalta on määritelty erilliset välitystapahtumat, koska kaikkea sopimustietoa ei tule välittää osapuolten välillä. Jos päivityspyynnön perusteella datahubiin ilmoitettu päivitystapahtuma ei sisällä muutoksia jo datahubissa olevaan tietoon verrattuna, tiedot välitetään eteenpäin vain sille osapuolelle, joka on pyytänyt tietojen päivitystä. Tällaisia pyyntötapahtumia ovat asiakastietojen päivityspyyntö jakeluverkonhaltijalta myyjälle ja käyttöpaikkatietojen päivityspyyntö myyjältä jakeluverkonhaltijalle.

31 (198) 2.11 Tapahtumien nouto Datahub ei toimita osapuolille toimitettavia sanomia automaattisesti vaan sanomat puskuroidaan lähetysjonoon, josta osapuoli noutaa sanomat yksi kerrallaan. Datahub toimittaa sanomat sanoman otsikkotiedoissa esitetyn luontiajan mukaisessa järjestyksessä. Noudettu sanoma pysyy edelleen osapuolen noudettavana, kunnes osapuoli on erikseen ilmoittanut datahubille noutaneensa sanoman. Osapuolet hakevat sanomat käyttämällä noutotapahtumaa. Noutotapahtuman tietosisältö on seuraava: Tietokenttä Taso Pakollisuus Kommentti Huom: Noutotapahtuma 1..1 Aikaleima 1 1..1 Osapuoli 1 1..1 [1] Sanomapaketti 1 1..1 Selite 1 0..1 Rakenteelliset tiedot Mittaustieto Laskutustieto [2] Huom: Tarkennus [1] Palautetaan kyseiselle osapuolelle kohdistetut tapahtumat [2] Tapahtumatietojen lisäksi palautetaan myös kyseiseen sanomapakettiin liittyvät kuittaustapahtumat. Asynkroniset haut, eli mittaustietojen ja laskurivitietojen haut, eriytetään jokaisella osapuolella omiin erillisiin jonoihinsa. Tällöin asynkroniset haut eivät sekoitu muuhun tiedonvaihtoon. Osapuolet voivat itse päättää miten jonot tullaan purkamaan osapuolen omiin järjestelmiin rajapintaa toteutettaessa. 2.12 Tapahtumien synkronisuus/asynkronisuus Rakenteellisten tietojen päivitys- ja kyselytapahtumien osalta palvelurajapinnat ovat synkronisia. Kuittaus- ja/tai vastaustiedot kyselyyn palautetaan palvelupyynnön vastauksena saman istunnon aikana. Aikasarjatietojen (mittaustiedot ja taseselvitystiedot) sekä laskurivitietojen osalta palvelut ovat asynkronisia sekä ilmoitustapahtumien että hakutapahtumien osalta. Datahub palauttaa välittömästi synkronisen teknisen tason kuittauksen siitä, että osapuolen pyyntö/ilmoitus on hyväksytty käsiteltäväksi. Varsinaisen tapahtuman käsittelyn kuittaukset ja vastaustiedot kyselyyn palautetaan erikseen noutopalvelun kautta asynkronisesti.

32 (198) 2.12.1 Asynkroniset haut Hakutapahtuman saapuessa rajapinnassa tarkastetaan, että haku on muodoltaan määritysten mukainen. Samalla tehdään tarkastus, että osapuolella on roolinsa perusteella oikeus lähettää kyseisenlainen hakutapahtuma. Jos muototarkastus tai roolitarkastus tuottaa negatiivisen tuloksen, datahub palauttaa negatiivisen kuittauksen ja haun käsittely päättyy. Jos hakutapahtuma on oikeassa muodossa, ja osapuolella on tapahtumaan tarvittava rooli, datahub aloittaa haun käsittelyn. Tässä yhteydessä tarkastetaan, onko osapuolella oikeus haettuun tietoon käyttöpaikkatasolla. Jos osapuoli on hakenut laajempaa tietokokonaisuutta, josta hänellä on oikeus vain osaan, datahub palauttaa sen osan haetuista tiedoista, johon osapuolella on oikeus. Niistä tiedoista, johon hakijalla ei ole oikeutta palautetaan virheilmoitus. Hakutulosten perään datahub toimittaa osapuolen noudettavaksi positiivisen kuittauksen, jonka noudettuaan osapuoli tietää vastaanottaneensa kaikki kyseiseen hakuun liittyvät sanomat. 2.13 Sanomaliikenteen salaus ja pakkaus Tapahtumat siirretään salattuna HTTPS (TLS 1.2). Sanomat allekirjoitetaan sertifikaatein käyttäen WS-Securityä. Sanomia ei erikseen salata WS-Securityn avulla. Lähetettävät mittaustieto tapahtumat tulee pakata ja vastaavasti datahubin välittämät mittaustieto tapahtumat on pakattu. Pakkaus tehdään tiedonsiirron yhteydessä (HTTP/S) käyttämällä HTTP Compression tekniikkaa.

33 (198) 3 DH-100-Asiakas- ja käyttöpaikkatietojen ylläpitoprosessit KUVA 1 ASIAKAS- JA KÄYTTÖPAIKKATAPAHTUMAT

34 (198) 3.1 DH-111 Asiakastietojen päivitys-myyjä Asiakkaat luodaan sopimustapahtumien yhteydessä. Asiakastietojen päivitykset datahubiin tehdään myyjän toimesta. Datahub välittää päivitetyt asiakastiedot niille jakeluverkonhaltijoille ja myyjille, joilla on voimassaoleva tai voimaan tuleva sopimus asiakkaan kanssa. Lisäksi tiedot välitetään niille 3. osapuolille, joilla on asiakkaan antama valtuutus asiakastiedoille. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-111-1 F01 Rakenteelliset tiedot, asiakas Myyjä Datahub DH-111-2 F01 Rakenteelliset tiedot, asiakas Datahub JVH DH-111-3 F01 Rakenteelliset tiedot, asiakas Datahub Myyjä DH-111-4 F01 Rakenteelliset tiedot, asiakas Datahub 3. osapuoli Huom: [*] Tarkennus Datahub välittää samat tapahtumatiedot muille osapuolille. Sanomaan lisätään alkuperäisen sanoman tunnus ja lähettäjä. Jos myyjältä vastaanotettavan sanoman tiedot ovat samat kuin datahubissa olevat tiedot (tiedot eivät muutu), tapahtumatietoja ei välitetä muille osapuolille. Poikkeuksena tilanne, jossa jakeluverkonhaltija on pyytänyt asiakastietojen päivitystä (DH-112-1). Tällöin tiedot välitetään kyseiselle jakeluverkonhaltijalle.

35 (198) KUVA 2 DH-111 - ASIAKASTIETOJEN PÄIVITYS - MYYJÄ Myyjän lähettämät tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Asiakastiedot 1 1..1 Voimaantulopäivämäärä 2 1..1 Alkuperäisen sanoman tunnus 2 0..1 Käytetään vain välitysanomassa [1]

36 (198) Alkuperäisen sanoman lähettäjä 2 0..1 Selite 2 0..1 Asiakkaan perustiedot 2 1..1 Käytetään vain välitysanomassa Käytetään vain päivityspyynnössä [1] Asiakkaan tunniste 3 1..1 Asiakkaan tunnisteen tyyppi 3 1..1 Asiakkaan tyyppi 3 1..1 Asiakkaan alityyppi 3 1..1 Käytetään joko y-tunnusta, yhdistystunnusta, henkilötunnusta tai osapuolen omaa tunnusta. Y-tunnus Yhdistystunnus Henkilötunnus (hetu) Osapuolen oma tunnus Yritys Kuluttaja Normaali Kuolinpesä [2] Osapuolen oma asiakastunnus 3 0..1 [3] Salattu -tieto 3 1..1 Kyllä/Ei. Kieli 3 1..1 Käytetään ISO 639-1 mukaista koodia. Yrityksen nimi 3 0..1 Pakollinen yritysasiakkaille Etunimi 3 0..1 Pakollinen kuluttajaasiakkaalle Keskimmäiset nimet 3 0..1 Sukunimi 3 0..1 Syntymäaika 3 0..1 Pakollinen kuluttajaasiakkaalle Pakollinen kuluttajaasiakkaalle, jos hetua ei ole annettu. VVVV-KK-PP Lisätunnus 3 0..1 Yhteystiedot 3 0..2 [4] Tyyppi 4 1..1 Puhelin Sähköpostiosoite Puhelinnumero Sähköpostiosoite 4 1..1 Postiosoite 3 1..1 [5] Osoitteen tarkenne 4 0..1 c/o Kadun nimi 4 0..1

37 (198) Talonumero 4 0..1 Porrastunnus 4 0..1 Huoneisto 4 0..1 Postinumero 4 1..1 Postilokero 4 0..1 Postitoimipaikka 4 1..1 Maa 4 1..1 Käytetään ISO 3166 alpha-2 mukaista tunnusta. Huom: [1] [2] [3] [4] Tarkennus Datahub välittää myyjältä tulleen alkuperäisen sanoman lähettäjän ja tunnuksen välityssanoman mukana näissä kentissä. Jos yritysasiakkaalle on tarve ilmoittaa myös henkilötunnus, ilmoitetaan tämä lisätunnuskentällä. Jos käytetään osapuolen omaa tunnusta, on se muotoa <myyjän tunnus>_<asiakasnumero> (käytetään yksilöivänä tietona tilanteessa, jossa henkilötunnusta ei ole tiedossa). Kenttää käytetään vain tilanteessa, jossa osapuolen oma tunnus halutaan päivittää henkilötunnukseksi. Asiakkaalle voidaan määrittää yksi puhelinnumero ja yksi sähköpostisoite. Vähintään toinen on annettava. [5] Osoitetiedossa tulee postinumeron lisäksi esittää joko kadun nimi tai postilokero. Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Postitoimipaikka on oikea postinumeron perusteella. Tarkistus tehdään vain suomalaiselle osoitteelle. 2 Asiakas löytyy datahubista. 3 Myyjällä on voimassaoleva tai voimaan tuleva sopimus asiakkaan kanssa. 4 Voimaantulopäivä ei saa olla menneisyydessä.

38 (198) 3.2 DH-112 Asiakastietojen päivityspyyntö - JVH Jakeluverkonhaltija voi pyytää asiakastietojen päivittämistä. Päivityspyynnössä jakeluverkonhaltija lähettää asiakkaan asiakastiedot. Datahub välittää pyynnön myyjälle, joka on viimeisenä tehnyt sopimuksen kyseisen asiakkaan kanssa. Jos asiakkaalla ei ole myyntisopimusta datahubissa, päivitetään asiakastiedot suoraan päivityspyynnön perusteella. Tällöin datahub palauttaa jakeluverkonhaltijalle kuittauksena tallennetut tiedot. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-112-1 F01 Rakenteelliset tiedot, asiakas JVH Datahub DH-112-2 F01 Rakenteelliset tiedot, asiakas Datahub Myyjä DH-112-3 F01 Rakenteelliset tiedot, asiakas Datahub JVH Huom: [*] Tarkennus Datahub välittää samat tapahtumatiedot myyjälle. Sanomaan lisätään alkuperäisen sanoman tunnus ja lähettäjä. KUVA 3 DH-112 - ASIAKASTIETOJEN PÄIVITYSPYYNTÖ - JVH

39 (198) Tapahtumassa välitetään pakolliset tiedot sekä ne tiedot, jotka halutaan päivitettäväksi. Mikäli jokin tieto halutaan poistaa, lähetetään kyseinen elementti/tietokenttä tyhjänä. Jos vapaaehtoista tietoa ei haluta muuttaa, kyseistä elementtiä/tietokenttää ei lähetetä lainkaan. Sanoman tapahtumatiedot sisältävät seuraavat tiedot. Tietokenttä Taso Pakollisuus Kommentti Huom: Asiakastiedot 1 1..1 Voimaantulopäivämäärä 2 1..1 Alkuperäisen sanoman tunnus 2 0..1 Alkuperäisen sanoman lähettäjä 2 0..1 Selite 2 0..1 Asiakkaan perustiedot 2 1..1 Asiakkaan tunniste 3 1..1 Asiakkaan tunnisteen tyyppi 3 1..1 Asiakkaan tyyppi 3 1..1 Asiakkaan alityyppi 3 0..1 Käytetään vain välitysanomassa Käytetään vain välitysanomassa Käytetään vain päivityspyynnössä Käytetään joko y-tunnusta, yhdistystunnusta, henkilötunnusta tai osapuolen omaa tunnusta. Y-tunnus Yhdistystunnus Henkilötunnus (hetu) Osapuolen oma tunnus Yritys Kuluttaja Normaali Kuolinpesä [1] [1] [2] Osapuolen oma asiakastunnus 3 0..1 [3] Salattu -tieto 3 0..1 Kyllä/Ei. Kieli 3 0..1 Käytetään ISO 639-1 mukaista koodia. Yrityksen nimi 3 0..1 Etunimi 3 0..1 Keskimmäiset nimet 3 0..1 Sukunimi 3 0..1 Syntymäaika 3 0..1 Pakollinen kuluttajaasiakkaalle, jos hetua ei ole annettu. VVVV-KK-PP Lisätunnus 3 0..1 Yhteystiedot 3 0..2 [4]

40 (198) Tyyppi 4 0..1 Puhelin Sähköpostiosoite Puhelinumero Sähköpostiosoite 4 0..1 Postiosoite 3 0..1 Osoitteen tarkenne 4 0..1 c/o Kadun nimi 4 0..1 Talonumero 4 0..1 Porrastunnus 4 0..1 Huoneisto 4 0..1 Postinumero 4 0..1 Postilokero 4 0..1 Postitoimipaikka 4 0..1 Maa 4 0..1 Käytetään ISO 3166 alpha-2 mukaista tunnusta. Huom: [1] [2] [3] Tarkennus Datahub välittää jakeluverkonhaltijalta tulleen alkuperäisen sanoman lähettäjän ja tunnuksen välityssanoman mukana näissä kentissä. Jos yritysasiakkaalle on tarve ilmoittaa myös henkilötunnus, ilmoitetaan tämä lisätunnuskentällä. Jos käytetään osapuolen omaa tunnusta, on se muotoa <myyjän tunnus>_<asiakasnumero> (käytetään yksilöivänä tietona tilanteessa, jossa henkilötunnusta ei ole tiedossa). Kenttää käytetään vain tilanteessa, jossa osapuolen oma tunnus halutaan päivittää henkilötunnukseksi. [4] Asiakkaalle voidaan määrittää yksi puhelinnumero ja yksi sähköpostisoite. Peruutussanomaa ei käytetä asiakastietojen päivityspyynnölle. Peruutus tehdään uudella päivityssanomalla. Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Postitoimipaikka on oikea postinumeron perusteella. Tarkistus tehdään vain suomalaiselle osoitteelle. 2 Asiakas löytyy datahubista. 3 Jakeluverkonhaltijalla on voimassaoleva sopimus asiakkaan kanssa. 4 Voimaantulopäivä ei saa olla menneisyydessä.

41 (198) 3.3 DH-113 Asiakastietojen päivityspyyntö - 3.osapuoli 3.osapuoli voi myös pyytää asiakastietojen päivittämistä. Päivityspyynnössä 3.osapuoli lähettää asiakkaan asiakastiedot. Datahub välittää pyynnön myyjälle, joka on viimeisenä tehnyt sopimuksen kyseisen asiakkaan kanssa. Jos asiakkaalla ei ole myyntisopimusta datahubissa, välittää datahub pyynnön jakeluverkonhaltijalle, joka on viimeisenä tehnyt sopimuksen kyseisen asiakkaan kanssa. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-113-1 F01 Rakenteelliset tiedot, asiakas 3,osapuoli Datahub DH-113-2 F01 Rakenteelliset tiedot, asiakas Datahub Myyjä DH-113-3 F01 Rakenteelliset tiedot, asiakas Datahub JVH Huom: [*] Tarkennus Datahub välittää samat tapahtumatiedot myyjälle. Sanomaan lisätään alkuperäisen sanoman tunnus ja lähettäjä. KUVA 4 DH-113 - ASIAKASTIETOJEN PÄIVITYSPYYNTÖ - 3.OSAPUOLI

42 (198) Tapahtumassa välitetään pakolliset tiedot sekä ne tiedot, jotka halutaan päivitettäväksi. Mikäli jokin tieto halutaan poistaa, lähetetään kyseinen elementti/tietokenttä tyhjänä. Jos vapaaehtoista tietoa ei haluta muuttaa, kyseistä elementtiä/tietokenttää ei lähetetä lainkaan. Sanoman tapahtumatiedot sisältävät seuraavat tiedot. Tietokenttä Taso Pakollisuus Kommentti Huom: Asiakastiedot 1 1..1 Voimaantulopäivämäärä 2 1..1 Alkuperäisen sanoman tunnus 2 0..1 Alkuperäisen sanoman lähettäjä 2 0..1 Selite 2 0..1 Asiakkaan perustiedot 2 1..1 Asiakkaan tunniste 3 1..1 Asiakkaan tunnisteen tyyppi 3 1..1 Asiakkaan tyyppi 3 1..1 Asiakkaan alityyppi 3 0..1 Käytetään vain välitysanomassa Käytetään vain välitysanomassa Käytetään vain päivityspyynnössä Käytetään joko y-tunnusta, yhdistystunnusta, henkilötunnusta tai osapuolen omaa tunnusta. Y-tunnus Yhdistystunnus Henkilötunnus (hetu) Osapuolen oma tunnus Yritys Kuluttaja Normaali Kuolinpesä [1] [1] [2] Osapuolen oma asiakastunnus 3 0..1 [3] Salattu -tieto 3 0..1 Kyllä/Ei. Kieli 3 0..1 Käytetään ISO 639-1 mukaista koodia. Yrityksen nimi 3 0..1 Etunimi 3 0..1 Keskimmäiset nimet 3 0..1 Sukunimi 3 0..1 Syntymäaika 3 0..1 Pakollinen kuluttajaasiakkaalle, jos hetua ei ole annettu. VVVV-KK-PP Lisätunnus 3 0..1 Yhteystiedot 3 0..2 [4]

43 (198) Tyyppi 4 0..1 Puhelin Sähköpostiosoite Puhelinumero Sähköpostiosoite 4 0..1 Postiosoite 3 0..1 Osoitteen tarkenne 4 0..1 c/o Kadun nimi 4 0..1 Talonumero 4 0..1 Porrastunnus 4 0..1 Huoneisto 4 0..1 Postinumero 4 0..1 Postilokero 4 0..1 Postitoimipaikka 4 0..1 Maa 4 0..1 Käytetään ISO 3166 alpha-2 mukaista tunnusta. Huom: [1] [2] [3] Tarkennus Datahub välittää jakeluverkonhaltijalta tulleen alkuperäisen sanoman lähettäjän ja tunnuksen välityssanoman mukana näissä kentissä. Jos yritysasiakkaalle on tarve ilmoittaa myös henkilötunnus, ilmoitetaan tämä lisätunnuskentällä. Jos käytetään osapuolen omaa tunnusta, on se muotoa <myyjän tunnus>_<asiakasnumero> (käytetään yksilöivänä tietona tilanteessa, jossa henkilötunnusta ei ole tiedossa). Kenttää käytetään vain tilanteessa, jossa osapuolen oma tunnus halutaan päivittää henkilötunnukseksi. [4] Asiakkaalle voidaan määrittää yksi puhelinnumero ja yksi sähköpostisoite. Peruutussanomaa ei käytetä asiakastietojen päivityspyynnölle. Peruutus tehdään uudella päivityssanomalla. Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Postitoimipaikka on oikea postinumeron perusteella. Tarkistus tehdään vain suomalaiselle osoitteelle. 2 Asiakas löytyy datahubista. 3 Jakeluverkonhaltijalla on voimassaoleva sopimus asiakkaan kanssa. 4 Voimaantulopäivä ei saa olla menneisyydessä.

44 (198) 3.4 DH-121 Käyttöpaikan luonti Käyttöpaikan luonti tehdään datahubiin jakeluverkonhaltijan toimesta. Käyttöpaikalla ei tässä vaiheessa ole kirjattuja sopimuksia, joten luontitapahtumaa ei välitetä eteenpäin. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-121 Huom: E58 Tarkennus Rakenteelliset tiedot, käyttöpaikka JVH Datahub KUVA 5 DH-121 - KÄYTTÖPAIKAN LUONTI Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Käyttöpaikkatiedot 1 1..1 Voimaantulopäivämäärä 2 1..1 Alkuperäisen sanoman tunnus Alkuperäisen sanoman lähettäjä 2 0..1 Käytetään vain välitysanomassa 2 0..1 Käytetään vain välitysanomassa

45 (198) Selite 2 0..1 Käytetään vain päivityspyynnössä Käyttöpaikan perustiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 Käyttöpaikan tila 3 1..1 Käyttöpaikan tyyppi 3 1..1 Käyttöpaikan alityyppi 3 1..1 Kytketty Katkaistu Rakenteilla Kulutus Tuotanto Tuotantoyksikön oma käyttö Normaali Kiinteistökäyttöpaikka Etäkytkettävä 3 1..1 Kyllä/Ei Aluetiedot 3 1..1 Mittausalue 4 1..1 [1] Mittarinumero 3 0..1 Pätömittauksen mittarinumero Rinnakkaiskäyttöpaikan tunnus 3 0..1 Pientuotantokohteelle ilmoitetaan vastaavan kulutuskäyttöpaikan/tuotantokäyttöpaikan tunnus. Käyttöpaikan osoitteet 3 1..n Osoitteen tyyppi 4 1..1 Pääosoite Lisäosoite Kadun nimi 4 0..1 [2] Talonumero 4 0..1 Porrastunnus 4 0..1 Huoneisto 4 0..1 Postinumero 4 1..1 Postitoimipaikka 4 1..1 Maa 4 1..1 Käytetään ISO 3166I mukaista tunnusta. Osoitteen tarkenne 4 0..1 Kieli 4 1..1 Käytetään ISO 639-1 mukaista koodia. Koordinaatisto 3 0..1 Käytetään WGS84-standardia. Leveysaste 4 1..1 Pituusaste 4 1..1 Käyttöpaikan ominaisuudet 3 0..1 Pakollinen, jos käyttöpaikan tila on eri kuin rakenteilla. Etäluettava 4 1..1 Kyllä/Ei

46 (198) Mittaustapa 4 1..1 Käyttäjäryhmä 4 1..1 Tuntimittaus Lukemamittaus Mittaroimaton Käytetään Tilastokeskuksen määrittämää luokittelua sähkön käyttötarkoituksen mukaan Pakollinen kulutuskäyttöpaikalle. Lämmitys riippuu sähköstä 4 1..1 Kyllä/Ei Sulakekoko 4 0..1 Käytetään sanomaliikenteen menettelyohjeen mukaista muotoa: <johtojen lukumäärä>x<vaiheiden lukumäärä>x<ampeeri> Johtojen lukumäärä jätetään pois jos käytössä vain yksi johto. Kts. sanomaliikenteen menettelyohje kappale 3.8. Esim: 3x25, 2x3x25 [3] Sähköteho 4 0..1 Ilmoitetaan aina kilowatteina [3] Vuosikäyttöarviot 4 0..2 Ilmoitetaan aina kilowattitunteina Ohjattava kuorma 3 0..n Ks. sanomatyypin yleiskuvaus (luku 12) Varastolaite 3 0..n Ks. sanomatyypin yleiskuvaus (luku 12) Tuotantolaite 3 0..n Ks. sanomatyypin yleiskuvaus (luku 12) Huom: [*] Tarkennus Tietoja Loissähkösarjat saatavilla ja Mittausaika-askel ei välitetä käyttöpaikkatapahtumassa. Datahub päättelee nämä tiedot vastaanotettujen mittaustietojen perusteella. Aikavyöhyketietoa ei ylläpidetä käyttöpaikalla, vaan se määrittyy verkkosopimuksen tuotteen/tuotekomponenttien ja kalenterin perusteella. [1] Mittausalueen tunnuksena käytetään EIC-tunnusta. [2] [3] Käyttöpaikan osoitteessa on aina oltava kadun nimi. Mikäli käyttöpaikalla ei ole virallista katuosoitetta, merkitään kadun nimeksi lähimmän kadun nimi ja tarkennetaan käyttöpaikan sijaintia osoitteen tarkenne -kentässä. Esitettävä joko sulakekoko tai sähköteho. Ote menettelyohjeesta: Sulaketiedot suositellaan kirjamaan sanomissa seuraavilla ehdoilla: ilman välilyöntejä, pienillä kirjaimilla (x) ja ilman ampeerimerkintää (A,a), eli esimerkiksi 3x25. Jos kohteessa on useampi liittymisjohto, kirjataan esimerkiksi 2x3x63. 1x3x63 merkintää ei tule käyttää.pienillä kirjaimilla (x) ja ilman ampeerimerkintää (A,a), eli esimerkiksi 3x25. Jos kohteessa on useampi liittymisjohto, kirjataan esimerkiksi 2x3x63. 1x3x63 merkintää ei tule käyttää. Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit.

47 (198) # Tapahtumavalidointi 1 Käyttöpaikkaa ei ole jo kirjattu järjestelmään. 2 Käyttöpaikan tunnus (GS1) on oikean muotoinen. 3 Mittausalue kuuluu jakeluverkonhaltijalle. 4 Postitoimipaikka on oikea postinumeron perusteella. Tarkistus tehdään vain suomalaiselle osoitteelle.

48 (198) 3.5 DH-122 Käyttöpaikkatietojen päivitys Käyttöpaikkatietojen päivitykset tehdään datahubiin jakeluverkonhaltijan toimesta. Datahub välittää päivitetyt käyttöpaikkatiedot käyttöpaikan voimassaolevalle ja tulevalle myyjälle. Tämän lisäksi muuttuneet käyttöpaikkatiedot toimitetaan 3.osapuolille, joilla on käyttöpaikkaan voimassaoleva asiakkaan valtuutus. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-122-1 E58 Rakenteelliset tiedot, käyttöpaikka JVH Datahub DH-122-2 E58 Rakenteelliset tiedot, käyttöpaikka Datahub Myyjä DH-122-3 E58 Rakenteelliset tiedot, käyttöpaikka Datahub 3. osapuoli Huom: Tarkennus [*] Datahub välittää samat tapahtumatiedot muille osapuolille. Sanomaan lisätään alkuperäisen sanoman tunnus ja lähettäjä. Jos jakeluverkonhaltijalta vastaanotettavan sanoman tiedot ovat samat kuin datahubissa olevat tiedot (tiedot eivät muutu), tapahtumatietoja ei välitetä muille osapuolille. Poikkeuksena tilanne, jossa myyjä on pyytänyt käyttöpaikkatietojen päivitystä (DH-124-1). Tällöin tiedot välitetään kyseiselle myyjälle.

49 (198) KUVA 6 DH-122 - KÄYTTÖPAIKKATIETOJEN PÄIVITYS Sanoman tapahtumatiedot sisältävät samat tiedot kuin tapahtuma DH-121. Päivitystapahtumassa toimitetaan kaikki käyttöpaikan tiedot, ei vain muuttuneita tietoja. Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Käyttöpaikka löytyy järjestelmästä 2 Mittausalue kuuluu jakeluverkonhaltijalle. 3 4 Postitoimipaikka on oikea postinumeron perusteella. Tarkistus tehdään vain suomalaiselle osoitteelle. Käyttöpaikkaa ei voi päivittää tilaan poistettu käytöstä, jos käyttöpaikalla on voimassa oleva myyntitai verkkosopimus.

50 (198) 3.6 DH-123 Käyttöpaikan poisto Käyttöpaikan poisto tehdään jakeluverkonhaltijan toimesta. Käyttöpaikka voidaan poistaa vain, jos sille ei ole sopimustapahtumia. Poistosanomaa ei välitetä eteenpäin. Poistosanomaa käytetään vain virheellisesti luotujen käyttöpaikkojen poistamiseen kokonaan järjestelmästä. Käyttöpaikan poistaminen käytöstä hoidetaan käyttöpaikan päivitystapahtumalla statuksen päivityksellä. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-123 Huom: E58 Tarkennus Rakenteelliset tiedot, käyttöpaikka JVH Datahub KUVA 7 DH-123 - KÄYTTÖPAIKAN POISTO

51 (198) Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Käyttöpaikkatiedot 1 1..1 Voimaantulopäivämäärä 2 1..1 Käyttöpaikan perustiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 Aluetiedot 3 1..1 Mittausalueen tunnus 4 1..1 Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Käyttöpaikka löytyy järjestelmästä 2 Käyttöpaikalle ei ole kirjattu sopimustapahtumia.

52 (198) 3.7 DH-124 Käyttöpaikkatietojen päivityspyyntö Myyjä tai 3.osapuoli voi pyytää käyttöpaikkatietojen päivittämistä. Datahub välittää pyynnön jakeluverkonhaltijalle. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-124-1 DH-124-2 Huom: [*] E58 E58 Tarkennus Rakenteelliset tiedot, käyttöpaikka Rakenteelliset tiedot, käyttöpaikka Myyjä 3.osapuoli Datahub Datahub Datahub välittää samat tapahtumatiedot jakeluverkonhaltijalle. Sanomaan lisätään alkuperäisen sanoman tunnus ja lähettäjä. JVH KUVA 8 DH-124 - KÄYTTÖPAIKKATIETOJEN PÄIVITYSPYYNTÖ Tapahtumassa välitetään pakolliset tiedot sekä ne tiedot, jotka halutaan päivitettäväksi. Mikäli jokin tieto halutaan poistaa, lähetetään kyseinen elementti/tietokenttä tyhjänä. Jos vapaaehtoista tietoa ei haluta muuttaa, kyseistä elementtiä/tietokenttää ei lähetetä lainkaan. Sanoman tapahtumatiedot sisältävät seuraavat tiedot.

53 (198) Tietokenttä Taso Pakollisuus Kommentti Huom: Käyttöpaikkatiedot 1 1..1 Voimaantulopäivämäärä 2 1..1 Alkuperäisen sanoman tunnus Alkuperäisen sanoman lähettäjä 2 0..1 Käytetään vain välitysanomassa 2 0..1 Käytetään vain välitysanomassa Selite 2 0..1 Käyttöpaikan perustiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 Käyttöpaikan osoite 3 0..n Osoitteen tyyppi 4 1..1 Pääosoite Lisäosoite Kadun nimi 4 0..1 Talonumero 4 0..1 Porrastunnus 4 0..1 Huoneisto 4 0..1 Postinumero 4 0..1 Postitoimipaikka 4 0..1 Maa 4 0..1 Käytetään ISO 3166I mukaista tunnusta. Osoitteen tarkenne 4 0..1 Kieli 4 0..1 Käytetään ISO 639-1 mukaista koodia. Käyttöpaikan ominaisuudet 3 0..1 Käyttäjäryhmä 4 0.,1 Käytetään Tilastokeskuksen määrittämää luokittelua sähkön käyttötarkoituksen mukaan Vuosikäyttöarviot 4 0..2 Veroluokka 4 0..1 [7] Ohjattava kuorma 3 0..n Varastolaite 3 0..n Tuotantolaite 3 0..n Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12)

54 (198) Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Käyttöpaikka löytyy järjestelmästä 2 Käyttöpaikka ja mittausalue täsmäävät. 3 Myyjällä on voimassaoleva oleva tai voimaan tuleva sopimus käyttöpaikalle. 4 Postitoimipaikka on oikea postinumeron perusteella. Tarkistus tehdään vain suomalaiselle osoitteelle. 6 Voimaantulopäivä ei saa olla menneisyydessä 7 Veroluokka on sopimustason tieto, ei käyttöpaikan ominaisuus. Veroluokka on mukana mukana käyttöpaikan päivityspyynnössä, jotta myyjä voi pyytää veroluokan päivitystä.

55 (198) 3.8 DH-131 Käyttöpaikkatunnuksen selvitys Käyttöpaikan tunnus voidaan hakea käyttöpaikan osoitteen perusteella. Hakua voidaan tarkentaa mittarinumerolla. Hakuun palautetaan lista käyttöpaikoista osoitetietoineen. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-131-1 F02 Käyttöpaikkatunnuksen kysely Myyjä 3.osapuoli Datahub DH-131-2 F20 Käyttöpaikkalista Datahub Myyjä 3.osapuoli Huom: Tarkennus KUVA 9 DH-131 - KÄYTTÖPAIKKATUNNUKSEN SELVITYS Kyselytapahtumassa on käytettävissä seuraavat hakukriteerit. Tietokenttä Taso Pakollisuus Kommentti Huom: Käyttöpaikan osoitekysely 1 1..1 Kadun nimi 2 1..1 Tuetaan jokerimerkkejä hakuarvossa. [1]

56 (198) Talonumero 2 0..1 Tuetaan jokerimerkkejä hakuarvossa. Porrastunnus 2 0..1 Tuetaan jokerimerkkejä hakuarvossa. Huoneisto 2 0..1 Postinumero 2 0..1 [1] Postitoimipaikka 2 0..1 [1] Mittarinumero 2 0..1 Pätömittauksen mittarinumero Käyttöpaikan tyyppi 2 0..1 Käyttöpaikan alityyppi 2 1..1 Normaali Kiinteistökäyttöpaikka Rinnakkaiskäyttöpaikan tunnus Huom: [1] 2 0..1 Tarkennus Kadun nimen lisäksi tulee haussa aina esittää joko postinumero tai postitoimipaikka. Kyselytapahtumassa ei tehdä pakollisuuksien lisäksi muita tapahtumavalidointeja. Virheilmoitus palautetaan, jos yhtään käyttöpaikkaa ei löydy hakukriteereillä. Vastaustapahtumassa palautetaan lista käyttöpaikoista osoitetietoineen. Vastauksessa toimitetaan maksimissaan 50 kappaletta käyttöpaikkoja. Mikäli haulla löytyy enemmän käyttöpaikkoja, kysely palauttaa virhetiedon ja hakukriteeriä tulee tarkentaa. Tietokenttä Taso Pakollisuus Kommentti Huom: Käyttöpaikkalista 1 1..50 Käyttöpaikan perustiedot 2 1..n Käyttöpaikan tunnus 3 1..1 Käyttöpaikan tila 3 1..1 Kytketty Katkaistu Rakenteilla Poistettu käytöstä Etäkytkettävä 3 1..1 Kyllä/Ei Käyttöpaikan tyyppi 3 1..1 Käyttöpaikan alityyppi 3 1..1 Kulutus Tuotanto Tuotantoyksikön oma käyttö Normaali Kiinteistökäyttöpaikka Mittarinumero 3 0..1 Pätömittauksen mittarinumero [1]

57 (198) Rinnakkaiskäyttöpaikan tunnus 3 0..1 Aluetiedot 3 1..1 Mittausalueen nimi 4 1..1 Mittausalueen tunnus 4 1..1 Mittausalueen tyyppi 4 1..1 Käyttöpaikan osoitteet 3 1..n Osoitteen tyyppi 4 1..1 Pääosoite Lisäosoite Kadun nimi 4 1..1 Talonumero 4 0..1 Porrastunnus 4 0..1 Huoneisto 4 0..1 Postinumero 4 1..1 Postitoimipaikka 4 1..1 Maa 4 1..1 Käytetään ISO 3166I mukaista tunnusta. Osoitteen tarkenne 4 0..1 Kieli 4 1..1 Käytetään ISO 639-1 mukaista koodia. Koordinaatisto 3 0..1 Leveysaste 4 1..1 Pituusaste 4 1..1 Huom: Tarkennus

58 (198) 3.9 DH-132 Käyttöpaikka ja asiakastietojen haku-nykyinen myyjä Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-132-1 F03 Käyttöpaikkatietokysely Nykyinen myyjä Datahub DH-132-2 F21 Käyttöpaikkatiedot Datahub Nykyinen myyjä Huom: Tarkennus Haussa käytetään hakukriteerinä käyttöpaikka- ja sopimustunnusta. Haussa palautetaan käyttöpaikkatiedot, sopimustiedot ja sopimusasiakkaat. KUVA 10 DH-132 - KÄYTTÖPAIKKA- JA ASIAKASTIETOJEN HAKU - NYKYINEN MYYJÄ Kyselyssä annetaan seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Käyttöpaikkatietokysely 1 1..1 Käyttöpaikan tunnus 2 1..1 Myyntisopimuksen tunnus 2 1..1

59 (198) Huom: Tarkennus Kyselytapahtumassa ei tehdä pakollisuuksien lisäksi muita tapahtumavalidointeja. Virheilmoitus palautetaan, jos yhtään käyttöpaikkaa ei löydy hakukriteereillä. Haussa kyselyyn palautetaan seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Käyttöpaikkatietovastaus 1 1..n [1] Voimaantulopäivämäärä 2 1..1 Käyttöpaikan perustiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 Käyttöpaikan tila 3 1..1 Käyttöpaikan tyyppi 3 1..1 Käyttöpaikan alityyppi 3 1..1 Etäkytkettävä 3 1..1 Päivämäärä, jolta tiedot raportoidaan. Kytketty Katkaistu Rakenteilla Poistettu käytöstä Kulutus Tuotanto Tuotantoyksikön oma käyttö Normaali Kiinteistökäyttöpaikka [2] Mittarinumero 3 0..1 Pätömittauksen mittarinumero Rinnakkaiskäyttöpaikan tunnus 3 0..1 Aluetiedot 3 1..1 Mittausalue 4 1..1 Verkkosopimuksen tiedot 3 1..n Verkkotuotteen tunnus 4 1..1 Käyttöpaikan osoitteet 3 1..n Koordinaatisto 3 0..1 Käyttöpaikan ominaisuudet 3 0..1 Verkkosopimuksen tuotteen tunnus Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12)

60 (198) Ohjattava kuorma 3 0..n Varastolaite 3 0..n Tuotantolaite 3 0..n Myyntisopimuksen tiedot 2 1..1 Myyntisopimuksen asiakkaat 3 1..n Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Huom: [1] [2] Tarkennus Haku voi palauttaa useamman rivin tilanteessa, jossa määräaikainen sopimus on uusittu käyttäen samaa sopimusnumeroa. Jos myyjän sopimus on voimassa hakuhetkellä, palautetaan hakuhetken tiedot. Jos myyjän sopimus on päättynyt, palautetaan päättymishetken tiedot. Jos myyjän sopimus astuu voimaan tulevaisuudessa, palautetaan sopimuksen aloitushetken mukaiset tiedot.

61 (198) 3.10 DH-133 Käyttöpaikka ja asiakastietojen haku-uusi myyjä Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-133-1 F03 Käyttöpaikkatietokysely Uusi myyjä Datahub DH-133-2 F21 Käyttöpaikkatiedot Datahub Uusi myyjä Huom : Tarkennus KUVA 11 DH-133 - KÄYTTÖPAIKKA- JA ASIAKASTIETOJEN HAKU - UUSI MYYJÄ Haussa käytetään hakukriteerinä käyttöpaikkatunnusta ja asiakastunnusta. Myyjällä tulee olla vähintään yhden asiakkaan osalta valtuutus käyttöpaikkatietoihin. Jos valtuutusta ei ole, palautetaan virheilmoitus. Haussa palautetaan käyttöpaikkatiedot, sopimustilanne ja asiakastiedot. Kyselyssä annetaan seuraavat tiedot:

62 (198) Tietokenttä Taso Pakollisuus Kommentti Huom: Käyttöpaikkatietokysely 1 1..n Käyttöpaikan tunnus 2 1..1 Asiakkaiden tiedot 2 1..n [1] Asiakkaan tunniste 3 1..1 Huom: Tarkennus [1] Kyselyyn sisällytetään kaikki uuteen sopimukseen tulevat asiakkaat. Kyselytapahtumassa ei tehdä pakollisuuksien lisäksi muita tapahtumavalidointeja. Virheilmoitus palautetaan, jos yhtään käyttöpaikkaa ei löydy hakukriteereillä. Haussa palautetaan seuraavat tiedot. Tietokenttä Taso Pakollisuus Kommentti Huom: Käyttöpaikkatietovastaus 1 1..1 Voimaantulopäivämäärä 2 1..1 Päivämäärä, jolta tiedot raportoidaan. [1] Käyttöpaikan perustiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 Käyttöpaikan tila 3 1..1 Käyttöpaikan tyyppi 3 1..1 Käyttöpaikan alityyppi 3 1..1 Kytketty Katkaistu Rakenteilla Poistettu käytöstä Kulutus Tuotanto Tuotantoyksikön oma käyttö Normaali Kiinteistökäyttöpaikka Etäkytkettävä 3 1..1 Mittarinumero 3 0..1 Pätömittauksen mittarinumero Rinnakkaiskäyttöpaikan tunnus 3 0..1 Aluetiedot 3 1..1 Mittausalue 4 1..1 Verkkosopimuksen tiedot 3 1..n [2] Veroluokka 4 1..1 Verkkotuotteen tunnus 4 1..1 Verkkosopimuksen tuotteen tunnus [2] Käyttöpaikan osoitteet 3 1..n Ks. sanomatyypin yleiskuvaus (luku 12)

63 (198) Koordinaatisto 3 0..1 Käyttöpaikan ominaisuudet 3 0..1 Ohjattava kuorma 3 0..n Varastolaite 3 0..n Tuotantolaite 3 0..n Sopimustilanne 2 1..1 Alkava myyntisopimus 3 0..1 Myyntisopimus asiakkaalla 3 1..1 Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Seuraavan sopimustapahtuman alkamispäivä Sopimus asiakkaalla Sopimus osittain asiakkaalla Sopimus ei asiakkaalla [2] [2] [2] [2] [3] Määräaikainen myyntisopimus 3 1..1 Kyllä/ei [2] Määräaikaisuuden päättymispäivä 3 0..1 Tätä tietoa ei palauteta,jos päätttyy yli 90 vuorokauden kuluttua. [2] Voimassa oleva myyntisopimus päättyy 3 0..1 Käyttöpaikalle on tullut aiemmin ilmoitus myyntisopimuksen päättymisestä. Poikkeava irtisanomisehto 3 1..1 Kyllä/ei [2] Irtisanomisaika 3 0..1 Poikkeava irtisanomisaika päivinä [2] Irtisanomisjakso 3 0..1 [2] Irtisanomisjakson alkuaika 4 0..1 [2] Irtisanomisjakson loppuaika 4 0..1 [2] Verkkosopimus asiakkaalla 4 1..1 Asiakkaiden tiedot 2 1..1 Sopimus asiakkaalla Sopimus osittain asiakkaalla Sopimus ei asiakkaalla Ks. sanomatyypin yleiskuvaus (luku 12) [3] [4] Huom: Tarkennus [1] Tiedot raportoidaan hakuhetkeltä. [2] Tiedot palautetaan vain, jos asiakkaalla on voimassa oleva sopimus käyttöpaikalle.

64 (198) [3] [4] Arvo päätellään seuraavasti: Sopimus täysin asiakkaalla", jos hakuun on syötetty täsmälleen ne asiakkaat, jotka ovat käyttöpaikan verkko- tai myyntisopimuksella. "Sopimus ei asiakkaalla", jos yhdelläkään ilmoitetulla asiakkaalla ei ole verkko- tai myyntisopimusta. Muussa tilanteessa "Sopimus osittain asiakkaalla" Palautetaan niiden asiakkaiden tiedot, jotka ovat listattu kyselyssä. Asiakastiedot palautetaan vain jos myyjällä on valtuutus asiakastietoihin.

65 (198) 3.11 DH-134 Käyttöpaikka ja asiakastietojen haku-jakeluverkonhaltija Käyttöpaikan tiedot haetaan käyttöpaikkatunnuksella. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-134-1 F03 Käyttöpaikkatietokysely JVH Datahub DH-134-2 F21 Käyttöpaikkatiedot Datahub JVH Huom: Tarkennus KUVA 12 DH-134 - KÄYTTÖPAIKKA- JA ASIAKASTIETOJEN HAKU - JVH Kyselytapahtumassa välitetään seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Käyttöpaikkatietokysely 1 1..1 Voimaantulopäivämäärä 2 1..1 Käyttöpaikan tunnus 2 1..1 Huom: Tarkennus

66 (198) Kyselylle tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Käyttöpaikka sijaitsee jakeluverkonhaltijan mittausalueella. Vastaustapahtumassa palautetaan käyttöpaikkaan liittyvät tiedot. Tietokenttä Taso Pakollisuus Kommentti Huom: Käyttöpaikkatietovastaus 1 1..1 Voimaantulopäivämäärä 2 1..1 Käyttöpaikan perustiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 Käyttöpaikan tila 3 1..1 Käyttöpaikan tyyppi 3 1..1 Käyttöpaikan alityyppi 3 1..1 Etäkytkettävä 3 1..1 Päivämäärä, jolta tiedot raportoidaan. Kytketty Katkaistu Rakenteilla Poistettu käytöstä Kulutus Tuotanto Tuotantoyksikön oma käyttö Normaali Kiinteistökäyttöpaikka [1] Mittarinumero 3 0..1 Pätömittauksen mittarinumero Rinnakkaiskäyttöpaikan tunnus 3 0..1 Aluetiedot 3 1..1 Mittausalue 4 1..1 Myyjätiedot 3 0..1 Myyjä 4 0..1 Myyntisopimuksen tiedot 3 0..n [2] Myyntituotteen tunnus 4 1..1 Myyntisopimuksen tuotteen tunnus [2] Käyttöpaikan osoitteet 3 1..n Koordinaatisto 3 0..1 Käyttöpaikan ominaisuudet 3 0..1 Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12)

67 (198) Ohjattava kuorma 3 0..n Varastolaite 3 0..n Tuotantolaite 3 0..n Verkkosopimuksen tiedot 3 1..n Verkkosopimuksen asiakkaat Huom: 3 1..n Tarkennus Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) [1] Tiedot palautetaan kyselyssä esitetyn ajanhetken mukaisesti. [2] Palautetaan, jos myyjä on antanut valtuudet tietoihin

68 (198) 3.12 DH-135 Käyttöpaikka ja asiakastietojen haku-3. osapuoli Käyttöpaikan tiedot voidaan hakea käyttöpaikkatunnuksella ja asiakastiedoilla halutulle ajanhetkelle. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-135-1 F03 Käyttöpaikkatietokysely 3. osapuoli Datahub DH-135-2 F21 Käyttöpaikkatiedot Datahub 3. osapuoli Huom : Tarkennus KUVA 13 DH-135 - KÄYTTÖPAIKKA- JA ASIAKASTIETOJEN HAKU - 3. OSAPUOLI Kyselytapahtumassa välitetään seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Käyttöpaikkatietokysely 1 1..1 Voimaantulopäivämäärä 2 1..1 Käyttöpaikan tunnus 2 1..1

69 (198) Asiakkaiden tiedot 2 1..n Asiakkaan tunniste 3 1..1 Huom: Tarkennus Kyselylle tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Osapuolella on asiakkaan antama valtuutus käyttöpaikalle. Vastaustapahtumassa palautetaan käyttöpaikkaan liittyvät tiedot. 3. osapuolella tulee olla asiakkaan antama valtuutus käyttöpaikan tietoihin. Tietokenttä Taso Pakollisuus Kommentti Huom: Käyttöpaikkatietovastaus 1 1..1 Voimaantulopäivämäärä 2 1..1 Käyttöpaikan perustiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 Käyttöpaikan tila 3 1..1 Käyttöpaikan tyyppi 3 1..1 Käyttöpaikan alityyppi 3 1..1 Etäkytkettävä 3 1..1 Päivämäärä, jolta tiedot raportoidaan. Kytketty Katkaistu Rakenteilla Poistettu käytöstä Kulutus Tuotanto Tuotantoyksikön oma käyttö Normaali Kiinteistökäyttöpaikka [1] Mittarinumero 3 0..1 Pätömittauksen mittarinumero Rinnakkaiskäyttöpaikan tunnus 3 0..1 Verkkosopimuksen tiedot 3 1..n Veroluokka 4 1..1 Verkkotuotteen tunnus 4 1..1 Verkkosopimuksen tuotteen tunnus Aluetiedot 3 1..1 Mittausalue 4 1..1

70 (198) Käyttöpaikan osoitteet 3 1..n Koordinaatisto 3 0..1 Käyttöpaikan ominaisuudet 3 0..1 Ohjattava kuorma 3 0..n Varastolaite 3 0..n Tuotantolaite 3 0..n Asiakkaan tiedot 2 1..n Huom: Tarkennus Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) [1] Tiedot raportoidaan kyselyssä esitylle raportointihetkelle. [2] Palautetaan vain niistä asiakkaista, joilta 3. osapuolella on valtuutus ja jotka on hakuun ilmoitettu. [2]

71 (198) 4 DH-200-Mittaustiedon ylläpitoprosessit KUVA 14 MITTAUSTAPAHTUMAT 4.1 DH-211 Mittaustiedon ilmoitus Mittauspisteen tuntimittaukset ilmoitetaan datahubiin jakeluverkonhaltijan tai palveluntarjoajan toimesta. Datahub välittää mittaustiedot voimassaolevalle myyjälle ja niille 3. osapuolille, joilla on oikeus mittaustietoihin. Myyjä, jolla on valtuutus tai sopimus käyttöpaikkaan, voi hakea tiedot mittaustiedon haun kautta. Mittaustietotapahtumassa tullaan soveltamaan E66-sanoman tietosisältöä, jota käytetään myös NBS suuntaan mitattua tuotantoa raportoitaessa. (NEG (ebix based) Validated Data for Settlement for Aggregator (E66)) Mittaustietoja toimitetaan oletusarvoisesti vuorokausijaksolla (Suomen virallinen vuorokausi). Erityis- ja korjaustilanteissa raportointijakso voi kuitenkin olla pitempi tai lyhyempi. Tapahtumassa tulee aina toimittaa ehjä aikajana aikasarja-arvoja koko raportointiaikavälille. Jokaiselle positiolle raportointiaikavälillä esitetään joko arvo tai arvo-puuttuu-tieto. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-211-1 E66 Mittaustiedot Mittausvastuullinen Datahub DH-211-2 E66 Mittaustiedot Datahub Myyjä DH-211-3 E66 Mittaustiedot Datahub 3. osapuoli

72 (198) KUVA 15 DH-211 - MITTAUSTIEDON ILMOITUS Tietokenttä Taso Pakollisuus Kommentti Huom: Mittausaikasarja 1 1..9999 Aikasarjan tunnus 2 1..1 Sanoman luontiaika 2 1..1 Raportointiaikaväli 2 1..1 Aika-askel 3 1..1 Alkuaika 3 1..1 Loppuaika 3 1..1 Mittauksen tyyppi 2 1..1 Lähettäjäkohtaisesti yksilöivä aikasarjan tunniste [1] Mittausaikasarjan tyyppi 3 1..1 Kulutus Tuotanto Loisenergia anto

73 (198) Loisenergia otto Rajapistesiirto Yksikkö 3 1..1 Mittauksen ominaisuudet Mittauspisteen tyyppi 2 1..1 3 1..1 Käyttöpaikka tuotantoyksikkö rajapiste Mittauspiste 2 1..1 Mittauspisteen tunnus 3 1..1 Aluetiedot 2 0..1 Mittausalueen tunnus 3 1..1 Ei käytetä rajapistemittaukselle. Antoalue 2 0..1 Antoalueen tunnus 3 1..1 Käytetään vain rajapistemittauksille Ottoalue 2 0..1 Ottoalueen tunnus 3 1..1 Käytetään vain rajapistemittauksille Aikasarja-arvot 2 1..9999 Positio 3 1..1 Arvot 3 1..1 Arvo 4 0..1 [2] Arvo puuttuu 4 0..1 Kyllä/Ei [2] Status 4 0..1 Epävarma Arvioitu Korjattu OK [3] Huom: [1] [2] [3] Tarkennus Aikasarjatiedot liitetään mittauspisteeseen mittauspisteen tunnus -kentän perusteella. Aikasarjan tunnuksena ilmoitetaan ilmoittavan järjestelmän käyttämä aikasarjatunnus, jota voidaan käyttää mahdollisten ongelmatilanteiden selvityksessä. Esitetään joko arvo tai arvo-puuttuu tieto. Arvojen tulee aina olla positiivisia. Rajapisteiden osalta molemmat siirtosuunnat ilmoitetaan erikseen. Status esitetään, jos muu kuin mitattu. (136=OK) (Puuttuva), ei esitetä, vaan ilmaistaan Arvo puutttuu kentällä. Epävarma Arvioitu Korjattu OK

74 (198) Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. Datahub hylkää sanoman tiedot mittausaikasarjoittain. # Tapahtumavalidointi 1 Mittauspiste löytyy järjestelmästä 2 Osapuolella (jakeluverkonhaltija tai 3. osapuoli) on oikeus toimittaa mittaustietoja mittausalueelle. 3 Mittaustiedon resoluutio on oikea (Tällä hetkellä tunti, jatkossa mahdollisesti 15 min tai 5 min). 4 Ilmoitettava aikaväli ei ole tulevaisuudessa eikä yli 6 vuoden takana menneisyydessä 5 Aikasarja sisältää arvon (tai arvo puuttuu -tiedon) jokaiselle raportointiaikavälin positiolle

75 (198) 4.2 DH-221, DH-222, DH-223 Mittaustiedon haut Mittaustietoja voidaan hakea myyjän, 3. osapuolen tai jakeluverkonhaltijan toimesta. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-221-1 Myyjä DH-222-1 F08 Mittaustiedon haku JVH Datahub DH-223-1 3. osapuoli DH-221-2 DH-222-2 DH-223-2 E66 Mittaustiedot Datahub Myyjä JVH 3. osapuoli KUVA 16 DH-220 - MITTAUSTIEDON HAKU

76 (198) Kyselytapahtumassa annetaan seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Mittaushaku 1 1..9999 Mittauspisteen tunnus Samalla kyselyllä voidaan hakea useampia käyttöpaikkoja. 2 0..1 [1] Mittausalue 2 0..1 [1] Käyttöpaikan tyyppi 2 0..1 Aika-askel 2 0..1 Jos tyyppiä ei ole annettu, palautetaan sekä kulutus- että tuotantokäyttöpaikkojen tiedot. Pätötehon yksikkö 2 0..1 [2] Loistehon yksikkö 2 0..1 [2] Pyyntöaikaväli 2 1..1 Alkuaika 3 1..1 Loppuaika 3 1..1 Huom: [1] [2] Tarkennus Voidaan hakea joko kaikki mittauspisteet mittausalueen perusteella tai yksittäinen mittauspiste. Pätö- ja loismittaukset voi hakea määritellyssä yksikössä. Jos yksikköä ei anneta haussa, vastaavasti pätö- tai loistehoa ei palauteta. Vähintään toinen yksiköistä on annettava, että tietoja voidaan palauttaa. Jos mittaus haetaan suuremmalla resoluutiolla kuin datahubin tallennusresoluutio, arvon statukseksi asetetaan heikoin status aika-askeleen sisällä. Jos mittaus haetaan pienemmällä resoluutiolla kuin datahubin tallennusresoluutio, palautetaan mittaus tallennusresoluutiolla. Kyselylle tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Kyselyaikaväli on korkeintaan yksi vuosi. 2 Kyselyaikaväli ei ole tulevaisuudessa eikä yli 6 vuoden takana menneisyydessä. 3 Aika-askel on vähintään yhtä suuri, kuin aika-askel, jolla mittaus on tallennettu datahubiin. 4 Kyselyn yksikkö on energiayksikkö. Vastaustapahtuma sisältää samat tiedot kuin DH-211 (Mittaustiedot). Mittaustiedot toimitetaan vain aikajaksolle, jolle osapuolella on oikeudet tietoihin. Osapuolten oikeudet tietoihin on kuvattu

77 (198) dokumentissa "Sähkön vähittäismarkkinoiden liiketoimintaprosessit datahubissa" luvussa 2.2. Vastaustapahtumassa toimitetaan kaikki käyttöpaikalle kirjatut mittaukset (myös loismittaukset, mikäli ne on toimitettu datahubiin). Mittaustietojen vastaustapahtuma palautetaan asynkronisena. Haettaessa suuria mittaustietomääriä vastaustapahtuman muodostaminen voidaan datahubissa tarvittaessa viivästyttää järjestelmän resurssitilanteen näin vaatiessa.

78 (198) 4.3 DH-212 Muistutus mittaustiedon ilmoituksesta Datahub ilmoittaa virheellisistä tai ilmoittamattomista mittaustiedoista jakeluverkonhaltijalle. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-212 F07 Mittaustietomuistutus Datahub Mittausvastuullinen KUVA 17 DH-212 - MUISTUTUS MITTAUSTIEDON ILMOITUKSESTA Tietokenttä Taso Pakollisuus Kommentti Huom: Mittaustietomuistutus 1 1..9999 Mittauspisteen tunnus 2 1..1 Mittausalue 2 1..1 Pyyntöaikaväli 2 1..1 Alkuaika 3 1..1 Loppuaika 3 1..1 Huom: [1] Tarkennus Käyttöpaikka, tuotantoyksikkö tai rajapiste. Aikavälinä esitetään ensimmäisen ja viimeisen puuttuvan arvon aikaväli. Datahub tekee tarkastelun tietylle ajanjaksolle (esim avoimelle taseikkunalle). Tällöin pyyntöaikaväli voi olla joko koko avoimen taseikkunan aikaväli tai ensimmäisen ja viimeisimmän puuttuvan arvon aikaväli. [1]

79 (198) 5 DH-300-Sopimusprosessit KUVA 18 SOPIMUSTAPAHTUMAT 5.1 DH-311 Ilmoitus uudesta sopimuksesta Myyjä toimittaa uuden myyntisopimuksen tiedot datahubiin. Uudet myyntisopimustiedot datahub toimittaa jakeluverkonhaltijalle. Käyttöpaikan nykyiselle myyjälle datahub toimittaa myyntisopimuksen päättymisilmoituksen.

80 (198) Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-311-1 F04 Rakenteelliset tiedot, sopimus Uusi myyjä Nykyinen myyjä Datahub DH-311-2 F04 Rakenteelliset tiedot, sopimus Datahub JVH DH-311-3 F06 Rakenteelliset tiedot, sopimuksen päättäminen Datahub Nykyinen myyjä DH-311-4 F06 Rakenteelliset tiedot, sopimuksen päättäminen Datahub Tuotantokäyttöpaikan myyjä DH-311-5 F18 Rakenteelliset tiedot, sopimuksen peruminen Datahub Tuleva myyjä DH-311-6 - DH-311-8 F01 Rakenteelliset tiedot, asiakas Datahub Myyjä Jakeluverkonhaltija 3.osapuoli DH-311-9 E66 Mittaustiedot Datahub JVH Huom: Tarkennus [*]

81 (198) KUVA 19 DH-311 - ILMOITUS UUDESTA SOPIMUKSESTA

82 (198) 5.1.1 DH-311-1 Uuden sopimuksen tiedot Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Uuden sopimuksen tiedot 1 1..1 Voimaantulopäivämäärä 2 1..1 Sopimuksen aloituspäivämäärä Alkuperäisen sanoman tunnus Alkuperäisen sanoman lähettäjä 2 0..1 Käytetään vain välitysanomassa [1] 2 0..1 Käytetään vain välitysanomassa Sopimustiedot 2 1..1 Asiointitapa 3 1..1 Sähköinen Muu Sopimustunnus 3 1..1 Sopimuksen tyyppi 3 1..1 Myyntisopimus Sähköntoimitussopimus 3 1..1 Kyllä/ei tieto Sopimuksen määräaikaisuus Määräaikaisuuden päättymispäivä 3 1..1 Kyllä/ei tieto 3 0..1 Laskutustapa 3 1..1 Erillislaskutus, Verkko laskuttaa molemmat Myyjä laskuttaa molemmat [6] Poikkeava irtisanomisehto 3 1..1 Kyllä/ei tieto Irtisanomisaika 3 0..1 Poikkeava irtisanomisaika päivinä [2] Irtisanomisjakso 3 0..1 [2] Irtisanomisjakson alkuaika 4 0..1 [2] Irtisanomisjakson loppuaika 4 0..1 [2] Keskeytyskriittisyys 3 1..1 Kyllä/ei tieto Laskutuskanava 3 1..1 Paperilasku Verkkolasku E-lasku Sähköposti Netposti Suoramaksu Mobiililasku [5] Veroluokka 3 1..1 0,1,2 Tuotetieto 3 0..n

83 (198) Tuotteen tunnus 4 1..1 Myyntisopimuksen tuotteen tunnus Asiakkaan tarkenne 3 0..1 Yhteyshenkilö 3 0..n Tyyppi 4 1..1 Edunvalvoja Sopimusvastaava Laskutusvastaava Kytkentävastaava Vikaviestintä Etunimi 4 0..1 Sukunimi 4 0..1 Muu Nimi 4 0..1 Yhteystiedot 4 0..99 Tyyppi 5 1..1 Puhelin Sähköpostiosoite Puhelinumero/ Sähköpostiosoite 5 1...1 Laskutusosoite 3 0..1 [3] Osoitteen tarkenne 4 0..1 c/o Kadun nimi 4 0..1 Talonumero 4 0..1 Porrastunnus 4 0..1 Huoneisto 4 0..1 Postinumero 4 1..1 Postilokero 4 0..1 Postitoimipaikka 4 1..1 Maa 4 1..1 Käytetään ISO 3166 alpha-2 mukaista tunnusta. Verkkolaskuosoite 3 0..1 [3 Kohdiste 4 0..1 Verkkolaskuosoite 4 1..1 Välittäjän tunnus 4 1..1 Muu sähköinen laskutusosoite 3 0..1 [3] Tyyppi 4 1..1 Sähköinen osoite 4 1..1 Käyttöpaikan tiedot 3 1..1

84 (198) Käyttöpaikan tunnus 4 1..1 Aluetiedot 3 1..1 Mittausalue 4 1..1 Myyjän tiedot 3 1..1 Myyjän tunnus 4 1..1 Asiakkaiden perustiedot 3 1..n Asiakkaan tunniste 4 1..1 Asiakkaan tunnisteen tyyppi 4 1..1 Asiakkaan tyyppi 4 1..1 Asiakkaan alityyppi 4 1..1 Käytetään joko y-tunnusta, yhdistystunnusta, henkilötunnusta tai osapuolen omaa tunnusta. Y-tunnus Yhdistystunnus Henkilötunnus (hetu) Osapuolen oma tunnus Yritys Kuluttaja Normaali Kuolinpesä Salattu-tieto 4 1..1 Kyllä/Ei. Kieli 4 1..1 Käytetään ISO 639-1 mukaista koodia. Yrityksen nimi 4 0..1 Pakollinen yritysasiakkaille Etunimi 4 0..1 Pakollinen kuluttaja-asiakkaalle Keskimmäiset nimet 4 0..1 Sukunimi 4 0..1 Pakollinen kuluttaja-asiakkaalle Syntymäaika 4 0..1 Pakollinen kuluttaja-asiakkaalle, jos hetua ei ole annettu. VVVV-KK-PP Lisätunnus 4 0..1 Yhteystiedot 4 0..99 Tyyppi 5 1..1 Puhelin Sähköpostiosoite Puhelinumero Sähköpostiosoite 5 1...1 Postisoite 4 1..1 [2] Osoitteen tarkenne 5 0..1 c/o Kadun nimi 5 0..1 Talonumero 5 0..1 Porrastunnus 5 0..1

85 (198) Huoneisto 5 0..1 Postinumero 5 1..1 Postilokero 5 0..1 Postitoimipaikka 5 1..1 Maa 5 1..1 Huom: [1] [2] Tarkennus Käytetään ISO 3166 alpha-2 mukaista tunnusta. Datahub välittää myyjältä tulleen alkuperäisen sanoman tunnuksen välityssanoman mukana tässä kentässä. Jos sopimuksella on poikkeava irtisanomisaika, tulee sopimukselle määrittää joko irtisanomisaika päivinä tai irtisanomisjakso. Irtisanomisjakso määrittää aikavälin, jolloin sopimus voidaan irtisanoa. Jos käytetään irtisanomisjaksoa, tulee myyjän huolehtia jakson päivittämisestä sopimukselle. [3] Osoitetiedossa tulee postinumeron lisäksi esittää joko kadun nimi tai postilokero. [4] Jompi kumpi esitettävä, jos laskutuskanava on muu kuin paperilasku. [5] [6] Kuluttajan e-laskuosoitetta ei tuoda datahubiin. Laskutuskanavaksi voidaan kuitenkin merkitä E-lasku tai Suoramaksu. Tällöin laskutusosoite on pakollinen. Jos kyseessä on sähköntoimitussopimus, laskutustapa tulee olla "Myyjä laskuttaa molemmat" Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Osoitteissa postitoimipaikka on oikea postinumeron perusteella. Tarkistus tehdään vain suomalaiselle osoitteelle. 3 Jos asiointitapa on sähköinen, niin yhteystiedoissa tulee olla sähköpostiosoite 3 Voimaantulopäivä on liiketoimintaprosessien määritysten mukainen. 4 Käyttöpaikka löytyy järjestelmästä ja sen status on muu kuin poistettu käytöstä. 5 6 Käyttöpaikalla olevalla myyntisopimuksella ei ole voimassa poikkeavaa irtisanomisehtoa. Tarkistusta ei tehdä, jos käyttöpaikan asiakkuus muuttuu. Jos käyttöpaikalla on voimassaoleva määräaikainen myyntisopimus, uuden sopimuksen aloitusaika ei saa olla aikaisempi kuin määräaikaisen sopimuksen päättymispäivä. Tarkistusta ei tehdä, jos käyttöpaikan asiakkuus muuttuu. 7 Käyttöpaikalle ei ole kirjattu toista myyntisopimusta samalle aloituspäivämäärälle. Mikäli uusi myyntisopimus astuu voimaan takautuvasti (voimaantulopäivä on aikaisempi kuin kuluva päivä) sopimus otetaan vastaan, mutta sopimusta ei aktivoida datahubissa. Sopimus aktivoidaan vasta, kun uusi myyjä on vahvistanut sopimuksen ja vanha myyjä on hyväksynyt

86 (198) sopimuksen. Sopimuksen vahvistaminen ja hyväksyminen tehdään manuaalisesti online-palvelun kautta. 5.1.2 DH-311-2 Uuden sopimuksen tiedot jakeluverkonhaltijalle Tietokenttä Taso Pakollisuus Kommentti Huom: Uuden sopimuksen tiedot 1 1..1 Voimaantulopäivämäärä 2 1..1 Alkuperäisen sanoman tunnus 2 1..1 Käytetään vain välitysanomassa [1] Alkuperäisen sanoman lähettäjä Vaatii uuden verkkosopimuksen 2 1..1 Käytetään vain välitysanomassa 2 1..1 Kyllä/ei tieto Sopimuksen aloituksen syy 2 1..1 Sopimuksen vaihto Myyjän vaihto Sisäänmuutto Sopimustiedot 2 1..1 Asiointitapa 3 1..1 Sähköinen Muu Sopimustunnus 3 1..1 Sopimuksen tyyppi 3 1..1 Myyntisopimus Sähköntoimitussopimus 3 1..1 Kyllä/ei tieto Sähköntoimitussopimus 3 1..1 Kyllä/ei tieto Sopimuksen aloituspäivämäärä 3 1..1 Laskutustapa 3 1..1 Erillislaskutus, Verkko laskuttaa molemmat Myyjä laskuttaa molemmat Keskeytyskriittisyys 3 1..1 Kyllä/ei tieto Laskutuskanava 3 1..1 Paperilasku Verkkolasku E-lasku Sähköposti Netposti Suoramaksu Mobiililasku Veroluokka 3 1..1 0,1,2 Asiakkaan tarkenne 3 0..1 Yhteyshenkilö 3 0..n Ks. sanomatyypin yleiskuvaus (luku 12)

87 (198) Yhteystiedot 4 0..99 Laskutusosoite 3 0..1 Verkkolaskuosoite 3 0..1 Muu sähköinen laskutusosoite 3 0..1 Käyttöpaikan tiedot 3 1..1 Käyttöpaikan tunnus 4 1..1 Aluetiedot 3 1..1 Mittausalue 4 1..1 Myyjän tiedot 3 1..1 Myyjän tunnus 4 1..1 Asiakkaiden perustiedot 3 1..n Postisoite 4 1..1 Huom: [1] Tarkennus Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Datahub välittää myyjältä tulleen alkuperäisen sanoman tunnuksen välityssanoman mukana tässä kentässä. [2] 5.1.3 DH-311-3 Ilmoitus myyntisopimuksen päättymisestä nykyiselle myyjälle Datahub ilmoittaa myyntisopimuksen päättymisestä nykyiselle myyjälle. Ilmoituksessa käytetään samaa tietosisältöä kuin normaalissa myyntisopimuksen päättämisessä (DH-331). Sanomassa esitetään päättyvän sopimuksen tiedot. 5.1.4 DH-311-4 Ulosmuuttoilmoitus tuotantokäyttöpaikan myyjälle Datahub ilmoittaa tuotantokäyttöpaikan sopimuksen päättymisestä tuotantokäyttöpaikan myyjälle. Ilmoituksessa käytetään samaa tietosisältöä kuin normaalissa myyntisopimuksen päättämisessä (DH-331). Sanomassa esitetään tuotantokäyttöpaikan sopimuksen tiedot. 5.1.5 DH-311-5 Ilmoitus myyntisopimuksen peruuntumisesta tulevalle myyjälle Datahub ilmoittaa uuden asiakkaan sisäänmuuton yhteydessä myyntisopimuksen peruuntumisen myyjälle, jolla on tulevaisuudessa alkamassa myyntisopimus, joka ei ole sisäänmuuttavan asiakkaan sopimus. Ilmoitus tehdään myyntisopimuksen peruutussanomalla syyllä "Asiakkaan peruutus".

88 (198) 5.1.6 DH-311-6 - DH-311-8 Asiakastietojen päivityksen välitys Datahub ilmoittaa kaikille asiakkaan tietoihin oikeutetuille osapuolille, jos asiakastiedot muuttuvat uuden sopimuksen ilmoituksen yhteydessä. Ilmoitus tehdään kuten muutkin asiakastietojen päivityksen välitykset tapahtumassa DH-111. 5.1.7 DH-311-9 Häviöihin kirjattujen kulutusten nollaus Datahub ilmoittaa nolla-aikasarjaa jakeluverkonhaltijalle, jos käyttöpaikalle tulee takautuvasti sisäänmuuttoilmoitus myyjättömälle käyttöpaikalle. Ilmoituksen perusteella jakeluverkonhaltija voi nollata aiemmin tapahtumalla DH-523 hakemansa häviöihin kirjatut kulutukset omasta järjestelmästään. Ilmoitus tehdään DH-523 -tapahtumaa vastaavasti.

89 (198) 5.2 DH-312 Verkkosopimuksen vahvistaminen Jakeluverkonhaltija toimittaa verkkosopimuksen vahvistustiedot datahubiin. Vahvistustiedot datahub toimittaa käyttöpaikan voimassaolevalle ja uudelle myyjälle. Tapahtuma DH-312-1 DH-312-2 Huom: Sanomatyyppi F04 F04 Tarkennus Sanomatyypin kuvaus Rakenteelliset tiedot, sopimus Rakenteelliset tiedot, sopimus [1] Verkkosopimuksen vahvistustiedot välitetään myyjälle. Lähettäjä Vastaanottaja Huom:[*] JVH Datahub Datahub Uusi myyjä Nykyinen myyjä [1] KUVA 20 DH-312 - VERKKOSOPIMUKSEN VAHVISTAMINEN Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Sopimustiedot 1 1..1 Voimaantulopäivämäärä 2 1..1

90 (198) Alkuperäisen sanoman tunnus Alkuperäisen sanoman lähettäjä Verkkosopimuksen hyväksyminen 2 1..1 Käytetään vain välitysanomassa 2 0..1 Käytetään vain välitysanomassa 2 1..1 Kyllä/ei [1] Selite 2 0..1 Selite sopimuksen hylkäämiselle Sopimustiedot 2 0..1 Asiointitapa 3 1..1 Sähköinen Muu Sopimustunnus 3 1..1 Sopimuksen tyyppi 3 1..1 Verkkosopimus Sopimuksen aloituspäivämäärä 3 1..1 Laskutustapa 3 1..1 Erillislaskutus, Verkko laskuttaa molemmat Myyjä laskuttaa molemmat Keskeytyskriittisyys 3 1..1 Kyllä/ei tieto Laskutuskanava 3 1..1 Paperilasku Verkkolasku E-lasku Sähköposti Netposti Suoramaksu Mobiililasku Veroluokka 3 1..1 0,1,2 Asiakkaan tarkenne 3 0..1 Tuotetieto 3 0..n Tuotteen tunnus 4 1..1 Verkkosopimuksen tuotteen tunnus Yhteyshenkilö 3 0..n Tyyppi 4 1..1 Edunvalvoja Sopimusvastaava Laskutusvastaava Kytkentävastaava Vikaviestintä Etunimi 4 0..1 Sukunimi 4 0..1 Muu Nimi 4 0..1 Yhteystiedot 4 0..99

91 (198) Tyyppi 5 1..1 Puhelin Sähköpostiosoite Puhelinumero/ Sähköpostiosoite 5 1...1 Laskutusosoite 3 0..1 Osoitteen tarkenne 4 0..1 c/o Kadun nimi 4 0..1 Talonumero 4 0..1 Porrastunnus 4 0..1 Huoneisto 4 0..1 Postinumero 4 1..1 Postilokero 4 0..1 Postitoimipaikka 4 1..1 Maa 4 1..1 Käytetään ISO 3166 alpha-2 mukaista tunnusta. Verkkolaskuosoite 3 0..1 Kohdiste 4 0..1 Verkkolaskuosoite 4 1..1 Välittäjän tunnus 4 1..1 Muu sähköinen laskutusosoite 3 0..1 Tyyppi 4 1..1 Sähköinen osoite 4 1...1 Käyttöpaikan tiedot 3 1..1 Käyttöpaikan tunnus 4 1..1 Aluetiedot 3 1..1 Mittausalue 4 1..1 Huom: [1] Tarkennus Jos jakeluverkonhaltija ei hyväksy verkkosopimusta, palautetaan hylkäystieto. Tällöin sopimustietoja ei sisällytetä sanomaan. Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Osoitteissa postitoimipaikka on oikea postinumeron perusteella. Tarkistus tehdään vain suomalaiselle osoitteelle.

92 (198) 2 Käyttöpaikka löytyy järjestelmästä ja sen status on muu kuin poistettu käytöstä. 3 Käyttöpaikan mittausalue kuuluu jakeluverkon haltijalle. 4 Käyttöpaikalle ilmoitettua myyntisopimusta ei ole peruttu

93 (198) 5.3 DH-321 Myyntisopimuksen tietojen päivitys Myyntisopimustietojen päivitykset tehdään myyjän toimesta datahubiin. Datahub välittää päivitetyt sopimustiedot jakeluverkonhaltijalle. Tapahtuma DH-321-1 DH-321-2 Huom: Sanomatyyppi F04 F04 Tarkennus Sanomatyypin kuvaus Rakenteelliset tiedot, sopimus Rakenteelliset tiedot, sopimus Lähettäjä Vastaanottaja Huom:[*] Nykyinen myyjä [1] Myyntisopimuksen muuttuneet tiedot välitetään jakeluverkonhaltijalle. Datahub Datahub JVH [1] KUVA 21 DH-321 - MYYNTISOPIMUKSEN TIETOJEN PÄIVITYS Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Sopimuksen tiedot 1 1..1 Voimaantulopäivämäärä 2 1..1

94 (198) Alkuperäisen sanoman tunnus 2 0..1 Käytetään vain välitysanomassa Alkuperäisen sanoman lähettäjä 2 0..1 Käytetään vain välitysanomassa Sopimustiedot 2 1..1 Sopimustunnus 3 1..1 Sopimuksen tyyppi 3 1..1 Myyntisopimus Asiointitapa 3 1..1 Sähköinen Muu Määräaikainen myyntisopimus 3 1..1 Kyllä/ei tieto Määräaikaisuuden päättymispäivä 3 0..1 Laskutustapa 3 1..1 Erillislaskutus, Verkko laskuttaa molemmat Myyjä laskuttaa molemmat Poikkeava irtisanomisehto 3 1..1 Kyllä/ei tieto Irtisanomisaika 3 0..1 Poikkeava irtisanomisaika päivinä Irtisanomisjakso 3 0..1 Irtisanomisjakson alkuaika 4 0..1 Irtisanomisjakson loppuaika 4 0..1 Keskeytyskriittisyys 3 1..1 Kyllä/ei tieto Laskutuskanava 3 1..1 Paperilasku Verkkolasku E-lasku Sähköposti Netposti Suoramaksu Mobiililasku Asiakkaan tarkenne 3 0..1 Tuotetieto 3 0..n Tuotteen tunnus 4 0..1 Yhteyshenkilö 3 0..n Yhteystiedot 4 0..99 Laskutusosoite 3 0..1 Verkkolaskuosoite 3 0..1 Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12) Ks. sanomatyypin yleiskuvaus (luku 12)

95 (198) Muu sähköinen laskutusosoite 3 0..1 Käyttöpaikan tiedot 3 1..1 Käyttöpaikan tunnus 4 1..1 Huom: Tarkennus Ks. sanomatyypin yleiskuvaus (luku 12) Päivitystapahtumassa toimitetaan kaikki tapahtuman tiedot, ei vain muuttuneita tietoja. Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Osoitteissa postitoimipaikka on oikea postinumeron perusteella. Tarkistus tehdään vain suomalaiselle osoitteelle. 2 Myyntisopimus löytyy järjestelmästä. 3 Jos asiointitapa on sähköinen, niin yhteystiedoissa tulee olla sähköpostiosoite 4 Voimaantulopäivä on liiketoimintaprosessien määritysten mukainen.

96 (198) 5.4 DH-322 Verkkosopimuksen tietojen päivitys Verkkosopimustietojen päivitykset tehdään jakeluverkonhaltijan toimesta datahubiin. Datahub välittää päivitetyt sopimustiedot käyttöpaikan voimassaolevalle ja mahdolliselle uudelle myyjälle. Tapahtuma DH-322-1 DH-322-2 Huom: Sanomatyyppi F04 F04 Tarkennus Sanomatyypin kuvaus Rakenteelliset tiedot, sopimus Rakenteelliset tiedot, sopimus Lähettäjä Vastaanottaja Huom:[*] JVH [1] Verkkosopimuksen muuttuneet tiedot välitetään myyjälle. Datahub Datahub Nykyinen myyjä [1] KUVA 22 DH-322 - VERKKOSOPIMUKSEN TIETOJEN PÄIVITYS Sanoman tapahtumatiedot sisältävät samat tiedot kuin tapahtuma DH-312. Päivitystapahtumassa toimitetaan kaikki sopimuksen tiedot, ei vain muuttuneita tietoja. Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Osoitteissa postitoimipaikka on oikea postinumeron perusteella. Tarkistus tehdään vain suomalaiselle osoitteelle. 2 Verkkosopimus löytyy järjestelmästä

97 (198) 5.5 DH-323 Ilmoitus myyjättömästä käyttöpaikasta Datahub välittää listan myyjättömistä käyttöpaikoista jakeluverkonhaltijalle. Tarkistus ajetaan päivittäin ja tapahtumassa raportoidaan sellaiset käyttöpaikat, joissa sopimus on päättymässä 14 pv kuluessa eikä käyttöpaikalle ole kirjattuna uutta myyjää. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-323 F05 Myyjätön käyttöpaikka Datahub JVH Huom: Tarkennus KUVA 23 DH-323 - ILMOITUS MYYJÄTTÖMISTÄ KÄYTTÖPAIKOISTA Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Käyttöpaikkatiedot 1 1..n Käyttöpaikan tunnus 2 1..1 Aluetiedot 2 1..1 Mittausalue 3 1..1 Sopimukseton aika 2 1..1 Alkuaika 3 1..1 Loppuaika 3 0..1 Huom: Tarkennus

98 (198) 5.6 DH-331 Ilmoitus myyntisopimuksen päättymisestä Myyjä ilmoittaa myyntisopimuksen päättymisestä datahubiin. Datahub välittää tiedon jakeluverkonhaltijalle, mikäli käyttöpaikalla on voimassaoleva verkkosopimus. Tapahtuma DH-331-1 DH-331-2 DH-331-3 DH-331-4 DH-311-5 Huom: Sanomatyyppi F06 F06 F06 F06 F18 Tarkennus Sanomatyypin kuvaus Rakenteelliset tiedot, sopimuksen päättäminen Rakenteelliset tiedot, sopimuksen päättäminen Rakenteelliset tiedot, sopimuksen päättäminen Rakenteelliset tiedot, sopimuksen päättäminen Rakenteelliset tiedot, sopimuksen peruminen Lähettäjä Vastaanottaja Huom:[*] Nykyinen myyjä Datahub Datahub JVH [1] Datahub Tuotantokäyttöpaikan myyjä [2] Datahub 3.osapuoli [3] Datahub Tuleva myyjä [4] [1] Ilmoitus myyntisopimuksen päättymisestä välitetään jakeluverkonhaltijalle. [2] [3] [4] Jos käyttöpaikalla on rinnakkaiskäyttöpaikka tuotannolle, niin tuotantokäyttöpaikan myyjälle (sähkön ostaja) välitetään ilmoitus sopimuksen päättymisestä ulosmuuttotilanteessa. Päättyvän myyntisopimuksen tunnusta ei välitetä. Datahub ilmoittaa 3.osapuolelle asiakkaan myyntisopimuksen päättymisestä käyttöpaikalla. Valtuutusta ei kuitenkaan peruuteta eikä päätetä, jotta historiatietoa voi hakea myös sopimuksen päättymisen jälkeen. Asiakkaan ulosmuuton yhteydessä datahub ilmoittaa myyntisopimuksen peruuntumisen käyttöpaikan myyjälle, jolla on tulevaisuudessa alkava myyntisopimus, joka ei ole sisäänmuutto.

99 (198) KUVA 24 DH-331 ILMOITUS MYYNTISOPIMUKSEN PÄÄTTYMISESTÄ Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Sopimustiedot 1 1..1 Päättymispäivämäärä 2 1..1 Alkuperäisen sanoman tunnus Alkuperäisen sanoman lähettäjä 2 0..1 Käytetään vain välitysanomassa [1] 2 0..1 Käytetään vain välitysanomassa [1] Syy 2 1..1 Ulosmuutto Irtisanominen [2]

100 (198) Purkaminen Sopimustiedot 2 1..1 Sopimustunnus 3 0..1 Sopimuksen tyyppi 3 0..1 Pakollinen alkuperäisessä sanomassa, ei välitetä välityssanomassa. Pakollinen alkuperäisessä sanomassa, ei välitetä välityssanomassa. Laskutusosoite 3 0..1 [3] Osoitteen tarkenne 4 0..1 c/o Kadun nimi 4 0..1 Talonumero 4 0..1 Porrastunnus 4 0..1 Huoneisto 4 0..1 Postinumero 4 1..1 Postilokero 4 0..1 Postitoimipaikka 4 1..1 Maa 4 1..1 Käytetään ISO 3166 alpha-2 mukaista tunnusta. Käyttöpaikan tiedot 3 1..1 Käyttöpaikan tunnus 4 1..1 Huom: [1] [2] [3] Tarkennus Datahub välittää myyjältä tulleen alkuperäisen sanoman tunnuksen välityssanoman mukana tässä kentässä. Sopimuksen peruutukset (asiakkaan tai myyjän peruutus) tehdään sopimuksen peruutussanomalla. Peruutusanomassa esitetään perumisen syy sekä tieto, onko peruminen tehty asiakkaan toimesta. Osoitetiedossa tulee postinumeron lisäksi esittää joko kadun nimi tai postilokero. Laskutusosoitteena annetaan asiakkaan uusi osoite, esimerkiksi osoite johon loppulasku toimitetaan. Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Osoitteissa postitoimipaikka on oikea postinumeron perusteella. Tarkistus tehdään vain suomalaiselle osoitteelle. 2 Voimassaoleva myyntisopimus löytyy järjestelmästä. 3 Päättymispäivämäärä on liiketoimintaprosessien määritysten mukainen.

101 (198) 5.7 DH-332 Sisäänmuuttokohteen myyjän ilmoitus asiakkaan ulosmuutosta Asiakkaan uusi myyjä ilmoittaa jakeluverkonhaltijalle asiakkaan ulosmuutosta asiakkaan nykyiselle käyttöpaikalle. Datahub välittää ilmoituksen jakeluverkonhaltijalle. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-332-1 DH-332-2 Huom: F06 F06 Tarkennus Rakenteelliset tiedot, sopimuksen päättäminen Rakenteelliset tiedot, sopimuksen päättäminen [1] Ilmoitus ulosmuutosta välitetään jakeluverkonhaltijalle. Uusi myyjä Datahub Datahub JVH [1] KUVA 25 DH-332 - SISÄÄNMUUTTOKOHTEEN MYYJÄN ILMOITUS ASIAKKAAN ULOSMUUTOSTA Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Sopimustiedot 1 1..1 Päättymispäivämäärä 2 1..1 Ulosmuuttopäivämäärä Alkuperäisen sanoman tunnus 2 0..1 Käytetään vain välitysanomassa [1]

102 (198) Alkuperäisen sanoman lähettäjä 2 0..1 Käytetään vain välitysanomassa [1] Syy 2 1..1 "Ulosmuutto", Käytetään vain välityssanomassa Käyttöpaikan tiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 Asiakkaiden perustiedot 2 1..n Asiakkaan tunniste 3 0..1 Asiakkaan tunnisteen tyyppi 3 1..1 Käytetään joko y-tunnusta, yhdistystunnusta, hetua tai osapuolen omaa tunnusta. Y-tunnus Yhdistystunnus Henkilötunnus (hetu) Osapuolen oma tunnus Yrityksen nimi 3 0..1 Pakollinen yritysasiakkaille Etunimi 3 0..1 [2] Keskimmäiset nimet 3 0..1 [2] Sukunimi 3 0..1 [2] Syntymäaika 3 0..1 [2] Laskutusosoite 2 0..1 [3] Osoitteen tarkenne 3 0..1 c/o Kadun nimi 3 0..1 Talonumero 3 0..1 Porrastunnus 3 0..1 Huoneisto 3 0..1 Postinumero 3 1..1 Postilokero 3 0..1 Postitoimipaikka 3 1..1 Maa 3 1..1 Käytetään ISO 3166 alpha-2 mukaista tunnusta. Huom: [1] [2] [3] Tarkennus Datahub välittää myyjältä tulleen alkuperäisen sanoman tunnuksen välityssanoman mukana tässä kentässä. Kenttiä käytetään asiakkaan yksilöintiin, jos asiastunnusta (hetua) ei ole esitetty sanomassa. Osoitetiedossa tulee postinumeron lisäksi esittää joko kadun nimi tai postilokero. Laskutusosoitteena annetaan asiakkaan uusi osoite, esimerkiksi osoite johon loppulasku toimitetaan.

103 (198) Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 2 Osoitteissa postitoimipaikka on oikea postinumeron perusteella. Tarkistus tehdään vain suomalaiselle osoitteelle. Asiakkaalla on voimassaoleva myynti- ja verkkosopimus järjestelmässä käyttöpaikalla. 3 Päättymispäivämäärä on liiketoimintaprosessien määritysten mukainen.

104 (198) 5.8 DH-333 Ilmoitus verkkosopimuksen päättymisestä Jakeluverkonhaltija ilmoittaa verkkosopimuksen päättymisen datahubiin. Datahub välittää tiedon myyjälle, jolla on voimassaoleva myyntisopimus käyttöpaikalla. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-333-1 DH-333-2 Huom: F06 F06 Tarkennus Rakenteelliset tiedot, sopimuksen päättäminen Rakenteelliset tiedot, sopimuksen päättäminen JVH Datahub [1] Ilmoitus verkkosopimuksen päättymisestä välitetään nykyiselle myyjälle. Datahub Nykyinen myyjä [1] KUVA 26 DH-333 - ILMOITUS VERKKOSOPIMUKSEN PÄÄTTYMISESTÄ

105 (198) Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Sopimustiedot 1 1..1 Päättymispäivämäärä 2 1..1 Alkuperäisen sanoman tunnus 2 0..1 Alkuperäisen sanoman lähettäjä 2 0..1 Syy 2 1..1 Sopimustiedot 2 1..1 Sopimustunnus 3 1..1 Käytetään vain välitysanomassa Käytetään vain välitysanomassa Ulosmuutto Irtisanominen Purkaminen [1] [1] Sopimuksen tyyppi 3 1..1 Verkkosopimus Laskutusosoite 3 0..1 [2] [3] Osoitteen tarkenne 4 0..1 c/o Kadun nimi 4 0..1 Talonumero 4 0..1 Porrastunnus 4 0..1 Huoneisto 4 0..1 Postinumero 4 1..1 Postilokero 4 0..1 Postitoimipaikka 4 1..1 Maa 4 1..1 Käytetään ISO 3166 alpha-2 mukaista tunnusta. Käyttöpaikan tiedot 3 1..1 Käyttöpaikan tunnus 4 1..1 Huom: [1] [2] [3] Tarkennus Datahub välittää verkkoyhtiöltä tulleen alkuperäisen sanoman tunnuksen välityssanoman mukana tässä kentässä. Osoitetiedossa tulee postinumeron lisäksi esittää joko kadun nimi tai postilokero. Laskutusosoitteena annetaan asiakkaan uusi osoite, esimerkiksi osoite johon loppulasku toimitetaan.

106 (198) Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Voimassaoleva verkkosopimus löytyy järjestelmästä. 2 Päättymispäivämäärä on liiketoimintaprosessien määritysten mukainen.

107 (198) 5.9 DH-340 Sopimuksen peruuttaminen Sopimusten peruuttamiseen ei käytetä yleistä peruutussanomaa (E67), vaan peruutustapahtumiin on määritelty omat sanomat. 5.9.1 DH-341 Ilmoitus myyntisopimuksen peruuttamisesta Myyjä ilmoittaa myyntisopimuksen peruuttamisesta datahubiin. Datahub välittää tiedon jakeluverkonhaltijalle ja edeltävälle myyjälle. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-341-1 F18 Rakenteelliset tiedot, sopimuksen peruminen Nykyinen myyjä Uusi myyjä Datahub DH-341-2 F18 Rakenteelliset tiedot, sopimuksen peruminen Datahub JVH [1] DH-341-3 F18 Rakenteelliset tiedot, sopimuksen peruminen Datahub Edellinen myyjä Nykyinen myyjä [2] Huom: Tarkennus [1] Ilmoitus myyntisopimuksen peruuttamisesta välitetään jakeluverkonhaltijalle. [2] Ilmoitus myyntisopimuksen peruuttamisesta välitetään edeltävälle myyjälle.

108 (198) KUVA 27 DH-341 - ILMOITUS MYYNTISOPIMUKSEN PERUUNTUMISESTA Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Sopimustiedot 1 1..1 Voimaantulopäivämäärä 2 1..1 Alkuperäisen sanoman tunnus 2 0..1 Alkuperäisen sanoman lähettäjä 2 0..1 Perumisen syy 2 1..1 Peruutettavan sopimuksen aloituspäivämäärä. Käytetään vain välitysanomassa Käytetään vain välitysanomassa Asiakas peruuttanut sopimuksen Myyjä peruuttanut sopimuksen Selite 2 0..1 Sopimustiedot 2 1..1 Sopimustunnus 3 1..1 Edeltävälle/nykyiselle myyjälle välitetään palautettavan sopimuksen sopimustunnus

109 (198) Käyttöpaikan tiedot 3 1..1 Käyttöpaikan tunnus 4 1..1 Huom: Tarkennus 5.9.2 DH-342 Ilmoitus verkkosopimuksen peruuttamisesta Jakeluverkonhaltija ilmoittaa verkkosopimuksen peruttamisesta datahubiin. Datahub välittää tiedon nykyiselle myyjälle. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-342-1 DH-342-2 Huom: [1] F18 F18 Tarkennus Rakenteelliset tiedot, sopimuksen peruminen Rakenteelliset tiedot, sopimuksen peruminen JVH Datahub Datahub Nykyinen myyjä Uusi myyjä Ilmoitus myyntisopimusksen peruuttamisesta välitetään uudelle tai nykyiselle myyjälle. Sille myyjälle, jolle alkuperäinen vahvistus on toimitettu. [1] KUVA 28 DH-342 - ILMOITUS VERKKOSOPIMUKSEN PERUUTTAMISESTA

110 (198) Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Sopimustiedot 1 1..1 Voimaantulopäivämäärä 2 1..1 Alkuperäisen sanoman tunnus 2 0..1 Alkuperäisen sanoman lähettäjä 2 0..1 Selite 2 0..1 Sopimustiedot 2 1..1 Sopimustunnus 3 1..1 Käyttöpaikan tiedot 3 1..1 Käyttöpaikan tunnus 4 1..1 Huom: Tarkennus Peruutettavan sopimuksen aloituspäivämäärä. Käytetään vain välitysanomassa Käytetään vain välitysanomassa 5.9.3 DH-343 Edeltävän myyjän ilmoitus myyntisopimuksen palautuksesta kieltäytymisestä Uuden myyjän peruuttaessa myyntisopimuksen, palautuu käyttöpaikka edeltävän myyjän myyntiin. Mikäli edeltävä myyjä ei halua jatkaa sopimusta, lähettää myyjä sopimuksen päättymisilmoituksen. Sanomasisältö on sama kuin normaalissa myyntisopimuksen päättämisessä DH-331. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-343-1 DH-343-2 Huom: F06 F06 Tarkennus Rakenteelliset tiedot, sopimuksen päättäminen Rakenteelliset tiedot, sopimuksen päättäminen Nykyinen myyjä Datahub Datahub JVH [1] [1] Ilmoitus myyntisopimuksen päättymisestä välitetään jakeluverkonhaltijalle.

111 (198) KUVA 29 DH-343 - EDELTÄVÄN MYYJÄN ILMOITUS MYYNTISOPIMUKSEN PALAUTUKSESTA KIELTÄYTYMISESTÄ 5.9.4 DH-344 Ilmoitus verkkosopimuksen päättymisestä peruutustilanteessa. Myyjän päättäessä myyntisopimuksen (DH343), jakeluverkonhaltija päättää tarvittaessa verkkosopimuksen. Sanomasisältö on sama kuin normaalissa verkkosopimuksen päättämisessä DH-333. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-344-1 DH-344-2 Huom: [1] F06 F06 Tarkennus Rakenteelliset tiedot, sopimuksen päättäminen Rakenteelliset tiedot, sopimuksen päättäminen JVH Datahub Datahub Uusi myyjä [1] Ilmoitus verkkosopimuksen päättymisestä välitetään uudelle myyjälle, joka on peruuttanut myyntisopimuksen.

112 (198) KUVA 30 DH-344 - ILMOITUS VERKKOSOPIMUKSEN PÄÄTTYMISESTÄ PERUUTUSTILANTEESSA

113 (198) 6 DH-400-Kytkentä- ja katkaisuprosessit KUVA 31 KYTKENTÄ- JA KATKAISUTAPAHTUMAT 6.1 DH-411 Toimituksen kytkentäpyyntö Myyjä välittää kytkentäpyyntötapahtuman datahubiin. Datahub välittää pyynnön jakeluverkonhaltijalle. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-411-1 F09 Kytkentä-katko Myyjä Datahub DH-411-2 F09 Kytkentä-katko Datahub JVH [1] Huom: Tarkennus [1] Kytkentäpyyntö välitetään jakeluverkonhaltijalle.

114 (198) KUVA 32 DH-411 - TOIMITUKSEN KYTKENTÄPYYNTÖ Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Kytkentäkatko 1 1..1 Kytkentäpäivämäärä 2 1..1 Alkuperäisen sanoman tunnus 2 0..1 Alkuperäisen sanoman lähettäjä 2 0..1 Käyttöpaikan tunnus 2 1..1 Käytetään vain välitysanomassa Käytetään vain välitysanomassa Kytkentätila 2 1..1 Kytkentäpyyntö Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Myyjällä on voimassaoleva myyntisopimus sekä pyyntöhetkellä että kytkentäpäivämäärällä. 2 Kytkentäpäivämäärä ei ole menneisyydessä.. 3 Käyttöpaikka löytyy järjestelmästä ja sen tila ei ole "poistettu käytöstä"..

115 (198) 6.2 DH-412 Ilmoitus toimituksen kytkennästä Jakeluverkonhaltija välittää kytkentäilmoituksen datahubiin. Datahub välittää ilmoituksen myyjälle, jolla on voimassaoleva myyntisopimus käyttöpaikalla. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-412-1 F09 Kytkentä-katko JVH Datahub DH-412-2 F09 Kytkentä-katko Datahub Myyjä [1] Huom: Tarkennus [1] Kytkentäilmoitus välitetään myyjälle. KUVA 33 DH-412 - ILMOITUS TOIMITUKSEN KYTKENNÄSTÄ

116 (198) Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Kytkentäkatko 1 1..1 Kytkentähetki 2 1..1 Alkuperäisen sanoman tunnus 2 0..1 Alkuperäisen sanoman lähettäjä 2 0..1 Käyttöpaikan tunnus 2 1..1 Käytetään vain välitysanomassa Käytetään vain välitysanomassa Kytkentätila 2 1..1 Kytketty Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Käyttöpaikka on jakeluverkon mittausalueella. 2 Käyttöpaikka löytyy järjestelmästä ja sen tila ei ole "poistettu käytöstä".

117 (198) 6.3 DH-421 Toimituksen katkaisupyyntö Myyjä välittää katkaisupyyntötapahtuman datahubiin. Datahub välittää pyynnön jakeluverkonhaltijalle. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-421-1 F09 Kytkentä-katko Myyjä Datahub DH-421-2 F09 Kytkentä-katko Datahub JVH [1] Huom: Tarkennus [1] Katkaisupyyntö välitetään jakeluverkonhaltijalle. KUVA 34 DH-421 - TOIMITUKSEN KATKAISUPYYNTÖ Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Kytkentäkatko 1 1..1 Katkaisupäivämäärä 2 1..1 Alkuperäisen sanoman tunnus 2 0..1 Käytetään vain välitysanomassa

118 (198) Alkuperäisen sanoman lähettäjä 2 0..1 Käyttöpaikan tunnus 2 1..1 Käytetään vain välitysanomassa Kytkentätila 2 1..1 Katkaisupyyntö Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Myyjällä on voimassaoleva myyntisopimus sekä pyyntöketkellä että katkaisupäivämäärällä. 2 Katkaisupäivämäärä tulee olla vähintään viikon päässä tulevaisuudessa. 3 Käyttöpaikka löytyy järjestelmästä ja sen tila ei ole "poistettu käytöstä".

119 (198) 6.4 DH-422 Ilmoitus toimituksen katkaisusta Jakeluverkonhaltija välittää katkaisuilmoituksen datahubiin. Datahub välittää ilmoituksen myyjälle, jolla on voimassaoleva myyntisopimus käyttöpaikalla.. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-422-1 F09 Kytkentä-katko JVH Datahub DH-422-2 F09 Kytkentä-katko Datahub Myyjä 3. osapuoli [1] Huom: Tarkennus [1] Katkaisuilmoitus välitetään myyjälle ja/tai mahdolliselle 3. osapuolelle. KUVA 35 DH-422 - ILMOITUS TOIMITUKSEN KATKAISUSTA

120 (198) Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Kytkentäkatko 1 1..1 Katkaisuhetki 2 1..1 Alkuperäisen sanoman tunnus 2 0..1 Alkuperäisen sanoman lähettäjä 2 0..1 Käyttöpaikan tunnus 2 1..1 Käytetään vain välitysanomassa Käytetään vain välitysanomassa Kytkentätila 2 1..1 Katkaistu Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Käyttöpaikka on jakeluverkon mittausalueella. 2 Käyttäpaikka löytyy järjestelmästä ja sen tila ei ole "poistettu käytöstä".

121 (198) 6.5 DH-413, DH-423 Ilmoitus kytkennän tai katkaisun viivästymisestä Jakeluverkonhaltija välittää viivästymisilmoituksen datahubiin. Datahub välittää ilmoituksen myyjälle, jolla on voimassaoleva myyntisopimus käyttöpaikalla. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-413-1 DH-423-1 DH-413-2 DH-423-2 F09 Kytkentä-katko JVH Datahub F09 Kytkentä-katko Datahub Myyjä [1] Huom: Tarkennus [1] Ilmoitus viivästymisestä välitetään myyjälle. KUVA 36 DH-413 - ILMOITUS KYTKENNÄN VIIVÄSTYMISESTÄ

122 (198) Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Kytkentäkatko 1 1..1 Aikaisintaan 2 1..1 Alkuperäisen sanoman tunnus Alkuperäisen sanoman lähettäjä Käyttöpaikan tunnus 2 1..1 Pyydetty kytkentätila 2 1..1 Aikaisin hetki kytkennälle/katkaisulle 2 0..1 Käytetään vain välitysanomassa 2 0..1 Käytetään vain välitysanomassa Ilmoitetaan se tila, jota myyjä on pyytänyt. Selite 2 0..1 Selite katkaisun viivästymiselle Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Käyttöpaikka on jakeluverkon mittausalueella. 2 Käyttöpaikka löytyy järjestelmästä.

123 (198) 7 DH-500-Taseselvitys KUVA 37 TASESELVITYSTAPAHTUMAT Datahub suorittaa taseselvityslaskennat jakeluverkonhaltijoiden osalta ja toimittaa taseselvitystiedot esett:lle. Tietojen välitys tapahtuu NBS-määritysten mukaisesti (www.ediel.org), eikä tapahtumia DH-511-DH-513 kuvata tässä dokumentissa. esett toimittaa jakeluverkonhaltijoiden tasepoikkeamatiedot datahubiiin ja datahub välittää tiedot jakeluverkonhaltijoille ja myyjille. Myös tapahtuma DH-512 noudattaa NBS-määrityksiä (www.ediel.org) eikä sitä kuvata tässä dokumentissa.

124 (198) 7.1 DH-514, DH-522 Jakeluverkonhaltijan taseselvitystiedot Taseselvitystiedot lähetetään jakeluverkonhaltijalle, kun tasepoikkeamatiedot vastaanotetaan esett:ltä. Jakelunverkonhaltija voi myös hakea mittausalueittensa taseselvitystiedot datahubista. Tietoja voidaan hakea myyjäkohtaisesti tai mittausalueen kokonaissummana. Palautuksessa toimitetaan kaikki taseselvityssarjat. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-514 E31 Taseselvitystiedot Datahub JVH DH-522-1 F10 Taseselvitystiedon haku JVH Datahub DH-522-2 E31 Taseselvitystiedot Datahub JVH KUVA 38 DH-514 - TASESELVITYSTIETOJEN ILMOITUS JAKELUVERKONHALTIJALLE

125 (198) KUVA 39 DH-522 - TASESELVITYSTIETOJEN HAKU - JVH Kyselytapahtumassa annetaan seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Aikasarjapyyntö 1 1..9999 Mittausalueen tunnus 2 1..1 Myyjän tunnus 2 0..1 [1] Pyyntöaikaväli 2 1..1 Alkuaika 3 1..1 Loppuaika 3 1..1 Huom: Tarkennus [1] Jos myyjän tunnusta ei anneta, palautetaan mittausalueen kokonaissummat Taseselvitystiedoissa ja vastaustapahtumassa palautetaan seuraavat aikasarjatiedot Tietokenttä Taso Pakollisuus Kommentti Huom: Summasaikasarja 1 1..9999 Aikasarjan tunnus 2 1..1 Sanoman luontiaika 2 1..1 Raportointiaikaväli 2 1..1

126 (198) Aika-askel 3 1..1 Alkuaika 3 1..1 Loppuaika 3 1..1 Summasarjan tyyppi 2 Tuotteen tyyppi 3 1..1 Pätöenergia Yksikkö 3 1..1 Aikasarjan ominaisuudet 2 1..1 Aikasarjan tyyppi 3 1..1 Taseselvitystapa 3 1..1 Kulutus Tuotanto Rajapiste Profiilitaseselvitys Tuntitaseselvitys Laskentatyyppi 3 1..1 Kts. lisäkommentti [1] Myyjä 2 0..1 Myyjän tunnus 3 0..1 Aluetiedot 2 1..1 Mittausalueen tunnus 3 1..1 Ottoalue 2 0..1 Ottoalueen tunnus 3 1..1 Antoalue 2 0..1 Antoalueen tunnus 3 1..1 Aikasarja-arvot 2 1..9999 Positio 3 1..1 Arvot 3 1..1 Arvo 4 1..1 Status 4 1..1 Huom: Tarkennus

127 (198) Mittausaluekohtaiset myyjäsummat: Myyjän mitattu summatoimitus Myyjän profiloitu summatoimitus Myyjän pientuotantosumma Myyjän omakäyttösumma Myyjän mittausalueen häviöt [1] Mittausaluekohtaiset summat: Mittausalueen kokonaisrajapistesumma Mittausalueen rajapistesumma Mittausalueen mitattu summatoimitus Mittausalueen profiloitu summatoimitus Mittausalueen tuotantoyksikkösumma Mittausalueen tasepoikkeama Mittausalueen häviöt Mittausalueen omakäyttösumma Mittausalueen pientuotantosumma Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Mittausalue kuuluu jakeluverkonhaltijalle

128 (198) 7.2 DH-515, DH-521 Myyjän taseselvitystiedot Taseselvitystiedot lähetetään jakeluverkonhaltijalle, kun tasepoikkeamatiedot vastaanotetaan esett:ltä. Myyjä voi hakea myyjäkohtaisia mittausalueen summatietoja datahubista. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-515 E31 Taseselvitystiedot Datahub Myyjä DH-521-1 F10 Taseselvitystiedon haku Myyjä Datahub DH-521-2 E31 Taseselvitystiedot Datahub Myyjä [1] KUVA 40 DH-515 - TASESELVITYSTIETOJEN ILMOITUS MYYJÄLLE KUVA 41 DH-521 - TASESELVITYSTIETOJEN HAKU - MYYJÄ

129 (198) Kyselytapahtumassa annetaan seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Aikasarjapyyntö 1 1..9999 Mittausalueen tunnus 2 1..1 Pyyntöaikaväli 2 1..1 Alkuaika 3 1..1 Loppuaika 3 1..1 Kyselytapahtumassa ei tehdä pakollisuuksien lisäksi muita tapahtumavalidointeja. Virheilmoitus palautetaan, jos yhtään summasarjaa ei löydy hakukriteereillä. Taseselvitystiedoissa ja vastaustapahtumassa palautetaan seuraavat aikasarjatiedot Tietokenttä Taso Pakollisuus Kommentti Huom: Summa-aikasarja 1 1..9999 Aikasarjan tunnus 2 1..1 Sanoman luontiaika 2 1..1 Raportointiaikaväli 2 1..1 Aika-askel 3 1..1 Alkuaika 3 1..1 Loppuaika 3 1..1 Summasarjan tyyppi 2 Tuotteen tyyppi 3 1..1 Pätöenergia Yksikkö 3 1..1 Aikasarjan ominaisuudet 2 1..1 Aikasarjan tyyppi 3 1..1 Taseselvitystapa 3 1..1 Kulutus Tuotanto Profiilitaseselvitys Tuntitaseselvitys Laskentatyyppi 3 1..1 Kts. lisäkommentti [1] Myyjä 2 1..1 Myyjän tunnus 3 1..1 Aluetiedot 2 1..1 Mittausalue 3 1..1

130 (198) Aikasarja-arvot 2 1..9999 Positio 3 1..1 Arvot 3 1..1 Arvo 4 1..1 Status 4 1..1 Huom: [1] Tarkennus Mittausaluekohtaiset myyjäsummat: Myyjän mitattu summatoimitus Myyjän profiloitu summatoimitus Myyjän pientuotantosumma Myyjän omakäyttösumma Myyjän mittausalueen häviöt

131 (198) 7.3 DH-523 Häviöihin kirjattujen kulutusten ja tuotantojen haku Jakeluverkonhaltija voi hakea häviötietojaan datahubista. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-523-1 F08 Mittaustiedon haku JVH Datahub [1] DH-523-2 E66 Mittaustiedot Datahub JVH [1] Huom: Tarkennus [1] Häviötietoja haetaan mittaustietojen haun kautta mittausaluekohtaisesti. KUVA 42 DH-523 - HÄVIÖIHIN KIRJATTUJEN KULUTUSTEN JA TUOTANTOJEN HAKU Kyselytapahtumassa annetaan seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Mittaushaku 1 1..1 Mittausalue 2 1..1 Hakuaikaväli 2 1..1 Alkuaika 3 1..1 Loppuaika 3 1..1

132 (198) Kyselylle tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Kyselyaikaväli on korkeintaan yksi vuosi. 2 Kyselyaikaväli ei ole tulevaisuudessa eikä yli 6 vuoden takana menneisyydessä. Vastaustapahtumassa palautetaan seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Mittausaikasarja 1 1..9999 Aikasarjan tunnus 2 1..1 Sanoman luontiaika 2 1..1 Raportointiaikaväli 2 1..1 Aika-askel 3 1..1 Alkuaika 3 1..1 Loppuaika 3 1..1 Mittauksen tyyppi 2 1..1 Lähettäjäkohtaisesti yksilöivä aikasarjan tunniste [1] Mittausaikasarjan tyyppi 3 1..1 Kulutus Tuotanto Yksikkö 3 1..1 Mittauksen ominaisuudet Mittauspisteen tyyppi 2 1..1 3 1..1 Käyttöpaikka Mittauspiste 2 1..1 Mittauspisteen tunnus 3 1..1 Aluetiedot 2 1..1 Mittausalueen tunnus 3 1..1 Aikasarja-arvot 2 1..9999 Positio 3 1..1 Arvot 3 1..1 Arvo 4 0..1 [2] Arvo puuttuu 4 0..1 Kyllä/Ei [2]

133 (198) Status 4 0..1 Epävarma Arvioitu Korjattu OK [3] Huom: [1] Tarkennus Aikasarjatiedot liitetään mittauspisteeseen mittauspisteen tunnus -kentän perusteella. Aikasarjan tunnuksena ilmoitetaan Järjestelmään tallennettu käyttöpaikan mittaustietoja ilmoittavan järjestelmän käyttämä aikasarjatunnus, jota voidaan käyttää mahdollisten ongelmatilanteiden selvityksessä. [2] Esitetään joko arvo tai arvo-puuttuu tieto. [3] Status esitetään, jos muu kuin mitattu. (136=OK) (Puuttuva), ei esitetä, vaan ilmaistaan Arvo puutttuu kentällä. Epävarma Arvioitu Korjattu OK

134 (198) 8 DH-600-Tasevirheiden korjaus KUVA 43 TASEVIRHETAPAHTUMAT Datahub välittää tasevirhelaskennan tulokset myyjille ja jakeluverkonhaltijoille. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus DH-611 F19 Tasevirhetiedot Datahub Myyjä DH-612 F19 Tasevirhetiedot Datahub JVH Lähettäjä Vastaanottaja Huom:[*] KUVA 44 DH-611 - TASEVIRHETIETOJEN ILMOITUS MYYJÄLLE

135 (198) KUVA 45 DH-612 - TASEVIRHETIETOJEN ILMOITUS JAKELUVERKONHALTIJALLE Tasevirhetiedoissa palautetaan seuraavat tiedot Tietokenttä Taso Pakollisuus Kommentti Huom: Tasevirhetiedot 1 1..9999 Mittausalueen tunnus 2 1..1 Myyjä 2 1..1 Ks. sanomatyypin yleiskuvaus (luku 12) Rekisteröintipäivä 2 1..1 Tasevirheen laskentahetki Korjaussumma yhteensä 2 1..1 EUR Raportointiaikaväli 2 1..1 Aika-askel 3 1..1 Alkuaika 3 1..1 Loppuaika 3 1..1 Tasevirheet 2 1..n Tasevirheen tyyppi 3 0..1 Käyttöpaikka 3 0..1 Käyttöpaikka Häviö Käytetään vain käyttöpaikkakohtaisille sarjoille. Tuntiarvot 3 1..9999 Positio 4 1..1 Mitattu energia 4 0..1 kwh [1] Taseeseen viety energia 4 0..1 kwh [2] Tasevirhe 4 1..1 kwh [3]

136 (198) Hintatiedot 2 1..9999 Positio 3 1..1 SPOT-hinta 3 1..1 EUR/MWh Korjaus yhteensä 3 1..1 EUR Korjattava energia yhteensä Huom: [1] [2] [3] Tarkennus 3 1..1 kwh Mitattu energia ilmoitetaan käyttöpaikkojen osalta vain, jos kyseisellä myyjällä on kyseiselle tunnille tasetiedon mukainen tasevastuu kyseiselle käyttöpaikalle. Taseeseen viety energia ilmoitetaan käyttöpaikkojen osalta vain, jos kyseisellä myyjällä on kyseiselle tunnille taseselvitysikkunan sulkeutuessa rekisteröity tai aiemmassa tasevirheiden laskennassa rekisteröity tasevastuu kyseiselle käyttöpaikalle, ja kyseiselle tunnille kyseisellä käyttöpaikalla on olemassa mittausarvo. Arvoksi merkitään nolla, jos mitattua energiaa eikä taseeseen vietyä energiaa ole määritetty.

137 (198) 9 DH-700-Tuote- ja laskutustiedon ylläpitoprosessit KUVA 46 TUOTE- JA LASKURIVITAPAHTUMAT

138 (198) 9.1 DH-711, DH-712 Tuotetietojen päivitys Tuotetietojen päivitystapahtumalla jakeluverkonhaltija ja myyjä ylläpitävät sopimustuotteidensa tiedot datahubissa. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-711 F11 Rakenteelliset tiedot, tuote Myyjä Datahub DH-712 F11 Rakenteelliset tiedot, tuote JVH Datahub KUVA 47 DH-710 - TUOTETIEDON PÄIVITYS Päivitystapahtuma sisältää seuraavat tiedot. Tietokenttä Taso Pakollisuus Kommentti Huom: Tuotetiedot 1 1..n Tuotteen voimassaoloaika 2 0..1 Alkuaika 3 1..1 Loppuaika 3 0..1 Tuotteen tunnus 2 1..1 Tuotteen omistajan osapuolitunnus 2 1..1 Myyjä tai jakeluverkonhaltija

139 (198) Tuotteen kuvaus 2 0..1 Tuotteen nimi 2 1..n Kieli 3 1..1 Tuotteen nimi 3 1..1 Tuotekomponentit 2 1..n Tuotekomponentin tunnus 3 1..1 Tuotekomponentin tiedot 3 1..n Kieli 4 1..1 Tuotekomponentin nimi 4 1..1 Hinnan yksikkö 4 1..1 Kalenteriaikasarja 3 0..1 Käytetään myös hinta-aikasarjan yksikkönä. Ks. sanomatyypin yleiskuvaus (luku 12) Hintatiedot 3 1..n Hinta 4 0..1 [1] Hinnan voimassaoloaika 4 0..1 [1] Alkuaika 5 1..1 Loppuaika 5 0..1 Hinta-aikasarja 4 0..1 Ks. sanomatyypin yleiskuvaus (luku 12) [1] Huom: [1] Tarkennus Esitetään joko kiinteä hinta tai aikasarjapohjainen hinta. Kiinteä hinta esitetään Hinta kentällä ja hinnan voimassaololla. Aikasarjapohjainen hinta (esim tuntihinta) esitetään hinta-aikasarjalla. Tiedon välityksessä ja hakujen palautuksessa hintatiedot esitetään vain, jos osapuolella on valtuutus tietoihin.

140 (198) 9.2 DH-721, DH-722, DH-723 Tuotetietojen haku Tuotetietojen haulla osapuolet (jakeluverkonhaltija, myyjä 3.osapuoli) hakevat toisen osapuolen tuotetietoja datahubista. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-721-1 Myyjä DH-722-1 F12 Tuotetietojen haku JVH Datahub DH-723-1 3. osapuoli DH-721-2 DH-722-2 DH-723-2 F11 Rakenteelliset tiedot, tuote Datahub Myyjä JVH 3. osapuoli Huom: Tarkennus KUVA 48 DH-720 - TUOTETIEDON HAKU Kyselytapahtumassa annetaan seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Tuotehaku 1 1..1 Tuotteen omistaja 2 0..n Myyjä tai jakeluverkonhaltija

141 (198) Tuotehaussa palautetaan hakuhetkellä voimassaolevat ja tulevaisuudessa voimaan tulevat tuotteet. Palautettavat tiedot ovat samat kuin tuotetietojen päivityksessä (DH-711, DH-712).

142 (198) 9.3 DH-731, DH-732 Laskurivitietojen ilmoitus Jakeluverkonhaltija ja myyjä voivat ilmoittaa laskurivitiedot datahubiin laskutustietotapahtumilla. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-731-1 F13 Laskutustiedot Myyjä Datahub DH-731-2 F13 Laskutustiedot Datahub JVH DH-731-3 F13 Laskutustiedot Datahub 3.osapuoli DH-732-1 F13 Laskutustiedot JVH Datahub DH-732-2 F13 Laskutustiedot Datahub Myyjä DH-732-3 F13 Laskutustiedot Datahub 3.osapuoli Huom: [*] Tarkennus Laskurivitiedot välitetään osapuolille, joilla on valtuutus laskurivitietoihin lähettävän osapuolen osalta. KUVA 49 DH-730 - LASKURIVITIETOJEN ILMOITUS

143 (198) Laskurivitietojen ilmoitustapahtuma sisältää seuraavat tiedot. Tietokenttä Taso Pakollisuus Kommentti Huom: Laskurivitiedot 1 1..1 Käyttöpaikan tunnus 2 1..1 Sopimuksen tunnus 2 1..1 Osapuolitunnus 2 1..1 Kokonaislaskutusaikaväli 2 1..1 Alkuaika 3 1..1 Loppuaika 3 1..1 Laskurivit 2 1..n Tuotteen tunnus 3 1..1 Tuotekomponentin tunnus 3 1..1 Hinta 3 1..1 0.0489 [1] Hinnan yksikkö 3 1..1 Valuutta 3 1..1 EUR Hinnan verollisuus 3 1..1 Kyllä/Ei Määrä 3 1..1 100 Määrän yksikkö 3 1..1 kwh Laskurivin summa 3 1..1 4.89 [1] Selite 3 0..1 ALV-prosentti 3 1..1 24.00 Alkuaika 3 1..1 Loppuaika 3 1..1 Huom: [1] Tarkennus Hinnan yksikkö on valuutta/määrän yksikkö. Esim EUR/kWh Summan yksikkö on valuutta. Esim EUR.

144 (198) 9.4 DH-741, DH-742, DH-743 Laskurivitietojen haku Laskurivitietojen haulla osapuolet (jakeluverkonhaltija, myyjä 3.osapuoli) hakevat toisen osapuolen toimittamia laskurivitietoja datahubista. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-741-1 Myyjä DH-742-1 F14 Laskurivitietojen haku JVH Datahub DH-743-1 3. osapuoli DH-741-2 DH-742-2 DH-743-2 F13 Laskutustiedot Datahub Myyjä JVH 3. osapuoli Huom: Tarkennus

145 (198) KUVA 50 DH-740-LASKURIVITIETOJEN HAKU Kyselytapahtumassa annetaan seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Huom: Laskutustietojen haku 1 1..n Osapuolitunnus 2 0..1 [2] Käyttöpaikan tunnus 2 0..1 [2] Sopimustunnus 2 0..1 Laskutusaikaväli 2 1..1 [1]

146 (198) Alkuaika 3 1..1 Loppuaika 3 1..1 Huom: Tarkennus [1] Palautetaan laskirivt, jotka leikkavat laskutusaikaväliä. [2] Haetaan joko osapuolen tunnuksella tai yksittäinen käyttöpaikka/sopimus. Jos hakua ei rajata osapuolella ja/tai käyttöpaikalla, palautetaan kaikki hakijalle kuuluvat laskurivit. Laskurivitietojen haussa palautetaan laskurivitiedot. Palautettavat tiedot ovat samat kuin laskurivitietojen päivityksessä (DH-731, DH-732).

147 (198) 10 DH-800-Valtuutukset KUVA 51 VALTUUTUSTAPAHTUMAT 10.1 DH-811, DH-812, DH-813 Asiakkaan valtuutuksesta ilmoitus osapuolelta Myyjä, jakeluverkonhaltija ja 3. osapuoli ilmoittavat asiakkaalta saadun valtuutuksen datahubiin. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-811 F15 Valtuutustiedot Myyjä Datahub DH-812 F15 Valtuutustiedot 3. osapuoli Datahub DH-813 F15 Valtuutustiedot JVH Datahub

148 (198) KUVA 52 DH-810-ASIAKKAAN VALTUUTUKSEN ILMOITUS Tietokenttä Taso Pakollisuus Kommentti Huom: Valtuutus 1 1..n Selite 2 0..1 Vapaamuotoinen selite Osapuolitunnus 2 1..1 Ilmoittavan osapuolen tunnus Valtuutuksen aikaväli 2 1..1 Alkuaika 3 1..1 Loppuaika 3 1..1 Valtuutuksen syy/tarkoitus 2 1..1 Energiaraportointi Tarjouspyyntö Sopimuksen kilpailutus palveluna Käyttöpaikan tunnus 2 1..1 Asiakkaiden tiedot 2 1..n Asiakkaan tunniste 3 1..1 Huom: Tarkennus

149 (198) Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Valtuutuksen tehneellä asiakkaalla tulee olla voimassa oleva myynti- tai verkkosopimus käyttöpaikalle valtuutusajalle. 10.2 DH-821, DH-822, DH-823 Asiakkaan antamasta valtuutuksesta ilmoitus osapuolelle Asiakas on muokannut osapuolelle annettua valtuutusta oman käyttöliittymänsä kautta. Datahub välittää osapuolelle tiedon valtuutuksen muutoksesta. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus DH-821 F15 Valtuutustiedot Datahub Myyjä Lähettäjä Vastaanottaja Huom:[*] DH-822 F15 Valtuutustiedot Datahub 3. osapuoli DH-823 F15 Valtuutustiedot Datahub JVH KUVA 53 DH-820-ASIAKKAAN ANTAMAN VALTUUTUKSEN ILMOITUS Tietokenttä Taso Pakollisuus Kommentti Huom: Valtuutus 1 1..n Selite 2 0..1 Vapaamuotoinen selite Osapuolitunnus 2 1..1 Valtuutetun osapuolen tunnus

150 (198) Valtuutuksen aikaväli 2 1..1 Alkuaika 3 1..1 Loppuaika 3 1..1 Valtuutuksen syy/tarkoitus 2 1..1 Energiaraportointi Tarjouspyyntö Sopimuksen kilpailutus palveluna Käyttöpaikan tunnus 2 1..1 Asiakkaiden tiedot 2 1..1 [1] Asiakkaan tunniste 3 1..1 Huom: Tarkennus [1] Asiakas voi antaa valtuutuksen vain omiin tietoihinsa Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Valtuutuksen tehneellä asiakkaalla tulee olla voimassa oleva myynti- tai verkkosopimus käyttöpaikalle valtuutusajalle.

151 (198) 11 DH-900-Osapuolitiedot KUVA 54 OSAPUOLITAPAHTUMAT 11.1 DH-910 Osapuolitiedot Osapuolitiedot ylläpidetään online-palvelun kautta. Datahub välittää uudet ja muuttuneet tiedot jakeluverkonhaltijoille, myyjille ja 3. osapuolille. Tapahtuma Sanomatyyppi Sanomatyypin kuvaus DH-911 F16 Osapuolitiedot Datahub Myyjä DH-912 F16 Osapuolitiedot Datahub JVH Lähettäjä Vastaanottaja Huom:[*] DH-913 F16 Osapuolitiedot Datahub 3. osapuoli KUVA 55 DH-910 OSAPUOLITIETOJEN ILMOITUS

152 (198) Osapuolitapahtuma sisältää seuraavat tiedot. Tietokenttä Taso Pakollisuus Kommentti Huom: Osapuolitiedot 1 1..n Osapuolen perustiedot 2 1..1 Voimaantulopäivämäärä 3 1..1 Osapuolitunnus 3 1..1 Käytetään GS1-tunnusta Osapuolen tyyppi 3 1..1 Jakeluverkonhaltija Myyjä 3. osapuoli Osapuolen Y-tunnus 3 1..1 Osapuolen nimi 3 1..1 Laskutuskanava 3 1..1 Maa 3 1..1 Paperilasku Verkkolasku E-lasku Sähköposti Netposti Käytetään ISO 3166I mukaista tunnusta. Yhteislaskutus 3 0..1 Kyllä/Ei Yhteyshenkilö 3 0..n Tyyppi 4 1..1 Edunvalvoja Sopimusvastaava Laskutusvastaava Kytkentävastaava Vikaviestintä Etunimi 4 0..1 Sukunimi 4 0..1 Muu Nimi 4 0..1 Yhteystiedot 4 0..2 Tyyppi 5 1..1 Puhelin Sähköpostiosoite Puhelinumero Sähköpostiosoite 5 1..1 Laskutusosoite 3 0..n Osoitteen tarkenne 4 0..1 c/o Kadun nimi 4 0..1

153 (198) Talonumero 4 0..1 Porrastunnus 4 0..1 Huoneisto 4 0..1 Postinumero 4 1..1 Postilokero 4 0..1 Postitoimipaikka 4 1..1 Maa 4 1..1 Verkkolaskuosoite 3 0..1 Kohdiste 4 0..1 Verkkolaskuosoite 4 1..1 Välittäjän tunnus 4 1..1 Pankkiyhteystedot 3 0..1 IBAN tunnus 4 1..1 Pankin nimi 4 1..1 SWIFT tunnus 4 1..1 Postisoite 3 1..1 Osoitteen tarkenne 4 0..1 c/o Kadun nimi 4 0..1 Talonumero 4 0..1 Porrastunnus 4 0..1 Huoneisto 4 0..1 Postinumero 4 1..1 Postilokero 4 0..1 Postitoimipaikka 4 1..1 Maa 4 1..1 Käytetään ISO 3166 alpha-2 mukaista tunnusta. Käytetään ISO 3166I mukaista tunnusta.

154 (198) 11.2 DH-920 Osapuolitietojen haku Tapahtuma Sanomatyyppi Sanomatyypin kuvaus Lähettäjä Vastaanottaja Huom:[*] DH-921-1 Myyjä DH-922-1 F17 Osapuolihaku JVH Datahub DH-923-1 3. osapuoli DH-921-2 DH-922-2 DH-923-2 F16 Osapuolitiedot Datahub Myyjä JVH 3. osapuoli Huom: Tarkennus KUVA 56 DH-920 OSAPUOLITIETOJEN HAKU Osapuolitietoja voidaan hakea datahubista seuraavalla kyselyllä. Tietokenttä Taso Pakollisuus Kommentti Huom: Osapuolihaku 1 1..n Osapuolitunnus 2 0..n Käytetään GS1-tunnusta Haussa palautetaan osapuolen tiedot. Palautettavat tiedot ovat samat kuin osapuolitietojen päivityksessä. (DH-911, DH-912, DH-913).

155 (198) 12 Sanomatyyppien kuvaukset Tässä luvussa kuvataan yleiset sanomatyypit, joilla datahub-tapahtumat toteutetaan. XMLelementtien nimet ovat viitteelliset ja niihin tulee muutoksia siinä vaiheessa, kun XML-schemat määritellään. Taulukoissa T tarkoittaa tiedon tasoa xml-rakenteessa. Sarake P ilmaisee tiedon kardinaliteetin. 12.1 Otsikko Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Huom Otsikkotiedot 1 1..1 Header Sanoman tunnus 2 1..1 A36 123e4567-e89b- 12d3-a456-426656756520 Identification Sanoman tyyppi 2 1..1 A3 E58 DocumentType Sanoman luontiaika Sanoman tekninen lähettäjä Lähettäjän tunnus Sanoman juridinen lähettäjä Lähettäjän tunnus Sanoman juridinen vastaanottaja Vastaanottajan tunnus Sanoman tekninen vastaanottaja Vastaanottajan tunnus Lähettäjän reititystieto 2 1..1 Aikaleima 2 1..1 2015-06- 12T21:00:00+00: 00 Creation PhysicalSenderEne rgyparty 3 1..1 A16 6458237348480 Identification 2 1..1 JuridicalSenderEne rgyparty 3 1..1 A16 6458237348480 Identification 2 1..1 JuridicalRecipientE nergyparty 3 1..1 A16 FG Identification 2 1..1 PhysicalRecipientE nergyparty 3 1..1 A16 FG Identification 2 0..1 schemeagencyiden tifier=260, 9 tai 305 schemeagencyiden tifier=260, 9 tai 305 schemeagencyiden tifier=260, 9 tai 305 schemeagencyiden tifier=260, 9 tai 305

156 (198) 12.2 Prosessi Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Huom Prosessi 1 1..1 ProcessEnergyCon text Prosessin tunnus 2 1..1 A10 DH-111 EnergyBusinessPro cess Rooli 2 1..1 A3 DDM Toimiala 2 1..1 A3 23=Sähkö EnergyBusinessPro cessrole EnergyIndustryClas sification 12.3 Tapahtumatiedot 12.3.1 F01 Rakenteelliset tiedot, asiakas Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Huom Asiakastiedot 1 1..1 MasterDataCustom erevent Voimaantulopäiv ämäärä 2 1..1 Aikaleima 2015-06- 12T21:00:00+00: 00 StartOfOccurrence Alkuperäisen sanoman tunnus 2 0..1 A36 123e4567-e89b- 12d3-a456-426656756520 OriginalBusinessDo cumentreference Alkuperäisen sanoman lähettäjä 2 0..1 A16 6458237348480 OriginalBusinessDo cumentsender schemeagencyiden tifier=9 Selite 2 0..1 A150 Vapaa selite Description Asiakkaan perustiedot 2 1..1 ConsumerInvolved CustomerParty Asiakkaan tunniste 3 1..1 A50 010191-090U Identification schemeagencyiden tifier=260 AA01=Y-tunnus Asiakkaan tunnisteen tyyppi 3 1..1 A4 AA02=Yhdistystu nnus AA03= Henkilötunnus (hetu) IdentificationType listagencyidentifier =NFI AA04=Osapuolen oma tunnus

157 (198) Asiakkaan tyyppi 3 1..1 A4 AB01=Yritys AB02=Kuluttaja CustomerType listagencyidentifier =NFI Asiakkaan alityyppi 3 0..1 A4 BF01=Normaali BF02=Kuolinpesä CustomerSubType Osapuolen oma asiakastunnus 3 0..1 A50 HKE_12345 AlternateIdentificati on Salattu-tieto 3 0..1 A1 0=ei salausta 1=salattu InformationRestricti on Kieli 3 0..1 A3 fi Language schemeagencyiden tifier=5 (ISO 639-1 Code) Yrityksen nimi 3 0..1 A90 Oy datahub Ab Name Etunimi 3 0..1 A50 Esa GivenName Keskimmäiset nimet 3 0..1 A50 Mikko Ylermi MiddleName Sukunimi 3 0..1 A50 Jaatikainen FamilyName Syntymäaika 3 0..1 Päivä 1991-01-01 DateOfBirth VVVV-KK-PP Lisätunnus 3 0..1 A50 AdditionalCode Yhteystiedot 3 0..2 Communication Yhteystiedon tyyppi 4 0..1 A4 AD01=Puhelin AD02=Sähköposti osoite CommunicationCha nnel listagencyidentifier =NFI Puhelinnumero/ Sähköpostiosoite 4 0..1 A90 nimi.sukunimi@d omain.com CompleteNumber Postisoite 3 0..1 ConsumerInvolved CustomerAddress Osoitteen tarkenne 4 0..1 A90 Oy datahub Ab CareOf Kadun nimi 4 0..1 A90 Syyriankatu StreetName Talonumero 4 0..1 A10 21 BuildingNumber Porrastunnus 4 0..1 A5 A FloorIdentification Huoneisto 4 0..1 A5 13 RoomIdentification Postinumero 4 0..1 A10 00510 Postcode Postilokero 4 0..1 A10 15 Pobox Postitoimipaikka 4 0..1 A50 Helsinki CityName

158 (198) Maa 4 0..1 A2 FI Huom: CountryCode schemeagencyiden tifier=5 ISO 3166 alpha-2 Tarkennus. 12.3.2 F02 Käyttöpaikkatunnuksen kysely Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Huom Käyttöpaikan osoitekysely 1 1..1 RequestMPList Kadun nimi 2 1..1 A90 Syyriankatu StreetName Talonumero 2 0..1 A10 21 BuildingNumber Porrastunnus 2 0..1 A5 A FloorIdentification Huoneisto 2 0..1 A5 13 RoomIdentification Postinumero 2 0..1 A10 00510 Postcode Postitoimipaikka 2 0..1 A50 Helsinki CityName Mittarinumero 2 0..1 A50 12345 MeterIdentification AG01=Kulutus Käyttöpaikan tyyppi 2 0..1 A4 AG02=Tuotanto AG03=Tuotantoyk sikön oma käyttö MeteringPointType listagencyidentifier =NFI Käyttöpaikan alityyppi 2 1..1 A4 AQ01=Normaali AQ02=Kiinteistök ayttöpaikka MeteringPointSubT ype listagencyidentifier =NFI Rinnakkaiskäytt öpaikan tunnus 2 0..1 A90 70705750002293 9823 RelatedMeteringPoi nt schemeagencyiden tifier=9 12.3.3 F20 Käyttöpaikkalista Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Huom Käyttöpaikkalista Käyttöpaikan perustiedot 1 1..1 ResponseMPList 2 1..n MeteringPointList Käyttöpaikan tunnus 3 1..1 A90 64582373484845 8216 Identification schemeagencyiden tifier=9 Käyttöpaikan tila 3 1..1 A4 AE01=Kytketty AE02=Katkaistu PhysicalStatusType listagencyidentifier =NFI

159 (198) Etäkytkettävä 3 1..1 A1 AE03=Rakenteilla AE04=Poistettu käytöstä 0=ei etäkytkettävä 1=etäkytkettävä RemoteConnectabl e AG01=Kulutus Käyttöpaikan tyyppi 3 1..1 A4 AG02=Tuotanto AG03=Tuotantoyk sikön oma käyttö MeteringPointType listagencyidentifier =NFI Käyttöpaikan alityyppi 3 1..1 A4 AQ01=Normaali AQ02=Kiinteistök ayttöpaikka MeteringPointSubT ype listagencyidentifier =NFI Mittarinumero 3 0..1 A50 12345 MeterIdentification Rinnakkaiskäyttöpaikan tunnus 3 0..1 A90 70705750002293 9823 RelatedMeteringPoi nt schemeagencyiden tifier=9 Aluetiedot 3 1..1 MeteringGridAreaU seddomainlocation Mittausalueen nimi 4 1..1 A50 Name Mittausalueen tunnus 4 1..1 A50 44Y1001A1001A4 6L Identification schemeagencyiden tifier=305 Z01=Alueellinen Z03=Teollinen Z04=Jakelu Mittausalueen tyyppi 4 1..1 A3 Z05=Mittausluvat on Z06=Tuotanto Type Z07=Siirto (kantaverkko) Käyttöpaikan osoite 3 0..n MeteringPointAddre ss Osoitteen tyyppi 4 1..1 A4 AF01=Pääosoite AF02=Lisäosoite Type listagencyidentifier =NFI Kadun nimi 4 0..1 A90 Syyriankatu StreetName Talonumero 4 0..1 A10 21 BuildingNumber Porrastunnus 4 0..1 A5 A FloorIdentification Huoneisto 4 0..1 A5 13 RoomIdentification Postinumero 4 1..1 A10 00510 Postcode Postitoimipaikka 4 1..1 A50 Helsinki CityName

160 (198) Maa 4 1..1 A2 FI CountryCode schemeagencyiden tifier=5 ISO 3166 alpha-2 Osoitteen tarkenne 4 0..1 A150 Kolmas pylväs vasemmalta sillalta katsoen AddressFreeForm Kieli 4 1..1 A3 fi Language schemeagencyiden tifier=5 (ISO 639-1 Code) Koordinaatisto 3 0..1 MPPositionMeterin gpointgeographical Coordinate Leveysaste 4 1..1 A10 61 10,27 N Latitude Pituusaste 4 1..1 A10 24 33,67 E Longitude 12.3.4 E58 Rakenteelliset tiedot, käyttöpaikka Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Huom Käyttöpaikkatiedot 1 1..1 MasterDataMPEve nt 2 1..1 Aikaleima Voimaantulopäivämäärä 2015-06- 12T21:00:00+00: 00 StartOfOccurrence Alkuperäisen sanoman tunnus 2 0..1 A36 123e4567-e89b- 12d3-a456-426656756520 OriginalBusinessDo cumentreference Alkuperäisen sanoman lähettäjä 2 0..1 A16 6458237348480 OriginalBusinessDo cumentsender schemeagencyiden tifier=9 Selite 2 0..1 A150 Vapaa selite Description Käyttöpaikan perustiedot 2 1..1 MeteringPointUsed DomainLocation Käyttöpaikan tunnus 3 1..1 A90 64582373484845 8216 Identification schemeagencyiden tifier=9 Käyttöpaikan tila 3 1..1 A4 AE01=Kytketty AE02=Katkaistu AE03=Rakenteilla AE04=Poistettu käytöstä PhysicalStatusType listagencyidentifier =NFI Käyttöpaikan tyyppi 3 1..1 A4 AG01=Kulutus AG02=Tuotanto MeteringPointType listagencyidentifier =NFI

161 (198) AG03=Tuotantoyk sikön oma käyttö Käyttöpaikan alityyppi 3 1..1 A4 AQ01=Normaali AQ02=Kiinteistök ayttöpaikka MeteringPointSubT ype listagencyidentifier =NFI Etäkytkettävä 3 1..1 A1 0=ei etäkytkettävä 1=etäkytkettävä RemoteConnectabl e Mittarinumero 3 0..1 A50 12345 MeterIdentification Rinnakkaiskäytt öpaikan tunnus 3 0..1 A90 64582373484845 8216 RelatedMeteringPoi nt schemeagencyiden tifier=9 Aluetiedot 3 1..1 MeteringGridAreaU seddomainlocation Mittausalue 4 1..1 A50 44Y1001A1001A4 6L Identification schemeagencyiden tifier=305 Käyttöpaikan osoite 3 0..n MeteringPointAddre ss Osoitteen tyyppi 4 1..1 A3 AF01=Pääosoite AF02=Lisäosoite Type listagencyidentifier =NFI Kadun nimi 4 0..1 A90 Syyriankatu StreetName Talonumero 4 0..1 A10 21 BuildingNumber Porrastunnus 4 0..1 A5 A FloorIdentification Huoneisto 4 0..1 A5 13 RoomIdentification Postinumero 4 0..1 A10 00510 Postcode Postitoimipaikka 4 0..1 A50 Helsinki CityName Maa 4 0..1 A2 FI CountryCode schemeagencyiden tifier=5 ISO 3166 alpha-2 Osoitteen tarkenne 4 0..1 A150 Kolmas pylväs vasemmalta sillalta katsoen AddressFreeForm Kieli 4 0..1 A3 fi Language schemeagencyiden tifier=5 (ISO 639-1 Code) Koordinaatisto 3 0..1 MPPositionMeterin gpointgeographical Coordinate Leveysaste 4 1..1 A10 61 10,27 N Latitude Pituusaste 4 1..1 A10 24 33,67 E Longitude Käyttöpaikan ominaisuudet 3 0..1 MPDetailMeteringP ointcharacteristic

162 (198) Etäluettava 4 0..1 A3 Mittaustapa 4 0..1 A3 0=ei etäluettava 1=etäluettava E13=Tuntimittaus E14=Lukemamitta us E16=Mittaroimato n RemoteReadable MeteringMethod Käyttäjäryhmä 4 0..1 A4 UserGroup Lämmitys riippuu sähköstä 4 0..1 A1 0=ei riippuvuutta 1=riippuvuus HeatingMethodTyp e Sulakekoko 4 0..1 A10 3x100 FuseSize Sähköteho 4 0..1 I9 20000 ContractedConnecti oncapacity kw Veroluokka 4 0..1 A1 1 TaxCategory Vuosikäyttöarvio t Aikavyöhyketun nus 4 0..2 Estimated_Metrics 5 1..1 A3 1 MeterTimeFrame Vuosikäyttöarvio 5 1..1 I9 5000 Total Ohjattava kuorma 3 0..n LoadUnit Tunnus 4 1..1 A50 Identification Nimi 4 0..1 A90 Name Kuvaus 4 0..1 A150 Description Ajastukset 4 0..1 A90 Timing Ohjausrajoituks et 4 0..1 A90 Limits Maksimiteho 4 0..1 I9 MaxPower Maksimitehon yksikkö 4 0..1 A5 kw UnitType Varastolaite 3 0..n StorageUnit Tunnus 4 1..1 A50 Identification Nimi 4 1..1 A90 Name Tyyppi 4 1..1 A10 Type Kapasiteetti 4 0..1 I9 Capacity Kapasiteetin yksikkö 4 0..1 A5 kw UnitType Maksimiteho 4 0..1 I9 MaxCapacity

163 (198) Maksimitehon yksikkö 4 0..1 A5 kw UnitType Tuotantolaite 3 0..n ProductionUnit Tunnus 4 1..1 A50 Identification Nimi 4 1..1 A90 Name Tuotantolaji 4 1..1 A10 Type Maksimiteho 4 0..1 I9 MaxCapacity Maksimitehon yksikkö 4 0..1 A5 kw UnitType 12.3.5 F03 Käyttöpaikkatietokysely Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Huom Käyttöpaikan tunnus 1 1..1 RequestMPInfo 2 1..1 Aikaleima 2 0..1 A90 Käyttöpaikkatietokysely Voimaantulopäivämäärä 2015-06- 12T21:00:00+00: 00 64582373484845 8216 StartOfOccurrence IdentificationMP Mittarinumero 2 0..1 A50 12345 MeterIdentification Sopimustunnus 2 1..1 A50 MS21444412 Asiakkaiden tiedot Asiakkaan tunniste IdentificationContra ct 2 1..n MPCustomer 3 0..1 A50 010191-090U Identification schemeagencyiden tifier=260 schemeagencyiden tifier=9 12.3.6 F21 Käyttöpaikkatiedot Tietokenttä T P Formaatti Esimerkki XML-elementti AgencyIdentifier Käyttöpaikkatietova staus 1 1..1 ResponseMPInfo Voimaantulopäiväm 2015-06- 2 1..1 Aikaleima äärä 12T21:00:00+00:00 StartOfOccurance Alkuperäisen sanoman tunnus Käyttöpaikan perustiedot 2 0..1 A36 2 1..1 123e4567-e89b-12d3- a456-426656756520 OriginalBusinessDoc umentreference MeteringPointUsedD omainlocation

164 (198) Käyttöpaikan tunnus Käyttöpaikan tila 3 1..1 A4 Käyttöpaikan tyyppi 3 1..1 A4 Käyttöpaikan alityyppi 3 1..1 A90 645823734848458216 Identification 3 1..1 A4 Etäkytkettävä 3 1..1 A1 AE01=Kytketty AE02=Katkaistu AE03=Rakenteilla AE04=Poistettu käytöstä AG01=Kulutus AG02=Tuotanto AG03=Tuotantoyksikön oma käyttö AQ01=Normaali AQ02=Kiinteistökayttöp aikka 0=ei etäkytkettävä 1=etäkytkettävä PhysicalStatusType MeteringPointType MeteringPointSubTy pe RemoteConnectable Mittarinumero 3 0..1 A50 12345 MeterIdentification Rinnakkaiskäyttöpai kan tunnus Aluetiedot 3 1..1 3 0..1 A90 645823734848458216 RelatedMeteringPoin t MeteringGridAreaUs eddomainlocation Mittausalue 4 1..1 A50 44Y1001A1001A46L Identification Käyttöpaikan osoite 3 0..n Osoitteen tyyppi 4 1..1 A4 AF01=Pääosoite AF02=Lisäosoite MeteringPointAddre ss Type Kadun nimi 4 0..1 A90 Syyriankatu StreetName Talonumero 4 0..1 A10 21 BuildingNumber Porrastunnus 4 0..1 A5 A FloorIdentification Huoneisto 4 0..1 A5 13 RoomIdentification Postinumero 4 1..1 A10 00510 PostCode Postitoimipaikka 4 1..1 A50 Helsinki CityName Maa 4 1..1 A2 FI CountryCode Osoitteen tarkenne 4 0..1 A150 Kolmas pylväs vasemmalta sillalta katsoen AddressFreeForm Kieli 4 1..1 A3 fi Language SchemeAgencyId entifier=9 ListAgencyIdentifi er=nfi ListAgencyIdentifi er=nfi ListAgencyIdentifi er=nfi SchemeAgencyId entifier=9 SchemeAgencyId entifier=305 ListAgencyIdentifi er=nfi SchemeAgencyId entifier=5 SchemeAgencyId entifier=5 (ISO 639-1 Code)

165 (198) Koordinaatisto 3 0..1 MPPositionsMeterin gpointgeographicalc oordinate Leveysaste 4 1..1 A10 61 10,27 N Latitude Pituusaste 4 1..1 A10 24 33,67 E Longitude Käyttöpaikan ominaisuudet 3 0..1 Etäluettava 4 0..1 A1 Mittaustapa 4 0..1 A3 0=ei etäluettava 1=etäluettava E13=Tuntimittaus E14=Lukemamittaus E16=Mittaroimaton MPDetailMeteringPo intcharacteristic RemoteReadable MeteringMethod Käyttäjäryhmä 4 0..1 A3 UserGroup Lämmitys riippuu sähköstä 4 0..1 A1 0=ei riippuvuutta 1=riippuvuus Sulakekoko 4 0..1 A10 3x100 FuseSize Sähköteho 4 0..1 I9 20000 Toimitetaanko loisenergia 4 0..1 A1 0=ei toimiteta 1=toimiteteaan HeatingMethodType ContractedConnectio ncapacity ReactiveEnergy Vuosikäyttöarviot 4 0..2 EstimateMetrics Aikavyöhyketunnus 5 1..1 A3 1 MeterTimeFrame Vuosikäyttöarvio 5 1..1 I9 5000 Total Ohjattava kuorma 3 0..n LoadUnit Tunnus 4 1..1 A50 Identification Nimi 4 1..1 A90 Name Kuvaus 4 0..1 A150 Description Ajastukset 4 0..1 A90 Timing Ohjausrajoitukset 4 0..1 A90 Limits Maksimiteho 4 0..1 I9 MaxPower Maksimitehon yksikkö 4 0..1 A5 kw UnitType Varastolaite 3 0..n StorageUnit Tunnus 4 1..1 A50 Identification Nimi 4 1..1 A90 Name Tyyppi 4 1..1 A10 Type Kapasiteetti 4 0..1 I9 Capacity Kapasiteetin yksikkö 4 0..1 A5 kw UnitType Maksimiteho 4 0..1 I9 MaxCapacity kw

166 (198) Maksimitehon yksikkö 4 0..1 A5 kw UnitType Tuotantolaite 3 0..n ProductionUnit Tunnus 4 1..1 A50 Identification Nimi 4 1..1 A90 Name Tuotantolaji 4 1..1 A10 Type Maksimiteho 4 0..1 I9 MaxCapacity Maksimitehon yksikkö 4 0..1 A5 kw UnitType Verkkosopimuksen tiedot 3 0..1 TransferContract Asiakkaan tarkenne 4 0..1 A90 CustomerNote Asiointitapa 4 0..1 A4 Keskeytyskrittisyys 4 0..1 A1 AC01=Sähköinen AC02=Muu 0=Ei kriittinen 1=Keskeytyskriittinen ContactType Priority listagencyidentifi er=nfi Laskutuskanava 4 0..1 A4 AI01=Paperilasku AI02=Verkkolasku AI03=E-lasku AI04=Sähköposti AI05=Netposti AI06=Suoramaksu AI07=Mobiililasku BillingChannel ListAgencyIdentifi er=nfi Laskutustapa 4 0..1 A4 AH01=Erillislaskutus, AH02=Verkko laskuttaa molemmat AH03=Myyjä laskuttaa molemmat BillingMethod ListAgencyIdentifi er=nfi Sopimuksen aloituksen syy Sopimuksen aloituspäivämäärä 4 0..1 A4 4 0..1 Aikaleima AT01=Sopimuksen vaihto AT02=Myyjän vaihto AT03=Sisäänmuutto 2015-06- 12T21:00:00+00:00 ContractReason ContractStart ListAgencyIdentifi er=nfi Sopimuksen päättymisen syy Sopimuksen päättymispäivämää rä 4 0..1 A4 4 0..1 Aikaleima AN01=Ulosmuutto AN02=Irtisanominen AN03=Purkaminen 2015-06- 12T21:00:00+00:00 Reason EndOfOccurance

167 (198) Sopimuksen tyyppi 4 0..1 A3 11=Verkkosopimus 12=Myyntisopimus ContractType Sopimustunnus 4 0..1 A50 MS21444412 Identication 0=Ei Sähköntoimitussopi sähköntoimitussopimus 4 0..1 A1 mus 1=Sähköntoimitussopi DeliveryContract mus Veroluokka 4 0..1 A1 1 TaxCategory Verkkotuotteen tiedot 4 0..1 Verkkotuotteen TransferContractCod 5 1..1 A50 YAE tunnus e Myyntisopimuksen tiedot 3 0..1 MasterDataContract Asiakkaan tarkenne 4 0..1 A90 CustomerNote Asiointitapa 4 0..1 A4 Keskeytyskriittisyys 4 0..1 A1 AC01=Sähköinen AC02=Muu 0=Ei kriittinen 1=Keskeytyskriittinen ContactType Priority ListAgencyIdentifi er=nfi Laskutuskanava 4 0..1 A4 AI01=Paperilasku AI02=Verkkolasku AI03=E-lasku AI04=Sähköposti AI05=Netposti AI06=Suoramaksu AI07=Mobiililasku BillingChannel ListAgencyIdentifi er=nfi Laskutustapa 4 0..1 A4 Määräaikainen myyntisopimus Määräaikaisuuden päättymispäivämää rä Poikkeava irtisanomisaika Poikkeava irtisanomisehto 4 0..1 A1 4 0..1 Aikaleima AH01=Erillislaskutus, AH02=Verkko laskuttaa molemmat AH03=Myyjä laskuttaa molemmat 0=Jatkuva sopimus 1=Määräaikainen sopimus 2015-06- 12T21:00:00+00:00 BillingMethod TimeLimited ContractStop 4 0..1 I3 30 NoticeDays 4 0..1 A1 0=Ei poikkeava 1=Poikkeava irtisanomisehto NoticeBasis ListAgencyIdentifi er=nfi

168 (198) Sopimuksen aloituksen syy Sopimuksen aloituspäivämäärä Sopimuksen päättymisen syy Sopimuksen päättymispäivämää rä 4 0..1 A4 4 0..1 Aikaleima 4 0..1 A4 Sopimuksen tyyppi 4 0..1 A3 AT01=Sopimuksen vaihto AT02=Myyjän vaihto AT03=Sisäänmuutto 2015-06- 12T21:00:00+00:00 AN01=Ulosmuutto AN02=Irtisanominen AN03=Purkaminen ContractReason ContractStart Reason 4 0..1 Aikaleima EndOfOccurance 11=Verkkosopimus 12=Myyntisopimus ContractType Sopimustunnus 4 0..1 A50 MS21444412 Identication 0=Ei Sähköntoimitussopi sähköntoimitussopimus 4 0..1 A1 mus 1=Sähköntoimitussopi DeliveryContract mus Poikkeava irtisanomisjakso Irtisanomisjakson alkuaika Irtisanomisjakson loppuaika Myyntituote 4 0..1 4 0..1 NoticePeriod 5 0..1 Aikaleima 5 0..1 Aikaleima 2015-06- 12T21:00:00+00:00 2015-07- 12T21:00:00+00:00 NoticeStart NoticeEnd Tuotteen tunnus 5 1..1 A30 ProductCode Myyjätiedot 4 0..1 BalanceSupplierInvol vedenergyparty Myyjä 5 0..1 A50 6458237348480 Identification Sopimustilanne 3 0..1 Alkava myyntisopimus Myyntisopimus asiakkaalla 4 0..1 Aikaleima 4 1..1 A4 2015-06- 12T21:00:00+00:00 AJ01=Sopimus asiakkaalla AJ02=Sopimus osittain asiakkaalla AJ03=Sopimus ei asiakkaalla NextContractStart EnergyContractByCu stomer ListAgencyIdentifi er=nfi SchemeAgencyId entifier=9 Seuraavan sopimustapahtu man alkamispäivä ListAgencyIdentifi er=nfi

169 (198) Sopimuksen määräaikaisuus Määräaikaisuuden päättymispäivä Voimassa oleva myyntisopimus päättyy Poikkeava irtisanomisehto 4 1..1 A1 4 0..1 Aikaleima 4 0..1 Aikaleima 4 1..1 A1 0=Jatkuva sopimus 1=Määräaikainen sopimus 2015-06- 12T21:00:00+00:00 2015-06- 12T21:00:00+00:00 0=Ei poikkeava 1=Poikkeava irtisanomisehto TimeLimited FixedContractEnd NextContractEnd NoticeBasis Irtisanomisaika 4 0..1 I3 30 NoticeDays Irtisanomisjakso 4 0..1 NoticePeriod Irtisanomisjakson 2015-06- 5 0..1 Aikaleima NoticeStart alkuaika 12T21:00:00+00:00 Irtisanomisjakson loppuaika Verkkosopimus asiakkaalla Asiakkaiden perustiedot 5 0..1 Aikaleima 4 1..1 A4 2 1..n Asiakkaan alityyppi 3 1..1 A4 2015-07- 12T21:00:00+00:00 AK01=Sopimus asiakkaalla AK02=Sopimus osittain asiakkaalla AK03=Sopimus ei asiakkaalla BF01=Normaali BF02=Kuolinpesä NoticeEnd TransferContractByC ustomer ConsumerInvolvedCu stomerparty CustomerSubType Asiakkaan tunniste 3 1..1 A50 010191-090U Identification Asiakkaan tunnisteen tyyppi 3 1..1 A4 Asiakkaan tyyppi 3 1..1 A4 Salattu-tieto 3 1..1 A1 AA01=Y-tunnus AA02=Yhdistystunnus AA03= Henkilötunnus (hetu) AA04=Osapuolen oma tunnus AB01=Yritys AB02=Kuluttaja 0=ei salausta 1=salattu IdentificationType CustomerType Kieli 3 1..1 A3 fi Language InformationRestricti on ListAgencyIdentifi er=nfi SchemeAgencyId entifier=260 ListAgencyIdentifi er=nfi ListAgencyIdentifi er=nfi schemeagencyide ntifier=5 (ISO 639-1 Code)

170 (198) Lisätunnus 3 0..1 A50 AdditionalCode Yrityksen nimi 3 0..1 A90 Oy Datahub Ab Name Etunimi 3 0..1 A50 Esa GivenName Keskimmäiset nimet 3 0..1 A50 Mikko Ylermi MiddleName Sukunimi 3 0..1 A50 Jaatikainen FamilyName Syntymäaika 3 0..1 Päivä 1991-01-01 DateOfBirth VVVV-KK-PP Yhteystiedot 3 0..2 Communication Yhteystiedon tyyppi 4 0..1 A4 Puhelinnumero/säh köpostiosoite 4 0..1 A90 AD01=Puhelin AD02=Sähköpostiosoite nimi.sukunimi@domain.com CommunicationChan nel CompleteNumber ListAgencyIdentifi er=nfi 12.3.7 F04 Rakenteelliset tiedot, sopimus Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Huom Sopimustiedot 1 1..1 Voimaantulopäiv ämäärä Päättymispäivä määrä Alkuperäisen sanoman tunnus Alkuperäisen sanoman lähettäjä 2 0..1 Aikaleima 2 0..1 Aikaleima 2 0..1 A36 2015-06- 12T21:00:00+00: 00 2015-06- 12T21:00:00+00: 00 123e4567-e89b- 12d3-a456-426656756520 2 0..1 A16 6458237348480 MasterDataContract Event StartOfOccurrence EndOfOccurence OriginalBusinessDoc umentreference OriginalBusinessDoc umentsender Selite 2 0..1 A150 Vapaa selite Description Vaatii uuden verkkosopimuks en Sopimuksen aloituksen syy 2 0..1 A1 2 0..1 A4 0=ei vaadi 1=vaatii AT01=Sopimukse n vaihto AT02=Myyjän vaihto AT03=Sisäänmuu tto TransferContractNee ded ContractReason schemeagencyid entifier=260, 9 tai 305 listagencyidentifie r=nfi

171 (198) Verkkosopimuks en hyväksyminen 2 0..1 A1 0=ei hyväksytä 1=hyväksytään ContractConfirm Sopimustiedot 2 1..1 MasterDataContract Asiointitapa 3 1..1 A4 AC01=Sähköinen AC02=Muu ContactType listagencyidentifie r=nfi Sopimustunnus 3 1..1 A50 MS21444412 Identification Sopimuksen tyyppi 3 1..1 A3 11=Verkkosopimu s 12=Myyntisopimu s ContractType Sähköntoimituss opimus 3 1..1 A1 0=Ei sähköntoimitusso pimus 1=Sähköntoimitus sopimus DeliveryContract Sopimuksen aloituspäivämää rä 3 1..1 Aikaleima 2015-06- 12T21:00:00+00: 00 ContractStart Sopimuksen määräaikaisuus 3 1..1 A1 0=Jatkuva sopimus 1=Määräaikainen sopimus TimeLimited Määräaikaisuud en päättymispäivä 3 0..1 Aikaleima 2015-06- 12T21:00:00+00: 00 ContractStop AH01=Erillislaskut us, Laskutustapa 3 1..1 A4 AH02=Verkko laskuttaa molemmat BillingMethod listagencyidentifie r=nfi AH03=Myyjä laskuttaa molemmat Poikkeava irtisanomisehto 3 1..1 A1 0=Ei poikkeava 1=Poikkeava irtisanomisehto NoticeBasis Irtisanomisaika 3 0..1 I3 30 NoticeDays Irtisanomisjakso 3 0..1 NoticePeriod Irtisanomisjakso n alkuaika 4 0..1 Aikaleima 2015-06- 12T21:00:00+00: 00 NoticeStart

172 (198) Irtisanomisjakso n loppuaika 4 0..1 Aikaleima 2015-07- 12T21:00:00+00: 00 NoticeEnd Keskeytyskriittis yys 3 1..1 A1 0=Ei kriittinen 1=Keskeytyskriitti nen Priority AI01=Paperilasku AI02=Verkkolasku AI03=E-lasku Laskutuskanava 3 1..1 A4 AI04=Sähköposti AI05=Netposti BillingChannel listagencyidentifie r=nfi AI06=Suoramaks u AI07=Mobiililasku Veroluokka 3 1..1 A1 1 TaxCategory Tuotetieto 3 1..n ProductInformation Tuotteen tunnus 4 1..1 A30 ProductCode Asiakkaan tarkenne 3 0..1 A90 CustormerNote Yhteyshenkilö 3 0..n Contact Tyyppi 4 1..1 A4 AL01=Edunvalvoj a AL02=Sopimusva staava AL03=Laskutusva staava AL04=Kytkentäva staava AL05=Vikaviestint ä ContactType Etunimi 4 0..1 A50 Esa GivenName Sukunimi 4 0..1 A50 Jaatikainen FamilyName Muu Nimi 4 0..1 A90 Tampereen sosiaalitoimisto Name Yhteystiedot 4 1..2 Communication Tyyppi 5 1..1 A4 AD01=Puhelin AD02=Sähköposti osoite CommunicationChan nel listagencyidentifie r=nfi Puhelinumero/ Sähköpostiosoit e 5 1... 1 A90 nimi.sukunimi@ domain.com CompleteNumber

173 (198) Laskutusosoite 3 0..1 BillingAddress Osoitteen tarkenne 4 0..1 A90 Oy datahub Ab CareOf Kadun nimi 4 0..1 A90 Syyriankatu StreetName Talonumero 4 0..1 A10 21 BuildingNumber Porrastunnus 4 0..1 A5 A FloorIdentification Huoneisto 4 0..1 A5 13 RoomIdentification Postinumero 4 1..1 A10 00510 Postcode Postilokero 4 0..1 A10 15 Pobox Postitoimipaikka 4 1..1 A50 Helsinki CityName Maa 4 1..1 A2 FI CountryCode schemeagencyid entifier=5 ISO 3166 alpha-2 Verkkolaskutuso soite 3 0..1 NetInvoiceAddressD etails Kohdiste 4 0..1 A50 NetInvoiceTargetId Verkkolaskuosoi te 4 1..1 A50 NetInvoiceAddress Välittäjän tunnus 4 1..1 A50 NetInvoiceRouter Muu sähköinen laskutusosoite 3 0..1 BillingChannel Tyyppi 4 1..1 A4 AM01=Sähköpost ilaskun osoite AM03=Mobiililask un puhelinnumero AddressType listagencyidentifie r=nfi Sähköinen osoite 4 1..1 A90 nimi.sukunimi@ domain.com Address Käyttöpaikan tiedot 3 1..1 MeteringPointOfCont ract Käyttöpaikan tunnus 4 1..1 A90 64582373484845 8216 Identification schemeagencyid entifier=9 Aluetiedot 3 1..1 MeteringGridAreaUs eddomainlocation Mittausalue 4 1..1 A50 44Y1001A1001A4 6L Identification schemeagencyid entifier=305 Myyjän tiedot 3 0..1 SupplierOfContract Myyjän tunnus 4 1..1 A90 6458237348480 Identification schemeagencyid entifier=9 Jakeluverkonhal tijan tiedot 3 0..1 NetworkOfContract

174 (198) Jakeluverkon tunnus 4 1..1 A90 44Y1001A1001A4 6L Identification schemeagencyid entifier=9 Asiakkaiden perustiedot 3 1..n ConsumerInvolvedC ustomerparty Asiakkaan tunniste 4 1..1 A50 010191-090U Identification schemeagencyid entifier=260 AA01=Y-tunnus Asiakkaan tunnisteen tyyppi 4 1..1 A4 AA02=Yhdistystu nnus AA03= Henkilötunnus (hetu) IdentificationType listagencyidentifie r=nfi AA04=Osapuolen oma tunnus Asiakkaan tyyppi 4 1..1 A4 AB01=Yritys AB02=Kuluttaja CustomerType Asiakkaan alityyppi 4 1..1 A4 BF01=Normaali BF02=Kuolinpesä CustomerSubType Osapuolen oma asiakastunnus 4 0..1 A50 HKE_12345 AlternateIdentificatio n Salattu-tieto 4 1..1 A1 0=ei salausta 1=salattu InformationRestrictio n Kieli 4 1..1 A3 fi Language schemeagencyid entifier=5 (ISO 639-2 Code) Yrityksen nimi 4 0..1 A90 Oy datahub Ab Name Etunimi 4 0..1 A50 Esa GivenName Keskimmäiset nimet 4 0..1 A50 Mikko Ylermi MiddleName Sukunimi 4 0..1 A50 Jaatikainen FamilyName Syntymäaika 4 0..1 Päivä 1991-01-01 DateOfBirth VVVV-KK-PP Lisätunnus 4 0..1 A50 AdditionalCode Yhteystiedot 4 0..9 9 Communication Tyyppi 5 1..1 A4 AD01=Puhelin AD02=Sähköposti osoite CommunicationChan nel listagencyidentifie r=nfi Puhelinnumero/ Sähköpostiosoit e 5 1... 1 A90 +358303955000 CompleteNumber

175 (198) Postisoite 4 1..1 ConsumerInvolvedC ustomeraddress Osoitteen tarkenne 5 0..1 A90 Oy datahub Ab CareOf Kadun nimi 5 0..1 A90 Syyriankatu StreetName Talonumero 5 0..1 A10 21 BuildingNumber Porrastunnus 5 0..1 A5 A FloorIdentification Huoneisto 5 0..1 A5 13 RoomIdentification Postinumero 5 1..1 A10 00510 Postcode Postilokero 5 0..1 A10 15 Pobox Postitoimipaikka 5 1..1 A50 Helsinki CityName Maa 5 1..1 A2 FI Huom: CountryCode schemeagencyid entifier=5 ISO 3166 alpha-2 Tarkennus. 12.3.8 F05 Myyjätön käyttöpaikka Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Huom Käyttöpaikkatied ot 1 1..n NotifyMPInfo Käyttöpaikan tunnus 2 1..1 A90 64582373484845 8216 Identification schemeagencyid entifier=9 Aluetiedot 2 1..1 MeteringGridAreaUs eddomainlocation Mittausalue 3 1..1 A50 44Y1001A1001A4 6L Identification schemeagencyid entifier=305 Sopimukseton aika 2 1..1 Period Alkuaika 3 1..1 Aikaleima Loppuaika 3 0..1 Aikaleima 2015-06- 12T21:00:00+00: 00 2015-06- 12T21:00:00+00: 00 PeriodStart PeriodStop

176 (198) 12.3.9 F06 Rakenteelliset tiedot, sopimuksen päättäminen Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Huom Sopimustiedot 1 1..1 MasterDataContract Event Päättymispäivä määrä 2 1..1 Aikaleima 2015-06- 12T21:00:00+00: 00 EndOfOccurence Alkuperäisen sanoman tunnus 2 0..1 A36 123e4567-e89b- 12d3-a456-426656756520 OriginalBusinessDoc umentreference Alkuperäisen sanoman lähettäjä 2 0..1 A16 6458237348480 OriginalBusinessDoc umentsender schemeagencyid entifier=9 Selite 2 0..1 A150 Vapaa selite Description Syy 2 1..1 A4 AN01=Ulosmuutt o AN02=Irtisanomin en AN03=Purkamine n Reason Sopimustiedot 2 0..1 MasterDataContract Sopimustunnus 3 0..1 A50 MS21444412 Identification Sopimuksen tyyppi 3 0..1 A3 11=Verkkosopimu s 12=Myyntisopimu s ContractType Laskutusosoite 3 0..1 BillingAddress Osoitteen tarkenne 4 0..1 A90 Oy datahub Ab CareOf Kadun nimi 4 0..1 A90 Syyriankatu StreetName Talonumero 4 0..1 A10 21 BuildingNumber Porrastunnus 4 0..1 A5 A FloorIdentification Huoneisto 4 0..1 A5 13 RoomIdentification Postinumero 4 1..1 A10 00510 Postcode Postilokero 4 0..1 A10 15 Pobox Postitoimipaikka 4 1..1 A50 Helsinki CityName Maa 4 1..1 A2 FI CountryCode schemeagencyid entifier=5 ISO 3166 alpha-2

177 (198) Käyttöpaikan tiedot 3 1..1 MeteringPointOfCont ract Käyttöpaikan tunnus 4 1..1 A90 64582373484845 8216 Identification schemeagencyid entifier=9 Aluetiedot 3 1..1 MeteringGridAreaUs eddomainlocation Mittausalue 4 1..1 A50 44Y1001A1001A4 6L Identification schemeagencyid entifier=305 Asiakkaiden perustiedot 3 0..n ConsumerInvolvedC ustomerparty Asiakkaan tunniste 4 0..1 A50 010191-090U Identification schemeagencyid entifier=260 AA01=Y-tunnus Asiakkaan tunnisteen tyyppi 4 1..1 A4 AA02=Yhdistystu nnus AA03= Henkilötunnus (hetu) AA04=Osapuolen oma tunnus IdentificationType listagencyidentifie r=nfi Asiakkaan tyyppi 4 1..1 A4 AB01=Yritys AB02=Kuluttaja CustomerType listagencyidentifie r=nfi Yrityksen nimi 4 0..1 A90 Oy datahub Ab Name Etunimi 4 0..1 A50 Esa GivenName Keskimmäiset nimet 4 0..1 A50 Mikko Ylermi MiddleName Sukunimi 4 0..1 A50 Jaatikainen FamilyName Syntymäaika 4 0..1 Päivä 1991-01-01 DateOfBirth VVVV-KK-PP Huom: Tarkennus. 12.3.10 F18 Rakenteelliset tiedot, sopimuksen peruminen Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Sopimustiedot 1 1..1 MasterDataContract Event Voimaantulopäiv ämäärä 2 1..1 Aikaleima 2015-06- 12T21:00:00+00: 00 StartOfOccurrence

178 (198) Alkuperäisen sanoman tunnus 2 0..1 A36 123e4567-e89b- 12d3-a456-426656756520 OriginalBusinessDoc umentreference Alkuperäisen sanoman lähettäjä 2 0..1 A16 6458237348480 OriginalBusinessDoc umentsender schemeagencyidentifier=9 AR01=Asiakas peruuttanut sopimuksen Perumisen syy 2 1..1 A4 AR02=Myyjä peruuttanut sopimuksen ReasonForCancel listagencyidentifier=nfi AR03=Jakeluverk onhaltija peruuttanut sopimuksen Selite 2 0..1 A150 Vapaa selite Description Sopimustiedot 2 1..1 MasterDataContract Sopimustunnus 3 1..1 A50 MS21444412 Identification Käyttöpaikan tiedot 3 1..1 MeteringPointOfCont ract Käyttöpaikan tunnus 4 1..1 A90 64582373484845 8216 Identification schemeagencyidentifier=9 12.3.11 E66 Mittaustiedot Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Mittausaikasarja 1 1..9999 EnergyTimeSeries Aikasarjan tunnus 2 1..1 A90 FI_HKE001_1234 5 Identification Lähettäjäkohtaisesti yksilöivä aikasarjan tunniste. Datahub ei aseta tunnukselle nimeämissääntöä. Sanoman luontiaika 2 1..1 Aikaleima 2015-06- 12T21:00:00+00: 00 RegistrationDateTime Raportointiaikav äli 2 ObservationPeriodTim eseriesperiod Aika-askel 3 0..1 PnYnMnD TnHnMnS PT1H ResolutionDuration Alkuaika 3 1..1 Aikaleima 2015-06- 12T21:00:00+00: 00 Start

179 (198) Loppuaika 3 1..1 Aikaleima 2015-06- 12T21:00:00+00: 00 End Mittauksen tyyppi 2 ProductIncludedProdu ctcharacteristic 8716867000030= Pätöenergia 8716867000139= Loisenergia, otto Mittausaikasarja n tyyppi 3 1..1 A18 8716867000146= Loisenergia, anto Identification 8716867000047= Loisenergia (käytetään vain hakukyselyissä) Yksikkö 3 1..1 A6 kwh UnitType Mittauksen ominaisuudet 2 1..1 MPDetailMeasurement MeteringPointCharacte ristic Mittauspisteen tyyppi 3 1..1 A3 E17=Kulutus E18=Tuotanto E20=Rajapiste MeteringPointType Mittauspiste 2 1..1 MeteringPointUsedDo mainlocation Mittauspisteen tunnus 3 1..1 A90 70705750002293 9815 Identification schemeagencyidenti fier=9 Aluetiedot 2 0..1 MeteringGridAreaUsed DomainLocation Mittausalueen tunnus 3 1..1 44Y1001A1001A4 6L Identification schemeagencyidenti fier=305 Ottoalue 2 0..1 InAreaUsedDomainLo cation Ottoalueen tunnus 3 1..1 44Y1001A1001A4 6L Identification schemeagencyidenti fier=305 Antoalue 2 0..1 OutAreaUsedDomainL ocation Antoalueen tunnus 3 1..1 44Y1001A1001A4 6L Identification schemeagencyidenti fier=305 Aikasarja-arvot 2 1..9999 ObservationIntervalOb servationperiod

180 (198) Positio 3 1..1 I4 1 Sequence [1] Arvot 3 ObservationDetailEner gyobservation Arvo 4 0..1 D8.6 1.123 EnergyQuantity Arvo puuttuu 4 0..1 A1 QuantityMissing Status 4 0..1 A3 Z02=Epävarma 99=Arvioitu Z01=Korjattu OK QuantityQuality Huom: [1] Tarkennus Positio määrittää aika-askeleen järjestysnumeron suhteessa alkuaikaan. Esimerkiksi aikavälin ensimäinen tunti saa arvon 1, toinen tunti arvon 2 jne. 12.3.12 F07 Mittaustietomuistutus Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Mittaustietomuis tutus 1 1..9999 RequestMeasuredDat a Mittauspisteen tunnus 2 1..1 A90 64582373484845 8216 MeteringPoint schemeagencyidenti fier=9 Mittausalue 2 1..1 44Y1001A1001A4 6L MeteringArea schemeagencyidenti fier=305 Pyyntöaikaväli 2 RequestPeriod Alkuaika 3 1..1 Aikaleima Loppuaika 3 1..1 Aikaleima 2015-06- 12T21:00:00+00: 00 2015-06- 12T21:00:00+00: 00 Start End 12.3.13 F08 Mittaustiedon haku Kyselytapahtuma: Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Mittaushaku 1 1..1 RequestMeasured DataInfo Mittauspisteen tunnus 2 0..1 A90 707057500022939 815 MeteringPoint [1] schemeagencyiden tifier=9 Mittausalue 2 0..1 A50 44Y1001A1001A46 L MeteringArea schemeagencyiden tifier=305

181 (198) Aika-askel 2 0..1 PnYnMnDTnHnM ns PT1H ResolutionDuration AG01=Kulutus Käyttöpaikan tyyppi 3 0..1 A4 AG02=Tuotanto AG03=Tuotantoyksi kön oma käyttö MeteringPointType listagencyidentifier =NFI Pätömittauksen yksikkö Loismittauksen yksikkö 2 0..1 A6 kwh UnitType 2 0..1 A6 kvarh UnitType2 Hakuaikaväli 2 RequestPeriod Alkuaika 3 1..1 Aikaleima Loppuaika 3 1..1 Aikaleima 2015-06- 12T21:00:00+00:00 2015-06- 12T21:00:00+00:00 Start End Huom: [1] Tarkennus Mittauspisteen tunnus voi olla: Kulutus- tai pientuotantokäyttöpaikan tunnus Rajapisteen tunnus Tuotantoyksikön tunnus Vastaustapahtuma: Vastaustapahtumana käytetään Mittaustiedot-tapahtumaa. (Mittaustiedot) 12.3.14 F09 Kytkentä-katko F09-sanomatyyppiä käytetään sekä kytkennän/katkaisun pyyntöön sekä jakeluverkonhaltijan suorittaman toimenpiteen ilmoitukseen. Tieto siitä, kumpi sanoma on kyseessä, selviää sanoman prosessitunnuksen (ks. Prosessitiedot) perusteella. Kytkentä- tai katkaisupyyntö: Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Kytkentäkatko 1 1..1 RequestPowerSwit ch Kytkentä- /katkaisupäiväm äärä 2 1..1 Päivä 2015-06-12: StartOfOccurrence

182 (198) Alkuperäisen sanoman tunnus 2 0..1 A36 123e4567-e89b- 12d3-a456-426656756520 OriginalBusinessDo cumentreference Alkuperäisen sanoman lähettäjä 2 0..1 A16 6458237348480 OriginalBusinessDo cumentsender schemeagencyiden tifier=9 Käyttöpaikan tunnus 2 1..1 A90 645823734848458 216 MeteringPoint schemeagencyiden tifier=9 Kytkentätila 2 1..1 A4 AO01=Kytkentäpyy ntö AO02=Katkaisupyy ntö PhysicalStatusType listagencyidentifier =NFI Selite 2 0..1 A150 Vapaa selite Description Pyynnössä ei käytetä selitettä Kytkentä- tai katkoilmoitus: Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Kytkentäkatko 1 1..1 RequestPowerSwit ch Kytkentähetki, katkaisuhetki tai Aikaisintaan 2 1..1 Aikaleima 2015-06- 12T21:00:00+00:00 StartOfOccurrence Alkuperäisen sanoman tunnus 2 0..1 A36 123e4567-e89b- 12d3-a456-426656756520 OriginalBusinessDo cumentreference Alkuperäisen sanoman lähettäjä 2 0..1 A16 6458237348480 OriginalBusinessDo cumentsender schemeagencyiden tifier=9 Käyttöpaikan tunnus 2 1..1 A90 645823734848458 216 MeteringPoint schemeagencyiden tifier=9 Kytkentätila 2 0..1 A4 AO01=Kytkentä AO02=Katkaisu PhysicalStatusType listagencyidentifier =NFI Selite 2 0..1 A150 Vapaa selite Description

183 (198) 12.3.15 F10 Taseselvitystiedon haku Kyselytapahtuma: Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Taseselvitystieto jen haku 1 1..1 Mittausalue 2 1..1 A50 44Y1001A1001A46 L RequestSettlement DataInfo MeteringArea Myyjän tunnus 2 0..1 A90 6458237348480 Supplier [1] Hakuaikaväli 2 RequestPeriod Alkuaika 3 1..1 Aikaleima Loppuaika 3 1..1 Aikaleima Huom: Tarkennus 2015-06- 12T21:00:00+00:00 2015-06- 12T21:00:00+00:00 [1] Jos myyjän tunnusta ei anneta, palautetaan mittausalueen kokonaissummat Start End schemeagencyiden tifier=305 12.3.16 E31 Taseselvitystiedot Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Summasaikasarja 1 1..9999 EnergyTimeSeries Aikasarjan tunnus 2 1..1 A90 Sanoman luontiaika Raportointiaikaväl i Aika-askel 3 1..1 2 1..1 Aikaleima 2 PnYnMnDTn HnMnS Alkuaika 3 1..1 Aikaleima Loppuaika 3 1..1 Aikaleima Summasarjan tyyppi Tuotteen tyyppi 3 1..1 A18 2 FI_HKE001_1234 5 2015-06- 12T21:00:00+00:0 0 PT1H 2015-06- 12T21:00:00+00:0 0 2015-06- 12T21:00:00+00:0 0 8716867000030= Pätöenergia Identification RegistrationDateTi me ObservationPeriod TimeSeriesPeriod ResolutionDuration Start End ProductIncludedPro ductcharacteristic Identification Datahubin aikasarjanimi Sanoman luontiaika

184 (198) Yksikkö 3 1..1 A6 kwh UnitType Aikasarjan ominaisuudet 2 1..1 MPDetailMeasurem entmeteringpointch aracteristic Aikasarjan tyyppi 3 1..1 A3 Taseselvitystapa 3 1..1 A3 E17=Kulutus E18=Tuotanto E20=Rajapiste E01=Profiilitasesel vitys E02=Tuntitaseselv itys MeteringPointType SettlementMethodT ype Taseselvityslaji 3 1..1 A3 Kts lisäkommentti BusinessType [1] Myyjä 2 0..1 Myyjän tunnus 3 1..1 A90 6458237348480 Aluetiedot 2 1..1 BalanceResponsibl einvolvedenergypa rty Identification MeteringGridAreaU seddomainlocation schemeagencyid entifier=9 Mittausalueen tunnus 3 1..1 44Y1001A1001A4 6L Identification schemeagencyid entifier=305 Ottoalue 2 0..1 InAreaUsedDomain Location Ottoalueen tunnus 3 1..1 44Y1001A1001A4 6L Identification schemeagencyid entifier=305 Antoalue 2 0..1 OutAreaUsedDoma inlocation Antoalueen tunnus 3 1..1 44Y1001A1001A4 6L Identification schemeagencyid entifier=305 Aikasarja-arvot 2 1..9999 ObservationInterval ObservationPeriod Positio 3 1..1 I4 1 Sequence [2] Arvot 3 1..1 Arvo 4 1..1 D8.6 1.123 EnergyQuantity Arvo puuttuu 4 0..1 A1 QuantityMissing Status 4 1..1 A3 Z02=Epävarma 99=Arvioitu Z01=Korjattu OK QuantityQuality

185 (198) Huom: Tarkennus Myyjäkohtaiset summat: A04=Mitattu summatoimitus Profiloitu summatoimitus Pientuotantosumma B36=Omakäyttösumma A15=Mittausalueen häviöt [1] [2] Mittausaluekohtaiset summat: Mittausalueen kokonanaisrajapistesumma Rajapistesumma A04: Mittausalueen mitattu summatoimitus Mittausalueen profiloitu summatoimitus Mittausalueen tuotantoyksikkösumma Mittausalueen tasevirhe Mittausalueen häviöt B36=Mittausalueen omakäyttösumma Mittausalueen pientuotantosumma Huom: Kooditus tullaan vielä tarkentamaan. Positio määrittää aikaaskeleen järjestysnumeron suhteessa alkuaikaan. Esimerkiksi aikavälin ensimäinen tunti saa arvon 1, toinen tunti arvon 2 jne. 12.3.17 F19 Tasevirhetiedot Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Tasevirhetiedot 1 1..9999 BalanceCorrection Data Mittausalueen tunnus 2 1..1 44Y1001A1001A4 6L Identification schemeagencyiden tifier=305 Myyjä 2 1..1 Myyjän tunnus 3 1..1 A90 6458237348480 BalanceResponsibl einvolvedenergypa rty Identification schemeagencyiden tifier=9 Rekisteröintipäiv ä 2 1..1 Aikaleima 2015-06- 12T21:00:00+00:0 0 RegistrationDateTi me Korjaussumma yhteensä 2 1..1 D8.2 4000.80 TotalAmount Raportointiaikav äli 2 1..1 ObservationPeriod TimeSeriesPeriod

186 (198) Aika-askel 3 1..1 PnYnMnDTnH nmns PT1H ResolutionDuration Alkuaika 3 1..1 Aikaleima Loppuaika 3 1..1 Aikaleima Tasevirheet 2 1..1 2015-06- 12T21:00:00+00:0 0 2015-06- 12T21:00:00+00:0 0 Start End BalanceCorrection Details Tasevirheen tyyppi 3 0..1 A4 AU01=Käyttöpaikk a AU02=Häviö CorrectionType listagencyidentifier =NFI Käyttöpaikan tunnus 3 0..1 A90 64582373484845 8216 Identification schemeagencyiden tifier=9 Tuntiarvot 3 1..9999 Positio 4 1..1 I6 1 Sequence Mitattu energia 4 1..1 D8.6 MeasuredEnergy Taseeseen viety energia 4 1..1 D8.6 BalanceEnergy Tasevirhe 4 1..1 D8.6 BalanceDifference Hintatiedot 2 1..9999 Positio 3 1..1 I6 1 Sequence SPOT-hinta 3 1..1 D6.3 25.000 Price Korjaus yhteensä Korjattava energia yhteensä 3 1..1 D8.6 Amount Euroissa 3 1..1 D8.6 Energy 12.3.18 F11 Rakenteelliset tiedot, tuote Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Tuotetiedot 1 1..n MasterDataProduct Event Tuotteen voimassaoloaika 2 1..1 ValiditidyTime Alkuaika 3 1..1 Aikaleima Start Loppuaika 3 0..1 Aikaleima End

187 (198) Tuotteen tunnus 2 1..1 A50 YLEIS ProductIdentificatio n Tuotteen omistaja 2 1..1 A16 ProductOwner Tuotteen kuvaus 2 0..1 A300 Tuotteen nimi 2 1..n Kieli 3 1..1 A3 fi Language schemeagencyi dentifier=5 (ISO 639-1 Code) Tuotteen nimi 3 1..1 A90 Yösähkö ProductName Tuotekomponentit 2 1..n Tuotekomponentin tunnus Tuotekomponentin tiedot 3 1..1 A50 ENERGIA 3 1..n ProductComponent Identification Kieli 4 1..1 A3 fi Language schemeagencyi dentifier=5 (ISO 639-1 Code) Tuotekomponentin nimi 4 1..1 A90 Energiamaksu ProductComponent Name Hinnan yksikkö 4 1..1 A10 EUR/kWh UnitType Kalenteriaikasarja 3 0..1 TimeSeries Raportointiaikaväli 4 1..1 ReportingPeriod Aika-askel 5 1..1 PnYnMnDTnHnM ns PT1H ResolutionDuration Alkuaika 5 1..1 Aikaleima Loppuaika 5 1..1 Aikaleima 2015-06- 12T21:00:00+00:00 2015-06- 12T21:00:00+00:00 Start End Aikasarja-arvot 4 1..9 999 9 TimeSeriesValues Positio 5 1..1 I4 1 Sequence Arvo 5 1..1 D8.6 Hintatiedot 3 1..1 0=ei sovelleta kyseiselle tunnille 1=sovelletaan kyseiselle tunnille Quantity Hinta 4 0..1 D8.6 Price [1] Hinnan voimassaoloaika 4 1..1 ValiditidyTime

188 (198) Alkuaika 5 1..1 Aikaleima Start Loppuaika 5 0..1 Aikaleima End Hinta-aikasarja 4 0..1 TimeSeries [1] Raportointiaikaväli 5 1..1 ReportingPeriod Aika-askel 5 1..1 PnYnMnDTnHnM ns Alkuaika 5 1..1 Aikaleima Loppuaika 5 1..1 Aikaleima Aikasarja-arvot 5 1..9 999 9 PT1H 2015-06- 12T21:00:00+00:00 2015-06- 12T21:00:00+00:00 ResolutionDuration Start End TimeSeriesValues Positio 6 1..1 I4 1 Sequence Arvo 6 1..1 D8.6 1.123 Quantity [1] Huom: [1] Tarkennus Hinta esitetään joko kiinteänä hintana Hinta-kentässä tai tunnittaisena hintana hintaaikasarjassa. 12.3.19 F12 Tuotetietojen haku Kyselytapahtuma: Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Tuotehaku 1 1..1 RequestProductDataInfo Osapuolitunnus 2 0..n A50 645823734 8480 PartyIdentification schemeagencyidentifier=9 Huom: Tarkennus Vastaustapahtumana käytetään Rakenteelliset tiedot, tuote-tapahtumaa. 12.3.20 F13 Laskurivitiedot Tietokenttä T P Formaatti Esimerkki xml-elementti Kommentti Laskurivitiedot 1 1..1 BillingDataInfo Käyttöpaikan tunnus 2 1..1 A90 64582373484845821 6 MeteringPoint schemeagencyi dentifier=9

189 (198) Sopimustunnus 2 1..1 A50 MS21444412 Contract Osapuolitunnus 2 1..1 A16 6458237348480 Laskutusaikaväli 2 1..1 BillingPeriod Alkuaika 3 1..1 Aikaleima Loppuaika 3 1..1 Aikaleima 2015-06- 12T21:00:00+00:00 2015-06- 12T21:00:00+00:00 Start End Laskurivit 2 1..n BillingRow Tuotteen tunnus 3 1..1 A50 YLEIS ProductIdentification Tuotekomponentin tunnus 3 1..1 A50 ENERGIA ProductComponenttId entification Hinta 3 1..1 D6.8 0.0489 Price Hinnan yksikkö 3 1..1 A10 EUR/kWh PriceUnit Valuutta 3 1..1 A10 EUR UnitType Hinnan verollisuus 3 1..1 A1 0=ei verollinen 1=verollinen TaxIncluded Määrä 3 1..1 D8.6 100 Price Määrän yksikkö 3 1..1 A6 kwh UnitType Laskurivin summa 3 D8.2 4.89 Amount Selite 3 0..1 A150 Description ALV-prosentti 3 1..1 D8.2 24.00 Tax Huom: Tarkennus 12.3.21 F14 Laskurivitietojen haku Kyselytapahtuma: Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Laskurivitietojen haku 1 1..n RequestBillingDataInfo Laskutusaikaväli 2 1..1 BillingPeriod Alkuaika 3 1..1 Aikaleima Loppuaika 3 1..1 Aikaleima 2015-06- 12T21:00:00+00:00 2015-06- 12T21:00:00+00:00 Start End Osapuolitunnus 2 0..1 A16 6458237348480

190 (198) Käyttöpaikan tunnus 2 0..1 A90 64582373484845821 6 MeteringPoint schemeagencyiden tifier=9 Sopimustunnus 2 0..1 A50 MS21444412 Contract Huom: Tarkennus Vastaustapahtumana käytetään Laskurivitiedot-tapahtumaa. 12.3.22 F15 Valtuutustiedot Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Valtuutus 1 1..n AuthorizationEvent Valtuutuksen aikaväli 2 1..1 AuthorizationPeriod Alkuaika 3 1..1 Aikaleima Loppuaika 3 1..1 Aikaleima 2015-06- 12T21:00:00+00:00 2015-06- 12T21:00:00+00:00 Start End Valtuutuksen syy/tarkoitus 2 1..1 A4 AP01=Energiaraport ointi AP02=Tarjoiuspyyntö AP03=Sopimuksen kilpailutus palveluna Reason listagencyidentifier =NFI Selite 2 0..1 A150 Vapaa selite Description Osapuolitunnus 2 1..1 A16 6458237348480 PartyIdentification Käyttöpaikan tunnus 2 1..1 A90 64582373484845821 6 MeteringPoint schemeagencyiden tifier=9 Asiakkaiden tiedot 2 1..n CustomerList Asiakkaan tunniste 3 1..1 A50 010191-090U Identification schemeagencyiden tifier=260 Huom: Tarkennus

191 (198) 12.3.23 F16 Osapuolitiedot Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Osapuolitiedot 1 1..n PartyInfo Osapuolen perustiedot 2 1..1 AuthorizationPeriod Voimaantulopäiv ämäärä 3 1..1 Aikaleima 2015-06- 12T21:00:00+00:00 Start Osapuolitunnus 3 1..1 A16 6458237348480 PartyIdentification AS01=Myyjä Osapuolen tyyppi 3 1..1 A4 AS02=Jäkeluverkonh altija PartyType AS02=3. osapuoli Osapuolen Y- tunnus 3 1..1 A16 12345678 PartyId Osapuolen nimi 3 1..1 A90 Oy datahub AB PartyName Laskutuskanava 3 1..1 A4 AI01=Paperilasku AI02=Verkkolasku AI03=E-lasku AI04=Sähköposti AI05=Netposti BillingChannel Maa 3 1..1 A2 FI CountryCode schemeagencyiden tifier=5 ISO 3166 alpha-2 Yhteislaskutus 3 0..1 A1 0=ei yhteislaskutusta 1=yhteislaskutus ConsolidateBilling Yhteyshenkilö 3 0..n Contact Tyyppi 4 1..1 A4 AL01=Edunvalvoja AL02=Sopimusvasta ava AL03=Laskutusvasta ava AL04=Kytkentävasta ava AL05=Vikaviestintä ContactType Etunimi 4 0..1 A50 Esa GivenName Sukunimi 4 0..1 A50 Jaatikainen FamilyName Muu Nimi 4 0..1 A90 Name Yhteystiedot 4 1..2 Communication

192 (198) Tyyppi 5 1..1 A4 AD01=Puhelin AD02=Sähköpostios oite CommunicationChann el listagencyidentifier =NFI Puhelinumero/ Sähköpostiosoit e 5 1... 1 A90 nimi.sukunimi@dom ain.com CompleteNumber Laskutusosoite 3 0..n BillingAddress Osoitteen tarkenne 4 0..1 A90 Oy datahub Ab CareOf Kadun nimi 4 0..1 A90 Syyriankatu StreetName Talonumero 4 0..1 A10 21 BuildingNumber Porrastunnus 4 0..1 A5 A FloorIdentification Huoneisto 4 0..1 A5 13 RoomIdentification Postinumero 4 1..1 A10 00510 Postcode Postilokero 4 0..1 A10 15 Pobox Postitoimipaikka 4 1..1 A50 Helsinki CityName Maa 4 1..1 A2 FI CountryCode schemeagencyiden tifier=5 ISO 3166 alpha-2 Verkkolaskutuso soite 3 0..1 Kohdiste 4 0..1 A50 Verkkolaskuosoi te 4 1..1 A50 Välittäjän tunnus 4 1..1 A50 Pankkiyhteysted ot 3 0..1 BankInfo IBAN tunnus 4 1..1 A50 IBAN Pankin nimi 4 1..1 A50 BankName SWIFT tunnus 4 1..1 A50 SWIFT Postisoite 3 1..1 ConsumerInvolvedCus tomeraddress Osoitteen tarkenne 4 0..1 A90 Oy datahub Ab CareOf Kadun nimi 4 0..1 A90 Syyriankatu StreetName Talonumero 4 0..1 A10 21 BuildingNumber Porrastunnus 4 0..1 A5 A FloorIdentification Huoneisto 4 0..1 A5 13 RoomIdentification

193 (198) Postinumero 4 1..1 A10 00510 Postcode Postilokero 4 0..1 A10 15 Pobox Postitoimipaikka 4 1..1 A50 Helsinki CityName Maa 4 1..1 A2 FI CountryCode schemeagencyiden tifier=5 ISO 3166 alpha-2 12.3.24 F17 Osapuolihaku Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Osapuolihaku 1 0..n PartyInfoRequest Osapuolitunnus 2 1..1 A16 6458237348480 PartyIdentification 12.4 ACK Kuittaustapahtuma Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Kuittaustapahtu ma 1 1..9999 Acknowledgement Kuittausaika 2 1..1 Aikaleima 2015-06- 12T21:00:00+00:00 StartOfOccurrence Alkuperäisen sanoman tunnus 2 1..1 A36 123e4567-e89b- 12d3-a456-426656756520 OriginalBusinessDocu mentreference Alkuperäisen sanoman lähettäjä 2 1..1 A16 6458237348480 OriginalBusinessDocu mentsender schemeagencyiden tifier=9 Selite 2 1..1 A90 Description Tapahtumataso n kuittaus 2 1..n Reason Kuittauksen tyyppi 3 1..1 A4 BA01=Sanoma hyväksytty BA02=Sanoma hylätty BA03=Osittain hyväksytty ReasonCode listagencyidentifier =NFI Kuittauksen teksti 3 1..1 A300 ReasonText Päivityksen tyyppi 3 0..1 A4 BC01=Sopimuksen vaihto BC02=Myyjän vaihto UpdateType

194 (198) BC03=Sisäänmuutt o Aikasarjatiedot 2 0..9999 TimeSeriesRejection [1] Lähettäjän aikasarjatunnus Aikasarjason kuittaus Kuittauksen tyyppi Kuittauksen teksti 3 1..1 A90 FI_HKE001_12345 SendersTimeSeriesIde ntification 2 1..1 Reason 3 0..1 A4 999 ReasonCode 3 0..1 A300 General error ReasonText Huom: Tarkennus [1] Aikasarjatason kuittaustietoa käytetään vain mittaustiedon välityksessä. 12.5 F99 Noutotapahtuma Tietokenttä T P Formaatti Esimerkki XML-elementti Kommentti Noutotapahtuma 1 1..1 PollData Noutoaika 2 1..1 Aikaleima 2015-06-12T21:00:00+00:00 StartOfOccurrence Osapuoli 2 1..1 A16 6458237348480 EnergyParty Sanomapaketti 2 1..1 A4 BB01=Rakenteelliset tiedot BB02=Mittaustieto BB03=Laskutustieto Package listagencyidentif ier=nfi

195 (198) 13 Koodilistat Asiakkaan tunnisteen tyyppi Asiakkaan tyyppi Asiointitapa Yhteystiedot, tyyppi Käyttöpaikan tila Käyttöpaikan osoitteen tyyppi Käyttöpaikan tyyppi Laskutustapa Laskutuskanava Myyntisopimus asiakkaalla Verkkosopimus asiakkaalla AA01=Y-tunnus AA02=Yhdistystunnus AA03= Henkilötunnus (hetu) AA04=Osapuolen oma tunnus AB01=Yritys AB02=Kuluttaja AC01=Sähköinen AC02=Muu AD01=Puhelin AD02=Sähköpostiosoite AE01=Kytketty AE02=Katkaistu AE03=Rakenteilla AE04=Poistettu käytöstä AF01=Pääosoite AF02=Lisäosoite AG01=Kulutus AG02=Tuotanto AG03= Tuotantoyksikön oma käyttö AH01=Erillislaskutus, AH02=Verkko laskuttaa molemmat AH03=Myyjä laskuttaa molemmat AI01=Paperilasku AI02=Verkkolasku AI03=E-lasku AI04=Sähköposti AI05=Netposti AI06=Suoramaksu AI07=Mobiililasku AI08=Muu laskutuskanava AJ01=Sopimus asiakkaalla AJ02=Sopimus osittain asiakkaalla AJ03=Sopimus ei asiakkaalla AK01=Sopimus asiakkaalla AK02=Sopimus osittain asiakkaalla AK03=Sopimus ei asiakkaalla

196 (198) Yhteyshenkilön tyyppi Muu sähköinen laskutusosoite, tyyppi Sopimuksen päättäminen, syy AL01=Edunvalvoja AL02=Sopimusvastaava AL03=Laskutusvastaava AL04=Kytkentävastaava AL05=Vikaviestintä AM01=Sähköpostilaskun osoite (AM02=E-laskun osoite) AM03=Mobiililaskun puhelinnumero AN01=Ulosmuutto AN02=Irtisanominen AN03=Purkaminen Kieli Kts. ISO 639-1 Maa Kytkentätila Valtuutuksen syy/tarkoitus Käyttöpaikan alityyppi Sopimuksen perumisen syy Osapuolen tyyppi Sopimuksen aloituksen syy Tasevirheen tyyppi Kts. ISO 3166-1 alpha-2 AO01=Kytkentäpyyntö tai kytkentä AO02=Katkaisupyyntö tai katkaisu AP01=Energiaraportointi AP02=Tarjouspyyntö AP03=Sopimuksen kilpailutus palveluna AQ01=Normaali AQ02=Kiinteistökayttöpaikka AR01=Asiakas peruuttanut sopimuksen AR02=Myyjä peruuttanut sopimuksen AR03=Jakeluverkonhaltija peruuttanut sopimuksen AS01=Myyjä AS02=Jäkeluverkonhaltija AS03=3. osapuoli AS04=Muu verkonhaltija AT01=Sopimuksen vaihto AT02=Myyjän vaihto AT03=Sisäänmuutto AU01=Käyttöpaikka AU02=Häviö

197 (198) Tuotantolaji Kuittauksen tyyppi Sanomapaketti Päivityksen tyyppi Taseselvityslaji AV01=Vesivoima AV02=Tuulivoima AV03=Ydinvoima AV04=Kaasuturpiini AV05=Diesel-voimakone AV06=Aurinkovoima AV07=Aaltovoima AV08=Yhteistuotanto AV09=Biovoima AV10=Muu tuotanto BA01=Sanoma hyväksytty BA02=Sanoma hylätty BA03=Osittain hyväksytty BB01=Rakenteelliset tiedot BB02=Mittaustieto BB03=Laskutustieto BC01=Sopimuksen vaihto BC02=Myyjän vaihto BC03=Sisäänmuutto BD01=Pientuotanto BD02=Tasepoikkeama BD03=Rajapistesumma BD04=Kokonaisrajapistesumma BD05=Tuotantoyksikön tuotanto BD06=Omakäyttö BD07=Häviöt BD08=Summatoimitus

198 (198) Käyttäjäryhmä Asiakkaan alityyppi Mittaustapa Mittausalueen tyyppi BE01=Asunnot, kerrostalo BE02=Asunnot, pientalo (rivi-, pari- ja omakotitalo), sähkölämmitteinen BE03=Asunnot, pientalo (rivi-, pari- ja omakotitalo), eisähkölämmitteinen BE04=Asunnot, vapaa-ajan asunto BE05=Asuinkiinteistöt BE06=Maataloustuotanto (TOL A) BE07=Teollisuus (TOL B ja C) BE08=Yhdyskuntahuolto tai energia- ja vesihuolto (TOL D, E) BE09=Rakentaminen (tilapäissähkö) (TOL F) BE10=Palvelut BE11=Ulkovalaistus BE12=Sähköautojen latauspisteet BE13=Liikenne BE14=Muu kohde BF01=Normaali BF02=Kuolinpesä E13=Tuntimittaus E14=Lukemamittaus E16=Mittaroimaton Z01=Alueellinen Z03=Teollinen Z04=Jakelu Z05=Mittausluvaton Z06=Tuotanto Z07=Siirto