RSM-015: Anmodning om måledata

RSM-015: Anmodning om måledata

 

>> Link til ændringslog >>

Overblik

Figur 1 – Use Case Diagram for Anmod om måledata på målepunkt

Anmod om måledata på et målepunkt (Request for Validated Metered Data) anvendes af elleverandør, systemansvarlig eller netvirksomhed til at forespørge om måledata på målepunktsniveau hos DataHub.

Aktivitets diagram

Figur 2 – Aktivitetsdiagram for Fremsend måledata for et målepunkt

Anmodning om måledata

Transaktionsstart

Transaktionen initieres med en Request validated measure data med MarketDocument type = E73. En meddelelse kan indeholde en eller flere transaktioner.

Meddelelsen kan indeholde en af følgende årsagskoder (ProcessType):

Årsagskode

Dansk navn

Engelsk navn

Årsagskode

Dansk navn

Engelsk navn

E23

Periodisk opgørelse

Periodical metering

E30

Historisk data

Historical data

Søge kriterier

Det er op til aktøren at sammensætte en korrekt forespørgsel. Nedenstående tabel opstiller de søgeregler der er gældende:

Årsagskode

Søge Kriterie

Årsagskode

Søge Kriterie

E30

MålepunktsID

E23

MålepunkstID og periode for måledata

Modtagelse i DataHub

I tilfælde af at der sker verifikationsfejl i forhold til skemaet, skal meddelelsen afvises synkront med en HTTP Error.

Derefter valideres meddelelsen i overensstemmelse med forretningsreglerne (BRS), og hvis der er fejl afvises meddelelsen.

Hvis der ikke opdages fejl ved kontrol af Request validated measure data Data meddelelsen sendes de ønskede måledata til aktøren, som angivet i Notify validated measure data.

Måledata meddelelsen vil altid indeholde en reference til den oprindelige anmodning.

Meddelelsen indhold

Request for Validated Metered Data indholder en header og en payload beskrevet herunder.

Contextual Model

image-20250109-135408.png

Assembly model

image-20250109-135430.png

Header information

Navn

Cim Attribut

længde

Kardi-nalitet

Beskrivelse

Navn

Cim Attribut

længde

Kardi-nalitet

Beskrivelse

MarketDocument

1

 

Meddelelses-ID

MarketDocument / mRID

An..36

1

Unik identifikation af meddelsen. DataHub bruger UUID

Meddelelsesnavn

MarketDocument / type

An..3
kode

1

type = E73

Forretningsårsag

MarketDocument /Process / ProcessType

An..3
kode

1

ProcessType = E23
ProcessType = E30

Marked

MarketDocument / BusinessSector / type

An..2

0..1

type = 23 - Electricity Supply Industry

Afsender ID

MarketDocument / Sender_MarketParticipant / mRID

An..16

1

Entydig identifikation af afsender. Aktøren er identificeret af et GLN-nummer eller en EIC-kode.
CodingScheme = A10 angives for 13 cifret GLN.
CodingScheme = A01 angives for 16 tegns EIC-kode.

Afsender rolle

MarketDocument / Sender_MarketParticipant / MarketRole / type

An..3

1

Mulige afsender:
type = DDQ
type = MDR
type = DDM
type = EZ
type = STS

Ved årssummer er det kun DDQ der kan anmode

Modtager ID

MarketDocument / Receiver_MarketParticipant / mRID

An..16

1

Entydig identifikation af afsender. Aktøren er identificeret af et GLN-nummer eller en EIC-kode.
CodingScheme = A10 angives for 13 cifret GLN.
CodingScheme = A01 angives for 16 tegns EIC-kode.

Modtager rolle

MarketDocument / Receiver_MarketParticipant / MarketRole / type

An..3

1

Mulige modtagere:
type= DGL

Meddelelsesdato

MarketDocument / createdDateTime

Date
time

1

ISO-8601 standard anvendes.

Dato og tid i UTC+0. Angiver oprettelsesdato for anmodning.
Format: YYYY-MM-DDThh:mm:ssZ

Payload - Attribut beskrivelse

Navn

Cim Attribut

længde

Kardinalitet

Beskrivelse

Navn

Cim Attribut

længde

Kardinalitet

Beskrivelse

Series

1..*

 

Transaktions-ID

Series / mRID

An..36

1

Afsenders unikke identifikation af transaktionen.

Her bruges UUID

Startdato

Series / Start_DateAndOrTime / dateTime

Datetime

0..1

ISO-8601 standard anvendes.

Dato og tid i UTC+0. Angiver starttidspunkt (skæringsdato) for proces.
Format: YYYY-MM-DDThh:mm:ssZ

Der kan kun anmodes om data for 3 år (38 mdr) af gangen og kun 8 år tilbage i tid.

Ved anmodning om årssum angives startdatoen i anmodningen med korrekt datoformat, men datoen vil altid blive ignoreret da anmodningen behandles ud fra modtagelsesdatoen i DataHub og 12 måneder tilbage eller seneste tilflytningsproces.

Slutdato

Series / End_DateAndOrTime / dateTime

Datetime

0..1

Målepunkts-ID

Series / MarketEvaluationPoint / mRID

An..18

1

Entydig identifikation af et målepunkt. GSRN = 18 cifre. CodingScheme = A10

Ved årssummer er det kun målepunktstype angivet i BRS-024, der kan benyttes.

Afvisning af anmodning

I tilfælde af, at der konstateres en fejl i forhold til forretningsreglerne, skal meddelelsen afvises. Dette sker med en Reject request validated measure data meddelelse med MarketDocument type = ERR. Status kode sættes til A02 (Rejected) samt at årsagskode sat til den relevante kode fra forretningsreglerne. Desuden udfyldes Reasontext hvis nødvendigt.

Meddelelsen indhold

Contexual model

image-20250115-105409.png

Assembly model

image-20250115-105453.png

Header Information

Navn

Cim Attribut

Str.

Kardi-nalitet

Beskrivelse

Navn

Cim Attribut

Str.

Kardi-nalitet

Beskrivelse

MarketDocument

1

 

Meddelelses-ID

MarketDocument / mRID

An..36

1

Unik identifikation af meddelelsen. DataHub bruger UUID

Meddelelsesnavn

MarketDocument / type

An..3
kode

1

Unikt for hvert dokumenttype, her bruges
type = ERR

Forretningsårsag

MarketDocument /Process / ProcessType

An..3
kode

1

ProcessType = E23
ProcessType = E30

Marked

MarketDocument / BusinessSector / type

An..2

0..1

type = 23 - Electricity Supply Industry

Afsender-ID

MarketDocument / Sender_MarketParticipant / mRID

An..16

1

Entydig identifikation af afsender. Aktøren er identificeret af et GLN-nummer eller en EIC-kode.
CodingScheme = A10 angives for 13 cifret GLN.
CodingScheme = A01 angives for 16 tegns EIC-kode.

Afsender rolle

MarketDocument / Sender_MarketParticipant / MarketRole / type

An..3

1

Mulige afsender:
type = DGL

Modtager-ID

MarketDocument / Receiver_MarketParticipant / mRID

An..16

1

Entydig identifikation af afsender. Aktøren er identificeret af et GLN-nummer eller en EIC-kode.
CodingScheme = A10 angives for 13 cifret GLN.
CodingScheme = A01 angives for 16 tegns EIC-kode.

Modtager rolle

MarketDocument / Receiver_MarketParticipant / MarketRole / type

An..3

1

Mulige modtager:
type = DDQ
type = MDR
type = DDM
type = EZ
type = STS

Meddelelsesdato

MarketDocument / createdDateTime

Date
time

1

ISO-8601 standard anvendes.

Dato og tid i UTC+0. Angiver oprettelsesdato for anmodning.
Format: YYYY-MM-DDThh:mm:ssZ

Status Type

MarketDocument / Reason /code

An..3
Kode

0..1

A02 Message fully rejected

Payload - Attribut beskrivelse

Navn

Cim Attribut

længde

Kardinalitet

Beskrivelse

Navn

Cim Attribut

længde

Kardinalitet

Beskrivelse

Series

1..*

 

Transaktions-ID

Series / mRID

An..36

1

Afsenders unikke identifikation af transaktionen.

Her bruges UUID

Reference til original Transaktions-ID

Series / OriginalTransactionReference_Series / mRID

An..36

0..1

Entydig reference til oprindelig meddelelse.

Målepunkts-ID

Series / MarketEvaluationPoint / mRID

An..18

0..1

Entydig identifikation af et målepunkt. GSRN = 18 cifre. CodingScheme = A10

Navn

Cim Attribut

længde

Kardinalitet

Beskrivelse

Navn

Cim Attribut

længde

Kardinalitet

Beskrivelse

Series/ Reason

1..*

 

Afvisningsårsag

Series/ Reason / code

An..3
kode

1

Anvendes hvis status lig afvist til at beskrive årsag for afvisning.

Fejltekst

Series/ Reason / text

String

0..1

Fejltekst

Ændringslog

Version

Dato

Ændringer siden sidste version

Version

Dato

Ændringer siden sidste version

1.7.3

2026-03-10

Alle kardinaliteter tilpasset, så de passer til skemaerne, inkl. gruppe opdeling (blå linier)
Fejltekst i reject meddelelsen er ændret fra 128 karakter til ubegrænset i længde.

1.7.2

2025-07-04

Periode er begrænset til Der kan kun anmodes om data for 3 år af gangen og kun 8 år tilbage i tid.

1.7.1

2025-06-18

Overskrift er ændret fra “Anmod om måledata på et målepunkt” til “Anmodning om måledata”.

1.7.0

2025-01-15

Version 1.7 er en sammenfatning af dokumenterne CIM Based Ediel transaktioner for det danske elmarked 1.6 og EDI transaktioner for det danske elmarked ver. 5.7.9.