From 1b791e4bbc4e1573f7573308f9c48dc075280f52 Mon Sep 17 00:00:00 2001 From: Einar Arro Date: Thu, 8 Jun 2023 11:47:16 +0300 Subject: [PATCH] Datahub API documentation update based on the latest developments and knowledge updates. --- ...kirjeldus-ja-infovahetuse-yldpohimotted.md | 30 ++++---- est/02-autentimine-ja-autoriseerimine.md | 3 +- est/03-kliendi-eic.md | 48 ++++++------- est/04-mootepunktid.md | 66 +++++++++--------- est/05-lepingud.md | 21 +++--- est/05.1-portfellileping.md | 24 +++---- est/05.2-vorguleping.md | 11 ++- est/05.3-avatud-tarne-leping.md | 13 ++-- est/05.4-avatud-tarnija-vahetus.md | 50 +++++++------- est/05.5-nimetatud-tarnija-leping.md | 14 ++-- est/05.7-yhisarve-leping.md | 13 ++-- ....8-kooskolastusega-lepingute-muudatused.md | 32 +++++---- est/06-yldteenuse-teavitus.md | 4 +- est/10-bilansipiirkond.md | 32 ++++----- est/11-ligipaasuoigus.md | 20 +++--- est/12-mooteandmed.md | 44 ++++++------ est/13-vorguteenuse-arve.md | 28 ++++---- est/14-yhisarve.md | 34 ++++----- est/20-raportid.md | 43 +++++++----- est/21-valja-ja-sisse-lylitamine.md | 52 +++++++------- est/22-kliendi-poordumiste-vahendus.md | 34 +++++---- est/30-andmete-levitamine.md | 4 +- est/40-migratsioon.md | 69 ++++++++++++------- 23 files changed, 369 insertions(+), 320 deletions(-) diff --git a/est/01-avp-kirjeldus-ja-infovahetuse-yldpohimotted.md b/est/01-avp-kirjeldus-ja-infovahetuse-yldpohimotted.md index b12e04c..4252346 100644 --- a/est/01-avp-kirjeldus-ja-infovahetuse-yldpohimotted.md +++ b/est/01-avp-kirjeldus-ja-infovahetuse-yldpohimotted.md @@ -43,10 +43,10 @@ Andmelattu andmete sisestajaid nimetatakse operaatoriteks, kelle ülesanded ja v - **Võrguettevõtja** on elektriettevõtja, kes osutab võrguteenust võrgu kaudu ning kes **vastutab** oma võrgupiirkonna mõõtepunktide ja mõõteandmete kogumise ja edastamise eest Andmelattu. Iga võrguettevõtja on turuosaline oma võrgukadudega. Lisaks vastavalt seadusandlusele, kui turuosalisel ei ole avatud tarne lepingut, siis on tema avatud tarnijaks automaatselt tema võrguettevõtja või viimase poolt nimetatud müüja. - **Liinivaldaja** kasutab elektrienergia edastamiseks otseliini ning kes **vastutab** oma liinipiirkonna mõõteandmete kogumise ja edastamise eest Andmelattu. - **Suletud jaotusvõrk** osutab võrguteenust suletud jaotusvõrgu kaudu kaudu ning kes **vastutab** oma võrgupiirkonna mõõtepunktide ja mõõteandmete kogumise ja edastamise eest Andmelattu. Iga võrguettevõtja on turuosaline oma võrgukadudega. Suletud jaotusvõrgus edastatakse elektrienergiat geograafiliselt piiratud tootmiskoha, ärirajatise või ühisteenuste koha piires seal asuvatele äritarbijatele, kelle tegevus või tootmisprotsess on tehnilistel või ohutusega seotud põhjustel omavahel ühendatud, või mille kaudu edastatakse elektrienergiat peamiselt võrgu omanikule või võrguettevõtjale, kes seda võrku haldab, või nendega valitseva mõju kaudu seotud ettevõtjale. -- **Tootja** edastab oma mõõtepunkti(de)ga seotud andmed, kui ei oma liinivaldaja tegevusluba -- **Laadimispunkti operaator** haldab laadimispunkte, mille kaudu on võimalik laadida korraga ühte elektrisõidukit või vahetada korraga ühe elektrisõiduki aku +- **Tootja** edastab oma mõõtepunkti(de)ga seotud andmed, kui ei oma liinivaldaja tegevusluba. +- **Laadimispunkti operaator** haldab laadimispunkte, mille kaudu on võimalik laadida korraga ühte elektrisõidukit või vahetada korraga ühe elektrisõiduki aku. - **Avatud tarnija** on elektri müüja või ostja, kes osutab kliendile avatud tarnet ehk müüb/ostab kas puudujääva/ülejääva elektrienergia koguse või müüb/ostab kogu mõõdetud elektrienergia koguse sõltuvalt poolte vahelisest kokkuleppest turuosalisega. Avatud tarnija sisestab Andmelattu avatud tarne lepingu andmed turuosalisega. -- **Nimetatud müüja** võrguettevõtja poolt valitud avatud tarnija, kes osutab võrguettevõtja asemel avatud tarne teenust võrguettevõtja teeninduspiirkonna klientidele, kellel puudub avatud tarne leping. +- **Nimetatud müüja** võrguettevõtja poolt valitud avatud tarnija, kes osutab võrguettevõtja asemel avatud tarne teenust võrguettevõtja teeninduspiirkonna klientidele, kellel puudub avatud tarne leping; - **Bilansihaldur** on hierarhiliselt kõrgemal olev avatud tarnija, kellel on bilansileping süsteemihalduriga. - **Agregaator** on tarbimise juhrimise teenuse osutaja ning edastab Andmelattu agregeerimislepingu info, tarbimise juhtimise mõõtepunkti ja andmed. - **Süsteemihaldur** on Elering, tagab Eesti elektrisüsteemi bilansi, on avatud tarnijaks bilansilepingu sõlminud bilansihalduritele, haldab ja arendab elektrituruseaduse alusel Andmeladu. @@ -118,7 +118,7 @@ Sõnumite struktuuride ja validatasioonide kirjeldused on leitavad [Swagger](htt - Kohustuslikud (tärniga tähistatud) elemendid peavad olema alati lisatud. Elemendi puudumisel muutub sõnum töötlematuks ja seda ei aktsepteerita vastuvõtval poolel. -- Osad elemendid on kohustuslikud ainult teatud juhtudel. Sellisel juhul on kohustuslikkuse reegel leitav sõnumi või elemendi kirjeldusest või käesolevatest dokumentidest +- Osad elemendid on kohustuslikud ainult teatud juhtudel. Sellisel juhul on kohustuslikkuse reegel leitav sõnumi või elemendi kirjeldusest või käesolevatest dokumentidest. - Kui element ei ole kohustuslik, siis võib see puududa. - Sõnumites kasutatakse vaikimisi UTF-8 kodeeringut. @@ -130,8 +130,8 @@ sõnum töötlematuks ja seda ei aktsepteerita vastuvõtval poolel. Liidestuval süsteemil on aadressi andmete edastamiseks 2 võimalust: -- saata Maaameti ADS süsteemi aadressi ID (ADR_ID) -- saata aadressi kirjeldus tekstilisel kujul +- saata Maaameti ADS süsteemi aadressi ID (ADR_ID). +- saata aadressi kirjeldus tekstilisel kujul. Mõlemad korraga ei ole lubatud. @@ -159,15 +159,15 @@ Aadressi sektsioon koosneb järgmistest atribuutidest: Atribuutide selgitus: -|Atribuut|Selgitus|Näide| -|--------|--------|-----| -|adsId|Maaameti ADS süsteemi ADR_ID|2105345| -|county|Maakond|Harju maakond| -|municipality|Omavalitsus|Tallinn| -|locality|Asustusüksus (küla, alevik, alev, vallasisene linn) või linnaosa|Kesklinna linnaosa| -|streetAddress|Lähiaadress (väikekoht, maaüksuse nimi, tänav, aadressinumber, korteri või muu hooneosa number)|Pärnu mnt 8| -|postalCode|Postiindeks|10148| -|comment|Kommentaar|C1T| +| Atribuut | Selgitus | Näide | +|---------------|-------------------------------------------------------------------------------------------------|--------------------| +| adsId | Maaameti ADS süsteemi ADR_ID | 2105345 | +| county | Maakond | Harju maakond | +| municipality | Omavalitsus | Tallinn | +| locality | Asustusüksus (küla, alevik, alev, vallasisene linn) või linnaosa | Kesklinna linnaosa | +| streetAddress | Lähiaadress (väikekoht, maaüksuse nimi, tänav, aadressinumber, korteri või muu hooneosa number) | Pärnu mnt 8 | +| postalCode | Postiindeks | 10148 | +| comment | Kommentaar | C1T | ### Vastussõnumite koodid diff --git a/est/02-autentimine-ja-autoriseerimine.md b/est/02-autentimine-ja-autoriseerimine.md index 8555459..b2c0c82 100644 --- a/est/02-autentimine-ja-autoriseerimine.md +++ b/est/02-autentimine-ja-autoriseerimine.md @@ -24,7 +24,7 @@ Elering tagab, et turuosalise andmetele Andmelaost saavad ligipääsu vaid need Ligipääsuõiguste üldpõhimõtted on järgmised: -1. Andmelao andmetele ligipääsuks tuleb Eleringiga sõlmida leping kõikidel elektriettevõtjatel ning energiateenuste osutajatel, kes taotlevad turuosalise andmetele ligipääsu +1. Andmelao andmetele ligipääsuks tuleb Eleringiga sõlmida leping kõikidel elektriettevõtjatel ning energiateenuste osutajatel, kes taotlevad turuosalise andmetele ligipääsu. 2. Võrgulepingu kliendile tagatakse juurdepääs kliendiportaali kaudu edastatavatele andmetele. Kliendil on õigus volituse andmise kaudu edastada oma mõõtepunkti ja mõõteandmeid teistele isikutele ja süsteemidele. > **Warning** @@ -239,7 +239,6 @@ Autentimiseks tuleb liidestuval süsteemi läbida järgmised sammud: |Autentimispäringu saatmine /api/authenticate aadressil|Andmeladu valideerib hash võtme, loob sessiooni ja tagastab JWT tokeni, mis kehtib sessiooni pikkuse| |JWT tokeni lisamine igale järgnevale API sõnumile|Andmeladu valideerib JWT tokeni. Kui puudub või kehtetu, siis tagastab veakoodi 401 (unauthorized). Kui valiidne, siis järgneb autoriseerimine, mille kohta loe järgmisest peatükist| - ## API liideses autoriseerimine Iga API päring sisaldab `marketParticipantContext` sektsiooni, kus API sõnumi saatja peab ära defineerima enda rolli ja päringu saatmise eesmärgi. Selle eesmärgiks on luua selge arusaam kes ja milleks sõnumeid saadab ja milline on andmete kasutamise eesmärk. diff --git a/est/03-kliendi-eic.md b/est/03-kliendi-eic.md index 391e83c..ae52d3a 100644 --- a/est/03-kliendi-eic.md +++ b/est/03-kliendi-eic.md @@ -22,21 +22,21 @@ Andmeladu võimaldab registreerida nii Eesti kui ka välismaiseid füüsilisi ja Kliendi andmete edastamiseks ja pärimiseks on loodud vastavad Andmelao teenused. Ettenähtud kasutamise protsess on järgmine: -- Võrguettevõtja saadab uue või muutunud kliendi sõnumi kasutades teenust `customer` +- Võrguettevõtja saadab uue või muutunud kliendi sõnumi kasutades teenust `customer`. - Andmeladu salvestab kliendi andmed ning määrab kliendile EIC koodi. -- Õigustatud kasutaja pärib kliendi andmed `customer/search` teenusest -- Õigustatud kasutaja pärib uute ja muutunud klientide andmete uuendusi kasutades teenust `customer/changes` +- Õigustatud kasutaja pärib kliendi andmed `customer/search` teenusest.. +- Õigustatud kasutaja pärib uute ja muutunud klientide andmete uuendusi kasutades teenust `customer/changes`. ## Masinliidese sõnumid ### Sõnumid -|Sõnum|Eesmärk| -|-----|-------| -|`POST /api/{version}/customer`|Võimaldab registreerida uut klienti.| -|`PUT /api/{version}/customer`|Võimaldab uuendada olemasoleva kliendi andmeid.| -|`POST /api/{version}/customer/search`|Võimaldab otsida registreeritud klienti.| -|`POST /api/{version}/customer/changes`|Võimaldab skaneerida klientide andmete uuendusi.| +| Sõnum | Eesmärk | +|----------------------------------------|--------------------------------------------------| +| `POST /api/{version}/customer` | Võimaldab registreerida uut klienti. | +| `PUT /api/{version}/customer` | Võimaldab uuendada olemasoleva kliendi andmeid. | +| `POST /api/{version}/customer/search` | Võimaldab otsida registreeritud klienti. | +| `POST /api/{version}/customer/changes` | Võimaldab skaneerida klientide andmete uuendusi. | Sõnumite struktuuride ja validatsioonide kirjeldused on leitavad [Swagger](https://test-datahub.elering.ee/swagger-ui/index.html) keskkonnast. @@ -45,25 +45,25 @@ Sõnumite struktuuride ja validatsioonide kirjeldused on leitavad [Swagger](http ### Sõnumite reeglid -- Kliendi andmeid on lubatud lisada või muuta ainult võrguettevõtjal +- Kliendi andmeid on lubatud lisada või muuta ainult võrguettevõtjal. - Kui uue kliendi registreerimisel tuvastab Andmeladu, kas antud isik juba eksisteerib süsteemis: - - kui eksisteerib, siis tagastab Andmeladu sõnumi saatjale olemasoleva isiku EIC koodi ja kui sõnumis oli uusi andmeid, siis uuendab need (nt nimi) - - kui isikut veel ei eksisteeri, siis loob uue isiku, omistab EIC koodi ja tagastab EIC koodi + - Kui eksisteerib, siis tagastab Andmeladu sõnumi saatjale olemasoleva isiku EIC koodi ja kui sõnumis oli uusi andmeid, siis uuendab need (nt nimi). + - Kui isikut veel ei eksisteeri, siis loob uue isiku, omistab EIC koodi ja tagastab EIC koodi. - Füüsilise isiku lisamisel või muutmisel järgmised andmed kohustuslikud: - - ees- ja perenimi - - riik - - isikukood, kui riigi väärtust on Eesti - - dokumendi number kui riigi väärtus ei ole Eesti ja isikukood puudub + - ees- ja perenimi; + - riik; + - isikukood, kui riigi väärtust on Eesti; + - dokumendi number kui riigi väärtus ei ole Eesti ja isikukood puudub. - Juriidilise isiku lisamisel või muutmisel järgmised andmed kohustuslikud: - - nimetus - - riik - - Äriregistri kood, kui riigi väärtus on Eesti ja tegu ei ole saatkonnaga - - Muu identifikaator, kui tegu on välismaise ettevõttega või saatkonnaga -- Eesti isikukoodi puhul rakendub formaadi kontroll -- Välismaiste isikukoodide puhul formaadi kontrolli ei rakendu -- Riigi väärtuse edastamiseks kasutatakse [ISO standardi](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) 2-tähelisi koode + - nimetus; + - riik; + - Äriregistri kood, kui riigi väärtus on Eesti ja tegu ei ole saatkonnaga; + - Muu identifikaator, kui tegu on välismaise ettevõttega või saatkonnaga. +- Eesti isikukoodi puhul rakendub formaadi kontroll. +- Välismaiste isikukoodide puhul formaadi kontrolli ei rakendu. +- Riigi väärtuse edastamiseks kasutatakse [ISO standardi](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) 2-tähelisi koode. - Uue kliendi registreerimisel peab `customerType + identityType + identityValue + extensionType(COUNTRY)` kombinatsioon peab olema unikaalne. Kui ei ole, siis on tegu olemasoleva kliendiga ning süsteem kohtleb lisamise päringut kui kliendi andmete uuendamise päringuna ning võimalusel uuendab kliendi andmed. -- Kliendi otsingu teenus tagastab ainult kliendi EIC koodi juhul, kui andmete pärijal puudub vastav õigus +- Kliendi otsingu teenus tagastab ainult kliendi EIC koodi juhul, kui andmete pärijal puudub vastav õigus. > **Note** > Andmete saatmise ja pärimise õigused on kirjeldatud dokumendis [Autentimine ja autoriseerimine](02-autentimine-ja-autoriseerimine.md) diff --git a/est/04-mootepunktid.md b/est/04-mootepunktid.md index 74c87bc..add137a 100644 --- a/est/04-mootepunktid.md +++ b/est/04-mootepunktid.md @@ -20,20 +20,21 @@ Mõõtepunkt on seade, mis mõõdab energia tarbimise ja tootmise koguseid teatud asukohas. Andmeladu võimaldab registreerida kolme tüüpi mõõtepunkte: + 1. Elektri mõõtepunkt; 2. Gaasi mõõtepunkt; 3. Agregeerimise mõõtepunkt; Mõõtepunkte haldavad järgmised turuosalised: -- võrguettevõtja -- liinioperaator -- suletud jaotusvõrgu ettevõtja -- agregaator -- tootja -- laadimispunkti operaator -- salvestusjaama operaator -- gaasitankla operaator +- võrguettevõtja; +- liinioperaator; +- suletud jaotusvõrgu ettevõtja; +- agregaator; +- tootja; +- laadimispunkti operaator; +- salvestusjaama operaator; +- gaasitankla operaator. Käesolevas dokumendis nimetatakse neid ühisnimetajaga **Mõõtepunkti haldur**. @@ -45,9 +46,9 @@ Mõõtepunkti andmestik sisaldab järgmist teavet: 2. mõõtepunkti tüüp (virtuaalne, kaugloetav, kohtloetav); 3. energia tüüp (elekter või gaas) 4. mõõtepunkti asukoha aadress; -5. elektrimõõtepunkti metaandmestik -6. gaasimõõtepunkti metaandmestik -7. agregeerimismõõtepunkti metaandmestik +5. elektrimõõtepunkti metaandmestik; +6. gaasimõõtepunkti metaandmestik; +7. agregeerimismõõtepunkti metaandmestik. > **Warning** > @@ -59,9 +60,8 @@ Mõõtepunkti haldur saab mõõtepunktide tehnilised andmed edastada Andmelattu Mõõtepunkti andmete edastamiseks on loodud vastavad Andmelao teenused. Ettenähtud kasutamise protsess on järgmine: -- Vajadusel kasutab võrguettevõtja eelnevalt teenust `range` et leida vaba EIC kood mõõtepunkti registreerimiseks -- Võrguettevõtja saadab uue või muutunud mõõtepunkti sõnumi kasutades teenust `meter` või `gridagreementmeteringpoint` - +- Vajadusel kasutab võrguettevõtja eelnevalt teenust `range` et leida vaba EIC kood mõõtepunkti registreerimiseks. +- Võrguettevõtja saadab uue või muutunud mõõtepunkti sõnumi kasutades teenust `meter` või `gridagreementmeteringpoint`. ### Veebiliides @@ -72,12 +72,12 @@ Mõõtepunkti andmete edastamiseks on loodud vastavad Andmelao teenused. Ettenä #### Sõnumid -|Sõnum|Eesmärk| -|-----|-------| -|`POST /api/{version}/eic/range`|Võimaldab pärida vaba(d) EIC koodi(d) omale eraldatud vahemikust| -|`POST /api/{version}/meter`|Võimaldab registreerida uue mõõtepunkti| -|`PUT /api/{version}/meter`|Võimaldab uuendada mõõtepunkti andmeid| -|`POST /api/{version}/gridagreementmeteringpoint`|Võimaldab registreerida mõõtepunkti koos võrgulepinguga korraga| +| Sõnum | Eesmärk | Märkus | +|--------------------------------------------------|------------------------------------------------------------------|--------------| +| `POST /api/{version}/eic/range` | Võimaldab pärida vaba(d) EIC koodi(d) omale eraldatud vahemikust | | +| `POST /api/{version}/meter` | Võimaldab registreerida uue mõõtepunkti | | +| `PUT /api/{version}/meter` | Võimaldab uuendada mõõtepunkti andmeid | | +| `POST /api/{version}/gridagreementmeteringpoint` | Võimaldab registreerida mõõtepunkti koos võrgulepinguga korraga | Pole MVP osa | Sõnumite struktuuride ja validatsioonide kirjeldused on leitavad [Swagger](https://test-datahub.elering.ee/swagger-ui/index.html) keskkonnast. @@ -86,11 +86,11 @@ Sõnumite struktuuride ja validatsioonide kirjeldused on leitavad [Swagger](http #### Sõnumite reeglid -- Mõõtepunkti EIC kood peab jääma võrguettevõtja EIC koodide vahemikku -- Piirimõõtepunkt on mõõtepunkt, kus võrguettevõtja on võrguteenuse klient +- Mõõtepunkti EIC kood peab jääma võrguettevõtja EIC koodide vahemikku. +- Piirimõõtepunkt on mõõtepunkt, kus võrguettevõtja on võrguteenuse klient. - Mõõtepunkti resolutsiooni reeglid on energia tüübist sõltuvad: - - Elektri puhul on resolutsioon täiendav info ja ei mõjuta mõõteandmete edastamist tulevikus vaid iseloomustab, kas mõõtepunkt suudab reaalsuses tarbimist mõõta 15 minuti, 1 tunni või lausa päeva täpsusega - - Gaasi puhul on resolutsioon rangelt seotud mõõteandmete resolutsiooniga. Näiteks kui mõõtepunkti resolutsioon on 1 päev, siis peavad ka edastatud mõõteandmed olema resolutsioonis 1 päev + - Elektri puhul on resolutsioon täiendav info ja ei mõjuta mõõteandmete edastamist tulevikus vaid iseloomustab, kas mõõtepunkt suudab reaalsuses tarbimist mõõta 15 minuti või 1 tunni täpsusega või on andmed võrguettevõtja poolt jaotatud ja prognoositud . + - Gaasi puhul on resolutsioon rangelt seotud mõõteandmete resolutsiooniga. Näiteks kui mõõtepunkti resolutsioon on 1 päev, siis peavad ka edastatud mõõteandmed olema resolutsioonis 1 päev. > **Note** > Andmete saatmise ja pärimise õigused on kirjeldatud dokumendis [Autentimine ja autoriseerimine](02-autentimine-ja-autoriseerimine.md) @@ -103,12 +103,12 @@ Sõnumite struktuuride ja validatsioonide kirjeldused on leitavad [Swagger](http #### Sõnumid -|Sõnum|Eesmärk| -|-----|-------| -|`POST /api/{version}/meter/search`|Võimaldab otsida mõõtepunkte mõõtepunkti andmete alusel| -|`POST /api/{version}/meter/search/customer`|Võimaldab otsida mõõtepunkte kliendi andmete alusel| -|`POST /api/{version}/meter/export`|Võimaldab eksportida tingimustele vastavad mõõtepunktid| -|`POST /api/{version}/meter/changes`|Võimaldab skaneerida mõõtepunktide andmete uuendusi.| +| Sõnum | Eesmärk | +|---------------------------------------------|---------------------------------------------------------| +| `POST /api/{version}/meter/search` | Võimaldab otsida mõõtepunkte mõõtepunkti andmete alusel | +| `POST /api/{version}/meter/search/customer` | Võimaldab otsida mõõtepunkte kliendi andmete alusel | +| `POST /api/{version}/meter/export` | Võimaldab eksportida tingimustele vastavad mõõtepunktid | +| `POST /api/{version}/meter/changes` | Võimaldab skaneerida mõõtepunktide andmete uuendusi. | Sõnumite struktuuride ja validatsioonide kirjeldused on leitavad [Swagger](https://test-datahub.elering.ee/swagger-ui/index.html) keskkonnast. @@ -120,6 +120,6 @@ Sõnumite struktuuride ja validatsioonide kirjeldused on leitavad [Swagger](http > **Note** > Andmete saatmise ja pärimise õigused on kirjeldatud dokumendis [Autentimine ja autoriseerimine](02-autentimine-ja-autoriseerimine.md) -1. Kui andmete pärijal puudub vajalik kliendi andmete nägemise õigus, siis otsingu teenus tagastab ainult EIC koodi. -2. Andmeladu väljastab mõõtepunkti andmed ilma aadressita, kui teostatakse võrgueeskirja §8 lg 5 järgset kontrolli. -3. Ligipääsuõiguste olemasolul väljastab Andmeladu kogu mõõtepunkti andmestiku +- Kui andmete pärijal puudub vajalik kliendi andmete nägemise õigus, siis otsingu teenus tagastab ainult EIC koodi. +- Andmeladu väljastab mõõtepunkti andmed ilma aadressita, kui teostatakse võrgueeskirja §8 lg 5 järgset kontrolli. +- Ligipääsuõiguste olemasolul väljastab Andmeladu kogu mõõtepunkti andmestiku. diff --git a/est/05-lepingud.md b/est/05-lepingud.md index 30487a9..adf12d9 100644 --- a/est/05-lepingud.md +++ b/est/05-lepingud.md @@ -16,12 +16,12 @@ Süsteem võimaldab lisada järgmisi lepinguid: -- Võrguleping -- Avatud tarne leping -- Agregeerimisleping -- Portfellileping (siia kuulub ka bilansileping) -- Nimetatud tarnija leping -- Ühisarve leping +- võrguleping; +- avatud tarne leping; +- agregeerimisleping; +- portfellileping (siia kuulub ka bilansileping); +- nimetatud tarnija leping; +- ühisarve leping. Erinevatel lepingutel on erinevad reeglid. Lisaks eksisteerivad lepingute omavahelised reeglid stiilis "avatud tarne lepingut ei saa lisada perioodi, kus puudub võrguleping". @@ -39,9 +39,9 @@ Bilansivastutus tagatakse katkematu avatud tarne ahela kaudu alljärgnevas hiera Lepinguid on võimalik Andmelattu edastada nii veebiliidese kui automaatse andmevahetuse sõnumi abil. Lepingu edastamiseks ja pärimiseks on loodud vastavad Andmelao teenused. Ettenähtud kasutamise protsess on järgmine: -- Vastav turuosaline saadab uue või muutunud lepingu sõnumi kasutades teenust `agreement` -- Sõltuvalt lepingu tüübist, osalistest ja muudest andmetest võib Andmeladu teha lisandunud või muutunud lepingu andmed kättesaadavaks `changes` teenuse vahendusel -- Õigustatud kasutaja pärib lepingu andmed `agreement/search` teenusest ning vajadusel ekspordib lepinguid kasutades teenust `agreement/export` +- Vastav turuosaline saadab uue või muutunud lepingu sõnumi kasutades teenust `agreement`. +- Sõltuvalt lepingu tüübist, osalistest ja muudest andmetest võib Andmeladu teha lisandunud või muutunud lepingu andmed kättesaadavaks `changes` teenuse vahendusel. +- Õigustatud kasutaja pärib lepingu andmed `agreement/search` teenusest ning vajadusel ekspordib lepinguid kasutades teenust `agreement/export`. ### Lepingute edastamine veebiliidese abil @@ -84,10 +84,11 @@ Lepingute omavahelised sõltuvused ja reeglid: Muud reeglid: -- Lepingu alguse aeg esitatakse päeva täpsusega, leping hakkab kehtima esitatud päeval kell 00:00; +- Lepingu alguse aeg esitatakse päeva täpsusega, leping hakkab kehtima esitatud päeval kell 00:00. - Lepingu lõpu aeg esitatakse päeva täpsusega, leping lõpeb esitatud päeva südaööl. - Lepingu lõpu kuupäev peab olema hilisem alguskuupäevast. - Lepingu loomine iseendale ei ole lubatud - lepingu teenusepakkuja ja klient ei tohi olla sama. +- Kehtivat ega kehtivuse kaotanud lepingut kustutada (*delete*) ei ole lubatud. Kehtivat lepingut on võimalik sulgeda, uuendades lepingu lõppemise kuupäeva väärtust. > **Note** > Andmete saatmise ja pärimise õigused on kirjeldatud dokumendis [Autentimine ja autoriseerimine](02-autentimine-ja-autoriseerimine.md) diff --git a/est/05.1-portfellileping.md b/est/05.1-portfellileping.md index f1c2993..5bfa91c 100644 --- a/est/05.1-portfellileping.md +++ b/est/05.1-portfellileping.md @@ -34,13 +34,14 @@ Portfellilepingu saab Andmelattu sisestada vaid see avatud tarnija, kes vastava Lepingute teenuste kasutamise ettnähtud protsess on kirjeldatud dokumendis [Lepingud](05-lepingud.md). Järgnevalt on kirjeldatud Andmelao täiendavad tegevused erinevates portfellilepingutega seotud tegevustes: -- Andmeladu teavitab uuest või muutunud portfellilepingust portfellilepingu klienti `changes` teenuse vahendusel +- Andmeladu teavitab uuest või muutunud portfellilepingust portfellilepingu klienti `changes` teenuse vahendusel. - Kui portfellileping on sõlmitud portfelliteenust pakkuva avatud tarnija ja võrguettevõtja vahel, siis Andmeladu registreerib kõigi võrguettevõtja piirmõõtepunktide kohta automaatselt avatud tarne lepingu(d) sellega, kes portfellilepingu edastas. Automaatsete avatud tarne lepingute kehtivusajad on otseses sõltuvuses nii portfelli- kui ka piirimõõtepunkti võrgulepingu kehtivusaegadest põhimõttel, et avatud tarne lepingu kehtivusaeg ei tohi kummasti otsast ületada ei portfelli- ega võrgulepingu kehtivusaegu. Seega portfellilepingute genereerimisel määratakse kehtivusajad järgmiselt: - - alguse kuupäevaks saab portfellilepingu ja piirimõõtepunkti võrgulepingu lõppkuupäevadest suurim - - lõppkuupäevaks saab portfellilepingu ja piirimõõtepunkti võrgulepingu lõppkuupäevadest väikseim + - alguse kuupäevaks saab portfellilepingu ja piirimõõtepunkti võrgulepingu lõppkuupäevadest suurim; + - lõppkuupäevaks saab portfellilepingu ja piirimõõtepunkti võrgulepingu lõppkuupäevadest väikseim. - Portfellilepingu lõppkuupäeva vähendamisel määrab Andmeladu kõikidele automaatselt genereeritud avatud tarne lepingutele sama lõppkuupäeva. +- Portfellilepingu kustutamisel kustutab Andmeladu ka kõik automaatselt genereeritud avatud tarne lepingud. - Portfellilepingu lõppkuupäeva pikendamisel pikendab Andmeladu nende automaatselt genereeritud avatud tarne lepingute lõppkuupäeva, mis olid eelnevalt portfellilepingu kuupäeva vähendamisega seonduvalt automaatselt lühendatud. Pikendamine toimub maksimaalselt portfellilepingu lõppkuupäevani või avatud tarne lepingu algse lõppkuupäevani. -- Kui portfellileping on sõlmitud avatud tarnija ja avatud tarnija vahel, siis automaatseid avatud tarne lepinguid Andmeladu ei registreeri +- Kui portfellileping on sõlmitud avatud tarnija ja avatud tarnija vahel, siis automaatseid avatud tarne lepinguid Andmeladu ei registreeri. ### Masinliidese sõnumid @@ -57,11 +58,10 @@ Lepingute üldreeglid on kirjeldatud dokumendis [Lepingud](05-lepingud.md#sõnum Portfellileping täiendavad reeglid on: -- Lepingu algus tohib olla ainult kuu esimene päev -- Lepingu algus peab olema vähemalt 7 päeva tulevikus -- Lepingu lõpp tohib olla ainult kuu viimane päev -- Lepingu lõpp peab olema vähemalt 7 päeva tulevikus -- Lepingu andmestikus ei tohi olla mõõtepunkte -- Lepingus ei tohi sätestada enneaegse lõpetamise tasu - -Ülemvõrgulepingu lõppemine lõpetab automaatselt tekitatud OS lepingu, aga mitte portfelli lepinu \ No newline at end of file +- Lepingu algus tohib olla ainult kuu esimene päev. +- Lepingu algus peab olema vähemalt 7 päeva tulevikus. +- Lepingu lõpp tohib olla ainult kuu viimane päev. +- Lepingu lõpp peab olema vähemalt 7 päeva tulevikus. +- Lepingu andmestikus ei tohi olla mõõtepunkte. +- Lepingus ei tohi sätestada enneaegse lõpetamise tasu. +- Lepingut ei saa kustutada, kui lepingu kehtivuseni on jäänud vähem kui 7 päeva. diff --git a/est/05.2-vorguleping.md b/est/05.2-vorguleping.md index eedea83..65db225 100644 --- a/est/05.2-vorguleping.md +++ b/est/05.2-vorguleping.md @@ -16,6 +16,10 @@ Võrguleping või võrgu kasutamise leping määrab võrgu kasutamise tingimused Võrguleping sõlmitakse liitumispunkti võrguettevõtja ja turuosalise vahel. Samuti sõlmitakse võrguleping võrguettevõtja ja tema ülem-võrguettevõtja vahel. Näiteks Eleringi ja mõne jaotusvõrgu ettevõtte vahel. Selline piirimõõtepunkti võrguleping omab koosmõjus portfellilepinguga mõju automaatselt genereeritud avatud tarne lepingutele, mille kohta loe täpsemalt dokumendist [Portfellileping](05.1-portfellileping.md) +> **Warning** +> +> Esialgses skoobis tekitatakse automaatsed avatud tarne lepingud ainult portfellilepingu loomisel. Piirimõõtepunkti võrgulepingu loomisel portfellilepingu kontroll ja avatud tarne lepingute automaatne loomine lisandub hiljem. + Võrgu kasutamise leping sõlmitakse liini valdaja või suletud jaotusvõrgu valdaja ja turuosalise vahel. ## Võrgulepingute edastamine @@ -24,7 +28,8 @@ Lepingute teenuste kasutamise ettnähtud protsess on kirjeldatud dokumendis [Lep - Lepingu lõppkuupäeva vähendamisel määrab Andmeladu kõikidele seotud avatud tarne ja agregeerimislepingutele võrgulepinguga sama lõppkuupäeva. - Lepingu lõppkuupäeva pikendamisel pikendab Andmeladu nende seotud avatud tarne ja agregeerimislepingute lõppkuupäeva, mis olid eelnevalt võrgulepingu kuupäeva vähendamisega seonduvalt automaatselt lühendatud. Pikendamine toimub maksimaalselt võrgulepingu lõppkuupäevani või avatud tarne lepingu (või agregeerimislepingu) algse lõppkuupäevani. -- Andmeladu teavitab avatud tarnijat ja agregaatorit võrgulepinguga seotud muudatustest kasutades `changes` teenuse funktsionaalsust +- Lepingu kustutamisel (enne kehtima hakkamist) kustutab Andmeladu ka tulevikus kehtima hakkavad avatud tarne ja agregeerimise lepingud. +- Andmeladu teavitab avatud tarnijat ja agregaatorit võrgulepinguga seotud muudatustest kasutades `changes` teenuse funktsionaalsust. ## Masinliidese sõnumid @@ -43,5 +48,5 @@ Võrgulepingu täiendavad reeglid on: - Ühel ajahetkel tohib ühel mõõtepunktil olla ainult 1 kehtiv võrguleping. - Lepingu lõppkuupäeva tohib tagasiulatuvalt muuta ainult juhul, kui see ei mõjuta avatud tarne lepingut. -- Lepingus ei tohi sätestada enneaegse lõpetamise tasu -- Igal võrguettevõtjal peab olema vähemalt 1 võrguleping ülem-võrguettevõtjaga, kus on määratud piirimõõtepunkt +- Lepingus ei tohi sätestada enneaegse lõpetamise tasu. +- Igal võrguettevõtjal peab olema vähemalt 1 võrguleping ülem-võrguettevõtjaga, kus on määratud piirimõõtepunkt. diff --git a/est/05.3-avatud-tarne-leping.md b/est/05.3-avatud-tarne-leping.md index afea1f0..139dfbb 100644 --- a/est/05.3-avatud-tarne-leping.md +++ b/est/05.3-avatud-tarne-leping.md @@ -99,14 +99,15 @@ Avatud tarne lepingu täiendavad reeglid on: - Ühel ajahetkel tohib ühel mõõtepunktil olla ainult 1 kehtiv avatud tarne leping. - Lepingu alguskuupäev peab olema: - - vähemalt üks päev tulevikus, kui puudub eelnev aktiivne avatud tarne leping - - vähemalt 14 päeva tulevikus, kui eksisteerib eelnev aktiivne avatud tarne leping - - sama või hilisem võrreldes võrgulepingu alguskuupäevaga + - vähemalt üks päev tulevikus, kui puudub eelnev aktiivne avatud tarne leping; + - vähemalt 14 päeva tulevikus, kui eksisteerib eelnev aktiivne avatud tarne leping; + - sama või hilisem võrreldes võrgulepingu alguskuupäevaga. - Lepingu alguskuupäev tohib olla kuni 48h minevikus juhul, kui avatud tarnija registreerib avatud tarne lepingut tagantjärele ja lepingu alguskuupäev langeb kokku võrgulepingu alguskuupäevaga. - Lepingu lõppkuupäev peab olema: - - vähemalt 1 päev tulevikus ja vähemalt 1 päev suurem alguskuupäevast - - mitte suurem võrgulepingu (või mitme järjestikkuse võrgulepingu puhul viimase võrgulelepingu) lõppkuupäevast -- Piirmõõtepunktide kohta ei saa avatud tarne lepingut otse lisada. Andmeladu loob ise automaatselt avatud tarne lepingud piirimõõtepunktidesse portfelli lepingu lisamisega. Vaata ka dokumenti [Portfellilepingud](05.1-portfellileping.md) + - vähemalt 1 päev tulevikus ja vähemalt 1 päev suurem alguskuupäevast; + - mitte suurem võrgulepingu (või mitme järjestikkuse võrgulepingu puhul viimase võrgulelepingu) lõppkuupäevast. +- Piirmõõtepunktide kohta ei saa avatud tarne lepingut otse lisada. Andmeladu loob ise automaatselt avatud tarne lepingud piirimõõtepunktidesse portfelli lepingu lisamisega. Vaata ka dokumenti [Portfellilepingud](05.1-portfellileping.md). +- Automaatselt geneeritud avatud tarne lepinguid ei saa API ega kasutajaliidese kaudu ei muuta ega tühistada. ## Avatud tarne lepingute tagasiulatuv sisestamine diff --git a/est/05.4-avatud-tarnija-vahetus.md b/est/05.4-avatud-tarnija-vahetus.md index 1c8b676..90f1175 100644 --- a/est/05.4-avatud-tarnija-vahetus.md +++ b/est/05.4-avatud-tarnija-vahetus.md @@ -81,49 +81,49 @@ Kui turuosalisel ei ole mõõtepunkti kohta sõlmitud avatud tarne lepingut, on 1. Avatud tarnija saab AVPst enne lepingu edastamise infot pärida mõõtepunkti EIC koodi ning kas mõõtepunktis on kehtiv võrguleping ning avatud tarne lepingud (avatud tarnija andmeteta) -|Näide: 05.09.2022 seisuga kehtivate lepingute info|05.09.2022 kell 9.00| -|---|---| -| Avatud tarne leping (Müüja A, nime ei edastata)| 01.01.2022-….| +| Näide: 05.09.2022 seisuga kehtivate lepingute info | 05.09.2022 kell 9.00 | +|----------------------------------------------------------------------------------------------|-----------------------| +| Avatud tarne leping (Müüja A, nime ei edastata) | 01.01.2022-…. | | Avatud tarne leping (Müüja B, nime ei edastata), ennetähtaegse lepingu lõpetamise tasu - JAH | 01.01.2023-31.12.2023 | 2. Avatud tarnija soovib sisestada lepingut alates algusajaga 20.09.2022. **NB,** lepingu sisestamisel tähtajatuna lõpetab Andmeladu kehtivuse nii olemasoleval lepingul kui uuel, mis algab 01.01.2023. Müüja peab veenduma, et on kontrollinud, et kliendile on ennetähtaegse lepingu lõpetamine/tühistamine lubatud/sobiv (müüja saab info AVPst). Kui klient soovib lepingut vaid kuni 31.12.2022, tuleb müüjal vastavalt ka lepinguinfo edastada. Sellisel juhul Andmeladu ei lõpeta lepingut, mis algab 01.01.2023. -|Näide: 05.09.2022 müüja C edastab lepingu 20.09.2022-31.12.2022|05.09.2022| -|---|---| -| Avatud tarne leping (Müüja A)| 01.01.2022-19.09.2022 (lõpetatud Andmelao poolt) | -| Avatud tarne leping (Müüja C)| 20.09.2022-31.12.2022 | -| Avatud tarne leping (Müüja B), ennetähtaegse lepingu lõpetamise tasu - JAH | 01.01.2023-31.12.2023 | +| Näide: 05.09.2022 müüja C edastab lepingu 20.09.2022-31.12.2022 | 05.09.2022 | +|----------------------------------------------------------------------------|--------------------------------------------------| +| Avatud tarne leping (Müüja A) | 01.01.2022-19.09.2022 (lõpetatud Andmelao poolt) | +| Avatud tarne leping (Müüja C) | 20.09.2022-31.12.2022 | +| Avatud tarne leping (Müüja B), ennetähtaegse lepingu lõpetamise tasu - JAH | 01.01.2023-31.12.2023 | Juhul kui müüja edastab tähtajatu uue lepinguinfo, on Andmelaos lepingud järgmised: -|Näide: 05.09.2022 müüja C edastab lepingu 20.09.2022-….| 05.09.2022| -|---|---| -| Avatud tarne leping (Müüja A)| 01.01.2022-19.09.2022 (lõpetatud Andmelao poolt) | -| Avatud tarne leping (Müüja C)| 20.09.2022-…. | -| Avatud tarne leping (Müüja B), ennetähtaegse lepingu lõpetamise tasu - JAH | tühistatud| +| Näide: 05.09.2022 müüja C edastab lepingu 20.09.2022-…. | 05.09.2022 | +|----------------------------------------------------------------------------|--------------------------------------------------| +| Avatud tarne leping (Müüja A) | 01.01.2022-19.09.2022 (lõpetatud Andmelao poolt) | +| Avatud tarne leping (Müüja C) | 20.09.2022-…. | +| Avatud tarne leping (Müüja B), ennetähtaegse lepingu lõpetamise tasu - JAH | tühistatud | #### Tarnijavahetus, võrguleping ei muutu, klient tühistab lepingu 14 päeva jooksul 1. Avatud tarnija saab Andmelaos enne lepingu jõustumist 14p jooksul tühistada avatud tarne lepingu kliendi taotlusest tulenevalt. NB, lepingut ei saa tühistada, kui see on rakendunud. 2. Andmeladu tühistab veel mittejõustunud lepingu ning klient jääb sellisel juhul kas üldteenusele/bilansienergia hinnale või sõlmib vähemalt 1p ette uue avatud tarne lepingu. Tühistamisega Andmeladu ei muuda juba lõpetatud lepingute staatust. -| Näide: 05.09.2022 müüja C edastas lepingu 20.09.2022-31.12.2022. Müüja tühistab lepingu 10.09.2022 | 10.09.2022 | -|---|---| -| Avatud tarne leping (Müüja A)| 01.01.2022-19.09.2022 (lõpetatud Andmelao poolt) | -| Avatud tarne leping (Müüja C)| Tühistatud | -| Avatud tarne leping (Müüja B), ennetähtaegse lepingu lõpetamise tasu - JAH| 01.01.2023-31.12.2023| +| Näide: 05.09.2022 müüja C edastas lepingu 20.09.2022-31.12.2022. Müüja tühistab lepingu 10.09.2022 | 10.09.2022 | +|----------------------------------------------------------------------------------------------------|--------------------------------------------------| +| Avatud tarne leping (Müüja A) | 01.01.2022-19.09.2022 (lõpetatud Andmelao poolt) | +| Avatud tarne leping (Müüja C) | Tühistatud | +| Avatud tarne leping (Müüja B), ennetähtaegse lepingu lõpetamise tasu - JAH | 01.01.2023-31.12.2023 | #### Avatud tarne lepinguta perioodile uue lepingu lisamine, võrguleping ei muutu Kui kliendil ei ole avatud tarne lepingut (päeva lõikes), saab uue avatud tarne lepingu edastada vähemalt 1p ette -| Näide: 11.09.2022 seisuga on Andmelaos järgmise lepingud|11.09.2022| -|---|---| -| Avatud tarne leping (Müüja A) | 01.01.2022-19.09.2022 (lõpetatud Andmelao poolt) | -| Leping algusajaga 20.09.2022 on võimalus edastada kuni 19.09.2022 | Lepingu algusaeg 20.09.2022 | -| Leping algusajaga 21.09.2022 on võimalus edastada kuni 20.09.2022. Sellisel juhul on klient 1p üldteenusel. | Lepingu algusaeg 21.09.2022 | -| Jne | Jne | -| Avatud tarne leping (Müüja B), ennetähtaegse lepingu lõpetamise tasu - JAH | 01.01.2023-31.12.2023 | +| Näide: 11.09.2022 seisuga on Andmelaos järgmise lepingud | 11.09.2022 | +|-------------------------------------------------------------------------------------------------------------|--------------------------------------------------| +| Avatud tarne leping (Müüja A) | 01.01.2022-19.09.2022 (lõpetatud Andmelao poolt) | +| Leping algusajaga 20.09.2022 on võimalus edastada kuni 19.09.2022 | Lepingu algusaeg 20.09.2022 | +| Leping algusajaga 21.09.2022 on võimalus edastada kuni 20.09.2022. Sellisel juhul on klient 1p üldteenusel. | Lepingu algusaeg 21.09.2022 | +| Jne | Jne | +| Avatud tarne leping (Müüja B), ennetähtaegse lepingu lõpetamise tasu - JAH | 01.01.2023-31.12.2023 | #### Avatud tarne lepingu sõlmimine tulenevalt tarbija vahetumisest**, uus võrguleping! diff --git a/est/05.5-nimetatud-tarnija-leping.md b/est/05.5-nimetatud-tarnija-leping.md index 2256e70..ee1ef7b 100644 --- a/est/05.5-nimetatud-tarnija-leping.md +++ b/est/05.5-nimetatud-tarnija-leping.md @@ -39,9 +39,11 @@ Lepingute üldreeglid on kirjeldatud dokumendis [Lepingud](05-lepingud.md#sõnum Nimetatud tarnija lepingu täiendavad reeglid on: -- Lepingu algus tohib olla ainult kuu esimene päev -- Lepingu algus peab olema vähemalt 7 päeva tulevikus -- Lepingu lõpp tohib olla ainult kuu viimane päev -- Lepingu lõpp peab olema vähemalt 7 päeva tulevikus -- Lepingu andmestikus ei tohi olla mõõtepunkte -- Lepingus ei tohi sätestada enneaegse lõpetamise tasu +- Lepingu algus tohib olla ainult kuu esimene päev. +- Lepingu algus peab olema vähemalt 7 päeva tulevikus. +- Lepingu lõpp tohib olla ainult kuu viimane päev. +- Lepingu lõpp peab olema vähemalt 7 päeva tulevikus. +- Lepingu andmestikus ei tohi olla mõõtepunkte. +- Lepingus ei tohi sätestada enneaegse lõpetamise tasu. +- Kehtivat lepingut ei saa kustutada. +- Lepingut ei saa kustutada, kui lepingu kehtivuseni on jäänud vähem kui 7 päeva. diff --git a/est/05.7-yhisarve-leping.md b/est/05.7-yhisarve-leping.md index 815525f..600a80c 100644 --- a/est/05.7-yhisarve-leping.md +++ b/est/05.7-yhisarve-leping.md @@ -41,9 +41,10 @@ Lepingute üldreeglid on kirjeldatud dokumendis [Lepingud](05-lepingud.md#sõnum Ühisarve lepingu täiendavad reeglid on: -- Lepingu algus tohib olla ainult kuu esimene päev -- Lepingu algus peab olema vähemalt 7 päeva tulevikus -- Lepingu lõpp tohib olla ainult kuu viimane päev -- Lepingu lõpp peab olema vähemalt 7 päeva tulevikus -- Lepingu andmestikus ei tohi olla mõõtepunkte -- Lepingus ei tohi sätestada enneaegse lõpetamise tasu +- Lepingu algus tohib olla ainult kuu esimene päev. +- Lepingu algus peab olema vähemalt 7 päeva tulevikus. +- Lepingu lõpp tohib olla ainult kuu viimane päev. +- Lepingu lõpp peab olema vähemalt 7 päeva tulevikus. +- Lepingu andmestikus ei tohi olla mõõtepunkte. +- Lepingus ei tohi sätestada enneaegse lõpetamise tasu. +- Lepingut ei saa kustutada, kui lepingu kehtivuseni on jäänud vähem kui 7 päeva. diff --git a/est/05.8-kooskolastusega-lepingute-muudatused.md b/est/05.8-kooskolastusega-lepingute-muudatused.md index 71b7676..c813a27 100644 --- a/est/05.8-kooskolastusega-lepingute-muudatused.md +++ b/est/05.8-kooskolastusega-lepingute-muudatused.md @@ -17,30 +17,34 @@ Vastavalt ärireeglitele on teatud lepingute sisestamisel või muutmisel vaja ee Selliste tegevuste tarbeks on loodud eraldi teenused, mis kooskõlastamise protsessi toetavad. +> **Warning** +> +> Kogu käesolevas dokumendis kirjeldatud funktsionaalsus on esialgsest skoobist välja arvatud. + ## Lepingute tagasiulatuv sisestamine (algus- või lõppkuupäeva muudatused) ### Avatud tarne lepingud Avatud tarne lepingute tagasiulatuvate muudatuste sisestamiseks on vajalik olemasoleva avatud tarnija, võrguettevõtja ja võrguettevõtja bilansihalduri kooskõlastus. Kooskõlastusi korjatakse kõikidelt korraga ja paralleelselt. Järgnevalt on toodud sõnumite kirjeldused, näited ja reeglid -1. Avatud tarnija sisestab taotluse muuta avatud tarne lepingu algus- või lõppkuupäeva; +1. Avatud tarnija sisestab taotluse muuta avatud tarne lepingu algus- või lõppkuupäeva. 2. Taotlus määratakse kooskõlastuseks järgmistele turuosalistele: - - mõõtepunkti avatud tarnijale – ainult juhul kui mõõtepunktis on kliendil avatud tarne leping - - mõõtepunkti avatud tarnija bilansihaldurile – ainult juhul kui mõõtepunktis on kliendil avatud tarne leping (ja see avatud tarnija ise ei ole bilansihaldur) + - mõõtepunkti avatud tarnijale – ainult juhul kui mõõtepunktis on kliendil avatud tarne leping; + - mõõtepunkti avatud tarnija bilansihaldurile – ainult juhul kui mõõtepunktis on kliendil avatud tarne leping (ja see avatud tarnija ise ei ole bilansihaldur); - mõõtepunkti võrguettevõtjale või tema nimetatud müüjale; - - võrguettevõtja või tema nimetatud müüja bilansihaldurile (ainult juhul kui nimetatud müüja puhul ei ole see nimetatud müüja ise bilansihalduriks); + - võrguettevõtja või tema nimetatud müüja bilansihaldurile (ainult juhul kui nimetatud müüja puhul ei ole see nimetatud müüja ise bilansihalduriks). 3. Eelmainitud kooskõlastuste ja muude tarnijavahetuse tingimuste vastavusel Andmeladu kinnitab muudatuse automaatselt. ## Masinliidese sõnumid ### Sõnumid -|Sõnum|Eesmärk| -|-----|-------| -|`POST /api/{version}/agreement-coordination`|Võimaldab registreerida uut taotlust.| -|`DELETE /api/{version}/agreement-coordination`|Võimaldab tühistada olemasoleva taotluse.| -|`POST /api/{version}/agreement-coordination/search`|Võimaldab otsida ja leida kooskõlastamisele suunatud taotlusi.| -|`POST /api/{version}/agreement-coordination/response`|Võimaldab lisada kooskõlastuse vastuse.| +| Sõnum | Eesmärk | +|-------------------------------------------------------|----------------------------------------------------------------| +| `POST /api/{version}/agreement-coordination` | Võimaldab registreerida uut taotlust. | +| `DELETE /api/{version}/agreement-coordination` | Võimaldab tühistada olemasoleva taotluse. | +| `POST /api/{version}/agreement-coordination/search` | Võimaldab otsida ja leida kooskõlastamisele suunatud taotlusi. | +| `POST /api/{version}/agreement-coordination/response` | Võimaldab lisada kooskõlastuse vastuse. | Sõnumite struktuuride ja validatsioonide kirjeldused on leitavad [Swagger](https://test-datahub.elering.ee/swagger-ui/index.html) keskkonnast. @@ -49,10 +53,10 @@ Sõnumite struktuuride ja validatsioonide kirjeldused on leitavad [Swagger](http ### Sõnumite reeglid -- Taotluse lisamisel on põhjenduse lisamine kohustuslik -- Kooskõlastusest keeldumise korral on põhjenduse lisamine kohustuslik -- Kooskõlastust ei saa anda tühistatud taotlusele -- Esimene kooskõlastusest keeldumine lõpetab kooskõlastuse protsessi ja järgmiste kooskõlastusvastuste saatmine pole enam võimalik +- Taotluse lisamisel on põhjenduse lisamine kohustuslik. +- Kooskõlastusest keeldumise korral on põhjenduse lisamine kohustuslik. +- Kooskõlastust ei saa anda tühistatud taotlusele. +- Esimene kooskõlastusest keeldumine lõpetab kooskõlastuse protsessi ja järgmiste kooskõlastusvastuste saatmine pole enam võimalik. > **Note** > Andmete saatmise ja pärimise õigused on kirjeldatud dokumendis [Autentimine ja autoriseerimine](02-autentimine-ja-autoriseerimine.md) diff --git a/est/06-yldteenuse-teavitus.md b/est/06-yldteenuse-teavitus.md index 90d7484..543fb90 100644 --- a/est/06-yldteenuse-teavitus.md +++ b/est/06-yldteenuse-teavitus.md @@ -13,7 +13,7 @@ Võrguettevõtjale edastatakse infot kõikide lisatud ja muudetud avatud tarne l Üldteenuse rakendumisel sõltub edasine andmevahetuse sellest, kas võrguettevõtjal on sõlmitud nimetatud tarnija leping või mitte: -- Kui ei ole, siis täiendavat andmevahetust pole ette nähtud; +- Kui ei ole, siis täiendavat andmevahetust pole ette nähtud. - Kui on, siis Andmeladu võimaldab võrguettevõtjale saata nimetatud tarnijale sõnumit selle kohta, et turuosalisele rakendub üldteenus. Tasub tähele panna, et antud protsessi on Andmeladu lihtsalt sõnumivahendaja ning selle liidese kasutamine on vabatahtlik. Käesolev dokument kirjeldab teenust, millega nimetatud tarnijat üldteenuse rakendumisest teavitatakse. @@ -21,4 +21,4 @@ Käesolev dokument kirjeldab teenust, millega nimetatud tarnijat üldteenuse rak ## Üldteenuse teavituse edastamine > **Note** -> Teenused on väljatöötamisel \ No newline at end of file +> Teenused on väljatöötamisel diff --git a/est/10-bilansipiirkond.md b/est/10-bilansipiirkond.md index d9bc09f..eb6242a 100644 --- a/est/10-bilansipiirkond.md +++ b/est/10-bilansipiirkond.md @@ -22,36 +22,36 @@ Bilansihaldurile kohanduvad Andmelaos avatud tarnija õigused ja kohustused. Bil Bilansihalduri bilansipiirkond on Andmelaos bilansihaldurile nähtav järgmiselt: -1. Mõõtepunkti EIC kood -2. Kliendi EIC kood -3. Mõõtepunkti võrguoperaatori EIC kood -4. Võrguoperaatori bilansihalduri EIC kood -5. Kui mõõtepunkt on bilansihalduri tarneahelas: mõõtepunktis avatud tarnija EIC kood ja bilansihalduri EIC kood -6. Kui mõõtepunkt ei ole bilansihalduri tarneahelas: mõõtepunktis avatud tarnija ja bilansihaldur ei ole nähtavad +1. Mõõtepunkti EIC kood. +2. Kliendi EIC kood. +3. Mõõtepunkti võrguoperaatori EIC kood. +4. Võrguoperaatori bilansihalduri EIC kood. +5. Kui mõõtepunkt on bilansihalduri tarneahelas: mõõtepunktis avatud tarnija EIC kood ja bilansihalduri EIC kood. +6. Kui mõõtepunkt ei ole bilansihalduri tarneahelas: mõõtepunktis avatud tarnija ja bilansihaldur ei ole nähtavad. 7. Periood (avatud tarne lepingu algus- ja lõpuaeg). Bilansihaldur saab Andmelaost mõõteandmed järgmiselt: -1. Mõõteandmed nendest mõõtepunktidest, mis on elektrilepingute alusel bilansihalduri avatud tarne ahelas -2. Kui võrguettevõtja piirimõõtepunktid on selle bilansihalduri bilansipiirkonna piirimõõtepunktid, saadakse mõõteandmed samuti nendest piirimõõtepunktidest +1. Mõõteandmed nendest mõõtepunktidest, mis on elektrilepingute alusel bilansihalduri avatud tarne ahelas. +2. Kui võrguettevõtja piirimõõtepunktid on selle bilansihalduri bilansipiirkonna piirimõõtepunktid, saadakse mõõteandmed samuti nendest piirimõõtepunktidest. 3. Summeeritult mõõteandmed võrguettevõtja piirkonnas olevate mõõtepunktide kohta, mis on teiste bilansihaldurite portfellides. Raport edastatakse eelmise perioodi andmetega kell 10.30 bilansihalduri poolt Andmelaos märgitud aadressile. ## Bilansipiirkonna sõnum Kasutatakse bilansihaldurile ja süsteemihaldurile bilansihalduri piirkonnas toimunud muudatuste edastamiseks. Bilansipiirkonna muudatussõnumi genereerimise ja edastamise protsess on järgmine: -- Andmelaos registreeritakse uus võrgu- või avatud tarne või portfellileping VÕI olemasolev võrgu- või avatud tarne või portfellileping lõppeb -- Andmeladu arvutab kord ööpäevas viimase ööpäeva bilansimuudatused (mõõtepunkti sisenemine või väljumine bilansipiirkonnast) -- Andmeladu koostab kell 00:05 bilansimuudatuste sõnumi ja teeb selle kättesaadavaks selle vastava(te)le bilansihalduri(te)le, kelle bilansipiirkonnas muudatused toimusid `changes` teenuse kaudu. Loe täpsemalt peatükist [Andmete levitamine](30-andmete-levitamine.md). Sõnum sisaldab uusi mõõtepunkte bilansipiirkonnas *(ADDED)* või bilansipiirkonnast välja arvatud mõõtepunkte *(REMOVED)* +- Andmelaos registreeritakse uus võrgu- või avatud tarne või portfellileping VÕI olemasolev võrgu- või avatud tarne või portfellileping lõppeb. +- Andmeladu arvutab kord ööpäevas viimase ööpäeva bilansimuudatused (mõõtepunkti sisenemine või väljumine bilansipiirkonnast). +- Andmeladu koostab kell 00:05 bilansimuudatuste sõnumi ja teeb selle kättesaadavaks selle vastava(te)le bilansihalduri(te)le, kelle bilansipiirkonnas muudatused toimusid `changes` teenuse kaudu. Loe täpsemalt peatükist [Andmete levitamine](30-andmete-levitamine.md). Sõnum sisaldab uusi mõõtepunkte bilansipiirkonnas *(ADDED)* või bilansipiirkonnast välja arvatud mõõtepunkte *(REMOVED)*. ### Masinliidese sõnumid ### Sõnumid -| Sõnum | Eesmärk | -|-------|---------| -|`POST /api/{version}/balance-state/changes` | Võimaldab skaneerida bilansipiirkonna muudatusi | -|`POST /api/{version}/balance-state/search` | Võimaldab otsida soovitud perioodi bilansipiirkonna seisu | +| Sõnum | Eesmärk | +|---------------------------------------------|-----------------------------------------------------------| +| `POST /api/{version}/balance-state/changes` | Võimaldab skaneerida bilansipiirkonna muudatusi | +| `POST /api/{version}/balance-state/search` | Võimaldab otsida soovitud perioodi bilansipiirkonna seisu | ### Sõnumi reeglid @@ -68,4 +68,4 @@ Bilansihalduritele edastatakse summeeritud mõõteandmeid, et bilansihaldurid sa ### Masinliidese sõnumid > **Note** -> Teenused on väljatöötamisel \ No newline at end of file +> Teenused on väljatöötamisel diff --git a/est/11-ligipaasuoigus.md b/est/11-ligipaasuoigus.md index 699e027..1010fd0 100644 --- a/est/11-ligipaasuoigus.md +++ b/est/11-ligipaasuoigus.md @@ -22,21 +22,21 @@ Andmetele ligipääsu õigus võib tuleneda ka seadusest. Ligipääsuõiguse andmete edastamiseks ja pärimiseks on loodud vastavad Andmelao teenused. Ettenähtud kasutamise protsess on järgmine: -1. Turuosaline lisab uue ligipääsuõiguse kasutades Kliendiportaali funktsionaalsust -2. Andmeladu salvestab uue ligipääsuõiguse oma andmebaasi ja määrab avatud tarnija, kellele see kättesaadavaks tehakse -3. Avatud tarnija skaneerib `changes` teenust ning tuvastab, et talle on adresseeritud uus ligipääsuõigus +1. Turuosaline lisab uue ligipääsuõiguse kasutades Kliendiportaali funktsionaalsust. +2. Andmeladu salvestab uue ligipääsuõiguse oma andmebaasi ja määrab avatud tarnija, kellele see kättesaadavaks tehakse. +3. Avatud tarnija skaneerib `changes` teenust ning tuvastab, et talle on adresseeritud uus ligipääsuõigus. 4. Pärast ligipääsuõiguse andmist võib avatud tarnija kasutada sõnumeid andmete pärimiseks: - - kliendi andmed - kirjeldatud dokumendis [Kliendid](03-kliendi-eic.md) - - mõõtepunkti andmed - kirjeldatud dokumendis [Mõõtepunktid](04-mootepunktid.md) - - mõõteandmed - kirjeldatud dokumendis [Mõõteandmed](07-mooteandmed.md) + - kliendi andmed - kirjeldatud dokumendis [Kliendid](03-kliendi-eic.md); + - mõõtepunkti andmed - kirjeldatud dokumendis [Mõõtepunktid](04-mootepunktid.md); + - mõõteandmed - kirjeldatud dokumendis [Mõõteandmed](07-mooteandmed.md). ## Masinliidese sõnumid ### Sõnumid -| Sõnum | Eesmärk | -|-------|---------| -| `POST /api/{version}/customer-authorization/search` | Võimaldab otsida ligipääsuõigusi | +| Sõnum | Eesmärk | +|------------------------------------------------------|------------------------------------------------| +| `POST /api/{version}/customer-authorization/search` | Võimaldab otsida ligipääsuõigusi | | `POST /api/{version}/customer-authorization/changes` | Võimaldab skaneerida ligipääsuõiguste uuendusi | ### Sõnumi reeglid @@ -45,5 +45,5 @@ Ligipääsuõiguse andmete edastamiseks ja pärimiseks on loodud vastavad Andmel > Andmete saatmise ja pärimise õigused on kirjeldatud dokumendis [Autentimine ja autoriseerimine](02-autentimine-ja-autoriseerimine.md) - Igal ligipääsuõigusel on algus- ja lõppaeg. Etteantuna on kehtivusaeg 48h, mida ligipääsuõiguse andja saab vähendada. -- Iga ligipääsuõigus sisaldab konkreetset andmete töötlemise eesmärki ja kes on andmete vastutav töötleja +- Iga ligipääsuõigus sisaldab konkreetset andmete töötlemise eesmärki ja kes on andmete vastutav töötleja. - Avatud tarnija ei näe kliendi ligipääsuõigusi teistele avatud tarnijatele. diff --git a/est/12-mooteandmed.md b/est/12-mooteandmed.md index b7eaaf8..4ea768c 100644 --- a/est/12-mooteandmed.md +++ b/est/12-mooteandmed.md @@ -38,13 +38,13 @@ Võrguettevõtja ja liinivaldaja saab mõõteandmed edastada Andmelattu nii veeb Mõõteandmete edastamiseks on loodud vastavad Andmelao teenused. Ettenähtud kasutamise protsess on järgmine: -- Mõõtepunkti haldur saadab uue või muutunud mõõteandmete sõnumi kasutades teenust `meter-data` -- Kuivõrd mõõteandmete töötlemine toimub Andmelaos asünkroonselt, siis esmalt annab Andmeladu kiire vastuse, kas sõnum õnnestus kätte saada või mitte -- Seejärel paneb Andmeladu sõnumi töötluse järjekorda -- Soovi korral kontrollib mõõtepunkti haldur asünkroonse töötluse olekut kasutades teenust `meter-data/status` +- Mõõtepunkti haldur saadab uue või muutunud mõõteandmete sõnumi kasutades teenust `meter-data`. +- Kuivõrd mõõteandmete töötlemine toimub Andmelaos asünkroonselt, siis esmalt annab Andmeladu kiire vastuse, kas sõnum õnnestus kätte saada või mitte. +- Seejärel paneb Andmeladu sõnumi töötluse järjekorda. +- Soovi korral kontrollib mõõtepunkti haldur asünkroonse töötluse olekut kasutades teenust `meter-data/status`. - Kui sõnumi töötlemine õnnestub vigadeta, siis rohkem teavitusi Andmeladu mõõtepunkti haldurile ei edasta. Andmed lisatakse või muudetakse andmebaasis ning Andmeladu teeb mõõteandmete lisandumise või muutumise kättesaadavaks avatud tarnijatele läbi `changes` teenuse. Loe täpsemalt peatükist [Andmete levitamine](30-andmete-levitamine.md). - Kui sõnumi töötlemisel tekivad vead, siis Andmeladu koostab vearaporti ja teeb selle kättesaadavaks mõõtepunkti haldurile läbi `changes` teenuse. Loe täpsemalt peatükist [Andmete levitamine](30-andmete-levitamine.md). -- Mõõtepunkti haldur loeb talle adresseeritud vearaportit ning lahendab selle vastavalt oma sisemisele äriloogikale +- Mõõtepunkti haldur loeb talle adresseeritud vearaportit ning lahendab selle vastavalt oma sisemisele äriloogikale. > **Warning** > @@ -59,9 +59,9 @@ Mõõteandmete edastamiseks on loodud vastavad Andmelao teenused. Ettenähtud ka Mõõteandmete edastamise puhul on oluline aru saada perioodi, resolutsiooni ja positsiooni tähendustest ja omavahelistest seostest: -- **Resolutsioon** määrab mõõteandmete tiheduse: 1 päev, 1 tund või 15 minutit -- **Periood** defineerib ajavahemiku, mille kohta mõõteandmeid edastatakse -- **Positsioon** defineerib pesa ehk sloti, mille kohta mõõteandmed käivad +- **Resolutsioon** määrab mõõteandmete tiheduse: 1 päev, 1 tund või 15 minutit; +- **Periood** defineerib ajavahemiku, mille kohta mõõteandmeid edastatakse; +- **Positsioon** defineerib pesa ehk sloti, mille kohta mõõteandmed käivad. Näiteks kui periood on 3 tundi ja resolutsioon 1 tund, siis tähendab see seda, et andmete edastaja soovib meile saata kolme pesa andmed. Seega eeldab süsteem sõnumis kolme sektsiooni, kus igas sektsioonis on mõõteandmed ja sektsioonide positsioonide väärtused on vastavalt 1, 2 ja 3. @@ -69,12 +69,12 @@ Tehniliselt on küll lubatud ka sellised sõnumid, kus edastatud pesad ei kata #### Sõnumid -|Sõnum|Eesmärk| -|-----|-------| -|`POST /api/{version}/meter-data`|Võimaldab lisada mõõteandmeid| -|`PUT /api/{version}/meter-data`|Võimaldab muuta mõõteandmeid| -|`POST /api/{version}/meter-data/status`|Võimaldab kontrollida asünkroonse töötluse olekut| -|`POST /api/{version}/meter-data/changes`|Võimaldab skaneerida mõõteandmete töötluse vearaporteid| +| Sõnum | Eesmärk | +|------------------------------------------|---------------------------------------------------------| +| `POST /api/{version}/meter-data` | Võimaldab lisada mõõteandmeid | +| `PUT /api/{version}/meter-data` | Võimaldab muuta mõõteandmeid | +| `POST /api/{version}/meter-data/status` | Võimaldab kontrollida asünkroonse töötluse olekut | +| `POST /api/{version}/meter-data/changes` | Võimaldab skaneerida mõõteandmete töötluse vearaporteid | Sõnumite struktuuride ja validatsioonide kirjeldused on leitavad [Swagger](https://test-datahub.elering.ee/swagger-ui/index.html) keskkonnast. @@ -83,11 +83,11 @@ Sõnumite struktuuride ja validatsioonide kirjeldused on leitavad [Swagger](http #### Sõnumite reeglid -- Mõõteandmete ja mõõtepunkti resolutsiooni seose kohta loe täpsemalt dokumendist [Mõõtepunktid](04-mootepunktid.md#sõnumite-reeglid) +- Mõõteandmete ja mõõtepunkti resolutsiooni seose kohta loe täpsemalt dokumendist [Mõõtepunktid](04-mootepunktid.md#sõnumite-reeglid). - Perioodi ajaperioodi väärtus peab olema vastavuses resolutsiooniga. Näiteks: - - kui resolutsioon on 1 tund, siis perioodi alguse kellaaeg peab olema täistund (hh:00) - - kui resolutsioon on 15 minutit, siis perioodi alguse kellaaeg peab olema veerandtund (hh:00, hh:15, hh:30, hh:45) -- perioodi algus esitatakse vasakjoondusega ja perioodi lõpp paremjoondusega. Näiteks 1 tunni mõõteandmete periood esitatakse kujul hh:00 - hh+1:00 (03:00-04:00) + - kui resolutsioon on 1 tund, siis perioodi alguse kellaaeg peab olema täistund (hh:00); + - kui resolutsioon on 15 minutit, siis perioodi alguse kellaaeg peab olema veerandtund (hh:00, hh:15, hh:30, hh:45). +- perioodi algus esitatakse vasakjoondusega ja perioodi lõpp paremjoondusega. Näiteks 1 tunni mõõteandmete periood esitatakse kujul hh:00 - hh+1:00 (03:00-04:00). - Mõõtekogused esitatakse alati kWh-des täpsusega 3 kohta peale koma. - Mõõteandmete suund esitatakse alati mõõtva mõõtepunkti halduri poolt vaadatuna: - in – võrku sisenev energia (tootmine); @@ -111,10 +111,10 @@ Mõõteandmete päringute teostamiseks on järgmised võimalused: #### Sõnumid -|Sõnum|Eesmärk| -|-----|-------| -|`POST /api/{version}/meter-data/search`|Võimaldab otsida mõõteandmeid| -|`POST /api/{version}/meter-data/changes`|Võimaldab skaneerida mõõteandmete muudatusi| +| Sõnum | Eesmärk | +|------------------------------------------|---------------------------------------------| +| `POST /api/{version}/meter-data/search` | Võimaldab otsida mõõteandmeid | +| `POST /api/{version}/meter-data/changes` | Võimaldab skaneerida mõõteandmete muudatusi | Sõnumite struktuuride ja validatsioonide kirjeldused on leitavad [Swagger](https://test-datahub.elering.ee/swagger-ui/index.html) keskkonnast. diff --git a/est/13-vorguteenuse-arve.md b/est/13-vorguteenuse-arve.md index 37c2579..3414cf0 100644 --- a/est/13-vorguteenuse-arve.md +++ b/est/13-vorguteenuse-arve.md @@ -22,24 +22,24 @@ Võrguteenuse koostamise sõnum abil edastab võrguettevõtja info selle kohta, Võrguteenuse arve edastamiseks ja pärimiseks on loodud vastavad Andmelao teenused. Ettenähtud kasutamise protsess on järgmine: -- Võrguettevõtja saadab uue või muutunud võrguteenuse arve sõnumi kasutades teenust `network-bill` -- Võrguettevõtja kustutab vajadusel eksliku arve kasutades teenust `delete` -- Avatud tarnija skaneerib võrguteenuste arvete muudatusi kasutades teenust `changes` -- Avatud tarnija kustutab kättesaadud võrguteenuste arve kasutades teenust `delete` +- Võrguettevõtja saadab uue või muutunud võrguteenuse arve sõnumi kasutades teenust `network-bill`. +- Võrguettevõtja kustutab vajadusel eksliku arve kasutades teenust `delete`. +- Avatud tarnija skaneerib võrguteenuste arvete muudatusi kasutades teenust `changes`. +- Avatud tarnija kustutab kättesaadud võrguteenuste arve kasutades teenust `delete`. -Võrguettevõtja või avatud tarnija võib kasutada `search` teenust Andmelattu salvestatud arvete otsimiseks +Võrguettevõtja või avatud tarnija võib kasutada `search` teenust Andmelattu salvestatud arvete otsimiseks. ## Masinliidese sõnumid ### Sõnumid -|Sõnum|Eesmärk| -|-----|-------| -|`POST /api/{version}/network-bill`|Võimaldab registreerida uut võrguarvet.| -|`PUT /api/{version}/network-bill`|Võimaldab uuendada olemasoleva võrguarve andmeid.| -|`POST /api/{version}/network-bill/search`|Võimaldab otsida registreeritud võrguarvet.| -|`POST /api/{version}/network-bill/changes`|Võimaldab skaneerida võrguarvete muudatusi| -|`POST /api/{version}/network-bill/delete`|Võimaldab eemaldada eksliku või töödeldud võrguarve Andmelaost| +| Sõnum | Eesmärk | +|--------------------------------------------|----------------------------------------------------------------| +| `POST /api/{version}/network-bill` | Võimaldab registreerida uut võrguarvet. | +| `PUT /api/{version}/network-bill` | Võimaldab uuendada olemasoleva võrguarve andmeid. | +| `POST /api/{version}/network-bill/search` | Võimaldab otsida registreeritud võrguarvet. | +| `POST /api/{version}/network-bill/changes` | Võimaldab skaneerida võrguarvete muudatusi | +| `POST /api/{version}/network-bill/delete` | Võimaldab eemaldada eksliku või töödeldud võrguarve Andmelaost | Sõnumite struktuuride ja validatsioonide kirjeldused on leitavad [Swagger](https://test-datahub.elering.ee/swagger-ui/index.html) keskkonnast. @@ -51,6 +51,6 @@ Sõnumite struktuuride ja validatsioonide kirjeldused on leitavad [Swagger](http > **Note** > Andmete saatmise ja pärimise õigused on kirjeldatud dokumendis [Autentimine ja autoriseerimine](02-autentimine-ja-autoriseerimine.md) -- Maksimaalne võrguarve koostamise periood on üks kuu -- Perioodi alguse ja lõpu kuu väärtus peab olema võrdne (juhul, kui avatud tarnija ei vahetu kuu vahetusel, siis võrguettevõtja peab edastama 2 eraldi võrguteenuse arvet) +- Maksimaalne võrguarve koostamise periood on üks kuu. +- Perioodi alguse ja lõpu kuu väärtus peab olema võrdne (juhul, kui avatud tarnija ei vahetu kuu vahetusel, siis võrguettevõtja peab edastama 2 eraldi võrguteenuse arvet). - Juhul kui turuosaline kasutab üldteenust, on võrguteenuste arve edastamine Andmelattu vabatahtlik. diff --git a/est/14-yhisarve.md b/est/14-yhisarve.md index cea8058..3659c9b 100644 --- a/est/14-yhisarve.md +++ b/est/14-yhisarve.md @@ -15,9 +15,9 @@ Ühisarve saatmise eelduseks on ühisarve leping Andmelaos. Loe täpsemalt dokumendist [Lepingud](05-lepingud.md). -Põhimõtteskeem võrguarve liikumiseks on järgmine: Võrguettevõtja > Andmeladu > Müüja > Klient +Põhimõtteskeem võrguarve liikumiseks on järgmine: Võrguettevõtja > Andmeladu > Müüja > Klient. -Vahendatava võrguarve rekvisiidid saadakse e-arve standardist ([Eesti e-arve kirjelduse juhend](https://media.voog.com/0000/0042/1620/files/Eesti_e-arve_kirjelduse_juhend_E_arve_saatmine%20ja%20presenteeerimine%20pangas_ver_1_0.pdf)) +Vahendatava võrguarve rekvisiidid saadakse e-arve standardist ([Eesti e-arve kirjelduse juhend](https://media.voog.com/0000/0042/1620/files/Eesti_e-arve_kirjelduse_juhend_E_arve_saatmine%20ja%20presenteeerimine%20pangas_ver_1_0.pdf)). ## Võrguarve edastamine @@ -25,15 +25,15 @@ Võrguarvet on võimalik edastada nii masinliidese kui ka veebiliidese vahenduse Võrguteenuse arve edastamiseks ja pärimiseks on loodud vastavad Andmelao teenused. Ettenähtud kasutamise protsess on järgmine: -- Võrguettevõtja saadab uue ühisarve võrguteenuse arve sõnumi kasutades teenust `forward-invoice` +- Võrguettevõtja saadab uue ühisarve võrguteenuse arve sõnumi kasutades teenust `forward-invoice`. - Andmeladu kontrollib, et määratud adressaadi ja saatja vahel on kehtiv ühisarve leping ning kas määratud kliendil selles mõõtepunktis on kehtiv avatud tarne leping arve adressaadiga. - - Kui ei ole, siis Andmeladu vastab veateatega - - Kui on, siis Andmeladu salvestab andmed andmebaasi ja teeb andmed kättesaadavaks avatud tarnijale `changes` teenuse vahendusel -- Avatud tarnija skaneerib võrguteenuste arvete muudatusi kasutades teenust `changes` -- Avatud tarnija laeb alla võrguteenuste arve kasutades teenust `download` -- Avatud tarnija kustutab kättesaadud võrguteenuste arve kasutades teenust `delete` + - kui ei ole, siis Andmeladu vastab veateatega; + - kui on, siis Andmeladu salvestab andmed andmebaasi ja teeb andmed kättesaadavaks avatud tarnijale `changes` teenuse vahendusel. +- Avatud tarnija skaneerib võrguteenuste arvete muudatusi kasutades teenust `changes`. +- Avatud tarnija laeb alla võrguteenuste arve kasutades teenust `download`. +- Avatud tarnija kustutab kättesaadud võrguteenuste arve kasutades teenust `delete`. -Võrguettevõtja või avatud tarnija võib kasutada `search` teenust Andmelattu salvestatud arvete otsimiseks +Võrguettevõtja või avatud tarnija võib kasutada `search` teenust Andmelattu salvestatud arvete otsimiseks. ### Veebiliides @@ -44,15 +44,15 @@ Võrguettevõtja või avatud tarnija võib kasutada `search` teenust Andmelattu #### Sõnumid -|Sõnum|Eesmärk| -|-----|-------| -|`POST /api/{version}/forward-invoice`|Võimaldab edastada ühisarve võrguarvet| -|`POST /api/{version}/forward-invoice/search`|Võimaldab otsida edastatud ühisarve võrguarveid| -|`POST /api/{version}/forward-invoice/download`|Võimaldab ühisarve võrguarvet alla laadida| -|`POST /api/{version}/forward-invoice/delete`|Võimaldab eemaldada eksliku või töödeldud võrguarve Andmelaost| -|`POST /api/{version}/forward-invoice/changes`|Võimaldab skaneerida võrguarvete muudatusi| +| Sõnum | Eesmärk | +|------------------------------------------------|----------------------------------------------------------------| +| `POST /api/{version}/forward-invoice` | Võimaldab edastada ühisarve võrguarvet | +| `POST /api/{version}/forward-invoice/search` | Võimaldab otsida edastatud ühisarve võrguarveid | +| `POST /api/{version}/forward-invoice/download` | Võimaldab ühisarve võrguarvet alla laadida | +| `POST /api/{version}/forward-invoice/delete` | Võimaldab eemaldada eksliku või töödeldud võrguarve Andmelaost | +| `POST /api/{version}/forward-invoice/changes` | Võimaldab skaneerida võrguarvete muudatusi | #### Sõnumite reeglid > **Note** -> Andmete saatmise ja pärimise õigused on kirjeldatud dokumendis [Autentimine ja autoriseerimine](02-autentimine-ja-autoriseerimine.md) \ No newline at end of file +> Andmete saatmise ja pärimise õigused on kirjeldatud dokumendis [Autentimine ja autoriseerimine](02-autentimine-ja-autoriseerimine.md) diff --git a/est/20-raportid.md b/est/20-raportid.md index 135e01c..cd7e7bf 100644 --- a/est/20-raportid.md +++ b/est/20-raportid.md @@ -29,10 +29,10 @@ Koondraportid arvutatakse ja edastatakse järgmise ajakavaga: Näide koondmõõteandmete arvutuse aegadest bilansiaruannete jaoks: -|| Jaanuari mõõteandmete koondraport | Veebruari mõõteandmete koondraport | Märtsi mõõteandmete koondraport | -|-|----------------------------------|------------------------------------|---------------------------------| -| Esialgne bilansiaruanne | 08. veebr | 08. märts | 08. aprill | -| Lõplik bilansiaruanne | 1. aprill | 1. mai | 1. juuni | +| | Jaanuari mõõteandmete koondraport | Veebruari mõõteandmete koondraport | Märtsi mõõteandmete koondraport | +|-------------------------|-----------------------------------|------------------------------------|---------------------------------| +| Esialgne bilansiaruanne | 08. veebr | 08. märts | 08. aprill | +| Lõplik bilansiaruanne | 1. aprill | 1. mai | 1. juuni | > **Note** > Raportid arvutatakse kõikidele operaatoritele samal ajal @@ -52,13 +52,13 @@ Kõik raportid sisaldavad ühe kalendrikuu andmeid. Enamus raportid on koostatud Saajad: -- **Võrguettevõtjad** +- **Võrguettevõtjad**. Sagedus: -- Kord ööpäevas toimub D+1 andmete agregeerimine kell 11.00 (saatmine kell 11.00) -- Kord kuus 8. kuupäeval toimub M+1 andmete agregeerimine kell 03.00 (saatmine kell 10.00) -- Kord kuus 1. kuupäeval toimub M+2 ja M+3 andmete agregeerimine kell 03.00 (saatmine kell 07.00) +- Kord ööpäevas toimub D+1 andmete agregeerimine kell 11.00 (saatmine kell 11.00). +- Kord kuus 8. kuupäeval toimub M+1 andmete agregeerimine kell 03.00 (saatmine kell 10.00). +- Kord kuus 1. kuupäeval toimub M+2 ja M+3 andmete agregeerimine kell 03.00 (saatmine kell 07.00). Andmed: @@ -103,6 +103,10 @@ Veergude kirjeldus: ### Avatud tarnija raport +> **Warning** +> +> Avatud tarnija ei ole esialgses skoobis + Saajad: - **Avatud tarnijad** @@ -133,13 +137,21 @@ Veergude kirjeldus: ### Avatud tarnija koondraport +> **Warning** +> +> Avatud tarnija koondraport ei ole esialgses skoobis + Saajad: - **Avatud tarnijad** Sagedus: -- Arvutamise aja (päev ja kellaaeg) seadistab administraator – arvutatakse 1x kalendrikuu alguses eelmise kuu kohta +- Arvutamise aja (päev ja kellaaeg) seadistab administraator – arvutatakse 1x kalendrikuu alguses eelmise kuu kohta. + +Andmed: + +Avatud tarne portfellis olevate avatud tarnijate kuised kogused mõõtepunktide ja klientide lõikes avatud tarne lepingute alusel. Veergude kirjeldus: @@ -174,9 +186,9 @@ Andmed: - koondmõõteandmed võrguettevõtja piiripunktide kaudu võrku sisenenud kogus; - võrguettevõtja võrgust väljunud kogused näidates eraldi summat: - avatud tarnijate summas lõppkogused mõõtepunktide summas, mille kohta on olemas elektri avatud tarne leping - sisse ei arvutata piirimõõtepunkte, kus võrgulepingu kliendiks on teine võrguettevõtja. - - Üldteenus (tavalises mõõtepunktis võrguleping on, aga puudub müügileping) - - Kliendiks teiste võrguettevõtjate summas kogus – piirimõõtepunktide summa võrguettevõtjatele (klient) -- Võrguettevõtja võrgukadu + - Üldteenus (tavalises mõõtepunktis võrguleping on, aga puudub müügileping). + - Kliendiks teiste võrguettevõtjate summas kogus – piirimõõtepunktide summa võrguettevõtjatele (klient). +- Võrguettevõtja võrgukadu. Veergude kirjeldus: @@ -233,7 +245,7 @@ Andmed: - Bilansihalduri + tema portfellis olevate avatud tarnijate bilansiselgituse mõõtepunktide koondandmed, mis arvatakse bilansihalduri bilansiselgituse piirkonda (nn IN mõõtepunktid); - võrguettevõtja bilansihalduri bilansiselgituse portfellist maha arvutatud müük, gaasilepingud teiste bilansihaldurite portfellides (nn OUT piirimõõtepunktid). - Leht „BP_OS“ = Bilansihalduri ja tema portfellis olevate avatud tarnijate bilansiselgituse mõõtepunktide koondandmed, mis arvatakse bilansihalduri bilansiselgituse piirkonda (nn IN bilansiselgituse mõõtepunktid); -- Leht „BP_GO“ = võrguettevõtja bilansihalduri bilansiselgituse portfellist maha arvutatud müük, gaasi müügilepingud teiste bilansihaldurite portfellides (nn OUT bilansiselgituse mõõtepunktid) +- Leht „BP_GO“ = võrguettevõtja bilansihalduri bilansiselgituse portfellist maha arvutatud müük, gaasi müügilepingud teiste bilansihaldurite portfellides (nn OUT bilansiselgituse mõõtepunktid). Veergude kirjeldus: @@ -276,9 +288,8 @@ Sagedus: Andmed: -```diff -- Siit on see sektsioon millegipärast puudub. Oleks viisakas mingil hetkel lisada. @kajali -``` +- Leht „BH_OS_GO“ – bilansihalduri ja tema portfellis olevate avatud tarnijate kogused võrguettevõtjate võrgupiirkondade lõikes. +- Leht „BH_GO_OS_GO“ – bilansihalduri portfellis olevate võrguettevõtjate üldteenusel olevate klientide kogused ning võrgukadude kogused. Veergude kirjeldus: diff --git a/est/21-valja-ja-sisse-lylitamine.md b/est/21-valja-ja-sisse-lylitamine.md index 07f44cd..7d611bf 100644 --- a/est/21-valja-ja-sisse-lylitamine.md +++ b/est/21-valja-ja-sisse-lylitamine.md @@ -14,44 +14,48 @@ Kui Võrguteenuse osutaja ja avatud tarnija on sõlminud ühisarve lepingu, siis saadetakse turuosalisele alati ühisarve (turuosaline ei saa seda valida) ja avatud tarnijal tekib õigus nõuda võrguühenduse väljalülitamist juhul, kui turuosaline ei ole oma ühisarvet tasunud. +> **Warning** +> +> Kogu käesolevas dokumendis kirjeldatud funktsionaalsus on esialgsest skoobist välja arvatud. + ## Väljalülitamise ja sisselülitamise taotlus ja kinnitus Väljalülitamise ja sisselülitamise taotluse ja kinnituse edastamiseks on loodud vastavad Andmelao teenused. Ettenähtud kasutamise protsess on järgmine: -1. Avatud tarnija saadab välja- või sisselülitamise taotluse -2. Andmeladu kontrollib, et määratud adressaadi ja saatja vahel on kehtiv (või on viimase 6 kuu jooksul olnud) ühisarve leping ning kas määratud kliendil selles mõõtepunktis on kehtiv avatud tarne leping saatjaga (või on olnud kehtiv viimase 12 kuu jooksul) ja kas määratud kliendi ja mõõtepunkti kombinatsioonil on kehtiv (või on olnud kehtiv viimase 12 kuu jooksul) võrguleping adresaadiga. - - Kui ei ole, siis Andmeladu vastab veateatega - - Kui on, siis Andmeladu salvestab andmed andmebaasi ja teeb andmed kättesaadavaks võrguettevõtjale `changes` teenuse vahendusel -3. Avatud tarnija vajadusel uuendab taotluse andmeid kasutades `PUT` teenust (selle teenusega saab ka tellimust tühistada) -4. Võrguettevõtja skaneerib välja- või sisselülitamise taotlusi kasutades teenust `changes` +1. Avatud tarnija saadab välja- või sisselülitamise taotluse. +2. Andmeladu kontrollib, et määratud adressaadi ja saatja vahel on kehtiv (või on viimase 6 kuu jooksul olnud) ühisarve leping ning kas määratud kliendil selles mõõtepunktis on kehtiv avatud tarne leping saatjaga (või on olnud kehtiv viimase 12 kuu jooksul) ja kas määratud kliendi ja mõõtepunkti kombinatsioonil on kehtiv (või on olnud kehtiv viimase 12 kuu jooksul) võrguleping adresaadiga: + - kui ei ole, siis Andmeladu vastab veateatega; + - kui on, siis Andmeladu salvestab andmed andmebaasi ja teeb andmed kättesaadavaks võrguettevõtjale `changes` teenuse vahendusel. +3. Avatud tarnija vajadusel uuendab taotluse andmeid kasutades `PUT` teenust (selle teenusega saab ka tellimust tühistada). +4. Võrguettevõtja skaneerib välja- või sisselülitamise taotlusi kasutades teenust `changes`. 5. Võrguettevõtja lisab taotluse olekut kasutades teenust `connection-state/response`. Võimalikud variandid on: - - mõõtepunkti välja- või sisselülitamise plaani võtmine - - mõõtepunkti välja- või sisselülitamisest keeldumine - - mõõtepunkti välja- või sisselülitamine -6. Avatud tarnija skaneerib võrguettevõtja vastuseid kasutades teenust `changes` + - mõõtepunkti välja- või sisselülitamise plaani võtmine; + - mõõtepunkti välja- või sisselülitamisest keeldumine; + - mõõtepunkti välja- või sisselülitamine. +6. Avatud tarnija skaneerib võrguettevõtja vastuseid kasutades teenust `changes`. 7. Võrguettevõtja uuendab taotluse olekut kasutades teenust `connection-state/response`. Võimalikud variandid on: - - mõõtepunkti välja- või sisselülitamise plaani muutumine - - mõõtepunkti välja- või sisselülitamisest keeldumine - - mõõtepunkti välja- või sisselülitamine -8. Avatud tarnija skaneerib võrguettevõtja vastuseid kasutades teenust `changes` + - mõõtepunkti välja- või sisselülitamise plaani muutumine; + - mõõtepunkti välja- või sisselülitamisest keeldumine; + - mõõtepunkti välja- või sisselülitamine. +8. Avatud tarnija skaneerib võrguettevõtja vastuseid kasutades teenust `changes`. ### Masinliidese sõnumid #### Sõnumid -|Sõnum|Eesmärk| -|-----|-------| -|`POST /api/{version}/connection-state`|Võimaldab luua uut välja- või sisselülitamise taotlust| -|`PUT /api/{version}/connection-state`|Võimaldab muuta või tühistada välja- või sisselülitamise taotlust| -|`POST /api/{version}/connection-state/search`|Võimaldab otsida välja- või sisselülitamise taotluse vastust| -|`POST /api/{version}/connection-state/response`|Võimaldab luua uut välja- või sisselülitamise taotluse vastust| -|`PUT /api/{version}/connection-state/response`|Võimaldab muuta välja- või sisselülitamise taotluse vastust| -|`POST /api/{version}/connection-state/changes`|Võimaldab skaneerida välja- või sisselülitamise taotlusi või nende vastuseid| +| Sõnum | Eesmärk | +|-------------------------------------------------|------------------------------------------------------------------------------| +| `POST /api/{version}/connection-state` | Võimaldab luua uut välja- või sisselülitamise taotlust | +| `PUT /api/{version}/connection-state` | Võimaldab muuta või tühistada välja- või sisselülitamise taotlust | +| `POST /api/{version}/connection-state/search` | Võimaldab otsida välja- või sisselülitamise taotluse vastust | +| `POST /api/{version}/connection-state/response` | Võimaldab luua uut välja- või sisselülitamise taotluse vastust | +| `PUT /api/{version}/connection-state/response` | Võimaldab muuta välja- või sisselülitamise taotluse vastust | +| `POST /api/{version}/connection-state/changes` | Võimaldab skaneerida välja- või sisselülitamise taotlusi või nende vastuseid | #### Sõnumite reeglid -- Ühel välja- või sisselülitamise taotlusel saab olla ainult üks vastus. Vastuse muutumist tuleb väljendada vastuse muutmisega -- Välja- või sisselülitamise taotlust on lubatud muuta seniks, kuni võrguettevõtja pole saatnud vastus lõppolekuga (CONNECTED, DISCONNECTED) +- Ühel välja- või sisselülitamise taotlusel saab olla ainult üks vastus. Vastuse muutumist tuleb väljendada vastuse muutmisega. +- Välja- või sisselülitamise taotlust on lubatud muuta seniks, kuni võrguettevõtja pole saatnud vastus lõppolekuga (CONNECTED, DISCONNECTED). > **Note** > Andmete saatmise ja pärimise õigused on kirjeldatud dokumendis [Autentimine ja autoriseerimine](02-autentimine-ja-autoriseerimine.md) diff --git a/est/22-kliendi-poordumiste-vahendus.md b/est/22-kliendi-poordumiste-vahendus.md index fa1572d..f5d6982 100644 --- a/est/22-kliendi-poordumiste-vahendus.md +++ b/est/22-kliendi-poordumiste-vahendus.md @@ -19,18 +19,22 @@ Kliendi pöördumiste vahenduse protsessi eesmärk on klientide võrguteenusega seotud pöördumiste vahendamine elektrimüüjalt võrguettevõtjale. Kliendi pöördumiste vahendus on kasutatav vaid müüja ja võrguettevõtja vaheliste sõnumitena. Kliendi pöördumiste funktsionaalsus sisaldab võrguettevõtjate ja müüjate omavahelist infovahetust standardiseeritud kujul. +> **Warning** +> +> Kogu käesolevas dokumendis kirjeldatud funktsionaalsus on esialgsest skoobist välja arvatud. + ## Kliendi pöördumise edastamine ja vastamine Pöördumisi on võimalik edastada ja vaadata nii masin- kui ka veebiliidese vahendusel. Pöördumiste edastamiseks on loodud vastavad Andmelao teenused. Ettenähtud kasutamise protsess on järgmine: -- Avatud tarnija saadab kliendi pöördumise info kasutades teenust `direct-messages` -- Andmeladu salvestab pöördumise ja teeb selle kättesaadavaks võrguettevõtjale `changes` teenuse vahendusel -- Võrguettevõtja skaneerib `changes` teenust ja saab uued või muutunud pöördumised -- Võrguettevõtja saadab pöördumisele vastuse kasutades teenust `response` -- Andmeladu salvestab vastuse ja teeb selle kättesaadavaks avatud tarnijale `changes` teenuse vahendusel -- Avatud tarnija skaneerib `changes` teenust ja saab uued või muutunud vastused +- Avatud tarnija saadab kliendi pöördumise info kasutades teenust `direct-messages`. +- Andmeladu salvestab pöördumise ja teeb selle kättesaadavaks võrguettevõtjale `changes` teenuse vahendusel. +- Võrguettevõtja skaneerib `changes` teenust ja saab uued või muutunud pöördumised. +- Võrguettevõtja saadab pöördumisele vastuse kasutades teenust `response`. +- Andmeladu salvestab vastuse ja teeb selle kättesaadavaks avatud tarnijale `changes` teenuse vahendusel. +- Avatud tarnija skaneerib `changes` teenust ja saab uued või muutunud vastused. Võrguettevõtja või avatud tarnija võib kasutada `search` teenust Andmelattu salvestatud pöördumiste ja vastuste otsimiseks. @@ -43,18 +47,18 @@ Võrguettevõtja või avatud tarnija võib kasutada `search` teenust Andmelattu #### Sõnumid -|Sõnum|Eesmärk| -|-----|-------| -|`POST /api/{version}/direct-messages`|Võimaldab registreerida uue kliendi pöördumise| -|`PUT /api/{version}/direct-messages`|Võimaldab muuta olemasoleva kliendi pöördumise andmeid. Või tühistada kliendi pöördumise| -|`POST /api/{version}/direct-messages/search`|Võimaldab otsida kliendi pöördumisi ja tagasisidet| -|`POST /api/{version}/direct-messages/response`|Võimaldab registreerida uue kliendi pöördumise tagasiside| -|`PUT /api/{version}/direct-messages/response`|Võimaldab muuta olemasoleva kliendi pöördumise tagasiside andmeid| -|`POST /api/{version}/direct-messages/changes`|Võimaldab skaneerida kliendi pöördumiste ja tagasisidede muudatusi| +| Sõnum | Eesmärk | +|------------------------------------------------|------------------------------------------------------------------------------------------| +| `POST /api/{version}/direct-messages` | Võimaldab registreerida uue kliendi pöördumise | +| `PUT /api/{version}/direct-messages` | Võimaldab muuta olemasoleva kliendi pöördumise andmeid. Või tühistada kliendi pöördumise | +| `POST /api/{version}/direct-messages/search` | Võimaldab otsida kliendi pöördumisi ja tagasisidet | +| `POST /api/{version}/direct-messages/response` | Võimaldab registreerida uue kliendi pöördumise tagasiside | +| `PUT /api/{version}/direct-messages/response` | Võimaldab muuta olemasoleva kliendi pöördumise tagasiside andmeid | +| `POST /api/{version}/direct-messages/changes` | Võimaldab skaneerida kliendi pöördumiste ja tagasisidede muudatusi | #### Sõnumite reeglid -- Pöördumise adressaati Andmeladu ei valideeri. Õigete andmete väärtustamise eest vastutab avatud tarnija +- Pöördumise adressaati Andmeladu ei valideeri. Õigete andmete väärtustamise eest vastutab avatud tarnija. > **Note** > Andmete saatmise ja pärimise õigused on kirjeldatud dokumendis [Autentimine ja autoriseerimine](02-autentimine-ja-autoriseerimine.md) diff --git a/est/30-andmete-levitamine.md b/est/30-andmete-levitamine.md index 38af8b2..97dc590 100644 --- a/est/30-andmete-levitamine.md +++ b/est/30-andmete-levitamine.md @@ -20,8 +20,8 @@ Erinevalt vanast Andmelaost, uus Andmeladu sõnumeid liidestuvatatele osapooltel - liidestunud turuosalise süsteem saadab päringu ning paneb kaasa ajatempli (*timestamp*), millal viimati õnnestus antud andmeobjekti uuendusi edukalt tõmmata. - Andmeladu otsib andmeobjektid, mis on lisandunud või muutunud pärast ajatempli väärtust. -- Andmeladu filtreerib välja need andmeobjektid või andmeobjekti andmed, mida antud olukorras antud turuosalisele väljastada ei tohi -- Andmeladu tagastab uued või muutunud andmeobjektid koos Andmelao poolse ID-ga +- Andmeladu filtreerib välja need andmeobjektid või andmeobjekti andmed, mida antud olukorras antud turuosalisele väljastada ei tohi. +- Andmeladu tagastab uued või muutunud andmeobjektid koos Andmelao poolse ID-ga. Liidestunud turuosalise süsteem skaneerib erinevate andmeobjektide API-d endale sobiva intervalliga võttes arvesse andmeobjektide tekkimise ja muutumise tavapärast sagedust: diff --git a/est/40-migratsioon.md b/est/40-migratsioon.md index 303172d..d11fe3d 100644 --- a/est/40-migratsioon.md +++ b/est/40-migratsioon.md @@ -6,6 +6,7 @@ - [Sisukord](#sisukord) - [Sissejuhatus](#sissejuhatus) - [Andmevahetusliidese teenuste võrdlus](#andmevahetusliidese-teenuste-võrdlus) + - [Lisandunud funktsionaalsus](#lisandunud-funktsionaalsus) ## Sissejuhatus @@ -15,29 +16,45 @@ Käesolev dokument on loodud ajutiseks abivahendiks arendajatele, et aidata neil Uus Andmeladu kasutab kaasaegsemat REST andmevahetusliidest. Sellest tulenevalt muutuvad kõik andmevahetusliidese teenused. Allolev tabel kõrvutab vanad ja uued teenused. -|Vana XML teenus|Kas kuulub MVP skoopi|Uus REST teenus| -|----|----|----| -|RequestCustomerEIC|MVP|`/api/{version}/customer`| -|NotifyMeteringPointData|MVP|`/api/{version}/meter`| -|NotifyGridAgreementChange|MVP|`/api /{version}/agreement`| -|RequestMeteringPointsData|MVP|`/api/{version}/meter/search/customer`| -|NotifySupplyAgreement|MVP|`/api /{version}/agreement`| -|EnergyReport|MVP|`/api/{version}/meter-data`| -|EnergyReportResult|MVP|`/api/{version}/meter-data/status`| -|NetworkBill|MVP|`/api/{version}/network-bill`| -|RequestMeteringDataHistory|MVP|`/api/{version}/meter-data/search`| -|NotifyCustomerAuthorization|MVP|`/api/customer-authorization`| -|CustomerMetadata|MVP|*Teenus on väljatöötamisel*| -|NotifyJointInvoiceAgreement|MVP|`/api/{version}/agreement`| -|NotifyPortfolioAgreement|MVP|`/api /{version}/agreement`| -|NotifyNamedSupplierAgreement|MVP|`/api /{version}/agreement`| -|RequestAgreementCoordination|-|`/api/{version}/agreement-coordination`| -|ReplyAgreementCoordination|-|`/api/{version}/agreement-coordination`| -|ConfirmAgreementCoordination|-|`/api/{version}/agreement-coordination`| -|ForwardInvoice|MVP|`/api/{version}/forward-invoice`| -|RequestConnectionState|-|`/api/{version}/connection-state`| -|ReplyRequestConnectionState|-|`/api/{version}/connection-state`| -|SendMessage|-|`/api/{version}/direct-message`| -|BalanceState|MVP|`/api/{version}/balance-state`| -|AggregatedMeteringDataReport|MVP|*Teenus on väljatöötamisel*| -|Report|-|*Teenus on väljatöötamisel*| +| Vana XML teenus | Kas kuulub MVP skoopi | Uus REST teenus | +|------------------------------|-----------------------|-----------------------------------------| +| RequestCustomerEIC | MVP | `/api/{version}/customer` | +| NotifyMeteringPointData | MVP | `/api/{version}/meter` | +| NotifyGridAgreementChange | MVP | `/api /{version}/agreement` | +| RequestMeteringPointsData | MVP | `/api/{version}/meter/search/customer` | +| NotifySupplyAgreement | MVP | `/api /{version}/agreement` | +| EnergyReport | MVP | `/api/{version}/meter-data` | +| EnergyReportResult | MVP | `/api/{version}/meter-data/status` | +| NetworkBill | MVP | `/api/{version}/network-bill` | +| RequestMeteringDataHistory | MVP | `/api/{version}/meter-data/search` | +| NotifyCustomerAuthorization | MVP | `/api/customer-authorization` | +| CustomerMetadata | MVP | *Teenus on väljatöötamisel* | +| NotifyJointInvoiceAgreement | MVP | `/api/{version}/agreement` | +| NotifyPortfolioAgreement | MVP | `/api /{version}/agreement` | +| NotifyNamedSupplierAgreement | MVP | `/api /{version}/agreement` | +| RequestAgreementCoordination | - | `/api/{version}/agreement-coordination` | +| ReplyAgreementCoordination | - | `/api/{version}/agreement-coordination` | +| ConfirmAgreementCoordination | - | `/api/{version}/agreement-coordination` | +| ForwardInvoice | MVP | `/api/{version}/forward-invoice` | +| RequestConnectionState | - | `/api/{version}/connection-state` | +| ReplyRequestConnectionState | - | `/api/{version}/connection-state` | +| SendMessage | - | `/api/{version}/direct-message` | +| BalanceState | MVP | `/api/{version}/balance-state` | +| AggregatedMeteringDataReport | MVP | *Teenus on väljatöötamisel* | +| Report | - | *Teenus on väljatöötamisel* | + +## Lisandunud funktsionaalsus + +Võrrelded varasema Andmelaoga on uues Andmelaos juba arendatud või arendamisel järgmised uued funktsionaalsused: + +- Lisandunud on uus lepingu tüüp - [Agregeerimisleping](05.6-agregeerimisleping.md). +- Niinimetatud ülem-mõõtepunkti kontseptsioon. +- Mõõteandmete asünkroonne töötlus. +- Asukoha andmetesse on lisandunud ADS-i ADR_ID ja kommentaar. +- Mõõtmise resolutsioonide hulka on lisandunud ka 15min võimekus. +- Uued klienditüübi valikud: ENERGY_STORAGE_UNIT, CHARGING_POINT_OPERATOR. +- Tootmise olemasolu ja tüüp: SOLAR, WIND, HYDRO, BIOGAS, BIOMASS, NATURAL_GAS, OIL_SHALE, OTHER_RENEWABLE, OTHER_NON_RENEWABLE. +- Arvulised väärtused: salvestusvõimsus (storageCapacity), salvestusenergia (storageEnergy), tootmisvõimsus (productionCapacity) ja ülekandevõimsus (transmissionCapacity). +- Ülekandevõrgu alajaam +- Korteriühistu tunnus +- Laadimispunkti tunnus