Check identifier 17121 — Order placement change
Check identifier 17121 · EDIFACT message type ORDERS · Format version 202610
Data structure
| Structure (BO4E) | Description | Format | 17121 | Condition |
|---|---|---|---|---|
| stammdaten * | — | object | Must | — |
| ANFRAGE [ ] * | — | object[] | Must | — |
| energierichtung * 00010 | Specifies the energy direction of a market location and/or metering location | Enum Energierichtung | Must | — |
AUSSP | — | — | Must | — |
EINSP | — | — | Must | — |
| lokationsId * 00020 | Which market or metering location this request applies to. | string | X | — |
| AUFTRAG [ ] * | — | object[] | Must | — |
| ausfuehrungsdatum * 00030 | The execution date describes at which point in time an order is to be executed. | string (date-time) | X | — |
| positionsdaten [ ] | — | object[] | May | — |
| positionsnummer 00040 | Line item number | integer | X | — |
| MARKTLOKATION [ ] | — | object[] | May | — |
| zaehlwerke [ ] | — | object[] | May | — |
| messprodukt 00050 | messprodukt | string | X | — |
| verwendungszweckLF 00060 | Codes according to the code list of the purposes of use Purpose of use LF | string | X | — |
| verwendungszweckNB 00070 | Codes according to the code list of the purposes of use Purpose of use NB | string | X | — |
| verwendungszweckUENB 00080 | Codes according to the code list of the purposes of use Purpose of use ÜNB | string | X | — |
| zaehlzeiten | — | object | May | — |
| zaehlzeitDefinition 00090 | Metering time period definition | string | Must | — |
| MESSLOKATION [ ] | — | object[] | May | — |
| messlokationsId 00100 | The metering location identification. This is the former metering point identifier, e.g. DE 47108151234567 | string | X | — |
| zaehlwerke [ ] | — | object[] | May | — |
| messprodukt 00110 | messprodukt | string | X | — |
| notwendigkeitZweiteMessung 00120 | Necessity of second measurement | Enum NotwendigkeitZweiteMessung | X | — |
VORHANDEN | — | — | X | — |
NICHT_VORHANDEN | — | — | X | — |
| werteuebermittlungVerwendungszweck 00130 | Purpose of use for value transmission | Enum WerteuebermittlungVerwendungszweck | X | — |
VORHANDEN | — | — | X | — |
NICHT_VORHANDEN | — | — | X | — |
| zaehlzeiten | — | object | May | — |
| zaehlzeitDefinition 00140 | Metering time period definition | string | Must | — |
| NETZLOKATION [ ] | — | object[] | May | — |
| zaehlwerke [ ] | — | object[] | May | — |
| messprodukt 00150 | messprodukt | string | X | — |
| verwendungszweckLF 00160 | Codes according to the code list of the purposes of use Purpose of use LF | string | X | — |
| verwendungszweckNB 00170 | Codes according to the code list of the purposes of use Purpose of use NB | string | X | — |
| TRANCHE [ ] | — | object[] | May | — |
| tranchenId 00180 | tranchenId | string | X | — |
| zaehlwerke [ ] | — | object[] | May | — |
| messprodukt 00190 | messprodukt | string | X | — |
| verwendungszweckLF 00200 | Codes according to the code list of the purposes of use Purpose of use LF | string | X | — |
| verwendungszweckNB 00210 | Codes according to the code list of the purposes of use Purpose of use NB | string | X | — |
| verwendungszweckUENB 00220 | Codes according to the code list of the purposes of use Purpose of use ÜNB | string | X | — |
| transaktionsdaten * | — | object | Must | — |
| dokumentennummer * 00230 | EDIFACT reference from the BGM segment / BGM | string | X | — |
| nachrichtendatum * 00240 | Creation date of the EDIFact / DTM+137 | string (date-time) | X | — |
| nachrichtenreferenznummer * 00250 | EDIFACT reference from the UNT segment / UTILMD UNT+21 | string | Must | — |
| pruefidentifikator * 00260 | Contains the check identifier from the EDIFact communication / RFF+Z13 | string | X | — |
| absender * | — | object | Must | — |
| rollencodenummer * 00270 | Specifies the code value of the market role. | string | X | — |
| rollencodetyp * 00280 | Indicates the type of the code. | Enum Rollencodetyp | X | — |
BDEW | — | — | X | — |
GS1 | — | — | X | — |
GLN | — | — | X | — |
DVGW | — | — | X | — |
| empfaenger * | — | object | Must | — |
| rollencodenummer * 00290 | Specifies the code value of the market role. | string | X | — |
| rollencodetyp * 00300 | Indicates the type of the code. | Enum Rollencodetyp | X | — |
BDEW | — | — | X | — |
GS1 | — | — | X | — |
GLN | — | — | X | — |
DVGW | — | — | X | — |
Application handbook (AHB)
| Structure (EDIFACT) | Description | Format | 17121 | Condition |
|---|---|---|---|---|
| UNH | — | — | Must | — |
006200010 | Message reference number | — | X | — |
0065 ORDERS00020 | Order placement | — | X | — |
0052 D00030 | Draft version | — | X | — |
0054 09B00040 | Edition 2009 - B | — | X | — |
0051 UN00050 | UN/CEFACT | — | X | — |
0057 1.4c00060 | Version number of the underlying BDEW message description | — | X | — |
| BGM | — | — | Must | — |
1001 Z6800070 | Change | — | 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 | — |
| DTM | — | — | Must | — |
2005 20300120 | Execution date/time | — | X | — |
238000130 | Date or time or time span, value | — | X | [UB1] |
2379 30300140 | CCYYMMDDHHMMZZZ | — | X | — |
| IMD | — | — | Must | — |
7081 Z1400150 | Delivery direction | — | X | — |
7009 Z0600160 | Generation | — | X | — |
7009 Z0700170 | Consumption | — | X | — |
| SG1.RFF | — | — | Must | — |
1153 Z1300180 | Check identifier | — | X | — |
1154 1712100190 | Order placement for change | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 MS00200 | Document-/message sender or sender | — | X | — |
303900210 | MP-ID | — | X | [61] |
3055 900220 | GS1 | — | X | — |
3055 29300230 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 MR00240 | Message recipient | — | X | — |
303900250 | MP-ID | — | X | [61] |
3055 900260 | GS1 | — | X | — |
3055 29300270 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 DP00280 | Supply address | — | X | — |
| SG2.LOC | — | — | Must | — |
3227 17200290 | Reporting point | — | X | — |
322500300 | Identifier | — | X | ([950] [521]) ⊻ ([960] [552]) |
| SG29.LIN | — | — | Must | — |
108200310 | Line item number | — | X | [911] |
1229 Z5400320 | Required product of the market location | — | X | — |
| SG29.PIA | — | — | Must | — |
4347 500330 | Product identification | — | X | — |
714000340 | Product code | — | X | [95] |
7143 Z1100350 | Product | — | X | — |
714300360 | Purpose of use NB | — | X | [198] |
1131 Z1600370 | EDI@Energy code list of purposes of use | — | X | — |
714300380 | Purpose of use LF | — | X | [199] |
1131 Z1600390 | EDI@Energy code list of purposes of use | — | X | — |
714300400 | Purpose of use ÜNB | — | X | [200] |
1131 Z1600410 | EDI@Energy code list of purposes of use | — | X | — |
| SG30.CCI | — | — | Must | — |
7059 Z3900420 | Code of the metering time period definition | — | X | — |
7059 Z4100430 | No metering time period required for metering product | — | X | [75] |
703700440 | Code of the metering time period definition | — | X | [77] |
| SG29.LIN | — | — | Must | — |
108200450 | Line item number | — | X | [911] |
1229 Z1600460 | Required product of the tranche | — | X | — |
| SG29.PIA | — | — | Must | — |
4347 500470 | Product identification | — | X | — |
714000480 | Product code | — | X | [96] |
7143 Z1100490 | Product | — | X | — |
714300500 | Purpose of use NB | — | X | [201] |
1131 Z1600510 | EDI@Energy code list of purposes of use | — | X | — |
714300520 | Purpose of use LF | — | X | [202] |
1131 Z1600530 | EDI@Energy code list of purposes of use | — | X | — |
714300540 | Purpose of use ÜNB | — | X | [203] |
1131 Z1600550 | EDI@Energy code list of purposes of use | — | X | — |
| SG34.RFF | — | — | Must | — |
1153 Z2000560 | Tranche | — | X | — |
115400570 | ID of the tranche | — | X | [950] |
| SG29.LIN | — | — | Must | — |
108200580 | Line item number | — | X | [911] |
1229 Z1900590 | Required product of the metering location | — | X | — |
| SG29.PIA | — | — | Must | — |
4347 500600 | Product identification | — | X | — |
714000610 | Product code | — | X | [100] |
7143 Z1100620 | Product | — | X | — |
| SG30.CCI | — | — | Must | — |
7059 Z3500630 | Description required value | — | X | — |
| SG30.CAV | — | — | Must | — |
7111 ZC900640 | Second measurement required for comparative measurement | — | X | — |
7110 Z0600650 | present | — | X | — |
7110 Z0700660 | not present | — | X | — |
| SG30.CAV | — | — | Must | — |
7111 Z8800670 | NB | — | X | — |
7110 Z0600680 | present | — | X | — |
7110 Z0700690 | not present | — | X | — |
| SG30.CCI | — | — | Must | — |
7059 Z3900700 | Code of the metering time period definition | — | X | — |
7059 Z4100710 | No metering time period required for metering product | — | X | [75] |
703700720 | Code of the metering time period definition | — | X | [77] |
| SG34.RFF | — | — | Must | — |
1153 Z1900730 | Metering location | — | X | — |
115400740 | ID of the metering location | — | X | [951] |
| SG29.LIN | — | — | Must | — |
108200750 | Line item number | — | X | [911] |
1229 Z5500760 | Required product of the grid location | — | X | — |
| SG29.PIA | — | — | Must | — |
4347 500770 | Product identification | — | X | — |
714000780 | Product code | — | X | [140] |
7143 Z1100790 | Product | — | X | — |
714300800 | Purpose of use NB | — | X | [196] |
1131 Z1600810 | EDI@Energy code list of purposes of use | — | X | — |
714300820 | Purpose of use LF | — | X | [197] |
1131 Z1600830 | EDI@Energy code list of purposes of use | — | X | — |
| UNS | — | — | Must | — |
0081 S00840 | Separation of detail and summary section | — | X | — |
| UNT | — | — | Must | — |
007400850 | Number of segments in a message | — | X | — |
006200860 | Message reference number | — | X | — |
Conditions of this table
The free text of the 24 conditions referenced by the rows above. All conditions of the message type are listed in the condition index ORDERS.
| Marker | Condition |
|---|---|
| [61] | MP-ID only from division electricity |
| [75] | If no metering time period is required for the required value |
| [77] | If code Z39 (code of the metering time period definition) is present in DE7059 in the same CCI |
| [95] | Metering product code from chapter 2.1 "Standard metering products of the market location" of the code list of configurations |
| [96] | Metering product code from chapter 2.2 "Standard metering products of the tranche" of the code list of configurations |
| [100] | Metering product code from chapter 2.3 "Standard metering products of the metering location" of the code list of configurations |
| [140] | Metering product code from chapter 2.4 "Standard metering products of the grid location" of the code list of configurations |
| [196] | Only codes from the „Code“ column of the code list of purposes of use (chapter 2) are permitted, provided that an „X“ is set in the same row both in the „Location/NeLo“ column and in the „Usable for market role/NB“ column and the statements in the „Explanation“ column match the product code specified in DE7140 of the same PIA |
| [197] | Only codes from the „Code“ column of the code list of purposes of use (chapter 2) are permitted, provided that an „X“ is set in the same row both in the „Location/NeLo“ column and in the „Usable for market role/LF“ column and the statements in the „Explanation“ column match the product code specified in DE7140 of the same PIA |
| [198] | Only codes from the „Code“ column of the code list of purposes of use (chapter 2) are permitted, provided that an „X“ is set in the same row both in the „Location/MaLo“ column and in the „Usable for market role/NB“ column and the statements in the „Explanation“ column match the product code specified in DE7140 of the same PIA |
| [199] | Only codes from the „Code“ column of the code list of purposes of use (chapter 2) are permitted, provided that an „X“ is set in the same row both in the „Location/MaLo“ column and in the „Usable for market role/LF“ column and the statements in the „Explanation“ column match the product code specified in DE7140 of the same PIA |
| [200] | Only codes from the „Code“ column of the code list of purposes of use (chapter 2) are permitted, provided that an „X“ is set in the same row both in the „Location/MaLo“ column and in the „Usable for market role/ÜNB“ column and the statements in the „Explanation“ column match the product code specified in DE7140 of the same PIA |
| [201] | Only codes from the „Code“ column of the code list of purposes of use (chapter 2) are permitted, provided that an „X“ is set in the same row both in the „Location/Tranche“ column and in the „Usable for market role/NB“ column and the statements in the „Explanation“ column match the product code specified in DE7140 of the same PIA |
| [202] | Only codes from the „Code“ column of the code list of purposes of use (chapter 2) are permitted, provided that an „X“ is set in the same row both in the „Location/Tranche“ column and in the „Usable for market role/LF“ column and the statements in the „Explanation“ column match the product code specified in DE7140 of the same PIA |
| [203] | Only codes from the „Code“ column of the code list of purposes of use (chapter 2) are permitted, provided that an „X“ is set in the same row both in the „Location/Tranche“ column and in the „Usable for market role/ÜNB“ column and the statements in the „Explanation“ column match the product code specified in DE7140 of the same PIA |
| [494] | The date stated here must be the point in time at which the document was created, or a point in time before that. |
| [521] | Note: Use of the ID of the market location |
| [552] | Note: Use of the ID of the grid location |
| [911] | Format: Possible values: 1 to n, starting at 1 for each message or segment group and ascending consecutively |
| [931] | Format: ZZZ = +00 |
| [950] | Format: market location ID |
| [951] | Format: Metering point identifier |
| [960] | Format: Grid location ID |
| [UB1] | ([931] ∧ [932] [490]) ⊻ ([931] ∧ [933] [491]) |
Example message
UNA:+.? '
UNB+UNOC:3+9900259000002:500+9904629000006:500+{{date}}:{{time}}+M0LI678W'
UNH+M0V0OCVO+ORDERS:D:09B:UN:1.4c'
BGM+Z68+M05AQP3S'
DTM+137:202610011100?+00:303'
DTM+203:202609292200?+00:303'
IMD++Z14+Z07'
RFF+Z13:17121'
NAD+MS+9900259000002::293'
NAD+MR+9904629000006::293'
NAD+DP'
LOC+172+44897654121'
LIN+1+Z54'
PIA+5+9991000000044:Z11+:V01:Z16+:V01:Z16+:V15:Z16'
CCI+Z39++Aal'
UNS+S'
UNT+15+M0V0OCVO'
UNZ+1+M0LI678W'[1 item
{6 fields
"data": {3 fields
"stammdaten": {3 fields
"ANFRAGE": [1 item
{6 fields
"AUFTRAG": [1 item
{4 fields
"positionsdaten": [1 item
{3 fields
"MARKTLOKATION": [1 item
{4 fields
"zaehlwerke": [1 item
{5 fields
"zaehlzeiten": {1 field
"transaktionsdaten": {8 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 NB and MSB.
| Role | Party involved | Process | Rulebook | Division | Step |
|---|---|---|---|---|---|
| NB | NB | Order placement for a configuration from the NB to MSB | GPKE part 3 | Electricity | Step 4 |
| MSB | MSB | Order placement for a configuration from the NB to MSB | GPKE part 3 | Electricity | Step 4 |
| MSB | WMSB | Order placement for a configuration from the NB to MSB | GPKE part 3 | Electricity | Step 4 |
Business classification
| Attribute | Value |
|---|---|
| Use case (AHB) | Order placement for change |
| AHB | ORDERS AHB |
| Transmission channel | AS4 |
| Process description / rulebook | Process step | Communication | Action |
|---|---|---|---|
| GPKE part 3 | Order placement for a configuration from NB to MSB | NB → MSB | Order placement for a configuration at the level of the directly affected location |
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 ORDERS 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 113 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 orders. 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.