Introduktion

Denne bilagsrapport beskriver den samling af forretningstransaktioner, der indgår i dokumentet "Forretningsprocesser for det danske elmarked".

Bilagsrapporten indeholder en specifikation af håndteringen af forretningstransaktionerne der bliver anvendt i det danske elmarked.

En forretningstransaktion i dette dokument skal håndteres med udgangspunkt i reglerne, som er angivet i afsnit om Fejlhåndtering og kvitteringer, der beskriver den generelle fejlhåndtering, hvilket omfatter den validering af meddelelserne, som skal ske før den mere specifikke validering af forretningstransaktion.

Formål og målgruppe

Dokumentet har til formål at klarlægge og beskrive forretningstransaktionerne samt indholdet af data for de beskrevne forretningsprocesser. Dokumentets målgruppe er alle aktører og disses systemleverandører.

Forretningstransaktioner

En forretningstransaktion er uafhængig af andre forretningstransaktioner, men kan sammen med andre transaktioner indgå i en eller flere forretningsprocesser.

En forretningstransaktion beskriver udvekslingen af meddelelser mellem to aktørers it-systemer. Yderligere specificeres en del af den interne håndtering i en aktørs it-system.

Ved modtagelse af en meddelelse skal det valideres om den er i overensstemmelse med de forretningsregler der er angivet i Forretningsprocesser for det danske elmarked, hvorefter svar afsendes.

Hver meddelelse indeholder en liste af attributter, som vises i form af et klassediagram og i enkelte tilfælde anvendes en dependency matrix. En dependency matrix anvendes, hvis det er muligt at sende en meddelelse med forskellige attributter alt efter formål.

Dette dokument beskriver således alle forretningstransaktioner, der indgår i dokumentet: Forretningsprocesser for det danske elmarked.

Beskrivelse af meddelelsesstruktur

Den strukturelle definition af de enkelte meddelelser er dels beskrevet tekstuelt i dette dokument, dels specificeret ved hjælp af en række XML-skemaer, som kan hentes på Energinets hjemmeside.

På grund af tekniske begrænsninger i syntaksen for XML/JSON-skemaer er der situationer, hvor attributter vil være angivet som valgfri, på trods af at de logisk vil være krævet et sted i meddelelsen og valgfri eller endog ikke tilladt et andet sted. Dette fremkommer når samme datatype genanvendes i samme meddelelse, men i lidt forskellig kontekst. I disse tilfælde vil afhængigheden for den enkelte instans af en attribut som beskrevet her i dokumentet være den gældende og den som DataHub validerer efter.

Eks. Next reading date skal være på NG6 målepunkter, men ikke på øvrige målepunkter

Eks. Netsettlementgroup – kun forbrugs- og produktionsmålepunkter (E17 og E18) harangivet nettoafregningsgruppe. Øvrige målepunktstyper har ikke angivet nettoafregningsgruppe.

Læsevejledning

De enkelte RSM er beskrevet ud fra den generelle IEC standard, hvorfor der vil være en række attributter, som ikke bruges i Danmark. Attributter der ikke bruges, vil ikke have noget navn i kolonnen ”Danish attribute” og ofte vil der også være en bemærkning i kolonnen ”Remark” som viser at der ikke bruges i Danmark.

Meddelelsesudveksling

Alle beskeder, der kommunikeres via webinterfacet i DataHub, er XML/JSON beskeder og består af:

·         En MessageHeader, som indeholder informationer, der bruges til styring af den bagvedliggende forretningsproces. Det vil sige identifikation af den enkelte besked og dens indhold og identifikation af den forretningsproces, beskeden skal behandles af.

·         En eller flere Payloads (forretningstransaktioner), som hver indeholder en forretningsbesked.

Validering mod XML-skema

XML-skemaer[1] definerer indhold, struktur og typer for XML-meddelelser. Med en XSD definition er det muligt at:

• Beskrive indholdet i XML-meddelelsen

• Validere XML-meddelelsen

• Definere datafacetter (restriktioner for dataindhold)

• Definere datamønstre (dataformater)

DataHub validerer alle XML-meddelelser mod det tilhørende skema. Valideringen sker i samme webservice session, og afsender bliver øjeblikkeligt orienteret om resultatet.

Det er til enhver tid Energinet, der fastlægger, hvilket XML-skema der skal anvendes for en given XML-meddelelse.

Note: Beskeder indsendt i JSON format, vil blive konverteret til XML.

[1] XML Schema Definition (XSD)