Datahub-tapahtumat tekninen kuvaus

Datahub-tapahtumat tekninen kuvaus

SISÄLLYSLUETTELO 1 Johdanto... 13 1.1 Yleistä... 13 2 Yleiset rajapintamääritykset... 14 2.1 Nimiavaruus (namespace)... 14 2.2 Versiointi... 15 2.2.1 Sanomaversio... 15 2.2.2 Sanoman aliversio... 15 2.2.3 schemalocation... 15 2.3 Sanomarakenne... 16 2.3.1 Otsikko (header)... 16 2.3.2 Prosessi (process)... 17 2.3.3 Tapahtumatiedot (payload)... 17 2.4 Yleiset elementit... 17 2.4.1 Tunnusten ja koodilistojen ylläpitäjät... 17 2.4.2 Osapuolet ja mittausalueet... 17 2.4.3 Käyttöpaikkatunnukset... 18 2.4.4 Aikaleimat ja aikavälit... 18 2.4.5 Arvojen yksiköt... 18 2.4.6 Sanomien tunnukset... 18 2.5 Sanomavalidoinnit... 18 2.5.1 XML schema... 18 2.5.2 Prosessivalidoinnit... 19 2.5.3 Tapahtumavalidoinnit... 19 2.6 Kuittauskäsittely... 19 2.7 Kyselytapahtumat... 20 2.8 Sanomalista... 20 2.9 Peruutussanomat ja -tapahtumat... 23 2.10 Tapahtumien välitys... 24 2.11 Tapahtumien nouto... 24 2.12 Tapahtumien synkronisuus/asynkronisuus... 25 3 DH-100 Asiakas- ja käyttöpaikkatietojen ylläpitoprosessit... 26 2 (144)

3.1 DH-111 Asiakastietojen päivitys myyjä... 26 3.2 DH-112 Asiakastietojen päivityspyyntö... 29 3.3 DH-121 Käyttöpaikan luonti... 30 3.4 DH-122 Käyttöpaikkatietojen päivitys... 33 3.5 DH-123 Käyttöpaikan poisto... 34 3.6 DH-124 Käyttöpaikkatietojen päivityspyyntö... 36 3.7 DH-131 Käyttöpaikkatunnuksen selvitys... 37 3.8 DH-132 Käyttöpaikka ja asiakastietojen haku nykyinen myyjä... 39 3.9 DH-133 Käyttöpaikka ja asiakastietojen haku uusi myyjä... 41 3.10 DH-134 Käyttöpaikka ja asiakastietojen haku jakeluverkonhaltija... 44 3.11 DH-135 Käyttöpaikka ja asiakastietojen haku 3. osapuoli... 46 4 DH-200 Mittaustiedon ylläpitoprosessit... 49 4.1 DH-211 Mittaustiedon ilmoitus... 49 4.2 DH-221, DH-222, DH-223 Mittaustiedon haut... 52 4.3 DH-212 Muistutus mittaustiedon ilmoituksesta... 54 5 DH-300 Sopimusprosessit... 55 5.1 DH-311 Ilmoitus uudesta sopimuksesta... 56 5.1.1 DH-311-1 Uuden sopimuksen tiedot... 57 5.1.2 DH-311-2 Uuden sopimuksen tiedot jakeluverkonhaltijalle... 60 5.1.3 DH-311-3 Ilmoitus myyntisopimuksen päättymisestä nykyiselle myyjälle... 62 5.1.4 DH-311-4 Ulosmuuttoilmoitus tuotantokäyttöpaikan myyjälle... 62 5.2 DH-312 Verkkosopimuksen vahvistaminen... 63 5.3 DH-321 Myyntisopimuksen tietojen päivitys... 66 5.4 DH-322 Verkkosopimuksen tietojen päivitys... 68 5.5 DH-323 Ilmoitus myyjättömästä käyttöpaikasta... 69 5.6 DH-331 Ilmoitus myyntisopimuksen päättymisestä... 70 5.7 DH-332 Sisäänmuuttokohteen myyjän ilmoitus asiakkaan ulosmuutosta... 72 5.8 DH-333 Ilmoitus verkkosopimuksen päättymisestä... 73 5.9 DH-340 Sopimuksen peruuttaminen... 75 5.9.1 DH-341 Ilmoitus myyntisopimuksen peruuttamisesta... 75 5.9.2 DH-342 Ilmoitus verkkosopimuksen peruuttamisesta... 77 5.9.3 DH-343 Edeltävän myyjän ilmoitus myyntisopimuksen palautuksesta kieltäytymisestä 78 3 (144)

5.9.4 DH-344 Ilmoitus verkkosopimuksen päättymisestä peruutustilanteessa.... 79 6 DH-400 Kytkentä- ja katkaisuprosessit... 81 6.1 DH-411 Toimituksen kytkentäpyyntö... 81 6.2 DH-412 Ilmoitus toimituksen kytkennästä... 82 6.3 DH-421 Toimituksen katkaisupyyntö... 84 6.4 DH-422 Ilmoitus toimituksen katkaisusta... 85 6.5 DH-413, DH-423 Ilmoitus kytkennän tai katkaisun viivästymisestä... 87 7 DH-500 Taseselvitys... 89 7.1 DH-514, DH-522, DH-523 Jakeluverkonhaltijan taseselvitystiedot... 89 7.2 DH-515, DH-521 Myyjän taseselvitystiedot... 93 8 DH-600 Tasevirheiden korjaus... 96 9 DH-700 Tuote- ja laskutustiedon ylläpitoprosessit... 98 9.1 DH-711, DH-712 Tuotetietojen päivitys... 98 9.2 DH-721, DH-722, DH-723 Tuotetietojen haku... 101 9.3 DH-731, DH-732 Laskurivitietojen ilmoitus... 102 9.4 DH-741, DH-742, DH-743 Laskurivitietojen haku... 103 10 DH-800 Valtuutukset... 105 10.1 DH-811, DH-812, DH-813 Asiakkaan valtuutuksen Ilmoitus... 105 11 DH-900 Osapuolitiedot... 107 11.1 DH910 Osapuolitiedot... 107 11.2 DH920 Osapuolitietojen haku... 109 12 Sanomakuvaukset... 111 12.1 Otsikko... 111 12.2 Prosessi... 111 12.3 Tapahtumatiedot... 111 12.3.1 Master data, asiakas... 111 12.3.2 Käyttöpaikkalista... 113 12.3.3 Master data, käyttöpaikka... 114 12.3.4 Käyttöpaikkatiedot... 117 12.3.5 Master data, sopimus... 122 4 (144)

12.3.8 Master data, sopimuksen peruminen... 127 12.3.9 Mittaustiedot... 129 12.3.10 Mittaustietopyyntö... 130 12.3.11 Mittaustiedon haku... 130 12.3.12 Kytkentä-katko... 131 12.3.13 Taseselvitystiedon haku... 132 12.3.14 Taseselvitystiedot... 132 12.3.15 Tasevirhetiedot... 134 12.3.16 Master data, tuote... 135 12.3.17 Tuotetietojen haku... 136 12.3.18 Laskurivitiedot... 136 12.3.19 Laskurivitietojen haku... 137 12.3.20 Valtuutustiedot... 137 12.3.21 Osapuolitiedot... 138 12.4 Kuittaustapahtuma... 140 12.5 Noutotapahtuma... 140 13 Koodilistat... 141 5 (144)

KUVAT Kuva 1 Asiakas- ja käyttöpaikkatapahtumat... 26 Kuva 2 DH-111 - Asiakastietojen päivitys - myyjä... 27 Kuva 3 DH-112 - Asiakastietojen päivityspyyntö... 30 Kuva 4 DH-122 - Käyttöpaikkatietojen päivitys... 34 Kuva 5 DH-123 - Käyttöpaikan poisto... 35 Kuva 6 DH-131 - Käyttöpaikkatunnuksen selvitys... 38 Kuva 7 DH-132 - Käyttöpaikka- ja asiakastietojen haku - nykyinen myyjä... 40 Kuva 8 DH-133 - Käyttöpaikka- ja asiakastietojen haku - uusi myyjä... 42 Kuva 9 DH-134 - Käyttöpaikka- ja asiakastietojen haku - JVH... 45 Kuva 10 DH-135 - Käyttöpaikka- ja asiakastietojen haku - 3. osapuoli... 47 Kuva 11 Mittaustapahtumat... 49 Kuva 12 DH-211 - Mittaustiedon ilmoitus... 50 Kuva 13 DH-220 - Mittaustiedon haku... 52 Kuva 14 DH-212 - Muistutus mittaustiedon ilmoituksesta... 54 Kuva 15 Sopimustapahtumat... 55 Kuva 16 DH-311 - Ilmoitus uudesta sopimuksesta... 57 Kuva 17 DH-312 - Verkkosopimuksen vahvistaminen... 63 Kuva 18 DH-321 - Myyntisopimuksen tietojen päivitys... 66 Kuva 19 DH-322 - Verkkosopimuksen tietojen päivitys... 68 Kuva 20 DH-323 - Ilmoitus myyjättömistä käyttöpaikoista... 69 Kuva 21 DH-331 Ilmoitus myyntisopimuksen päättymisestä... 70 Kuva 22 DH-332 - Sisäänmuuttokohteen myyjän ilmoitus asiakkaan ulosmuutosta... 72 Kuva 23 DH-333 - Ilmoitus verkkosopimuksen päättymisestä... 74 Kuva 24 DH-341 - Ilmoitus myyntisopimuksen peruuntumisesta... 76 Kuva 25 DH-342 - Ilmoitus verkkosopimuksen peruuttamisesta... 77 Kuva 26 DH-343 - Edeltävän myyjän ilmoitus myyntisopimuksen palautuksesta kieltäytymisestä79 Kuva 27 DH-344 - Ilmoitus verkkosopimuksen päättymisestä peruutustilanteessa... 80 Kuva 28 Kytkentä- ja katkaisutapahtumat... 81 Kuva 29 DH-411 - Toimituksen kytkentäpyyntö... 82 Kuva 30 DH-412 - Ilmoitus toimituksen kytkennästä... 83 Kuva 31 DH-421 - Toimituksen katkaisupyyntö... 84 6 (144)

Kuva 32 DH-422 - Ilmoitus toimituksen katkaisusta... 86 Kuva 33 DH-413 - Ilmoitus kytkennän viivästymisestä... 87 Kuva 34 Taseselvitystapahtumat... 89 Kuva 35 DH-514 - Taseselvitystietojen ilmoitus jakeluverkonhaltijalle... 90 Kuva 36 DH-522 - Taseselvitystietojen haku - JVH... 90 Kuva 37 DH-523 - Häviöihin kirjattujen kulutusten ja tuotantojen haku... 91 Kuva 38 DH-515 - Taseselvitystietojen ilmoitus myyjälle... 93 Kuva 39 DH-521 - Taseselvitystietojen haku - myyjä... 94 Kuva 40 Tasevirhetapahtumat... 96 Kuva 41 DH-611 - Tasevirhetietojen ilmoitus myyjälle... 96 Kuva 42 DH-612 - Tasevirhetietojen ilmoitus jakeluverkonhaltijalle... 97 Kuva 43 Tuote- ja laskurivitapahtumat... 98 Kuva 44 DH-710 - Tuotetiedon päivitys... 99 Kuva 45 DH-720 - Tuotetiedon haku... 101 Kuva 46 DH-730 - Laskurivitietojen ilmoitus... 102 Kuva 47 DH-740 - Laskurivitietojen haku... 104 Kuva 48 Valtuutustapahtumat... 105 Kuva 49 DH-810 - Asiakkaan valtuutuksen ilmoitus... 105 Kuva 50 Osapuolitapahtumat... 107 Kuva 51 DH-920 Osapuolitietojen haku... 108 Kuva 52 DH-920 Osapuolitietojen haku... 110 7 (144)

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, joka rajapisteiden mittaustiedon ilmoituksessa tulkitaan positiiviseksi sähkön siirtosuunnaksi (ottoalueelta antoalueelle). (Mittaustiedon) aikaleima. Mittaustiedon ajallinen kohdistusmerkintä, joka kertoo, minkä aikajakson tiedosta on kyse. Asiakas. Henkilö tai yritys, 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. Handbook) ET. Energiateollisuus ry on sähkö- ja kaukolämpöalaa edustava elinkeinopoliittinen ja työmarkkinapoliittinen etujärjestö. 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. 8 (144)

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. 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. Jakeluverkonhaltija. Yhteisö tai yhtiö, jolla on hallinnassaan 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. 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ä tietojoukko, 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. (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. Mittausalue. Yhteispohjoismaisessa taseselvityksessä käytettävä looginen tieto, jota käytetään jakeluverkonhaltijan taseselvityksessä. Mittausalueen fyysinen vastine on Suomen sähköjärjestelmään liittynyt tai siitä erillään toimiva Sähkömarkkinalain mukainen jakeluverkko tai suurjännitteinen jakeluverkko. 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ö. 9 (144)

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. Mittaustiedot. Mittarin tuottamat tiedot, 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. (Sähkön)myyjä. Henkilö, yhteisö tai yhtiö, joka myy sähköä tai ostaa (tässä yhteydessä asiakkaan pientuotannon) sähköä. (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. Osapuoli. Toimija tai 3.osapuoli (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ä aikaaskeleella). Rajapiste on kahden sähköverkon rajalla oleva piste, jossa näiden verkkojen välinen sähkön siirto määritetään Rajapistemittaus on mittaus, joka liittyy rajapisteeseen. Ottoalue. Mittausalue, joka rajapisteiden mittaustiedon ilmoituksessa tulkitaan negatiiviseksi sähkön siirtosuunnaksi (antoalueelta ottoalueelle). Siirtotuote. ks. Verkkotuote 10 (144)

Sisäänmuuttokohde. Käyttöpaikka, jonne asiakas on muuttamassa. 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. 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. 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. 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. 11 (144)

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. Tuntimittaukseen liittyvä tieto, joka sisältää aikaleiman, mittausarvon sekä statustiedon. 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. Tuotantoyksikkö. Pohjoismaisessa taseselvityksessä käytettävä tietojoukko, joka kuuluu tuotantotaseen puolella käsiteltävään tuotantoon. (Sähkö)tuote. Myynti- tai verkkotuote 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 tai toimijan osapuolelle antama lupa saada tietoonsa itseensä liittyvää tietoa Datahubista. Osapuolella tulee olla todiste (esimerkiksi valtakirja) asiakkaan antamasta valtuutuksesta. (Sähkö)verkkosopimus. Jakeluverkonhaltijan ja asiakkaan välinen sopimus, joka koskee asiakkaan tarvitsemaa verkkopalvelua. Verkkotuote. Jakeluverkonhaltijan verkkopalvelussa käyttämä sähkötuote. 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öä. 12 (144)

1 JOHDANTO 1.1 Yleistä Tämä dokumentti sisältää Datahubin tiedonvaihtoon liittyvät rajapintakuvaukset. Dokumentti perustuu Datahubin prosessityöryhmien kuvaamiin liiketoimintaprosesseihin ja tietomalleihin. Tämän dokumentin lisäksi tullaan vielä erikseen määrittämään tarvittavat tekniset rajapintamääritykset (kuten xml schemat, wsdl kuvaukset, esimerkkisanomat). Dokumentaatio on tuotettu Datahubin teknisen asiantuntijaryhmän toimesta. Ryhmän jäseninä ovat toimineet: Jari Arve, Ari Hallikainen, Jari Hirvonen, Mikko Horsmanheimo, Arttu Lahtinen, Joni Räsänen, Merja Toikko, Satapirkan Sähkö Oy Enoro Oy (työpajojen fasilitointi) Fingrid Oyj (ryhmän puheenjohtaja) Caruna Oy Fortum Markets Oy Tieto Oyj Enfo Zender Oy Ryhmän työpajoihin ovat lisäksi osallistuneet seuraavat Fingridin prosessityöryhmien jäsenet; Marko Juslin, Esa Pietarinen ja Marjut Puukangas. Kappaleessa 2 on esitetty sanomiin ja tapahtumiin liittyviä yleisiä sääntöjä, jotka koskevat rajapintoja yleisesti. Kappaleissa 3-11 on kuvattu eri tapahtumissa käytettävä tietosisältö, tapahtumien välitysketjut sekä alustavat tapahtumavalidoinnit. Sopimusten kiistämistilanteisiin ei määritellä rajapintaa vaan kiistämiset hoidetaan manuaalitoimenpitein. Liiketoimintaprosessien kuvauksen kappaleessa 3.9 esitettyä Asiakkaan pääsy omiin tietoihin -toimintoa ei ole kuvattu tässä dokumentissa. Myös muut Datahubiin tulevat online palvelut määritellään erikseen Datahubin sisäisen toiminnallisuuden määrittelytyön yhteydessä. Dokumentissa esitetyt tapahtumavalidoinnit ovat alustavia ja validoinnit tullaan tarkentamaan järjestelmän sisäisen toiminnallisuuden määrittelytyön yhteydessä. Listattujen tarkistusten lisäksi tapahtumavalidoinnissa tarkistetaan tapahtumakohtaiset tietojen pakollisuudet ja enumeraatiot. Virheellisistä tapahtumista palautetaan negatiivinen kuittaus. Kappaleessa 12 on kuvattu tapahtumien tietosisältö teknisesti. XML määritykset tullaan tekemään kappaleen mukaisesti. XML sanomaviittaukset ovat viittelliset ja niihin tullee muutoksia siinä vaiheessa, kun XML -schemat määritellään. 13 (144)

Sanomien pakkaaminen ja salaaminen sekä autentikointikäytännöt tullaan määrittämään ja kuvaamaan XML-määritysten yhteydessä. 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 olemassaolevien 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 Elbubissa käsitellään myös profiilikäyttöpaikkojen lukemamittauksia. Tästä 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 ebix sanomamää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 atribuutit. Datahub sanomissa käytetään nimiavaruudelle määritystä: urn:fi:datahub:mif:<package>:<message name>:<major version> Package - Käytetään seuraavia arvoja: Masterdata Master datan päivityksiin liittyvät sanomat Metering Mittaustietoihin liittyvät sanomat Billing Laskutukseen liityvä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: 14 (144)

<rsm: MasterDataCustomer xmlns:rsm="urn:fi:datahub:mif:masterdata: MasterDataCustomer:v1" xmlns:abie="urn:fi:datahub:mif:common:aggregatedbusinessinformationentitie s:v1" <rsm:header> <abie:identification>123e4567-e89b-12d3-a456-426655440000</abie:identification> 2.2 Versiointi 2.2.1 Sanomaversio Sanomaversio esitetään rsm nimiavaruusmäärityksessä. 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 atribuuttien nimiin Muutokset sanoman rakenteeseen tai järjestykseen Pakollisten elementtien tai atribuuttien poistaminen tai lisääminen Elementtien tai atribuuttien 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"> 15 (144)

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 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 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. 2 1..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. 2 0..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. 2 1..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. [3] [3] [3] [3] Lähettäjän reititystieto 2 0..1 Lähettäjän asettama reititystieto [4] [1] Datahubin sanomaliikenteessä kaikille vastaanotetuille sanomille muodostetan kuittaussanoma. Kuittauspyyntöä ei esitetä sanomaotsikossa. [2] 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. [2] Sanoman teknisellä lähettäjällä tarkoitetaan osapuolta, joka toimittaa sanoman. Sanoman juridisella lähettäjällä tarkoitetaan osapuolta, jonka tietoja sanomassa lähetetään. Esimerkiksi jos palveluntarjoaja huolehtii mittaustiedon keruusta ja toimittamisesta Datahubiin (jakeluverkonhaltijan puolesta), tekninen lähettäjä on palveluntarjoaja ja juridinen lähettäjä on jakeluvarkonhaltija. Vastaavasti sanoman teknisellä vastaanottajalla tarkoitetaan sanoman vastaanottajaa ja juridisella vastaanottajalla sanoman tietojen varsinaista osapuolta. [3] 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 tekninen kuvaus on esitetty sanomakuvausosiossa, Otsikko. 16 (144)

2.3.2 Prosessi (process) Sanoman prosessitiedot sisältävät seuraavat tiedot. Tietokenttä Taso Pakollisuus Kommentti Prosessi 1 1..1 Prosessin tunnus 2 1..1 Käytetään Datahubin tapahtumatunnuksia (esim. DH-111-1) Rooli 2 1..1 Toimiala 2 1..1 Sähkö Prosessitietojen tekninen kuvaus on esitetty sanomakuvausosiossa, Prosessi 2.3.3 Tapahtumatiedot (payload) Prossesseihin liittyvät tapahtumat ja tietosisältö on kuvattu tapahtumakohtaisesti kappaleissa 3-10. Tekniset kuvaukset tapahtumille on kuvattu kappaleessa 11 Tapahtumatiedot. 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 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 ja mittausaluetunnusten osalta siirrytään käyttämään GS1 tunnuksia. 17 (144)

2.4.3 Käyttöpaikkatunnukset Käyttöpaikkatunnusten osalta siirrytään käyttämään GS1 tunnuksia. Käyttöpaikkatunnusten tulee olla Datahubissa yksilöiviä tunnuksia ja yhteispohjoismainen vähittäismarkkina tulee tämän vaatimaan. GS1 tunnukset ovat jo käytössä Ruotsissa ja Norjassa. 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 esitetään käytettäväksi SI-järjestelmän mukaisia tunnuksia, esim kw, MW, kwh, MWh, kvar, MVAR, kvarh, Mvarh. 2.4.6 Sanomien tunnukset Sanomien tunnuksina käytetään UUID tunnuksia (Universally Unique Identifiers). 2.5 Sanomavalidoinnit Datahub validoi sanomia 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). 18 (144)

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, liiketoimintaprosessin mukaiset validoinnit, joita ei XML schema - ja prosessivalidoinneissa validoida. Tapahtumavalidoinnissa validoidaan ilmoituksen attribuuttien välisien riippuvuuksien ja aikarajojen täyttymistä sekä 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 datastandardissa (viittaus) 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) Tapahtumakohtaissa kuvauksissa (kappaleet 3 11) on listattu kyseiseen tapahtumaan liittyvät tapahtumavalidoinnit. Validointeja tullaan tarkentamaan projektin edetessä. 2.6 Kuittauskäsittely Datahub rajapinnossa käytetään aina kuittaussanomaa. Sanoman otsikkotiedoissa ei määritellä erikseen, halutaanko kuittaus vai ei. Datahub toimittaa vastaanotetuille sanomille aina joko positiivisen tai negatiivisen kuittauksen. Kyselytapahtumissa palautettavat tiedot toimivat positiivisena kuittauksena ja virhetilanteesta palautetaan negatiivinen kuittaussanoma. Noudettaessa sanomia Datahubista noutavan osapuolen tulee kuitata sanomien vastaanotto positiivisella tai negatiivisella kuittaussanomalla. Jos sanomaa ei kuitata 30 min kuluessa noudosta, siirretään sanoma takaisin noudettavaksi. Datahub rajapinnossa sovelletaan 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 Kuittaustapahtuma 1..9999 Kuittausaika 1 1..1 Alkuperäisen sanoman tunnus Alkuperäisen sanoman lähettäjä 1 1..1 1 1..1 19 (144)

Selite 1 0..1 Tapahtumatason kuittaus 2 1..n Kuittauksen tyyppi 2 1..1 Hyväksytty Osittain hyväksytty Hylätty [1] Kuittauksen teksti 2 1..1 Virheteksti Päivityksen tyyppi 2 0..1 Sopimuksen vaihto Myyjän vaihto Sisäänmuutto [2] Aikasarjatason kuittaus 2 0..9999 Käytetään vain mittaustiedolle Lähettäjän aikasarjatunnus 3 1..1 Kuittauksen tyyppi 3 1..1 Virhekoodi Kuittauksen teksti 3 1..1 Virheteksti [1] 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 haussa mikäli asiakas on antanut valtuuksen sisäänmuuttokohteeseen. Asiakas ei voi valtuuttaa myyjää saamaan enempää tietoa sisäänmuuttokohteesta kuin mitä myyjä saisi käyttöpaikkatunnuksen selvityksessä. [2] 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 sanomakuvausosiossa, Kuittaussanoma. 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 kadun nimen hakuarvossa tähteä (*) jokerimerkkinä arvon alussa ja lopussa (esim Syy*, *riankatu, *yy*ia*). Jokerimerkkiä tuetaan myös talonumero ja porrastunnus -kentille. 2.8 Sanomalista Kappaleissa 3-11 on kuvattu Datahubin prosessit. Tapahtumien tietosisältö on kuvattu prosessikohtaisesti ja taulukossa on määritelty tietokenttien tasot ja pakollisuudet kyseisen prosessin kannalta. Lisäksi taulukossa on kyseiseen prosessiin liittyviä prosessikohtaisia kommentteja. Prosessit viittaavat kappaleen 12 teknisiin tapahtumakuvauksiin. Teknistä tapahtumaa hyödynnetään yhdessä tai useammassa prosessissa. Teknisissä tapahtumissa kuvataan tietosisältö sekä tietokenttien tasot ja pakollisuudet XML sanoman ja scheman kannalta. 20 (144)

Tietokenttien formaatti, esimerkki ja XML viittaus on määritelty teknisessä tapahtumakuvauksessa. Alla olevassa taulukossa on esitetty yhteenveto prosessitapahtumista ja sanomista. 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 master datalle (E58). Muiden sanomien osalta on päädytty määrittämään erikseen kansalliset Datahub -sanomat (Fxx sanomat). Prosessi Tekninen lähettäjä Sanoma Tapahtuma Tapahtumakuvaus DH-111 Asiakastietojen päivitys myyjä Myyjä F01 MasterDataCustomerEvent Master data, asiakas DH-112 Asiakastietojen päivityspyyntö Myyjä F01 MasterDataCustomerEvent Master data, asiakas DH-121 Käyttöpaikan luonti JVH E58 MasterDataMPEvent Master data, käyttöpaikkamaster data, asiakas DH-122 Käyttöpaikkatietojen päivitys JVH E58 MasterDataMPEvent Master data, käyttöpaikkamaster data, asiakas DH-123 Käyttöpaikan poisto JVH E58 MasterDataMPEvent Master data, käyttöpaikkamaster data, asiakas DH-124 Käyttöpaikkatietojen päivityspyyntö Myyjä E58 MasterDataMPEvent Master data, käyttöpaikkamaster data, asiakas DH-131 Käyttöpaikkatunnuksen selvitys Myyjä JVH 3. osapuoli F02 RequestMPList ResponseMPList KäyttöpaikkalistaMaster data, asiakas DH-132 Käyttöpaikka ja asiakastietojen haku nykyinen myyjä DH-133 Käyttöpaikka ja asiakastietojen haku uusi myyjä DH-134 Käyttöpaikka ja asiakastietojen haku jakeluverkonhaltija DH-135 Käyttöpaikka ja asiakastietojen haku 3. osapuoli Myyjä F03 RequestMPInfo ResponseMPInfo Myyjä F03 RequestMPInfo ResponseMPInfo JVH F03 RequestMPInfo ResponseMPInfo 3. osapuoli F03 RequestMPInfo ResponseMPInfo KäyttöpaikkatiedotMaster data, asiakas KäyttöpaikkatiedotMaster data, asiakas KäyttöpaikkatiedotMaster data, asiakas KäyttöpaikkatiedotMaster data, asiakas DH-211 Mittaustiedon ilmoitus JVH 3. osapuoli E66 EnergyTimeSeries MittaustiedotMaster data, asiakas DH-221, DH-222, DH-223 Mittaustiedon haut Myyjä JVH 3. osapuoli F08 RequestMeasuredDataInfo EnergyTimeSeries Mittaustiedon hakumaster data, asiakas DH-212 Muistutus mittaustiedon toimituksesta DH-311 Ilmoitus uudesta sopimuksesta Datahub F07 RequestMeasuredData MittaustietopyyntöMaster data, asiakas Myyjä F04 MasterDataContractEvent Master data, sopimusmaster data, asiakas 21 (144)

DH-312 Verkkosopimuksen vahvistaminen DH-321 Myyntisopimuksen tietojen päivitys DH-322 Verkkosopimuksen tietojen päivitys DH-323 Ilmoitus myyjättömästä käyttöpaikasta DH-331 Ilmoitus myyntisopimuksen päättymisestä DH-332 Sisäänmuuttokohteen myyjän ilmoitus asiakkaan ulosmuutosta DH-333 Ilmoitus verkkosopimuksen päättymisestä DH-341 Ilmoitus myyntisopimuksen peruuttamisesta DH-342 Ilmoitus verkkosopimuksen peruuttamisesta DH-343 Edeltävän myyjän ilmoitus myyntisopimuksen palatutuksesta kieltäytymisestä DH-344 Ilmoitus verkkosopimuksen päättymisestä peruutustilanteessa. JVH F04 MasterDataContractEvent Master data, sopimusmaster data, asiakas Myyjä F04 MasterDataContractEvent Master data, sopimusmaster data, asiakas JVH F04 MasterDataContractEvent Master data, sopimusmaster data, asiakas Datahub F05 NotifyMPInfo Myyjätön käyttöpaikkamaster data, asiakas Myyjä F06 MasterDataContractClose Master data, sopimuksen päättäminenmaster data, asiakas Myyjä F06 MasterDataContractClose Master data, sopimuksen päättäminenmaster data, asiakas JVH F06 MasterDataContractClose Master data, sopimuksen päättäminenmaster data, asiakas Myyjä F18 MasterDataContractCancel Master data, sopimuksen peruminen JVH F18 MasterDataContractCancel Master data, sopimuksen peruminen Myyjä F06 MasterDataContractClose Master data, sopimuksen päättäminen JVH F06 MasterDataContractClose Master data, sopimuksen päättäminen DH-411 Toimituksen kytkentäpyyntö Myyjä F09 RequestPowerSwitch Kytkentä-katkoMaster data, asiakas DH-412 Ilmoitus toimituksen kytkennästä JVH F09 ResponsePowerSwitch Kytkentä-katkoMaster data, asiakas DH-421 Toimituksen katkaisupyyntö Myyjä F09 RequestPowerSwitch Kytkentä-katkoMaster data, asiakas DH-422 Ilmoitus toimituksen katkaisusta DH-413, DH-423 Ilmoitus kytkennän tai katkaisun viivästymisestä DH-514, DH-522, DH-523 Jakeluverkonhaltijan taseselvitystiedot DH-515, DH-521 Myyjän taseselvitystiedot JVH F09 ResponsePowerSwitch Kytkentä-katkoMaster data, asiakas JVH F09 ResponsePowerSwitch Kytkentä-katkoMaster data, asiakas Datahub E31 EnergyTimeSeries Taseselvitystiedot Datahub E31 EnergyTimeSeries Taseselvitystiedot DH-514, DH-522, DH-523 Jakeluverkonhaltijan taseselvitystiedot JVH F10 E31 RequestSettlementDataInfo EnergyTimeSeries Taseselvitystiedon haku TaseselvitystiedotMaster data, asiakas DH-515, DH-521 Myyjän taseselvitystiedot Myyjä F10 E31 RequestSettlementDataInfo EnergyTimeSeries Taseselvitystiedon haku TaseselvitystiedotMaster data, asiakas DH-600 Tasevirheiden korjaus Datahub F16 BalanceCorrectionData Tasevirhetiedot DH-711, DH-712 Tuotetietojen päivitys Myyjä JVH F11 MasterDataProductEvent Master data, tuotemaster data, asiakas 22 (144)

DH-721, DH-722, DH-723 Tuotetietojen haku Myyjä JVH 3. osapuoli F12 F11 RequestProductDataInfo MasterDataProductEvent Tuotetietojen hakumaster data, asiakas DH-731, DH-732 Laskutustietojen päivitys Myyjä JVH F13 BillingDataInfo Laskurivitiedot DH-741, DH-742, DH-743 Laskutustietojen haku Myyjä JVH 3. osapuoli F14 F13 RequestBillingtDataInfo BillingDataInfo Laskurivitietojen haku DH-811, DH-812, DH-813 Asiakkaan valtuutuksen Ilmoitus Myyjä JVH 3. osapuoli F15 AuthorizationEvent ValtuutustiedotMaster data, asiakas DH910 Osapuolitiedot Datahub F16 PartyInfo Osapuolitiedot DH920 Osapuolitietojen haku Myyjä JVH 3. osapuoli F17 F16 PartyInfoRequest PartyInfo Osapuolitiedot Kuittaustapahtuma Noutotapahtuma Peruutustapahtuma Myyjä JVH 3. osapuoli Datahub Myyjä JVH 3. osapuoli Myyjä JVH ACK Acknowledgement Kuittaustapahtuma F99 PollData Noutotapahtuma E67 Alkuperäinen tapahtuma Alkuperäinen tapahtuma 2.9 Peruutussanomat ja -tapahtumat Peruutuskäytännöt ovat seuraavat eri tapahtumille. Peruutusehdot on kuvattu tapahtumakohtaisesti prosessidokumentissa. Prosessi Sanoma Peruutustapa DH-111 Asiakastietojen päivitys myyjä F01 Peruutus tehdään päivityksellä. DH-112 Asiakastietojen päivityspyyntö F01 Peruutussanoma DH-121 Käyttöpaikan luontimaster data, asiakas DH-122 Käyttöpaikkatietojen päivitysmaster data, asiakas DH-124 Käyttöpaikkatietojen päivityspyyntömaster data, asiakas DH-211 Mittaustiedon toimitusmaster data, asiakas DH-311 Ilmoitus uudesta sopimuksestamaster data, asiakas E58 E58 E58 E66 F04 Käyttöpaikan luonti voidaan perua käyttöpaikan poistolla (DH-123) mikäli käyttöpaikalle ei ole vielä kohdistunut muita tapahtumia. Peruutus tehdään päivityksellä. Peruutussanoma Peruutus tehdään päivityksellä. Erillinen peruutussaoma (DH-341) 23 (144)

DH-312 Verkkosopimuksen vahvistaminenmaster data, asiakas DH-321 Myyntisopimuksen tietojen päivitys jmaster data, asiakas DH-322 Verkkosopimuksen tietojen päivitysmaster data, asiakas DH-331 Ilmoitus myyntisopimuksen päättymisestämaster data, asiakas F04 F04 F04 F06 Erillinen peruutussaoma (DH-342) Peruutus tehdään päivityksellä. Peruutus tehdään päivityksellä. Peruutussanoma DH-333 Ilmoitus verkkosopimuksen päättymisestä F06 Peruutussanoma DH-411 Toimituksen kytkentäpyyntömaster data, asiakas DH-412 Ilmoitus toimituksen kytkennästämaster data, asiakas DH-421 Toimituksen katkaisupyyntömaster data, asiakas DH-422 Ilmoitus toimituksen katkaisustamaster data, asiakas DH-413, DH-423 Ilmoitus kytkennän tai katkaisun viivästymisestämaster data, asiakas DH-711, DH-712 Tuotetietojen päivitysmaster data, asiakas DH-731, DH-732 Laskutustietojen ylläpitomaster data, asiakas DH-811, DH-812, DH-813 Asiakkaan valtuutuksen IlmoitusMaster data, asiakas F09 F09 F09 F09 F09 F11 F13 F15 Peruutussanoma Peruutussanoma Peruutussanoma Peruutussanoma Peruutus tehdään kytkentä/katkaisuilmoituksella Peruutus tehdään päivityksellä. Peruutus tehdään korjausriveillä. Peruutussanoma Peruutussanomaa käytettäessä lähetetään alkuperäisen sanoman tiedot sanoman tyypillä E67. Lisäksi voidaan välittää peruutuksen selitetieto. Yleiselle peruutustapahtumalle (E67) tehdään seuraavat validoinnit: # Tapahtumavalidointi 1 Alkuperäinen peruutettava 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. 24 (144)

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 dokumentissa. Sopimustapahtumien (sopimusten luonti- ja päivitystapahtumat) osalta on määritelty erilliset välitystapahtumat, koska kaikkea sopimustietoa ei tule välittää osapuolen välillä. Jos vastaanotettu tapahtuma ei sisällä muutoksia jo Datahubissa olevaan tietoon verrattuna, tapahtumatietoja 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. 2.11 Tapahtumien nouto Datahub ei toimita osapuolille meneviä sanomia vaan luodut sanomat puskuroidaan lähetysjonoon. Datahub toimittaa sanomat sanoman otsikkotiedoissa esitetyn luontiajan mukaisessa järjestyksessä. Osapuolet hakevat sanomat käyttämällä noutotapahtumaa. Noutotapahtuman tietosisältö on seuraava: Tietokenttä Taso Pakollisuus Kommentti Noutotapahtuma 1..1 Noutoaika 1 1..1 Osapuoli 1 1..1 [1] Sanomapaketti 1 1..1 Master data Mittaustieto Laskutustieto [2] Selite 1 0..1 [1] Palautetaan kyseiselle osapuolelle kohdistetut tapahtumat [2] Tapahtumatietojen lisäksi palautetaan myös kyseiseen sanomapakettiiin liittyvät kuittaustapahtumat. Noutotapahtumassa palautetaan pyydetyn osapuolen ja sanomapaketin kaikki uudet noutamattomat sanomat, mukaan lukien asynkroniset kuittaussanomat. 2.12 Tapahtumien synkronisuus/asynkronisuus Master datan päivitys- ja kyselytapahtumien osalta palvelurajapinnat ovat synkronisia. Kuittaus- ja tai vastaustiedot kyselyyn palautetaan palvelupyynnön vastauksena. Aikasarjatietojen (mittaustiedot ja taseselvitystiedot) osalta palvelut ovat asynkronisia. Kuittaukset ja vastaustiedot kyselyyn palautetaan erikseen noutopalvelun kautta. 25 (144)

26 (144)

3 DH-100 ASIAKAS- JA KÄYTTÖPAIKKATIETOJEN YLLÄPITOPROSESSIT Kuva 1 Asiakas- ja käyttöpaikkatapahtumat 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. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-111-1 F01 MasterDataCustomerEvent Master data, asiakas Myyjä Datahub DH-111-2 F01 MasterDataCustomerEvent Master data, asiakas Datahub JVH 27 (144)

DH-111-3 F01 MasterDataCustomerEvent Master data, asiakas Datahub Myyjä DH-111-4 F01 MasterDataCustomerEvent Master data, asiakas Datahub 3. osapuoli [*] 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 jakelvuverkonhaltija on pyytänyt asiakastietojen päivitystä (DH-112-1). Tällöin tiedot välitetään kyseiselle jakeluverkonhaltijalle. Kuva 2 DH-111 - Asiakastietojen päivitys - myyjä Myyjän lähettämä tapahtumatiedot sisältävät seuraavat tiedot: 28 (144)

Tietokenttä Taso Pakollisuus Kommentti Voimaantulopäivämäärä 1 1..1 Alkuperäisen sanoman tunnus 1 0..1 Käytetään vain välitysanomassa [1] Alkuperäisen sanoman lähettäjä 1 0..1 Käytetään vain välitysanomassa [1] Selite 1 0..1 Käytetään vain päivityspyynnössä Asiakkaan perustiedot 2 1..1 Asiakkaan tunnus 3 1..1 Käytetään joko y-tunnusta, yhdistystunnusta, hetua tai muu -tunnusta. [2] Asiakkaan tunnuksen tyyppi 3 1..1 Y-tunnus Asiakkaan tyyppi 3 1..1 Yritys Yhdistystunnus Henkilötunnus (hetu) Osapuolen oma tunnus Kuluttaja Osapuolen oma asiakastunnus 3 0..1 [3] Salattu -tieto 3 1..1 Kyllä/Ei. Kielikoodi 3 1..1 Käytetään ISO 639-1 mukaista koodia. Yrityksen nimi 3 0..1 Pakollinen yritysasiakkaille Etunimi 3 0..1 Pakollinen kuluttaja-asiakkaalle Keskimmäiset nimet 3 0..1 Sukunimi 3 0..1 Pakollinen kuluttaja-asiakkaalle Syntymäaika 3 0..1 Pakollinen kuluttaja-asiakkaalle, jos hetua ei ole annettu. VVVV-KK-PP Asiointitapa 3 1..1 Sähköinen Lisätunnus 3 0..1 Yhteystiedot 3 0..2 [4] Tyyppi 4 1..1 Puhelin Muu Sähköpostiosoite Puhelinumero Sähköpostiosoite 4 1..1 Postiosoite 3 1..1 [5] 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 Maatunnus 4 1..1 Käytetään ISO 3166I mukaista tunnusta. 29 (144)

[1] Datahub välittää myyjältä tulleen alkuperäisen sanoman lähettäjän ja tunnuksen välityssanoman mukana näissä kentissä. [2] Yritysasiakkaalla voi olla myös hetu tunnuksena, asiakas identifioidaan tyypillä ja tunnuksella. Jos käytetään muu tunnusta, on se muotoa <myyjän tunnus>_<asiakasnumero> (käytetään yksilöivänä tietona tilanteessa, jossa henkilötunnusta ei ole tiedossa). [3] Kenttää käytetään vain tilanteessa, jossa muu tunnus halutaan päivittää henkilötunnukseksi. [4] 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 Jos asiointitapa on sähköinen, niin yhteystiedoissa tulee olla sähköpostiosoite. 3 Asiakas löytyy Datahubista. 4 Myyjällä on voimasaoleva tai voimaan tuleva sopimus asiakkaan kanssa. 5 Voimaantulopäivä ei saa olla menneisyydessä. 3.2 DH-112 Asiakastietojen päivityspyyntö Jakeluverkonhaltija voi pyytää asiakastietojen päivittämistä. Päivityspyynnössä jakeluverkonhaltija lähettää asiakkaan kaikki asiakastiedot. Datahub välittää pyynnön myyjälle, joka on viimeisenä tehnyt sopimuksen kyseisen asiakkaan kanssa. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-112-1 F01 MasterDataCustomerEvent Master data, asiakas JVH Datahub DH-112-2 F01 MasterDataCustomerEvent Master data, asiakas Datahub Myyjä [*] Datahub välittää samat tapahtumatiedot myyjälle. Sanomaan lisätään alkuperäisen sanoman tunnus ja lähettäjä. 30 (144)

Kuva 3 DH-112 - Asiakastietojen päivityspyyntö Sanoman tapahtumatiedot sisältävät samat tiedot kuin tapahtuma DH-111. Sanomassa tulee lähettää asiakkaan kaikki tiedot, ei vain muuttuneita tietoja. 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 Jos asiointitapa on sähköinen, niin yhteystiedoissa tulee olla sähköpostiosoite. 3 Asiakas löytyy Datahubista. 4 Jakeluverkonhaltijalla on voimassaoleva sopimus asiakkaan kanssa. 5 Voimaantulopäivä ei saa olla menneisyydessä. 3.3 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. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] 31 (144)

DH-121 E58 MasterDataMPEvent Master data, käyttöpaikkamaster data, asiakas JVH Datahub Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Voimaantulopäivämäärä 1 1..1 Alkuperäisen sanoman tunnus 1 0..1 Käytetään vain välitysanomassa Alkuperäisen sanoman lähettäjä 1 0..1 Käytetään vain välitysanomassa Selite 1 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 Kytketty Katkaistu Rakenteilla Käyttöpaikan tyyppi 3 1..1 Kulutus Tuotanto Käyttöpaikan alityyppi 3 1..1 Normaali Etäkytkettävä 3 1..1 Kyllä/Ei Tuotantoyksikön oma käyttö Kiinteistökäyttöpaikka Mittausalue 3 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 Maatunnus 4 1..1 Käytetään ISO 3166I mukaista tunnusta. Vapaa teksti 4 0..1 Kielikoodi 4 1..1 Käytetään ISO 639-1 mukaista koodia. 32 (144)

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 Mittaustapa 4 1..1 Tuntimittaus Lukemamittaus Mittaroimaton Käyttäjäryhmä 4 1..1 Käytetään Tilastokeskuksen määrittämää luokittelua sähkön käyttötarkoituksen mukaan Lämmitys riippuu sähköstä 4 1..1 Kyllä/Ei Pakollinen kulutuskäyttöpaikalle. 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 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Varastolaite 3 0..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Tuotantolaite 3 0..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. [*] 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ääritttyy verkkosopimuksen tuotteen/tuotekomponenttien ja kalenterin perusteella. [1] Mittausalueen tunnuksena käytetään GS1 tunnusta. [2] 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 vapaatekstikentässä. [3] 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. # Tapahtumavalidointi 33 (144)

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. 3.4 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. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-122-1 E58 MasterDataMPEvent Master data, käyttöpaikkamaster data, asiakas DH-122-2 E58 MasterDataMPEvent Master data, käyttöpaikkamaster data, asiakas DH-122-3 E58 MasterDataMPEvent Master data, käyttöpaikkamaster data, asiakas JVH Datahub Datahub Datahub Myyjä 3. osapuoli [*] 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. 34 (144)

Kuva 4 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 Postitoimipaikka on oikea postinumeron perusteella. Tarkistus tehdään vain suomalaiselle osoitteelle. 4 Käyttöpaikkaa ei voi päivittää tilaan poistettu käytöstä, jos käyttöpaikalla on voimassa oleva myynti- tai verkkosopimus. 3.5 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. 35 (144)

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ä. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-123 E58 MasterDataMPEvent Master data, käyttöpaikkamaster data, asiakas JVH Datahub Kuva 5 DH-123 - Käyttöpaikan poisto Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Voimaantulopäivämäärä 1 1..1 Käyttöpaikan perustiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 Mittausalue 3 1..1 Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Käyttöpaikka löytyy järjestelmästä 36 (144)

2 Käyttöpaikalle ei ole kirjattu sopimustapahtumia. 3.6 DH-124 Käyttöpaikkatietojen päivityspyyntö Myyjä voi pyytää käyttöpaikkatietojen päivittämistä. Datahub välittää pyynnön jakeluverkonhaltijalle. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-124-1 E58 MasterDataMPEvent Master data, käyttöpaikkamaster data, asiakas DH-124-2 E58 MasterDataMPEvent Master data, käyttöpaikkamaster data, asiakas Myyjä Datahub Datahub JVH [*] Datahub välittää samat tapahtumatiedot jakeluverkonhaltijalle. Sanomaan lisätään alkuperäisen sanoman tunnus ja lähettäjä. Tapahtumassa välitetään pakolliset tiedot sekä ne tiedot, jotka halutaan päivitettäväksi. Sanoman tapahtumatiedot sisältävät seuraavat tiedot. Tietokenttä Taso Pakollisuus Kommentti Voimaantulopäivämäärä 1 1..1 Alkuperäisen sanoman tunnus Alkuperäisen sanoman lähettäjä 1 0..1 Käytetään vain välitysanomassa 1 0..1 Käytetään vain välitysanomassa Selite 1 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 1..1 Postitoimipaikka 4 1..1 Maatunnus 4 1..1 Käytetään ISO 3166I mukaista tunnusta. Vapaa teksti 4 0..1 Kielikoodi 4 1..1 Käytetään ISO 639-1 mukaista koodia. 37 (144)

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 3 0..1 [7] Ohjattava kuorma 3 0..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Varastolaite 3 0..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Tuotantolaite 3 0..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. 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ä. 3.7 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. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-131-1 F02 RequestMPList KäyttöpaikkalistaMaster data, asiakas DH-131-2 F02 ResponseMPList KäyttöpaikkalistaMaster data, asiakas Myyjä 3.osapuoli Datahub Datahub Myyjä 3.osapuoli 38 (144)

Kuva 6 DH-131 - Käyttöpaikkatunnuksen selvitys Kyselytapahtumassa on käytettävissä seuraavat hakukriteerit. Tietokenttä Taso Pakollisuus Kommentti Käyttöpaikan osoitekysely 1 1..1 Kadun nimi 2 1..1 Tuetaan jokerimerkkejä hakuarvossa. [1] 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 Rinnakkaiskäyttöpaikan tunnus 2 0..1 [1] 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 39 (144)

Käyttöpaikan perustiedot 1 1..50 Käyttöpaikan tunnus 2 1..1 Mittausalue 2 1..1 Status 2 1..1 Kytketty Katkaistu Rakenteilla Poistettu käytöstä Käyttöpaikan tyyppi 2 1..1 Kulutus Tuotanto Tuotantoyksikön oma käyttö Käyttöpaikan alityyppi 2 1..1 Etäkytkettävä 2 1..1 Kyllä/Ei Mittarinumero 2 0..1 Pätömittauksen mittarinumero [1] Käyttöpaikan osoitteet 2 1..n Osoitteen tyyppi 3 1..1 Pääosoite Lisäosoite Kadun nimi 3 1..1 Talonumero 3 0..1 Porrastunnus 3 0..1 Huoneisto 3 0..1 Postinumero 3 1..1 Postitoimipaikka 3 1..1 Maatunnus 3 1..1 Käytetään ISO 3166I mukaista tunnusta. Vapaa teksti 3 0..1 Kielikoodi 3 1..1 Käytetään ISO 639-1 mukaista koodia. Koordinaatisto 2 0..1 Leveysaste 3 1..1 Pituusaste 3 1..1 3.8 DH-132 Käyttöpaikka ja asiakastietojen haku nykyinen myyjä Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-132-1 F03 RequestMPInfo KäyttöpaikkatiedotMaster data, asiakas DH-132-2 F03 ResponseMPInfo KäyttöpaikkatiedotMaster data, asiakas Nykyinen myyjä Datahub Datahub Nykyinen myyjä 40 (144)

Haussa käytetään hakukriteerinä käyttöpaikka- ja sopimustunnusta. Haussa palautetaan käyttöpaikkatiedot, sopimustiedot ja sopimusasiakkaat. Kuva 7 DH-132 - Käyttöpaikka- ja asiakastietojen haku - nykyinen myyjä Kyselyssä annetaan seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Käyttöpaikan tunnus 1 1..1 Myyntisopimuksen tunnus 1 1..1 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 Käyttöpaikan tiedot 1 1..n [1] Voimaantulopäivämäärä 2 1..1 Päivämäärä, jolta tiedot raportoidaan. [2] Käyttöpaikan perustiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 Mittausalue 3 1..1 41 (144)

Status 3 1..1 Kytketty Katkaistu Rakenteilla Poistettu käytöstä Käyttöpaikan tyyppi 3 1..1 Kulutus Tuotanto Tuotantoyksikön oma käyttö Käyttöpaikan alityyppi 3 1..1 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 Verkkosopimuksen tiedot 3 1..n Verkkotuotteen tunnus 4 1..1 Verkkosopimuksen tuotteen tunnus Verkkotuotteen nimi 4 1..1 Verkkosopimuksen tuotteen nimi Käyttöpaikan osoitteet 3 1..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Koordinaatisto 3 0..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Käyttöpaikan ominaisuudet 3 0..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Ohjattava kuorma 3 0..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Varastolaite 3 0..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Tuotantolaite 3 0..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Myyntisopimuksen tiedot 2 1..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Myyntisopimuksen asiakkaat 3 1..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. [1] Haku voi palauttaa useamman rivin tilanteessa, jossa määräaikainen sopimus on uusittu käyttäen samaa sopimusnumeroa. [2] 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. 3.9 DH-133 Käyttöpaikka ja asiakastietojen haku uusi myyjä Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-133-1 F03 RequestMPInfo KäyttöpaikkatiedotMaster data, asiakas Uusi myyjä Datahub 42 (144)

DH-133-2 F03 ResponseMPInfo KäyttöpaikkatiedotMaster data, asiakas Datahub Uusi myyjä Kuva 8 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: Tietokenttä Taso Pakollisuus Kommentti Käyttöpaikan tiedot 1 1..n Käyttöpaikan tunnus 2 1..1 43 (144)

Asiakkaiden tiedot 2 1..n [1] Asiakkaan tunnus 3 1..1 [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 Voimaantulopäivämäärä 1 1..1 Päivämäärä, jolta tiedot raportoidaan. [1] Käyttöpaikan perustiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 Mittausalue 3 1..1 Status 3 1..1 Kytketty Katkaistu Rakenteilla Poistettu käytöstä Käyttöpaikan tyyppi 3 1..1 Kulutus Tuotanto Tuotantoyksikön oma käyttö Käyttöpaikan alityyppi 3 1..1 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 Verkkosopimuksen tiedot 3 1..n [2] Verkkotuotteen tunnus 4 1..1 Verkkosopimuksen tuotteen tunnus [2] Verkkotuotteen nimi 4 1..1 Verkkosopimuksen tuotteen nimi [2] Käyttöpaikan osoitteet 3 1..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Koordinaatisto 3 0..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Käyttöpaikan ominaisuudet 3 0..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. [2] Ohjattava kuorma 3 0..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. [2] Varastolaite 3 0..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. [2] Tuotantolaite 3 0..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. [2] Sopimustilanne 3 1..1 Alkava myyntisopimus 4 0..1 Seuraavan sopimustapahtuman alkamispäivä Myyntisopimus asiakkaalla 4 1..1 Sopimus asiakkaalla Sopimus osittain asiakkaalla Sopimus ei asiakkaalla [3] Määräaikainen myyntisopimus 4 1..1 Kyllä/ei [2] 44 (144)

Määräaikaisuuden päättymispäivä 4 0..1 Tätä tietoa ei palauteta,jos päätttyy yli 90 vuorokauden kuluttua. [2] Voimassa oleva myyntisopimus päättyy 4 0..1 Käyttöpaikalle on tullut aiemmin ilmoitus myyntisopimuksen päättymisestä. Poikkeava irtisanomisehto 4 1..1 Kyllä/ei [2] Irtisanomisaika 3 0..1 Poikkeava irtisanomisaika päivinä [2] Irtisanomijakso 3 0..1 [2] Irtisanomisjakson alkuaika 4 0..1 [2] Irtisanomisjakson loppuaika 4 0..1 [2] Verkkosopimus asiakkaalla 4 1..1 Sopimus asiakkaalla Sopimus osittain asiakkaalla Sopimus ei asiakkaalla Asiakkaiden tiedot 2 1..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. [4] [1] Tiedot raportoidaan hakuhetkeltä. [2] Tiedot palautetaan vain, jos asiakkaalla on voimassa oleva sopimus käyttöpaikalle. [3] 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" [4] Palautetaan niiden asiakkaiden tiedot, jotka ovat listattu kyselyssä. Asiakastiedot palautetaan vain jos myyjällä on valtuutus asiakastietoihin. [3] 3.10 DH-134 Käyttöpaikka ja asiakastietojen haku jakeluverkonhaltija Käyttöpaikan tiedot haetaan käyttöpaikkatunnuksella. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-134-1 F03 RequestMPInfo KäyttöpaikkatiedotMaster data, asiakas DH-134-2 F03 ResponseMPInfo KäyttöpaikkatiedotMaster data, asiakas JVH Datahub Datahub JVH 45 (144)

Kuva 9 DH-134 - Käyttöpaikka- ja asiakastietojen haku - JVH Kyselytapahtumassa välitetään seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Voimaantulopäivämäärä 1 1..1 Käyttöpaikan tunnus 1 1..1 Kyselylle tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Käyttöpaikka sijaitsee jakeluverkonhalitjan mittausalueella. Vastaustapahtumassa palautetaan käyttöpaikkaan liittyvät tiedot. Tietokenttä Taso Pakollisuus Kommentti Voimaantulopäivämäärä 1 1..1 Päivämäärä, jolta tiedot raportoidaan. [1] Käyttöpaikan perustiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 Mittausalue 3 1..1 46 (144)

Status 3 1..1 Kytketty Katkaistu Rakenteilla Poistettu käytöstä Käyttöpaikan tyyppi 3 1..1 Kulutus Tuotanto Tuotantoyksikön oma käyttö Käyttöpaikan alityyppi 3 1..1 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 Myyjä 2 0..1 Myyntiopimuksen tiedot 3 0..n [2] Myyntituotteen tunnus 4 1..1 Myyntisopimuksen tuotteen tunnus [2] Myyntituotteen nimi 4 1..1 Myyntisopimuksen tuotteen nimi [2] Käyttöpaikan osoitteet 3 1..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Koordinaatisto 3 0..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Käyttöpaikan ominaisuudet 3 0..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Ohjattava kuorma 3 0..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Varastolaite 3 0..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Tuotantolaite 3 0..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Verkkosopimuksen tiedot 2 1..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Verkkosopimuksen asiakkaat 3 1..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. [1] Tiedot palautetaan kyselyssä esitetyn ajanhetken mukaisesti. [2] Palautetaan, jos myyjä on antanut valtuudet tietoihin 3.11 DH-135 Käyttöpaikka ja asiakastietojen haku 3. osapuoli Käyttöpaikan tiedot voidaan hakea käyttöpaikkatunnuksella ja asiakastiedoilla halutulle ajanhetkelle. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-135-1 F03 RequestMPInfo KäyttöpaikkatiedotMaster data, asiakas 3. osapuoli Datahub DH-135-2 F03 ResponseMPInfo KäyttöpaikkatiedotMaster data, asiakas Datahub 3. osapuoli 47 (144)

Kuva 10 DH-135 - Käyttöpaikka- ja asiakastietojen haku - 3. osapuoli Kyselytapahtumassa välitetään seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Voimaantulopäivämäärä 1 1..1 Käyttöpaikan tunnus 1 1..1 Asiakkaiden tiedot 2 1..n Asiakkaan tunnus 3 1..1 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 Voimaantulopäivämäärä 1 1..1 Päivämäärä, jolta tiedot raportoidaan. [1] 48 (144)

Käyttöpaikan perustiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 Mittausalue 3 1..1 Status 3 1..1 Kytketty Katkaistu Rakenteilla Poistettu käytöstä Käyttöpaikan tyyppi 3 1..1 Kulutus Tuotanto Tuotantoyksikön oma käyttö Käyttöpaikan alityyppi 3 1..1 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 Käyttöpaikan osoitteet 3 1..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Koordinaatisto 3 0..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Käyttöpaikan ominaisuudet 3 0..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Ohjattava kuorma 3 0..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Varastolaite 3 0..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Tuotantolaite 3 0..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Asiakkaan tiedot 2 1..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. [2] [1] Tiedot raportoidaan kyselyssä esitylle raportointihetkelle. [2] Palautetaan vain niistä asiakkaista, joilta 3. osapuolella on valtuutus ja jotka on hakuun ilmoitettu. 49 (144)

4 DH-200 MITTAUSTIEDON YLLÄPITOPROSESSIT Kuva 11 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 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 arvopuuttuu tieto. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-211-1 E66 EnergyTimeSeries MittaustiedotMaster data, asiakas DH-211-2 E66 EnergyTimeSeries MittaustiedotMaster data, asiakas DH-211-3 E66 EnergyTimeSeries MittaustiedotMaster data, asiakas Mittausvastuullinen Datahub Datahub Datahub Myyjä 3. osapuoli 50 (144)

Kuva 12 DH-211 - Mittaustiedon ilmoitus Tietokenttä Taso Pakollisuus Kommentti Mittausaikasarja 1 1..9999 Aikasarjan tunnus 2 1..1 Lähettäjäkohtaisesti yksilöivä aikasarjan tunniste Sanoman luontiaika 2 1..1 Raportointiaikaväli 2 1..1 Aika-askel 3 1..1 Alkuaika 3 1..1 Loppuaika 3 1..1 Mittauksen tiedot 2 1..1 Mittausaikasarjan tyyppi 3 1..1 Kulutus Tuotanto Loisenergia anto Loisenergia otto Rajapistesiirto 51 (144)

Yksikkö 3 1..1 Mittauspisteen tyyppi 3 1..1 Rajapiste, kulutus tai tuotanto Mittauspisteen tunnus 3 1..1 Käyttöpaikka, tuotantoyksikkö tai rajapiste. Mittausalueen tunnus 3 0..1 Ei käytetä rajapistemittaukselle. Antoalueen tunnus 3 0..1 Käytetään vain rajapistemittauksille Ottoalueen tunnus 3 0..1 Käytetään vain rajapistemittauksille Aikasarja-arvot 2 1..9999 Positio 3 1..1 Arvot 3 1..1 Arvo 4 0..1 [1] Arvo puuttuu 4 0..1 Kyllä/Ei [1] Status 4 0..1 Epävarma Arvioitu Korjattu OK [2] [1] Esitetään joko arvo tai arvo-puuttuu tieto. [2] Status esitetään, jos muu kuin mitattu. (136=OK) (Puuttuva), ei esitetä, vaan ilmaistaan Arvo puutttuu kentällä. Epävarma Arvioitu Korjattu OK Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. Datahub hylkää sanoman tiedot mittausaikasarjoittain. Tarkemmat validointisäännöt mittaustiedoille on listattu liitteessä Liite A: Mittausaikasarjan validointisäännöt. # 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 52 (144)

4.2 DH-221, DH-222, DH-223 Mittaustiedon haut Mittaustietoja voidaan hakea myyjän, 3. osapuolen tai jakeluverkonhaltijan toimesta. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-221-1 DH-222-1 DH-223-1 F08 RequestMeasuredDataInfo Mittaustiedon hakumaster data, asiakas Myyjä JVH 3. osapuoli Datahub DH-221-2 DH-222-2 DH-223-2 E66 EnergyTimeSeries MittaustiedotMaster data, asiakas Datahub Myyjä JVH 3. osapuoli Kuva 13 DH-220 - Mittaustiedon haku Kyselytapahtumassa annetaan seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Mittaustietopyyntö 1 1..9999 Samalla kyselyllä voidaan hakea useampia käyttöpaikkoja. Mittauspisteen tunnus 2 0..1 [1] Mittausalue 2 0..1 [1] Aika-askel 2 0..1 Pätömittauksen yksikkö 2 0..1 [2] Loismittauksen yksikkö 2 0..1 [2] Pyyntöaikaväli 2 1..1 Alkuaika 3 1..1 53 (144)

Loppuaika 3 1..1 [1] Voidaan hakea joko kaikki mittauspisteet mittausalueen perusteella tai yksittäinen mittauspiste. [2] Pätö- ja loismittaukset voi hakea määritellyssä yksikössä. Jos yksikköä ei anneta haussa, palautetaan mittaukset Datahubiin tallennetussa yksikössä. 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 DH211 (Mittaustiedot). Mittaustiedot toimitetaan vain aikajaksolle, jolle osapuolella on oikeudet tietoihin. 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. 54 (144)

4.3 DH-212 Muistutus mittaustiedon ilmoituksesta Datahub ilmoittaa virheellisistä tai ilmoittamattomista mittaustiedoista jakeluverkonhaltijalle. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-212 F07 RequestMeasuredData MittaustietopyyntöMaster data, asiakas Datahub Mittausvastuullinen Kuva 14 DH-212 - Muistutus mittaustiedon ilmoituksesta Tietokenttä Taso Pakollisuus Kommentti Mittaustietopyyntö 1 1..9999 Mittauspisteen tunnus 2 1..1 Käyttöpaikka, tuotantoyksikkö tai rajapiste. Pyyntöaikaväli 2 1..1 Aikavälinä esitetään ensimmäisen ja viimeisen puuttuvan arvon aikaväli. [1] Alkuaika 3 1..1 Loppuaika 3 1..1 [1] 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. 55 (144)

5 DH-300 SOPIMUSPROSESSIT Kuva 15 Sopimustapahtumat 56 (144)

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. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-311-1 F04 MasterDataContractEvent Master data, sopimusmaster data, asiakas DH-311-2 F04 MasterDataContractEvent Master data, sopimusmaster data, asiakas DH-311-3 F04 MasterDataContractEvent Master data, sopimusmaster data, asiakas DH-311-4 F04 MasterDataContractEvent Master data, sopimusmaster data, asiakas Uusi myyjä Nykyinen myyjä Datahub Datahub Datahub Datahub JVH Nykyinen myyjä Tuotantokäyttöpaikan myyjä [*] 57 (144)

Kuva 16 DH-311 - Ilmoitus uudesta sopimuksesta 5.1.1 DH-311-1 Uuden sopimuksen tiedot Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Uuden sopimuksen tiedot 1 1..1 Voimaantulopäivämäärä 1 1..1 Sopimuksen aloituspäivämäärä Alkuperäisen sanoman tunnus 1 0..1 Käytetään vain välitysanomassa [1] Alkuperäisen sanoman lähettäjä 1 0..1 Käytetään vain välitysanomassa Sopimustiedot 2 1..1 Sopimustunnus 3 1..1 Sopimuksen tyyppi 3 1..1 Myyntisopimus Sähköntoimitussopimus 3 1..1 Kyllä/ei tieto Sopimuksen määräaikaisuus 3 1..1 Kyllä/ei tieto 58 (144)

Määräaikaisuuden päättymispäivä 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] Irtisanomijakso 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 Tuotteen tunnus 4 1..1 Myyntisopimuksen tuotteen tunnus Tuotteen nimi 4 0..1 Myyntisopimuksen tuotteen nimi Asiakkaan tarkenne 3 0..1 Yhteyshenkilö 2 0..n Tyyppi 3 1..1 Edunvalvoja Sopimusvastaava Laskutusvastaava Kytkentävastaava Vikaviestintä Etunimi 3 0..1 Sukunimi 3 0..1 Muu Nimi 3 0..1 Yhteystiedot 3 0..99 Tyyppi 4 1..1 Puhelin Sähköpostiosoite Puhelinumero/ Sähköpostiosoite 4 1...1 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 59 (144)

Postilokero 3 0..1 Postitoimipaikka 3 1..1 Maatunnus 3 1..1 Käytetään ISO 3166 alpha-2 mukaista tunnusta. Verkkolaskuosoite 2 0..1 [3 Kohdiste 3 0..1 Verkkolaskuosoite 3 1..1 Välittäjän tunnus 3 1..1 Muu sähköinen laskutusosoite 2 0..1 [3] Tyyppi 4 1..1 Sähköinen osoite 4 1...1 Käyttöpaikan tiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 Mittausalue 3 1..1 Myyjän tunnus 3 1..1 Asiakkaiden perustiedot 2 1..n Asiakkaan tunnus 3 1..1 Käytetään joko y-tunnusta, yhdistystunnusta, henkilötunnusta tai muu tunnusta. Asiakkaan tunnuksen tyyppi 3 1..1 Y-tunnus Asiakkaan tyyppi 3 1..1 Yritys Salattu tieto 3 1..1 Kyllä/Ei. Yhdistystunnus Henkilötunnus (hetu) Osapuolen oma tunnus Kuluttaja Kielikoodi 3 1..1 Käytetään ISO 639-1 mukaista koodia. Yrityksen nimi 3 0..1 Pakollinen yritysasiakkaille Etunimi 3 0..1 Pakollinen kuluttaja-asiakkaalle Keskimmäiset nimet 3 0..1 Sukunimi 3 0..1 Pakollinen kuluttaja-asiakkaalle Syntymäaika 3 0..1 Pakollinen kuluttaja-asiakkaalle, jos hetua ei ole annettu. VVVV- KK-PP Asiointitapa 3 1..1 Sähköinen Lisätunnus 3 0..1 Yhteystiedot 3 0..99 Muu Tyyppi 4 1..1 Puhelin Sähköpostiosoite Puhelinumero Sähköpostiosoite 4 1...1 Postisoite 3 1..1 [2] Osoitteen tarkenne 4 0..1 c/o 60 (144)

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 Maatunnus 4 1..1 Käytetään ISO 3166 alpha-2 mukaista tunnusta. [1] Datahub välittää myyjältä tulleen alkuperäisen sanoman tunnuksen välityssanoman mukana tässä kentässä. [2] 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] Kuluttajan e-laskuosoitetta ei tuoda Datahubiin. Laskutuskanavaksi voidaan kuitenkin merkitä E-lasku tai Suoramaksu. [6] 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 Käyttöpaikalla olevalla myyntisopimuksella ei ole voimassa poikkeavaa irtisanomisehtoa. Tarkistusta ei tehdä, jos käyttöpaikan asiakkuus muuttuu. 6 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 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 Uuden sopimuksen tiedot 1 1..1 Voimaantulopäivämäärä 1 1..1 61 (144)

Alkuperäisen sanoman tunnus Alkuperäisen sanoman lähettäjä Vaatii uuden verkkosopimuksen 1 1..1 Käytetään vain välitysanomassa [1] 1 1..1 Käytetään vain välitysanomassa 1 1..1 Kyllä/ei tieto Sopimuksen aloituksen syy 1 1..1 Sopimuksen vaihto Myyjän vaihto Sisäänmuutto Sopimustiedot 2 1..1 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 [5] Veroluokka 3 1..1 0,1,2 Asiakkaan tarkenne 3 0..1 Yhteyshenkilö 2 0..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Yhteystiedot 3 0..99 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Laskutusosoite 2 0..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Verkkolaskuosoite 2 0..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Muu sähköinen laskutusosoite 2 0..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Käyttöpaikan tiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 Mittausalue 3 1..1 Myyjän tunnus 3 1..1 Asiakkaiden perustiedot 2 1..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Postisoite 3 1..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. [2] 62 (144)

[1] Datahub välittää myyjältä tulleen alkuperäisen sanoman tunnuksen välityssanoman mukana tässä kentässä. 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. 63 (144)

5.2 DH-312 Verkkosopimuksen vahvistaminen Jakeluverkonhaltija toimittaa verkkosopimuksen vahvistustiedot Datahubiin. Vahvistustiedot Datahub toimittaa käyttöpaikan voimassaolevalle ja uudelle myyjälle. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-312-1 F04 MasterDataContractEvent Master data, sopimusmaster data, asiakas JVH Datahub DH-312-2 F04 MasterDataContractEvent Master data, sopimusmaster data, asiakas Datahub Uusi myyjä Nykyinen myyjä [1] [1] Verkkosopimuksen vahvistustiedot välitetään myyjälle. Kuva 17 DH-312 - Verkkosopimuksen vahvistaminen Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Sopimustiedot 1 1..1 Voimaantulopäivämäärä 1 1..1 Alkuperäisen sanoman tunnus 1 1..1 Käytetään vain välitysanomassa Alkuperäisen sanoman lähettäjä 1 0..1 Käytetään vain välitysanomassa 64 (144)

Verkkosopimuksen hyväksyminen 1 1..1 Kyllä/ei [1] Selite 1 0..1 Selite sopmuksen hylkäämiselle Sopimustiedot 2 0.1 Sopimustunnus 3 1..1 Sopimuksen tyyppi 3 1..1 Verkkosopimus Sopimuksen aloituspäivämäärä 3 1..1 Laskutuskanava 3 1..1 Paperilasku Verkkolasku E-lasku Sähköposti Netposti Suoramaksu Veroluokka 3 1..1 0,1,2 Tuotetieto 3 0..n Mobiililasku Tuotteen tunnus 4 1..1 Verkkosopimuksen tuotteen tunnus Tuotteen nimi 4 0..1 Verkkosopimuksen tuotteen nimi Yhteyshenkilö 2 0..n Tyyppi 3 1..1 Edunvalvoja Etunimi 3 0..1 Sukunimi 3 0..1 Muu Nimi 3 0..1 Yhteystiedot 3 0..99 Sopimusvastaava Laskutusvastaava Kytkentävastaava Vikaviestintä Tyyppi 4 1..1 Puhelin Sähköpostiosoite Puhelinumero/ Sähköpostiosoite 4 1...1 Laskutusosoite 2 0..1 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 Maatunnus 3 1..1 Käytetään ISO 3166 alpha-2 mukaista tunnusta. Verkkolaskuosoite 2 0..1 65 (144)

Kohdiste 3 0..1 Verkkolaskuosoite 3 1..1 Välittäjän tunnus 3 1..1 Muu sähköinen laskutusosoite 2 0..1 Tyyppi 3 1..1 Sähköinen osoite 3 1...1 Käyttöpaikan tiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 Mittausalue 3 1..1 [1] 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. 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 66 (144)

5.3 DH-321 Myyntisopimuksen tietojen päivitys Myyntisopimustietojen päivitykset tehdään myyjän toimesta Datahubiin. Datahub välittää päivitetyt sopimustiedot jakeluverkonhaltijalle. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-321-1 F04 MasterDataContractEvent Master data, sopimusmaster data, asiakas Nykyinen myyjä Datahub DH-321-2 F04 MasterDataContractEvent Master data, sopimusmaster data, asiakas Datahub JVH [1] [1] Myyntisopimuksen muuttuneet tiedot välitetään jakeluverkonhaltijalle. Kuva 18 DH-321 - Myyntisopimuksen tietojen päivitys Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Sopimuksen tiedot 1 1..1 67 (144)

Voimaantulopäivämäärä 1 1..1 Alkuperäisen sanoman tunnus Alkuperäisen sanoman lähettäjä 1 0..1 Käytetään vain välitysanomassa 1 0..1 Käytetään vain välitysanomassa Sopimustiedot 2 1..1 Sopimustunnus 3 1..1 Sopimuksen tyyppi 3 1..1 Myyntisopimus Sopimuksen määräaikaisuus Määräaikaisuuden päättymispäivä 3 1..1 Kyllä/ei tieto 3 0..1 Laskutustapa 3 1..1 Erillislaskutus, Poikkeava irtisanomisehto 3 1..1 Kyllä/ei tieto Verkko laskuttaa molemmat Myyjä laskuttaa molemmat Irtisanomisaika 3 0..1 Poikkeava irtisanomisaika päivinä Irtisanomijakso 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 Asiakkaan tarkenne 3 0..1 Mobiililasku Yhteyshenkilö 2 0..n Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Yhteystiedot 3 0..99 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa Laskutusosoite 2 0..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa Verkkolaskuosoite 2 0..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa Muu sähköinen laskutusosoite 2 0..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa Käyttöpaikan tiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 Päivitystapahtumassa toimitetaan kaikki tapahtuman tiedot, ei vain muuttuneita tietoja. Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. 68 (144)

# 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. 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. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-322-1 F04 MasterDataContractEvent Master data, sopimusmaster data, asiakas JVH Datahub DH-322-2 F04 MasterDataContractEvent Master data, sopimusmaster data, asiakas Datahub Nykyinen myyjä [1] [1] Verkkosopimuksen muuttuneet tiedot välitetään myyjälle. 69 (144)

Kuva 19 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ä 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ää. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-323 F05 NotifyMPInfo Myyjätön käyttöpaikkamaster data, asiakas Datahub JVH 70 (144)

Kuva 20 DH-323 - Ilmoitus myyjättömistä käyttöpaikoista Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Käyttöpaikkatiedot 1 1..n Käyttöpaikan tunnus 2 1..1 Mittausalue 2 1..1 Sopimukseton aika 2 1..1 Alkuaika 3 1..1 Loppuaika 3 0..1 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. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-331-1 F06 MasterDataContractClose Master data, sopimuksen päättäminenmaster data, asiakas Nykyinen myyjä Datahub DH-331-2 F06 MasterDataContractClose Master data, sopimuksen päättäminen Datahub JVH [1] DH-331-3 F06 MasterDataContractClose Master data, sopimuksen päättäminen Datahub Tuotantokäyttöpaikan myyjä [2] [1] Ilmoitus myyntisopimuksen päättymisestä välitetään jakeluverkonhaltijalle. [2] 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. 71 (144)

Kuva 21 DH-331 Ilmoitus myyntisopimuksen päättymisestä Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Sopimustiedot 1 1..1 Päättymispäivämäärä 1 1..1 Alkuperäisen sanoman tunnus 1 0..1 Käytetään vain välitysanomassa [1] Alkuperäisen sanoman lähettäjä 1 0..1 Käytetään vain välitysanomassa [1] Syy 1 0.1 Ulosmuutto Sopimustiedot 2 1..1 Irtisanominen Purkaminen Sopimustunnus 3 0..1 Pakollinen alkuperäisessä sanomassa, ei välitetä välityssanomassa. Sopimuksen tyyppi 3 0..1 Pakollinen alkuperäisessä sanomassa, ei välitetä välityssanomassa. Laskutusosoite 2 0..1 [3] [2] 72 (144)

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 Maatunnus 3 1..1 Käytetään ISO 3166 alpha-2 mukaista tunnusta. Käyttöpaikan tiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 [1] Datahub välittää myyjältä tulleen alkuperäisen sanoman tunnuksen välityssanoman mukana tässä kentässä. [2] Sopimuksen peruutukset (asiakkaan tai myyjän peruutus) tehdään sopimuksen peruutussanomalla. Peruutusanomassa esitetään perumisen syy sekä tieto, onko peruminen tehty asiakkaan toimesta. [3] 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. 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 jakeluvarkonhaltijalle. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-332-1 F06 MasterDataContractClose Master data, sopimuksen päättäminenmaster data, asiakas Uusi myyjä Datahub DH-332-2 F06 MasterDataContractClose Master data, sopimuksen päättäminen Datahub JVH [1] [1] Ilmoitus ulosmuutosta välitetään jakeluverkonhaltijalle. 73 (144)

Kuva 22 DH-332 - Sisäänmuuttokohteen myyjän ilmoitus asiakkaan ulosmuutosta Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Sopimustiedot 1 1..1 Päättymispäivämäärä 1 1..1 Ulosmuuttopäivämäärä Alkuperäisen sanoman tunnus 1 0..1 Käytetään vain välitysanomassa [1] Alkuperäisen sanoman lähettäjä 1 0..1 Käytetään vain välitysanomassa [1] Syy 1 1.1 Ulosmuutto Käyttöpaikan tiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 Asiakkaiden perustiedot 2 1..n Asiakkaan tunnus 3 0..1 Käytetään joko y-tunnusta, yhdistystunnusta, hetua tai muu tunnusta. Asiakkaan tunnuksen tyyppi 3 1..1 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] 74 (144)

[1] Datahub välittää myyjältä tulleen alkuperäisen sanoman tunnuksen välityssanoman mukana tässä kentässä. [2] Kenttiä käytetään asiakkaan yksilöintiin, jos asiastunnusta (hetua) ei ole esitetty sanomassa. Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Osoitteissa postitoimipaikka on oikea postinumeron perusteella. Tarkistus tehdään vain suomalaiselle osoitteelle. 2 Asiakkaalla on voimassaoleva myynti- ja verkkosopimus järjestelmässä käyttöpaikalla. 3 Päättymispäivämäärä on liiketoimintaprosessien määritysten mukainen. 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. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-333-1 F06 MasterDataContractClose Master data, sopimuksen päättäminenmaster data, asiakas JVH Datahub DH-333-2 F06 MasterDataContractClose Master data, sopimuksen päättäminen Datahub Nykyinen myyjä [1] [1] Ilmoitus verkkosopimuksen päättymisestä välitetään nykyiselle myyjälle. 75 (144)

Kuva 23 DH-333 - Ilmoitus verkkosopimuksen päättymisestä Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Sopimustiedot 1 1..1 Päättymispäivämäärä 1 1..1 Alkuperäisen sanoman tunnus 1 0..1 Käytetään vain välitysanomassa [1] Alkuperäisen sanoman lähettäjä 1 0..1 Käytetään vain välitysanomassa [1] Syy 1 1.1 Ulosmuutto Irtisanominen Purkaminen Sopimustiedot 2 1..1 Sopimustunnus 3 1..1 Sopimuksen tyyppi 3 1..1 Verkkosopimus Laskutusosoite 2 0..1 [2] [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 76 (144)

Postinumero 3 1..1 Postilokero 3 0..1 Postitoimipaikka 3 1..1 Maatunnus 3 1..1 Käytetään ISO 3166 alpha-2 mukaista tunnusta. Käyttöpaikan tiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 [1] Datahub välittää verkkoyhtiöltä tulleen alkuperäisen sanoman tunnuksen välityssanoman mukana tässä kentässä. [2] Osoitetiedossa tulee postinumeron lisäksi esittää joko kadun nimi tai postilokero. [3] Laskutusosoitteena annetaan asiakkaan uusi osoite, esimerkiksi osoite johon loppulasku toimitetaan. Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Voimassaoleva verkkosopimus löytyy järjestelmästä. 3 Päättymispäivämäärä on liiketoimintaprosessien määritysten mukainen. 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. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-341-1 F18 MasterDataContractCancel Master data, sopimuksen peruminenmaster data, asiakas Nykyinen myyjä Uusi myyjä Datahub DH-341-2 F18 MasterDataContractCancel Master data, sopimuksen peruminenmaster data, asiakas Datahub JVH [1] DH-341-3 F18 MasterDataContractCancel Master data, sopimuksen peruminenmaster data, asiakas Datahub Edellinen myyjä Nykyinen myyjä [2] [1] Ilmoitus myyntisopimuksen peruuttamisesta välitetään jakeluverkonhaltijalle. [2] Ilmoitus myyntisopimuksen peruuttamisesta välitetään edeltävälle myyjälle. 77 (144)

Kuva 24 DH-341 - Ilmoitus myyntisopimuksen peruuntumisesta Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Sopimustiedot 1 1..1 Voimaantulopäivämäärä 1 1..1 Peruutettavan sopimuksen aloituspäivämäärä. Alkuperäisen sanoman tunnus 1 0..1 Käytetään vain välitysanomassa Alkuperäisen sanoman lähettäjä 1 0..1 Käytetään vain välitysanomassa Perumisen syy 1 1..1 Asiakas peruuttanut sopimuksen Myyjä peruuttanut sopimuksen Selite 1 0..1 Sopimustiedot 2 1..1 Sopimustunnus 3 1..1 Edeltävälle/nykyiselle myyjälle välitetään palautettavan sopimuksen sopimustunnus Käyttöpaikan tiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 78 (144)

5.9.2 DH-342 Ilmoitus verkkosopimuksen peruuttamisesta Jakeluverkonhaltija ilmoittaa verkkosopimuksen peruttamisesta Datahubiin. Datahub välittää tiedon nykyiselle myyjälle. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-342-1 F18 MasterDataContractCancel Master data, sopimuksen peruminenmaster data, asiakas JVH Datahub DH-342-2 F18 MasterDataContractCancel Master data, sopimuksen peruminenmaster data, asiakas Datahub Nykyinen myyjä Uusi myyjä [1] [1] Ilmoitus myyntisopimusksen peruuttamisesta välitetään uudelle tai nykyiselle myyjälle. Sille myyjälle, jolle alkuperäinen vahvistus on toimitettu. Kuva 25 DH-342 - Ilmoitus verkkosopimuksen peruuttamisesta Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Sopimustiedot 1 1..1 Voimaantulopäivämäärä 1 1..1 Peruutettavan sopimuksen aloituspäivämäärä. Alkuperäisen sanoman tunnus 1 0..1 Käytetään vain välitysanomassa 79 (144)

Alkuperäisen sanoman lähettäjä 1 0..1 Käytetään vain välitysanomassa Selite 1 0..1 Sopimustiedot 2 1..1 Sopimustunnus 3 1..1 Käyttöpaikan tiedot 2 1..1 Käyttöpaikan tunnus 3 1..1 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. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-343-1 F06 MasterDataContractClose Master data, sopimuksen päättäminenmaster data, asiakas Nykyinen myyjä Datahub DH-343-2 F06 MasterDataContractClose Master data, sopimuksen päättäminen Datahub JVH [1] [1] Ilmoitus myyntisopimuksen päättymisestä välitetään jakeluverkonhaltijalle. 80 (144)

Kuva 26 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. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-344-1 F06 MasterDataContractClose Master data, sopimuksen päättäminenmaster data, asiakas JVH Datahub DH-344-2 F06 MasterDataContractClose Master data, sopimuksen päättäminen Datahub Uusi myyjä [1] [1] Ilmoitus verkkosopimuksen päättymisestä välitetään uudelle myyjälle, joka on peruuttanut myyntisopimuksen. 81 (144)

Kuva 27 DH-344 - Ilmoitus verkkosopimuksen päättymisestä peruutustilanteessa 82 (144)

6 DH-400 KYTKENTÄ- JA KATKAISUPROSESSIT Kuva 28 Kytkentä- ja katkaisutapahtumat 6.1 DH-411 Toimituksen kytkentäpyyntö Myyjä välittää kytkentäpyyntötapahtuman Datahubiin. Datahub välittää pyynnön jakeluverkonhaltijalle. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-411-1 F09 RequestPowerSwitch Kytkentä-katkoMaster data, asiakas Myyjä Datahub DH-411-2 F09 RequestPowerSwitch Kytkentä-katko Datahub JVH [1] [1] Kytkentäpyyntö välitetään jakeluverkonhaltijalle. 83 (144)

Kuva 29 DH-411 - Toimituksen kytkentäpyyntö Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Kytkentäkatko 1 1..1 Kytkentäpäivämäärä 2 1..1 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 Käyttöpaikan tunnus 2 1..1 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 on Katkaistu. 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. 84 (144)

Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-412-1 F09 ResponsePowerSwitch Kytkentä-katkoMaster data, asiakas JVH Datahub DH-412-2 F09 ResponsePowerSwitch Kytkentä-katko Datahub Myyjä [1] [1] Kytkentäilmoitus välitetään myyjälle. Kuva 30 DH-412 - Ilmoitus toimituksen kytkennästä Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Kytkentäkatko 1 1..1 Kytkentähetki 2 1..1 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 Käyttöpaikan tunnus 2 1..1 Kytkentätila 2 1..1 Kytketty 85 (144)

Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Käyttöpaikka on jakeluverkon mittausalueella. 3 Käyttöpaikka löytyy järjestelmästä ja sen tila on Katkaistu. 6.3 DH-421 Toimituksen katkaisupyyntö Myyjä välittää katkaisupyyntötapahtuman Datahubiin. Datahub välittää pyynnön jakeluverkonhaltijalle. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-421-1 F09 RequestPowerSwitch Kytkentä-katkoMaster data, asiakas Myyjä Datahub DH-421-2 F09 RequestPowerSwitch Kytkentä-katko Datahub JVH [1] [1] Katkaisupyyntö välitetään jakeluverkonhaltijalle. Kuva 31 DH-421 - Toimituksen katkaisupyyntö Sanoman tapahtumatiedot sisältävät seuraavat tiedot: 86 (144)

Tietokenttä Taso Pakollisuus Kommentti 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 Alkuperäisen sanoman lähettäjä 2 0..1 Käytetään vain välitysanomassa Käyttöpaikan tunnus 2 1..1 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 on Kytketty. 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.. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-422-1 F09 ResponsePowerSwitch Kytkentä-katkoMaster data, asiakas JVH Datahub DH-422-2 F09 ResponsePowerSwitch Kytkentä-katko Datahub Myyjä [1] [1] Katkaisuilmoitus välitetään myyjälle. 87 (144)

Kuva 32 DH-422 - Ilmoitus toimituksen katkaisusta Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Kytkentäkatko 1 1..1 Katkaisuhetki 2 1..1 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 Käyttöpaikan tunnus 2 1..1 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 on Kytketty 88 (144)

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. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-413-1 DH-423-1 F09 ResponsePowerSwitch Kytkentä-katkoMaster data, asiakas JVH Datahub DH-413-2 DH-423-2 F09 ResponsePowerSwitch Kytkentä-katko Datahub Myyjä [1] [1] Ilmoitus viivästymisestä välitetään myyjälle. Kuva 33 DH-413 - Ilmoitus kytkennän viivästymisestä Sanoman tapahtumatiedot sisältävät seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Kytkentäkatko 1 1..1 Aikaisintaan 2 1..1 Aikaisin hetki kytkennälle/katkaisulle Alkuperäisen sanoman tunnus 2 0..1 Käytetään vain välitysanomassa Alkuperäisen sanoman lähettäjä 1 0..1 Käytetään vain välitysanomassa 89 (144)

Käyttöpaikan tunnus 2 1..1 Pyydetty kytkentätila 2 1..1 Ilmoitetaan se tila, jota myyjä on pyytänyt. Selite 1 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 ja käyttöpaikan tila on vastakkainen (Kytketty vs Katkaistu ) 90 (144)

7 DH-500 TASESELVITYS Kuva 34 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. 7.1 DH-514, DH-522, DH-523 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. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-514 E31 EnergyTimeSeries TaseselvitystiedotMaster data, asiakas Datahub JVH DH-522-1 F10 RequestSettlementDataInfo Taseselvitystiedon haku JVH Datahub DH-522-2 E31 EnergyTimeSeries Taseselvitystiedot Datahub JVH DH-523-1 F10 RequestMeasuredDataInfo Mittaustiedon hakumaster data, asiakas JVH Datahub [1] 91 (144)

DH-523-2 E31 EnergyTimeSeries MittaustiedotMaster data, asiakas Datahub JVH [1] [1] Häviötietoja haetaan mittaustietojen haun kautta mittausaluekohtaisesti. Kuva 35 DH-514 - Taseselvitystietojen ilmoitus jakeluverkonhaltijalle Kuva 36 DH-522 - Taseselvitystietojen haku - JVH 92 (144)

Kuva 37 DH-523 - Häviöihin kirjattujen kulutusten ja tuotantojen haku Kyselytapahtumassa annetaan seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti 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 [1].Jos myyjän tunnusta ei anneta, palautetaan mittausalueen kokonaissummat Taseselvitystiedoissa ja vastaustapahtumassa palautetaan seuraavat aikasarjatiedot Tietokenttä Taso Pakollisuus Kommentti Summasaikasarja 1 1..9999 Aikasarjan tunnus 2 1..1 Sanoman luontiaika 2 1..1 Raportointiaikaväli 1..1 93 (144)

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 Kulutus Tuotanto Rajapiste Taseselvitystapa 3 1..1 Profiilitaseselvitys Tuntitaseselvitys Laskentatyyppi 3 1..1 Kts. lisäkommentti [1] Myyjän tunnus 3 0..1 Mittausalueen tunnus 3 1..1 Ottoalueen tunnus 3 0..1 Antoalueen tunnus 3 0..1 Aikasarja-arvot 2 1..9999 Positio 3 1..1 Arvot 3 1..1 Arvo 4 1..1 Status 4 1..1 [1] 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 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. 94 (144)

# Tapahtumavalidointi 1 Mittausalue kuuluu jakeluverkonhaltijalle 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. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-515 E31 EnergyTimeSeries TaseselvitystiedotMaster data, asiakas Datahub Myyjä DH-521-1 F10 RequestSettlementDataInfo Taseselvitystiedon haku Myyjä Datahub DH-521-2 E31 EnergyTimeSeries Taseselvitystiedot Datahub Myyjä [1] Kuva 38 DH-515 - Taseselvitystietojen ilmoitus myyjälle 95 (144)

Kuva 39 DH-521 - Taseselvitystietojen haku - myyjä Kyselytapahtumassa annetaan seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti 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 Summa-aikasarja 1 1..9999 Aikasarjan tunnus 2 1..1 Sanoman luontiaika 2 1..1 Raportointiaikaväli 1..1 Aika-askel 3 1..1 Alkuaika 3 1..1 Loppuaika 3 1..1 96 (144)

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 Kulutus Tuotanto Taseselvitystapa 3 1..1 Profiilitaseselvitys Tuntitaseselvitys Laskentatyyppi 3 1..1 Kts. lisäkommentti [1] Myyjän tunnus 3 1..1 Mittausalue 3 1..1 Aikasarja-arvot 2 1..9999 Positio 3 1..1 Arvot 3 1..1 Arvo 4 1..1 Status 4 1..1 [1] 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 97 (144)

8 DH-600 TASEVIRHEIDEN KORJAUS Kuva 40 Tasevirhetapahtumat Datahub välittää tasevirhelaskennan tulokset myyjille ja jakeluverkonhaltijoille. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-611 F16 BalanceCorrectionData TasevirhetiedotMaster data, asiakas DH-612 F16 BalanceCorrectionData TasevirhetiedotMaster data, asiakas Datahub Datahub Myyjä JVH Kuva 41 DH-611 - Tasevirhetietojen ilmoitus myyjälle 98 (144)

Kuva 42 DH-612 - Tasevirhetietojen ilmoitus jakeluverkonhaltijalle Tasevirhetiedoissa palautetaan seuraavat tiedot Tietokenttä Taso Pakollisuus Kommentti Tasevirhetiedot 1 1..9999 Mittausalueen tunnus 2 1..1 Myyjä 2 1..1 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 Häviö Käyttöpaikka 3 0.1 Käytetään vain käyttöpaikkakohtaisille sarjoille. Tuntiarvot 3 1..9999 Positio 4 1..1 Mitattu energia 4 1..1 kwh Taseeseen viety energia 4 1..1 kwh Tasevirhe 4 1..1 kwh Hintatiedot 2 1..9999 Positio 3 1..1 SPOT-hinta 3 1..1 EUR/MWh Korjaus yhteensä 3 1..1 EUR Korjattava energia yhteensä 3 1..1 kwh 99 (144)

9 DH-700 TUOTE- JA LASKUTUSTIEDON YLLÄPITOPROSESSIT Kuva 43 Tuote- ja laskurivitapahtumat 9.1 DH-711, DH-712 Tuotetietojen päivitys Tuotetietojen päivitystapahtumalla jakeluverkonhaltija ja myyjä ylläpitävät sopimustuotteidensa tiedot Datahubissa. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-711 F11 MasterDataProductEvent Master data, tuotemaster data, asiakas DH-712 F11 MasterDataProductEvent Master data, tuotemaster data, asiakas Myyjä JVH Datahub Datahub 100 (144)

Kuva 44 DH-710 - Tuotetiedon päivitys Päivitystapahtuma sisältää seuraavat tiedot. Tietokenttä Taso Pakollisuus Kommentti Tuotetiedot 1 1..n Tuotteen voimassaoloaika 2 0..1 Alkuaika 3 1..1 Loppuaika 3 0..1 Tuotteen tunnus 2 1..1 Tuotteen nimi 2 1..1 Tuotteen omistaja 2 1..1 Myyjä tai jakeluverkonhaltija Tuotekomponentit 2 1..n Tuotekomponentin tunnus 3 1..1 Tuotekomponentin nimi 3 1..1 Kalenteriaikasarja 3 0..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. Hintatiedot 3 Hinnan yksikkö 4 1..1 Käytetään myös hinta-aikasarjan yksikkönä. Hinta 4 0..1 [1] Hinnan voimassaoloaika 4 0..1 [1] Alkuaika 5 1..1 101 (144)

Loppuaika 5 0..1 Hinta-aikasarja 4 0..1 Yksittäiset kentät kuvattu teknisessä tapahtumakuvauksessa. [2] [1] 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. 102 (144)

9.2 DH-721, DH-722, DH-723 Tuotetietojen haku Tuotetietojen haulla osapuolet (jakeluverkonhaltija, myyjä 3.osapuoli) hakevat toisen osapuolen tuotetietoja Datahubista. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-721-1 DH-722-1 DH-723-1 F12 RequestProductDataInfo Tuotetietojen hakumaster data, asiakas Myyjä JVH 3. osapuoli Datahub DH-721-2 DH-722-2 DH-723-2 F11 MasterDataProductEvent Master data, tuotemaster data, asiakas Datahub Myyjä JVH 3. osapuoli Kuva 45 DH-720 - Tuotetiedon haku Kyselytapahtumassa annetaan seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Tuotehaku 1 1..1 Tuotteen omistaja 2 0..n Myyjä tai jakeluverkonhaltija Tuotehaussa palautetaan hakuhetkellä voimassaolevat ja tulevaisuudessa voimaan tulevat tuotteet. Palautettavat tiedot ovat samat kuin tuotetietojen päivityksessä (DH-711, DH-712). 103 (144)

9.3 DH-731, DH-732 Laskurivitietojen ilmoitus Jakeluverkonhaltija ja myyjä voivat ilmoittaa laskurivitiedot Datahubiin laskutustietotapahtumilla. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-731-1 F13 BillingDataInfo LaskutustiedotMaster data, asiakas Myyjä Datahub DH-731-2 F13 BillingDataInfo Laskutustiedot Datahub JVH DH-731-3 F13 BillingDataInfo Laskutustiedot Datahub 3.osapuoli DH-732-1 F13 BillingDataInfo Laskutustiedot JVH Datahub DH-732-2 F13 BillingDataInfo Laskutustiedot Datahub Myyjä DH-732-3 F13 BillingDataInfo Laskutustiedot Datahub 3.osapuoli [*] Laskurivitiedot välitetään osapuolille, joilla on valtuutus laskurivitietoihin lähettävän osapuolen osalta. Kuva 46 DH-730 - Laskurivitietojen ilmoitus Laskurivitietojen ilmoitustapahtuma sisältää seuraavat tiedot. 104 (144)

Tietokenttä Taso Pakollisuus Kommentti Laskurivitiedot 1 1..1 Käyttöpaikan tunnus 2 1..1 Sopimuksen tunnus 2 1..1 Osapuolen tunnus 2 1..1 Laskutusaikaväli 2 1..1 Alkuaika 3 1..1 Loppuaika 3 1..1 Laskurivit 3 1..n Tuotteen tunnus 4 1..1 Tuotteen nimi 4 1..1 Tuotekomponentin tunnus 4 1..1 Tuotekomponentin nimi 4 1..1 Hinta 4 1..1 0.0489 [1] Hinnan yksikkö 4 1..1 Valuutta 4 1..1 EUR Hinnan verollisuus 4 1..1 Kyllä/Ei Määrä 4 1..1 100 Määrän yksikkö 4 1..1 kwh Laskurivin summa 4 1..1 4.89 [1] Selite 4 0..1 ALV-prosentti 4 1..1 24.00 [1] Hinnan yksikkö on valuutta/määrän yksikkö. Esim EUR/kWh Summan yksikkö on valuutta. Esim EUR. 9.4 DH-741, DH-742, DH-743 Laskurivitietojen haku Laskurivitietojen haulla osapuolet (jakeluverkonhaltija, myyjä 3.osapuoli) hakevat toisen osapuolen toimittamia laskurivitietoja Datahubista. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-741-1 DH-742-1 DH-743-1 F14 RequestBillingtDataInfo Laskurivitietojen hakumaster data, asiakas Myyjä JVH 3. osapuoli Datahub DH-741-2 DH-742-2 DH-743-2 F13 BillingDataInfo LaskutustiedotMaster data, asiakas Datahub Myyjä JVH 3. osapuoli 105 (144)

Kuva 47 DH-740 Laskurivitietojen haku Kyselytapahtumassa annetaan seuraavat tiedot: Tietokenttä Taso Pakollisuus Kommentti Laskutustietojen haku 1 1..n Laskutusaikaväli 2 1..1 [1] Alkuaika 3 1..1 Loppuaika 3 1..1 Osapuolen tunnus 2 0..1 [2] Käyttöpaikan tunnus 2 0..1 [2] Sopimustunnus 3 0..1 [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). 106 (144)

10 DH-800 VALTUUTUKSET Kuva 48 Valtuutustapahtumat 10.1 DH-811, DH-812, DH-813 Asiakkaan valtuutuksen Ilmoitus Myyjä, jakeluverkonhaltija ja 3. osapuoli ilmoittavat asiakkaalta saadun valtuutuksen Datahubiin. Valtuutustietojen kyselyt ja mahdolliset poistot tehdään online palvelun kautta. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-811 F15 AuthorizationEvent ValtuutustiedotMaster data, asiakas Myyjä Datahub DH-812 F15 AuthorizationEvent Valtuutustiedot JVH Datahub DH-812 F15 AuthorizationEvent Valtuutustiedot 3. osapuoli Datahub Kuva 49 DH-810 Asiakkaan valtuutuksen ilmoitus 107 (144)

Tietokenttä Taso Pakollisuus Kommentti Valtuutus 1 1..n 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 3 1..n Asiakkaan tunnus 4 1..1 Tapahtumatiedoille tehdään seuraavat tapahtumavalidoinnit. # Tapahtumavalidointi 1 Valtuutuksen tehneellä asiakkaalla tulee olla voimassa oleva myynti- tai verkkosopimus käyttöpaikalle valtuutusajalle. 108 (144)

11 DH-900 OSAPUOLITIEDOT Kuva 50 Osapuolitapahtumat 11.1 DH910 Osapuolitiedot Osapuolittiedot ylläpidetään online-palvelun kautta. Datahub välittää uudet ja muuttuneet tiedot jakeluverkonhaltijoille, myyjille ja 3. osapuolille. Prosessi Sanoma Tapahtuma Tapahtumakuvaus Lähettäjä Vastaanottaja [*] DH-911 F16 PartyInfo OsapuolitiedotMaster data, asiakas Datahub Myyjä DH-912 F16 PartyInfo Osapuolitiedot Datahub JVH DH-913 F16 PartyInfo Osapuolitiedot Datahub 3. osapuoli 109 (144)