Check identifier 55017 — Confirmation of contract termination
Check identifier 55017 · EDIFACT message type UTILMD · Format version 202604
Data structure
| Structure (BO4E) | Description | Format | 55017 | Condition |
|---|---|---|---|---|
| stammdaten | — | object | May | — |
| BILANZIERUNG [ ] | — | object[] | May | — |
| vorjahresverbrauch | — | object | May | — |
| einheit 00010 | Unit: measurands that can be determined by measurement or by specification | Enum Mengeneinheit | X | — |
W | — | — | X | — |
WH | — | — | X | — |
KW | — | — | X | — |
KWH | — | — | X | — |
KVARH | — | — | X | — |
MW | — | — | X | — |
MWH | — | — | X | — |
STUECK | — | — | X | — |
KUBIKMETER | — | — | X | — |
STUNDE | — | — | X | — |
TAG | — | — | X | — |
MONAT | — | — | X | — |
JAHR | — | — | X | — |
PROZENT | — | — | X | — |
ANZAHL | — | — | X | — |
VAR | — | — | X | — |
KVAR | — | — | X | — |
VARH | — | — | X | — |
KWHK | — | — | X | — |
Z16 | — | — | X | — |
KWT | — | — | X | — |
WATT_PRO_QUADRATMETER | — | — | X | — |
METER_PRO_SEKUNDE | — | — | X | — |
| wert 00020 | Value | number (float) | X | — |
| NETZNUTZUNGSVERTRAG [ ] | — | object[] | May | — |
| vertragsende 00030 | Specifies when the contract (is expected to) end or was ended. | string (date-time) | X | — |
| transaktionsdaten * | — | object | Must | — |
| anfragereferenznummer * 00040 | Reference transaction number 'from request message' / ORDERS RFF+TN / IFTSTA RFF+AAV / INSRPT RFF+TN RFF+AAV | string | X | — |
| antwortstatus * 00050 | Response status / STS+E01 | string | X | — |
| antwortstatusCodeliste * 00060 | Response status code list / STS+E01 | string | X | — |
| dokumentennummer * 00070 | EDIFACT reference from the BGM segment / BGM | string | X | — |
| endezumtermin 00080 | Termination date / DTM+471 | string (date-time) | X | — |
| kategorie * 00090 | Qualifier from the beginning of the EDIFACT message / BGM | string | X | — |
| nachrichtendatum * 00100 | Creation date of the EDIFact / DTM+137 | string (date-time) | X | — |
| nachrichtenreferenznummer * 00110 | EDIFACT reference from the UNT segment / UTILMD UNT+21 | string | Must | — |
| pruefidentifikator * 00120 | Contains the check identifier from the EDIFact communication / RFF+Z13 | string | X | — |
| transaktionsgrund * 00130 | The transaction reason describes the business transaction for the category in more detail / UTILMD STS+7++###+ZW4+E03 | string | X | — |
| transaktionsgrundergaenzung * 00140 | Supplement to the transaction reason / UTILMD STS+7++E01+###+E03 | string | X | — |
| vertragsende 00150 | Contract end date / DTM+93 | string (date-time) | X | — |
| vorgangsnummer * 00160 | Number of the transaction / UTILMD UTILTS IDE+24 / INSRPT INVOIC DOC | string | X | — |
| absender * | — | object | Must | — |
| rollencodenummer * 00170 | Specifies the code value of the market role. | string | X | — |
| rollencodetyp * 00180 | Indicates the type of the code. | Enum Rollencodetyp | X | — |
BDEW | — | — | X | — |
GS1 | — | — | X | — |
GLN | — | — | X | — |
DVGW | — | — | X | — |
| ansprechpartner | — | object | May | — |
| eMailAdresse 00190 | Email address | string | Must | — |
| nachname 00200 | Surname (family name) of the contact person | string | Must | — |
| rufnummern [ ] | — | object[] | May | — |
| nummerntyp 00210 | 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 00220 | rufnummer | string | Must | — |
| empfaenger * | — | 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 | — |
Application handbook (AHB)
| Structure (EDIFACT) | Description | Format | 55017 | 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.100060 | Version number of the underlying BDEW message description | — | X | — |
| BGM | — | — | Must | — |
1001 E3500070 | Contract termination | — | 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 | — |
| SG3.CTA | — | — | Must | — |
3139 IC00160 | Information contact | — | X | — |
341200170 | Name of the contact person | — | X | — |
| SG3.COM | — | — | Must | — |
314800180 | Number / address | — | X | (([939] [321]) ∨ ([940] [322])) ∧ [514] |
3155 EM00190 | Electronic mail | — | X | [1P0..1] |
3155 FX00200 | Fax number | — | X | [1P0..1] |
3155 TE00210 | Telephone | — | X | [1P0..1] |
3155 AJ00220 | further telephone | — | X | [1P0..1] |
3155 AL00230 | Mobile phone | — | X | [1P0..1] |
| SG2.NAD | — | — | Must | — |
3035 MR00240 | Message recipient | — | X | — |
303900250 | MP-ID | — | X | — |
3055 900260 | GS1 | — | X | — |
3055 29300270 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
| SG4.IDE | — | — | Must | — |
7495 2400280 | Transaction | — | X | — |
740200290 | Transaction number | — | X | — |
| SG4.DTM | — | — | Must | [12] ∧ [357] ∧ [704] |
2005 9300300 | Contract end date | — | X | — |
238000310 | Date or time or time span, value | — | X | [UB1] |
2379 30300320 | CCYYMMDDHHMMZZZ | — | X | — |
| SG4.DTM | — | — | Must | [18] ∧ [513] ∧ [704] |
2005 47100330 | End on (next possible date) | — | X | — |
238000340 | Date or time or time span, value | — | X | [UB1] |
2379 30300350 | CCYYMMDDHHMMZZZ | — | X | — |
| SG4.STS | — | — | Must | — |
9015 700360 | Transaction reason | — | X | — |
9013 E0300370 | Change | — | X | — |
9013 ZW300380 | Generating market location | — | X | — |
9013 ZW400390 | Consuming market location | — | X | — |
9013 ZW500400 | Tranche | — | X | — |
| SG4.STS | — | — | Must | [2061] |
9015 E0100410 | Status of the response | — | X | — |
901300420 | Code of the check step | — | X | [360] |
1131 E_061400430 | EBD no. E_0614 | — | X | — |
| SG6.RFF | — | — | Must | — |
1153 Z1300440 | Check identifier | — | X | — |
1154 5501700450 | GPKE / Confirmation contract termination | — | X | — |
| SG6.RFF | — | — | Must | — |
1153 TN00460 | Transaction reference number | — | X | — |
115400470 | Transaction number | — | X | — |
| SG8.SEQ | — | — | Must | — |
1229 Z0100480 | Data of the market location | — | X | — |
| SG9.QTY | — | — | Must | — |
6063 Z0900490 | Previous year's consumption | — | X | — |
606000500 | Quantity specification | — | X | [902] ∧ [937] |
6411 KWH00510 | Kilowatt hour | — | X | — |
| UNT | — | — | Must | — |
007400520 | Number of segments in a message | — | X | — |
006200530 | Message reference number | — | X | — |
Conditions of this table
The free text of the 18 conditions referenced by the rows above. All conditions of the message type are listed in the condition index UTILMDS.
| Marker | Condition |
|---|---|
| [12] | If SG4 DTM+471 (end at the next possible date) is not present |
| [18] | If SG4 DTM+93 (end as of) is not present |
| [321] | If code EM is present in DE3155 in the same COM |
| [322] | If code TE / FX / AJ / AL is present in DE3155 in the same COM |
| [357] | If SG4 STS+E01++A03/A09/A12/A17 (status of the response) is present |
| [360] | Only response codes from the consent cluster are permitted |
| [494] | The date stated here must be the point in time at which the document was created, or a point in time before that |
| [513] | Note: The next possible date must be determined from the DTM+471 in the corresponding request |
| [514] | Note: Only one piece of information may be transmitted in DE3148 |
| [704] | Note: Segment is to be used if it was present in the request |
| [902] | Format: Possible value: ≥ 0 |
| [931] | Format: ZZZ = +00 |
| [937] | Format: no decimal places |
| [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 |
| [2061] | Segment or segment group must be specified exactly once per SG4 IDE (transaction) |
| [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]) |
Example message
UNA:+.? '
UNB+UNOC:3+9903448000007:500+9911694000002:500+{{date}}:{{time}}+P102845739A'
UNH+1+UTILMD:D:11A:UN:S2.1'
BGM+E35+P102845739A-1'
DTM+137:202404011547?+00:303'
NAD+MS+9903448000007::293'
NAD+MR+9911694000002::293'
IDE+24+ECOUNT_207917572'
DTM+471:202511302300?+00:303'
STS+7++E03+ZW4'
STS+E01++A09:E_0614'
RFF+Z13:55017'
RFF+TN:PCL09023100613515599116940000022246'
SEQ+Z01'
QTY+Z09:6460:KWH'
UNT+14+1'
UNZ+1+P102845739A'[1 item
{6 fields
"data": {2 fields
"stammdaten": {1 field
"BILANZIERUNG": [1 item
{3 fields
"vorjahresverbrauch": {2 fields
"transaktionsdaten": {16 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 is LF.
| Role | Party involved | Process | Rulebook | Division | Step |
|---|---|---|---|---|---|
| LF | LFA | Contract termination | GPKE part 2 | Electricity | Step 2 |
| LF | LFN | Contract termination | GPKE part 2 | Electricity | Step 2 |
Business classification
| Attribute | Value |
|---|---|
| Use case (AHB) | Confirmation of contract termination |
| AHB | UTILMD AHB electricity |
| Decision tree | E_0614 |
| Transmission channel | AS4 |
| Process description / rulebook | Process step | Communication | Action |
|---|---|---|---|
| GPKE part 2 | Contract termination | LFA → LFN | Response to contract termination |
One entry from format version 202610
The check identifiers table of format version 202604 does not carry this entry: decision tree. It comes from version 202610. Everything else on this page — use case, rulebook and communication direction — comes from its own version. Before adopting this into an implementation specification, check whether what is stated applies to 202604.
Transaction and responses
Role of this check identifier: response — confirmation. Basis: the transaction data carry antwortstatus and antwortstatusCodeliste; the title or the action of the Prüfi table begins with “response”; the title names a polarity (confirmation).
Which request this message responds to
| Role | Check identifier | Use case | Message type | Origin of supply |
|---|---|---|---|---|
| Request | 55016 | Contract termination | UTILMD | from the step sequence |
In which field the request is quoted
| Reference field of this message | EDIFACT segment | Target field in the request |
|---|---|---|
anfragereferenznummer | SG4.IDE+24.SG6.RFF+TN | vorgangsnummer |
For RFF+TN, the time slice field description gives »reference transaction number (from request message)« — the target is the vorgangsnummer in segment SG4.IDE+24 of the request. Measured: 55016 lists vorgangsnummer in SG4.IDE+24.
Response codes
Decision tree E_0614 — named in: AHB STS DE1131 and Prüfi table.
Only the codes from the consent cluster are shown: the tree carries both clusters, the handbook of this check identifier names exactly this one tree, and the title is polar (confirmation). If one of the three conditions were missing, all codes would be listed here with their label.
| Response code | Cluster | Meaning | Outputs |
|---|---|---|---|
| A03 | Consent | Contract has already been terminated as of the requested termination date. | 1 |
| A09 | Consent | Consent | 1 |
| A12 | Consent | Contract has already been terminated as of the requested termination date. | 1 |
| A17 | Consent | Consent | 1 |
Check identifiers of the same AHB table: No other check identifier of message type UTILMDS has the same row structure in this version.
Editorial — not derived from a source
Which date field the confirmation carries. vertragsende (SG4.IDE+24.DTM+93) is used in the confirmation if the request carried it — condition [704] at the head of this segment: “Segment is to be used if it was present in the request”. endezumtermin (SG4.IDE+24.DTM+471) is determined under condition [513] from the DTM+471 of the request: “The next possible date from the DTM+471 of the corresponding request is to be determined” — the value can therefore differ from the one requested. Both segments fall under [357]: they apply only if the response carries an approval code (STS+E01++A03, A09, A12, A17). The expression of the two header rows reads Muss [12] ∧ [357] ∧ [704] and Muss [18] ∧ [513] ∧ [704] respectively in both versions; [12] and [18] exclude the two date fields from one another (“If SG4 DTM+471 is not present” / “If SG4 DTM+93 is not present”). The conditions themselves appear generated in the Application handbook (AHB) section of this page, with free text below the table; what is stated here is only what they mean together.
| requested in (55016) | confirmed in (55017) | Ratio |
|---|---|---|
vertragsende · SG4.IDE+24.DTM+93 | vertragsende · SG4.IDE+24.DTM+93 | Presence: the segment is used because the request carried it ([704]) |
endezumtermin · SG4.IDE+24.DTM+471 | endezumtermin · SG4.IDE+24.DTM+471 | derived value: earliest possible date from the requested one ([513]) — may differ |
Source: UTILMD AHB electricity, versions 202604 and 202610 (Knowledge Collection ahb/202604/UTILMDS and ahb/202610/UTILMDS, files 55016.json and 55017.json), conditions [12], [18], [357], [513], [704]; decision tree E_0614 · As of: 2026-09-05 · Applies to format version: 202604, 202610 · To be reviewed by: 2027-04-01
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 70 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.