Check identifier 17101 — Request master data market location (Gas)
Check identifier 17101 · EDIFACT message type ORDERS · Format version 202610
Data structure
| Structure (BO4E) | Description | Format | 17101 | Condition |
|---|---|---|---|---|
| stammdaten | — | object | May | — |
| ANFRAGE [ ] | — | object[] | May | — |
| lokationsId 00010 | Which market or metering location this request applies to. | string | X | — |
| AUFTRAG [ ] | — | object[] | May | — |
| positionsdaten [ ] | — | object[] | May | — |
| positionsnummer 00020 | Line item number | integer | Must | [16] ∨ [17] |
| allgemeineInformationen | — | object | May | — |
| info1 00030 | General info 1 | string | X | — |
| info2 00040 | General info 2 | string | X | — |
| info3 00050 | General info 3 | string | X | — |
| info4 00060 | General info 4 | string | X | — |
| info5 00070 | General info 5 | string | X | — |
| ENERGIELIEFERVERTRAG [ ] | — | object[] | May | — |
| vertragspartner2 [ ] | — | object[] | May | — |
| anrede 00080 | The form of address for the GePa, e.g. Mr. | string | X | — |
| geschaeftspartnerrolle 00090 | Role held by the business partner (e.g. prospect, customer). | array | X | — |
| gewerbekennzeichnung 00100 | Indicates whether this is a business/company (gewerbeKennzeichnung = true) or a private individual. (gewerbeKennzeichnung = false) | boolean | X | — |
| name1 00110 | First part of the name. This can hold the company name or, for private individuals, the surname, for example. Examples: Yellow Strom GmbH or Hagen | string | X | — |
| name2 00120 | Second part of the name. Here an extension to the company name or for private individuals, for example, the first name can be entered. Examples: Bereich Süd or Nina | string | X | — |
| name3 00130 | Third part of the name. Further additions to the company name or , for private individuals, additions to the name can be represented here. Examples: and Africa or singer | string | X | — |
| name4 00140 | name4 | string | X | — |
| externeReferenzen [ ] | — | object[] | May | — |
| exRefName 00150 | Name of the external reference (e.g. "hochfrequenz integration services") | string | X | — |
Kundennummer beim Lieferanten | — | — | X | — |
Kundennummer beim Altlieferanten | — | — | X | — |
| exRefWert 00160 | Value of the external reference (e.g. "123456"; "4711") | string | X | — |
| MARKTLOKATION [ ] | — | object[] | May | — |
| lokationsadresse | — | object | May | — |
| hausnummer 00170 | House number and supplement | string | X | — |
| landescode 00180 | Country code | Enum Landescode | X | — |
AC | — | — | X | — |
AD | — | — | X | — |
AE | — | — | X | — |
AF | — | — | X | — |
AG | — | — | X | — |
AI | — | — | X | — |
AL | — | — | X | — |
AM | — | — | X | — |
AN | — | — | X | — |
AO | — | — | X | — |
AQ | — | — | X | — |
AR | — | — | X | — |
AS | — | — | X | — |
AT | — | — | X | — |
AU | — | — | X | — |
AW | — | — | X | — |
AX | — | — | X | — |
AZ | — | — | X | — |
BA | — | — | X | — |
BB | — | — | X | — |
BD | — | — | X | — |
BE | — | — | X | — |
BF | — | — | X | — |
BG | — | — | X | — |
BH | — | — | X | — |
BI | — | — | X | — |
BJ | — | — | X | — |
BL | — | — | X | — |
BM | — | — | X | — |
BN | — | — | X | — |
BO | — | — | X | — |
BQ | — | — | X | — |
BR | — | — | X | — |
BS | — | — | X | — |
BT | — | — | X | — |
BU | — | — | X | — |
BV | — | — | X | — |
BW | — | — | X | — |
BY | — | — | X | — |
BZ | — | — | X | — |
CA | — | — | X | — |
CC | — | — | X | — |
CD | — | — | X | — |
CF | — | — | X | — |
CG | — | — | X | — |
CH | — | — | X | — |
CI | — | — | X | — |
CK | — | — | X | — |
CL | — | — | X | — |
CM | — | — | X | — |
CN | — | — | X | — |
CO | — | — | X | — |
CP | — | — | X | — |
CR | — | — | X | — |
CS | — | — | X | — |
CU | — | — | X | — |
CV | — | — | X | — |
CW | — | — | X | — |
CX | — | — | X | — |
CY | — | — | X | — |
CZ | — | — | X | — |
DE | — | — | X | — |
DG | — | — | X | — |
DJ | — | — | X | — |
DK | — | — | X | — |
DM | — | — | X | — |
DO | — | — | X | — |
DZ | — | — | X | — |
EA | — | — | X | — |
EC | — | — | X | — |
EE | — | — | X | — |
EG | — | — | X | — |
EH | — | — | X | — |
ER | — | — | X | — |
ES | — | — | X | — |
ET | — | — | X | — |
EU | — | — | X | — |
FI | — | — | X | — |
FJ | — | — | X | — |
FK | — | — | X | — |
FM | — | — | X | — |
FO | — | — | X | — |
FR | — | — | X | — |
FX | — | — | X | — |
GA | — | — | X | — |
GB | — | — | X | — |
GD | — | — | X | — |
GE | — | — | X | — |
GF | — | — | X | — |
GG | — | — | X | — |
GH | — | — | X | — |
GI | — | — | X | — |
GL | — | — | X | — |
GM | — | — | X | — |
GN | — | — | X | — |
GP | — | — | X | — |
GQ | — | — | X | — |
GR | — | — | X | — |
GS | — | — | X | — |
GT | — | — | X | — |
GU | — | — | X | — |
GW | — | — | X | — |
GY | — | — | X | — |
HK | — | — | X | — |
HM | — | — | X | — |
HN | — | — | X | — |
HR | — | — | X | — |
HT | — | — | X | — |
HU | — | — | X | — |
IC | — | — | X | — |
ID | — | — | X | — |
IE | — | — | X | — |
IL | — | — | X | — |
IM | — | — | X | — |
IN | — | — | X | — |
IO | — | — | X | — |
IQ | — | — | X | — |
IR | — | — | X | — |
IS | — | — | X | — |
IT | — | — | X | — |
JE | — | — | X | — |
JM | — | — | X | — |
JO | — | — | X | — |
JP | — | — | X | — |
KE | — | — | X | — |
KG | — | — | X | — |
KH | — | — | X | — |
KI | — | — | X | — |
KM | — | — | X | — |
KN | — | — | X | — |
KP | — | — | X | — |
KR | — | — | X | — |
KW | — | — | X | — |
KY | — | — | X | — |
KZ | — | — | X | — |
LA | — | — | X | — |
LB | — | — | X | — |
LC | — | — | X | — |
LI | — | — | X | — |
LK | — | — | X | — |
LR | — | — | X | — |
LS | — | — | X | — |
LT | — | — | X | — |
LU | — | — | X | — |
LV | — | — | X | — |
LY | — | — | X | — |
MA | — | — | X | — |
MC | — | — | X | — |
MD | — | — | X | — |
ME | — | — | X | — |
MF | — | — | X | — |
MG | — | — | X | — |
MH | — | — | X | — |
MK | — | — | X | — |
ML | — | — | X | — |
MM | — | — | X | — |
MN | — | — | X | — |
MO | — | — | X | — |
MP | — | — | X | — |
MQ | — | — | X | — |
MR | — | — | X | — |
MS | — | — | X | — |
MT | — | — | X | — |
MU | — | — | X | — |
MV | — | — | X | — |
MW | — | — | X | — |
MX | — | — | X | — |
MY | — | — | X | — |
MZ | — | — | X | — |
NA | — | — | X | — |
NC | — | — | X | — |
NE | — | — | X | — |
NF | — | — | X | — |
NG | — | — | X | — |
NI | — | — | X | — |
NL | — | — | X | — |
NO | — | — | X | — |
NP | — | — | X | — |
NR | — | — | X | — |
NT | — | — | X | — |
NU | — | — | X | — |
NZ | — | — | X | — |
OM | — | — | X | — |
PA | — | — | X | — |
PE | — | — | X | — |
PF | — | — | X | — |
PG | — | — | X | — |
PH | — | — | X | — |
PK | — | — | X | — |
PL | — | — | X | — |
PM | — | — | X | — |
PN | — | — | X | — |
PR | — | — | X | — |
PS | — | — | X | — |
PT | — | — | X | — |
PW | — | — | X | — |
PY | — | — | X | — |
QA | — | — | X | — |
RE | — | — | X | — |
RO | — | — | X | — |
RS | — | — | X | — |
RU | — | — | X | — |
RW | — | — | X | — |
SA | — | — | X | — |
SB | — | — | X | — |
SC | — | — | X | — |
SD | — | — | X | — |
SE | — | — | X | — |
SF | — | — | X | — |
SG | — | — | X | — |
SH | — | — | X | — |
SI | — | — | X | — |
SJ | — | — | X | — |
SK | — | — | X | — |
SL | — | — | X | — |
SM | — | — | X | — |
SN | — | — | X | — |
SO | — | — | X | — |
SR | — | — | X | — |
SS | — | — | X | — |
ST | — | — | X | — |
SU | — | — | X | — |
SV | — | — | X | — |
SX | — | — | X | — |
SY | — | — | X | — |
SZ | — | — | X | — |
TA | — | — | X | — |
TC | — | — | X | — |
TD | — | — | X | — |
TF | — | — | X | — |
TG | — | — | X | — |
TJ | — | — | X | — |
TK | — | — | X | — |
TL | — | — | X | — |
TM | — | — | X | — |
TN | — | — | X | — |
TO | — | — | X | — |
TP | — | — | X | — |
TR | — | — | X | — |
TT | — | — | X | — |
TV | — | — | X | — |
TW | — | — | X | — |
TZ | — | — | X | — |
UA | — | — | X | — |
UG | — | — | X | — |
UK | — | — | X | — |
UM | — | — | X | — |
US | — | — | X | — |
UY | — | — | X | — |
UZ | — | — | X | — |
VA | — | — | X | — |
VC | — | — | X | — |
VE | — | — | X | — |
VG | — | — | X | — |
VI | — | — | X | — |
VN | — | — | X | — |
VU | — | — | X | — |
WF | — | — | X | — |
WS | — | — | X | — |
XK | — | — | X | — |
YE | — | — | X | — |
YT | — | — | X | — |
YU | — | — | X | — |
ZA | — | — | X | — |
ZM | — | — | X | — |
ZR | — | — | X | — |
ZW | — | — | X | — |
| ort 00190 | City | string | X | — |
| ortsteil 00200 | District | string | X | — |
| postfach 00210 | PO box | string | X | — |
| postleitzahl 00220 | Postal code | string | X | — |
| strasse 00230 | Street | string | X | — |
| zusatzInformation | — | object | May | — |
| zusatz1 00240 | Address supplement 1 | string | X | — |
| zusatz2 00250 | Address supplement 2 | string | X | — |
| zusatz3 00260 | Address supplement 3 | string | X | — |
| zusatz4 00270 | Address supplement 4 | string | X | — |
| zusatz5 00280 | Address supplement 5 | string | X | — |
| ZAEHLER [ ] | — | object[] | May | — |
| geraete [ ] | — | object[] | May | — |
| geraetenummer 00290 | The number printed on the device, which is assigned by the MSB. | string | X | — |
| transaktionsdaten * | — | object | Must | — |
| dokumentennummer * 00300 | EDIFACT reference from the BGM segment / BGM | string | X | — |
| nachrichtendatum * 00310 | Creation date of the EDIFact / DTM+137 | string (date-time) | X | — |
| nachrichtenreferenznummer * 00320 | EDIFACT reference from the UNT segment / UTILMD UNT+21 | string | Must | — |
| pruefidentifikator * 00330 | Contains the check identifier from the EDIFact communication / RFF+Z13 | string | X | — |
| absender * | — | object | Must | — |
| 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 | 17101 | 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 Z6100070 | Master data of the market location | — | 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 | — |
| SG1.RFF | — | — | Must | — |
1153 Z1300120 | Check identifier | — | X | — |
1154 1710100130 | Request for master data of market location | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 MS00140 | Document-/message sender or sender | — | X | — |
303900150 | MP-ID | — | X | [60] |
3055 900160 | GS1 | — | X | — |
3055 33200170 | DE, DVGW Service & Consult GmbH | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 MR00180 | Message recipient | — | X | — |
303900190 | MP-ID | — | X | [60] |
3055 900200 | GS1 | — | X | — |
3055 33200210 | DE, DVGW Service & Consult GmbH | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 DP00220 | Supply address | — | X | — |
| SG2.LOC | — | — | Must | — |
3227 17200230 | Reporting point | — | X | — |
322500240 | Identifier | — | X | [950] [521] |
| SG2.NAD | — | — | Must | — |
3035 Z2300250 | Market location address | — | X | — |
312400260 | Additional information for identification | — | — | — |
304200270 | Street and house number or PO box | — | — | S [9] M [57] |
316400280 | City | — | X | — |
325100290 | Postal code, code | — | X | — |
320700300 | Country name, code | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 Z0900310 | Customer of the LF | — | X | — |
303600320 | Name | — | X | — |
3045 Z0100330 | Structure of person names | — | X | — |
3045 Z0200340 | Structure of the company name | — | X | — |
| SG3.RFF | — | — | Must | — |
1153 AVC00350 | Customer number at the supplier | — | X | — |
115400360 | Customer number | — | X | — |
| SG29.LIN | — | — | Must | [16] ∨ [17] |
108200370 | Line item number | — | X | [903] |
| SG29.FTX | — | — | May | — |
4451 ACB00380 | Additional information (for general notes) | — | X | — |
444000390 | Free text | — | X | — |
| SG34.RFF | — | — | Must | — |
1153 Z0900400 | Device number | — | X | — |
115400410 | Device number | — | X | — |
| UNS | — | — | Must | — |
0081 S00420 | Separation of detail and summary section | — | X | — |
| UNT | — | — | Must | — |
007400430 | Number of segments in a message | — | X | — |
006200440 | Message reference number | — | X | — |
Conditions of this table
The free text of the 10 conditions referenced by the rows above. All conditions of the message type are listed in the condition index ORDERS.
| Marker | Condition |
|---|---|
| [9] | If known |
| [16] | If a subordinate SG is present |
| [17] | If a segment is present within the SG |
| [57] | If NAD DE3124 is not present in the same SG2 |
| [60] | MP-ID only from division gas |
| [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 |
| [903] | Format: Possible value: 1 |
| [931] | Format: ZZZ = +00 |
| [950] | Format: market location ID |
Example message
UNA:+.? '
UNB+UNOC:3+9903111000003:502+9900259000002:502+{{date}}:{{time}}+M0Q6IGPA'
UNH+M0B2T74V+ORDERS:D:09B:UN:1.4c'
BGM+Z61+M00T0WEQ'
DTM+137:202610011100?+00:303'
RFF+Z13:17101'
NAD+MS+9903111000003::332'
NAD+MR+9900259000002::332'
NAD+DP'
LOC+172+44897654121'
UNS+S'
UNT+10+M0B2T74V'
UNZ+1+M0Q6IGPA'[1 item
{6 fields
"data": {3 fields
"stammdaten": {1 field
"ANFRAGE": [1 item
{5 fields
"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 LF and NB.
| Role | Party involved | Process | Rulebook | Division | Step |
|---|---|---|---|---|---|
| LF | LF | Business data request from the LF to NB | GeLi Gas 2.0 | Gas | Step 1 |
| NB | NB | Business data request from the LF to NB | GeLi Gas 2.0 | Gas | Step 1 |
Business classification
| Attribute | Value |
|---|---|
| Use case (AHB) | Request for master data of market location (gas) |
| AHB | ORDERS AHB |
| Transmission channel | AS4 |
This check identifier is used in 2 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 |
|---|---|---|---|
| GeLi Gas 2.0 | Business data request from LF to NB | LF → NB | Business data request |
| GeLi Gas | Ch. D 3.2 No. 1 | LF → NB | Business data request |
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 | 19101 | Rejection of the request for master data | ORDRSP | explicit |
| Response | 44035 | Response to the business data request | UTILMD_GAS | explicit |
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 60 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.