Check identifier 17001 — Order placement device takeover quotation
Check identifier 17001 · EDIFACT message type ORDERS · Format version 202610
Data structure
| Structure (BO4E) | Description | Format | 17001 | Condition |
|---|---|---|---|---|
| stammdaten * | — | object | Must | — |
| AUFTRAG [ ] * | — | object[] | Must | — |
| ausfuehrungsdatum * 00010 | The execution date describes at which point in time an order is to be executed. | string (date-time) | X | — |
| positionsdaten [ ] * | — | object[] | Must | — |
| apnKommunikationsdaten 00020 | APN of the communication details | string | X | — |
| positionsnummer * 00030 | Line item number | integer | Must | — |
| positionsnummerAngebot * 00040 | sequential item number of the quotation | string | X | — |
| wakeUpPort 00050 | Wake-up port of the communication unit | string | X | — |
| endpunktAdresse | — | object | May | — |
| gwaAdminService 00060 | Endpoint address GWA admin service | string | X | — |
| gwaManagement 00070 | Endpoint address GWA management | string | X | — |
| gwaNTP 00080 | Endpoint address GWA NTP (time server) | string | X | — |
| zertifikatsInformationen | — | object | May | — |
| commonNameZertifikat 00090 | Common Name (CN) of the certificate | string | X | — |
| seriennummerZertifikat 00100 | Serial number of the certificate | string | X | — |
| uriSubCA 00110 | URI of the sub-CA | string | X | — |
| transaktionsdaten * | — | object | Must | — |
| angebotsnummer * 00120 | Quotation number / RFF+AAG | string | X | — |
| dokumentennummer * 00130 | EDIFACT reference from the BGM segment / BGM | string | X | — |
| nachrichtendatum * 00140 | Creation date of the EDIFact / DTM+137 | string (date-time) | X | — |
| nachrichtenreferenznummer * 00150 | EDIFACT reference from the UNT segment / UTILMD UNT+21 | string | Must | — |
| pruefidentifikator * 00160 | Contains the check identifier from the EDIFact communication / RFF+Z13 | 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 | Must | — |
| eMailAdresse 00190 | Email address | string | Must | — |
| nachname * 00200 | Surname (family name) of the contact person | string | X | — |
| 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 | 17001 | 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 Z1000070 | Device takeover | — | 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 | [UB3] |
2379 30300140 | CCYYMMDDHHMMZZZ | — | X | — |
| SG1.RFF | — | — | Must | — |
1153 AAG00150 | Quotation number | — | X | — |
115400160 | Message number | — | X | [530] |
| SG1.RFF | — | — | Must | — |
1153 Z1300170 | Check identifier | — | X | — |
1154 1700100180 | Order placement for device takeover | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 MS00190 | Document-/message sender or sender | — | X | — |
303900200 | MP-ID | — | X | — |
3055 900210 | GS1 | — | X | — |
3055 29300220 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
3055 33200230 | DE, DVGW Service & Consult GmbH | — | X | — |
| SG5.CTA | — | — | Must | — |
3139 IC00240 | Information contact | — | X | — |
341200250 | Contact | — | X | [503] |
| SG5.COM | — | — | Must | — |
314800260 | Communication address, identification | — | X | (([939] [147]) ⊻ ([940] [148])) ∧ [567] |
3155 EM00270 | Electronic mail | — | X | [1P0..1] |
3155 FX00280 | Fax number | — | X | [1P0..1] |
3155 TE00290 | Telephone | — | X | [1P0..1] |
3155 AJ00300 | further telephone | — | X | [1P0..1] |
3155 AL00310 | Mobile phone | — | X | [1P0..1] |
| SG2.NAD | — | — | Must | — |
3035 MR00320 | Message recipient | — | X | — |
303900330 | MP-ID | — | X | — |
3055 900340 | GS1 | — | X | — |
3055 29300350 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
3055 33200360 | DE, DVGW Service & Consult GmbH | — | X | — |
| SG29.LIN | — | — | Must | — |
108200370 | Line item number | — | X | [911] |
| SG29.FTX | — | — | Should | [184] ∧ [593] |
4451 Z2900380 | Endpoint address (IP:port) | — | X | — |
444000390 | Endpoint address GWA management | — | X | — |
444000400 | Endpoint address GWA admin service | — | X | — |
444000410 | Endpoint address GWA-NTP | — | X | — |
| SG29.FTX | — | — | Must | [185] ∧ [593] |
4451 Z3000420 | Certificate information | — | X | — |
444000430 | URI of the sub-CA | — | X | — |
444000440 | Common Name of the certificate | — | X | — |
444000450 | Serial number of the certificate | — | X | — |
| SG29.FTX | — | — | Must | [185] ∧ [593] |
4451 Z3100460 | WakeUp Port | — | X | — |
444000470 | WakeUp Port | — | X | — |
| SG29.FTX | — | — | Must | [185] ∧ [593] |
4451 Z3200480 | APN communication details | — | X | — |
444000490 | APN communication details (provider-specific) | — | X | — |
| SG34.RFF | — | — | Must | — |
1153 Z0300500 | Line item number of the quotation | — | X | — |
115400510 | Line item number | — | X | [531] |
| UNS | — | — | Must | — |
0081 S00520 | Separation of detail and summary section | — | X | — |
| UNT | — | — | Must | — |
007400530 | Number of segments in a message | — | X | — |
006200540 | Message reference number | — | X | — |
Conditions of this table
The free text of the 16 conditions referenced by the rows above. All conditions of the message type are listed in the condition index ORDERS.
| Marker | Condition |
|---|---|
| [147] | If code EM is present in DE3155 in the same COM |
| [148] | If code TE / FX / AJ / AL is present in DE3155 in the same COM |
| [184] | If the item (SG34 RFF+Z03 DE1154) ordered within this SG29 LIN concerns the order placement of the device takeover quotation for a smart meter gateway. |
| [185] | If FTX+Z29 (endpoint address (IP:Port)) present |
| [494] | The date stated here must be the point in time at which the document was created, or a point in time before that. |
| [503] | Note: Indication of a technical contact person for the device takeover |
| [530] | Note: Value from BGM+310 DE1004 of the QUOTES with which the quotation was made. |
| [531] | Note: Value from LIN DE1082 of the QUOTES with which the quotation was made |
| [567] | Note: Only one piece of information may be transmitted in DE3148 |
| [593] | Note: Data of the MSBN |
| [911] | Format: Possible values: 1 to n, starting at 1 for each message or segment group and ascending consecutively |
| [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 |
| [UB3] | ([931] ∧ [932] [492] ∧ [490]) ⊻ ([931] ∧ [933] [492] ∧ [491]) ⊻ ([931] ∧ [934] [493] ∧ [490]) ⊻ ([931] ∧ [935] [493] ∧ [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+9904733000009:500+9905257000004:500+{{date}}:{{time}}+LZXUG7BT'
UNH+LZY3DA6G+ORDERS:D:09B:UN:1.4c'
BGM+Z10+LZXZ14PB'
DTM+137:202610011100?+00:303'
DTM+203:202610272200?+00:303'
RFF+AAG:1234567890'
RFF+Z13:17001'
NAD+MS+9904733000009::293'
CTA+IC+:Andre Laue'
COM+marktpartner @stromnetz-hamburg.de:EM'
NAD+MR+9905257000004::293'
LIN+1'
FTX+Z29+++X:X:X'
FTX+Z30+++X:X:X'
FTX+Z31+++X'
FTX+Z32+++X'
RFF+Z03:12'
UNS+S'
UNT+18+LZY3DA6G'
UNZ+1+LZXUG7BT'[1 item
{6 fields
"data": {3 fields
"stammdaten": {2 fields
"ANFRAGE": [1 item
{3 fields
"AUFTRAG": [1 item
{4 fields
"positionsdaten": [1 item
{6 fields
"endpunktAdresse": {3 fields
"zertifikatsInformationen": {3 fields
"transaktionsdaten": {9 fields
"absender": {5 fields
"ansprechpartner": {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 MSB.
| Role | Party involved | Process | Rulebook | Division | Step |
|---|---|---|---|---|---|
| MSB | MSBA | Device takeover | AWH WiM gas 2.0 | Gas | Step 3 |
| MSB | MSBA | Device takeover | WiM electricity part 1 | Electricity | Step 3 |
| MSB | MSBN | Device takeover | AWH WiM gas 2.0 | Gas | Step 3 |
| MSB | MSBN | Device takeover | WiM electricity part 1 | Electricity | Step 3 |
Business classification
| Attribute | Value |
|---|---|
| Use case (AHB) | Order placement for device takeover offer |
| AHB | ORDERS AHB |
| Transmission channel | AS4 |
This check identifier is used in 3 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 |
|---|---|---|---|
| WiM electricity part 1 | Device takeover | MSB (corresponds to MSBN on the object metering location) → MSB (corresponds to MSBA on the object metering location) | Order placement |
| AWH WiM gas 2.0 | Device takeover | MSBN → MSBA | Order placement |
| WiM gas | Ch. B 5.2.3 No. 3 | MSBN → MSBA | Order placement |
Individual entries from format version 202604
The check identifiers table of format version 202610 does not carry this entry: process step. It comes from version 202604. Version 202604 also carries this check identifier in contexts that the table of version 202610 does not know; they are included in the list above. 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 202610.
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”.
Which messages respond to this
| Role | Check identifier | Use case | Message type | Origin of supply |
|---|---|---|---|---|
| Response | 19001 | Confirmation of order placement | ORDRSP | from the step sequence |
| Response | 19002 | Rejection order placement | ORDRSP | from the step sequence |
This column is the inverse of the assignment on the response pages — not the next step of a list. The process source says of its own steps that they are »possible messages, not a sequence«.
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 72 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.