Estfeed Datahubi KKK

Estfeed Datahub on elektrituru andmevahetusplatvorm, mis tagab efektiivse andmevahetuse ning turuosaliste võrdse kohtlemise. Lihtsustatult öeldes on see platvorm, kuhu võrguettevõtjad edastavad tarbimis- ja tootmisandmeid ning mille kaudu saavad volitatud osapooled neile andmetele ligipääsu.

Estfeed Datahub on elektriturul kasutusel alates 22.11.2024. Varem kasutati andmevahetuseks Andmeladu ehk AVP. Tulevikus plaanitakse Estfeed Datahubi kasutusele võtta ka gaasituru andmevahetuseks.

Estfeed Datahubile saavad ligipääsu taotleda energiaettevõtted, kellel on selleks seaduslik alus. Erinevate rollide kohta leiab rohkem infot siit. Ligipääsu saamiseks palun täitke lepingupõhi ja saatke see meile allkirjastamata kujul tagasi.

Taotluse töötlemine võib aega võtta kuni 10 tööpäeva. Pärast lepingu mõlemapoolset allkirjastamist antakse ligipääsuõigus lepingus märgitud haldurile. Enne süsteemile ligipääsu saamist palume tutvuda põhjalikult Elektrituru toimimise võrgueeskirjaga. Estfeed Datahubi kasutusjuhendid ja täiendav teave on kättesaadavad järgmisel lingil: https://github.com/Elering/estfeed-datahub-docs.

Lepingupõhjad turuosalisele:
AVP kasutamise leping turuosalistele
AVP kasutamise lepingu üldringimused

Enne, kui saame teid lisada energiateenuse pakkujaks tuleb läbida protsess, mille eesmärk on kontrollida, et on täidetud energiateenusele isikuandmete kaitse üldmäärusest tulenevad kohustused.

1. Täitke liitumistaotlus ja saatke see aadressile [email protected]
2. Peale meiepoolset taotluse kinnitamist tuleb sõlmida Estfeed Datahubi kasutamise leping. Seejärel täitke leping ja saatke see meile allkirjastamata kujul tagasi. Lepingus sõnastatud eesmärk peab olema lihtne ja üheselt arusaadav.
   
   Lepingupõhjad energiateenusele:
   AVP kasutamise leping energiateenusele
   AVP kasutamise lepingu üldtingimused energiateenusele
    
3. Saadame teile allkirjastamiseks teie poolt täidetud lepingu koos üldtingimustega.
4. Peale lepingu edukat allkirjastamist liidestame teid Estfeediga. Selleks küsime teilt veel täiendavat informatsiooni, näiteks veebilehele lisamiseks teie logo.

Oleme loonud turuosalistele oma liidestuste testimiseks Public-test keskkonna, mis asub aadressil https://public-test-datahub.elering.ee. Testkeskkonnale ligipääsu saamiseks saatke meile palun aadressile [email protected] allkirjastamata kujul eeltäidetud testkeskkonna leping. Testkeskkonna lepingu sõlmimise eelduseks on LIVE keskkonna leping.

Lepingu põhi on leitav siit.

Kõik meie juhendid on kättesaadavad Githubist, seal on olemas ka eraldi kasutajaliidese juhend.

Juhendis on samm-sammult kirjeldatud, kuidas andmeid lisada, otsida ja muuta.

Kogu vajalik info API-ga liidestumiseks on leitav meie Githubi dokumentatsioonis.

API liidestuseks on vajalik, et lepingujärgsel halduril oleks olemas ligipääs veebiliidesele ja saaks luua tehnilise kasutaja.

Soovitame liituda ka Estfeed Datahubi IT töögrupi Teamsi kanali ja koosolekutega. Selleks palume kirjutada aadressile [email protected].

Ligipääs Estfeed Datahubile on ainult lepingus märgitud halduril ja tema poolt volitatud kasutajatel. Palun veendu, et oled allkirjastanud AVP kasutamise lepingu.

Turuosalistel on ligipääs lepingutele, kus nad on mõõtepunkti omanikuks, avatud tarnijaks või neile on antud kliendiportaali kaudu ligipääs.

Veebiliideses lepingute otsimine:
Lepinguid saab vaadata vajutades menüüpunktile "Lepingud". Seejärel on võimalik erinevate filtrite alusel otsida õige leping. Jättes kõik lahtrid täitmata leitakse kõik lepingud. Peale "Otsi" nupu vajutamist on võimalik vajtada ka "Laadi alla" nuppu. Seejärel laetakse lepingud Excelisse. Excelisse saab laadida maksimaalselt 40 000 lepingut.

API kaudu lepingute otsimine:
Lepinguid saab otsida ka API kaudu, seda oleme täpsemalt kirjeldanud Githubi dokumentatsioonis.

Igal võrguettevõtjal, liinivaldajal, suletud jaotusvõrgu ettevõtjal, agregaatoril, tootjal ja laadimispunkti operaatoril on oma EIC-koodi vahemik, mille määrab Elering. Turuosaline saab registreerida ainult sellesse vahemikku jääva EIC koodiga mõõtepunkte.

Mõõtepunkti registreerimise sammud veebiliideses:

1. Kui sa ei tea järgmist vaba EIC koodi, genereeri see Datahubis:
   Ava "Mõõtepunktide masslaadimine“ leht ja vajuta nuppu "Genereeri EIC koodid". Koguse lahtrisse lisa soovitud EIC koodide arv ja vajuta "Genereeri". 
2. Lisa uus mõõtepunkt koos vajalike andmetega. Selleks vajuta lehel "Mõõtepunktid" nuppu "Uus". Ja täida vähemalt kõik kohustuslikud väljad (tähistatud tärniga). Veendu, et esitatud andmed oleksid korrektsed. Seejärel vajuta nuppu "Loo"
3. Enne mõõteandmete saatmist loo mõõtepunktile ka võrguleping.
   
   Täpsemalt saab mõõtepunkti lisamise kohta lugeda Githubi dokumentatsioonist, sinna oleme lisanud ka piltidega juhised.

Mõõtepunkti registreerimine API kaudu:

1. Kui sa ei tea järgmist vaba EIC koodi, genereeri see Datahubis:
   • API teenus: /eic/amount
2. Lisa uus mõõtepunkt koos vajalike andmetega ja veendu esitatud andmete õigsuses:
   • API teenus: /meter
3. Enne mõõteandmete saatmist loo mõõtepunktile ka võrguleping.

Täpsemalt saab mõõtepunkti lisamise kohta lugeda Githubi dokumentatsioonist.

Ülekandevõrgu EIC-koodi väljale tuleb lisada alajaama EIC-kood. Alajaamade EIC koodid on leitavad siit.

Kui õiget alajaama EIC-koodi pole teada, võib ajutiselt kasutada koodi 38A-1234567890-1, kuid see tuleks hiljem asendada korrektse koodiga.

Vastavalt elektrituru toimimise võrgueeskirjale on võrguettevõtjal kohustus tagada, et andmevahetusplatvormile Estfeed Datahub esitatud andmed on korrektsed, ajakohased ja võimaldavad korrektset arvestust ning andmevahetust. Muuhulgas on oluline, et aadressid oleksid lisatud korrektselt, ei sisaldaks kirjavigu ja oleksid korrektsel kujul. Aadresside kontrollimiseks soovitame kasutada Maa- ja Ruumiameti avalikku teenust: https://xgis.maaamet.ee/adsavalik/.

Veebiliideses andmete muutmiseks:

1. Navigeeri lehele "Mõõtepunktid"
2. Vajuta "Otsi" või täida mõni filtri lahtritest. Otsinguks ei ole vaja täita kõiki lahtreid.
3.  Rea lõpus on pliaatsi ikoon, see avab andmete muutmise akna. Muudatuste tegemise pliiatsi kujuline ikoon ei pruugi kohe nähtav olla. Selleks tuleb kasutada tabeli kohal asuvat horisontaalset kerimisriba, see võimaldab liikuda tabelis paremale. 
4.  Seejärel saab teha vajalikud muudatused
5. Peale "Muuda" nupu vajutamist salvestatakse muudatused.

API kaudu muudatuste tegemiseks:

Kasutada saab PUT /api/{version}/meter teenust. Täpsemalt saab sellest lugeda Githubist.

Mõõtepunkti tüübi muutmine ei ole lubatud. Näiteks ei saa muuta piirimõõtepunkti tavaliseks, sellises olukorras tuleks genereerida uus EIC kood ja lisada uus mõõtepunkt.

Täpsemad juhendid mõõtepunktide andmete muutmiseks nii API kui veebiliidese kaudu on leitavad siit: https://github.com/Elering/estfeed-datahub-docs/blob/main/est/05-mootepunktid.md.

Piirimõõtepunkte saab vaadata veebiliideses "Piirimõõtepunktid" lehelt või API teenuses /meter/search/border. Mõõteandmeid saab otsida tavalises mõõteandmete otsingus (veebiliideses lehel "Mõõteandmed") mõõtepunkti EIC koodi ja perioodi alusel.

• Iga päeva kella 10:00-ks tuleb esitada eelmise päeva mõõteandmed.
• Iga kalendrikuu 5. kuupäevaks tuleb esitada lõplikud andmed eelmise kuu kohta.

Mõõteandmeid saab lisada nii veebiliidese kui ka API vahendusel, kuid enne tuleks mõõtepunkt Datahubi registreerida ja registreerima peaks ka võrgulepingu.

Mõõteandmete lisamine veebiliideses (piltidega juhend on leitav Githubist):

1.  'Mõõteandmed' -> 'Mall' -> vali sobivad parameetrid (tunni andmete puhul peavad kellaajad olema täistunnid või 15 min andmete puhul veerandtunnid) -> 'Laadi alla'
2. Täida alla laetud mall ära üles laetavate mõõteandmetega ja salvesta oma arvutisse, Exceli täitmise juhendi leiab siit: Mõõteandmete edastamine Exceli teel. Reading time väärtuse lisamine on vabatahtlik, tühjaks jättes asendatakse see hetke ajaga. 
3. Mõõteandmed' -> 'Impordi' -> vali fail, mida üles laadida -> 'Impordi'
4. Kui fail oli ilma vigadeta, siis peaks mõõteandmed olema üles laetud või üles laadimisel
5. Kas mõõteandmed said üles laetud saab kontrollida kahte moodi:
   • 'Mõõteandmed' -> 'Mõõteandmete olek' -> vali ajavahemik -> 'Otsi'
   • 'Mõõteandmed' -> täida vastavad väljad -> 'Otsi' -> vaata kas üles laetud mõõteandmed tagastatakse otsingu tulemustes

Mõõteandmete edastamine API vahendusel:

Mõõteandmeid saab lisada /meter-data teenuse vahendusel. Peale andmite saatmist saate töötlemise staatuse kontrollimiseks kasutada /meter-data/status teenust. Rohkem infot on leitav Githubist.

Estfeed Datahub võtab vastu vaid õigesti vormistatud faile, täpsemalt oleme seda kirjeldanud Githubi juhendis.

Kõige levinumad probleemid ja lahendused:

1. 15-minuti resolutsioon: Kui arvesti mõõdab tunni täpsusega, tuleb kogus jagada neljaks ja esitada veerandtundide kaupa.
2. Mõõtepunkt ei kuulu turuosalisele: Kontrolli EIC-koodi.
3. Mõõtepunkti ei leitud: Registreeri mõõtepunkt enne andmete saatmist.
4. Exceli struktuur: Fail ei tohi sisaldada tühje või mittevajalikke lehti.
5. Andmete vorming: Kasuta puhast tekstivormingut, väldi valemeid.
6. Kellaaeg ja resolutsioon: Algusajad peavad vastama resolutsioonile (täistunnid või veerandtunnid).
7. "Period start" ja "Reading time": Vorming peab vastama mallile.
8. Kohustuslikud veerud: Vaata juhendist, millised veerud peavad olema täidetud.
9. EIC-kood igal real: Iga rida peab sisaldama mõõtepunkti EIC-koodi.
10. Rolli sobivus: Mõõteandmeid saavad saata ainult kindlates rollides tegutsevad turuosalised (võrguettevõtja, liinivaldaja, suletud jaotusvõrk, tootja, laadimispunkti operaator, agregaator).

"Reading time" ehk andmete lugemise aeg näitab, mis hetke seisuga on andmed arvestist võetud. See aitab korrektuuride korral määrata, millised andmed on kõige värskemad.

Selle välja võib jätta ka tühjaks, sel juhul kasutatakse hetke aega.

Mõnikord ilmnevad vead alles salvestamisel. Seetõttu tuleks alati kontrollida mõõteandmete töötlemise staatust:

• Veebiliideses: lehelt „Mõõteandmete staatus“
• API teenus: /meter-data/status

Vahel võeb mõõteandmete töötlemine võtta kauem aega ja seega ei saa töötlemise tulemust koheselt teada.

Mõõteandmeid saab kontrollida veebiliides lehelt "Mõõteandmed" või API teenuse meter-data/search kaudu.

Veebiliideses mõõteandmete otsimiseks täida mõõtepunkti EIC koodi lahter ja vali periood. Seejärel on võimalik näha mõõteandmeid ja lisaks on võimalus laadida need Excelisse.

Estfeed Datahubis on võimalik vaadata korraga vaid ühe mõõtepunkti mõõteandmeid. Korraga mitme mõõtepunkti mõõteandmeid ei ole võimalik kontrollida.

Täpsemad juhised on leitavad Githubi dokumentatsioonist.

Võrguettevõtjal on õigus vajadusel oma andmeid korrigeerida. Selleks tuleb uuendatud mõõteandmed lihtsalt uuesti Datahubi üles laadida.

Oluline on, et Reading time väärtus oleks kas tühi (sel juhul kasutatakse hetke aega) või hilisem kui eelnevalt esitatud andmetel. See tagab, et uued andmed kirjutavad varasemad õigesti üle.

Palume andmeid korrigeerida ainult juhul, kui on tuvastatud viga. Duplikaatandmete (sama sisuga andmete) korduv üleslaadimine ei ole lubatud, kui mõõteandmete väärtused tegelikult ei ole muutunud.

Uue võrgulepingu saab lisada veebiliideses lehelt "Uus leping" või API kaudu. Selleks tuleb lisada vajalik info - mõõtepunkti EIC kood, kliendi EIC kood ja lepingu kehtivuse aeg.

Tähele tuleb panna, et:

1. Mõõtepunktis ei tohi olla samal perioodil teist kehtivad võrgulepingut. Uue lisamiseks tuleb eelmine leping alustuseks lõpetada.
2. Mõõtepunkt peab olema eelnevalt Datahubis registreeritud ja kuuluma antud turuosalisele
3. Võrgulepingut saab lisada võrguettevõtja, liinivaldajal, suletud jaotusvõrgu ettevõtjal, tootjal ja laadimispunkti operaatori. Näiteks müüja või agregaatori rollis olles pole võimalik lepingut registreerida.

Kehtiva võrgulepingu klienti ei ole võimalik muuta. Kliendi muutuse korral tuleks eelmine võrguleping lõpetada ja seejärel lisada uus leping. Kui leping pole veel kehtima hakanud saab selle lihtsalt kustutada ja seejärel lisada õige lepingu.

Võrgulepingut saab muuta API kaudu ja veebiliideses, veebiliideses lepingu muutmiseks järgi järgmiseid samme:

1.  Mine lehele "Lepingud".
2. Otsi näiteks isikukoodi või mõõtepunkti EIC koodi alusel üles õige leping,
3.  Otsingu tulemustes on rea lõpus nupp "Muuda", seejärel avaneb lepingu muutmise aken.
4. Lisa lepingu lõppemise kuupäev "Kehtiv kuni" lahtrisse ja vajuta "Salvesta", nüüd on see leping lõpetatud.
5.  Uue leping lisamiseks vajuta nupule "Uus leping"
6. Lisa mõõtepunkti EIC kood, kliendi EIC kood ja kehtivuse algus kuupäev.
7. Vajuta nuppu "Registreeri uus leping". Kui antud andmed olid õiged ja leping ei kattunud mõne varasema lepinguga oli lepingu lisamine edukas ja mõõtepunktis nüüd klient vahetunud.

Vastavalt elektrituru toimimise võrgueeskirjale on võrguettevõtjal kohustus tagada, et andmevahetusplatvormile Estfeed Datahub esitatud andmed on korrektsed, ajakohased ja võimaldavad korrektset arvestust ning andmevahetust. Nende hulka kuuluvad ka kliendi andmed, andmevahetuse tagamiseks on oluline, et kliendid oleksid lisatud korrektse isikukoodi, registrikoodiga või isikukoodi puudumisel dokumendi numbriga.

Kliendi andmeid on võimalik muuta vaid API kaudu. Selleks tuleks kasutada teenust PUT /api/{version}/customer. Täpsemalt saab selle kohta lugeda Githubi dokumentatsioonist.

Kui kliendil ei ole kunagi võrgulepingut olnud puudub tema info tõenäoliselt Datahubist ja võrguettevõtja peab selle sinna lisama. Võrguettevõtja on kohustatud tagama andmete korrektsuse ja ajakohasuse. Alati tuleb lisada kliendi isikukood või registrikood. Välismaalase puhul, kellel Eesti isikukood puudub piisab ka dokumendi numbri lisamisest.

Uue kliendi registreerimine veebiliideses:

1. Alusta võrgulepingu lisamist "Uus leping" lehel.
2.  Lisa mõõtepunkti EIC kood.
3. Vajuta nuppu "Otsi klienti"
4. Kliendi otsingu vaates täida mõni lahter (näiteks isikukood) ja vajuta paremal nupule "Otsi". Kui klient leiti ei pea te kliendi andmeid lisama hakkama ja saate kliendi valida. Kui klienti ei leidnud tuleb klient ise lisada.
5. Kliendi lisamiseks vajuta kliendi otsingu all nuppu "Registreeri uus klient"
6. Täida kohustuslikud väljad

Uue kliendi lisamine API vahendusel:

Kliendi otsimiseks saab kasutada POST /api/{version}/customer/search teenust, uue kliendi lisamiseks saab kasutada POST /api/{version}/customer teenust. Rohkem infot Githubis.

Kui kliendil on kunagi olnud võrguleping eksisteerib tal tõenäoliselt ka EIC kood. Kui kliendil ei ole kunagi võrgulepingut olnud puudub tema info tõenäoliselt Datahubist ja võrguettevõtja peab selle sinna lisama. Võrguettevõtja on kohustatud tagama andmete korrektsuse ja ajakohasuse. Alati tuleb lisada kliendi isikukood või registrikood. Välismaalase puhul, kellel Eesti isikukood puudub piisab ka dokumendi numbri lisamisest.

Kliendi otsimine:

1. Alusta võrgulepingu lisamist "Uus leping" lehel.
2.  Lisa mõõtepunkti EIC kood.
3. Vajuta nuppu "Otsi klienti"
4. Kliendi otsingu vaates täida mõni lahter (näiteks isikukood) ja vajuta paremal nupule "Otsi". Kui klient leiti ei pea te kliendi andmeid lisama hakkama ja saate kliendi valida. Kui klienti ei leidnud tuleb klient ise lisada.

Uue kliendi lisamine API vahendusel:

Kliendi otsimiseks saab kasutada POST /api/{version}/customer/search teenust, uue kliendi lisamiseks saab kasutada POST /api/{version}/customer teenust. Rohkem infot Githubis.

Tavaolukorras tagab kliendi andmetele ligipääsu kliendiga sõlmitud avatud tarne leping.

Pakkumise tegemiseks saab klient jagada ligipääsu ka Estfeedi kliendiportaali kaudu jagades ligipääsu lehelt "Minu rollid ja õigused". See võimaldab avatud tarnijal näha kliendi viimase aasta mõõteandmeid ja mõõtepunkti aadressi.

Juriidilise isiku andmeid on võimalik pärida ka kinnitades süsteemivälise volituse olemasolu. Sellisel juhul kinnitab avatud tarnija, et tal on olemas kliendi kirjalik volitus taasesitavas vormis. Volituste kasutamist monitooritakse.

Uue avatud tarne lepingu saab lisada veebiliideses lehelt "Uus leping" või API kaudu. Vaja on lisada klient, mõõtepunkti EIC kood ja kehtivuse periood.

Tähelepanu tuleks pöörata järgnevale:

1. Kliendil peab olema mõõtepunktis kehtiv võrguleping, mis katab kogu avatud tarne lepingu perioodi.
2. Kliendil ei tohi olla trahvinõudega lepingut eelmise teenusepakkujaga. Sellisel juhul tuleb klienti sellest teavitada.
3. Kui mõõtepunkt on hetkel üldteenusel, võib uus leping kehtima hakata alates järgmisest päevast.
4. Kui lepingu lisamise tõttu lõpetatakse eelmise avatud tarnija leping, peab lepingu algus olema vähemalt 14 päeva tulevikus.

Ei pea. Eelmise avatud tarnija leping lõpetatakse automaatselt uue lepingu lisamisel. Siiski peab uue lepingu alguskuupäev olema vähemalt 14 päeva tulevikus.

Kui leping pole veel kehtima hakanud, saab selle kustutada:

1. Ava veebiliideses leht „Lepingud“
2. Leia sobiv leping
3. Vajuta rea lõpus nuppu „Kustuta“

Sama saab teha ka API vahendusel. Lepingu kustutamine ei taasta eelmise müüja lepingut. Soovitame sellest veast eelmist müüjat teavitada.

Mõõteandmeid saab vaadata:

• veebiliideses lehel „Mõõteandmed“
• API kaudu teenusega /meter-data/search

Seejärel on võimalik näha mõõteandmeid ja lisaks on võimalus laadida need Excelisse.

Estfeed Datahubis on võimalik vaadata korraga vaid ühe mõõtepunkti mõõteandmeid. Korraga mitme mõõtepunkti mõõteandmeid ei ole võimalik vaadata ei ole.

Lisaks on võimalik kasutada Data Distribution teenust, mille kaudu genereeritakse sõnumid uute mõõteandmete kohta. Täpsemalt on sellest teenusest võimalik lugeda siin.

Kehtiva avatud tarne lepingu olemasolul peaksid nägema mõõteandmeid. Kui mõõteandmed mingil perioodil puuduvad on need tõenäoliselt jäänud võrguettevõtjal esitamata. Palun teavita võrguettevõtjat või kirjuta [email protected] meilile.

Valede andmete põhjuseid võib olla erinevaid. Suure tõenäosusega on mingitesse mõõtepunktidesse jäänud võrguettevõtjal andmed edastamata või on probleem mingite lepingutega. Et saaksime probleemi paremini uurida märkige raportis probleemsed kohad kollaseks ja saatke koos probleemi võimalikult täpse kirjeldusega [email protected] meilile. 

Estfeed Datahubis on loodud funktsionaalsus, mis võimaldab tagasiulatuvate lepingumuudatuste puhul esitada muudatuse taotluse kõigile mõjutatud osapooltele. Kui kõik osapooled on muudatusega nõus, vormistatakse ametlik lepingumuudatus.

Täpsem info ja juhised:

• Funktsionaalsuse kirjeldus
• Veebiliidese kasutusjuhend koos piltidega
• API kirjeldused