> For the complete documentation index, see [llms.txt](https://docs.videc.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.videc.de/june5-datatrans/ausgabeformate/mscons.md). # MSCONS MSCONS ist die Abkürzung für "Metered Services Consumption report message", ist ein elektronisches Nachrichtenformat und dient dem Austausch von z.B. Energiedaten. Dieses wird benötigt wenn z.B. zwei Geschäftspartner (Energielieferant und Energieverbraucher) Bewegungsdaten wie z.B. 15Min Verbrauchsdaten abrechnen bzw. austauschen möchten. JUNE5.DataTrans unterstützt eine Teilmenge der MSCONS Spezifikation. Zum Dokumentieren einer praktischen MSCONS Datei wurden folgende Dokumente von [www.edi-energy.de](http://www.edi-energy.de) verwendet: * "EDI\@Energy MSCONS Nachrichtenbeschreibung", Version 2.3c vom 01.04.2021 * "EDI\@Energy MSCONS Anwendungshandbuch", Stand MIG 2.3c, Version 3.0 vom 01.04.2021 Zum Validieren einer Testumgebung wurden folgende Programme verwendet: * EDI Viewer 1.14.27.0, siehe [www.ediviewer.de](http://www.ediviewer.de) * EDI View bzw. EDIFACT Viewer, siehe [www.kilinski.de](http://www.kilinski.de) #### Quelle JUNE5 bzw. ACRON ist mit JUNE5.DataTrans die Quelle der Information. Die im JUNE5 bzw. ACRON vorliegenden Messwertzeitreihen sind an Verfahrensgrößen gebunden. Die Quelldaten bestehen i.A. nur aus den ACRON Variablen und den Messwertzeitreihen einer Variablen. #### Ziel Das Ziel ist i.A. ein Drittsystem welches die Messwertzeitreihen im MSCONS Format empfängt. Das Importformat des Drittsystems muss dem MSCONS und somit dem EDIFACT Standard entsprechen. Da das MSCONS Format mehr als nur Messwertzeitreihen enthält müssen ggf. Werte, Eigenschaften oder Parameter hinzugefügt werden. Diese Parameter werden teilweise im ACRON, JUNE5.DataTrans und in Konfigurationsdateien mit der Endung .tedi hinterlegt. Aus der Konfiguration und den Messwertzeitreihen kann dann das JUNE5.DataTrans Dateien im MSCCONS Format erzeugen und versenden. Der Datentransfer erfolgt i.A. nach Abschluss einer Zeiteinheit, z.B. 1x täglich oder 1x monatlich. #### Weitere Basis Informationen Messlokation bzw. Zählpunkt oder Zählpunktbezeichnung (ZPB) Die Messlokation (frühere Bezeichnung: Messstelle oder Zählpunkt) ist eine reale, physikalische Lokation, an der Energie (Strom oder Gas) tatsächlich gemessen wird. Die Messlokation identifiziert eine Messung an einer Örtlichkeit (z.B. Energiezähler). Es können aber auch mehrere Zähler zu einem virtuellen Messpunkt zusammengefasst werden. Die Messlokation wird vom Energieversorger bereitgestellt und setzt sich in Deutschland als auch in Österreich aus einer 33-stelligen alphanumerischen Zeichenkette zusammen: * Ländercode nach DIN ISO 3166 (2 Stellen) * Verteilnetzbetreiber (6 Stellen) * Postleitzahl (5 Stellen) * Zählpunktnummer (20 Stellen alphanumerisch) **Beispiel:** DE0073535114700000EVU0BHKWM010P01 DE00000099999AAAABBBBCCCCDDDDEEEE #### OBIS-Kennzahl OBIS (Object Identification System) Kennzahlen bzw. OBIS Codes werden in der Energiewirtschaft eingesetzt. Sie ermöglichen den standardisierten elektronischen Datenaustausch zwischen Kommunikationspartner z.B. im MSCONS Format. Bei Messeinrichtungen (z.B. Zählern) dienen sie dazu, Messgrößen eindeutig zu identifizieren. Die Kennzahl besteht dabei aus 6 Wertegruppen, von denen jedoch nur 5 am deutschen Energiemarkt verwendet werden. Diese sind mit A-F gekennzeichnet und verwenden folgenden Trenner: A-B:C-D-E Die Wertegruppen sind dabei wie folgt belegt: A: Medium (z.B. 0 Abstrakt, 1 Elektrizität, 5 Kälte/Wärme, 7 Gas, 8 Wasser kalt, 9 Wasser warm, 16 Öl, 17 Druckluft, 18 Stickstoff) B: Kanal (z.B. 1-127 Messgerätespezifischer Kanal, 128 Einsparung, 129 Sollwert, 130 Prognose, 135 SLP Montag) C: Messgröße (z.B. Wirk-, Blind-, Scheinleistung, Strom, Spannung) D: Messart (Maximum, aktueller Wert) E: Tarif **Beispiel:** 1-1:1.8.0 {% hint style="info" %} Je nach Medium können die weiteren Parameter andere Bedeutungen haben. Die hier dargestellten Werte beziehen sich auf Elektrizität. {% endhint %} #### Allgemeines zu MSCCONS MSCONS ist ein genormtes Format in der Energiewirtschaft und basiert auf dem internationalen Standard EDIFACT. Es ermöglicht eine genormte Übertragung von z.B. Lastprofil, Zählerdaten, Energiemengen aber auch Wassermengen oder Ölmengen. MSCONS ist in Ebenen (Layer) organisiert und verwendet folgende formatspezifischen Symbole:
BezeichnungSymbol
Segment Endzeichen'
Datenelement Trenner+
Gruppendatenelement Trenner:
Dezimalzeichen.
Fluchtsymbol?
Eine MSCONS Datei enthält häufig keine Zeilenumbrüche, die Endung der Datei lautet .edi oder auch .txt. #### Strom, Gas oder Wärme Strom bzw. Gas oder Wärmemengen haben unterschiedliche Anforderungen und Prüfidentifikatoren (z.B. RFF). Da ACRON bei der Identifikation und Einheit frei konfiguriert werden kann sind Kenntnisse über den Hintergrund einer Verfahrensgröße (Strom oder Gas) erforderlich. Ohne diese Information kann keine brauchbare MSCONS Datei erstellt werden. #### Funktionsweise Die Schnittstelle MSCONS im JUNE5.DataTrans arbeitet mit Templates. In einem Template (\*.tedi) wird die MSCONS Datei "vorkonfiguriert" und während des Betriebes mit Laufzeitdaten aus dem ACRON / JUNE5 aufgefüllt bzw. erweitert. Diese Templates dienen einer Gruppierung damit ggf. Anpassungen für mehrere Messstellen an einer zentralen Stelle erfolgen kann. **Beispiel:** Template\_001\_Kältemengen.tedi Template\_002\_Brennstoffe.tedi Template\_003\_ElektrischeArbeit.tedi ... In der .tedi Datei liegt somit das Grundgerüst für eine MSCONS Datei, die anschließend mit weiteren Bewegungsdaten vom JUNE5.DataTrans erweitert wird. Die Dateien sind im Verzeichnis "*C:\ProgramData\VIDEC\JUNE5.DataTrans\Configuration\MSCONS\\"* abzulegen, damit diese eingelesen werden können. #### Konfiguration ACRON Damit nur die Messgrößen verwendet werden die vorkonfiguriert sind, erfolgt an dem Beschreibungsfeld der Verfahrensgröße im ACRON eine Parametrierung nach folgendem XML-Schema: ```xml Template_003_ElektrischeArbeit DE000000123456789 1-2:3.5.6 ``` **TEDI** = MSCCONS Tedi Datei **LOCATION** = Örtlichkeit der Messstelle, i.A. eine Zähler ID o.Ä. **OBIS** = Der zu verwendende OBIS Code Diese drei Felder müssen durch den Anwender gefüllt werden. Liegt nur ein oder zwei Felder vor werden keine Daten exportiert. Arbeitsweise Beim Starten eines MSCONS-Auftrages vom JUNE5.DataTrans wird folgende Logik durchlaufen: 1. Auslesen aller Messgrößen aus der JUNE5 Konfiguration gemäß Filterbedingung im JUNE5.DataTrans 2. Einlesen der Felder TEDI, LOCATION und OBIS aus der Verfahrensgrößen Beschreibung 3. Für jede Messgröße wird eine eigener "Unterauftrag" erzeugt, der ausschließlich diese eine Messgröße beinhaltet 4. Für jeden "Unterauftrag" wird die jeweilige TEDI-Datei eingelesen. 5. Anschließend werden die folgenden Felder subsituieren:
EbeneSegmentSegment-NameSubsituierter Wert
0UNBNutzdaten-KopfsegmentDatum der Erstellung
Uhrzeit der Erstellung
Datenaustauschreferenz
UNHNachrichtenkopfsegmentNachrichten-Referenznummer
BGMBeginn der NachrichtDokumentennummer
1DTMNachrichtendatumDatum/Uhrzeit/Zeitspanne
2LOCIdentifikationsangabe

Lokalisierung des Meldepunktes

(LOCATION aus ACRON Konfiguration)

3DTMBeginn Messperiode ÜbertragungszeitraumBeginn datum & -Uhrzeit der Messperiode
DTMEnde Messperiode ÜbertragungszeitraumEnddatum & -Uhrzeit der Messperiode
DTMErfassungsdatumDatum & Uhrzeit des Erfassungsdatum
4PIAProduktidentifikation

Produkt-/Leistungsnummer

(OBIS-Kennzahl aus ACRON Konfiguration)

QTYMengenangaben / MesswertMenge, Qualifier
Menge / Wert
5DTMAblesedatumDatums- oder Uhrzeits- oder Zeitspannen-Funktion, Qualifier
Datum oder Uhrzeit oder Zeitspanne, Wert
Datums- oder Uhrzeit- oder Zeitspannen-Format, Code
0UNTNachrichten-EndesegmentAnzahl der Segmente in einer Nachricht

Nachrichten-Referenznummer

(Die Referenznummer aus dem UNH-Segment muss hier wiederholt werden)

UNZNutzdaten-Endesegment

Datenaustauschzähler

(Anzahl der Nachrichten oder Nachrichtengruppen in der Übertragungsdatei)

Datenaustauschreferenz

(Identisch mit DE0020 im UNB-Segment)

Die Segmente QTY und DTM aus LEVEL 4 & 5 werden dann gemäß der Zeitreihe wiederholt bis alle Werte übernommen wurden. 1. Schreiben der Datei im Format MSCONS\_PVI\_LOC\_YYYYMMDDHHMMSS.edi {Auftragsvorlagenname}\_{Messwertnummer}\_{Location}\_{Datum im Format 'yyyyMMddHHmmss}.edi; **Beispiel:** MSCONS\_001\_DE00000099999AAAABBBBCCCCDDDDEEEE\_20220613081005.edi MSCONS\_002\_DE123456890123456789\_20220613081005.edi MSCONS Nachrichtenstruktur Edifact Struktur // Prüfidentikator bzw. Beschreibung ## UNB - 0000 - Nutzdaten-Kopfsegment
NameBezeichnerSpezifikationAnwendung / Bemerkung / Format
Datum der ErstellungS004
0017Format: JJMMTT
Uhrzeit der Erstellung0019Format: HHMM
Datenaustauschreferenz0020Eindeutige Referenz zur Identifikation der Übertragungsdatei, vergeben vom Sender.
Für die Datenaustauschreferenz wird eine 8-stelliger Alphanumerischer Text erzeugt mit dem Präfix 'J5.DT-'. **Beispiel:** ``` UNB+UNOC:3+Quelle4711:500+Ziel4712:500+220101:0800+J5.DT-am439al1++VL' ``` ## UNH - 0010 - Nachrichtenkopfsegment ## Das UNH Segment dient dazu, eine Nachricht zu eröffnen, zu identifizieren und zu spezifizieren.
NameBezeichnerAnwendung / Bemerkung
Nachrichten-Referenznummer0062Eindeutige Nachrichtenreferenz des Absenders. Nummer der Nachrichten einer Übertragungsdatei im Datenaustausch. Identisch mit DE0062 im UNT, i. d. R. vom sendenden Konverter vergeben.
Für die Nachrichten-Referenznummer wird ein Numerischer Wert eingesetzt, der zur Laufzeit hoch gezählt wird. Wird das Programm neugestartet, beginnt der Zähler erneut bei 1. Alle weitern Felder werden aus der Tedi-Datei übernommen **Beispiel:** ``` UNH+123+MSCONS:D:04B:UN:2.3c ``` ## BGM - 0020 - Beginn der Nachricht Dieses Segment dient dazu, Typ und Funktion einer Nachricht anzuzeigen und die Identifikationsnummer zu übermitteln. Die Dokumentennummer wird mit einer GUID belegt und ist eindeutig
NameBezeichnerSpezifikationAnwendung / Bemerkung
DokumentennummerC1061004Eindeutige EDI-Nachrichtennummer vergeben vom Absender des Dokuments
**Beispiel:** ``` BGM+7+35efe8ab-9ab7-4e83-a993-5b3a94fa5062+9 ``` ## DTM - 0030 - Nachrichtendatum Für das DTM-Segment auf diesem Level wird immer der Qualifier '137' verwendet, sowie das Format '203'.
NameBezeichnerSpezifikationAnwendung / Bemerkung
Qualifier

C507

(Datum/Uhrzeit/Zeitspanne)

2005137 - Dokumenten-/Nachrichtendatum/-zeit
Wert2380
Code2379203 - CCYYMMDDHHMM
**Beispiel:** ``` DTM+137:202206131630:203 ``` ## LOC - 0200 - Identifikationsangabe Das Segment LOC bestimmt die Örtlichkeit bzw. ist eine Ortsangabe. Der Wert wird aus der ACRON-Beschreibung übernommen. Es wird dabei nur der Qualifier des 'Meldepunkt' unterstützt.
NameBezeichnerSpezifikationAnwendung / Bemerkung
Ortsangabe, Qualifier3227
  • 172 - Meldepunkt
  • Z04 - Profilbezeichnung
  • 107 - Bilanzierungsgebiet
  • Z06 - Profilschar

Lokalisierung des Meldepunktes

Ortsangabe, Code

C517

(Ortsangabe)

3225LOCATION aus ACRON Konfiguration
**Beispiel:** ``` LOC+172+DE007353511470000017A0UV001010P01 ``` ## DTM - 0210 - Messwertzeitraum Für den Messwertzeitraum kann das DTM-Segment optional und mehrfach angegeben werden. Je nachdem wie die TEDI-Datei gestaltet ist, können die in der Tabelle aufgelisteten DTM-Variationen subsituiert werden.
NameBezeichnerAnwendung / Bemerkung
Beginn Messperiode ÜbertragungszeitraumBeginndatum & -Uhrzeit der Messperiode

Qualifier:

163 - Verarbeitung, Beginndatum/-zeit

Format:

303 - CCYYMMDDHHMMZZZ

Ende Messperiode ÜbertragungszeitraumEnddatum & -Uhrzeit der Messperiode

Qualifier: 164 - Verarbeitung, Endedatum/-zeit

Format:

303 - CCYYMMDDHHMMZZZ

Erfassungsdatum

Datum & Uhrzeit

des Erfassungsdatum

Qualifier:

9 -Bearbeitungs-/ Verarbeitungsdatum/ -zeit

Format:

102 - CCYYMMDD

**Beispiel:** ``` DTM+163:202008010904?+01:303 DTM+164:202008010904?+01:303 DTM+9:20220517:102 ``` ## LIN - 0290 - Laufende Position Dieses Segment zeigt den Beginn des Positionsteils innerhalb einer Lokation an. Der Positionsteil wird durch Wiederholung von Segmentgruppen gebildet, die immer mit einem LIN-Segment beginnen. Die Positionsnummer wird hochgezählt, um verschiedene Messwerte (mehrere Zählwerke) oder Messwertreihen (z. B. Wirk- und Blindarbeit) an einem Meldepunkt zu bilden. Da für jeden Meldepunkt eine eigene Datei geschrieben wird, ist eine Trennung nicht nötig, sodass das Segment immer mit **LIN+1** gesetzt ist
NameBezeichnerAnwendung / Bemerkung
Positionsnummer1082TMZ (von 0 bis n) oder laufende Positionsnummer (von 1 bis n)
## PIA - 0300 -Produktidentifikation Das Segment wird für die Identifikation verwendet. Es kann somit nur den Qualifier für die Produktidentifikation beinhalte, in Kombination mit der OBIS-Kennzahl. Die OBIS-Kennzahl wird der ACRON-Konfiguration entnommen und entsprechend eingetragen.
NameBezeichnerSpezifikationAnwendung / Bemerkung
Produkt-/Erzeugnisnummer, Qualifier43475 - Produktidentifikation
Produkt-/Leistungsnummer

C212

(Waren-/Leistungsnummer, Identifikation)

7140Medium / OBIS-Kennzahl
Art der Produkt-/ Leistungsnummer, Code7143
  • SRW - OBIS-Kennzahl
  • Z02 - BDEW OBIS-ähnliche Kennzahl
  • Z08 - Medium
**Beispiel** ``` PIA+5+1-1?:1.8.0:SRW ``` {% hint style="info" %} Da die OBIS-Kennzahl oftmals mit den Symbolen der MSCONS-Steuerelementen belegt sind, wie z.B. dem ':', werden diese mithilfe des Escape Zeichen korrekt konvertiert. {% endhint %} ## QTY - 0360 - Mengenangaben
NameBezeichnerSpezifikationAnwendung / Bemerkung
Menge, QualifierC1866063
  • 20 - Nicht verwendbarer Wert
  • 67 - Ersatzwert
  • 79 - Energiemenge summiert (Summenwert, Bilanzsumme)
  • 187 - Prognosewert
  • 201 - Vorschlagswert
  • 220 - Wahrer Wert
  • Z18 - Vorläufiger Wert
  • Z30 - Fehlender Wert
  • Z31 - Angabe für Lieferschein
Menge6060
DTM - 0370 - Ablesedatum
NameBezeichnerSpezifikationAnwendung / Bemerkung
QualifierC50720059 -Bearbeitungs-/Verarbeitungsdatum/-zeit
Wert2380
Code2379
  • 102 - CCYYMMDD
  • 303 - CCYYMMDDHHMMZZZ
Das DTM-Format (2379) wird mithilfe der ACRON-Kompressionsstufen bestimmt * Prozess & Intervall : 303 - CCYYMMDDHHMMZZZ * Tag, Woche, Monat, Jahr: 102 - CCYYMMDD Die Segmente QTY & DTM folgen abwechselnd aufeinander. Dabei beschreibt QTY den Wert des Meldepunktes und DTM den Zeitpunkt des Wertes. **Beispiele:** | | | | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | |

Prozessdaten:

QTY+220:10020'

DTM+9:202008010904?+01:303'

QTY+220:10052'

DTM+9:202008010905?+01:303'

|

Tagesdaten:

QTY+220:10020'

DTM+9:20200801:102'

QTY+220:10052'

DTM+9:20200802:102'

| {% hint style="warning" %} Es werde keine Bewertung des Wertes übernommen, sodass jedes QTY mit einem "220 - Wahrer Wert" belegt wird. Das Messperiodische DTM-Konzept wird nicht unterstützt. Auf jedes QTY- folgt ein DTM-Segment {% endhint %} ## UNT - 0440 - Nachrichten-Endesegment
NameBezeichnerAnwendung / Bemerkung
Anzahl der Segmente in einer Nachricht0074Hier wird die Gesamtzahl der Segmente einer Nachricht angegeben.
Nachrichten-Referenznummer0062Die Referenznummer aus dem UNH-Segment muss hier wiederholt werden.
**Beispiel:** ``` UNT+32+132 ``` ## UNZ - 0000 - Nutzdaten-Endesegment Das UNZ ist das letzte Segment einer Datei.
NameBezeichnerAnwendung / Bemerkung
Datenaustauschzähler0036Anzahl der Nachrichten oder Nachrichtengruppen in der Übertragungsdatei
Datenaustauschreferenz0020Identisch mit DE0020 im UNB-Segment
Da pro Datei nur eine Nachricht enthalten ist, wird der Datenaustauschzähler immer '1' lauten. **Beispiel:** ``` UNZ+1+J5.DT-am439al1 ``` Quellen Beschreibungen und Definitionen wurden den folgenden Quellen entnommen. [www.edi-energy.de](http://www.edi-energy.de) [www.ediviewer.de](http://www.ediviewer.de) [www.kilinski.de](http://www.kilinski.de) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.videc.de/june5-datatrans/ausgabeformate/mscons.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.