Check identifier 55173 — Change to the location bundle structure
Check identifier 55173 · EDIFACT message type UTILMD · Format version 202610
Data structure
| Structure (BO4E) | Description | Format | 55173 | Condition |
|---|---|---|---|---|
| stammdaten * | — | object | Must | — |
| LOKATIONSBUENDEL [ ] | — | object[] | May | — |
| 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 | — |
| lokationsbuendelNummer 00020 | lokationsbuendelNummer | integer | Must | — |
| lokationsbuendelstrukturId 00030 | lokationsbuendelstrukturId | string | Must | — |
| standardisierteLokationsbuendelstruktur 00040 | standardisierteLokationsbuendelstruktur | boolean | Must | — |
| gueltigkeitszeitraum | — | object | May | — |
| zeitraumId 00050 | zeitraumId | integer | X | — |
| zuordnungObjectcode [ ] | — | object[] | May | — |
| referenzLokationsId 00060 | referenzLokationsId | string | Must | — |
| referenzLokationsTyp 00070 | Indicates whether it is a market location or a metering location | Enum Lokationstyp | Must | — |
MALO | — | — | Must | — |
MELO | — | — | Must | — |
NELO | — | — | Must | — |
TECHNISCHE_RESSOURCE | — | — | Must | — |
STEUERBARE_RESSOURCE | — | — | Must | — |
TRANCHE | — | — | Must | — |
MABIS_ZAEHLPUNKT | — | — | Must | — |
| referenzMarktlokationTechnischeRessource 00080 | referenzMarktlokationTechnischeRessource | array | X | — |
| vorgelagerteLokationId 00090 | vorgelagerteLokationId | string | Must | — |
| vorgelagerteLokationTyp 00100 | Indicates whether it is a market location or a metering location | Enum Lokationstyp | Must | — |
MALO | — | — | Must | — |
MELO | — | — | Must | — |
NELO | — | — | Must | — |
TECHNISCHE_RESSOURCE | — | — | Must | — |
STEUERBARE_RESSOURCE | — | — | Must | — |
TRANCHE | — | — | Must | — |
MABIS_ZAEHLPUNKT | — | — | Must | — |
| objectcode [ ] | — | object[] | May | — |
| lokationsbuendelNummer 00110 | lokationsbuendelNummer | integer | X | — |
| objectcode 00120 | objectcode | string | X | — |
| MARKTLOKATION [ ] * | — | object[] | Must | — |
| marktlokationsId * 00130 | Identification number of a market location at which energy is either consumed or generated | string | X | — |
| gueltigkeitszeitraum * | — | object | Must | — |
| zeitraumId * 00140 | zeitraumId | integer | X | — |
| MESSLOKATION [ ] | — | object[] | May | — |
| messlokationsId 00150 | The metering location identification. This is the former metering point identifier, e.g. DE 47108151234567 | string | X | — |
| gueltigkeitszeitraum | — | object | May | — |
| zeitraumId 00160 | zeitraumId | integer | X | — |
| NETZLOKATION [ ] | — | object[] | May | — |
| netzlokationsId 00170 | Identification number of a grid location at which energy is either consumed or generated (like MarktlokationsId market location) | string | X | — |
| gueltigkeitszeitraum | — | object | May | — |
| zeitraumId 00180 | zeitraumId | integer | X | — |
| STEUERBARE_RESSOURCE [ ] | — | object[] | May | — |
| ressourcenId 00190 | ressourcenId | string | X | — |
| gueltigkeitszeitraum | — | object | May | — |
| zeitraumId 00200 | zeitraumId | integer | X | — |
| TECHNISCHE_RESSOURCE [ ] | — | object[] | May | — |
| ressourcenId 00210 | ressourcenId | string | X | — |
| gueltigkeitszeitraum | — | object | May | — |
| zeitraumId 00220 | zeitraumId | integer | X | — |
| VERWENDUNGSZEITRAUM [ ] * | — | object[] | Must | — |
| datenqualitaet * 00230 | 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 * 00240 | verwendungAb | string (date-time) | X | — |
| verwendungBis 00250 | verwendungBis | string (date-time) | X | — |
| zeitraumId * 00260 | zeitraumId | integer | Must | — |
| transaktionsdaten * | — | object | Must | — |
| dokumentennummer * 00270 | EDIFACT reference from the BGM segment / BGM | string | X | — |
| kategorie * 00280 | Qualifier from the beginning of the EDIFACT message / BGM | string | X | — |
| nachrichtendatum * 00290 | Creation date of the EDIFact / DTM+137 | string (date-time) | X | — |
| nachrichtenreferenznummer * 00300 | EDIFACT reference from the UNT segment / UTILMD UNT+21 | string | Must | — |
| pruefidentifikator * 00310 | Contains the check identifier from the EDIFact communication / RFF+Z13 | string | X | — |
| transaktionsgrund * 00320 | The transaction reason describes the business transaction for the category in more detail / UTILMD STS+7++###+ZW4+E03 | string | X | — |
| vorgangsnummer * 00330 | Number of the transaction / UTILMD UTILTS IDE+24 / INSRPT INVOIC DOC | string | X | — |
| absender * | — | object | Must | — |
| rollencodenummer * 00340 | Specifies the code value of the market role. | string | X | — |
| rollencodetyp * 00350 | Indicates the type of the code. | Enum Rollencodetyp | X | — |
BDEW | — | — | X | — |
GS1 | — | — | X | — |
GLN | — | — | X | — |
DVGW | — | — | X | — |
| empfaenger * | — | object | Must | — |
| rollencodenummer * 00360 | Specifies the code value of the market role. | string | X | — |
| rollencodetyp * 00370 | Indicates the type of the code. | Enum Rollencodetyp | X | — |
BDEW | — | — | X | — |
GS1 | — | — | X | — |
GLN | — | — | X | — |
DVGW | — | — | X | — |
Application handbook (AHB)
| Structure (EDIFACT) | Description | Format | 55173 | 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 | CCYYMMDDHHM MZZZ | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 MS00120 | Document/message issuer or sender | — | X | — |
303900130 | MP-ID | — | X | — |
3055 900140 | GS1 | — | X | — |
3055 29300150 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaf t 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 Wasserwirtschaf t e.V.) | — | X | — |
| SG4.IDE | — | — | Must | — |
7495 2400200 | Transaction | — | X | — |
740200210 | Transaction number | — | X | — |
| SG4.STS | — | — | Must | — |
9015 700220 | Transaction reason | — | X | — |
9013 ZY200230 | Change of the location bundle structure | — | X | — |
| SG5.LOC | — | — | Must | — |
3227 Z1800240 | Grid location | — | X | — |
322500250 | ID of the grid location | — | X | [960] |
322400260 | Time period ID | — | X | [914] ∧ [937] |
| SG5.LOC | — | — | Must | — |
3227 Z1600270 | Market location | — | X | — |
322500280 | ID of the market location | — | X | [950] |
322400290 | Time period ID | — | X | [914] ∧ [937] |
| SG5.LOC | — | — | Must | — |
3227 Z2200300 | Dormant market location | — | X | — |
322500310 | ID of the dormant market location | — | X | [950] |
322400320 | Time period ID | — | X | [914] ∧ [937] |
| SG5.LOC | — | — | Must | — |
3227 Z2000330 | Technical resource | — | X | — |
322500340 | ID of the technical resource | — | X | [922] |
322400350 | Time period ID | — | X | [914] ∧ [937] |
| SG5.LOC | — | — | Must | — |
3227 Z1900360 | Controllable resource | — | X | — |
322500370 | ID of the controllable resource | — | X | [961] |
322400380 | Time period ID | — | X | [914] ∧ [937] |
| SG5.LOC | — | — | Must | — |
3227 Z1700390 | Metering location | — | X | — |
322500400 | ID of the metering location | — | X | [951] |
322400410 | Time period ID | — | X | [914] ∧ [937] |
| SG6.RFF | — | — | Must | — |
1153 Z1300420 | Check identifier | — | X | — |
1154 5517300430 | GPKE / Change of the location bundle structure NB to MSB | — | X | — |
| SG6.RFF | — | — | Must | — |
1153 Z4900440 | Valid data | — | X | [1P0..n] |
1153 Z5300450 | No data | — | X | [1P0..n] |
115600460 | Time period ID | — | X | [914] ∧ [937] [126] |
| SG6.DTM | — | — | Must | [131] ⊻ [401] |
2005 Z2500470 | Data used from | — | X | — |
238000480 | Date or time or time span, value | — | X | [UB1] |
2379 30300490 | CCYYMMDDHHM MZZZ | — | X | — |
| SG6.DTM | — | — | Must | [471] |
2005 Z2600500 | Data used until | — | X | — |
238000510 | Date or time or time span, value | — | X | [UB1] |
2379 30300520 | CCYYMMDDHHM MZZZ | — | X | — |
| SG8.SEQ | — | — | Must | — |
1229 Z7800530 | Reference to the location bundle structure | — | X | — |
105000540 | Reference to time period ID | — | X | [914] ∧ [937] [22] |
| SG8.RFF | — | — | Must | — |
1153 Z3100550 | Location bundle structure | — | X | — |
1153 Z3900560 | No standardized location bundle structure available | — | X | — |
115400570 | ID of the location bundle structure | — | X | [333] |
115600580 | Consecutive number of a location bundle within the business transaction | — | — | M [914] ∧ [937] [242] |
| SG8.SEQ | — | — | Must | — |
1229 Z5800590 | Assignment of the location to the object code of the location bundle | — | X | — |
105000600 | Reference to time period ID | — | X | [914] ∧ [937] [22] |
| SG8.RFF | — | — | Must | — |
1153 Z3200610 | Grid location | — | X | — |
1153 Z1800620 | Market location | — | X | — |
1153 Z1900630 | Metering location | — | X | — |
1153 Z3700640 | Technical resource | — | X | — |
115400650 | ID of a location | — | X | ([451] ∧ [950]) ⊻ ([452] ∧ [951]) ⊻ ([450] ∧ [960]) ⊻ ([456] ∧ [922]) |
| SG8.RFF | — | — | Must | [2312] |
1153 Z3300660 | Object code of the location in the location bundle structure | — | X | — |
115400670 | Object code | — | X | — |
115600680 | Consecutive number of a location bundle within the business transaction | — | — | M [914] ∧ [937] [242] |
| SG8.RFF | — | — | Must | ([176] ∧ (([173] ∧ [179]) ⊻ ([174] ∧ [196]))) ⊻ ([177] ∧ [178] ∧ [229]) |
1153 Z3400690 | upstream metering location | — | X | — |
1153 Z3500700 | upstream grid location | — | X | — |
115400710 | ID of a location | — | X | ([442] ∧ [951]) ⊻ ([440] ∧ [960]) |
| SG8.RFF | — | — | Must | [179] ∧ [291] |
1153 Z1600720 | assigned market location | — | X | — |
115400730 | ID of the market location | — | X | [950] |
| UNT | — | — | Must | — |
007400740 | Number of segments in a message | — | X | — |
006200750 | Message reference number | — | X | — |
Conditions of this table
The free text of the 34 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 |
| [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 |
| [173] | If DE1156 (consecutive number of a location bundle in the business transaction) in the RFF+Z33 (reference to the object code in the location bundle structure) is not present in the same SG8 SEQ+Z58/ZC9/ZD0/ZD6 (assignment of location to the object code of the location bundle) |
| [174] | If DE1156 consecutive number of a location bundle in the business transaction) in the RFF+Z33 (reference to the object code in the location bundle structure) is present in the same SG8 SEQ+Z58/ZC9/ZD0/ZD6 (assignment of location to the object code of the location bundle) |
| [176] | If DE1153 with code Z34 upstream metering location is present in the same segment |
| [177] | If DE1153 with code Z35 upstream grid location is present in the same segment |
| [178] | If the LOC+Z18 (grid location) is present |
| [179] | If the object code in RFF+Z33 (reference to the object code in the location bundle struc ture) in DE1154 of the same SG8 SEQ+Z58/ZC9 / ZD0/ZD6 (assignment of location to the object code of the location bundle ) is present in a further SG8 SEQ+Z58/ZC9 / ZD0/ZD6 (assignment of location to the object code of the location bundle ) with an identical code in DE1229 |
| [196] | If the object code in RFF+Z33 (reference to the object code in the location bundle struc ture) in DE1154 of the same SG8 SEQ+Z58/ZC9/ZD0 (assignment of location to the object code of the location bundle ) is present in a further SG8 SEQ+Z58/ZC9/ZD0 with the same sequential number in DE1156 of the SG8 RFF, the same time period ID in DE1050 and identical codes in DE1229 of the SG8 SEQ |
| [229] | If the object code in RFF+Z33 (reference to the object code in the location bundle struc ture) in DE1154 of the same SG8 SEQ+Z58/ZC9/ZD0/ZD6 (assignment of location to the object code of the location bundle ) is present in a further SG8 SEQ+Z58/ZC9/ZD0/ZD6 (assignment of location to the object code of the location bundle ) with an identical time period ID in DE1050 and identical codes in DE1229 of the SG8 SEQ |
| [242] | If more than one SG8 (reference to the location bundle structure) with the same time period ID in DE1050 is present |
| [291] | If in the same SG8 (assignment of location to the object code of the location bundle ) the RFF+Z37 is present |
| [333] | If in this RFF "reference to the location bundle structure" the code Z31 "location bundle structure" is present in DE1153 |
| [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 |
| [440] | If code Z35 (upstream grid location) is present in DE1153 in the same RFF |
| [442] | If code Z34 (upstream metering location) is present in DE1153 in the same RFF |
| [450] | If code Z32 (grid location) is present in DE1153 in the same RFF |
| [451] | If code Z18 (market location) is present in DE1153 in the same RFF |
| [452] | If code Z19 (metering location) is present in DE1153 in the same RFF |
| [456] | If code Z37 (technical resource) is present in DE1153 in the same RFF |
| [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 |
| [922] | Format: TR-ID |
| [931] | Format: ZZZ = +00 |
| [937] | Format: no decimal places |
| [950] | Format: market location ID |
| [951] | Format: Metering point identifier |
| [960] | Format: Grid location ID |
| [961] | Format: SR-ID |
| [2312] | If the object code "9992000001256" (grid location) is not present in DE1154 of the same RFF+Z33, the RFF+Z33 must be specified exactly once in the same SG8 SEQ+Z58/ZC9/ZD0/ZD6 (assignment of location to the object code of the location bundle ) |
| [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+9900496000001:500+9900496000002:500+{{date}}:{{time}}+M3UMGXPN'
UNH+UNHM2W52SAM+UTILMD:D:11A:UN:S2.2'
BGM+E03+BGMM3FTBBT4'
DTM+137:202506050945?+00:303'
NAD+MS+9900496000001::293'
NAD+MR+9900496000002::293'
IDE+24+KBG27094210000000000929931413171000'
STS+7++ZY2'
LOC+Z18+E1688110018:::1'
LOC+Z16+50363198116:::1'
LOC+Z22+50363198122:::1'
LOC+Z20+D417MLM8120:::1'
LOC+Z19+C816417ST19:::1'
LOC+Z17+DE0032106765712000000000000001217:::1'
RFF+Z13:55173'
RFF+Z49::1'
DTM+Z25:202410202200?+00:303'
SEQ+Z78+1'
RFF+Z31:9992000000026'
SEQ+Z58+1'
RFF+Z19:DE0032106765712000000000000001217'
RFF+Z33:9992000001032'
SEQ+Z58+1'
RFF+Z37:D417MLM8120'
RFF+Z33:9992000001024'
SEQ+Z58+1'
RFF+Z18:50363198122'
RFF+Z33:9992000001016'
SEQ+Z58+1'
RFF+Z32:E1688110018'
RFF+Z33:9992000001256'
UNT+31+UNHM2W52SAM'
UNZ+1+M3UMGXPN'[1 item
{6 fields
"data": {3 fields
"stammdaten": {8 fields
"VERWENDUNGSZEITRAUM": [1 item
{5 fields
"MARKTLOKATION": [2 items
{6 fields
"marktlokationsTyp": [1 item
{1 field
"gueltigkeitszeitraum": {2 fields
{6 fields
"marktlokationsTyp": [1 item
{1 field
"gueltigkeitszeitraum": {2 fields
"NETZLOKATION": [1 item
{5 fields
"gueltigkeitszeitraum": {2 fields
"MESSLOKATION": [1 item
{5 fields
"gueltigkeitszeitraum": {2 fields
"TECHNISCHE_RESSOURCE": [1 item
{5 fields
"gueltigkeitszeitraum": {2 fields
"STEUERBARE_RESSOURCE": [1 item
{5 fields
"gueltigkeitszeitraum": {2 fields
"LOKATIONSBUENDEL": [1 item
{7 fields
"gueltigkeitszeitraum": {2 fields
"zuordnungObjectcode": [4 items
{3 fields
"objectcode": [1 item
{1 field
{3 fields
"objectcode": [1 item
{1 field
{3 fields
"objectcode": [1 item
{1 field
{3 fields
"objectcode": [1 item
{1 field
"NETZNUTZUNGSVERTRAG": [1 item
{6 fields
"transaktionsdaten": {11 fields
"absender": {5 fields
"empfaenger": {5 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 NB (responsible) | GPKE part 4 | Electricity | Step 4 |
| NB | NB | Master data change initiated by the NB (responsible) | GPKE part 4 | Electricity | Step 4 |
| MSB | MSB | Master data change initiated by the NB (responsible) | GPKE part 4 | Electricity | Step 4 |
| ÜNB | ÜNB | Master data change initiated by the NB (responsible) | GPKE part 4 | Electricity | Step 4 |
Business classification
| Attribute | Value |
|---|---|
| Use case (AHB) | Change of the location bundle structure |
| AHB | UTILMD AHB electricity |
| Transmission channel | AS4 |
| Process description / rulebook | Process step | Communication | Action |
|---|---|---|---|
| GPKE part 4 | Master data change initiated by the NB (responsible) | NB → MSB | Change from the NB to MSB |
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 100 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.