Check identifier 55557 — Change to MSB billing data of MaLo
Check identifier 55557 · EDIFACT message type UTILMD · format version 202610
Data structure
| Structure (BO4E) | Description | Format | 55557 | Condition |
|---|---|---|---|---|
| stammdaten * | — | object | Must | — |
| MARKTLOKATION [ ] * | — | object[] | Must | — |
| datenqualitaet * 00010 | Data quality | Enum Datenqualitaet | X | — |
ERWARTETE_DATEN | — | — | X | — |
IM_SYSTEM_VORHANDENE_DATEN | — | — | X | — |
INFORMATIVE_DATEN | — | — | X | — |
GUELTIGE_DATEN | — | — | X | — |
KEINE_DATEN | — | — | X | — |
IM_SYSTEM_KEINE_DATEN_VORHANDEN | — | — | X | — |
KEINE_DATEN_ERWARTET | — | — | X | — |
DIFFERENZ_DATEN | — | — | X | — |
DIFFERENZ_ERWARTETE_DATEN | — | — | X | — |
DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN | — | — | X | — |
| marktlokationsId 00020 | Identification number of a market location at which energy is either consumed or generated | string | X | — |
| gueltigkeitszeitraum * | — | object | Must | — |
| zeitraumId * 00030 | zeitraumId | integer | X | — |
| messstellenbetriebsabrechnungsdaten [ ] | — | object[] | May | — |
| abschlag 00040 | Instalment payment | number (float) | Must | — |
| anzahl 00050 | anzahl | integer | X | — |
| artikelId 00060 | BDEWArtikelId | string | Must | — |
| messstellenbetriebsabrechnung 00070 | messstellenbetriebsabrechnung | boolean | Must | — |
| VERWENDUNGSZEITRAUM [ ] * | — | object[] | Must | — |
| datenqualitaet * 00080 | Data quality | Enum Datenqualitaet | Must | — |
ERWARTETE_DATEN | — | — | Must | — |
IM_SYSTEM_VORHANDENE_DATEN | — | — | Must | — |
INFORMATIVE_DATEN | — | — | Must | — |
GUELTIGE_DATEN | — | — | Must | — |
KEINE_DATEN | — | — | Must | — |
IM_SYSTEM_KEINE_DATEN_VORHANDEN | — | — | Must | — |
KEINE_DATEN_ERWARTET | — | — | Must | — |
DIFFERENZ_DATEN | — | — | Must | — |
DIFFERENZ_ERWARTETE_DATEN | — | — | Must | — |
DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN | — | — | Must | — |
| verwendungAb * 00090 | verwendungAb | string (date-time) | X | — |
| verwendungBis 00100 | verwendungBis | string (date-time) | X | — |
| zeitraumId * 00110 | zeitraumId | integer | Must | — |
| transaktionsdaten * | — | object | Must | — |
| dokumentennummer * 00120 | EDIFACT reference from the BGM segment / BGM | string | X | — |
| kategorie * 00130 | Qualifier from the beginning of the EDIFACT message / BGM | string | X | — |
| nachrichtendatum * 00140 | Creation date of the EDIFact / DTM+137 | string (date-time) | X | — |
| nachrichtenreferenznummer * 00150 | EDIFACT reference from the UNT segment / UTILMD UNT+21 | string | Must | — |
| pruefidentifikator * 00160 | Contains the check identifier from the EDIFact communication / RFF+Z13 | string | X | — |
| transaktionsgrund * 00170 | The transaction reason describes the business transaction for the category in more detail / UTILMD STS+7++###+ZW4+E03 | string | X | — |
| vorgangsnummer * 00180 | Number of the transaction / UTILMD UTILTS IDE+24 / INSRPT INVOIC DOC | 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 | — |
| empfaenger * | — | object | Must | — |
| rollencodenummer * 00210 | Specifies the code value of the market role. | string | X | — |
| rollencodetyp * 00220 | Indicates the type of the code. | Enum Rollencodetyp | X | — |
BDEW | — | — | X | — |
GS1 | — | — | X | — |
GLN | — | — | X | — |
DVGW | — | — | X | — |
Application handbook (AHB)
| Structure (EDIFACT) | Description | Format | 55557 | Condition |
|---|---|---|---|---|
| UNH | — | — | Must | — |
006200010 | Message reference number | — | X | — |
0065 UTILMD00020 | Grid connection master data | — | X | — |
0052 D00030 | Draft version | — | X | — |
0054 11A00040 | Edition 2011 - A | — | X | — |
0051 UN00050 | UN/CEFACT | — | X | — |
0057 S2.200060 | Version number of the underlying BDEW message description | — | X | — |
| BGM | — | — | Must | — |
1001 E0300070 | Change notifications | — | X | — |
100400080 | Document number | — | X | — |
| DTM | — | — | Must | — |
2005 13700090 | Document/message date/time | — | X | — |
238000100 | Date or time or time span, value | — | X | [931] [494] |
2379 30300110 | CCYYMMDDHHMMZZZ | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 MS00120 | Document-/ message sender or sender | — | X | — |
303900130 | MP-ID | — | X | — |
3055 900140 | GS1 | — | X | — |
3055 29300150 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 MR00160 | Message recipient | — | X | — |
303900170 | MP-ID | — | X | — |
3055 900180 | GS1 | — | X | — |
3055 29300190 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
| SG4.IDE | — | — | Must | — |
7495 2400200 | Transaction | — | X | — |
740200210 | Transaction number | — | X | — |
| SG4.STS | — | — | Must | — |
9015 700220 | Transaction reason | — | X | — |
9013 ZU100230 | Change of MSB billing data | — | X | — |
| SG5.LOC | — | — | Must | — |
3227 Z1600240 | Market location | — | X | — |
322500250 | ID of the market location | — | X | [950] |
| SG6.RFF | — | — | Must | — |
1153 Z1300260 | Check identifier | — | X | — |
1154 5555700270 | GPKE / Change of MSB billing data | — | X | — |
| SG6.RFF | — | — | Must | — |
1153 Z4900280 | Valid data | — | X | [1P0..n] |
1153 Z5300290 | No data | — | X | [1P0..n] |
115600300 | Time period ID | — | X | [914] ∧ [937] [126] |
| SG6.DTM | — | — | Must | [131] ⊻ [401] |
2005 Z2500310 | Data used from | — | X | — |
238000320 | Date or time or time span, value | — | X | [UB1] |
2379 30300330 | CCYYMMDDHHMMZZZ | — | X | — |
| SG6.DTM | — | — | Must | [471] |
2005 Z2600340 | Data used until | — | X | — |
238000350 | Date or time or time span, value | — | X | [UB1] |
2379 30300360 | CCYYMMDDHHMMZZZ | — | X | — |
| SG8.SEQ | — | — | Must | — |
1229 Z7600370 | Metering point operation billing data of the market location | — | X | — |
105000380 | Reference to time period ID | — | X | [914] ∧ [937] [22] |
| SG8.PIA | — | — | Must | — |
4347 Z0200390 | Group article ID / article ID | — | X | — |
4347 Z0300400 | No metering point operation billing is carried out for this market location | — | X | — |
714000410 | Product/service number | — | X | [942] [125] ∧ [93] |
7143 Z0900420 | Article ID | — | X | — |
| SG9.QTY | — | — | Must | — |
6063 Z3800430 | Number of line items to be billed for the group article ID / article ID | — | X | — |
606000440 | Quantity | — | X | [914] ∧ [937] |
6411 H8700450 | Piece | — | X | — |
| SG9.QTY | — | — | Must | — |
6063 Z3500460 | Instalment payment | — | X | — |
6063 Z4600470 | no instalment payment | — | X | — |
606000480 | Quantity | — | X | ([914] ∧ [930] [138]) ⊻ ([926] ∧ [937] [180]) |
6411 P100490 | Percent | — | X | — |
| UNT | — | — | Must | — |
007400500 | Number of segments in a message | — | X | — |
006200510 | Message reference number | — | X | — |
Conditions of this table
The free text of the 19 conditions referenced by the rows above. All conditions of the message type are listed in the condition index UTILMDS.
| Marker | Condition |
|---|---|
| [22] | The time period ID from DE1156 of a matching SG6 RFF+Z47/Z48/Z49 (usage period of the data) must be entered |
| [93] | Permitted codes from the PRICAT BGM+Z32 (price sheet for metering point operation) of the responsible MSB |
| [125] | If in the same SG8 SEQ+Z76/ZC5/ZC6 (metering point operation billing data of the market location) Z02 (group article ID / article ID) is present in DE4347 of the PIA |
| [126] | The value resulting from the number of repetitions of the SG6 RFF+Z49/Z53 (usage period of the data: valid data/no data) must be entered. This means: the first SG6 RFF+Z49/Z53 thus has the „1“, the second the „2“, the third the „3“, etc. |
| [131] | If this DTM+Z25 (use of the data from) in SG6 RFF (usage peri od of the data) is marked with the time period ID "1" in DE1156, the date in this DE2380 must be the day immediately following DTM+137 DE2380 (message dat e) at 0:00, or a day earlier than that at 0:00 German time |
| [138] | If Z35 (instalment payment) is present in DE6063 in the same QTY |
| [180] | If Z46 (no instalment payment) is present in DE6063 in the same QTY |
| [401] | If this DTM+Z25 (use of data from) is not in the SG6 RFF+Z49/Z53 (usage period of the data: valid data/no data) with time period ID "1" in DE1156, the date must correspond to the DTM+Z26 (use of data until) of the SG6 RFF+Z49/Z53 (usage period of the data: valid data/no data) with the next lower time period ID in DE1156 |
| [471] | If a time period ID is named in DE1156 (time period ID) in the same SG6 RFF+Z49/Z53 (usage period of the data: valid data/no data) which is lower than in another SG6 RFF+Z49/Z53 (usage period of the data: valid data/no data) DE1156 (time period ID) |
| [494] | The date stated here must be the point in time at which the document was created, or a point in time before that |
| [914] | Format: Possible value: > 0 |
| [926] | Format: Possible value: 0 |
| [930] | Format: max. 2 decimal places |
| [931] | Format: ZZZ = +00 |
| [937] | Format: no decimal places |
| [942] | Format: n1- n2-n1-n3 |
| [950] | Format: market location ID |
| [1P0..n] | Note: This is the standard package if no condition applies, e.g. in the COM segment. |
| [UB1] | ([931] ∧ [932] [490]) ⊻ ([931] ∧ [933] [491]) |
Example message
UNA:+.? '
UNB+UNOC:3+9904446000007:500+9900321000005:500+{{date}}:{{time}}+LZQV1FTH'
UNH+UNHLZPSZ8H2+UTILMD:D:11A:UN:S2.2'
BGM+E03+BGMM097DLXC'
DTM+137:202610021100?+00:303'
NAD+MS+9904446000007::293'
NAD+MR+9900321000005::293'
IDE+24+123456'
STS+7++ZU1'
LOC+Z16+50074561188'
RFF+Z13:55557'
RFF+Z49::1'
DTM+Z25:202606302200?+00:303'
SEQ+Z76+1'
PIA+Z02+1-06-7-004:Z09'
QTY+Z38:1:H87'
QTY+Z46:0:P1'
UNT+16+UNHLZPSZ8H2'
UNZ+1+LZQV1FTH'[1 item
{6 fields
"data": {3 fields
"stammdaten": {2 fields
"VERWENDUNGSZEITRAUM": [1 item
{5 fields
"MARKTLOKATION": [1 item
{8 fields
"marktlokationsTyp": [1 item
{1 field
"gueltigkeitszeitraum": {2 fields
"messstellenbetriebsabrechnungsdaten": [1 item
{4 fields
"transaktionsdaten": {12 fields
"absender": {4 fields
"empfaenger": {4 fields
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, NB, MSB and ÜNB.
| Role | Party involved | Process | Rulebook | Division | Step |
|---|---|---|---|---|---|
| LF | LF | Master data change initiated by the MSB (responsible) | GPKE part 4 | Electricity | Step 1 |
| NB | NB | Master data change initiated by the MSB (responsible) | GPKE part 4 | Electricity | Step 1 |
| MSB | MSB | Master data change initiated by the MSB (responsible) | GPKE part 4 | Electricity | Step 1 |
| MSB | WMSB | Master data change initiated by the MSB (responsible) | GPKE part 4 | Electricity | Step 1 |
| ÜNB | ÜNB | Master data change initiated by the MSB (responsible) | GPKE part 4 | Electricity | Step 1 |
Business classification
| Attribute | Value |
|---|---|
| Use case (AHB) | Change MSB bill. data of the MaLo |
| AHB | UTILMD AHB electricity |
| Transmission channel | AS4 |
| Process description / rulebook | Process step | Communication | Action |
|---|---|---|---|
| GPKE part 4 | Master data change initiated by the MSB (responsible) | MSB → NB | Change from the MSB to NB |
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 UTILMDS 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 68 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 utilmd. 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.