NB! Dette er foreløpig versjon som kan bli endret etter innspill fra aktørene i bransjen.
| Dato | Versjon | Endring |
|---|---|---|
| 27.10.21 | 0.8 | Init |
DIGINprosjektet 'Nettariff API' jobber med utvikling av en standard for deling av nettariffdata med brukere og tredjepartsaktører i kraftsystemet. Det er ikke innenfor prosjektets mandat å standardisere hvilke nettariffmodeller som skal benyttes.
Hensikten med APIet er å støtte styring ved hjelp av smarthusteknologi og dermed stimulere til økt utnyttelse av fleksibilitet fra sluttbrukere. APIet er ikke ment å brukes til å få et korrekt historisk datagrunnlag for sluttbrukeres nettariff.
Dette betyr for eksempel at APIet leverer ut et GridTariff-objekt med kobling mellom en tariff og et målepunkt som er korrekt på tidspunktet for funksjonskallet. Hvis tidsperioden går lenger tilbake enn startdato for målepunktets kontrakt, så gjenspeiles ikke dette i APIet.
Altså er prishistorikken i responsen koblet til tariffen, ikke målepunktet.
Prosjektet leverer standardiserte skjema, med tilhørende dokumentasjon, for utveksling av nettariffdata. Legg merke til at det er opp til det enkelte nettselskap hvordan APIet skal implementeres, så prosjektet leverer ikke programvare for implementasjon.
Dokumentasjon av beslutninger tatt i DIGINs prosjektgruppe for å lage et standard API for utveksling av Nettariff data for styring/smarthus.
API - Application programming interface
OpenAPI - Standard for API-spesifikasjoner, se referanser.
Konsument/Klient - En applikasjon som konsumerer data fra et API. I denne sammenheng, typisk en 3. partsleverandør som skal hente nettariff data fra en eller flere nettselskap.
Implementasjon/Service - En tjeneste hos et nettselskap som leverer nettariff data etter DIGIN Nettariff spesifikasjonen.
LS - Lavspent nettilknytning
HS - Høyspent nettilknytning
DN - DistribusjonsNett
RN - RegionalNett
Følgende versjoner finnes av DIGIN Nettariff API spesifikasjonen.
| Versjon | Type | Beskrivelse | Kommentar |
|---|---|---|---|
| 1.0 | Offisiell | Offisiell versjon som skal implementeres | Ikke utgitt |
| 0.9 | Arbeid | Arbeidsversjon etter innspill | Ikke utgitt |
| 0.8 | Arbeid | Versjon for innspill fra aktører | Publisert 27.10.2021 |
| 0.7 | Arbeid | Arbeidsversjon | Skal ikke publiseres |
Spesifikasjonen er opprettet ved bruk av standarden OpenAPI, https://www.openapis.org/.
Spesifikasjonen består av 2 json filer.
DiginGridTariffAPI.v0_8.json
Dette er OpenAPI spesifikasjonsfilen. Denne inneholder metoder og skjemadefinisjoner.
gridtariffapi.v0_8.common.schema.json
Inneholder definisjoner for input- og outputobjekter brukt av metoder.
OpenApi json filer kan vises som SWAGGER dokumentasjon. En måte å gjøre dette er å benytte Microsoft Visual Studio Code (gratis).
Importer OpenApi utvidelsen.
Åpne begge json filene i Visual Studio Code.
Velg utvidelsen OpenAPI (Rød sirkel rundt) og trykk på knappen "Show Preview using default render" (Rød sirkel rundt)
Dette vil vise SWAGGER-dokumentasjon som vist i bildet under.
DIGIN leverer ikke en ferdig implementasjon av APIet. DIGIN leverer spesifikasjon for implementasjon.
Spesifikasjonsfilene kan benyttes til å generere klient og service.
OpenAPI, https://www.openapis.org/, nevner flere verktøy som kan benyttes til dette.
Hvis en bruker Microsoft Visual Studio kan en generere en klient.
Dette gjøres i Visual Studio ved å legge til en "Service Reference", velge OpenAPI og så velge filen DiginGridTariffAPI.v0_8.json.
Merk at filene DiginGridTariffAPI.v0_8.json og gridtariffapi.v0_8.common.schema.json må være i samme mappe.
Det finnes open source implementasjoner av tidligere arbeids-versjon av denne spesifikasjonen, som f.eks. Elvias implementasjon:
https://github.com/3lvia/grid-tariff-api
I første versjon av APIet er det kun PULL som støttes, med anbefalt kallfrekvens på én gang per døgn. PUSH vurderes støttet i fremtidige versjoner!
Implementasjon hos nettselskapene eller deres leverandører kan bli "hostet" flere steder og på forskjellige måter.
Det er 3 store skyløsninger: Microsoft Azure, Google Cloud, Amazon Web Services.
Samt nettselskapene eller leverandørene kan "hoste" implementasjonen på lokale "on prem" web servere.
Vi har derfor sett det vanskelig å spesifisere hvilken modell av sikkerhet som kan passe alle.
DIGIN Grid Tariff API kommer med følgende anbefalinger:
- En hver implementasjon bør sikres med autorisering og autentisering av innkommende forespørsler.
Hvordan dette gjøres er opp til hver nettselskap/leverandør. - Alle implementasjoner bør benytte seg av https og bruke et gyldig sertifikat utgitt av godkjent leverandør.
Med dette menes sertifikatet bør være godkjent av en "Certificate Authority, CA" - Alle innkommende forespørsler og implementasjoner/installasjoner bør valideres i henhold til OWASP TOP 10, https://owasp.org/www-project-top-ten
Alle angivelser av dato og tid i spørringer og responser skal være i henhold til Elhubs Edielstandard.
https://dok.elhub.no/ediel/datetime-elements-37751603.html
Intitative, OPEN API. 2021. OPEN API. October. https://www.openapis.org/.
2021. SWAGGER. October. https://swagger.io/.
Visual Studio Code https://code.visualstudio.com/
OWASP https://owasp.org
Elhub Edielstandard. https://dok.elhub.no/ediel/edielstandard-37751483.html
Nettselskapene velger selv hvordan nettariffene bygges opp, innenfor visse rammer.
Fra og med 01.01.2022 endres kravene og i praksis gjelder følgende:
Fastledd:
- Fastleddet skal differensieres etter kundens etterspørsel etter kapasitet/effekt og vil dermed variere for kunder med årsforbruk under 100.000 kWh.
- I praksis vil de fleste tariffene baseres på makstime(r) pr dag eller måned, eller være sikringsbasert.
- Sikringsbasert: nivået på fastleddet er basert på størrelse på hovedsikring.
- Makstimebasert: nivået på fastleddet er basert på de(n) timen(e) i døgnet, også kalt "døgnmaks", eller måneden(e), også kalt "månedsmaks", der forbruket målt i kW(eller kWh/h) er høyest.
Effektledd:
- Effektledd er kun tillatt for bedriftskunder med årsforbruk over 100.000 kWh.
Eksempler på prising av forskjellige tariffer (pris i kr eks mva og forbrukseffekt/elavgift) og link til eksempelfiler:
1. Månedsmaks ("monthlymax" med differensiert fastledd) (priser er inkludert mva og avgifter)
Type: LS kunde < 100.000 kWh
Nettnivå: LS DN
Fastledd (kr/mnd):
0-2 kW: 100,00
2-4 kW: 115,00
4-8 kW: 140,00
8-12 kW: 170,00
12-16 kW: 225,00
> 16 kW: 350,00
Energiledd (øre/kWh):
Vinter dag: 50,58
Vinter natt: 30,58
Sommer dag: 27,85
Sommer natt: 25,85
Link eksempel: https://github.com/DIGINenergi/API-nettleie-for-styring/blob/master/doc/DiginGridTariffAPI.v0_8_meteringpointsgridtariffs_json_output_monthlymax_example1.json
2. Døgnmaks (med differensiert fastledd) (priser er inkludert mva og avgifter)
Type: LS kunde < 100.000 kWh
Nettnivå: LS DN
Fastledd (kr/mnd):
0-2 kW: 100,00
2-4 kW: 115,00
4-8 kW: 140,00
8-12 kW: 170,00
12-16 kW: 225,00
> 16 kW: 350,00
Energiledd (øre/kWh):
Vinter dag: 50,58
Vinter natt: 30,58
Sommer dag: 27,85
Sommer natt: 25,85
Link eksempel: https://github.com/DIGINenergi/API-nettleie-for-styring/blob/master/doc/DiginGridTariffAPI.v0_8_meteringpointsgridtariffs_json_output_dailymax_example1.json
3. Sikringsbasert (med differensiert fastledd) (priser er inkludert mva og avgifter)
Type: LS kunde < 100.000 kWh
Nettnivå: LS DN
Fastledd (kr/mnd):
10 A: 100,00
17 A: 115,00
25 A: 140,00
35 A: 170,00
50 A: 225,00
65 A: 350,00
80 A: 500,00
99 A: 700,00
Energiledd (øre/kWh):
Vinter dag: 50,58
Vinter natt: 30,58
Sommer dag: 27,85
Sommer natt: 25,85
Link eksempel: https://github.com/DIGINenergi/API-nettleie-for-styring/blob/master/doc/DiginGridTariffAPI.v0_8_meteringpointsgridtariffs_json_output_fusesize_example1.json
4. Effekttariff LS DN (priser er oppgitt ekskludert mva og avgifter)
Type: Tariff med effektledd.
Nettnivå: LS DN
Fastledd (kr/mnd): 340.00
Effektledd (kr/kW/mnd):
Aktiv effekt vinter: 120,00
Aktiv effekt sommer: 22,00
Reaktiv effekt vinter: 65,61
Reaktiv effekt sommer: 10,61
Energiledd (øre/kWh):
Vinter: 7,87
Sommer: 3,90
Link eksempel: https://github.com/DIGINenergi/API-nettleie-for-styring/blob/master/doc/DiginGridTariffAPI.v0_8_meteringpointsgridtariffs_json_output_LSDN_example1.json
5. Effekttariff LS DN med differensiert effektledd (priser er oppgitt ekskludert mva og avgifter)
Type: Tariff med effektledd.
Nettnivå: LS DN
Fastledd (kr/mnd): 340,00
Effektledd (kr/kW/mnd):
Aktiv effekt vinter:
0-100 kW : 111,0
over 100 kW: 55,5
Reaktiv effekt vinter: 65,61
Aktiv effekt sommer:
0-100 kW : 50,0
over 100 kW: 25,00
Reaktiv effekt sommer: 10,61
Energiledd (øre/kWh):
Vinter: 7,87
Sommer: 3,90
Link eksempel: https://github.com/DIGINenergi/API-nettleie-for-styring/blob/master/doc/DiginGridTariffAPI.v0_8_meteringpointsgridtariffs_json_output_LSDN_example2.json
Eksempler input:
Input with range parameter: https://github.com/DIGINenergi/API-nettleie-for-styring/blob/master/doc/DiginGridTariffAPI.v0_8_meteringpointsgridtariffs_json_input_example_range.json
Input with startTime and endTime parameters: https://github.com/DIGINenergi/API-nettleie-for-styring/blob/master/doc/DiginGridTariffAPI.v0_8_meteringpointsgridtariffs_json_input_example_startTime_endTime.json