Check identifier 55651 — Change to data of SR
Check identifier 55651 · EDIFACT message type UTILMD · format version 202610
Data structure
| Structure (BO4E) | Description | Format | 55651 | Condition |
|---|---|---|---|---|
| stammdaten * | — | object | Must | — |
| STEUERBARE_RESSOURCE [ ] * | — | 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 | — |
| keinKonfigurationsprodukt 00020 | keinKonfigurationsprodukt | boolean | X | — |
| konfigurationsprodukt 00030 | konfigurationsprodukt | string | X | — |
| produktdatenRelevanteRolle 00040 | A market participant can take on these roles | Enum Marktrolle | Must | — |
NB | — | — | Must | — |
LF | — | — | Must | — |
MSB | — | — | Must | — |
MSBA | — | — | Must | — |
GMSB | — | — | Must | — |
MDL | — | — | Must | — |
DL | — | — | Must | — |
BKV | — | — | Must | — |
UENB | — | — | Must | — |
KUNDE-SELBST-NN | — | — | Must | — |
MGV | — | — | Must | — |
EIV | — | — | Must | — |
RB | — | — | Must | — |
KUNDE | — | — | Must | — |
INTERESSENT | — | — | Must | — |
KN | — | — | Must | — |
UBA | — | — | Must | — |
BIKO | — | — | Must | — |
ESA | — | — | Must | — |
| ressourcenId * 00050 | ressourcenId | string | X | — |
| steuerkanal 00060 | Control channel | Enum Steuerkanal | X | — |
AN_AUS | — | — | X | — |
GESTUFT | — | — | X | — |
| auftraggebenderMarktpartner | — | object | May | — |
| marktrolle 00070 | Indicates the designation of the market role in free text. | Enum Marktrolle | Must | — |
NB | — | — | Must | — |
LF | — | — | Must | — |
MSB | — | — | Must | — |
MSBA | — | — | Must | — |
GMSB | — | — | Must | — |
MDL | — | — | Must | — |
DL | — | — | Must | — |
BKV | — | — | Must | — |
UENB | — | — | Must | — |
KUNDE-SELBST-NN | — | — | Must | — |
MGV | — | — | Must | — |
EIV | — | — | Must | — |
RB | — | — | Must | — |
KUNDE | — | — | Must | — |
INTERESSENT | — | — | Must | — |
KN | — | — | Must | — |
UBA | — | — | Must | — |
BIKO | — | — | Must | — |
ESA | — | — | Must | — |
| rollencodenummer 00080 | Specifies the code value of the market role. | string | Must | — |
| gueltigkeitszeitraum | — | object | May | — |
| zeitraumId 00090 | zeitraumId | integer | X | — |
| zugeordneteDefinition | — | object | May | — |
| leistungskurvendefinition 00100 | leistungskurvendefinition | string | Must | — |
| schaltzeitdefinition 00110 | schaltzeitdefinition | string | Must | — |
| VERWENDUNGSZEITRAUM [ ] * | — | object[] | Must | — |
| datenqualitaet * 00120 | 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 * 00130 | verwendungAb | string (date-time) | X | — |
| verwendungBis 00140 | verwendungBis | string (date-time) | X | — |
| zeitraumId * 00150 | zeitraumId | integer | Must | — |
| transaktionsdaten * | — | object | Must | — |
| dokumentennummer * 00160 | EDIFACT reference from the BGM segment / BGM | string | X | — |
| kategorie * 00170 | Qualifier from the beginning of the EDIFACT message / BGM | string | X | — |
| nachrichtendatum * 00180 | Creation date of the EDIFact / DTM+137 | string (date-time) | X | — |
| nachrichtenreferenznummer * 00190 | EDIFACT reference from the UNT segment / UTILMD UNT+21 | string | Must | — |
| pruefidentifikator * 00200 | Contains the check identifier from the EDIFact communication / RFF+Z13 | string | X | — |
| transaktionsgrund * 00210 | The transaction reason describes the business transaction for the category in more detail / UTILMD STS+7++###+ZW4+E03 | string | X | — |
| vorgangsnummer * 00220 | Number of the transaction / UTILMD UTILTS IDE+24 / INSRPT INVOIC DOC | string | X | — |
| absender * | — | object | Must | — |
| rollencodenummer * 00230 | Specifies the code value of the market role. | string | X | — |
| rollencodetyp * 00240 | Indicates the type of the code. | Enum Rollencodetyp | X | — |
BDEW | — | — | X | — |
GS1 | — | — | X | — |
GLN | — | — | X | — |
DVGW | — | — | X | — |
| 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 | 55651 | 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 issuer 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 ZX900230 | Change data of the SR | — | X | — |
| SG5.LOC | — | — | Must | — |
3227 Z1900240 | Controllable resource | — | X | — |
322500250 | ID of the controllable resource | — | X | [961] |
| SG6.RFF | — | — | Must | — |
1153 Z1300260 | Check identifier | — | X | — |
1154 5565100270 | GPKE / Change data of the SR from MSB to LF | — | 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 Z6200370 | Data of the controllable resource | — | X | — |
105000380 | Reference to time period ID | — | X | [914] ∧ [937] [22] |
| SG10.CCI | — | — | Must | — |
7059 Z4900390 | Control channel | — | X | — |
| SG10.CAV | — | — | Must | — |
7111 ZF200400 | Service description of the control channel | — | X | — |
1131 Z1400410 | On/Off | — | X | — |
1131 Z1500420 | Tiered | — | X | — |
| SG8.SEQ | — | — | Must | — |
1229 Z6100430 | Product data of the controllable resource | — | X | — |
105000440 | Reference to time period ID | — | X | [914] ∧ [937] [22] |
| SG8.PIA | — | — | Must | [81] |
4347 500450 | Product identification | — | X | — |
714000460 | Configuration product code | — | X | — |
7143 Z1200470 | Configuration product | — | X | — |
| SG10.CCI | — | — | Must | — |
7059 1100480 | Product | — | X | — |
7037 ZF600490 | No product assigned | — | X | — |
| SG10.CCI | — | — | Must | — |
7059 Z5200500 | Code of the switching time definition | — | X | — |
7059 Z5300510 | Code of the power curve definition | — | X | — |
703700520 | Code of the definition | — | X | — |
| SG10.CCI | — | — | Must | — |
7037 ZB300530 | Assigned market partner | — | X | — |
| SG10.CAV | — | — | Must | — |
7111 Z8800540 | NB | — | X | — |
7111 Z8900550 | LF | — | X | — |
113100560 | MP-ID | — | X | — |
| SG10.CCI | — | — | Must | — |
7037 ZA700570 | LF | — | X | — |
| UNT | — | — | Must | — |
007400580 | Number of segments in a message | — | X | — |
006200590 | Message reference number | — | X | — |
Conditions of this table
The free text of the 13 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 |
| [81] | If in the same SG8 SEQ+Z61/ZB3/ZB4 (product data of the controllable resource) the SG10 CCI+11 (details on the product of the controllable resource) is not present |
| [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 |
| [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 |
| [931] | Format: ZZZ = +00 |
| [937] | Format: no decimal places |
| [961] | Format: SR-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+9900321000005:500+9903790000002:500+{{date}}:{{time}}+M0JN3AAC'
UNH+UNHLZVRLW0N+UTILMD:D:11A:UN:S2.2'
BGM+E03+BGMLZOU34CN'
DTM+137:202610021100?+00:303'
NAD+MS+9900321000005::293'
NAD+MR+9903790000002::293'
IDE+24+123456'
STS+7++ZX9'
LOC+Z19+C816417ST77'
RFF+Z13:55651'
RFF+Z49::1'
DTM+Z25:202504022200?+00:303'
SEQ+Z62+1'
CCI+Z49'
CAV+ZF2:Z14'
SEQ+Z61+1'
PIA+5+9991000000721:Z12'
CCI+Z53++ABC'
CCI+++ZB3'
CAV+Z89:9903790000002'
CCI+++ZA7'
UNT+21+UNHLZVRLW0N'
UNZ+1+M0JN3AAC'[1 item
{6 fields
"data": {3 fields
"stammdaten": {2 fields
"VERWENDUNGSZEITRAUM": [1 item
{5 fields
"STEUERBARE_RESSOURCE": [1 item
{11 fields
"gueltigkeitszeitraum": {2 fields
"auftraggebenderMarktpartner": {4 fields
"zugeordneteDefinition": {1 field
"transaktionsdaten": {12 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 MSB (responsible) | GPKE part 4 | Electricity | Step 4 |
| NB | NB | Master data change initiated by the MSB (responsible) | GPKE part 4 | Electricity | Step 4 |
| MSB | MSB | Master data change initiated by the MSB (responsible) | GPKE part 4 | Electricity | Step 4 |
| MSB | WMSB | Master data change initiated by the MSB (responsible) | GPKE part 4 | Electricity | Step 4 |
| ÜNB | ÜNB | Master data change initiated by the MSB (responsible) | GPKE part 4 | Electricity | Step 4 |
Business classification
| Attribute | Value |
|---|---|
| Use case (AHB) | Change data of the SR |
| 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 → LF | Change from the MSB to LF |
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 82 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.