Check identifier 17130 — Order placement of a configuration
Check identifier 17130 · EDIFACT message type ORDERS · Format version 202610
Data structure
| Structure (BO4E) | Description | Format | 17130 | Condition |
|---|---|---|---|---|
| stammdaten * | — | object | Must | — |
| ANFRAGE [ ] * | — | object[] | Must | — |
| lokationsId * 00010 | Which market or metering location this request applies to. | string | X | — |
| AUFTRAG [ ] | — | object[] | May | — |
| ausfuehrungsdatum 00020 | The execution date describes at which point in time an order is to be executed. | string (date-time) | X | — |
| WERTE_NACH_TYP2 [ ] | — | object[] | May | — |
| aenderungsmoeglichkeitKonfiguration 00030 | AenderungsmoeglichkeitKonfiguration | Enum AenderungsmoeglichkeitKonfiguration | X | — |
ERFORDERLICH | — | — | X | — |
NICHT_ERFORDERLICH | — | — | X | — |
| messprodukt 00040 | messprodukt | string | X | — |
| aussteller | — | object | May | — |
| aussteller1 00050 | aussteller1 | string | X | — |
| aussteller2 00060 | aussteller2 | string | X | — |
| aussteller3 00070 | aussteller3 | string | X | — |
| aussteller4 00080 | aussteller4 | string | X | — |
| aussteller5 00090 | aussteller5 | string | X | — |
| schwellwerte [ ] | — | object[] | May | — |
| konfigurationsprodukt 00100 | konfigurationsprodukt | string | X | — |
| obererSchwellwert 00110 | obererSchwellwert | number (float) | X | — |
| untererSchwellwert 00120 | untererSchwellwert | number (float) | X | — |
| zertifikatsNutzer | — | object | May | — |
| zertifikatsNutzer1 00130 | zertifikatsNutzer1 | string | X | — |
| zertifikatsNutzer2 00140 | zertifikatsNutzer2 | string | X | — |
| zertifikatsNutzer3 00150 | zertifikatsNutzer3 | string | X | — |
| zertifikatsNutzer4 00160 | zertifikatsNutzer4 | string | X | — |
| zertifikatsNutzer5 00170 | zertifikatsNutzer5 | string | X | — |
| zieladresse | — | object | May | — |
| zieladresse1 00180 | zieladresse1 | string | X | — |
| zieladresse2 00190 | zieladresse2 | string | X | — |
| zieladresse3 00200 | zieladresse3 | string | X | — |
| zieladresse4 00210 | zieladresse4 | string | X | — |
| zieladresse5 00220 | zieladresse5 | 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 | — |
| vorgangsreferenznummer 00270 | Reference number of the transaction of the registration according to WiM / ORDERS RFF+Z41 / IFTSTA RFF+ACW | string | X | — |
| absender * | — | object | Must | — |
| rollencodenummer * 00280 | Specifies the code value of the market role. | string | X | — |
| rollencodetyp * 00290 | Indicates the type of the code. | Enum Rollencodetyp | X | — |
BDEW | — | — | X | — |
GS1 | — | — | X | — |
GLN | — | — | X | — |
DVGW | — | — | X | — |
| beteiligterMarktpartner | — | object | May | — |
| rollencodenummer 00300 | Specifies the code value of the market role. | string | X | — |
| rollencodetyp 00310 | Indicates the type of the code. | Enum Rollencodetyp | X | — |
BDEW | — | — | X | — |
GS1 | — | — | X | — |
GLN | — | — | X | — |
DVGW | — | — | X | — |
| empfaenger * | — | object | Must | — |
| rollencodenummer * 00320 | Specifies the code value of the market role. | string | X | — |
| rollencodetyp * 00330 | Indicates the type of the code. | Enum Rollencodetyp | X | — |
BDEW | — | — | X | — |
GS1 | — | — | X | — |
GLN | — | — | X | — |
DVGW | — | — | X | — |
Application handbook (AHB)
| Structure (EDIFACT) | Description | Format | 17130 | 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 Z7300070 | Order placement for a configuration | — | 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 | [122] |
2005 20300120 | Execution date/time | — | X | — |
238000130 | Date or time or time span, value | — | X | [UB1] |
2379 30300140 | CCYYMMDDHHMMZZZ | — | X | — |
| SG1.RFF | — | — | Must | — |
1153 Z4100150 | Reference number of the transaction of the registration according to WiM | — | X | — |
115400160 | Reference, identification | — | X | [555] |
| SG1.RFF | — | — | Must | — |
1153 Z1300170 | Check identifier | — | X | — |
1154 1713000180 | Order placement for change of a configuration | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 MS00190 | Document-/message sender or sender | — | X | — |
303900200 | MP-ID | — | X | [61] |
3055 900210 | GS1 | — | X | — |
3055 29300220 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 MR00230 | Message recipient | — | X | — |
303900240 | MP-ID | — | X | [61] |
3055 900250 | GS1 | — | X | — |
3055 29300260 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 DP00270 | Supply address | — | X | — |
| SG2.LOC | — | — | Must | — |
3227 17200280 | Reporting point | — | X | — |
322500290 | Identifier | — | X | ([950] [521] ∧ ([118] ⊻ [120])) ⊻ ([951] [522] ∧ ([120] ⊻ [121])) ⊻ ([960] [552] ∧ ([118] ⊻ [119] ⊻ [120])) ⊻ ([961] [553] ∧ ([117] ⊻ [118] ⊻ [119])) |
| SG2.NAD | — | — | Must | — |
3035 DDM00300 | Grid operator | — | X | — |
303900310 | MP-ID | — | X | [61] |
3055 900320 | GS1 | — | X | — |
3055 29300330 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
| SG29.LIN | — | — | Must | — |
108200340 | Line item number | — | X | [903] |
1229 Z6400350 | Required product switching time definitions | — | X | — |
| SG29.PIA | — | — | Must | — |
4347 500360 | Product identification | — | X | — |
714000370 | Product code | — | X | [125] |
7143 Z1100380 | Product | — | X | — |
| SG30.CCI | — | — | Must | — |
7059 Z5200390 | Code of the switching time definition | — | X | — |
703700400 | Code of the switching time definition | — | X | — |
| SG29.LIN | — | — | Must | — |
108200410 | Line item number | — | X | [903] |
1229 Z6500420 | Required product power curve definitions | — | X | — |
| SG29.PIA | — | — | Must | — |
4347 500430 | Product identification | — | X | — |
714000440 | Product code | — | X | [126] |
7143 Z1100450 | Product | — | X | — |
| SG30.CCI | — | — | Must | — |
7059 Z5300460 | Code of the power curve definition | — | X | — |
703700470 | Code of the power curve definition | — | X | — |
| SG29.LIN | — | — | Must | — |
108200480 | Line item number | — | X | [903] |
1229 Z6600490 | Required product ad hoc control channel | — | X | — |
| SG29.PIA | — | — | Must | — |
4347 500500 | Product identification | — | X | — |
714000510 | Product code | — | X | [127] |
7143 Z1100520 | Product | — | X | — |
| SG29.LIN | — | — | Must | — |
108200530 | Line item number | — | X | [903] |
1229 Z6700540 | Required metering product for type 2 values from the backend | — | X | — |
| SG29.PIA | — | — | Must | — |
4347 500550 | Product identification | — | X | — |
714000560 | Product code | — | X | [128] |
7143 Z1100570 | Product | — | X | — |
| SG29.LIN | — | — | Must | — |
108200580 | Line item number | — | X | [903] |
1229 Z6800590 | Required product configuration permission for values according to type 2 from SMGW | — | X | — |
| SG29.PIA | — | — | Must | — |
4347 500600 | Product identification | — | X | — |
714000610 | Product code | — | X | [129] |
7143 Z1100620 | Product | — | X | — |
| SG29.FTX | — | — | Must | [564] |
4451 Z1700630 | Destination address URI | — | X | — |
444000640 | Destination address URI IPv4 for the provision of the values | — | X | [573] |
444000650 | Destination address URI IPv6 for the provision of the values | — | X | [574] |
| SG29.FTX | — | — | Must | [564] |
4451 Z2400660 | Issuer | — | X | — |
444000670 | Certificate issuer | — | X | [967] |
| SG29.FTX | — | — | Must | [564] |
4451 Z2300680 | Certificate user (subject) | — | X | — |
444000690 | Certificate user | — | X | [967] |
| SG30.CCI | — | — | Must | — |
7059 Z5400700 | Option to change the configuration in the SMGW | — | X | — |
7037 ZF700710 | independent modification option required | — | X | — |
7037 ZF800720 | independent modification option not required | — | X | — |
| SG30.CCI | — | — | Must | — |
7059 Z6000730 | Thresholds | — | X | — |
703700740 | Metering product item code | — | X | [141] |
703600750 | upper threshold | — | X | [906] ∧ [962] |
703600760 | lower threshold | — | X | [906] ∧ [962] |
| UNS | — | — | Must | — |
0081 S00770 | Separation of detail and summary section | — | X | — |
| UNT | — | — | Must | — |
007400780 | Number of segments in a message | — | X | — |
006200790 | Message reference number | — | X | — |
Conditions of this table
The free text of the 32 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 |
| [117] | If SG29 LIN++Z64 (Required product switching time definitions) is present |
| [118] | If SG29 LIN++Z65 (Required product power curve definitions) is present |
| [119] | If SG29 LIN++Z66 (Required product ad hoc control channel) is present |
| [120] | If SG29 LIN++Z67 (Required metering product for values of type 2 from backend) is present |
| [121] | If SG29 LIN++Z68 (Required product configuration permission for values of type 2 from SMGW) is present |
| [122] | If SG1 RFF+Z41 (reference number of the registration transaction pursuant to WiM) not present |
| [125] | Only the configuration products are permitted that are contained in chapter 4.1 „Configuration products switching time definition“ of the code list of configurations. |
| [126] | Only the configuration products are permitted that are contained in chapter 4.2 „Configuration products power curve definition“ of the code list of configurations. |
| [127] | Only the configuration products are permitted that are contained in chapter 4.3 „Configuration products ad-hoc control channel“ of the code list of configurations. |
| [128] | Only the metering products are permitted that are contained in chapter 4.5 „Metering products for values according to type 2 from the backend for LF and NB“ of the code list of configurations. |
| [129] | Only the metering products are permitted that are contained in chapter 4.4 „Metering products with configuration permission for values according to type 2 from SMGW“ of the code list of configurations. |
| [141] | Only the metering product position codes are permitted that are contained in chapter 4.7 „Type of values for metering products according to type 2“ of the code list of configurations. |
| [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 |
| [522] | Note: Use of the ID of the metering location |
| [552] | Note: Use of the ID of the grid location |
| [553] | Note: Use of the ID of the controllable resource |
| [555] | Note: Transaction number from SG4 IDE+24 DE7402 of the UTILMD with BGM+E01 with which the registration of the MSB switch was carried out. |
| [564] | Note: For receiving the values according to type 2 from the SMGW. |
| [573] | Note: An URI IPv4 must be specified for the provision of the values. |
| [574] | Note: An URI IPv6 must be specified for the provision of the values. |
| [903] | Format: Possible value: 1 |
| [906] | Format: max. 3 decimal places |
| [931] | Format: ZZZ = +00 |
| [950] | Format: market location ID |
| [951] | Format: Metering point identifier |
| [960] | Format: Grid location ID |
| [961] | Format: SR-ID |
| [962] | Format: max. 6 digits before the decimal point |
| [967] | Format: Certificate body in accordance with X509.1, BSI TR-03109-4 |
| [UB1] | ([931] ∧ [932] [490]) ⊻ ([931] ∧ [933] [491]) |
Example message
UNA:+.? '
UNB+UNOC:3+9903111000003:500+9904629000006:500+{{date}}:{{time}}+M0OU3NLP'
UNH+M08MHOSC+ORDERS:D:09B:UN:1.4c'
BGM+Z73+M0O1YVAK'
DTM+137:202610011100?+00:303'
RFF+Z41:AS1234'
RFF+Z13:17130'
NAD+MS+9903111000003::293'
NAD+MR+9904629000006::293'
NAD+DP'
LOC+172+C4897654121'
NAD+DDM+9903111000003::293'
LIN+1+Z64'
PIA+5+9991000000713:Z11'
CCI+Z52++AAL'
UNS+S'
UNT+15+M08MHOSC'
UNZ+1+M0OU3NLP'[1 item
{6 fields
"data": {3 fields
"stammdaten": {4 fields
"ANFRAGE": [1 item
{5 fields
"AUFTRAG": [1 item
{3 fields
"positionsdaten": [1 item
{1 field
"STEUERBARE_RESSOURCE": [1 item
{3 fields
"SCHALTZEITDEFINITION": [1 item
{3 fields
"schaltzeiten": [1 item
{2 fields
"transaktionsdaten": {10 fields
"absender": {5 fields
"empfaenger": {4 fields
"beteiligterMarktpartner": {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 and MSB.
Business classification
| Attribute | Value |
|---|---|
| Use case (AHB) | Order placement for a configuration |
| AHB | ORDERS AHB |
| Transmission channel | AS4 |
This check identifier is used in 4 contexts
Regulatory determination and communication direction depend on the process in which the message is sent. A single entry would be misleading — all placements are therefore listed here.
| 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 |
| GPKE part 3 | Order placement for a configuration from NB to MSB | MSB → further MSB | Order placement for a configuration for further affected locations |
| GPKE part 3 | Order placement for a configuration from LF to MSB | LF → MSB | Order placement for a configuration at the level of the directly affected location |
| GPKE part 3 | Order placement for a configuration from LF to MSB | MSB → further MSB | Order placement for a configuration for further affected locations |
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 109 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.