RSM-020: Anmodning om serviceydelse
Indholdsfortegnelse
- 1 Overblik
- 2 Aktivitetsdiagram
- 3 Anmodning om serviceydelse
- 4 Godkendelse af Anmodning om serviceydelse
- 4.1 Meddelelses indhold
- 4.1.1 Contextual model
- 4.1.2 Assembly model
- 4.1.3 Header Information
- 4.1.4 Payload - Attribut beskrivelse
- 4.1 Meddelelses indhold
- 5 Afvisning af Anmodning om serviceydelse
- 5.1 Meddelelses indhold
- 5.1.1 Contextual model
- 5.1.2 Assembly model
- 5.1.3 Header Information
- 5.1.4 Payload - Attribut beskrivelse
- 5.1 Meddelelses indhold
- 6 Ændringslog
Overblik
Forretningstransaktionen anvendes af elleverandøren til at sende en Request Service til netvirksomheden via målepunktsadministratoren (DataHub).
Aktivitetsdiagram
Anmodning om serviceydelse
Transaktionsstart
Transaktionen startes af en Request service med MarketDocument type = D03. En meddelelse kan indeholde en eller flere transaktioner.
Transaktionen kan initieres af Elleverandøren
Meddelelsen kan indeholde en af følgende årsagskoder (ProcessType):
Årsagskode | Dansk navn | Engelsk navn |
|---|---|---|
D22 | Anmodning om serviceydelse | Service request |
E20 | Leveranceophør | End of supply |
Modtagelse af DataHub / Netvirksomhed
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 service behandler DataHub anmodningen og videresender Request service til netvirksomheden.
Netvirksomheden behandler anmodningen om serviceydelse og sender svar
Meddelelses indhold
Request service indeholder en header og en Payload klasse beskrevet herunder.
Contextual model
Assembly model
Header Information
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 | 1 | type = D03 |
Forretningsårsag | MarketDocument /Process / ProcessType | An..3 | 1 | ProcessType = D22 |
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. |
Afsender rolle | MarketDocument / Sender_MarketParticipant / MarketRole / type | An..3 | 1 | Mulige afsender: |
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. |
Modtager rolle | MarketDocument / Receiver_MarketParticipant / MarketRole / type | An..3 | 1 | Mulige modtagere: |
Meddelelsesdato | MarketDocument / createdDateTime | Date | 1 | ISO-8601 standard anvendes. Dato og tid i UTC+0. Angiver oprettelsesdato for anmodning. |
Payload - Attribut beskrivelse
Navn | Cim Attribut | længde | Kardinalitet | Beskrivelse |
|---|---|---|---|---|
MktActivityRecord | 1..* |
| ||
Transaktions-ID | MktActivityRecord / mRID | An..36 | 1 | Afsenders unikke identifikation af transaktionen. |
Proces-ID | MktActivityRecord / BusinessProcessReference_ MktActivityRecord / mRID | An..36 | 0..1 | Unik identifikation af proces, som indsættes af DataHub og skal bruges i fremtidige svar til DataHub, når aktør svare i processen. Note: Det er frivilligt om aktør vil bruge proces-id i svar til DataHub |
Startdato | MktActivityRecord / Start_DateAndOrTime / dateTime | Datetime | 1 | ISO-8601 standard anvendes. Dato og tid i UTC+0. Angiver starttidspunkt (skæringsdato) for proces. |
Målepunkts-ID | MktActivityRecord / MarketEvaluationPoint / mRID | An..18 | 1 | Entydig identifikation af et målepunkt. GSRN = 18 cifre. CodingScheme = A10 |
Elleverandør-ID | MktActivityRecord / MarketEvaluationPoint / EnergySupplier_MarketParticipant / mRID | An..16 | 0..1 | Entydig identifikation af elleverandør. Aktøren er identificeret af et GLN-nummer eller en EIC-kode. |
Serviceart | MktActivityRecord / MarketEvaluationPoint / Request_ServiceCategory / kind | An..3 | 1 | Kode for forespørgsel om service. |
Service beskrivelse | MktActivityRecord / description | String | 0..1 | Uddybning af anmodning. Afsender skal være opmærksom på GDPR regler
|
Godkendelse af Anmodning om serviceydelse
Confirm reqeust Service sendes, hvis netvirksomheden kan imødekomme anmodningen om serviceydelse og hvis der ikke opdages fejl ved kontrol af meddelelsen i DataHub lagres informationen og der sendes en bekræftelse til aktøren med en Confirm Request service med MarketDocument type = D04
Meddelelsen sendes som beskrevet i klassediagrammet indeholdende samme ProcessType som
i anmodningen, og godkendelse sker ved at sætte status kode til A01 (Godkendt).
Confirm Request service vil altid indeholde en reference til den oprindelige meddelelse.
Meddelelses indhold
Confirm Request service indeholder en header og en Payload klasse beskrevet herunder.
Contextual model
Assembly model
Header Information
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 | 1 | type = D04 |
Forretningsårsag | MarketDocument /Process / ProcessType | An..3 | 1 | ProcessType = D22 |
Marked | MarketDocument / BusinessSector / type | An..2 | 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. |
Afsender rolle | MarketDocument / Sender_MarketParticipant / MarketRole / type | An..3 | 1 | Mulige afsender: |
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. |
Modtager rolle | MarketDocument / Receiver_MarketParticipant / MarketRole / type | An..3 | 1 | Mulige modtagere: |
Meddelelsesdato | MarketDocument / createdDateTime | Date | 1 | ISO-8601 standard anvendes. Dato og tid i UTC+0. Angiver oprettelsesdato for anmodning. |
Status type | MarketDocument / Reason /code | AN..3 | 1 | A01 =meddelelsen fuldstændig accepteret |
Payload - Attribut beskrivelse
Navn | Cim Attribut | længde | Kardinalitet | Beskrivelse |
|---|---|---|---|---|
MktActivityRecord | 1..* |
| ||
Transaktions-ID | MktActivityRecord / mRID | An..36 | 1 | Afsenders unikke identifikation af transaktionen. DataHub bruger UUID |
Proces-ID | MktActivityRecord / BusinessProcessReference_ MktActivityRecord / mRID | An..36 | 0..1 | Unik identifikation af proces (DataHub bruge UUID), som indsættes af DataHub og skal bruges i fremtidige svar til DataHub, når aktør svare i processen. af processen. Note: Det er frivilligt om aktør vil bruge proces-id i svar til DataHub |
Reference til original Transaktions-ID | MktActivityRecord / OriginalTransactionIDReference_ MktActivityRecord / mRID | An..36 | 0..1 | Entydig reference til oprindelig meddelelse |
Målepunkts-ID | MktActivityRecord / MarketEvaluationPoint / mRID | AN..18 | 1 | Entydig identifikation af et målepunkt. |
Attributter der ikke bruges i RSM-004 confirm
Data der indsendes i attributter der ikke benyttes i meddelelsen vil blive ignoreret af DataHub. Det betyder at DataHub ikke kigge på indhold af feltet, og dermed ikke afviser/godkender meddelelsen på baggrund af feltet.
Navn | Cim Attribut |
|---|---|
Service beskrivelse | MktActivityRecord / description |
Afvisning af Anmodning om serviceydelse
Reject Service sendes i 2 tilfælde:
Hvis der er konstateret fejl i forhold til forretningsregler, skal transaktionen afvises.
Hvis netvirksomheden ikke kan imødekomme anmodningen.
Dette sker med meddelelsen Reject request service med Document type = D04.
Meddelelsen sendes som beskrevet i klassediagrammet indeholdende samme ProcessType som
i anmeldelsen, og afvisning sker ved at sætte status kode til A02 (Afvist) og Reason Code sat til den
relevante kode fra forretningsreglerne.
Reject request service vil altid indeholde en reference til den oprindelige meddelelse.
Behandling af svar hos aktøren
Modtager elleverandøren af en Reject request service kan denne efterfølgende rette data i eget system og sende en ny Request service data for målepunktet.
Ved indholdsfejl, som normalt vil medføre en Confirm request service , skal der ske henvendelse til DataHub Support.
Meddelelses indhold
Reject Request service indeholder en header og en Payload klasse beskrevet herunder.
Contextual model
Assembly model
Header Information
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 | 1 | type = D04 |
Forretningsårsag | MarketDocument /Process / ProcessType | An..3 | 1 | ProcessType = D22 |
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. |
Afsender rolle | MarketDocument / Sender_MarketParticipant / MarketRole / type | An..3 | 1 | Mulige afsender: |