ORDERS (46 / 44)
Check identifier 17130 — Order placement of a configuration
Check identifier 17130 · EDIFACT message type ORDERS · Format version 202604
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 | — |
| ansprechpartner | — | object | May | — |
| eMailAdresse 00300 | Email address | string | Must | — |
| nachname 00310 | Surname (family name) of the contact person | string | X | — |
| rufnummern [ ] | — | object[] | May | — |
| nummerntyp 00320 | 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 00330 | rufnummer | string | Must | — |
| beteiligterMarktpartner | — | object | May | — |
| 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 | 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.4b00060 | 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 | — |
| SG5.CTA | — | — | Must | — |
3139 IC00230 | Information contact | — | X | — |
341200240 | Contact | — | X | — |
| SG5.COM | — | — | Must | — |
314800250 | Communication address, identification | — | X | (([939] [147]) ∨ ([940] [148])) ∧ [567] |
3155 EM00260 | Electronic mail | — | X | [1P0..1] |
3155 FX00270 | Fax number | — | X | [1P0..1] |
3155 TE00280 | Telephone | — | X | [1P0..1] |
3155 AJ00290 | further telephone | — | X | [1P0..1] |
3155 AL00300 | Mobile phone | — | X | [1P0..1] |
| SG2.NAD | — | — | Must | — |
3035 MR00310 | Message recipient | — | X | — |
303900320 | MP-ID | — | X | [61] |
3055 900330 | GS1 | — | X | — |
3055 29300340 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 DP00350 | Supply address | — | X | — |
| SG2.LOC | — | — | Must | — |
3227 17200360 | Reporting point | — | X | — |
322500370 | Identifier | — | X | ([950] [521] ∧ ([118] ⊻ [120])) ⊻ ([951] [522] ∧ ([120] ⊻ [121])) ⊻ ([960] [552] ∧ ([118] ⊻ [119] ⊻ [120])) ⊻ ([961] [553] ∧ ([117] ⊻ [118] ⊻ [119])) |
| SG2.NAD | — | — | Must | — |
3035 DDM00380 | Grid operator | — | X | — |
303900390 | MP-ID | — | X | [61] |
3055 900400 | GS1 | — | X | — |
3055 29300410 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
| SG29.LIN | — | — | Must | — |
108200420 | Line item number | — | X | [903] |
1229 Z6400430 | Required product switching time definitions | — | X | — |
| SG29.PIA | — | — | Must | — |
4347 500440 | Product identification | — | X | — |
714000450 | Product code | — | X | [125] |
7143 Z1100460 | Product | — | X | — |
| SG30.CCI | — | — | Must | — |
7059 Z5200470 | Code of the switching time definition | — | X | — |
703700480 | Code of the switching time definition | — | X | — |
| SG29.LIN | — | — | Must | — |
108200490 | Line item number | — | X | [903] |
1229 Z6500500 | Required product power curve definitions | — | X | — |
| SG29.PIA | — | — | Must | — |
4347 500510 | Product identification | — | X | — |
714000520 | Product code | — | X | [126] |
7143 Z1100530 | Product | — | X | — |
| SG30.CCI | — | — | Must | — |
7059 Z5300540 | Code of the power curve definition | — | X | — |
703700550 | Code of the power curve definition | — | X | — |
| SG29.LIN | — | — | Must | — |
108200560 | Line item number | — | X | [903] |
1229 Z6600570 | Required product ad hoc control channel | — | X | — |
| SG29.PIA | — | — | Must | — |
4347 500580 | Product identification | — | X | — |
714000590 | Product code | — | X | [127] |
7143 Z1100600 | Product | — | X | — |
| SG29.LIN | — | — | Must | — |
108200610 | Line item number | — | X | [903] |
1229 Z6700620 | Required metering product for type 2 values from the backend | — | X | — |
| SG29.PIA | — | — | Must | — |
4347 500630 | Product identification | — | X | — |
714000640 | Product code | — | X | [128] |
7143 Z1100650 | Product | — | X | — |
| SG29.LIN | — | — | Must | — |
108200660 | Line item number | — | X | [903] |
1229 Z6800670 | Required product configuration permission for values according to type 2 from SMGW | — | X | — |
| SG29.PIA | — | — | Must | — |
4347 500680 | Product identification | — | X | — |
714000690 | Product code | — | X | [129] |
7143 Z1100700 | Product | — | X | — |
| SG29.FTX | — | — | Must | [564] |
4451 Z1700710 | Destination address URI | — | X | — |
444000720 | Destination address URI IPv4 for the provision of the values | — | X | [573] |
444000730 | Destination address URI IPv6 for the provision of the values | — | X | [574] |
| SG29.FTX | — | — | Must | [564] |
4451 Z2400740 | Issuer | — | X | — |
444000750 | Certificate issuer | — | X | [967] |
| SG29.FTX | — | — | Must | [564] |
4451 Z2300760 | Certificate user (subject) | — | X | — |
444000770 | Certificate user | — | X | [967] |
| SG30.CCI | — | — | Must | — |
7059 Z5400780 | Option to change the configuration in the SMGW | — | X | — |
7037 ZF700790 | independent modification option required | — | X | — |
7037 ZF800800 | independent modification option not required | — | X | — |
| SG30.CCI | — | — | Must | — |
7059 Z6000810 | Thresholds | — | X | — |
703700820 | Metering product item code | — | X | [141] |
703600830 | upper threshold | — | X | [906] ∧ [962] |
703600840 | lower threshold | — | X | [906] ∧ [962] |
| UNS | — | — | Must | — |
0081 S00850 | Separation of detail and summary section | — | X | — |
| UNT | — | — | Must | — |
007400860 | Number of segments in a message | — | X | — |
006200870 | Message reference number | — | X | — |
Conditions of this table
The free text of the 38 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. |
| [147] | if the code EM is present in DE3155 in the same COM |
| [148] | if the code TE / FX / AJ / AL is present in DE3155 in the same COM |
| [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. |
| [567] | Note: Only one piece of information may be transmitted in DE3148 |
| [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 |
| [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 |
| [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]) |
| [1P0..1] | Note: This is the standard package if no condition applies, e.g. in the COM segment. |
Example message
UNA:+.? '
UNB+UNOC:3+9903111000003:500+9904629000006:500+{{date}}:{{time}}+M0OU3NLP'
UNH+M08MHOSC+ORDERS:D:09B:UN:1.4b'
BGM+Z73+M0O1YVAK'
DTM+137:202408190803?+00:303'
RFF+Z41:AS1234'
RFF+Z13:17130'
NAD+MS+9903111000003::293'
CTA+IC+:A'
COM+a.l@cinuti.de:EM'
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+17+M08MHOSC'
UNZ+1+M0OU3NLP'[1 item
{6 fields
"businessKey": "<businessKey>",
"processDate": null,
"dataSource": "OUTBOUND",
"version": 1,
"edifactVersion": 202604,
"data": {3 fields
"stammdaten": {4 fields
"ANFRAGE": [1 item
{5 fields
"boTyp": "ANFRAGE",
"versionStruktur": "1",
"anfragekategorie": "BESTELLUNG_EINER_KONFIGURATION",
"lokationsId": "C4897654121",
"lokationsTyp": "STEUERBARE_RESSOURCE"
}
],
"AUFTRAG": [1 item
{3 fields
"boTyp": "AUFTRAG",
"versionStruktur": "1",
"positionsdaten": [1 item
{1 field
"positionsnummer": 1
}
]
}
],
"STEUERBARE_RESSOURCE": [1 item
{3 fields
"boTyp": "STEUERBARE_RESSOURCE",
"versionStruktur": "1",
"ressourcenId": "C4897654121"
}
],
"SCHALTZEITDEFINITION": [1 item
{3 fields
"boTyp": "SCHALTZEITDEFINITION",
"versionStruktur": "1",
"schaltzeiten": [1 item
{2 fields
"code": "AAL",
"konfigurationsprodukt": "9991000000713"
}
]
}
]
},
"transaktionsdaten": {10 fields
"datenaustauschreferenz": "M0OU3NLP",
"sparte": "STROM",
"pruefidentifikator": "17130",
"absender": {5 fields
"boTyp": "MARKTTEILNEHMER",
"versionStruktur": "1",
"rollencodenummer": "9903111000003",
"rollencodetyp": "BDEW",
"ansprechpartner": {4 fields
"boTyp": "ANSPRECHPARTNER",
"versionStruktur": "1",
"nachname": "A",
"eMailAdresse": "a.l@cinuti.de"
}
},
"empfaenger": {4 fields
"boTyp": "MARKTTEILNEHMER",
"versionStruktur": "1",
"rollencodenummer": "9904629000006",
"rollencodetyp": "BDEW"
},
"dokumentennummer": "M0O1YVAK",
"nachrichtendatum": "2024-08-19T08:03:00Z",
"nachrichtenreferenznummer": "M08MHOSC",
"vorgangsreferenznummer": "AS1234",
"beteiligterMarktpartner": {4 fields
"boTyp": "MARKTTEILNEHMER",
"versionStruktur": "1",
"rollencodenummer": "9903111000003",
"rollencodetyp": "BDEW"
}
},
"zusatzdaten": {}
}
}
]
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 119 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.