diff --git a/DiginGridTariffAPI.v1_0.json b/DiginGridTariffAPI.v1_0.json new file mode 100644 index 0000000..e34289f --- /dev/null +++ b/DiginGridTariffAPI.v1_0.json @@ -0,0 +1,267 @@ +{ + "openapi": "3.0.2", + "info": { + "title": "Digin Grid Tariff API", + "description": "Provides grid tariffs. For external and internal use. https://github.com/digin-energi/API-nettleie-for-styring", + "version": "1.0", + "contact": { + "name": "Digin Grid Tariff API", + "url": "https://github.com/digin-energi/API-nettleie-for-styring" + } + }, + "servers": [ + { + "url": "/" + } + ], + "components": { + "schemas": { + "TariffQueryRequestMeteringPointsResult": { + "type": "object", + "properties": { + "gridTariffCollections": { + "type": "array", + "items": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/GridTariffCollection" + } + } + } + }, + "TariffQueryRequestMeteringPoints": { + "type": "object", + "$ref": "gridtariffapi.v1_0.common.schema.json#/TariffQueryRequestMeteringPoints", + "additionalProperties": false + }, + "TariffQueryResult": { + "type": "object", + "properties": { + "gridTariff": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/GridTariff" + } + }, + "additionalProperties": false + }, + "TariffTypeContainer": { + "type": "object", + "properties": { + "tariffTypes": { + "type": "array", + "items": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/TariffType" + }, + "nullable": true + } + }, + "additionalProperties": false + } + } + }, + "paths": { + "/api/{v}/tariffquery/meteringpointsgridtariffs": { + "post": { + "tags": [ + "TariffQuery" + ], + "summary": "Returns tariff data for a given set of meteringpoints for a given timeperiod.", + "parameters": [ + { + "description": "The API specification version to be used.", + "name": "v", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "requestBody": { + "description": "MeteringPointIds ditctates which meteringpoints to return tariff data for.

If a meteringpointid is unknown to api it will be omitted from the responseRange dictates which day to query.

Valid values is yesterday,today,tomorrow StartTime/EndTime dictates which timeperiod to query.

Range and StartTime/Endtime is mutual exclusive, meaning either one must be present, but not both. Date time formats using Edielstandard, see README file", + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/TariffQueryRequestMeteringPoints" + } + } + } + }, + "responses": { + "200": { + "description": "TariffData matching query parameters, also including meteringpoints associated with each tariff. Date time formats using Edielstandard, see README file", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/TariffQueryRequestMeteringPointsResult" + } + } + } + }, + "204": { + "description": "No data for given request" + }, + "304": { + "description": "Not modified" + }, + "400": { + "description": "Bad request" + }, + "401": { + "description": "Unauthorized" + }, + "403": { + "description": "Forbidden" + }, + "500": { + "description": "Internal Server Error" + } + } + } + }, + "/api/{v}/tariffquery": { + "get": { + "tags": [ + "TariffQuery" + ], + "summary": "Returns tariff data for a given tariff for a given timeperiod", + "description": "Range and StartTime/Endtime is mutual exclusive, meaning either one must be present, but not bot. Date time formats using Edielstandard, see README file", + "parameters": [ + { + "name": "TariffKey", + "description": "TariffKey dictates which tariff will be queried", + "in": "query", + "required": true, + "schema": { + "maxLength": 100, + "minLength": 0, + "type": "string" + } + }, + { + "name": "Range", + "description": "Range dictates which day to query, valid values is yesterday,today,tomorrow", + "in": "query", + "schema": { + "maxLength": 10, + "minLength": 0, + "pattern": "yesterday|today|tomorrow", + "type": "string", + "nullable": true + } + }, + { + "name": "StartTime", + "in": "query", + "description": "StartTime/EndTime dictates which timeperiod to query.", + "schema": { + "type": "string", + "format": "date-time", + "nullable": true + } + }, + { + "name": "EndTime", + "in": "query", + "description": "StartTime/EndTime dictates which timeperiod to query.", + "schema": { + "type": "string", + "format": "date-time", + "nullable": true + } + }, + { + "name": "v", + "description": "The API specification version to be used.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Ok", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/TariffQueryResult" + } + } + } + }, + "204": { + "description": "No data for given request" + }, + "304": { + "description": "Not modified" + }, + "400": { + "description": "Bad request" + }, + "401": { + "description": "Unauthorized" + }, + "403": { + "description": "Forbidden" + }, + "500": { + "description": "Internal Server Error" + } + } + } + }, + "/api/{v}/tarifftype": { + "get": { + "tags": [ + "TariffType" + ], + "summary": "Service returns all available private tariffs", + "parameters": [ + { + "name": "v", + "description": "The API specification version to be used.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "All tariffs. Date time formats using Edielstandard, see README file", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/TariffTypeContainer" + } + }, + "text/plain": { + "schema": { + "$ref": "#/components/schemas/TariffTypeContainer" + } + }, + "text/json": { + "schema": { + "$ref": "#/components/schemas/TariffTypeContainer" + } + } + } + }, + "400": { + "description": "Bad request" + }, + "401": { + "description": "Unauthorized" + }, + "403": { + "description": "Forbidden" + }, + "500": { + "description": "Internal Server Error" + } + } + } + } + } +} \ No newline at end of file diff --git a/README.md b/README.md index 166bbd4..9b288aa 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,11 @@ # DIGIN Nettariff API
Spesifikasjon -NB! Dette er foreløpig versjon som kan bli endret før v1.0 publiseres. - ## Dokumentversjoner -| Dato | Versjon | Endring | -|-------------|----------------|----------------| -| 27.10.21 | 0.8 | Init | -| 17.11.21 | 0.9 | Soft release | -| | | | +| Dato | Versjon | Endring | +|-------------|----------------|-------------------| +| 27.10.21 | 0.8 | Init | +| 17.11.21 | 0.9 | Soft release | +| 01.12.21 | 1.0 | Offisiell versjon | ## 1. Bakgrunn 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. @@ -20,35 +18,41 @@ 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.
+Denne versjonen av standard for 'Nettariff API' tar ikke hensyn til kunder med redusert elavgift. Disse kundene må selv sørge for å trekke fra sin reduksjon av elavgift for å få korrekte priser. +
+ ## 2. Hensikt med dette dokumentet Dokumentasjon av beslutninger tatt i DIGINs prosjektgruppe for å lage et standard API for utveksling av Nettariff data for styring/smarthus. ## 3. Definisjoner API - Application programming interface
-OpenAPI - Standard for API-spesifikasjoner, se referanser. +DN - DistribusjonsNett
-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. +HS - Høyspent nettilknytning
Implementasjon/Service - En tjeneste hos et nettselskap som leverer nettariff data etter DIGIN Nettariff spesifikasjonen.
+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. +
LS - Lavspent nettilknytning
-HS - Høyspent nettilknytning +MPID - Målepunkt-Id som finnes på faktura fra Nettselskapet eller på Min side (et logisk nummer som ikke er det samme som målernummer)
-DN - DistribusjonsNett +OpenAPI - Standard for API-spesifikasjoner, se referanser.
RN - RegionalNett (NB. DEKKES IKKE AV APIet)
Unique id - En unik id som er garantert unik innenfor responsen fra ett nettselskap. Dette kan være for eksempel en GUID (Global Unique IDentifier) eller et løpenummer som unikt identifiserer elementet i responsen. Denne er ikke garantert unik på tvers av flere nettselskaper.
+ ## 4. Versjoner Følgende versjoner finnes av DIGIN Nettariff API spesifikasjonen. | Versjon | Type | Beskrivelse | Kommentar | |------------------|---------------------|---------------------------------------------|-----------------------| -| 1.0 | Offisiell | Offisiell versjon som skal implementeres| Ikke utgitt | +| 1.0 | Offisiell | Offisiell versjon som skal implementeres| Publisert 01.12.2021 | | 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 | @@ -59,12 +63,12 @@ Spesifikasjonen er opprettet ved bruk av standarden OpenAPI, https://www.openapi Spesifikasjonen består av 2 json filer.

-DiginGridTariffAPI.v0_9.json +DiginGridTariffAPI.v1_0.json
Dette er OpenAPI spesifikasjonsfilen. Denne inneholder metoder og skjemadefinisjoner.

-gridtariffapi.v0_9.common.schema.json +gridtariffapi.v1_0.common.schema.json
Inneholder definisjoner for input- og outputobjekter brukt av metoder.
@@ -87,15 +91,31 @@ Dette vil vise SWAGGER-dokumentasjon som vist i bildet under. DIGIN leverer ikke en ferdig implementasjon av APIet. DIGIN leverer spesifikasjon for implementasjon.

+DiginGridTariffAPI.gridcompany-mapping.json +
+Nettselskap som implementerer Nettariff API melder inn sine MPID-serier, navn på nettselskap, organisasjonsnummer, url til api og url til brukerdokumentasjon eller epost-adresse til DIGIN på epost-adresse digin@energinorge.no. +
+Filen inneholder mapping av MPID (fra - til), nettselskapsnavn, nettselskapets organisasjonsnummer, url til api og url til brukerdokumentasjon eller epost-adresse. +
+https://github.com/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.gridcompany-mapping.json +
+
+GridTariffAPI-3part-registration-and-use-of-api_v1_0.jpg +
+Sekvensdiagram som beskriver rutine for 3.-parts registerering av bruker og utstedelse av api-key. +
+https://github.com/digin-energi/API-nettleie-for-styring/blob/main/doc/GridTariffAPI-3part-registration-and-use-of-api_v1_0.jpg +
+
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_9.json. +Dette gjøres i Visual Studio ved å legge til en "Service Reference", velge OpenAPI og så velge filen DiginGridTariffAPI.v1_0.json.
-Merk at filene DiginGridTariffAPI.v0_9.json og gridtariffapi.v0_9.common.schema.json må være i samme mappe. +Merk at filene DiginGridTariffAPI.v1_0.json og gridtariffapi.v1_0.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: @@ -146,6 +166,17 @@ DIGIN kommer med følgende anbefalinger for implementering av GridTariffAPI: 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 +
+I en tidsperiode, feks angitt av startDate og endDate, så er startDate inkludert og endDate ikke inkludert. Dvs endDate betyr at prisen gjelder inntil denne datoen. +
+Eksempel for en tidsperiode som gjelder hele januar, så angis dette av: +
+startDate = 2022-01-01 +
+endDate = 2022-02-01 +
+Dette gjelder alle tidsperioder med mindre annet er spesifisert. +
## 9. Referanser Intitative, OPEN API. 2021. OPEN API. October. https://www.openapis.org/. @@ -181,40 +212,16 @@ Effektledd:

-Eksempler på prising av forskjellige tariffer (pris i kr eks mva og forbrukseffekt/elavgift) og link til eksempelfiler: +Eksempler på prising av forskjellige tariffer og link til eksempelfiler:

-1. MÃ¥nedsmaks ("monthlymax" med differensiert fastledd) (priser er inkludert mva og avgifter) +1. MÃ¥nedsmaks ("monthlymax" med differensiert fastledd)
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/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_monthlymax_example1.json +Link eksempel: https://github.com/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_monthlymax_example1.json


@@ -224,139 +231,53 @@ Type: LS kunde < 100.000 kWh
Nettnivå: LS DN
-Fastledd (kr/mnd): -
- 0-2 kW: 100,00 -
- 2-4 kW: 115,00 +Link eksempel: https://github.com/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_dailymax_example1.json
- 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/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_dailymax_example1.json -
-
-
-3. Sikringsbasert (med differensiert fastledd) (priser er inkludert mva og avgifter) +3. Sikringsbasert (med differensiert fastledd)
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 +Link eksempel: https://github.com/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_fusesize_example1.json
- Sommer dag: 27,85
- Sommer natt: 25,85
-Link eksempel: https://github.com/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_fusesize_example1.json -
-
-
-4. Effekttariff LS DN (priser er oppgitt ekskludert mva og avgifter) +4. Effekttariff LS DN
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 +Link eksempel: https://github.com/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_LSDN_example1.json
- Sommer: 3,90
-Link eksempel: https://github.com/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_LSDN_example1.json
-
-
-5. Effekttariff LS DN med differensiert effektledd (priser er oppgitt ekskludert mva og avgifter) +5. Effekttariff LS DN med differensiert effektledd
Type: Tariff med effektledd.
Nettnivå: LS DN
-Fastledd (kr/mnd): 340,00 -
-Effektledd (kr/kW/mnd): -
- Aktiv effekt vinter: -
- 0-100 kW : 111,0 +Link eksempel: https://github.com/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_LSDN_example2.json
- over 100 kW: 55,5
- Reaktiv effekt vinter: 65,61
- Aktiv effekt sommer: +6. Effekttariff HS DN med effektledd
- 0-100 kW : 50,0 -
- over 100 kW: 25,00 -
- Reaktiv effekt sommer: 10,61 -
- Energiledd (øre/kWh): -
- Vinter: 7,87 +Type: Tariff med effektledd.
- Sommer: 3,90 +Nettnivå: HS DN
-Link eksempel: https://github.com/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_LSDN_example2.json +Link eksempel: https://github.com/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_HSDN_example1.json


Eksempler input:
-Input with range parameter: https://github.com/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_input_example_range.json +Input with range parameter: https://github.com/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_input_example_range.json
-Input with startTime and endTime parameters: https://github.com/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_input_example_startTime_endTime.json +Input with startTime and endTime parameters: https://github.com/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_input_example_startTime_endTime.json
diff --git a/doc/DiginGridTariffAPI.gridcompany-mapping.json b/doc/DiginGridTariffAPI.gridcompany-mapping.json new file mode 100644 index 0000000..2141407 --- /dev/null +++ b/doc/DiginGridTariffAPI.gridcompany-mapping.json @@ -0,0 +1,22 @@ +{ + "gridTariffGridCompanyMapping": { + "meteringPointRange": [ + { + "meteringPointIdFrom": "70705750000000000", + "meteringPointIdTo": "70705750009999999", + "companyName": "Nettselskap AS", + "companyOrgNo": "900000000", + "apiUrl": "/", + "userDocUrlOrEmail": "/" + }, + { + "meteringPointIdFrom": "70705750010000000", + "meteringPointIdTo": "70705750019999999", + "companyName": "Nettselskap 2 AS", + "companyOrgNo": "900000002", + "apiUrl": "/", + "userDocUrlOrEmail": "/" + } + ] + } +} \ No newline at end of file diff --git a/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_input_example_range.json b/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_input_example_range.json similarity index 100% rename from doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_input_example_range.json rename to doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_input_example_range.json diff --git a/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_input_example_startTime_endTime.json b/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_input_example_startTime_endTime.json new file mode 100644 index 0000000..e4adf0a --- /dev/null +++ b/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_input_example_startTime_endTime.json @@ -0,0 +1,8 @@ +{ + "startTime": "2021-09-17T00:00:00+02:00", + "endTime": "2021-09-17T13:00:00+02:00", + "meteringPointIds": [ + "707057500000000001", + "707057500000000002" + ] +} \ No newline at end of file diff --git a/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_HSDN_example1.json b/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_HSDN_example1.json new file mode 100644 index 0000000..2d398dc --- /dev/null +++ b/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_HSDN_example1.json @@ -0,0 +1,424 @@ +{ + "gridTariffCollections": [ + { + "gridTariff": { + "tariffType": { + "tariffKey": "power_hs_dn", + "product": "BB EL 789", + "companyName": "Nettselskap 4 AS", + "companyOrgNo": "900000003", + "title": "Nettleie høyspent dn", + "consumptionFlag": true, + "lastUpdated": "2021-11-05T00:00:00+01:00", + "usePublicHolidayPrices": false, + "useWeekendPrices": false, + "fixedPriceConfiguration": { + "basis": "fixed", + "maxhoursPerDay": null, + "daysPerMonth": null, + "allDaysPerMonth": null, + "maxhoursPerMonth": null, + "months": null + }, + "powerPriceConfiguration": { + "reactivePowerPricing": true, + "powerFactorPercentage": 50.0000 + }, + "resolution": 60, + "description": "Tariff for high voltage connection in distribution grid" + }, + "tariffPrice": { + "hours": [ + { + "startTime": "2021-09-17T00:00:00+02:00", + "expiredAt": "2021-09-17T01:00:00+02:00", + "shortName": "0000-0100", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T01:00:00+02:00", + "expiredAt": "2021-09-17T02:00:00+02:00", + "shortName": "0100-0200", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T02:00:00+02:00", + "expiredAt": "2021-09-17T03:00:00+02:00", + "shortName": "0200-0300", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T03:00:00+02:00", + "expiredAt": "2021-09-17T04:00:00+02:00", + "shortName": "0300-0400", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T04:00:00+02:00", + "expiredAt": "2021-09-17T05:00:00+02:00", + "shortName": "0400-0005", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T05:00:00+02:00", + "expiredAt": "2021-09-17T06:00:00+02:00", + "shortName": "0500-0600", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T06:00:00+02:00", + "expiredAt": "2021-09-17T07:00:00+02:00", + "shortName": "0600-0700", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T07:00:00+02:00", + "expiredAt": "2021-09-17T08:00:00+02:00", + "shortName": "0700-0800", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T08:00:00+02:00", + "expiredAt": "2021-09-17T09:00:00+02:00", + "shortName": "0800-0900", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T09:00:00+02:00", + "expiredAt": "2021-09-17T10:00:00+02:00", + "shortName": "0900-1000", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T10:00:00+02:00", + "expiredAt": "2021-09-17T11:00:00+02:00", + "shortName": "1000-1100", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T11:00:00+02:00", + "expiredAt": "2021-09-17T12:00:00+02:00", + "shortName": "1100-1200", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T12:00:00+02:00", + "expiredAt": "2021-09-17T13:00:00+02:00", + "shortName": "1200-1300", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + } + ], + "priceInfo": { + "fixedPrices": [ + { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "startDate": "2021-09-17", + "endDate": "2021-09-17", + "priceLevel": [ + { + "id": "edcf53ce-70d3-4fa0-8bfb-e79918335ab7", + "valueMin": null, + "valueMax": null, + "nextIdDown": null, + "nextIdUp": null, + "valueUnitOfMeasure": "kWh/h", + "monthlyTotal": 140.0000, + "monthlyTotalExVat": 112.0000, + "monthlyExTaxes": 112.0000, + "monthlyTaxes": 28.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.1881, + "totalExVat": 0.1504 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.1944, + "totalExVat": 0.1555 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.2011, + "totalExVat": 0.1608 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.2083, + "totalExVat": 0.1666 + } + ], + "levelInfo": "Fixed price component for Nettleie lavspent DS", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + } + ] + } + ], + "powerPrices": [ + { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "startDate": "2021-09-17", + "endDate": "2021-09-17", + "priceLevel": [ + { + "id": "c87bfdc8-a73c-4c93-9a3b-b2558b4aa3c4", + "valueMin": null, + "valueMax": null, + "nextIdDown": null, + "nextIdUp": null, + "valueUnitOfMeasure": null, + "monthlyActivePowerTotal": 27.5000, + "monthlyActivePowerTotalExVat": 22.0000, + "monthlyActivePowerExTaxes": 22.0000, + "monthlyActivePowerTaxes": 5.5000, + "monthlyReactivePowerTotal": 13.2625, + "monthlyReactivePowerTotalExVat": 10.6100, + "monthlyReactivePowerExTaxes": 10.6100, + "monthlyReactivePowerTaxes": 2.6525, + "monthlyUnitOfMeasure": "kr/kW/month", + "hourPrices": [ + { + "id": "d85adcfa-24bd-4561-a0df-ae6b5ce475bc", + "numberOfDaysInMonth": 31, + "activeTotal": 0.0369, + "activeTotalExVat": 0.0295, + "reactiveTotal": 0.0178, + "reactiveTotalExVat": 0.0142 + }, + { + "id": "27134fc2-514d-479e-aedb-f13fc4f087d1", + "numberOfDaysInMonth": 30, + "activeTotal": 0.0381, + "activeTotalExVat": 0.0316, + "reactiveTotal": 0.0184, + "reactiveTotalExVat": 0.0147 + }, + { + "id": "0609c164-0ce0-4dce-b6e5-1236e506a9f1", + "numberOfDaysInMonth": 29, + "activeTotal": 0.0395, + "activeTotalExVat": 0.0316, + "reactiveTotal": 0.0190, + "reactiveTotalExVat": 0.0152 + }, + { + "id": "3c1869cb-17dc-43d1-ac9f-40c332b018c8", + "numberOfDaysInMonth": 28, + "activeTotal": 0.0409, + "activeTotalExVat": 0.0327, + "reactiveTotal": 0.0197, + "reactiveTotalExVat": 0.0157 + } + ], + "levelInfo": "Power price component for Nettleie lavspent DS", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/kW/month" + } + ] + } + ], + "energyPrices": [ + { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "startDate": "2021-09-17", + "endDate": "2021-09-17", + "season": "summer", + "level": "NORMAL", + "total": 0.2585, + "totalExVat": 0.2068, + "energyExTaxes": 0.0399, + "taxes": 0.2286, + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/kWh" + } + ] + } + } + }, + "meteringPointsAndPriceLevels": [ + { + "meteringPointIds": [ + "707057500000000007", + "707057500000000008", + "707057500000000009" + ] + } + ] + } + ] +} \ No newline at end of file diff --git a/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_LSDN_example1.json b/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_LSDN_example1.json new file mode 100644 index 0000000..13c443c --- /dev/null +++ b/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_LSDN_example1.json @@ -0,0 +1,424 @@ +{ + "gridTariffCollections": [ + { + "gridTariff": { + "tariffType": { + "tariffKey": "power_ls_dn", + "product": "AA EL 12345", + "companyName": "Nettselskap 4 AS", + "companyOrgNo": "900000003", + "title": "Nettleie lavspent dn", + "consumptionFlag": true, + "lastUpdated": "2021-11-05T00:00:00+01:00", + "usePublicHolidayPrices": false, + "useWeekendPrices": false, + "fixedPriceConfiguration": { + "basis": "fixed", + "maxhoursPerDay": null, + "daysPerMonth": null, + "allDaysPerMonth": null, + "maxhoursPerMonth": null, + "months": null + }, + "powerPriceConfiguration": { + "reactivePowerPricing": true, + "powerFactorPercentage": 50.0000 + }, + "resolution": 60, + "description": "Tariff for low voltage connection in distribution grid" + }, + "tariffPrice": { + "hours": [ + { + "startTime": "2021-09-17T00:00:00+02:00", + "expiredAt": "2021-09-17T01:00:00+02:00", + "shortName": "0000-0100", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T01:00:00+02:00", + "expiredAt": "2021-09-17T02:00:00+02:00", + "shortName": "0100-0200", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T02:00:00+02:00", + "expiredAt": "2021-09-17T03:00:00+02:00", + "shortName": "0200-0300", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T03:00:00+02:00", + "expiredAt": "2021-09-17T04:00:00+02:00", + "shortName": "0300-0400", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T04:00:00+02:00", + "expiredAt": "2021-09-17T05:00:00+02:00", + "shortName": "0400-0005", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T05:00:00+02:00", + "expiredAt": "2021-09-17T06:00:00+02:00", + "shortName": "0500-0600", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T06:00:00+02:00", + "expiredAt": "2021-09-17T07:00:00+02:00", + "shortName": "0600-0700", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T07:00:00+02:00", + "expiredAt": "2021-09-17T08:00:00+02:00", + "shortName": "0700-0800", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T08:00:00+02:00", + "expiredAt": "2021-09-17T09:00:00+02:00", + "shortName": "0800-0900", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T09:00:00+02:00", + "expiredAt": "2021-09-17T10:00:00+02:00", + "shortName": "0900-1000", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T10:00:00+02:00", + "expiredAt": "2021-09-17T11:00:00+02:00", + "shortName": "1000-1100", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T11:00:00+02:00", + "expiredAt": "2021-09-17T12:00:00+02:00", + "shortName": "1100-1200", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T12:00:00+02:00", + "expiredAt": "2021-09-17T13:00:00+02:00", + "shortName": "1200-1300", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + } + ], + "priceInfo": { + "fixedPrices": [ + { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "startDate": "2021-09-17", + "endDate": "2021-09-17", + "priceLevel": [ + { + "id": "edcf53ce-70d3-4fa0-8bfb-e79918335ab7", + "valueMin": null, + "valueMax": null, + "nextIdDown": null, + "nextIdUp": null, + "valueUnitOfMeasure": "kWh/h", + "monthlyTotal": 140.0000, + "monthlyTotalExVat": 112.0000, + "monthlyExTaxes": 112.0000, + "monthlyTaxes": 28.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.1881, + "totalExVat": 0.1504 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.1944, + "totalExVat": 0.1555 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.2011, + "totalExVat": 0.1608 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.2083, + "totalExVat": 0.1666 + } + ], + "levelInfo": "Fixed price component for Nettleie lavspent DS", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + } + ] + } + ], + "powerPrices": [ + { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "startDate": "2021-09-17", + "endDate": "2021-09-17", + "priceLevel": [ + { + "id": "c87bfdc8-a73c-4c93-9a3b-b2558b4aa3c4", + "valueMin": null, + "valueMax": null, + "nextIdDown": null, + "nextIdUp": null, + "valueUnitOfMeasure": null, + "monthlyActivePowerTotal": 27.5000, + "monthlyActivePowerTotalExVat": 22.0000, + "monthlyActivePowerExTaxes": 22.0000, + "monthlyActivePowerTaxes": 5.5000, + "monthlyReactivePowerTotal": 13.2625, + "monthlyReactivePowerTotalExVat": 10.6100, + "monthlyReactivePowerExTaxes": 10.6100, + "monthlyReactivePowerTaxes": 2.6525, + "monthlyUnitOfMeasure": "kr/kW/month", + "hourPrices": [ + { + "id": "d85adcfa-24bd-4561-a0df-ae6b5ce475bc", + "numberOfDaysInMonth": 31, + "activeTotal": 0.0369, + "activeTotalExVat": 0.0295, + "reactiveTotal": 0.0178, + "reactiveTotalExVat": 0.0142 + }, + { + "id": "27134fc2-514d-479e-aedb-f13fc4f087d1", + "numberOfDaysInMonth": 30, + "activeTotal": 0.0381, + "activeTotalExVat": 0.0316, + "reactiveTotal": 0.0184, + "reactiveTotalExVat": 0.0147 + }, + { + "id": "0609c164-0ce0-4dce-b6e5-1236e506a9f1", + "numberOfDaysInMonth": 29, + "activeTotal": 0.0395, + "activeTotalExVat": 0.0316, + "reactiveTotal": 0.0190, + "reactiveTotalExVat": 0.0152 + }, + { + "id": "3c1869cb-17dc-43d1-ac9f-40c332b018c8", + "numberOfDaysInMonth": 28, + "activeTotal": 0.0409, + "activeTotalExVat": 0.0327, + "reactiveTotal": 0.0197, + "reactiveTotalExVat": 0.0157 + } + ], + "levelInfo": "Power price component for Nettleie lavspent DS", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/kW/month" + } + ] + } + ], + "energyPrices": [ + { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "startDate": "2021-09-17", + "endDate": "2021-09-17", + "season": "summer", + "level": "NORMAL", + "total": 0.2585, + "totalExVat": 0.2068, + "energyExTaxes": 0.0399, + "taxes": 0.2286, + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/kWh" + } + ] + } + } + }, + "meteringPointsAndPriceLevels": [ + { + "meteringPointIds": [ + "707057500000000007", + "707057500000000008", + "707057500000000009" + ] + } + ] + } + ] +} \ No newline at end of file diff --git a/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_LSDN_example2.json b/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_LSDN_example2.json new file mode 100644 index 0000000..d3ed6ec --- /dev/null +++ b/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_LSDN_example2.json @@ -0,0 +1,478 @@ +{ + "gridTariffCollections": [ + { + "gridTariff": { + "tariffType": { + "tariffKey": "power_ls_dn", + "product": "AA EL 12345", + "companyName": "Nettselskap 4 AS", + "companyOrgNo": "900000003", + "title": "Nettleie lavspent dn diff effektledd", + "consumptionFlag": true, + "lastUpdated": "2021-11-05T00:00:00+01:00", + "usePublicHolidayPrices": false, + "useWeekendPrices": false, + "fixedPriceConfiguration": { + "basis": "fixed", + "maxhoursPerDay": null, + "daysPerMonth": null, + "allDaysPerMonth": null, + "maxhoursPerMonth": null, + "months": null + }, + "powerPriceConfiguration": { + "reactivePowerPricing": true, + "powerFactorPercentage": 50.0000 + }, + "resolution": 60, + "description": "Tariff for low voltage connection in distribution grid" + }, + "tariffPrice": { + "hours": [ + { + "startTime": "2021-09-17T00:00:00+02:00", + "expiredAt": "2021-09-17T01:00:00+02:00", + "shortName": "0000-0100", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T01:00:00+02:00", + "expiredAt": "2021-09-17T02:00:00+02:00", + "shortName": "0100-0200", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T02:00:00+02:00", + "expiredAt": "2021-09-17T03:00:00+02:00", + "shortName": "0200-0300", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T03:00:00+02:00", + "expiredAt": "2021-09-17T04:00:00+02:00", + "shortName": "0300-0400", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T04:00:00+02:00", + "expiredAt": "2021-09-17T05:00:00+02:00", + "shortName": "0400-0005", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T05:00:00+02:00", + "expiredAt": "2021-09-17T06:00:00+02:00", + "shortName": "0500-0600", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T06:00:00+02:00", + "expiredAt": "2021-09-17T07:00:00+02:00", + "shortName": "0600-0700", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T07:00:00+02:00", + "expiredAt": "2021-09-17T08:00:00+02:00", + "shortName": "0700-0800", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T08:00:00+02:00", + "expiredAt": "2021-09-17T09:00:00+02:00", + "shortName": "0800-0900", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T09:00:00+02:00", + "expiredAt": "2021-09-17T10:00:00+02:00", + "shortName": "0900-1000", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T10:00:00+02:00", + "expiredAt": "2021-09-17T11:00:00+02:00", + "shortName": "1000-1100", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T11:00:00+02:00", + "expiredAt": "2021-09-17T12:00:00+02:00", + "shortName": "1100-1200", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T12:00:00+02:00", + "expiredAt": "2021-09-17T13:00:00+02:00", + "shortName": "1200-1300", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "powerPrice": { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "hourId": "27134fc2-514d-479e-aedb-f13fc4f087d1" + }, + "energyPrice": { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "total": 0.2585, + "totalExVat": 0.2068 + } + } + ], + "priceInfo": { + "fixedPrices": [ + { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "startDate": "2021-09-17", + "endDate": "2021-09-17", + "priceLevel": [ + { + "id": "edcf53ce-70d3-4fa0-8bfb-e79918335ab7", + "valueMin": null, + "valueMax": null, + "nextIdDown": null, + "nextIdUp": null, + "valueUnitOfMeasure": "kWh/h", + "monthlyTotal": 140.0000, + "monthlyTotalExVat": 112.0000, + "monthlyExTaxes": 112.0000, + "monthlyTaxes": 28.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.1881, + "totalExVat": 0.1504 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.1944, + "totalExVat": 0.1555 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.2011, + "totalExVat": 0.1608 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.2083, + "totalExVat": 0.1666 + } + ], + "levelInfo": "Fixed price component for Nettleie lavspent DS diff effektledd", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + } + ] + } + ], + "powerPrices": [ + { + "id": "f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "startDate": "2021-09-17", + "endDate": "2021-09-17", + "priceLevel": [ + { + "id": "c87bfdc8-a73c-4c93-9a3b-b2558b4aa3c4", + "valueMin": 0, + "valueMax": 100, + "nextIdDown": null, + "nextIdUp": "d40424b5-78a5-427a-bf70-b0b33dde6df0", + "valueUnitOfMeasure": "kW", + "monthlyActivePowerTotal": 27.5000, + "monthlyActivePowerTotalExVat": 22.0000, + "monthlyActivePowerExTaxes": 22.0000, + "monthlyActivePowerTaxes": 5.5000, + "monthlyReactivePowerTotal": 13.2625, + "monthlyReactivePowerTotalExVat": 10.6100, + "monthlyReactivePowerExTaxes": 10.6100, + "monthlyReactivePowerTaxes": 2.6525, + "monthlyUnitOfMeasure": "kr/kW/month", + "hourPrices": [ + { + "id": "d85adcfa-24bd-4561-a0df-ae6b5ce475bc", + "numberOfDaysInMonth": 31, + "activeTotal": 0.0369, + "activeTotalExVat": 0.0295, + "reactiveTotal": 0.0178, + "reactiveTotalExVat": 0.0142 + }, + { + "id": "27134fc2-514d-479e-aedb-f13fc4f087d1", + "numberOfDaysInMonth": 30, + "activeTotal": 0.0381, + "activeTotalExVat": 0.0316, + "reactiveTotal": 0.0184, + "reactiveTotalExVat": 0.0147 + }, + { + "id": "0609c164-0ce0-4dce-b6e5-1236e506a9f1", + "numberOfDaysInMonth": 29, + "activeTotal": 0.0395, + "activeTotalExVat": 0.0316, + "reactiveTotal": 0.0190, + "reactiveTotalExVat": 0.0152 + }, + { + "id": "3c1869cb-17dc-43d1-ac9f-40c332b018c8", + "numberOfDaysInMonth": 28, + "activeTotal": 0.0409, + "activeTotalExVat": 0.0327, + "reactiveTotal": 0.0197, + "reactiveTotalExVat": 0.0157 + } + ], + "levelInfo": "Power price component for Nettleie lavspent DS diff effektledd", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/kW/month" + }, + { + "id": "d40424b5-78a5-427a-bf70-b0b33dde6df0", + "valueMin": 100, + "valueMax": null, + "nextIdDown": "c87bfdc8-a73c-4c93-9a3b-b2558b4aa3c4", + "nextIdUp": null, + "valueUnitOfMeasure": "kW", + "monthlyActivePowerTotal": 13.7500, + "monthlyActivePowerTotalExVat": 11.0000, + "monthlyActivePowerExTaxes": 11.0000, + "monthlyActivePowerTaxes": 2.7500, + "monthlyReactivePowerTotal": 13.2625, + "monthlyReactivePowerTotalExVat": 10.6100, + "monthlyReactivePowerExTaxes": 10.6100, + "monthlyReactivePowerTaxes": 2.6525, + "monthlyUnitOfMeasure": "kr/kW/month", + "hourPrices": [ + { + "id": "d85adcfa-24bd-4561-a0df-ae6b5ce475bc", + "numberOfDaysInMonth": 31, + "activeTotal": 0.0184, + "activeTotalExVat": 0.0147, + "reactiveTotal": 0.0178, + "reactiveTotalExVat": 0.0142 + }, + { + "id": "27134fc2-514d-479e-aedb-f13fc4f087d1", + "numberOfDaysInMonth": 30, + "activeTotal": 0.0190, + "activeTotalExVat": 0.0152, + "reactiveTotal": 0.0184, + "reactiveTotalExVat": 0.0147 + }, + { + "id": "0609c164-0ce0-4dce-b6e5-1236e506a9f1", + "numberOfDaysInMonth": 29, + "activeTotal": 0.0197, + "activeTotalExVat": 0.0157, + "reactiveTotal": 0.0190, + "reactiveTotalExVat": 0.0152 + }, + { + "id": "3c1869cb-17dc-43d1-ac9f-40c332b018c8", + "numberOfDaysInMonth": 28, + "activeTotal": 0.0204, + "activeTotalExVat": 0.0163, + "reactiveTotal": 0.0197, + "reactiveTotalExVat": 0.0157 + } + ], + "levelInfo": "Power price component for Nettleie lavspent DS diff effektledd", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/kW/month" + } + ] + } + ], + "energyPrices": [ + { + "id": "4360704e-ea68-4aaa-818f-a3ff04a47cbd", + "startDate": "2021-09-17", + "endDate": "2021-09-17", + "season": "summer", + "level": "NORMAL", + "total": 0.2585, + "totalExVat": 0.2068, + "energyExTaxes": 0.0399, + "taxes": 0.2286, + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/kWh" + } + ] + } + } + }, + "meteringPointsAndPriceLevels": [ + { + "meteringPointIds": [ + "707057500000000010", + "707057500000000011", + "707057500000000012" + ] + } + ] + } + ] +} \ No newline at end of file diff --git a/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_dailymax_example1.json b/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_dailymax_example1.json new file mode 100644 index 0000000..c604dac --- /dev/null +++ b/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_dailymax_example1.json @@ -0,0 +1,543 @@ +{ + "gridTariffCollections": [ + { + "gridTariff": { + "tariffType": { + "tariffKey": "normal_low_cons_dailymax", + "product": "YY EL ZZZ YYY XXX", + "companyName": "Nettselskap 2 AS", + "companyOrgNo": "900000001", + "title": "Nettleie normal under 100MW", + "consumptionFlag": true, + "lastUpdated": "2021-11-05T00:00:00+01:00", + "usePublicHolidayPrices": false, + "useWeekendPrices": false, + "fixedPriceConfiguration": { + "basis": "monthlymax", + "maxhoursPerDay": 1, + "daysPerMonth": null, + "allDaysPerMonth": true, + "maxhoursPerMonth": null, + "months": 1 + }, + "resolution": 60, + "description": "Tariff for private households and businesses with annual consumption below 100.000 kWh." + }, + "tariffPrice": { + "hours": [ + { + "startTime": "2021-09-17T00:00:00+02:00", + "expiredAt": "2021-09-17T01:00:00+02:00", + "shortName": "0000-0100", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T01:00:00+02:00", + "expiredAt": "2021-09-17T02:00:00+02:00", + "shortName": "0100-0200", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T02:00:00+02:00", + "expiredAt": "2021-09-17T03:00:00+02:00", + "shortName": "0200-0300", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T03:00:00+02:00", + "expiredAt": "2021-09-17T04:00:00+02:00", + "shortName": "0300-0400", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T04:00:00+02:00", + "expiredAt": "2021-09-17T05:00:00+02:00", + "shortName": "0400-0500", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T05:00:00+02:00", + "expiredAt": "2021-09-17T06:00:00+02:00", + "shortName": "0500-0600", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T06:00:00+02:00", + "expiredAt": "2021-09-17T07:00:00+02:00", + "shortName": "0600-0700", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + }, + { + "startTime": "2021-09-17T07:00:00+02:00", + "expiredAt": "2021-09-17T08:00:00+02:00", + "shortName": "0700-0800", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + }, + { + "startTime": "2021-09-17T08:00:00+02:00", + "expiredAt": "2021-09-17T09:00:00+02:00", + "shortName": "0800-0900", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + }, + { + "startTime": "2021-09-17T09:00:00+02:00", + "expiredAt": "2021-09-17T10:00:00+02:00", + "shortName": "0900-1000", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + }, + { + "startTime": "2021-09-17T10:00:00+02:00", + "expiredAt": "2021-09-17T11:00:00+02:00", + "shortName": "1000-1100", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + }, + { + "startTime": "2021-09-17T11:00:00+02:00", + "expiredAt": "2021-09-17T12:00:00+02:00", + "shortName": "1100-1200", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + }, + { + "startTime": "2021-09-17T12:00:00+02:00", + "expiredAt": "2021-09-17T13:00:00+02:00", + "shortName": "1200-1300", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + } + ], + "priceInfo": { + "fixedPrices": [ + { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "startDate": "2021-09-17", + "endDate": "2021-09-17", + "priceLevel": [ + { + "id": "edcf53ce-70d3-4fa0-8bfb-e79918335ab7", + "valueMin": 0.0000, + "valueMax": 2.0000, + "nextIdDown": null, + "nextIdUp": "a920b2af-a43f-4de4-aa86-33ea874bdbc4", + "valueUnitOfMeasure": "kWh/h", + "monthlyTotal": 100.0000, + "monthlyTotalExVat": 80.0000, + "monthlyExTaxes": 80.0000, + "monthlyTaxes": 20.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.1344, + "totalExVat": 0.1075 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.1388, + "totalExVat": 0.1110 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.1436, + "totalExVat": 0.1148 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.1488, + "totalExVat": 0.1190 + } + ], + "levelInfo": "Power consumption: 0-2 kWh/h", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + }, + { + "id": "a920b2af-a43f-4de4-aa86-33ea874bdbc4", + "valueMin": 2.0000, + "valueMax": 4.0000, + "nextIdDown": "edcf53ce-70d3-4fa0-8bfb-e79918335ab7", + "nextIdUp": "fa350888-d463-4132-b3e3-8a43ea9fc062", + "valueUnitOfMeasure": "kWh/h", + "monthlyTotal": 115.0000, + "monthlyTotalExVat": 92.0000, + "monthlyExTaxes": 92.0000, + "monthlyTaxes": 23.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.1545, + "totalExVat": 0.1236 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.1597, + "totalExVat": 0.1277 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.1652, + "totalExVat": 0.1321 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.1711, + "totalExVat": 0.1368 + } + ], + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + }, + { + "id": "fa350888-d463-4132-b3e3-8a43ea9fc062", + "valueMin": 4.0000, + "valueMax": 8.0000, + "nextIdDown": "a920b2af-a43f-4de4-aa86-33ea874bdbc4", + "nextIdUp": "4e3de6a7-e1ed-4156-9b1e-04f924609b7d", + "valueUnitOfMeasure": "kWh/h", + "monthlyTotal": 140.0000, + "monthlyTotalExVat": 112.0000, + "monthlyExTaxes": 112.0000, + "monthlyTaxes": 28.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.1881, + "totalExVat": 0.1504 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.1944, + "totalExVat": 0.1555 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.2011, + "totalExVat": 0.1608 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.2083, + "totalExVat": 0.1666 + } + ], + "levelInfo": "Power consumption: 4-8 kWh/h", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + }, + { + "id": "4e3de6a7-e1ed-4156-9b1e-04f924609b7d", + "valueMin": 8.0000, + "valueMax": 12.0000, + "nextIdDown": "fa350888-d463-4132-b3e3-8a43ea9fc062", + "nextIdUp": "fa719e48-72ff-4a1c-b388-1aa87d700f93", + "valueUnitOfMeasure": "kWh/h", + "monthlyTotal": 170.0000, + "monthlyTotalExVat": 136.0000, + "monthlyExTaxes": 136.0000, + "monthlyTaxes": 34.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.2284, + "totalExVat": 0.1827 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.2361, + "totalExVat": 0.1888 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.2442, + "totalExVat": 0.1953 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.2529, + "totalExVat": 0.2023 + } + ], + "levelInfo": "Power consumption: 8-12 kWh/h", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + }, + { + "id": "fa719e48-72ff-4a1c-b388-1aa87d700f93", + "valueMin": 12.0000, + "valueMax": 16.0000, + "nextIdDown": "4e3de6a7-e1ed-4156-9b1e-04f924609b7d", + "nextIdUp": "f88e26f8-c98a-4d37-afa2-21f3ebefb808", + "valueUnitOfMeasure": "kWh/h", + "monthlyTotal": 225.0000, + "monthlyTotalExVat": 180.0000, + "monthlyExTaxes": 180.0000, + "monthlyTaxes": 45.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.3024, + "totalExVat": 0.2419 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.3125, + "totalExVat": 0.2500 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.3232, + "totalExVat": 0.2585 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.3348, + "totalExVat": 0.2678 + } + ], + "levelInfo": "Power consumption: 12-16 kWh/h", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + }, + { + "id": "f88e26f8-c98a-4d37-afa2-21f3ebefb808", + "valueMin": 16.0000, + "valueMax": null, + "nextIdDown": "fa719e48-72ff-4a1c-b388-1aa87d700f93", + "nextIdUp": null, + "valueUnitOfMeasure": "kWh/h", + "monthlyTotal": 350.0000, + "monthlyTotalExVat": 280.0000, + "monthlyExTaxes": 280.0000, + "monthlyTaxes": 70.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.4704, + "totalExVat": 0.3763 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.4861, + "totalExVat": 0.3888 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.5028, + "totalExVat": 0.4022 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.5208, + "totalExVat": 0.4166 + } + ], + "levelInfo": "Power consumption: >16 kWh/h", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + } + ] + } + ], + "energyPrices": [ + { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "startDate": "2021-09-17", + "endDate": "2021-09-17", + "season": "summer", + "level": "CHEAP", + "total": 0.2585, + "totalExVat": 0.2068, + "energyExTaxes": 0.0299, + "taxes": 0.2286, + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/kWh" + }, + { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "startDate": "2021-01-01", + "endDate": "2021-12-31", + "season": "summer", + "level": "NORMAL", + "total": 0.2850, + "totalExVat": 0.2280, + "energyExTaxes": 0.0511, + "taxes": 0.2339, + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/kWh" + } + ] + } + } + }, + "meteringPointsAndPriceLevels": [ + { + "currentFixedPriceLevel": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "levelId": "edcf53ce-70d3-4fa0-8bfb-e79918335ab7", + "levelValue": null, + "lastUpdated": "2021-11-05T01:00:00+01:00" + }, + "meteringPointIds": [ + "707057500000000004" + ] + }, + { + "currentFixedPriceLevel": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "levelId": "4e3de6a7-e1ed-4156-9b1e-04f924609b7d", + "levelValue": null, + "lastUpdated": "2021-11-05T01:00:00+01:00" + }, + "meteringPointIds": [ + "707057500000000005", + "707057500000000006" + ] + } + ] + } + ] +} \ No newline at end of file diff --git a/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_fusesize_example1.json b/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_fusesize_example1.json new file mode 100644 index 0000000..f353b54 --- /dev/null +++ b/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_fusesize_example1.json @@ -0,0 +1,628 @@ +{ + "gridTariffCollections": [ + { + "gridTariff": { + "tariffType": { + "tariffKey": "normal_low_cons_fusesize", + "product": "YY EL ZZZ YYY XXX", + "companyName": "Nettselskap 3 AS", + "companyOrgNo": "900000002", + "title": "Nettleie normal under 100MW", + "consumptionFlag": true, + "lastUpdated": "2021-11-05T00:00:00+01:00", + "usePublicHolidayPrices": false, + "useWeekendPrices": false, + "fixedPriceConfiguration": { + "basis": "fusesize", + "maxhoursPerDay": null, + "daysPerMonth": null, + "allDaysPerMonth": null, + "maxhoursPerMonth": null, + "months": null + }, + "resolution": 60, + "description": "Tariff for private households and businesses with annual consumption below 100.000 kWh." + }, + "tariffPrice": { + "hours": [ + { + "startTime": "2021-09-17T00:00:00+02:00", + "expiredAt": "2021-09-17T01:00:00+02:00", + "shortName": "0000-0100", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T01:00:00+02:00", + "expiredAt": "2021-09-17T02:00:00+02:00", + "shortName": "0100-0200", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T02:00:00+02:00", + "expiredAt": "2021-09-17T03:00:00+02:00", + "shortName": "0200-0300", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T03:00:00+02:00", + "expiredAt": "2021-09-17T04:00:00+02:00", + "shortName": "0300-0400", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T04:00:00+02:00", + "expiredAt": "2021-09-17T05:00:00+02:00", + "shortName": "0400-0500", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T05:00:00+02:00", + "expiredAt": "2021-09-17T06:00:00+02:00", + "shortName": "0500-0600", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T06:00:00+02:00", + "expiredAt": "2021-09-17T07:00:00+02:00", + "shortName": "0600-0700", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + }, + { + "startTime": "2021-09-17T07:00:00+02:00", + "expiredAt": "2021-09-17T08:00:00+02:00", + "shortName": "0700-0800", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + }, + { + "startTime": "2021-09-17T08:00:00+02:00", + "expiredAt": "2021-09-17T09:00:00+02:00", + "shortName": "0800-0900", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + }, + { + "startTime": "2021-09-17T09:00:00+02:00", + "expiredAt": "2021-09-17T10:00:00+02:00", + "shortName": "0900-1000", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + }, + { + "startTime": "2021-09-17T10:00:00+02:00", + "expiredAt": "2021-09-17T11:00:00+02:00", + "shortName": "1000-1100", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + }, + { + "startTime": "2021-09-17T11:00:00+02:00", + "expiredAt": "2021-09-17T12:00:00+02:00", + "shortName": "1100-1200", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + }, + { + "startTime": "2021-09-17T12:00:00+02:00", + "expiredAt": "2021-09-17T13:00:00+02:00", + "shortName": "1200-1300", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + } + ], + "priceInfo": { + "fixedPrices": [ + { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "startDate": "2021-09-17", + "endDate": "2021-09-17", + "priceLevel": [ + { + "id": "edcf53ce-70d3-4fa0-8bfb-e79918335ab7", + "valueMin": 10.0000, + "valueMax": 10.0000, + "nextIdDown": null, + "nextIdUp": "a920b2af-a43f-4de4-aa86-33ea874bdbc4", + "valueUnitOfMeasure": "A", + "monthlyTotal": 100.0000, + "monthlyTotalExVat": 80.0000, + "monthlyExTaxes": 80.0000, + "monthlyTaxes": 20.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.1344, + "totalExVat": 0.1075 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.1388, + "totalExVat": 0.1110 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.1436, + "totalExVat": 0.1148 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.1488, + "totalExVat": 0.1190 + } + ], + "levelInfo": "Fuse size: 10 A", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + }, + { + "id": "a920b2af-a43f-4de4-aa86-33ea874bdbc4", + "valueMin": 17.0000, + "valueMax": 17.0000, + "nextIdDown": "edcf53ce-70d3-4fa0-8bfb-e79918335ab7", + "nextIdUp": "fa350888-d463-4132-b3e3-8a43ea9fc062", + "valueUnitOfMeasure": "A", + "monthlyTotal": 115.0000, + "monthlyTotalExVat": 92.0000, + "monthlyExTaxes": 92.0000, + "monthlyTaxes": 23.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.1545, + "totalExVat": 0.1236 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.1597, + "totalExVat": 0.1277 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.1652, + "totalExVat": 0.1321 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.1711, + "totalExVat": 0.1368 + } + ], + "levelInfo": "Fuse size: 17 A", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + }, + { + "id": "fa350888-d463-4132-b3e3-8a43ea9fc062", + "valueMin": 25.0000, + "valueMax": 25.0000, + "nextIdDown": "a920b2af-a43f-4de4-aa86-33ea874bdbc4", + "nextIdUp": "4e3de6a7-e1ed-4156-9b1e-04f924609b7d", + "valueUnitOfMeasure": "A", + "monthlyTotal": 140.0000, + "monthlyTotalExVat": 112.0000, + "monthlyExTaxes": 112.0000, + "monthlyTaxes": 28.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.1881, + "totalExVat": 0.1504 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.1944, + "totalExVat": 0.1555 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.2011, + "totalExVat": 0.1608 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.2083, + "totalExVat": 0.1666 + } + ], + "levelInfo": "Fuse size: 25 A", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + }, + { + "id": "4e3de6a7-e1ed-4156-9b1e-04f924609b7d", + "valueMin": 35.0000, + "valueMax": 35.0000, + "nextIdDown": "fa350888-d463-4132-b3e3-8a43ea9fc062", + "nextIdUp": "fa719e48-72ff-4a1c-b388-1aa87d700f93", + "valueUnitOfMeasure": "A", + "monthlyTotal": 170.0000, + "monthlyTotalExVat": 136.0000, + "monthlyExTaxes": 136.0000, + "monthlyTaxes": 34.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.2284, + "totalExVat": 0.1827 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.2361, + "totalExVat": 0.1888 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.2442, + "totalExVat": 0.1953 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.2529, + "totalExVat": 0.2023 + } + ], + "levelInfo": "Fuse size: 35 A", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + }, + { + "id": "fa719e48-72ff-4a1c-b388-1aa87d700f93", + "valueMin": 50.0000, + "valueMax": 50.0000, + "nextIdDown": "4e3de6a7-e1ed-4156-9b1e-04f924609b7d", + "nextIdUp": "f88e26f8-c98a-4d37-afa2-21f3ebefb808", + "valueUnitOfMeasure": "A", + "monthlyTotal": 225.0000, + "monthlyTotalExVat": 180.0000, + "monthlyExTaxes": 180.0000, + "monthlyTaxes": 45.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.3024, + "totalExVat": 0.2419 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.3125, + "totalExVat": 0.2500 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.3232, + "totalExVat": 0.2585 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.3348, + "totalExVat": 0.2678 + } + ], + "levelInfo": "Fuse size: 50 A", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + }, + { + "id": "f88e26f8-c98a-4d37-afa2-21f3ebefb808", + "valueMin": 65.0000, + "valueMax": 65.0000, + "nextIdDown": "fa719e48-72ff-4a1c-b388-1aa87d700f93", + "nextIdUp": "ce4b302c-025a-4444-8708-1f37c7bcd38b", + "valueUnitOfMeasure": "A", + "monthlyTotal": 350.0000, + "monthlyTotalExVat": 280.0000, + "monthlyExTaxes": 280.0000, + "monthlyTaxes": 70.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.4704, + "totalExVat": 0.3763 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.4861, + "totalExVat": 0.3888 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.5028, + "totalExVat": 0.4022 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.5208, + "totalExVat": 0.4166 + } + ], + "levelInfo": "Fuse size: 65 A", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + }, + { + "id": "ce4b302c-025a-4444-8708-1f37c7bcd38b", + "valueMin": 80.0000, + "valueMax": 80.0000, + "nextIdDown": "f88e26f8-c98a-4d37-afa2-21f3ebefb808", + "nextIdUp": "bb38e680-b0a8-478a-b824-92f006f3b1cf", + "valueUnitOfMeasure": "A", + "monthlyTotal": 500.0000, + "monthlyTotalExVat": 400.0000, + "monthlyExTaxes": 400.0000, + "monthlyTaxes": 100.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.6720, + "totalExVat": 0.5376 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.6944, + "totalExVat": 0.5555 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.7183, + "totalExVat": 0.5746 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.7440, + "totalExVat": 0.5952 + } + ], + "levelInfo": "Fuse size: 88 A", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + }, + { + "id": "bb38e680-b0a8-478a-b824-92f006f3b1cf", + "valueMin": 99.0000, + "valueMax": 99.0000, + "nextIdDown": "ce4b302c-025a-4444-8708-1f37c7bcd38b", + "nextIdUp": null, + "valueUnitOfMeasure": "A", + "monthlyTotal": 700.0000, + "monthlyTotalExVat": 560.0000, + "monthlyExTaxes": 560.0000, + "monthlyTaxes": 140.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.9408, + "totalExVat": 0.7526 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.9722, + "totalExVat": 0.7777 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 1.0057, + "totalExVat": 0.8045 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 1.0416, + "totalExVat": 0.8332 + } + ], + "levelInfo": "Fuse size: 99 A", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + } + ] + } + ], + "energyPrices": [ + { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "startDate": "2021-09-17", + "endDate": "2021-09-17", + "season": "summer", + "level": "CHEAP", + "total": 0.2585, + "totalExVat": 0.2068, + "energyExTaxes": 0.0299, + "taxes": 0.2286, + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/kWh" + }, + { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "startDate": "2021-09-17", + "endDate": "2021-09-17", + "season": "summer", + "level": "NORMAL", + "total": 0.2850, + "totalExVat": 0.2280, + "energyExTaxes": 0.0511, + "taxes": 0.2339, + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/kWh" + } + ] + } + } + }, + "meteringPointsAndPriceLevels": [ + { + "currentFixedPriceLevel": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "levelId": "edcf53ce-70d3-4fa0-8bfb-e79918335ab7", + "levelValue": null, + "lastUpdated": "2021-11-05T01:00:00+01:00" + }, + "meteringPointIds": [ + "707057500000000007" + ] + }, + { + "currentFixedPriceLevel": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "levelId": "4e3de6a7-e1ed-4156-9b1e-04f924609b7d", + "levelValue": null, + "lastUpdated": "2021-11-05T01:00:00+01:00" + }, + "meteringPointIds": [ + "707057500000000008", + "707057500000000009" + ] + } + ] + } + ] +} diff --git a/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_monthlymax_example1.json b/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_monthlymax_example1.json new file mode 100644 index 0000000..81beb82 --- /dev/null +++ b/doc/DiginGridTariffAPI.v1_0_meteringpointsgridtariffs_json_output_monthlymax_example1.json @@ -0,0 +1,543 @@ +{ + "gridTariffCollections": [ + { + "gridTariff": { + "tariffType": { + "tariffKey": "normal_low_cons", + "product": "XX EL XXX YYY ZZZ", + "companyName": "Nettselskap AS", + "companyOrgNo": "900000000", + "title": "Nettleie normal under 100MW", + "consumptionFlag": true, + "lastUpdated": "2021-11-05T00:00:00+01:00", + "usePublicHolidayPrices": false, + "useWeekendPrices": false, + "fixedPriceConfiguration": { + "basis": "monthlymax", + "maxhoursPerDay": null, + "daysPerMonth": null, + "allDaysPerMonth": null, + "maxhoursPerMonth": 1, + "months": 1 + }, + "resolution": 60, + "description": "Tariff for private households and businesses with annual consumption below 100.000 kWh." + }, + "tariffPrice": { + "hours": [ + { + "startTime": "2021-09-17T00:00:00+02:00", + "expiredAt": "2021-09-17T01:00:00+02:00", + "shortName": "0000-0100", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T01:00:00+02:00", + "expiredAt": "2021-09-17T02:00:00+02:00", + "shortName": "0100-0200", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T02:00:00+02:00", + "expiredAt": "2021-09-17T03:00:00+02:00", + "shortName": "0200-0300", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T03:00:00+02:00", + "expiredAt": "2021-09-17T04:00:00+02:00", + "shortName": "0300-0400", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T04:00:00+02:00", + "expiredAt": "2021-09-17T05:00:00+02:00", + "shortName": "0400-0500", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T05:00:00+02:00", + "expiredAt": "2021-09-17T06:00:00+02:00", + "shortName": "0500-0600", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "total": 0.2585, + "totalExVat": 0.2068 + } + }, + { + "startTime": "2021-09-17T06:00:00+02:00", + "expiredAt": "2021-09-17T07:00:00+02:00", + "shortName": "0600-0700", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + }, + { + "startTime": "2021-09-17T07:00:00+02:00", + "expiredAt": "2021-09-17T08:00:00+02:00", + "shortName": "0700-0800", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + }, + { + "startTime": "2021-09-17T08:00:00+02:00", + "expiredAt": "2021-09-17T09:00:00+02:00", + "shortName": "0800-0900", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + }, + { + "startTime": "2021-09-17T09:00:00+02:00", + "expiredAt": "2021-09-17T10:00:00+02:00", + "shortName": "0900-1000", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + }, + { + "startTime": "2021-09-17T10:00:00+02:00", + "expiredAt": "2021-09-17T11:00:00+02:00", + "shortName": "1000-1100", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + }, + { + "startTime": "2021-09-17T11:00:00+02:00", + "expiredAt": "2021-09-17T12:00:00+02:00", + "shortName": "1100-1200", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + }, + { + "startTime": "2021-09-17T12:00:00+02:00", + "expiredAt": "2021-09-17T13:00:00+02:00", + "shortName": "1200-1300", + "isPublicHoliday": false, + "fixedPrice": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "hourId": "a4afa37ae2ec41048e2b5153c35af1c5" + }, + "energyPrice": { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "total": 0.2850, + "totalExVat": 0.2280 + } + } + ], + "priceInfo": { + "fixedPrices": [ + { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "startDate": "2021-09-17", + "endDate": "2021-09-17", + "priceLevel": [ + { + "id": "edcf53ce-70d3-4fa0-8bfb-e79918335ab7", + "valueMin": 0.0000, + "valueMax": 2.0000, + "nextIdDown": null, + "nextIdUp": "a920b2af-a43f-4de4-aa86-33ea874bdbc4", + "valueUnitOfMeasure": "kWh/h", + "monthlyTotal": 100.0000, + "monthlyTotalExVat": 80.0000, + "monthlyExTaxes": 80.0000, + "monthlyTaxes": 20.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.1344, + "totalExVat": 0.1075 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.1388, + "totalExVat": 0.1110 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.1436, + "totalExVat": 0.1148 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.1488, + "totalExVat": 0.1190 + } + ], + "levelInfo": "Power consumption: 0-2 kWh/h", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + }, + { + "id": "a920b2af-a43f-4de4-aa86-33ea874bdbc4", + "valueMin": 2.0000, + "valueMax": 4.0000, + "nextIdDown": "edcf53ce-70d3-4fa0-8bfb-e79918335ab7", + "nextIdUp": "fa350888-d463-4132-b3e3-8a43ea9fc062", + "valueUnitOfMeasure": "kWh/h", + "monthlyTotal": 115.0000, + "monthlyTotalExVat": 92.0000, + "monthlyExTaxes": 92.0000, + "monthlyTaxes": 23.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.1545, + "totalExVat": 0.1236 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.1597, + "totalExVat": 0.1277 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.1652, + "totalExVat": 0.1321 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.1711, + "totalExVat": 0.1368 + } + ], + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + }, + { + "id": "fa350888-d463-4132-b3e3-8a43ea9fc062", + "valueMin": 4.0000, + "valueMax": 8.0000, + "nextIdDown": "a920b2af-a43f-4de4-aa86-33ea874bdbc4", + "nextIdUp": "4e3de6a7-e1ed-4156-9b1e-04f924609b7d", + "valueUnitOfMeasure": "kWh/h", + "monthlyTotal": 140.0000, + "monthlyTotalExVat": 112.0000, + "monthlyExTaxes": 112.0000, + "monthlyTaxes": 28.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.1881, + "totalExVat": 0.1504 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.1944, + "totalExVat": 0.1555 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.2011, + "totalExVat": 0.1608 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.2083, + "totalExVat": 0.1666 + } + ], + "levelInfo": "Power consumption: 4-8 kWh/h", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + }, + { + "id": "4e3de6a7-e1ed-4156-9b1e-04f924609b7d", + "valueMin": 8.0000, + "valueMax": 12.0000, + "nextIdDown": "fa350888-d463-4132-b3e3-8a43ea9fc062", + "nextIdUp": "fa719e48-72ff-4a1c-b388-1aa87d700f93", + "valueUnitOfMeasure": "kWh/h", + "monthlyTotal": 170.0000, + "monthlyTotalExVat": 136.0000, + "monthlyExTaxes": 136.0000, + "monthlyTaxes": 34.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.2284, + "totalExVat": 0.1827 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.2361, + "totalExVat": 0.1888 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.2442, + "totalExVat": 0.1953 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.2529, + "totalExVat": 0.2023 + } + ], + "levelInfo": "Power consumption: 8-12 kWh/h", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + }, + { + "id": "fa719e48-72ff-4a1c-b388-1aa87d700f93", + "valueMin": 12.0000, + "valueMax": 16.0000, + "nextIdDown": "4e3de6a7-e1ed-4156-9b1e-04f924609b7d", + "nextIdUp": "f88e26f8-c98a-4d37-afa2-21f3ebefb808", + "valueUnitOfMeasure": "kWh/h", + "monthlyTotal": 225.0000, + "monthlyTotalExVat": 180.0000, + "monthlyExTaxes": 180.0000, + "monthlyTaxes": 45.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.3024, + "totalExVat": 0.2419 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.3125, + "totalExVat": 0.2500 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.3232, + "totalExVat": 0.2585 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.3348, + "totalExVat": 0.2678 + } + ], + "levelInfo": "Power consumption: 12-16 kWh/h", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + }, + { + "id": "f88e26f8-c98a-4d37-afa2-21f3ebefb808", + "valueMin": 16.0000, + "valueMax": null, + "nextIdDown": "fa719e48-72ff-4a1c-b388-1aa87d700f93", + "nextIdUp": null, + "valueUnitOfMeasure": "kWh/h", + "monthlyTotal": 350.0000, + "monthlyTotalExVat": 280.0000, + "monthlyExTaxes": 280.0000, + "monthlyTaxes": 70.0000, + "monthlyUnitOfMeasure": "kr/month", + "hourPrices": [ + { + "id": "884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "numberOfDaysInMonth": 31, + "total": 0.4704, + "totalExVat": 0.3763 + }, + { + "id": "a4afa37ae2ec41048e2b5153c35af1c5", + "numberOfDaysInMonth": 30, + "total": 0.4861, + "totalExVat": 0.3888 + }, + { + "id": "00af3883-9de4-4bb8-b8ba-b32c79dde575", + "numberOfDaysInMonth": 29, + "total": 0.5028, + "totalExVat": 0.4022 + }, + { + "id": "c6581146-fab6-4105-bf7a-69715e014673", + "numberOfDaysInMonth": 28, + "total": 0.5208, + "totalExVat": 0.4166 + } + ], + "levelInfo": "Power consumption: >16 kWh/h", + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/hour" + } + ] + } + ], + "energyPrices": [ + { + "id": "ba446e00-24be-4850-b212-fdc9f20cfef0", + "startDate": "2021-09-17", + "endDate": "2021-09-17", + "season": "summer", + "level": "CHEAP", + "total": 0.2585, + "totalExVat": 0.2068, + "energyExTaxes": 0.0299, + "taxes": 0.2286, + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/kWh" + }, + { + "id": "0852242b-90a9-4f71-9903-e881d55194f9", + "startDate": "2021-09-17", + "endDate": "2021-09-17", + "season": "summer", + "level": "NORMAL", + "total": 0.2850, + "totalExVat": 0.2280, + "energyExTaxes": 0.0511, + "taxes": 0.2339, + "currency": "NOK", + "monetaryUnitOfMeasure": "kr/kWh" + } + ] + } + } + }, + "meteringPointsAndPriceLevels": [ + { + "currentFixedPriceLevel": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "levelId": "edcf53ce-70d3-4fa0-8bfb-e79918335ab7", + "levelValue": null, + "lastUpdated": "2021-11-05T01:00:00+01:00" + }, + "meteringPointIds": [ + "707057500000000001" + ] + }, + { + "currentFixedPriceLevel": { + "id": "216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "levelId": "4e3de6a7-e1ed-4156-9b1e-04f924609b7d", + "levelValue": null, + "lastUpdated": "2021-11-05T01:00:00+01:00" + }, + "meteringPointIds": [ + "707057500000000002", + "707057500000000003" + ] + } + ] + } + ] +} \ No newline at end of file diff --git a/doc/GridTariffAPI-3part-registration-and-use-of-api_v1_0.jpg b/doc/GridTariffAPI-3part-registration-and-use-of-api_v1_0.jpg new file mode 100644 index 0000000..26f6caa Binary files /dev/null and b/doc/GridTariffAPI-3part-registration-and-use-of-api_v1_0.jpg differ diff --git a/gridtariffapi.v1_0.common.schema.json b/gridtariffapi.v1_0.common.schema.json new file mode 100644 index 0000000..5d64f64 --- /dev/null +++ b/gridtariffapi.v1_0.common.schema.json @@ -0,0 +1,752 @@ +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "$id": "https://github.com/digin-energi/API-nettleie-for-styring/blob/main/gridtariffapi.v1_0.common.schema.json", + "title": "common", + "TariffQueryRequestMeteringPoints": { + "type": "object", + "properties": { + "range": { + "description": "A keyword for the from-to time range. Exclusive OR with startTime/endTime. Yesterday = hour 0 through hour 23 yesterday etc.", + "maxLength": 10, + "minLength": 0, + "pattern": "yesterday|today|tomorrow", + "type": "string", + "nullable": true + }, + "startTime": { + "description": "Start timestamp for the time range. Inclusive AND with endTime. Exclusive OR with range. Example 2021-09-17T00:00:00+02:00", + "type": "string", + "format": "date-time", + "nullable": true + }, + "endTime": { + "description": "End timestamp for the time range. Inclusive AND with startTime. Exclusive OR with range. Example 2021-09-18T00:00:00+02:00", + "type": "string", + "format": "date-time", + "nullable": true + }, + "meteringPointIds": { + "description": "List of meteringpoint-ids you are the registered owner of as a private person or your company has e legal reason to request in a customer/provider relationship. Example 707057500000000001", + "type": "array", + "items": { + "type": "string" + }, + "nullable": true + } + }, + "additionalProperties": false + }, + "GridTariffCollection": { + "description": "The response object with the grid tariff object and the meteringpointid object", + "type": "object", + "properties": { + "gridTariff": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/GridTariff" + }, + "meteringPointsAndPriceLevels": { + "type": "array", + "items": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/MeteringPointsAndPriceLevels" + }, + "nullable": true + } + }, + "additionalProperties": false + }, + "MeteringPointsAndPriceLevels": { + "description": "The response object with the grid tariff object and the meteringpointid object", + "type": "object", + "properties": { + "currentFixedPriceLevel": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/CurrentFixedPriceLevel", + "nullable": true + }, + "meteringPointIds": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/MeteringPointIds" + } + }, + "additionalProperties": false + }, + "GridTariff": { + "description": "The grid tariff object with the tariff type object and the tariff price object", + "type": "object", + "properties": { + "tariffType": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/TariffType" + }, + "tariffPrice": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/TariffPrice" + } + }, + "additionalProperties": false + }, + "TariffType": { + "description": "Information about the tariff type", + "type": "object", + "properties": { + "tariffKey": { + "description": "A keyword for this grid tariff in this grid company. Ex. private_tou_daynight.", + "type": "string", + "nullable": true + }, + "product": { + "description": "Name of the grid company product, for grid company internal use.", + "type": "string", + "nullable": true + }, + "companyName": { + "description": "Name of the grid company. Ex. Elvia AS", + "type": "string", + "nullable": true + }, + "companyOrgNo": { + "description": "Organization number of the grid company. Ex. 980489698", + "type": "string" + }, + "title": { + "description": "Name of the grid tariff type. Ex. Nettleie under 100MWh", + "type": "string", + "nullable": true + }, + "consumptionFlag": { + "description": "Indicates if this is a tariff for consumption or production. True = consumption", + "type": "boolean" + }, + "lastUpdated": { + "description": "The time of when the prices were last updated on the server side. No need to get prices if you already fetched the latest ones? Ex. 2021-11-05T00:00:00+01:00", + "type": "string", + "format": "date-time" + }, + "usePublicHolidayPrices": { + "description": "True if the grid tariff use the lowest prices during public holidays.", + "type": "boolean", + "nullable": true + }, + "useWeekendPrices": { + "description": "True if the grid tariff use the lowest prices during public weekends(Saturday and/or Sunday)", + "type": "boolean", + "nullable": true + }, + "fixedPriceConfiguration": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/FixedPriceConfiguration" + }, + "powerPriceConfiguration": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/PowerPriceConfiguration", + "nullable": true + }, + "resolution": { + "type": "integer", + "format": "int32" + }, + "description": { + "type": "string", + "nullable": true + } + }, + "additionalProperties": false + }, + "FixedPriceConfiguration": { + "description": "Parameters to visualize how the fixed price component is calculated. Ex. if months > 1, then the average of the maxhoursPerMonth for x months is the basis for the fixed price etc. Weighting is not supported in this version.", + "type": "object", + "properties": { + "basis": { + "description": "Description of fixed price basis. Values: monthlymax|dailymax|fusesize|fixed.", + "pattern": "monthlymax|dailymax|fusesize|fixed", + "type": "string" + }, + "maxhoursPerDay": { + "description": "Only for dailymax tariff. Number of hours per day. Null if not dailymax tariff. Ex. value is 1 if 1 hour per day is used as basis", + "type": "integer", + "nullable": true + }, + "daysPerMonth": { + "description": "Only for dailymax tariff. Number of days per month. Null if not dailymax tariff or if allDaysPerMonth is true. Ex. value is 1 if 1 day per month is used as basis", + "type": "integer", + "nullable": true + }, + "allDaysPerMonth": { + "description": "Only for dailymax tariff. Flag to indicate if a dailymax tariff uses all days per month as basis. True = all days per month is used. False = not all days per month are used or basis != dailymax. If false, then daysPerMonth must not be null.", + "type": "boolean", + "nullable": true + }, + "maxhoursPerMonth": { + "description": "Only for monthlymax tariff. Number of hours per month. Null if not monthlymax tariff.", + "type": "integer", + "nullable": true + }, + "months": { + "description": "For dailymax and monthlymax tariffs. Number of months maxhours are measured(averaged). Null if not dailymax or monthlymax tariff.", + "type": "integer", + "nullable": true + } + } + }, + "PowerPriceConfiguration": { + "description": "Parameters to visualize how the fixed price component is calculated. Ex. if months > 1, then the average of the maxhoursPerMonth for x months is the basis for the fixed price etc. Weighting is not supported in this version.", + "type": "object", + "properties": { + "reactivePowerPricing": { + "description": "True = reactive power prices applies and powerFactor indicates triggering point. False = reactive power prices does not apply.", + "type": "boolean", + "nullable": true + }, + "powerFactorPercentage": { + "description": "The power factor is used to trigger invoicing of reactive power. Ex. a power factor of 0.9 equals a power factor percentage of 50, meaning invoicing starts when reactive power is more than 50% of active power. Pricing applies to exceeding value above 50%. Ex. 50.0000", + "type": "number", + "format": "double", + "nullable": true + } + } + }, + "TariffPrice": { + "description": "The tariff price object with the prices", + "type": "object", + "properties": { + "hours": { + "type": "array", + "items": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/Hours" + }, + "nullable": true + }, + "priceInfo": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/PriceInfo" + } + }, + "additionalProperties": false + }, + "Hours": { + "description": "The time series with prices per resolution period.", + "type": "object", + "properties": { + "startTime": { + "description": "The start time of this resolution period. Ex. 2021-09-17T00:00:00+02:00", + "type": "string", + "format": "date-time" + }, + "expiredAt": { + "description": "The time when this resolution period is expired. Ex. 2021-09-17T01:00:00+02:00", + "type": "string", + "format": "date-time" + }, + "shortName": { + "description": "Short name for this resolution period. Ex. 0000-0100", + "type": "string", + "nullable": true + }, + "isPublicHoliday": { + "description": "Indicate if this is a public holiday true=public holiday", + "type": "boolean" + }, + "fixedPrice": { + "description": "Object with id references to fixed prices", + "type": "object", + "properties": { + "id": { + "description": "Unique id referencing gridTariffCollections.gridTariff.tariffPrice.priceInfo.fixedPrices.id. Ex. 216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "type": "string" + }, + "hourId": { + "description": "Unique id referencing gridTariffCollections.gridTariff.tariffPrice.priceInfo.fixedPrices.priceLevel.hourPrices.id Ex. a4afa37ae2ec41048e2b5153c35af1c5", + "type": "string" + } + }, + "additionalProperties": false + }, + "powerPrice": { + "description": "Object with id references to power prices", + "type": "object", + "properties": { + "id": { + "description": "Unique id referencing gridTariffCollections.gridTariff.tariffPrice.priceInfo.powerPrices.id. Ex. f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "type": "string" + }, + "hourId": { + "description": "Unique id referencing gridTariffCollections.gridTariff.tariffPrice.priceInfo.powerPrices.priceLevel.hourPrices.id Ex. 27134fc2-514d-479e-aedb-f13fc4f087d1", + "type": "string" + } + }, + "additionalProperties": false + }, + "energyPrice": { + "description": "Object with id references to energy prices and the hourly energy price included taxes", + "type": "object", + "properties": { + "id": { + "description": "Unique id referencing gridTariffCollections.gridTariff.tariffPrice.priceInfo.energyPrices.id. Ex. 0852242b-90a9-4f71-9903-e881d55194f9", + "type": "string" + }, + "total": { + "description": "Total price of energy component for this resolution period. This is for easier access to the hourly energy price. Ex. 0.2850", + "type": "number", + "format": "double" + }, + "totalExVat": { + "description": "Total price of energy component for this resolution period included all taxes except VAT. This is for easier access to the hourly energy price. Ex. 0.2280", + "type": "number", + "format": "double" + } + }, + "additionalProperties": false + } + }, + "additionalProperties": false + }, + "PriceInfo": { + "description": "The price object with the price details", + "type": "object", + "properties": { + "fixedPrices": { + "description": "Object with list of fixed prices", + "type": "array", + "items": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/FixedPrices" + }, + "nullable": true + }, + "powerPrices": { + "description": "Object with list of power prices", + "type": "array", + "items": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/PowerPrices" + }, + "nullable": true + }, + "energyPrices": { + "description": "Object with list of energy prices", + "type": "array", + "items": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/EnergyPrices" + }, + "nullable": true + } + }, + "additionalProperties": false + }, + "FixedPrices": { + "description": "Fixed prices object containing priceLevel list", + "type": "object", + "properties": { + "id": { + "description": "Unique id for this fixed price (decided by the start and end time of the price). Ex. 216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "type": "string" + }, + "startDate": { + "description": "Start date for when this fixed price is valid from, limited to the latest of either the fixed price start date or the request startTime date. Ex. 2021-01-01", + "type": "string", + "format": "date", + "nullable": true + }, + "endDate": { + "description": "End date is when this fixed price has expired, limited to the earliest of either the fixed price end date or the request endTime date. Ex. 2021-12-31", + "type": "string", + "format": "date", + "nullable": true + }, + "priceLevel": { + "type": "array", + "items": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/FixedPriceLevel" + } + } + }, + "additionalProperties": false + }, + "PowerPrices": { + "description": "Power price object containing properties for power price.", + "type": "object", + "properties": { + "id": { + "description": "Unique id for this power price (decided by the start and end time of the price). Ex. f122e3e7-3e0c-43ca-a3ce-051ec0339b98", + "type": "string" + }, + "startDate": { + "description": "Start date for when this power price is valid from, limited to the latest of either the power price start date or the request startTime date. Ex. 2021-01-01", + "type": "string", + "format": "date", + "nullable": true + }, + "endDate": { + "description": "End date is when this power price has expired, limited to the earliest of either the power price end date or the request endTime date. Ex. 2021-12-31", + "type": "string", + "format": "date", + "nullable": true + }, + "priceLevel": { + "type": "array", + "items": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/PowerPriceLevel" + } + } + }, + "additionalProperties": false + }, + "EnergyPrices": { + "description": "Energy price object containing properties for energy price. The total can be multiplied by consumption in this resolution period to get cost of energy price", + "type": "object", + "properties": { + "id": { + "description": "Unique id for this energy price (decided by the start and end time of the price). Ex. ba446e00-24be-4850-b212-fdc9f20cfef0", + "type": "string" + }, + "startDate": { + "description": "Start date for when this energy price is valid from, limited to the latest of either the energy price start date or the request startTime date. Ex. 2021-01-01", + "type": "string", + "format": "date", + "nullable": true + }, + "endDate": { + "description": "End date is when this energy price has expired, limited to the earliest of either the energy price end date or the request endTime date. Ex. 2021-12-31", + "type": "string", + "format": "date", + "nullable": true + }, + "season": { + "description": "Season for this resolution period. Ex. summer", + "pattern": "summer|winter|year", + "type": "string", + "nullable": true + }, + "level": { + "description": "Short name for the price level for this resolution period. Ex. CHEAP", + "pattern": "VERY_CHEAP|CHEAP|NORMAL|EXPENSIVE|VERY_EXPENSIVE", + "type": "string", + "nullable": true + }, + "total": { + "description": "Total price of energy component for this resolution period. Ex. 0.2585", + "type": "number", + "format": "double" + }, + "totalExVat": { + "description": "Total price of energy component for this resolution period included all taxes except VAT. Ex. 0.2068", + "type": "number", + "format": "double" + }, + "energyExTaxes": { + "description": "Price of energy component excluded taxes for this resolution period. Ex. 0.0299", + "type": "number", + "format": "double" + }, + "taxes": { + "description": "Taxes for the energy component for this resolution period. Ex. 0.2286", + "type": "number", + "format": "double" + }, + "currency": { + "description": "Currency. Ex. NOK", + "type": "string", + "nullable": true + }, + "monetaryUnitOfMeasure": { + "description": "Unit of measure for the energy prices. Ex. kr/kWh", + "type": "string", + "nullable": true + } + }, + "additionalProperties": false + }, + "FixedPriceLevel": { + "description": "The fixed prices and attributes for this price level for the resolution period. Ex. hour 00-01", + "type": "object", + "properties": { + "id": { + "description": "Unique fixed price component level id. Ex. edcf53ce-70d3-4fa0-8bfb-e79918335ab7", + "type": "string" + }, + "valueMin": { + "description": "Minimum value the level is based on. Included on this level for monthlymax and dailymax models(Ex. 0.0000 kWh/h). Included for fusesize based(Ex. 50 A). Null if this is the lowest level.", + "type": "number", + "format": "double", + "nullable": true + }, + "valueMax": { + "description": "Maximum value the level is based on. Excluded on this level for monthlymax and dailymax models(Ex. 2.0000 kWh/h which is the next level start value). Included for fusesize based(Ex. 50 A). Null if this is the highest level.", + "type": "number", + "format": "double", + "nullable": true + }, + "nextIdDown": { + "description": "Level id of the level below the current. Ex. null if this is the lowest level", + "type": "string", + "nullable": true + }, + "nextIdUp": { + "description": "Level id of the level above the current. Ex. a920b2af-a43f-4de4-aa86-33ea874bdbc4", + "type": "string", + "nullable": true + }, + "valueUnitOfMeasure": { + "description": "Unit of measure for the valueMin and Max. Ex. kWh/h", + "type": "string", + "nullable": true + }, + "monthlyTotal": { + "description": "Total monthly fixed price for this level included taxes. Ex 100.0000", + "type": "number", + "format": "double", + "nullable": true + }, + "monthlyTotalExVat": { + "description": "Monthly fixed price including all taxes except VAT. Ex 80.0000", + "type": "number", + "format": "double", + "nullable": true + }, + "monthlyExTaxes": { + "description": "Monthly fixed price exluded all taxes. Ex 80.0000", + "type": "number", + "format": "double", + "nullable": true + }, + "monthlyTaxes": { + "description": "Monthly total for all taxes including VAT for fixed price. Ex 20.0000", + "type": "number", + "format": "double", + "nullable": true + }, + "monthlyUnitOfMeasure": { + "description": "Unit of measure for the monthlyTotal fixed price. Ex. kr/month", + "type": "string", + "nullable": true + }, + "hourPrices": { + "description": "List of hourly prices for months with 31,30,29 and 28 days for this fixed price level.", + "type": "array", + "items": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/HourFixedPrices" + } + }, + "levelInfo": { + "description": "Information about this fixed price level. Ex. Power consumption: 8-12 kWh/h", + "type": "string", + "nullable": true + }, + "currency": { + "description": "The currency for all monetary units of measures. Ex. NOK", + "type": "string", + "nullable": true + }, + "monetaryUnitOfMeasure": { + "description": "Unit of measure for the hourPrices. Ex. kr/hour", + "type": "string", + "nullable": true + } + }, + "additionalProperties": false + }, + "PowerPriceLevel": { + "description": "The fixed prices and attributes for this price level for the resolution period. Ex. hour 00-01", + "type": "object", + "properties": { + "id": { + "description": "Unique fixed price component level id. Ex. edcf53ce-70d3-4fa0-8bfb-e79918335ab7", + "type": "string" + }, + "valueMin": { + "description": "Minimum value the level is based on. Included on this level for monthlymax and dailymax models(Ex. 0.0000 kWh/h). Included for fusesize based(Ex. 50 A). Null if this is the lowest level.", + "type": "number", + "format": "double", + "nullable": true + }, + "valueMax": { + "description": "Maximum value the level is based on. Excluded on this level for monthlymax and dailymax models(Ex. 2.0000 kWh/h which is the next level start value). Included for fusesize based(Ex. 50 A). Null if this is the highest level.", + "type": "number", + "format": "double", + "nullable": true + }, + "nextIdDown": { + "description": "Level id of the level below the current. Ex. null if this is the lowest level", + "type": "string", + "nullable": true + }, + "nextIdUp": { + "description": "Level id of the level above the current. Ex. a920b2af-a43f-4de4-aa86-33ea874bdbc4", + "type": "string", + "nullable": true + }, + "valueUnitOfMeasure": { + "description": "Unit of measure for the valueMin and Max. Ex. kWh/h", + "type": "string", + "nullable": true + }, + "monthlyActivePowerTotal": { + "description": "Total monthly active power price. To be multiplied with the number of kW (specifically kWh/h) on the maximum hour of the month. Ex. 27.500", + "type": "number", + "format": "double", + "nullable": true + }, + "monthlyActivePowerTotalExVat": { + "description": "Monthly active power price including all taxes except VAT. Ex 80.0000", + "type": "number", + "format": "double", + "nullable": true + }, + "monthlyActivePowerExTaxes": { + "description": "Monthly active power price excluded taxes. To be multiplied with the number of kW (specifically kWh/h) on the maximum hour of the month. Ex. 22.0000", + "type": "number", + "format": "double", + "nullable": true + }, + "monthlyActivePowerTaxes": { + "description": "Monthly active power taxes. To be multiplied with the number of kW (specifically kWh/h) on the maximum hour of the month. Ex. 5.5000", + "type": "number", + "format": "double", + "nullable": true + }, + "monthlyReactivePowerTotal": { + "description": "Total monthly reactive power price. May be multiplied with the number of kW (specifically kWh/h) which exceeds the powerFactorPercentage on the maximum hour of the month. Ex. 13.2625", + "type": "number", + "format": "double", + "nullable": true + }, + "monthlyReactivePowerTotalExVat": { + "description": "Monthly reactive power price including all taxes except VAT. Ex 80.0000", + "type": "number", + "format": "double", + "nullable": true + }, + "monthlyReactivePowerExTaxes": { + "description": "Monthly reactive power price excluded taxes. May be multiplied with the number of kW (specifically kWh/h) which exceeds the powerFactorPercentage on the maximum hour of the month. Ex. 10.6100", + "type": "number", + "format": "double", + "nullable": true + }, + "monthlyReactivePowerTaxes": { + "description": "Monthly reactive power taxes. May be multiplied with the number of kW (specifically kWh/h) which exceeds the powerFactorPercentage on the maximum hour of the month. ONLY USED FOR POWER PRICE. Ex. 2.6525", + "type": "number", + "format": "double", + "nullable": true + }, + "monthlyUnitOfMeasure": { + "description": "Unit of measure for the monthlyTotal power price. Ex. kr/month", + "type": "string", + "nullable": true + }, + "hourPrices": { + "description": "List of hourly prices for months with 31,30,29 and 28 days for this power price level.", + "type": "array", + "items": { + "$ref": "gridtariffapi.v1_0.common.schema.json#/HourPowerPrices" + } + }, + "levelInfo": { + "description": "Information about this fixed price level. Ex. Power consumption: 8-12 kWh/h", + "type": "string", + "nullable": true + }, + "currency": { + "description": "The currency for all monetary units of measures. Ex. NOK", + "type": "string", + "nullable": true + }, + "monetaryUnitOfMeasure": { + "description": "Unit of measure for the hourPrices. Ex. kr/hour", + "type": "string", + "nullable": true + } + }, + "additionalProperties": false + }, + "HourFixedPrices": { + "description": "Price per hour for fixed prices, with a unique id", + "type": "object", + "properties": { + "id": { + "description": "Unique id. Ex. 884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "type": "string" + }, + "numberOfDaysInMonth": { + "description": "The number of days the total fixed price is divided by to find the hourly price. Valid values: 31|30|29|28. Ex. 30", + "type": "integer" + }, + "total": { + "description": "Total price of fixed component for this resolution period included taxes. Calculated by monthlyTotal/(number of days in the month)/24 hours. Ex. 0.1388", + "type": "number", + "format": "double", + "nullable": true + }, + "totalExVat": { + "description": "Total price of fixed component for this resolution period included all taxes except VAT. Calculated by monthlyTotalExVat/(number of days in the month)/24 hours. Ex. 0.1388", + "type": "number", + "format": "double", + "nullable": true + } + }, + "additionalProperties": false + }, + "HourPowerPrices": { + "description": "Price per hour for power prices, with a unique id", + "type": "object", + "properties": { + "id": { + "description": "Unique id. Ex. 884d57a8-c8ac-462c-a04e-7554f3fc9c7a", + "type": "string" + }, + "numberOfDaysInMonth": { + "description": "The number of days the total power price is divided by to find the hourly price. Valid values: 31|30|29|28. Ex. 30", + "type": "integer" + }, + "activeTotal": { + "description": "Total price of active power for the power component for this resolution period included taxes. Calculated by monthlyActivePowerTotal/(number of days in the month)/24 hours. Ex. 0.0381", + "type": "number", + "format": "double", + "nullable": true + }, + "activeTotalExVat": { + "description": "Total price of active power for the power component for this resolution period included all taxes except VAT. Calculated by monthlyActivePowerTotalExVat/(number of days in the month)/24 hours. Ex. 0.0381", + "type": "number", + "format": "double", + "nullable": true + }, + "reactiveTotal": { + "description": "Total price of reactive power for the power component for this resolution period included taxes. Calculated by monthlyReactivePowerTotal/(number of days in the month)/24 hours. Ex. 0.0184", + "type": "number", + "format": "double", + "nullable": true + }, + "reactiveTotalExVat": { + "description": "Total price of reactive power for the power component for this resolution period included all taxes except VAT. Calculated by monthlyReactivePowerTotalExVat/(number of days in the month)/24 hours. Ex. 0.0184", + "type": "number", + "format": "double", + "nullable": true + } + }, + "additionalProperties": false + }, + "CurrentFixedPriceLevel": { + "description": "The last known fixed price level the MPID is placed in based on fuse size or max hour measurement", + "type": "object", + "properties": { + "id": { + "description": "Unique id referencing gridTariffCollections.gridTariff.tariffPrice.priceInfo.fixedPrices.id. Ex. 216783ff-5dda-4c38-b491-d6f0fcee9a9b", + "type": "string" + }, + "levelId": { + "description": "Unique id referencing gridTariffCollections.gridTariff.tariffPrice.priceInfo.fixedPrices.priceLevel.id. Ex. edcf53ce-70d3-4fa0-8bfb-e79918335ab7", + "type": "string" + }, + "levelValue": { + "description": "Value of the max hour setting the level of fixedprice. NOT IN USE YET AS IT REQUIRES A HIGHER LEVEL OF AUTHENTICATION AND AUTHORIZATION. Ex. 9.0000", + "type": "number", + "format": "double", + "nullable": true + }, + "lastUpdated": { + "description": "Time of when the last metervalues were received from the meters to calculate basis for the fixed level. Ex. 2021-09-17T02:00:00+02:00", + "type": "string", + "format": "date-time", + "nullable": true + } + }, + "additionalProperties": false + }, + "MeteringPointIds": { + "description": "List of meteringpoint-ids that has this tariff type at the time of the api call. Ex. 707057500000000002", + "type": "array", + "items": { + "type": "string" + }, + "nullable": true + } +} \ No newline at end of file diff --git a/DiginGridTariffAPI.v0_9.json b/old_versions/v0_9/DiginGridTariffAPI.v0_9.json similarity index 100% rename from DiginGridTariffAPI.v0_9.json rename to old_versions/v0_9/DiginGridTariffAPI.v0_9.json diff --git a/old_versions/v0_9/README.md b/old_versions/v0_9/README.md new file mode 100644 index 0000000..166bbd4 --- /dev/null +++ b/old_versions/v0_9/README.md @@ -0,0 +1,362 @@ +# DIGIN Nettariff API
Spesifikasjon + +NB! Dette er foreløpig versjon som kan bli endret før v1.0 publiseres. + +## Dokumentversjoner +| Dato | Versjon | Endring | +|-------------|----------------|----------------| +| 27.10.21 | 0.8 | Init | +| 17.11.21 | 0.9 | Soft release | +| | | | + +## 1. Bakgrunn +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. +
+## 2. Hensikt med dette dokumentet +Dokumentasjon av beslutninger tatt i DIGINs prosjektgruppe for å lage et standard API for utveksling av Nettariff data for styring/smarthus. + +## 3. Definisjoner +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 (NB. DEKKES IKKE AV APIet) +
+Unique id - En unik id som er garantert unik innenfor responsen fra ett nettselskap. Dette kan være for eksempel en GUID (Global Unique IDentifier) eller et løpenummer som unikt identifiserer elementet i responsen. Denne er ikke garantert unik på tvers av flere nettselskaper. +
+ +## 4. Versjoner +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 | + +## 5. Hva består spesifikasjonen av +Spesifikasjonen er opprettet ved bruk av standarden OpenAPI, https://www.openapis.org/. +
+Spesifikasjonen består av 2 json filer. +
+
+DiginGridTariffAPI.v0_9.json +
+Dette er OpenAPI spesifikasjonsfilen. Denne inneholder metoder og skjemadefinisjoner. +
+
+gridtariffapi.v0_9.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. +
+![image](https://user-images.githubusercontent.com/92018405/137330959-ff522cbb-87ee-41b1-9393-f683b0b21964.png) + + + +## 6. Implementasjon +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_9.json. +
+Merk at filene DiginGridTariffAPI.v0_9.json og gridtariffapi.v0_9.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! +
+
+ +## 7. Sikkerhet +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 kommer med følgende anbefalinger for implementering av GridTariffAPI: + + +## 8. Dato- og timeformat +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 + +## 9. Referanser +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 + +## 10. Forklaring av tariffstruktur og eksempler +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: + +
+Effektledd: + +
+
+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/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v0_9_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/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v0_9_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/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v0_9_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/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v0_9_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/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_LSDN_example2.json +
+
+
+Eksempler input: +
+Input with range parameter: https://github.com/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_input_example_range.json +
+Input with startTime and endTime parameters: https://github.com/digin-energi/API-nettleie-for-styring/blob/main/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_input_example_startTime_endTime.json +
diff --git a/old_versions/v0_9/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_input_example_range.json b/old_versions/v0_9/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_input_example_range.json new file mode 100644 index 0000000..eb64cae --- /dev/null +++ b/old_versions/v0_9/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_input_example_range.json @@ -0,0 +1,6 @@ +{ + "range": "string", + "meteringPointIds": [ + "707057500000000001","707057500000000002" + ] +} \ No newline at end of file diff --git a/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_input_example_startTime_endTime.json b/old_versions/v0_9/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_input_example_startTime_endTime.json similarity index 100% rename from doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_input_example_startTime_endTime.json rename to old_versions/v0_9/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_input_example_startTime_endTime.json diff --git a/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_HSDN_example1.json b/old_versions/v0_9/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_HSDN_example1.json similarity index 100% rename from doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_HSDN_example1.json rename to old_versions/v0_9/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_HSDN_example1.json diff --git a/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_LSDN_example1.json b/old_versions/v0_9/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_LSDN_example1.json similarity index 100% rename from doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_LSDN_example1.json rename to old_versions/v0_9/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_LSDN_example1.json diff --git a/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_LSDN_example2.json b/old_versions/v0_9/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_LSDN_example2.json similarity index 100% rename from doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_LSDN_example2.json rename to old_versions/v0_9/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_LSDN_example2.json diff --git a/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_dailymax_example1.json b/old_versions/v0_9/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_dailymax_example1.json similarity index 100% rename from doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_dailymax_example1.json rename to old_versions/v0_9/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_dailymax_example1.json diff --git a/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_fusesize_example1.json b/old_versions/v0_9/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_fusesize_example1.json similarity index 100% rename from doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_fusesize_example1.json rename to old_versions/v0_9/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_fusesize_example1.json diff --git a/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_monthlymax_example1.json b/old_versions/v0_9/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_monthlymax_example1.json similarity index 100% rename from doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_monthlymax_example1.json rename to old_versions/v0_9/doc/DiginGridTariffAPI.v0_9_meteringpointsgridtariffs_json_output_monthlymax_example1.json diff --git a/old_versions/v0_9/doc/GridTariffAPI-conceptual-application-communication-diagram_v1_0.jpg b/old_versions/v0_9/doc/GridTariffAPI-conceptual-application-communication-diagram_v1_0.jpg new file mode 100644 index 0000000..4562279 Binary files /dev/null and b/old_versions/v0_9/doc/GridTariffAPI-conceptual-application-communication-diagram_v1_0.jpg differ diff --git a/doc/GridTariffAPI-object-diagram_v0_9.jpg b/old_versions/v0_9/doc/GridTariffAPI-object-diagram_v0_9.jpg similarity index 100% rename from doc/GridTariffAPI-object-diagram_v0_9.jpg rename to old_versions/v0_9/doc/GridTariffAPI-object-diagram_v0_9.jpg diff --git a/gridtariffapi.v0_9.common.schema.json b/old_versions/v0_9/gridtariffapi.v0_9.common.schema.json similarity index 100% rename from gridtariffapi.v0_9.common.schema.json rename to old_versions/v0_9/gridtariffapi.v0_9.common.schema.json