API-et og endepunktene

RME tilbyr et test-miljø og et prod-miljø. Etter 1. januar 2026 vil vi bare anse data som blir sendt til produksjonsmiljøet som godkjent jf. NEM § 3-6. Nettselskapet er altså pliktig til å passe på at de sender inn data til riktig adresse.

API-et benytter Maskinporten, som er en løsning for tilgangsstyring for virksomheter som utveksler data. Løsningen sørger for sikker autentisering og tilgangskontroll for datautveksling mellom virksomheter (maskin-til-maskin). For å oversende data behøves riktig scope. Les mer om Maskinporten her Autentisering (Maskinporten).

• Adressen til både test-miljøet er: mottak.qa.dataplattform.nve.no
• Adressen til både produksjonsmiljø er: mottak.dataplattform.nve.no

De komplette endepunktene samt kravene på dataformatet og valideringsreglene på dataen finnes på Swagger:

• Testmiljø: Mottak API - QA
• Produksjonsmiljø: Mottak API

Som beskrevet ovenfor har RME valgt å utvikle et REST API som metode for innrapportering. Vi tilbyr 4 POST-endepunkter, der hvert endepunkt brukes til 4 ulike tilfeller:

• Nye tilknytninger som utløser anleggsbidrag. Her skal tidspunktene i bokstav b) og c) rapporteres. I tillegg skal nettselskapet bare rapportere hva ny kapasitet er.
• Eksisterende tilknytninger uten anleggsbidrag. Her skal ikke tidspunktene i bokstav b) og c) å innrapporteres. I tillegg skal nettselskapet rapportere initiell kapasitet, og ny kapasitet som spesifisert i forespørselen.
• Eksisterende tilknytninger som utløser anleggsbidrag. Her skal tidspunktene i bokstav b) og c) rapporteres. I tillegg skal nettselskapet rapportere initiell kapasitet, og ny kapasitet som spesifisert i forespørselen.
• Nye tilknytninger som IKKE utløser anleggsbidrag. Her skal ikke tidspunktene i bokstav b) og c) å innrapporteres. I tillegg skal nettselskapet bare rapportere hva ny kapasitet er. Med dagens regelverk skal nettselskapene kreve anleggsbidrag ved enhver nye tilknytning. Dette endepunktet er åpent i tilfelle det skulle oppstå spesielle situasjoner eller ved regelendringer.

Disse 4 POST-endepunktene krever ulik payload. RME har valgt denne løsningen for effektiv datavalidering. I alle 4 endepunktene skal nettselskapet også rapportere inn en «Forespørsel ID». Denne bestemmes av nettselskapet. API-et krever at et organisasjonsnummer ikke kan ha duplikater av forespørsels-ID. Det vil si at et nettselskap ikke kan rapportere inn samme forespørsel ID flere ganger.

I alle endepunktene krever vi at feltet "er_produksjonsrelatert" fylles ut med true/false. Dette feltet indikerer om endringen i kapasitet enten helt eller delvis skyldes produksjon. For eksempel, hvis en kunde vil øke kapasiteten på hovedsikringen grunnet installasjon av solceller, så skal feltet "er_produksjonsrelatert" fylles med "true". Hvis produksjon ikke er relevant i tilknytningsforespørselen i det hele tatt, skal feltet fylles med "false". Denne settes til "true" hvis forespørselen inneholder produksjonsdata. Hvis forespørselen ikke inneholder produksjonsdata, antar vi at forespørselen skyldes en endring i forbruk, og feltet settes til "false".