Check identifier 17101 — Request master data market location (Gas)
Check identifier 17101 · EDIFACT message type ORDERS · Format version 202604
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 | — |
| ansprechpartner | — | object | May | — |
| eMailAdresse 00360 | Email address | string | Must | — |
| nachname 00370 | Surname (family name) of the contact person | string | X | — |
| rufnummern [ ] | — | object[] | May | — |
| nummerntyp 00380 | 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 00390 | rufnummer | string | Must | — |
| empfaenger * | — | object | Must | — |
| rollencodenummer * 00400 | Specifies the code value of the market role. | string | X | — |
| rollencodetyp * 00410 | 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.4b00060 | 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 | — |
| SG5.CTA | — | — | Must | — |
3139 IC00180 | Information contact | — | X | — |
341200190 | Contact | — | X | — |
| SG5.COM | — | — | Must | — |
314800200 | Communication address, identification | — | X | (([939] [147]) ∨ ([940] [148])) ∧ [567] |
3155 EM00210 | Electronic mail | — | X | [1P0..1] |
3155 FX00220 | Fax number | — | X | [1P0..1] |
3155 TE00230 | Telephone | — | X | [1P0..1] |
3155 AJ00240 | further telephone | — | X | [1P0..1] |
3155 AL00250 | Mobile phone | — | X | [1P0..1] |
| SG2.NAD | — | — | Must | — |
3035 MR00260 | Message recipient | — | X | — |
303900270 | MP-ID | — | X | [60] |
3055 900280 | GS1 | — | X | — |
3055 33200290 | DE, DVGW Service & Consult GmbH | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 DP00300 | Supply address | — | X | — |
| SG2.LOC | — | — | Must | — |
3227 17200310 | Reporting point | — | X | — |
322500320 | Identifier | — | X | [950] [521] |
| SG2.NAD | — | — | Must | — |
3035 Z2300330 | Market location address | — | X | — |
312400340 | Additional information for identification | — | — | — |
304200350 | Street and house number or PO box | — | — | S [9] M [57] |
316400360 | City | — | X | — |
325100370 | Postal code, code | — | X | — |
320700380 | Country name, code | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 Z0900390 | Customer of the LF | — | X | — |
303600400 | Name | — | X | — |
3045 Z0100410 | Structure of person names | — | X | — |
3045 Z0200420 | Structure of the company name | — | X | — |
| SG3.RFF | — | — | Must | — |
1153 AVC00430 | Customer number at the supplier | — | X | — |
115400440 | Customer number | — | X | — |
| SG29.LIN | — | — | Must | [16] ∨ [17] |
108200450 | Line item number | — | X | [903] |
| SG29.FTX | — | — | May | — |
4451 ACB00460 | Additional information (for general notes) | — | X | — |
444000470 | Free text | — | X | — |
| SG34.RFF | — | — | Must | — |
1153 Z0900480 | Device number | — | X | — |
115400490 | Device number | — | X | — |
| UNS | — | — | Must | — |
0081 S00500 | Separation of detail and summary section | — | X | — |
| UNT | — | — | Must | — |
007400510 | Number of segments in a message | — | X | — |
006200520 | 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 |
|---|---|
| [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 |
| [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 |
| [567] | Note: Only one piece of information may be transmitted in DE3148 |
| [903] | Format: Possible value: 1 |
| [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 |
| [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:502+9900259000002:502+{{date}}:{{time}}+M0Q6IGPA'
UNH+M0B2T74V+ORDERS:D:09B:UN:1.4b'
BGM+Z61+M00T0WEQ'
DTM+137:202408150608?+00:303'
RFF+Z13:17101'
NAD+MS+9903111000003::332'
CTA+IC+:Laue'
COM+mako@enercity.de:EM'
NAD+MR+9900259000002::332'
NAD+DP'
LOC+172+44897654121'
UNS+S'
UNT+12+M0B2T74V'
UNZ+1+M0Q6IGPA'[1 item
{6 fields
"data": {3 fields
"stammdaten": {1 field
"ANFRAGE": [1 item
{5 fields
"transaktionsdaten": {8 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 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 70 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.