BRS-NO-624 Oppdatering av tredjepartstilgang via URL

Oversikt

Før oppdatering av tilgang skal tredjepart ha gyldig kontrakt med sluttbruker og med Elhub.

Tredjepart kan med denne prosessen få tilgang til måleverdier og grunndata uten å ha kjennskap til hvilke målepunkt sluttbruker eier eller sluttbrukers fødselsnummer/organisasjonsnummer.

Prosessflyt

Prosessforløp

Hovedprosessen er som følger:

• Tredjepart sender melding – URL til sluttbruker fra sitt datasystem/applikasjon.

• Sluttbruker logger inn på Elhub Min side via ID-porten.

• Sluttbruker gir tilgang til de målepunktene tredjepart skal ha tilgang til, eventuelt avviser forespørselen.

• Tredjepart får melding tilbake om hvilke målepunkter tilgang er gitt for samt startdato, eventuelt melding dersom forespørsel ikke godkjennes.

Forutsetning

• GLN-nummer til tredjepart og returadresse må whitelistes hos Elhub. Informasjon om GLN-nummer og returadresse sendes til post@elhub.no.

Fra tredjepart til Elhub

Tredjepartene kan videresende sluttbrukere til Elhub Min Side for å godkjenne BRS-NO-624. Adressen skal ha følgende format: 

https://minside.elhub.no/third-party-access/authorize?client_id=<GLN number>&request_id=<request id from third party>&scope=Full&redirect_url=<URL>

Eksempel:

https://minside.elhub.no/third-party-access/authorize?client_id=1234567890123&request_id=df88e4ca-5804-4dac-aaf4-170a58f5bb36&scope=Full&redirect_url=minurl.no?some_param=value

• Forklaring:

  • “GLN-nummer” er GLN-nummer til tredjepart

  • “request_id” skal være på UUID format

  • “scope” kan være enten “Full” eller “Limited”

  • “redirect_url” er en valgfri returadresse etter at tilgang er gitt/ avbrutt av sluttbruker. Hvis dette ikke er satt bør brukeren lukke siden selv

Returmelding til tredjepart med kontraktsinformasjon

Det sendes returmelding etter BRS-NO-624 er fullført til tredjepart, adressen returmeldingen sendes til må whitelistes hos Elhub. Dersom tredjepart har angitt en redirect_rl i forespørsel sendes bruker tilbake til tredjeparten.

Det sendes én returmelding per BRS-NO-624 brukeren får. Returmeldingen sendes som en POST med Content-Type “application/json”. Denne kan inneholde et eller flere “notification”-objekter, avhengig av antall målepunkter brukeren godkjenner.

Returmeldingen inneholder følgende elementer:

• eelhubGLN – Elhub’s GLN nummer

• ThirdpartyGLN– tredjepart sitt GLN nummer

• contractId - unik id for kontrakt i Elhub

• requestid – request_id som er mottatt fra tredjepart

• accessCode - Full or Limited

• MeteringPointId– målepunktid som det er gitt tilgang på

• Start – Dato for innflytt for sluttbruker på målepunktet

• End - Dato tilgang gjelder til dersom dato er angitt fra sluttbruker, default dato er 3 år frem i tid

• Grunndatafelter

  • Gridowner

    • navn

    • GLN

  • MGA

    • navn

    • kode

  • meteringPointAddress

    • Gatenavn,

    • postkode

    • by

  • consumptioncode - forbrukskode

  • meterNumber - målernummer

  • estimatedAnnualConsuption

  • estimatedAnnualProduction ( hvis pluss punkt)

Eksempel på returmelding til tredjepart

BRS-NO-624-returmelding-eksempel v5.pdf

Valideringsregler