2 (9) Sisällysluettelo 1 Johdanto... 3 1.1 Poikkeamat markkinadokumentaatio v1.7:n ja skeemakuvausten välillä... 4 2 Datahub-toteutuksen osavaiheen 1 julkaisutiedot... 5 2.1 Julkaisun toiminnallisuudet... 5 2.2 Poikkeamat... 6 2.3 Avoimet viat julkaisussa... 9
3 (9) 1 Johdanto Tässä dokumentissa kuvataan Fingrid Datahub v0.1 version (osavaihe 1, julkaisu 1) julkaisutiedot 1. Luvussa 2 kuvataan julkaisussa toteutetut toiminnot ja tunnetut poikkeamat ja viat. Poikkeama edustaa toiminnallisuutta, joka on osa toimituksen suunniteltua laajuutta, mutta ei ole vielä toimitettu tulevissa julkaisuissa toimitettaviksi suunniteltujen komponenttien tai toimintojen riippuvuudesta johtuen. Vika ( bugi tai tunnettu virhe) määrittelee osan ohjelmistosta, joka ei toimi kuten suunnittelussa on kuvattu. Viat löytyvät osana järjestelmän testausta tai osana myöhempiä testivaiheita. Näissä tapauksissa tarvitaan ohjelmistopäivitys ja se suunnitellaan vianhallintasuunnitelman mukaisesti. Datahub-järjestelmän toteuttamien datahub-tapahtumien (markkinaprosessitapahtumien) kuvaukset löytyvät Ediel.fi-portaalissa (linkki) julkaistussa asiakirjassa Datahub tapahtumat. Näissä julkaisutiedoissa esitettyjä poikkeamia ja vikoja lukuun ottamatta kaikki toteutetut ominaisuudet (markkinaprosessit) noudattavat seuraavia Ediel.fi-portaalissa julkaistuja määritysdokumentteja: Sähkön vähittäismarkkinoiden liiketoimintaprosessit datahubissa v1.7 Datahub tapahtumat versio 1.7 Datahub datastandardi (data standard) 1.7. Julkaisu sisältää B2B-sanomarajapinnan (SOAP) ja web-selaimessa toimivan käyttöliittymän (GUI). Yleisesti ottaen markkinaprosesseja käytetään pääasiassa B2B-rajapinnan kautta, mutta rakenteellisten tietojen markkinaprosessit voidaan suorittaa myös käyttöliittymän kautta. Osana järjestelmän testausta käyttöliittymässä voidaan tarkistaa ja tarkastella B2B-rajapinnan avulla suoritetun markkinaprosessin yksityiskohtia. Huomaa, että tässä julkaisussa on käyttöliittymässä rajoituksia markkinaprosesseille ja käyttöliittymänäkymien suunnittelu ei ole lopullinen. Tämä tarkoittaa, että kaikkia toteutettujen markkinaprosessien osia ei voida tarkistaa käyttöliittymässä tässä julkaisussa. Huomioitavaa on myös, että käyttöliittymässä näkyviä versionumeroita 1.0 CMS2.0 käytetään vain datahubin toteutusprojektissa. CMS2.0 viittaa datahubin toteuttavan CMS-tuotteen versioon. 1 Datahubin toteutussuunnitelman kokonaisaikataulu on kuvattu 15.2.2019 pidetyn datahub-webinaarin Powerpoint-kalvosarjan kalvolla 10 (saatavilla Ediel.fi-portaalissa webinaaritallenteiden osiosta).
4 (9) 1.1 Poikkeamat markkinadokumentaatio v1.7:n ja skeemakuvausten välillä Seuraavat Datahub tapahtumat 1.7 -versioissa esitetyt muutokset eivät ole vielä käytössä julkaistuissa sanomaskeemoissa eikä julkaistussa järjestelmäversiossa: Käyttöpaikan tyyppi attribuutin tiedoista arvo AG03= Tuotantoyksikön omakäyttö siirretään kulutuskäyttöpaikan alityypiksi. Käyttöpaikalla oleva attribuutti Kiinteistökäyttöpaikka muutetaan Käyttöpaikan alityypiksi, jolla on arvot AQ01= Normaali, AQ02= Kiinteistökäyttöpaikka sekä AQ03= Tuotantoyksikön omakäyttö. Käyttöpaikan ominaisuuksiin on lisätty uusi attribuutti Mittauksen aika-askel mitä ei vielä ole julkaistussa skeemassa. Lisäys on osa varttitaseen tarvitsemia muutoksia. Tällä ilmoitetaan datahubille, onko käyttöpaikalta saatavissa mitattua tuntitason tietoa vai varttitietoa. Sanomasta F04 Rakenteelliset tiedot, sopimus on poistettu tietokenttä Sopimuksen aloituspäivämäärä. Sanoman skeema kuitenkin vaatii tietokentän mukaisen elementin <ContractStart> olemassaolon eli se on pakollinen. Elementin voi täyttää vapaa valintaisella aikaleimalla, koska arvoa ei käytetä mihinkään, vaikka elementti onkin pakollinen. Vaikka jotkin järjestelmätoiminnot poikkeavat markkinadokumentaatiosta, XML-skeema 1.7 on todellisen toteutuksen mukainen. Jos epäilet, noudata skeemoissa määritettyjä tietoja. Kaaviot ja B2B-rajapinnan määrittely löytyvät myös Ediel.fi-portaalista (linkki).
5 (9) 2 Datahub-toteutuksen osavaiheen 1 julkaisutiedot 2.1 Julkaisun toiminnallisuudet Julkaisun toiminnallisuudet DH-120 Käyttöpaikkatiedon ylläpito DH-121 Käyttöpaikan luonti DH-122 Käyttöpaikkatietojen päivitys (jakeluverkonhaltija) DH-123 Käyttöpaikan poisto DH-124 Käyttöpaikkatietojen päivityspyyntö (myyjä) DH-310 Sopimusten luonti DH-311 Ilmoitus uudesta sopimuksesta DH-312 Verkkosopimuksen vahvistaminen DH-410 Kytkentä Sähköposti DH-411 Toimituksen kytkentäpyyntö (myyjä) DH-412 Ilmoitus toimituksen kytkennästä (jakeluverkonhaltija) DH-413 Ilmoitus kytkennän viivästymisestä Sähköpostirajapinta B2B-Sanomarajapinta B2B-Sanomarajapinta Kirjautumisen hallinta (ei osa osavaiheen 1 testausta) Sisäänkirjautuminen Vaihda salasana Salasana unohtunut Päivitä käyttäjätiedot Dashboard (Valikkonäkymä) Julkaisu sisältää toiminnon, jolla käyttäjä voi vahvistaa käyttäjätunnuksen ja asettaa salasanan sähköpostilla. Järjestelmän Web Service (SOAP) -rajapinta markkinaprosessien käyttöön. Dashboard näkyy valikossa, mutta itse toiminnallisuus ei ole käytössä.
6 (9) 2.2 Poikkeamat Yhteenveto DH-121 Käyttöpaikan luonti Käyttöpaikan luonnissa (DH-121) asetetut aikarajat poikkeavat Datahub tapahtumat v1.7 määrityksistä. Kuvaus DH-122 Käyttöpaikkatietojen päivitys (jakeluverkonhaltija) Käyttöpaikan päivityksessä ei voida testata tiedonvälitystä käyttöpaikan edeltävälle myyjälle, koska sopimuksia ei voida luoda menneisyyteen. DH-123 Käyttöpaikan poisto Ei poikkeamia DH-124 Käyttöpaikkatietojen päivityspyyntö (myyjä) Ei poikkeamia DH-311 Ilmoitus uudesta sopimuksesta Sopimuksia ei voida aloittaa menneisyydessä. Tulevaisuudessa alkavien myyntisopimusten ja tasesopimusten peruutus sisäänmuuttotilanteessa. Datahub tapahtumat dokumentti, määrittää että käyttöpaikka voidaan luoda aikaisintaan 3 vuotta takautuvasti ja viimeistään kuluvan päivän kello 00:00 mennessä. Julkaisussa aikarajat ovat kuitenkin 3 päivää takautuvasti ja viimeistään seuraavana päivänä. Markkinasäännöt määrittävät, että käyttöpaikkatiedon päivityksestä ei lähetetä tietoa muutoshetkellä voimassaolleelle myyjälle, jos päivitys ilmoitetaan yli 6 viikkoa takautuvasti siitä hetkestä, kun käyttöpaikkaan liittyvä myyntisopimus on päättynyt. Koska myyntisopimuksia ei voida luoda menneisyyteen, ei voida luoda tilannetta, jolla tapahtumaa voidaan testata. Takautuvien korjausten suoritus sopimuksille on osa tulevaa osavaihetta. Tulevaisuudessa alkavat tase- ja myyntisopimukset peruutetaan osana toteutettua prosessia (käyttöpaikan tasetieto toteutetaan tasesopimuksena järjestelmässä). Peruutusten tarkka toteutus tullaan kuitenkin keskustelemaan myyntisopimusten peruutuksiin liittyvissä työpajoissa ja tämä voi muuttaa nykyistä toteutusta myöhemmässä osavaiheessa. Arvioitu toteutuksen osavaihe
7 (9) Ilmoitusta häviöihin kirjattujen kulutusten nollauksesta osana uutta sopimusta (DH-311-9) ei ole vielä toteutettu. Suunniteltu osavaiheeseen 5. Jakeluverkonhaltijan Yhteislaskutus-tietoa ei voida tarkistaa sopimusprosessin yhteydessä, sillä osapuolitietojen hallintaa ei ole vielä toteutettu. Peruutettuihin sopimuksiin liittyviä validointisääntöjä ei ole vielä toteutettu. Sopimuksia ei voida luoda päättymispäivällä. Henkilötunnuksen (muotoa PPKKVVSNNNT) validointia ei ole vielä toteutettu. Myös asiakkaan ikää (asiakkaan tulee olla vähintään 18-vuotias) ei vielä validoida henkilötunnuksen perusteella. DH-312 Verkkosopimuksen vahvistaminen Tämä ilmoitus tarvitsee integraation mittaustieto/taseselvitys-moduuliin. Ilmoitus lähetetään vain takautuvia korjauksia tehdessä (nämä eivät ole sallittuja osavaiheessa 1). Yhteislaskutus-tieto on yksi osapuolen tiedoista. Nämä tiedot eivät ole osa osavaihetta 1. Tarkat kuvaukset, kuinka sopimusten peruutuksia käsitellään, keskustellaan osavaiheen 3 yhteydessä. Tähän poikkeamaan liittyviä validointisääntöjä ei voida vielä toteuttaa. Nykyisessä tapahtuman sanomamäärityksen versiossa ei ole kenttää päättymispäivämäärälle. Toteutetaan osavaiheessa 2. Ikä validoidaan kuitenkin silloin, kun asiakkaan ikä on annettu syntymäpäiväkentässä, jo nykyisessä julkaisussa. DH-312 sanoma, jolla verkkosopimus hylätään (ei vahvisteta), voidaan ilmoittaa ilman käyttöpaikkatietoa. Osavaihe 5 Osavaihe 2 Sanomaa, jossa verkkosopimuksen luontia ei vahvisteta ja jossa sopimustietoa ei ole ilmoitettu, ei voida prosessoida oikein. Tällä hetkellä käyttöpaikkatieto tarvitaan, jotta sanoma voidaan järjestelmässä reitittää oikeaan prosessiin. DH-411 Toimituksen kytkentäpyyntö (myyjä) Ei poikkeamia DH-412 Ilmoitus toimituksen kytkennästä (jakeluverkonhaltija) Olemassa olevan katkaisuprosessi-instanssin tarkistusta ja katkaisuprosessin ilmoituksia ei ole vielä toteutettu. DH-413 Ilmoitus kytkennän viivästymisestä Ei poikkeamia DH-312 sanomamääritys muutetaan siten, että käyttöpaikan tunnus on aina pakollinen. Katkaisuprosessia ei ole vielä toteutettu. Siitä syystä validointisääntöä ei voida vielä toteuttaa. Osavaihe 2
8 (9) Yleiset B2B-rajapinnan poikkeamat Sisääntulevan sanoman ja järjestelmään tallennettujen tietojen vertailua ei ole vielä toteutettu. Sanomissa käytettävät ulkoiset syykoodit ovat väliaikaisia ja ne päivitetään myöhemmässä osavaiheessa. 3.osapuolen valtuutuksiin liittyviä validointeja ja ilmoituksia 3.osapuolille ei ole vielä toteutettu. Postin rajapintaan liittyviä validointisääntöjä ei ole toteutettu. Datahub tapahtumat dokumentin luvussa 2.9 kuvattua yleistä peruutustapahtumaa ei ole vielä toteutettu. Yleiset käyttöliittymän poikkeamat Käyttöliittymässä on rajoitus seuraavien prosessien suoritusten näkymissä: Tällä hetkellä datahub ei validoi tietojenpäivityksissä sitä, että mikään tieto ei päivityksen perusteella muutu. Täten datahub myös välittää kaikki tällaiset päivitykset toisille osapuolille. Ulkoiset syykoodit määritetään myöhemmässä osavaiheessa. Datahub tulee validoimaan, että postinumero ja postitoimipaikka täsmäävät keskenään Suomessa sijaitsevilla osoitteilla ja että postinumero ja postitoimipaikka löytyvät Postin tarjoamassa listauksessa. Peruutusten toimenpiteet ja toteutus selvennetään tulevaisuudessa. Osavaihe 2 Verkkosopimuksen vahvistus Kytkennän viivästymisen ilmoitus (avoimet transaktiot) Jakeluverkonhaltijan kytkentä vastauksena myyjän kytkentäpyyntöön Jakeluverkonhaltijan suorittama käyttöpaikkatietojen päivitys vastauksena myyjän päivityspyyntöön. Tämä vaatii tuotteen laajennuksen, joka on suunniteltu osavaiheeseen 3.
9 (9) 2.3 Avoimet viat julkaisussa Avoimet viat DH-123 Käyttöpaikan poisto [GUI] Aloituspäivämäärä puuttuu käyttöpaikan poiston popup-ikkunassa. DH-124 Käyttöpaikkatietojen päivityspyyntö (myyjä) [GUI] LISÄÄ ja POISTA painikkeet näkyvät syyttä Myyjän käyttöpaikkatietojen päivityspyyntö -näkymässä. DH-311 Ilmoitus uudesta sopimuksesta [GUI] Myyntisopimuksen luonti: Pakolliset tiedot sanoman (ilmoituksen) vapaaehtoisille osille tulee olla täytettynä ilmoituksen luomiseksi. Aloituspäivämäärä ei ole näkyvillä näytöllä. Prosessi automaattisesti poistaa käyttöpaikan käyttöpaikan luonti-ilmoituksessa ilmoitetusta päivämäärästä alkaen. Myyjän käyttöpaikkatietojen päivityspyynnössä lisää ja poista painikkeiden ei tulisi olla näkyvillä taulukossa, koska tämä ei ole sallittua prosessissa. Tällä hetkellä nämä painikkeet ovat nähtävillä. Myyntisopimuksen luonnissa on käyttöliittymässä joitakin valinnaisia ilmoituksen osia, jotka sisältävät pakollisia kenttiä. Tällä hetkellä pyyntöä ei voida lähettää, jos kaikkia näitä ominaisuuksia ei ole täytetty (vaikka koko osa olisi valinnainen).