Tietorajapinta (REST) markkinaosapuolille

Tiedonvaihto datahubin kautta hoidetaan Liiketoimintaprosessit ja datahub-tapahtumat -osiossa kuvatulla sanomaliikenteellä, jonka pohjana käytetään ebIX-sanomamäärityksiä. Osapuolilla on käytössään myös heille tarkoitettu käyttöliittymä. Näiden lisäksi datahubissa on myös niin kutsuttu tietorajapinta, jonka avulla osapuolille voidaan tarjota joustavammin heille kuuluvia tietoja suoraan ilman tapahtumiin liittyviä sanomia. Tietorajapinta on REST/HTTP-rajapinta. Tietorajapinta mahdollistaa datahubissa olevien tietojen haun esimerkiksi suoraan markkinaosapuolen loppuasiakkaillensa tarjoamaan online-palveluun. Tietorajapinnan kautta ei voi ilmoittaa tietoja datahubiin. Markkinaosapuolet voivat itse päättää haluavatko tätä rajapintaa hyödyntää omassa toiminnassaan. Mikäli osapuolilla on tarve hakea isompaa tietomäärää kerralla, esimerkiksi verratakseen datahubissa olevaa tietoa oman järjestelmänsä tietoihin, tulee tähän tarkoitukseen käyttää datahubin tarjoamia kontrolliraportteja. Näitä raportteja voidaan ajaa ajastetusti esim. yöaikaan häiritsemättä muuta päivittäistä toimintaa.

Tietorajapintaa voidaan hyödyntää myös, kun ulkoinen rekisteröity osapuoli (3. osapuoli tai muu markkinaosapuoli) kehittää ja luo uusia palveluita, joita varten asiakas voi antaa valtuutuksen omiin tietoihinsa. 3. osapuolen palvelu voi olla esim. sovellus, jolla loppukäyttäjä näkee omat tietonsa kaikista käyttöpaikoistaan riippumatta minkä verkon alueella ne sijaitsevat tai kuka niihin myy sähköä.

Tietorajapinnasta tietoa voi kysellä yksittäiselle tietueelle (asiakastiedolle/käyttöpaikalle) kerrallaan. Toisin sanoen tietorajapinta ei tue ns. massahakuja, joilla voisi hakea monen käyttöpaikan tietoja kerrallaan. Tietorajapinta tarjoaa seuraavanlaiset tietohaut:

• Käyttöpaikkatietojen haku

• Käyttöpaikan sopimustietojen haku

• Käyttöpaikan mittaustietojen haku

• Käyttöpaikan valtuutustietojen haku

• Asiakkaan asiakastietojen haku

• Osapuolitietojen haku

  • Osapuolitietojen osalta voidaan hakea kaikkien osapuolten tiedot kerralla.

Tietorajapinnan käytössä huomioidaan osapuolten oikeudet tietoon samoilla säännöillä kuin sanomarajapinnassa. Osapuoli saa tämän rajapinnan kautta käyttöönsä ainoastaan ne tiedot mihin tällä on oikeus joko sopimuksen tai valtuutuksen kautta. Tietosuojan varmistamiseksi hakuun tulee syöttää aina myös asiakkaan tunnus, jonka kanssa sopimus on tehty. Yhden asiakkaan tunnus riittää myös siinä tapauksessa, jos sopimuksella on useampi asiakas.

Datahubin tietorajapinnasta on julkaistu oma dokumentaatio palveluportaalin rajapintakuvauksissa.

Tietorajapinnan lisäksi datahub tarjoaa osapuolille mahdollisuuden ajaa CSV-muotoisia kontrolliraportteja omista tiedoistaan tiedon laadun tarkastamistarkoituksiin. Kontrolliraportteja voidaan ajaa kaikista osapuolen omista tiedoista tietokokonaisuuksittain, mm. asiakas-, käyttöpaikka-, sopimus- ja valtuutustiedoista. Osapuoli voi esimerkiksi ajaa kontrolliraportin kaikista omista asiakastiedoista, jolloin datahub palauttaa raportin kaikista raportille annetulla ajanhetkellä aktiivisista asiakkaista, joihin raporttia ajavalla osapuolella on joko sopimuksen tai valtuutuksen mukainen oikeus.

Kontrolliraportit markkinaosapuolille: