| Structure (BO4E) | Description | Format | 44140 | Condition |
|---|---|---|---|---|
| **stammdaten** | — | object | May | — |
| **MARKTLOKATION** [ ] | — | object[] | May | — |
| **eigentuemer** | — | object | May | — |
| [anrede](/en/bo4e/202604/bo/Geschaeftspartner#anrede)00010 | The form of address for the GePa, e.g. Mr. | string | May | — |
| [gewerbekennzeichnung](/en/bo4e/202604/bo/Geschaeftspartner#gewerbekennzeichnung)00020 | Indicates whether this is a business/company (gewerbeKennzeichnung = true)
or a private individual. (gewerbeKennzeichnung = false) | boolean | May | — |
| [name1](/en/bo4e/202604/bo/Geschaeftspartner#name1)00030 | 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 | May | — |
| [name2](/en/bo4e/202604/bo/Geschaeftspartner#name2)00040 | 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 | May | — |
| [name3](/en/bo4e/202604/bo/Geschaeftspartner#name3)00050 | 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 | May | — |
| [name4](/en/bo4e/202604/bo/Geschaeftspartner#name4)00060 | name4 | string | May | — |
| **partneradresse** | — | object | May | — |
| [hausnummer](/en/bo4e/202604/com/Adresse#hausnummer)00070 | House number and supplement | string | May | — |
| [landescode](/en/bo4e/202604/com/Adresse#landescode)00080 | Country code | [Enum Landescode](/en/bo4e/202604/enum/Landescode) | May | — |
| `AC` | — | — | May | — |
| `AD` | — | — | May | — |
| `AE` | — | — | May | — |
| `AF` | — | — | May | — |
| `AG` | — | — | May | — |
| `AI` | — | — | May | — |
| `AL` | — | — | May | — |
| `AM` | — | — | May | — |
| `AN` | — | — | May | — |
| `AO` | — | — | May | — |
| `AQ` | — | — | May | — |
| `AR` | — | — | May | — |
| `AS` | — | — | May | — |
| `AT` | — | — | May | — |
| `AU` | — | — | May | — |
| `AW` | — | — | May | — |
| `AX` | — | — | May | — |
| `AZ` | — | — | May | — |
| `BA` | — | — | May | — |
| `BB` | — | — | May | — |
| `BD` | — | — | May | — |
| `BE` | — | — | May | — |
| `BF` | — | — | May | — |
| `BG` | — | — | May | — |
| `BH` | — | — | May | — |
| `BI` | — | — | May | — |
| `BJ` | — | — | May | — |
| `BL` | — | — | May | — |
| `BM` | — | — | May | — |
| `BN` | — | — | May | — |
| `BO` | — | — | May | — |
| `BQ` | — | — | May | — |
| `BR` | — | — | May | — |
| `BS` | — | — | May | — |
| `BT` | — | — | May | — |
| `BU` | — | — | May | — |
| `BV` | — | — | May | — |
| `BW` | — | — | May | — |
| `BY` | — | — | May | — |
| `BZ` | — | — | May | — |
| `CA` | — | — | May | — |
| `CC` | — | — | May | — |
| `CD` | — | — | May | — |
| `CF` | — | — | May | — |
| `CG` | — | — | May | — |
| `CH` | — | — | May | — |
| `CI` | — | — | May | — |
| `CK` | — | — | May | — |
| `CL` | — | — | May | — |
| `CM` | — | — | May | — |
| `CN` | — | — | May | — |
| `CO` | — | — | May | — |
| `CP` | — | — | May | — |
| `CR` | — | — | May | — |
| `CS` | — | — | May | — |
| `CU` | — | — | May | — |
| `CV` | — | — | May | — |
| `CW` | — | — | May | — |
| `CX` | — | — | May | — |
| `CY` | — | — | May | — |
| `CZ` | — | — | May | — |
| `DE` | — | — | May | — |
| `DG` | — | — | May | — |
| `DJ` | — | — | May | — |
| `DK` | — | — | May | — |
| `DM` | — | — | May | — |
| `DO` | — | — | May | — |
| `DZ` | — | — | May | — |
| `EA` | — | — | May | — |
| `EC` | — | — | May | — |
| `EE` | — | — | May | — |
| `EG` | — | — | May | — |
| `EH` | — | — | May | — |
| `ER` | — | — | May | — |
| `ES` | — | — | May | — |
| `ET` | — | — | May | — |
| `EU` | — | — | May | — |
| `FI` | — | — | May | — |
| `FJ` | — | — | May | — |
| `FK` | — | — | May | — |
| `FM` | — | — | May | — |
| `FO` | — | — | May | — |
| `FR` | — | — | May | — |
| `FX` | — | — | May | — |
| `GA` | — | — | May | — |
| `GB` | — | — | May | — |
| `GD` | — | — | May | — |
| `GE` | — | — | May | — |
| `GF` | — | — | May | — |
| `GG` | — | — | May | — |
| `GH` | — | — | May | — |
| `GI` | — | — | May | — |
| `GL` | — | — | May | — |
| `GM` | — | — | May | — |
| `GN` | — | — | May | — |
| `GP` | — | — | May | — |
| `GQ` | — | — | May | — |
| `GR` | — | — | May | — |
| `GS` | — | — | May | — |
| `GT` | — | — | May | — |
| `GU` | — | — | May | — |
| `GW` | — | — | May | — |
| `GY` | — | — | May | — |
| `HK` | — | — | May | — |
| `HM` | — | — | May | — |
| `HN` | — | — | May | — |
| `HR` | — | — | May | — |
| `HT` | — | — | May | — |
| `HU` | — | — | May | — |
| `IC` | — | — | May | — |
| `ID` | — | — | May | — |
| `IE` | — | — | May | — |
| `IL` | — | — | May | — |
| `IM` | — | — | May | — |
| `IN` | — | — | May | — |
| `IO` | — | — | May | — |
| `IQ` | — | — | May | — |
| `IR` | — | — | May | — |
| `IS` | — | — | May | — |
| `IT` | — | — | May | — |
| `JE` | — | — | May | — |
| `JM` | — | — | May | — |
| `JO` | — | — | May | — |
| `JP` | — | — | May | — |
| `KE` | — | — | May | — |
| `KG` | — | — | May | — |
| `KH` | — | — | May | — |
| `KI` | — | — | May | — |
| `KM` | — | — | May | — |
| `KN` | — | — | May | — |
| `KP` | — | — | May | — |
| `KR` | — | — | May | — |
| `KW` | — | — | May | — |
| `KY` | — | — | May | — |
| `KZ` | — | — | May | — |
| `LA` | — | — | May | — |
| `LB` | — | — | May | — |
| `LC` | — | — | May | — |
| `LI` | — | — | May | — |
| `LK` | — | — | May | — |
| `LR` | — | — | May | — |
| `LS` | — | — | May | — |
| `LT` | — | — | May | — |
| `LU` | — | — | May | — |
| `LV` | — | — | May | — |
| `LY` | — | — | May | — |
| `MA` | — | — | May | — |
| `MC` | — | — | May | — |
| `MD` | — | — | May | — |
| `ME` | — | — | May | — |
| `MF` | — | — | May | — |
| `MG` | — | — | May | — |
| `MH` | — | — | May | — |
| `MK` | — | — | May | — |
| `ML` | — | — | May | — |
| `MM` | — | — | May | — |
| `MN` | — | — | May | — |
| `MO` | — | — | May | — |
| `MP` | — | — | May | — |
| `MQ` | — | — | May | — |
| `MR` | — | — | May | — |
| `MS` | — | — | May | — |
| `MT` | — | — | May | — |
| `MU` | — | — | May | — |
| `MV` | — | — | May | — |
| `MW` | — | — | May | — |
| `MX` | — | — | May | — |
| `MY` | — | — | May | — |
| `MZ` | — | — | May | — |
| `NA` | — | — | May | — |
| `NC` | — | — | May | — |
| `NE` | — | — | May | — |
| `NF` | — | — | May | — |
| `NG` | — | — | May | — |
| `NI` | — | — | May | — |
| `NL` | — | — | May | — |
| `NO` | — | — | May | — |
| `NP` | — | — | May | — |
| `NR` | — | — | May | — |
| `NT` | — | — | May | — |
| `NU` | — | — | May | — |
| `NZ` | — | — | May | — |
| `OM` | — | — | May | — |
| `PA` | — | — | May | — |
| `PE` | — | — | May | — |
| `PF` | — | — | May | — |
| `PG` | — | — | May | — |
| `PH` | — | — | May | — |
| `PK` | — | — | May | — |
| `PL` | — | — | May | — |
| `PM` | — | — | May | — |
| `PN` | — | — | May | — |
| `PR` | — | — | May | — |
| `PS` | — | — | May | — |
| `PT` | — | — | May | — |
| `PW` | — | — | May | — |
| `PY` | — | — | May | — |
| `QA` | — | — | May | — |
| `RE` | — | — | May | — |
| `RO` | — | — | May | — |
| `RS` | — | — | May | — |
| `RU` | — | — | May | — |
| `RW` | — | — | May | — |
| `SA` | — | — | May | — |
| `SB` | — | — | May | — |
| `SC` | — | — | May | — |
| `SD` | — | — | May | — |
| `SE` | — | — | May | — |
| `SF` | — | — | May | — |
| `SG` | — | — | May | — |
| `SH` | — | — | May | — |
| `SI` | — | — | May | — |
| `SJ` | — | — | May | — |
| `SK` | — | — | May | — |
| `SL` | — | — | May | — |
| `SM` | — | — | May | — |
| `SN` | — | — | May | — |
| `SO` | — | — | May | — |
| `SR` | — | — | May | — |
| `SS` | — | — | May | — |
| `ST` | — | — | May | — |
| `SU` | — | — | May | — |
| `SV` | — | — | May | — |
| `SX` | — | — | May | — |
| `SY` | — | — | May | — |
| `SZ` | — | — | May | — |
| `TA` | — | — | May | — |
| `TC` | — | — | May | — |
| `TD` | — | — | May | — |
| `TF` | — | — | May | — |
| `TG` | — | — | May | — |
| `TJ` | — | — | May | — |
| `TK` | — | — | May | — |
| `TL` | — | — | May | — |
| `TM` | — | — | May | — |
| `TN` | — | — | May | — |
| `TO` | — | — | May | — |
| `TP` | — | — | May | — |
| `TR` | — | — | May | — |
| `TT` | — | — | May | — |
| `TV` | — | — | May | — |
| `TW` | — | — | May | — |
| `TZ` | — | — | May | — |
| `UA` | — | — | May | — |
| `UG` | — | — | May | — |
| `UK` | — | — | May | — |
| `UM` | — | — | May | — |
| `US` | — | — | May | — |
| `UY` | — | — | May | — |
| `UZ` | — | — | May | — |
| `VA` | — | — | May | — |
| `VC` | — | — | May | — |
| `VE` | — | — | May | — |
| `VG` | — | — | May | — |
| `VI` | — | — | May | — |
| `VN` | — | — | May | — |
| `VU` | — | — | May | — |
| `WF` | — | — | May | — |
| `WS` | — | — | May | — |
| `XK` | — | — | May | — |
| `YE` | — | — | May | — |
| `YT` | — | — | May | — |
| `YU` | — | — | May | — |
| `ZA` | — | — | May | — |
| `ZM` | — | — | May | — |
| `ZR` | — | — | May | — |
| `ZW` | — | — | May | — |
| [ort](/en/bo4e/202604/com/Adresse#ort)00090 | City | string | May | — |
| [ortsteil](/en/bo4e/202604/com/Adresse#ortsteil)00100 | District | string | May | — |
| [postfach](/en/bo4e/202604/com/Adresse#postfach)00110 | PO box | string | May | — |
| [postleitzahl](/en/bo4e/202604/com/Adresse#postleitzahl)00120 | Postal code | string | May | — |
| [strasse](/en/bo4e/202604/com/Adresse#strasse)00130 | Street | string | May | — |
| **hausverwalter** | — | object | May | — |
| [anrede](/en/bo4e/202604/bo/Geschaeftspartner#anrede)00140 | The form of address for the GePa, e.g. Mr. | string | May | — |
| [gewerbekennzeichnung](/en/bo4e/202604/bo/Geschaeftspartner#gewerbekennzeichnung)00150 | Indicates whether this is a business/company (gewerbeKennzeichnung = true)
or a private individual. (gewerbeKennzeichnung = false) | boolean | May | — |
| [name1](/en/bo4e/202604/bo/Geschaeftspartner#name1)00160 | 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 | May | — |
| [name2](/en/bo4e/202604/bo/Geschaeftspartner#name2)00170 | 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 | May | — |
| [name3](/en/bo4e/202604/bo/Geschaeftspartner#name3)00180 | 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 | May | — |
| [name4](/en/bo4e/202604/bo/Geschaeftspartner#name4)00190 | name4 | string | May | — |
| **partneradresse** | — | object | May | — |
| [hausnummer](/en/bo4e/202604/com/Adresse#hausnummer)00200 | House number and supplement | string | May | — |
| [landescode](/en/bo4e/202604/com/Adresse#landescode)00210 | Country code | [Enum Landescode](/en/bo4e/202604/enum/Landescode) | May | — |
| `AC` | — | — | May | — |
| `AD` | — | — | May | — |
| `AE` | — | — | May | — |
| `AF` | — | — | May | — |
| `AG` | — | — | May | — |
| `AI` | — | — | May | — |
| `AL` | — | — | May | — |
| `AM` | — | — | May | — |
| `AN` | — | — | May | — |
| `AO` | — | — | May | — |
| `AQ` | — | — | May | — |
| `AR` | — | — | May | — |
| `AS` | — | — | May | — |
| `AT` | — | — | May | — |
| `AU` | — | — | May | — |
| `AW` | — | — | May | — |
| `AX` | — | — | May | — |
| `AZ` | — | — | May | — |
| `BA` | — | — | May | — |
| `BB` | — | — | May | — |
| `BD` | — | — | May | — |
| `BE` | — | — | May | — |
| `BF` | — | — | May | — |
| `BG` | — | — | May | — |
| `BH` | — | — | May | — |
| `BI` | — | — | May | — |
| `BJ` | — | — | May | — |
| `BL` | — | — | May | — |
| `BM` | — | — | May | — |
| `BN` | — | — | May | — |
| `BO` | — | — | May | — |
| `BQ` | — | — | May | — |
| `BR` | — | — | May | — |
| `BS` | — | — | May | — |
| `BT` | — | — | May | — |
| `BU` | — | — | May | — |
| `BV` | — | — | May | — |
| `BW` | — | — | May | — |
| `BY` | — | — | May | — |
| `BZ` | — | — | May | — |
| `CA` | — | — | May | — |
| `CC` | — | — | May | — |
| `CD` | — | — | May | — |
| `CF` | — | — | May | — |
| `CG` | — | — | May | — |
| `CH` | — | — | May | — |
| `CI` | — | — | May | — |
| `CK` | — | — | May | — |
| `CL` | — | — | May | — |
| `CM` | — | — | May | — |
| `CN` | — | — | May | — |
| `CO` | — | — | May | — |
| `CP` | — | — | May | — |
| `CR` | — | — | May | — |
| `CS` | — | — | May | — |
| `CU` | — | — | May | — |
| `CV` | — | — | May | — |
| `CW` | — | — | May | — |
| `CX` | — | — | May | — |
| `CY` | — | — | May | — |
| `CZ` | — | — | May | — |
| `DE` | — | — | May | — |
| `DG` | — | — | May | — |
| `DJ` | — | — | May | — |
| `DK` | — | — | May | — |
| `DM` | — | — | May | — |
| `DO` | — | — | May | — |
| `DZ` | — | — | May | — |
| `EA` | — | — | May | — |
| `EC` | — | — | May | — |
| `EE` | — | — | May | — |
| `EG` | — | — | May | — |
| `EH` | — | — | May | — |
| `ER` | — | — | May | — |
| `ES` | — | — | May | — |
| `ET` | — | — | May | — |
| `EU` | — | — | May | — |
| `FI` | — | — | May | — |
| `FJ` | — | — | May | — |
| `FK` | — | — | May | — |
| `FM` | — | — | May | — |
| `FO` | — | — | May | — |
| `FR` | — | — | May | — |
| `FX` | — | — | May | — |
| `GA` | — | — | May | — |
| `GB` | — | — | May | — |
| `GD` | — | — | May | — |
| `GE` | — | — | May | — |
| `GF` | — | — | May | — |
| `GG` | — | — | May | — |
| `GH` | — | — | May | — |
| `GI` | — | — | May | — |
| `GL` | — | — | May | — |
| `GM` | — | — | May | — |
| `GN` | — | — | May | — |
| `GP` | — | — | May | — |
| `GQ` | — | — | May | — |
| `GR` | — | — | May | — |
| `GS` | — | — | May | — |
| `GT` | — | — | May | — |
| `GU` | — | — | May | — |
| `GW` | — | — | May | — |
| `GY` | — | — | May | — |
| `HK` | — | — | May | — |
| `HM` | — | — | May | — |
| `HN` | — | — | May | — |
| `HR` | — | — | May | — |
| `HT` | — | — | May | — |
| `HU` | — | — | May | — |
| `IC` | — | — | May | — |
| `ID` | — | — | May | — |
| `IE` | — | — | May | — |
| `IL` | — | — | May | — |
| `IM` | — | — | May | — |
| `IN` | — | — | May | — |
| `IO` | — | — | May | — |
| `IQ` | — | — | May | — |
| `IR` | — | — | May | — |
| `IS` | — | — | May | — |
| `IT` | — | — | May | — |
| `JE` | — | — | May | — |
| `JM` | — | — | May | — |
| `JO` | — | — | May | — |
| `JP` | — | — | May | — |
| `KE` | — | — | May | — |
| `KG` | — | — | May | — |
| `KH` | — | — | May | — |
| `KI` | — | — | May | — |
| `KM` | — | — | May | — |
| `KN` | — | — | May | — |
| `KP` | — | — | May | — |
| `KR` | — | — | May | — |
| `KW` | — | — | May | — |
| `KY` | — | — | May | — |
| `KZ` | — | — | May | — |
| `LA` | — | — | May | — |
| `LB` | — | — | May | — |
| `LC` | — | — | May | — |
| `LI` | — | — | May | — |
| `LK` | — | — | May | — |
| `LR` | — | — | May | — |
| `LS` | — | — | May | — |
| `LT` | — | — | May | — |
| `LU` | — | — | May | — |
| `LV` | — | — | May | — |
| `LY` | — | — | May | — |
| `MA` | — | — | May | — |
| `MC` | — | — | May | — |
| `MD` | — | — | May | — |
| `ME` | — | — | May | — |
| `MF` | — | — | May | — |
| `MG` | — | — | May | — |
| `MH` | — | — | May | — |
| `MK` | — | — | May | — |
| `ML` | — | — | May | — |
| `MM` | — | — | May | — |
| `MN` | — | — | May | — |
| `MO` | — | — | May | — |
| `MP` | — | — | May | — |
| `MQ` | — | — | May | — |
| `MR` | — | — | May | — |
| `MS` | — | — | May | — |
| `MT` | — | — | May | — |
| `MU` | — | — | May | — |
| `MV` | — | — | May | — |
| `MW` | — | — | May | — |
| `MX` | — | — | May | — |
| `MY` | — | — | May | — |
| `MZ` | — | — | May | — |
| `NA` | — | — | May | — |
| `NC` | — | — | May | — |
| `NE` | — | — | May | — |
| `NF` | — | — | May | — |
| `NG` | — | — | May | — |
| `NI` | — | — | May | — |
| `NL` | — | — | May | — |
| `NO` | — | — | May | — |
| `NP` | — | — | May | — |
| `NR` | — | — | May | — |
| `NT` | — | — | May | — |
| `NU` | — | — | May | — |
| `NZ` | — | — | May | — |
| `OM` | — | — | May | — |
| `PA` | — | — | May | — |
| `PE` | — | — | May | — |
| `PF` | — | — | May | — |
| `PG` | — | — | May | — |
| `PH` | — | — | May | — |
| `PK` | — | — | May | — |
| `PL` | — | — | May | — |
| `PM` | — | — | May | — |
| `PN` | — | — | May | — |
| `PR` | — | — | May | — |
| `PS` | — | — | May | — |
| `PT` | — | — | May | — |
| `PW` | — | — | May | — |
| `PY` | — | — | May | — |
| `QA` | — | — | May | — |
| `RE` | — | — | May | — |
| `RO` | — | — | May | — |
| `RS` | — | — | May | — |
| `RU` | — | — | May | — |
| `RW` | — | — | May | — |
| `SA` | — | — | May | — |
| `SB` | — | — | May | — |
| `SC` | — | — | May | — |
| `SD` | — | — | May | — |
| `SE` | — | — | May | — |
| `SF` | — | — | May | — |
| `SG` | — | — | May | — |
| `SH` | — | — | May | — |
| `SI` | — | — | May | — |
| `SJ` | — | — | May | — |
| `SK` | — | — | May | — |
| `SL` | — | — | May | — |
| `SM` | — | — | May | — |
| `SN` | — | — | May | — |
| `SO` | — | — | May | — |
| `SR` | — | — | May | — |
| `SS` | — | — | May | — |
| `ST` | — | — | May | — |
| `SU` | — | — | May | — |
| `SV` | — | — | May | — |
| `SX` | — | — | May | — |
| `SY` | — | — | May | — |
| `SZ` | — | — | May | — |
| `TA` | — | — | May | — |
| `TC` | — | — | May | — |
| `TD` | — | — | May | — |
| `TF` | — | — | May | — |
| `TG` | — | — | May | — |
| `TJ` | — | — | May | — |
| `TK` | — | — | May | — |
| `TL` | — | — | May | — |
| `TM` | — | — | May | — |
| `TN` | — | — | May | — |
| `TO` | — | — | May | — |
| `TP` | — | — | May | — |
| `TR` | — | — | May | — |
| `TT` | — | — | May | — |
| `TV` | — | — | May | — |
| `TW` | — | — | May | — |
| `TZ` | — | — | May | — |
| `UA` | — | — | May | — |
| `UG` | — | — | May | — |
| `UK` | — | — | May | — |
| `UM` | — | — | May | — |
| `US` | — | — | May | — |
| `UY` | — | — | May | — |
| `UZ` | — | — | May | — |
| `VA` | — | — | May | — |
| `VC` | — | — | May | — |
| `VE` | — | — | May | — |
| `VG` | — | — | May | — |
| `VI` | — | — | May | — |
| `VN` | — | — | May | — |
| `VU` | — | — | May | — |
| `WF` | — | — | May | — |
| `WS` | — | — | May | — |
| `XK` | — | — | May | — |
| `YE` | — | — | May | — |
| `YT` | — | — | May | — |
| `YU` | — | — | May | — |
| `ZA` | — | — | May | — |
| `ZM` | — | — | May | — |
| `ZR` | — | — | May | — |
| `ZW` | — | — | May | — |
| [ort](/en/bo4e/202604/com/Adresse#ort)00220 | City | string | May | — |
| [ortsteil](/en/bo4e/202604/com/Adresse#ortsteil)00230 | District | string | May | — |
| [postfach](/en/bo4e/202604/com/Adresse#postfach)00240 | PO box | string | May | — |
| [postleitzahl](/en/bo4e/202604/com/Adresse#postleitzahl)00250 | Postal code | string | May | — |
| [strasse](/en/bo4e/202604/com/Adresse#strasse)00260 | Street | string | May | — |
| **MESSLOKATION** [ ] \* | — | object[] | Must | — |
| [gasqualitaet](/en/bo4e/202604/bo/Messlokation#gasqualitaet)00270 | gasqualitaet for EDIFACT mapping | [Enum Gasqualitaet](/en/bo4e/202604/enum/Gasqualitaet) | May | — |
| `H_GAS` | — | — | May | — |
| `L_GAS` | — | — | May | — |
| [messlokationsId](/en/bo4e/202604/bo/Messlokation#messlokationsid) \*00280 | The metering location identification. This is the former metering point identifier,
e.g. DE 47108151234567 | string | Must | — |
| **marktrollen** [ ] | — | object[] | May | — |
| [marktrolle](/en/bo4e/202604/bo/Marktteilnehmer#marktrolle)00290 | Indicates the designation of the market role in free text. | [Enum Marktrolle](/en/bo4e/202604/enum/Marktrolle) | May | — |
| `NB` | — | — | May | — |
| `LF` | — | — | May | — |
| `MSB` | — | — | May | — |
| `MSBA` | — | — | May | — |
| `GMSB` | — | — | May | — |
| `MDL` | — | — | May | — |
| `DL` | — | — | May | — |
| `BKV` | — | — | May | — |
| `UENB` | — | — | May | — |
| `KUNDE-SELBST-NN` | — | — | May | — |
| `MGV` | — | — | May | — |
| `EIV` | — | — | May | — |
| `RB` | — | — | May | — |
| `KUNDE` | — | — | May | — |
| `INTERESSENT` | — | — | May | — |
| `KN` | — | — | May | — |
| `UBA` | — | — | May | — |
| `BIKO` | — | — | May | — |
| `ESA` | — | — | May | — |
| [rollencodenummer](/en/bo4e/202604/bo/Marktteilnehmer#rollencodenummer)00300 | Specifies the code value of the market role. | string | May | — |
| [weiterverpflichtet](/en/bo4e/202604/bo/Marktteilnehmer#weiterverpflichtet)00310 | weiterverpflichtet | boolean | May | — |
| **MESSSTELLENBETRIEBSVERTRAG** [ ] | — | object[] | May | — |
| **vertragskonditionen** | — | object | May | — |
| **geplanteTurnusablesung** | — | object | May | — |
| [ableseZeitraum](/en/bo4e/202604/com/Zeitraum#ablesezeitraum)00320 | ableseZeitraum | string | May | — |
| **NETZNUTZUNGSVERTRAG** [ ] | — | object[] | May | — |
| [vertragsbeginn](/en/bo4e/202604/bo/Vertrag#vertragsbeginn)00330 | Specifies when the contract begins. | string (date-time) | May | — |
| **korrespondenzpartner** | — | object | May | — |
| [anrede](/en/bo4e/202604/bo/Geschaeftspartner#anrede)00340 | The form of address for the GePa, e.g. Mr. | string | May | — |
| [gewerbekennzeichnung](/en/bo4e/202604/bo/Geschaeftspartner#gewerbekennzeichnung)00350 | Indicates whether this is a business/company (gewerbeKennzeichnung = true)
or a private individual. (gewerbeKennzeichnung = false) | boolean | May | — |
| [name1](/en/bo4e/202604/bo/Geschaeftspartner#name1)00360 | 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 | May | — |
| [name2](/en/bo4e/202604/bo/Geschaeftspartner#name2)00370 | 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 | May | — |
| [name3](/en/bo4e/202604/bo/Geschaeftspartner#name3)00380 | 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 | May | — |
| [name4](/en/bo4e/202604/bo/Geschaeftspartner#name4)00390 | name4 | string | May | — |
| **partneradresse** | — | object | May | — |
| [hausnummer](/en/bo4e/202604/com/Adresse#hausnummer)00400 | House number and supplement | string | May | — |
| [landescode](/en/bo4e/202604/com/Adresse#landescode)00410 | Country code | [Enum Landescode](/en/bo4e/202604/enum/Landescode) | May | — |
| `AC` | — | — | May | — |
| `AD` | — | — | May | — |
| `AE` | — | — | May | — |
| `AF` | — | — | May | — |
| `AG` | — | — | May | — |
| `AI` | — | — | May | — |
| `AL` | — | — | May | — |
| `AM` | — | — | May | — |
| `AN` | — | — | May | — |
| `AO` | — | — | May | — |
| `AQ` | — | — | May | — |
| `AR` | — | — | May | — |
| `AS` | — | — | May | — |
| `AT` | — | — | May | — |
| `AU` | — | — | May | — |
| `AW` | — | — | May | — |
| `AX` | — | — | May | — |
| `AZ` | — | — | May | — |
| `BA` | — | — | May | — |
| `BB` | — | — | May | — |
| `BD` | — | — | May | — |
| `BE` | — | — | May | — |
| `BF` | — | — | May | — |
| `BG` | — | — | May | — |
| `BH` | — | — | May | — |
| `BI` | — | — | May | — |
| `BJ` | — | — | May | — |
| `BL` | — | — | May | — |
| `BM` | — | — | May | — |
| `BN` | — | — | May | — |
| `BO` | — | — | May | — |
| `BQ` | — | — | May | — |
| `BR` | — | — | May | — |
| `BS` | — | — | May | — |
| `BT` | — | — | May | — |
| `BU` | — | — | May | — |
| `BV` | — | — | May | — |
| `BW` | — | — | May | — |
| `BY` | — | — | May | — |
| `BZ` | — | — | May | — |
| `CA` | — | — | May | — |
| `CC` | — | — | May | — |
| `CD` | — | — | May | — |
| `CF` | — | — | May | — |
| `CG` | — | — | May | — |
| `CH` | — | — | May | — |
| `CI` | — | — | May | — |
| `CK` | — | — | May | — |
| `CL` | — | — | May | — |
| `CM` | — | — | May | — |
| `CN` | — | — | May | — |
| `CO` | — | — | May | — |
| `CP` | — | — | May | — |
| `CR` | — | — | May | — |
| `CS` | — | — | May | — |
| `CU` | — | — | May | — |
| `CV` | — | — | May | — |
| `CW` | — | — | May | — |
| `CX` | — | — | May | — |
| `CY` | — | — | May | — |
| `CZ` | — | — | May | — |
| `DE` | — | — | May | — |
| `DG` | — | — | May | — |
| `DJ` | — | — | May | — |
| `DK` | — | — | May | — |
| `DM` | — | — | May | — |
| `DO` | — | — | May | — |
| `DZ` | — | — | May | — |
| `EA` | — | — | May | — |
| `EC` | — | — | May | — |
| `EE` | — | — | May | — |
| `EG` | — | — | May | — |
| `EH` | — | — | May | — |
| `ER` | — | — | May | — |
| `ES` | — | — | May | — |
| `ET` | — | — | May | — |
| `EU` | — | — | May | — |
| `FI` | — | — | May | — |
| `FJ` | — | — | May | — |
| `FK` | — | — | May | — |
| `FM` | — | — | May | — |
| `FO` | — | — | May | — |
| `FR` | — | — | May | — |
| `FX` | — | — | May | — |
| `GA` | — | — | May | — |
| `GB` | — | — | May | — |
| `GD` | — | — | May | — |
| `GE` | — | — | May | — |
| `GF` | — | — | May | — |
| `GG` | — | — | May | — |
| `GH` | — | — | May | — |
| `GI` | — | — | May | — |
| `GL` | — | — | May | — |
| `GM` | — | — | May | — |
| `GN` | — | — | May | — |
| `GP` | — | — | May | — |
| `GQ` | — | — | May | — |
| `GR` | — | — | May | — |
| `GS` | — | — | May | — |
| `GT` | — | — | May | — |
| `GU` | — | — | May | — |
| `GW` | — | — | May | — |
| `GY` | — | — | May | — |
| `HK` | — | — | May | — |
| `HM` | — | — | May | — |
| `HN` | — | — | May | — |
| `HR` | — | — | May | — |
| `HT` | — | — | May | — |
| `HU` | — | — | May | — |
| `IC` | — | — | May | — |
| `ID` | — | — | May | — |
| `IE` | — | — | May | — |
| `IL` | — | — | May | — |
| `IM` | — | — | May | — |
| `IN` | — | — | May | — |
| `IO` | — | — | May | — |
| `IQ` | — | — | May | — |
| `IR` | — | — | May | — |
| `IS` | — | — | May | — |
| `IT` | — | — | May | — |
| `JE` | — | — | May | — |
| `JM` | — | — | May | — |
| `JO` | — | — | May | — |
| `JP` | — | — | May | — |
| `KE` | — | — | May | — |
| `KG` | — | — | May | — |
| `KH` | — | — | May | — |
| `KI` | — | — | May | — |
| `KM` | — | — | May | — |
| `KN` | — | — | May | — |
| `KP` | — | — | May | — |
| `KR` | — | — | May | — |
| `KW` | — | — | May | — |
| `KY` | — | — | May | — |
| `KZ` | — | — | May | — |
| `LA` | — | — | May | — |
| `LB` | — | — | May | — |
| `LC` | — | — | May | — |
| `LI` | — | — | May | — |
| `LK` | — | — | May | — |
| `LR` | — | — | May | — |
| `LS` | — | — | May | — |
| `LT` | — | — | May | — |
| `LU` | — | — | May | — |
| `LV` | — | — | May | — |
| `LY` | — | — | May | — |
| `MA` | — | — | May | — |
| `MC` | — | — | May | — |
| `MD` | — | — | May | — |
| `ME` | — | — | May | — |
| `MF` | — | — | May | — |
| `MG` | — | — | May | — |
| `MH` | — | — | May | — |
| `MK` | — | — | May | — |
| `ML` | — | — | May | — |
| `MM` | — | — | May | — |
| `MN` | — | — | May | — |
| `MO` | — | — | May | — |
| `MP` | — | — | May | — |
| `MQ` | — | — | May | — |
| `MR` | — | — | May | — |
| `MS` | — | — | May | — |
| `MT` | — | — | May | — |
| `MU` | — | — | May | — |
| `MV` | — | — | May | — |
| `MW` | — | — | May | — |
| `MX` | — | — | May | — |
| `MY` | — | — | May | — |
| `MZ` | — | — | May | — |
| `NA` | — | — | May | — |
| `NC` | — | — | May | — |
| `NE` | — | — | May | — |
| `NF` | — | — | May | — |
| `NG` | — | — | May | — |
| `NI` | — | — | May | — |
| `NL` | — | — | May | — |
| `NO` | — | — | May | — |
| `NP` | — | — | May | — |
| `NR` | — | — | May | — |
| `NT` | — | — | May | — |
| `NU` | — | — | May | — |
| `NZ` | — | — | May | — |
| `OM` | — | — | May | — |
| `PA` | — | — | May | — |
| `PE` | — | — | May | — |
| `PF` | — | — | May | — |
| `PG` | — | — | May | — |
| `PH` | — | — | May | — |
| `PK` | — | — | May | — |
| `PL` | — | — | May | — |
| `PM` | — | — | May | — |
| `PN` | — | — | May | — |
| `PR` | — | — | May | — |
| `PS` | — | — | May | — |
| `PT` | — | — | May | — |
| `PW` | — | — | May | — |
| `PY` | — | — | May | — |
| `QA` | — | — | May | — |
| `RE` | — | — | May | — |
| `RO` | — | — | May | — |
| `RS` | — | — | May | — |
| `RU` | — | — | May | — |
| `RW` | — | — | May | — |
| `SA` | — | — | May | — |
| `SB` | — | — | May | — |
| `SC` | — | — | May | — |
| `SD` | — | — | May | — |
| `SE` | — | — | May | — |
| `SF` | — | — | May | — |
| `SG` | — | — | May | — |
| `SH` | — | — | May | — |
| `SI` | — | — | May | — |
| `SJ` | — | — | May | — |
| `SK` | — | — | May | — |
| `SL` | — | — | May | — |
| `SM` | — | — | May | — |
| `SN` | — | — | May | — |
| `SO` | — | — | May | — |
| `SR` | — | — | May | — |
| `SS` | — | — | May | — |
| `ST` | — | — | May | — |
| `SU` | — | — | May | — |
| `SV` | — | — | May | — |
| `SX` | — | — | May | — |
| `SY` | — | — | May | — |
| `SZ` | — | — | May | — |
| `TA` | — | — | May | — |
| `TC` | — | — | May | — |
| `TD` | — | — | May | — |
| `TF` | — | — | May | — |
| `TG` | — | — | May | — |
| `TJ` | — | — | May | — |
| `TK` | — | — | May | — |
| `TL` | — | — | May | — |
| `TM` | — | — | May | — |
| `TN` | — | — | May | — |
| `TO` | — | — | May | — |
| `TP` | — | — | May | — |
| `TR` | — | — | May | — |
| `TT` | — | — | May | — |
| `TV` | — | — | May | — |
| `TW` | — | — | May | — |
| `TZ` | — | — | May | — |
| `UA` | — | — | May | — |
| `UG` | — | — | May | — |
| `UK` | — | — | May | — |
| `UM` | — | — | May | — |
| `US` | — | — | May | — |
| `UY` | — | — | May | — |
| `UZ` | — | — | May | — |
| `VA` | — | — | May | — |
| `VC` | — | — | May | — |
| `VE` | — | — | May | — |
| `VG` | — | — | May | — |
| `VI` | — | — | May | — |
| `VN` | — | — | May | — |
| `VU` | — | — | May | — |
| `WF` | — | — | May | — |
| `WS` | — | — | May | — |
| `XK` | — | — | May | — |
| `YE` | — | — | May | — |
| `YT` | — | — | May | — |
| `YU` | — | — | May | — |
| `ZA` | — | — | May | — |
| `ZM` | — | — | May | — |
| `ZR` | — | — | May | — |
| `ZW` | — | — | May | — |
| [ort](/en/bo4e/202604/com/Adresse#ort)00420 | City | string | May | — |
| [ortsteil](/en/bo4e/202604/com/Adresse#ortsteil)00430 | District | string | May | — |
| [postfach](/en/bo4e/202604/com/Adresse#postfach)00440 | PO box | string | May | — |
| [postleitzahl](/en/bo4e/202604/com/Adresse#postleitzahl)00450 | Postal code | string | May | — |
| [strasse](/en/bo4e/202604/com/Adresse#strasse)00460 | Street | string | May | — |
| **vertragspartner2** [ ] | — | object[] | May | — |
| [anrede](/en/bo4e/202604/bo/Geschaeftspartner#anrede)00470 | The form of address for the GePa, e.g. Mr. | string | May | — |
| [gewerbekennzeichnung](/en/bo4e/202604/bo/Geschaeftspartner#gewerbekennzeichnung)00480 | Indicates whether this is a business/company (gewerbeKennzeichnung = true)
or a private individual. (gewerbeKennzeichnung = false) | boolean | May | — |
| [name1](/en/bo4e/202604/bo/Geschaeftspartner#name1)00490 | 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 | May | — |
| [name2](/en/bo4e/202604/bo/Geschaeftspartner#name2)00500 | 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 | May | — |
| [name3](/en/bo4e/202604/bo/Geschaeftspartner#name3)00510 | 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 | May | — |
| [name4](/en/bo4e/202604/bo/Geschaeftspartner#name4)00520 | name4 | string | May | — |
## Chain of this trigger
The event triggers the message. The market partner responds with one of the responses listed, and after that the MACO APP writes the transaction to your backend system.
| Message | Responses | Write call after the response |
|---|---|---|
| [44140](/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44140) | [44142](/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44142) | `POST /updateProcessData` |
This event triggers a step in this role view:
| Process | Party involved | Rulebook | Division |
|---|---|---|---|
| [Request for a master data change from the MSB to NB (responsible)](/en/prozessdoku/202604/MSB/geli-gas-2-0-anfrage-zur-stammdatenanderung-vom-msb-an-nb-verantwortlich) | MSB | GeLi Gas 2.0 | Gas |
## Transaction data
The interchange envelope of the message. Mandatory fields must be set on the trigger call.
| Field | Type | Mandatory | Description |
|---|---|---|---|
| [gueltigAb](/en/bo4e/202604/cdoc/Transaktionsdaten#gueltigab) | string (date-time) | **yes** | Effective date/time / DTM+7 |
| [kategorie](/en/bo4e/202604/cdoc/Transaktionsdaten#kategorie) | string | **yes** | Qualifier from the beginning of the EDIFACT message / BGM |
| [sparte](/en/bo4e/202604/cdoc/Transaktionsdaten#sparte) | [Enum Sparte](/en/bo4e/202604/enum/Sparte) | **yes** | Contains information about the division Values: `STROM`, `GAS`, `FERNWAERME`, `NAHWAERME`, `WASSER`, `ABWASSER` |
| [transaktionsgrund](/en/bo4e/202604/cdoc/Transaktionsdaten#transaktionsgrund) | string | **yes** | The transaction reason describes the business transaction for the category in more detail / UTILMD STS+7++###+ZW4+E03 |
| [transaktionsgrundergaenzung](/en/bo4e/202604/cdoc/Transaktionsdaten#transaktionsgrundergaenzung) | string | **yes** | Supplement to the transaction reason / UTILMD STS+7++E01+###+E03 |
| `pruefidentifikator` | — | no | Determined dynamically in the event process. A value supplied by the sender is ignored. Prüfis possible in the topic — 44140. Possible values: `44140` |
| [absender › marktrolle](/en/bo4e/202604/bo/Marktteilnehmer#marktrolle) | [Enum Marktrolle](/en/bo4e/202604/enum/Marktrolle) | no | Specifies the designation of the market role as free text. Values: `NB`, `LF`, `MSB`, `MSBA`, `GMSB`, `MDL`, `DL`, `BKV`, `UENB`, `KUNDE-SELBST-NN` … (+9) |
| [absender › rollencodenummer](/en/bo4e/202604/bo/Marktteilnehmer#rollencodenummer) | string | no | Specifies the code value of the market role. |
| [empfaenger › marktrolle](/en/bo4e/202604/bo/Marktteilnehmer#marktrolle) | [Enum Marktrolle](/en/bo4e/202604/enum/Marktrolle) | no | Specifies the designation of the market role as free text. Values: `NB`, `LF`, `MSB`, `MSBA`, `GMSB`, `MDL`, `DL`, `BKV`, `UENB`, `KUNDE-SELBST-NN` … (+9) |
| [empfaenger › rollencodenummer](/en/bo4e/202604/bo/Marktteilnehmer#rollencodenummer) | string | no | Specifies the code value of the market role. |
## Additional data
`eventname` is fixed to **START_BESTELLUNG_SDAE**. This value stays German in the English version as well, because Camunda correlates on it.
| Field | Type | Mandatory | Description |
|---|---|---|---|
| `prozessId` | string | **yes** | — |
| `eventname` | const `START_BESTELLUNG_SDAE` | **yes** | — |
## Response
**The trigger assigns its own `businessKey`.** The MACO APP adopts **neither** the `businessKey` **nor** the `prozessId` of the calling system as the identifier of the process instance. The `businessKey` of the response is created when the process starts and is new. The body of this call carries no `businessKey` field; there is thus no place where a key of your own could be passed in. The `prozessId` passed in (a mandatory field of this call) remains the document number of the backend: it comes back in `zusatzdaten.prozessId` of the callbacks — mandatory there only for MaloIdent (03002/03003), otherwise optional.
**201 — Success.** Success message for the process data API call.
| Field | Type | Mandatory | Description |
|---|---|---|---|
| `businessKey` | string (uuid) | **yes** | Unique identifier of the business process |
| `message` | string | **yes** | Message with details of the triggered event — example from the source: `received event XXXXXXXXXXXX with id at 2024-08-08T12:58:22Z and started process with businessKey 4c7170ed-3518-41ee-8582-39ab65b00107` |
**400 — Error.** Error message for the process data API call.
| Field | Type | Mandatory | Description |
|---|---|---|---|
| `errorCode` | string | no | Error identifier — example from the source: `400` |
| `message` | string | no | Technical message — example from the source: `Validation Failed` |
Which body the callbacks `updateProcessData` and `createProcessData` send is measured against the NiFi flow of the MACO APP: `{stammdaten, transaktionsdaten, zusatzdaten}` without an interchange envelope, the `businessKey` inside `zusatzdaten`. This is not measured against a recorded call, and not for MaloIdent (03002/03003).
What distinguishes `businessKey`, `prozessId` and `targetBusinessKey` is explained on [Keys and assignment](/en/schnittstellen/schluessel).