MSCONS (25)
Check identifier 13015 — Energy max. demand calendar year before start of supply
Check identifier 13015 · EDIFACT message type MSCONS · Format version 202604
Data structure
| Structure (BO4E) | Description | Format | 13015 | Condition |
|---|---|---|---|---|
| stammdaten * | — | object | Must | — |
| ENERGIEMENGE [ ] * | — | object[] | Must | — |
| konfiguration 00010 | konfiguration | string | X | — |
| lokationsId * 00020 | Unique number of the market location or of the metering location to which the energy quantity belongs | string | X | — |
| energieverbrauch [ ] * | — | object[] | Must | — |
| enddatum 00030 | enddatum | string (date-time) | X | — |
| leistungsperiode 00040 | leistungsperiode | string | X | — |
| messwertstatus * 00050 | The status of a meter reading | Enum Messwertstatus | Must | — |
ABGELESEN | — | — | Must | — |
ERSATZWERT | — | — | Must | — |
VORSCHLAGSWERT | — | — | Must | — |
NICHT_VERWENDBAR | — | — | Must | — |
PROGNOSEWERT | — | — | Must | — |
ENERGIEMENGESUMMIERT | — | — | Must | — |
VOLAEUFIGERWERT | — | — | Must | — |
FEHLT | — | — | Must | — |
ANGABE_FUER_LIEFERSCHEIN | — | — | Must | — |
GRUNDLAGE_POG_ERMITTLUNG | — | — | Must | — |
| obiskennzahl * 00060 | obiskennzahl | string | X | — |
| position * 00070 | position | integer | Must | — |
| startdatum 00080 | startdatum | string (date-time) | X | — |
| wert * 00090 | wert | number (float) | Must | — |
| statuszusatzinformationen [ ] | — | object[] | May | — |
| art 00100 | Status type | Enum StatusArt | X | — |
PLAUSIBILISIERUNGSHINWEIS | — | — | X | — |
ERSATZWERTBILDUNGSVERFAHREN | — | — | X | — |
KORREKTURGRUND | — | — | X | — |
GRUND_ERSATZWERTBILDUNGSVERFAHREN | — | — | X | — |
GASQUALITAET | — | — | X | — |
MESSKLASSIFIZIERUNG | — | — | X | — |
| status 00110 | Status | Enum Status | X | — |
KUNDENSELBSTABLESUNG | — | — | X | — |
LEERSTAND | — | — | X | — |
REALER_ZAEHLERUEBERLAUF_GEPRUEFT | — | — | X | — |
PLAUSIBEL_WG_KONTROLLABLESUNG | — | — | X | — |
PLAUSIBEL_WG_KUNDENHINWEIS | — | — | X | — |
AUSTAUSCH_DES_ERSATZWERTES | — | — | X | — |
RECHENWERT | — | — | X | — |
BASIS_MME | — | — | X | — |
VERGLEICHSMESSUNG_GEEICHT | — | — | X | — |
VERGLEICHSMESSUNG_NICHT_GEEICHT | — | — | X | — |
MESSWERTNACHBILDUNG_AUS_GEEICHTEN_WERTEN | — | — | X | — |
MESSWERTNACHBILDUNG_AUS_NICHT_GEEICHTEN_WERTEN | — | — | X | — |
INTERPOLATION | — | — | X | — |
HALTEWERT | — | — | X | — |
BILANZIERUNG_NETZABSCHNITT | — | — | X | — |
HISTORISCHE_MESSWERTE | — | — | X | — |
STATISTISCHE_METHODE | — | — | X | — |
AUFTEILUNG | — | — | X | — |
VERWENDUNG_VON_WERTEN_DES_STOERMENGENZAEHLWERKS | — | — | X | — |
UMGANGS_UND_KORREKTURMENGEN | — | — | X | — |
ANGABEN_MESSLOKATION | — | — | X | — |
KEIN_ZUGANG | — | — | X | — |
KOMMUNIKATIONSSTOERUNG | — | — | X | — |
NETZAUSFALL | — | — | X | — |
SPANNUNGSAUSFALL | — | — | X | — |
STATUS_GERAETEWECHSEL | — | — | X | — |
KALIBRIERUNG | — | — | X | — |
GERAET_ARBEITET_AUSSERHALB_DER_BETRIEBSBEDINGUNGEN | — | — | X | — |
MESSEINRICHTUNG_GESTOERT_DEFEKT | — | — | X | — |
UNSICHERHEIT_MESSUNG | — | — | X | — |
BERUECKSICHTIGUNG_STOERMENGENZAEHLWERK | — | — | X | — |
MENGENUMWERTUNG_VOLLSTAENDIG | — | — | X | — |
UHRZEIT_GESTELLT_SYNCHRONISATION | — | — | X | — |
MESSWERT_UNPLAUSIBEL | — | — | X | — |
FALSCHER_WANDLERFAKTOR | — | — | X | — |
FEHLERHAFTE_ABLESUNG | — | — | X | — |
AENDERUNG_DER_BERECHNUNG | — | — | X | — |
UMBAU_DER_MESSLOKATION | — | — | X | — |
DATENBEARBEITUNGSFEHLER | — | — | X | — |
BRENNWERTKORREKTUR | — | — | X | — |
Z_ZAHL_KORREKTUR | — | — | X | — |
STOERUNG_DEFEKT_MESSEINRICHTUNG | — | — | X | — |
AENDERUNG_TARIFSCHALTZEITEN | — | — | X | — |
TARIFSCHALTGERAET_DEFEKT | — | — | X | — |
IMPULSWERTIGKEIT_NICHT_AUSREICHEND | — | — | X | — |
ENERGIEMENGE_IN_UNGEMESSENEM_ZEITINTERVALL | — | — | X | — |
ENERGIEMENGE_AUS_DEM_UNGEPAIRTEN_ZEITINTERVALL | — | — | X | — |
WARTUNGSARBEITEN_AN_GEEICHTEM_MESSGERAET | — | — | X | — |
GESTOERTE_WERTE | — | — | X | — |
WARTUNGSARBEITEN_AN_EICHRECHTSKONFORMEN_MESSGERAETEN | — | — | X | — |
KONSISTENZ_UND_SYNCHRONPRUEFUNG | — | — | X | — |
GRUND_ANGABEN_MESSLOKATION | — | — | X | — |
ANFORDERUNG_IN_DIE_VERGANGENHEIT_ZUM_ANGEFORDERTEN_ZEITPUNKT_LIEGT_KEIN_WERT_VOR | — | — | X | — |
UMSTELLUNG_GASQUALITAET | — | — | X | — |
ZAEHLERSTAND_ZUM_BEGINN_DER_ANGEGEBENEN_ENERGIEMENGE_VORHANDEN_UND_KOMMUNIZIERT | — | — | X | — |
ZAEHLERSTAND_ZUM_ENDE_DER_ANGEGEBENEN_ENERGIEMENGE_VORHANDEN_UND_KOMMUNIZIERT | — | — | X | — |
ZAEHLERSTAND_ZUM_BEGINN_DER_ANGEGEBENEN_ENERGIEMENGE_NICHT_VORHANDEN_DA_MENGENABGRENZUNG | — | — | X | — |
ZAEHLERSTAND_ZUM_ENDE_DER_ANGEGEBENEN_ENERGIEMENGE_NICHT_VORHANDEN_DA_MENGENABGRENZUNG | — | — | X | — |
GESCHEITERT | — | — | X | — |
AUSGEBAUT | — | — | X | — |
| transaktionsdaten * | — | object | Must | — |
| anfrageReferenz * 00120 | Application number / RFF+AGI | string | X | — |
| dokumentennummer * 00130 | EDIFACT reference from the BGM segment / BGM | string | Must | — |
| kategorie * 00140 | Qualifier from the beginning of the EDIFACT message / BGM | string | Must | — |
| nachrichtendatum * 00150 | Creation date of the EDIFact / DTM+137 | string (date-time) | X | — |
| nachrichtenfunktion * 00160 | Message function code / BGM | string | Must | — |
| nachrichtenreferenznummer * 00170 | EDIFACT reference from the UNT segment / UTILMD UNT+21 | string | Must | — |
| pruefidentifikator * 00180 | Contains the check identifier from the EDIFact communication / RFF+Z13 | string | X | — |
| absender * | — | object | Must | — |
| rollencodenummer * 00190 | Specifies the code value of the market role. | string | X | — |
| rollencodetyp * 00200 | Indicates the type of the code. | Enum Rollencodetyp | X | — |
BDEW | — | — | X | — |
GS1 | — | — | X | — |
GLN | — | — | X | — |
DVGW | — | — | X | — |
| ansprechpartner | — | object | May | — |
| eMailAdresse 00210 | Email address | string | Must | — |
| nachname 00220 | Surname (family name) of the contact person | string | X | — |
| rufnummern [ ] | — | object[] | May | — |
| nummerntyp 00230 | Phone number type | Enum Rufnummernart | Must | — |
RUF_ZENTRALE | — | — | Must | — |
FAX_ZENTRALE | — | — | Must | — |
SAMMELRUF | — | — | Must | — |
SAMMELFAX | — | — | Must | — |
ABTEILUNGRUF | — | — | Must | — |
ABTEILUNGFAX | — | — | Must | — |
RUF_DURCHWAHL | — | — | Must | — |
FAX_DURCHWAHL | — | — | Must | — |
MOBIL_NUMMER | — | — | Must | — |
| rufnummer 00240 | rufnummer | string | Must | — |
| empfaenger * | — | object | Must | — |
| rollencodenummer * 00250 | Specifies the code value of the market role. | string | X | — |
| rollencodetyp * 00260 | Indicates the type of the code. | Enum Rollencodetyp | X | — |
BDEW | — | — | X | — |
GS1 | — | — | X | — |
GLN | — | — | X | — |
DVGW | — | — | X | — |
Application handbook (AHB)
| Structure (EDIFACT) | Description | Format | 13015 | Condition |
|---|---|---|---|---|
| UNB | — | — | Must | — |
0001 UNOC00010 | UN/ECE character set C | — | X | — |
0002 300020 | Version 3 | — | X | — |
000400030 | MP-ID Sender | — | X | — |
0007 1400040 | GS1 | — | X | — |
0007 50000050 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
001000060 | MP-ID recipient | — | X | — |
0007 1400070 | GS1 | — | X | — |
0007 50000080 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
001700090 | Date of creation | — | X | — |
001900100 | Time of creation | — | X | — |
002000110 | Interchange control reference | — | X | [918] |
0026 EM00120 | Energy quantity | — | X | — |
| UNH | — | — | Must | — |
006200130 | Message reference number | — | X | — |
0065 MSCONS00140 | Report on the consumption of measurable services | — | X | — |
0052 D00150 | Draft version | — | X | — |
0054 04B00160 | Edition 2004 - B | — | X | — |
0051 UN00170 | UN/CEFACT | — | X | — |
0057 2.4c00180 | Version number of the underlying BDEW message description | — | X | — |
| BGM | — | — | Must | — |
1001 Z2700190 | Transaction data in the calendar year before the start of supply | — | X | — |
100400200 | Document number | — | X | — |
1225 900210 | Original | — | X | — |
| DTM | — | — | Must | — |
2005 13700220 | Document-/message date/time | — | X | — |
238000230 | Date or time or time span, value | — | X | [931] [494] |
2379 30300240 | CCYYMMDDHHMMZZZ | — | X | — |
| SG1.RFF | — | — | Must | — |
1153 AGI00250 | Application number | — | X | — |
115400260 | Reference number | — | X | [530] |
| SG1.RFF | — | — | Must | — |
1153 Z1300270 | Check identifier | — | X | — |
1154 1301500280 | Transaction data in the calendar year before the start of supply | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 MS00290 | Document-/message sender or sender | — | X | — |
303900300 | MP-ID | — | X | [117] |
3055 900310 | GS1 | — | X | — |
3055 29300320 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
| SG4.CTA | — | — | Must | — |
3139 IC00330 | Information point | — | X | — |
341200340 | Department or contact person | — | X | — |
| SG4.COM | — | — | Must | — |
314800350 | Communication address, identification | — | X | (([939] [142]) ∨ ([940] [143])) ∧ [576] |
3155 TE00360 | Telephone | — | X | [1P0..1] |
3155 EM00370 | — | X | [1P0..1] | |
3155 AJ00380 | further telephone | — | X | [1P0..1] |
3155 AL00390 | Mobile phone | — | X | [1P0..1] |
3155 FX00400 | Fax number | — | X | [1P0..1] |
| SG2.NAD | — | — | Must | — |
3035 MR00410 | Message recipient | — | X | — |
303900420 | MP-ID | — | X | [117] |
3055 900430 | GS1 | — | X | — |
3055 29300440 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
| UNS | — | — | Must | — |
0081 D00450 | Separation of header and detail section | — | X | — |
| SG5.NAD | — | — | Must | — |
3035 DP00460 | Supply address | — | X | — |
| SG6.LOC | — | — | Must | — |
3227 17200470 | Reporting point | — | X | — |
322500480 | Designation | — | X | [950] [514] |
| SG9.LIN | — | — | Must | — |
108200490 | Line item number | — | X | [908] |
| SG9.PIA | — | — | Must | — |
4347 500500 | Product identification | — | X | — |
714000510 | Medium / OBIS code number | — | X | [501] |
7143 SRW00520 | OBIS code | — | X | — |
| SG10.QTY | — | — | Must | — |
6063 22000530 | True value | — | X | — |
6063 6700540 | Substitute value | — | X | — |
606000550 | Quantity | — | X | [902] ∧ [906] |
| SG10.DTM | — | — | Must | [27] |
2005 16300560 | Processing, start date/time | — | X | — |
238000570 | Date or time or time span, value | — | X | [UB1] ∧ [495] |
2379 30300580 | CCYYMMDDHHMMZZZ | — | X | — |
| SG10.DTM | — | — | Must | [27] |
2005 16400590 | Processing, end date/time | — | X | — |
238000600 | Date or time or time span, value | — | X | [UB1] ∧ [495] |
2379 30300610 | CCYYMMDDHHMMZZZ | — | X | — |
| SG10.DTM | — | — | Must | [28] |
2005 30600620 | Demand period | — | X | — |
238000630 | Date or time or time span, value | — | X | — |
2379 61000640 | CCYYMM | — | X | — |
| SG10.STS | — | — | Must | [92] |
9015 Z3200650 | Substitute value formation procedure | — | X | — |
9013 Z8800660 | Comparative measurement (calibrated) | — | X | [4P0..1] |
9013 Z8900670 | Comparative measurement (not calibrated) | — | X | [4P0..1] |
9013 Z9200680 | Interpolation | — | X | [4P0..1] |
9013 ZJ200690 | Statistical method | — | X | [4P0..1] |
| UNT | — | — | Must | — |
007400700 | Number of segments in a message | — | X | — |
006200710 | Message reference number | — | X | — |
| UNZ | — | — | Must | — |
003600720 | Interchange counter | — | X | — |
002000730 | Interchange control reference | — | X | — |
Conditions of this table
The free text of the 23 conditions referenced by the rows above. All conditions of the message type are listed in the condition index MSCONS.
| Marker | Condition |
|---|---|
| [27] | If SG9 PIA+5+1-1?:1.9.0 is present |
| [28] | If SG9 PIA+5+1-1?:1.9.0 is not present |
| [92] | If SG10 QTY DE6063 with value 67 is present |
| [117] | Only MP-ID from the electricity division |
| [142] | if the code EM is present in DE3155 in the same COM |
| [143] | if the code TE / FX / AJ / AL is present in DE3155 in the same COM |
| [494] | The date stated here must be the point in time at which the document was created, or a point in time before that. |
| [495] | The point in time must be ≤ the value in DE2380 of DTM+137 |
| [501] | Note: Only the values that are marked with the corresponding check identifier in the EDI@Energy code list of the OBIS codes and media are permitted. |
| [514] | Note: Use of the ID of the market location |
| [530] | Note: Value from SG4 IDE+24 DE7402 of the UTILMD with which the sender of the MSCONS transmitted the previous master data by means of UTILMD. |
| [576] | Note: Only one piece of information may be transmitted in DE3148 |
| [902] | Format: Possible value: ≥ 0 |
| [906] | Format: max. 3 decimal places |
| [908] | Format: possible values: 1 to n |
| [918] | Format: Characters from the character set defined via UNOC, where only capital letters are permitted among the letters. |
| [931] | Format: ZZZ = +00 |
| [939] | Format: the character string must contain the characters @ and . |
| [940] | Format: the character string must begin with the character + and may only be followed by digits |
| [950] | Format: market location ID |
| [1P0..1] | Note: This is the standard package if no condition applies, e.g. in the COM segment |
| [UB1] | ([931] ∧ [932] [490]) ⊻ ([931] ∧ [933] [491]) |
| [4P0..1] | [92] If SG10 QTY DE6063 with value 67 present |
Example message
UNA:+.? '
UNB+UNOC:3+9900321000005:500+9903790000002:500+{{date}}:{{time}}+209700++EM'
UNH+132971+MSCONS:D:04B:UN:2.4c'
BGM+Z27+132971BGM+9'
DTM+137:202310040725?+00:303'
RFF+AGI:12345678910'
RFF+Z13:13015'
NAD+MS+9900321000005::293'
NAD+MR+9903790000002::293'
UNS+D'
NAD+DP'
LOC+172+50074561188'
LIN+1'
PIA+5+1-1?:1.6.0:SRW'
QTY+220:5000'
DTM+306:202301:610'
LIN+2'
PIA+5+1-1?:1.9.0:SRW'
QTY+220:5000'
DTM+163:202212312300?+00:303'
DTM+164:202301312300?+00:303'
UNT+20+132971'
UNZ+1+209700'[1 item
{6 fields
"businessKey": "<businessKey>",
"processDate": null,
"dataSource": "OUTBOUND",
"version": 1,
"edifactVersion": 202604,
"data": {3 fields
"stammdaten": {1 field
"ENERGIEMENGE": [1 item
{5 fields
"boTyp": "ENERGIEMENGE",
"versionStruktur": "1",
"lokationsId": "50074561188",
"lokationsTyp": "MALO",
"energieverbrauch": [2 items
{5 fields
"messwertstatus": "ABGELESEN",
"obiskennzahl": "1-1:1.6.0",
"wert": 5000,
"leistungsperiode": "202301",
"position": 1
},
{6 fields
"messwertstatus": "ABGELESEN",
"obiskennzahl": "1-1:1.9.0",
"wert": 5000,
"startdatum": "2022-12-31T23:00:00Z",
"enddatum": "2023-01-31T23:00:00Z",
"position": 2
}
]
}
]
},
"transaktionsdaten": {12 fields
"datenaustauschreferenz": "209700",
"sparte": "STROM",
"pruefidentifikator": "13015",
"absender": {4 fields
"boTyp": "MARKTTEILNEHMER",
"versionStruktur": "1",
"rollencodenummer": "9900321000005",
"rollencodetyp": "BDEW"
},
"empfaenger": {4 fields
"boTyp": "MARKTTEILNEHMER",
"versionStruktur": "1",
"rollencodenummer": "9903790000002",
"rollencodetyp": "BDEW"
},
"dokumentennummer": "132971BGM",
"kategorie": "Z27",
"nachrichtenfunktion": "9",
"nachrichtendatum": "2023-10-04T07:25:00Z",
"nachrichtenreferenznummer": "132971",
"typ": "EM",
"anfrageReferenz": "12345678910"
},
"zusatzdaten": {}
}
}
]
Download: EDIFACT file · BO4E JSON
Belongs to these role views
The check identifier itself carries no market role. This assignment is derived back from the role views in whose process steps it occurs — affected are LF and NB.
| Role | Party involved | Process | Rulebook | Division | Step |
|---|---|---|---|---|---|
| LF | LF | Transmission of the energy and demand values measured so far | GPKE part 2 | Electricity | Step 1 |
| NB | NB | Transmission of the energy and demand values measured so far | GPKE part 2 | Electricity | Step 1 |
Business classification
| Attribute | Value |
|---|---|
| Use case (AHB) | Energy, max. demand calendar year before start of supply |
| AHB | MSCONS AHB |
| Transmission channel | AS4 |
| Process description / rulebook | Process step | Communication | Action |
|---|---|---|---|
| GPKE part 2 | Transmission of the energy and demand values measured so far | NB → LF | Energy and demand values measured so far |
Transaction and responses
Role of this check identifier: request. Basis: the transaction data carry neither antwortstatus nor antwortstatusCodeliste, and neither the title nor the action of the Prüfi table begins with “response” or “response message”.
Responses: No response of this format version names this check identifier as a reference — neither explicitly in the Prüfi table nor via the step sequence. That does not mean there is none; it means that the sources do not record one.
Check identifiers of the same AHB table: No other check identifier of message type MSCONS has the same row structure in this version.
Notes on this page
An * after a field or group name marks a mandatory field or a mandatory group. The type is beside it; where the value ends up in the EDIFACT segment is shown by the info icon next to the field name.
The status column carries two vocabularies because the manual answers two questions: on a group row, Muss, Soll or Kann states whether the EDIFACT segment must be present; on a field row, X states that this qualifier is used in this check identifier. Both are kept exactly as the source records them.
For this check identifier, the application handbook lists 95 rows. They appear in the order of the handbook, indented by segment: a row without a data element opens a segment, the rows below it are its data elements.
The Condition column names the markers under which the handbook ties a row to a prerequisite; their free text is below the table.
The test data contains one transaction for this check identifier under the message type mscons. Each is stored twice — as a EDIFACT message and as a BO4E JSON. That both representations show the same transaction has been recalculated, not assumed: interchange control reference, message reference number, document number, message date, sender and recipient match in all 517 pairs of the format version; check identifier, transaction number and location ID wherever both representations carry them. Not a single attribute contradicts.
Placeholder from the test data set
The test data set carries placeholders instead of valid values: {{date}} and {{time}} in the UNB interchange envelope of every EDIFACT file. The page replaces these on call with the current date and the current time — in the format that applies at the respective position: in the envelope year, month and day as well as hour and minute, two digits each.
<businessKey> stays in place. It is not a time value, and an invented key would look like a valid one.