# [LF] START_ANFRAGE_STAMMDATEN_MALO
Marktrolle **LF** · Formatversion **202610** · BO4E-Schema **1.7.8**
## Stammdaten
Unter diesem Topic ist genau einer der folgenden 1 Prüfidentifikatoren zulässig — welcher, entscheidet der Event-Prozess.
| Prüfi | Scope | Anwendungsfall | Festlegung | Kommunikation |
|---|---|---|---|---|
| [PI_17101](/schnittstellen/202610/pruefi/ORDERS/PI_17101) | ORDERS | Anfrage Stammdaten Marktlokation (Gas) | GeLi Gas 2.0 | LF → NB |
Die Stammdaten der 1 Prüfidentifikatoren in **einer** Struktur — eine Spalte je Prüfidentifikator, wie im Anwendungshandbuch. Ein Wert in der Spalte heißt, dass das Feld zu diesem Prüfidentifikator gehört: **Muss**, wenn seine Spezifikation es verlangt, sonst **Kann**. Eine leere Zelle heißt »gehört nicht dazu«, nicht »unbekannt«. Vorausgewählt ist der erste; die übrigen schaltet die Leiste über der Tabelle zu.
| Struktur (BO4E) | Beschreibung | Format | 17101 | Bedingung |
|---|---|---|---|---|
| **stammdaten** | — | object | Kann | — |
| **ANFRAGE** [ ] | — | object[] | Kann | — |
| [lokationsId](/bo4e/202610/bo/Anfrage#lokationsid)00010 | Für welche Markt- oder Messlokation gilt diese Anfrage. | string | Kann | — |
| **AUFTRAG** [ ] | — | object[] | Kann | — |
| **positionsdaten** [ ] | — | object[] | Kann | — |
| [positionsnummer](/bo4e/202610/com/AuftragPosition#positionsnummer)00020 | Positionsnummer | integer | Kann | — |
| **allgemeineInformationen** | — | object | Kann | — |
| [info1](/bo4e/202610/com/AllgemeineInformationen#info1)00030 | Allgemeine Info 1 | string | Kann | — |
| [info2](/bo4e/202610/com/AllgemeineInformationen#info2)00040 | Allgemeine Info 2 | string | Kann | — |
| [info3](/bo4e/202610/com/AllgemeineInformationen#info3)00050 | Allgemeine Info 3 | string | Kann | — |
| [info4](/bo4e/202610/com/AllgemeineInformationen#info4)00060 | Allgemeine Info 4 | string | Kann | — |
| [info5](/bo4e/202610/com/AllgemeineInformationen#info5)00070 | Allgemeine Info 5 | string | Kann | — |
| **ENERGIELIEFERVERTRAG** [ ] | — | object[] | Kann | — |
| **vertragspartner2** [ ] | — | object[] | Kann | — |
| [anrede](/bo4e/202610/bo/Geschaeftspartner#anrede)00080 | Die Anrede für den GePa, Z.B. Herr. | string | Kann | — |
| [geschaeftspartnerrolle](/bo4e/202610/bo/Geschaeftspartner#geschaeftspartnerrolle)00090 | Rolle, die der Geschäftspartner hat (z.B. Interessent, Kunde). | array | Kann | — |
| [gewerbekennzeichnung](/bo4e/202610/bo/Geschaeftspartner#gewerbekennzeichnung)00100 | Kennzeichnung ob es sich um einen Gewerbe/Unternehmen (gewerbeKennzeichnung = true)
oder eine Privatperson handelt. (gewerbeKennzeichnung = false) | boolean | Kann | — |
| [name1](/bo4e/202610/bo/Geschaeftspartner#name1)00110 | Erster Teil des Namens. Hier kann der Firmenname oder bei Privatpersonen
beispielsweise der Nachname dargestellt werden. Beispiele: Yellow Strom GmbH
oder Hagen | string | Kann | — |
| [name2](/bo4e/202610/bo/Geschaeftspartner#name2)00120 | Zweiter Teil des Namens. Hier kann der eine Erweiterung zum Firmennamen oder
bei Privatpersonen beispielsweise der Vorname dargestellt werden. Beispiele:
Bereich Süd oder Nina | string | Kann | — |
| [name3](/bo4e/202610/bo/Geschaeftspartner#name3)00130 | Dritter Teil des Namens. Hier können weitere Ergänzungen zum Firmennamen oder
bei Privatpersonen Zusätze zum Namen dargestellt werden. Beispiele: und Afrika
oder Sängerin | string | Kann | — |
| [name4](/bo4e/202610/bo/Geschaeftspartner#name4)00140 | name4 | string | Kann | — |
| **externeReferenzen** [ ] | — | object[] | Kann | — |
| [exRefName](/bo4e/202610/com/ExterneReferenz#exrefname)00150 | Bezeichnung der externen Referenz (z.B. "hochfrequenz integration services") | string | Kann | — |
| `Kundennummer beim Lieferanten` | — | — | Kann | — |
| `Kundennummer beim Altlieferanten` | — | — | Kann | — |
| [exRefWert](/bo4e/202610/com/ExterneReferenz#exrefwert)00160 | Wert der externen Referenz (z.B. "123456"; "4711") | string | Kann | — |
| **MARKTLOKATION** [ ] | — | object[] | Kann | — |
| **lokationsadresse** | — | object | Kann | — |
| [hausnummer](/bo4e/202610/com/Adresse#hausnummer)00170 | Hausnummer und Ergänzung | string | Kann | — |
| [landescode](/bo4e/202610/com/Adresse#landescode)00180 | Landescode | [Enum Landescode](/bo4e/202610/enum/Landescode) | Kann | — |
| `AC` | — | — | Kann | — |
| `AD` | — | — | Kann | — |
| `AE` | — | — | Kann | — |
| `AF` | — | — | Kann | — |
| `AG` | — | — | Kann | — |
| `AI` | — | — | Kann | — |
| `AL` | — | — | Kann | — |
| `AM` | — | — | Kann | — |
| `AN` | — | — | Kann | — |
| `AO` | — | — | Kann | — |
| `AQ` | — | — | Kann | — |
| `AR` | — | — | Kann | — |
| `AS` | — | — | Kann | — |
| `AT` | — | — | Kann | — |
| `AU` | — | — | Kann | — |
| `AW` | — | — | Kann | — |
| `AX` | — | — | Kann | — |
| `AZ` | — | — | Kann | — |
| `BA` | — | — | Kann | — |
| `BB` | — | — | Kann | — |
| `BD` | — | — | Kann | — |
| `BE` | — | — | Kann | — |
| `BF` | — | — | Kann | — |
| `BG` | — | — | Kann | — |
| `BH` | — | — | Kann | — |
| `BI` | — | — | Kann | — |
| `BJ` | — | — | Kann | — |
| `BL` | — | — | Kann | — |
| `BM` | — | — | Kann | — |
| `BN` | — | — | Kann | — |
| `BO` | — | — | Kann | — |
| `BQ` | — | — | Kann | — |
| `BR` | — | — | Kann | — |
| `BS` | — | — | Kann | — |
| `BT` | — | — | Kann | — |
| `BU` | — | — | Kann | — |
| `BV` | — | — | Kann | — |
| `BW` | — | — | Kann | — |
| `BY` | — | — | Kann | — |
| `BZ` | — | — | Kann | — |
| `CA` | — | — | Kann | — |
| `CC` | — | — | Kann | — |
| `CD` | — | — | Kann | — |
| `CF` | — | — | Kann | — |
| `CG` | — | — | Kann | — |
| `CH` | — | — | Kann | — |
| `CI` | — | — | Kann | — |
| `CK` | — | — | Kann | — |
| `CL` | — | — | Kann | — |
| `CM` | — | — | Kann | — |
| `CN` | — | — | Kann | — |
| `CO` | — | — | Kann | — |
| `CP` | — | — | Kann | — |
| `CR` | — | — | Kann | — |
| `CS` | — | — | Kann | — |
| `CU` | — | — | Kann | — |
| `CV` | — | — | Kann | — |
| `CW` | — | — | Kann | — |
| `CX` | — | — | Kann | — |
| `CY` | — | — | Kann | — |
| `CZ` | — | — | Kann | — |
| `DE` | — | — | Kann | — |
| `DG` | — | — | Kann | — |
| `DJ` | — | — | Kann | — |
| `DK` | — | — | Kann | — |
| `DM` | — | — | Kann | — |
| `DO` | — | — | Kann | — |
| `DZ` | — | — | Kann | — |
| `EA` | — | — | Kann | — |
| `EC` | — | — | Kann | — |
| `EE` | — | — | Kann | — |
| `EG` | — | — | Kann | — |
| `EH` | — | — | Kann | — |
| `ER` | — | — | Kann | — |
| `ES` | — | — | Kann | — |
| `ET` | — | — | Kann | — |
| `EU` | — | — | Kann | — |
| `FI` | — | — | Kann | — |
| `FJ` | — | — | Kann | — |
| `FK` | — | — | Kann | — |
| `FM` | — | — | Kann | — |
| `FO` | — | — | Kann | — |
| `FR` | — | — | Kann | — |
| `FX` | — | — | Kann | — |
| `GA` | — | — | Kann | — |
| `GB` | — | — | Kann | — |
| `GD` | — | — | Kann | — |
| `GE` | — | — | Kann | — |
| `GF` | — | — | Kann | — |
| `GG` | — | — | Kann | — |
| `GH` | — | — | Kann | — |
| `GI` | — | — | Kann | — |
| `GL` | — | — | Kann | — |
| `GM` | — | — | Kann | — |
| `GN` | — | — | Kann | — |
| `GP` | — | — | Kann | — |
| `GQ` | — | — | Kann | — |
| `GR` | — | — | Kann | — |
| `GS` | — | — | Kann | — |
| `GT` | — | — | Kann | — |
| `GU` | — | — | Kann | — |
| `GW` | — | — | Kann | — |
| `GY` | — | — | Kann | — |
| `HK` | — | — | Kann | — |
| `HM` | — | — | Kann | — |
| `HN` | — | — | Kann | — |
| `HR` | — | — | Kann | — |
| `HT` | — | — | Kann | — |
| `HU` | — | — | Kann | — |
| `IC` | — | — | Kann | — |
| `ID` | — | — | Kann | — |
| `IE` | — | — | Kann | — |
| `IL` | — | — | Kann | — |
| `IM` | — | — | Kann | — |
| `IN` | — | — | Kann | — |
| `IO` | — | — | Kann | — |
| `IQ` | — | — | Kann | — |
| `IR` | — | — | Kann | — |
| `IS` | — | — | Kann | — |
| `IT` | — | — | Kann | — |
| `JE` | — | — | Kann | — |
| `JM` | — | — | Kann | — |
| `JO` | — | — | Kann | — |
| `JP` | — | — | Kann | — |
| `KE` | — | — | Kann | — |
| `KG` | — | — | Kann | — |
| `KH` | — | — | Kann | — |
| `KI` | — | — | Kann | — |
| `KM` | — | — | Kann | — |
| `KN` | — | — | Kann | — |
| `KP` | — | — | Kann | — |
| `KR` | — | — | Kann | — |
| `KW` | — | — | Kann | — |
| `KY` | — | — | Kann | — |
| `KZ` | — | — | Kann | — |
| `LA` | — | — | Kann | — |
| `LB` | — | — | Kann | — |
| `LC` | — | — | Kann | — |
| `LI` | — | — | Kann | — |
| `LK` | — | — | Kann | — |
| `LR` | — | — | Kann | — |
| `LS` | — | — | Kann | — |
| `LT` | — | — | Kann | — |
| `LU` | — | — | Kann | — |
| `LV` | — | — | Kann | — |
| `LY` | — | — | Kann | — |
| `MA` | — | — | Kann | — |
| `MC` | — | — | Kann | — |
| `MD` | — | — | Kann | — |
| `ME` | — | — | Kann | — |
| `MF` | — | — | Kann | — |
| `MG` | — | — | Kann | — |
| `MH` | — | — | Kann | — |
| `MK` | — | — | Kann | — |
| `ML` | — | — | Kann | — |
| `MM` | — | — | Kann | — |
| `MN` | — | — | Kann | — |
| `MO` | — | — | Kann | — |
| `MP` | — | — | Kann | — |
| `MQ` | — | — | Kann | — |
| `MR` | — | — | Kann | — |
| `MS` | — | — | Kann | — |
| `MT` | — | — | Kann | — |
| `MU` | — | — | Kann | — |
| `MV` | — | — | Kann | — |
| `MW` | — | — | Kann | — |
| `MX` | — | — | Kann | — |
| `MY` | — | — | Kann | — |
| `MZ` | — | — | Kann | — |
| `NA` | — | — | Kann | — |
| `NC` | — | — | Kann | — |
| `NE` | — | — | Kann | — |
| `NF` | — | — | Kann | — |
| `NG` | — | — | Kann | — |
| `NI` | — | — | Kann | — |
| `NL` | — | — | Kann | — |
| `NO` | — | — | Kann | — |
| `NP` | — | — | Kann | — |
| `NR` | — | — | Kann | — |
| `NT` | — | — | Kann | — |
| `NU` | — | — | Kann | — |
| `NZ` | — | — | Kann | — |
| `OM` | — | — | Kann | — |
| `PA` | — | — | Kann | — |
| `PE` | — | — | Kann | — |
| `PF` | — | — | Kann | — |
| `PG` | — | — | Kann | — |
| `PH` | — | — | Kann | — |
| `PK` | — | — | Kann | — |
| `PL` | — | — | Kann | — |
| `PM` | — | — | Kann | — |
| `PN` | — | — | Kann | — |
| `PR` | — | — | Kann | — |
| `PS` | — | — | Kann | — |
| `PT` | — | — | Kann | — |
| `PW` | — | — | Kann | — |
| `PY` | — | — | Kann | — |
| `QA` | — | — | Kann | — |
| `RE` | — | — | Kann | — |
| `RO` | — | — | Kann | — |
| `RS` | — | — | Kann | — |
| `RU` | — | — | Kann | — |
| `RW` | — | — | Kann | — |
| `SA` | — | — | Kann | — |
| `SB` | — | — | Kann | — |
| `SC` | — | — | Kann | — |
| `SD` | — | — | Kann | — |
| `SE` | — | — | Kann | — |
| `SF` | — | — | Kann | — |
| `SG` | — | — | Kann | — |
| `SH` | — | — | Kann | — |
| `SI` | — | — | Kann | — |
| `SJ` | — | — | Kann | — |
| `SK` | — | — | Kann | — |
| `SL` | — | — | Kann | — |
| `SM` | — | — | Kann | — |
| `SN` | — | — | Kann | — |
| `SO` | — | — | Kann | — |
| `SR` | — | — | Kann | — |
| `SS` | — | — | Kann | — |
| `ST` | — | — | Kann | — |
| `SU` | — | — | Kann | — |
| `SV` | — | — | Kann | — |
| `SX` | — | — | Kann | — |
| `SY` | — | — | Kann | — |
| `SZ` | — | — | Kann | — |
| `TA` | — | — | Kann | — |
| `TC` | — | — | Kann | — |
| `TD` | — | — | Kann | — |
| `TF` | — | — | Kann | — |
| `TG` | — | — | Kann | — |
| `TJ` | — | — | Kann | — |
| `TK` | — | — | Kann | — |
| `TL` | — | — | Kann | — |
| `TM` | — | — | Kann | — |
| `TN` | — | — | Kann | — |
| `TO` | — | — | Kann | — |
| `TP` | — | — | Kann | — |
| `TR` | — | — | Kann | — |
| `TT` | — | — | Kann | — |
| `TV` | — | — | Kann | — |
| `TW` | — | — | Kann | — |
| `TZ` | — | — | Kann | — |
| `UA` | — | — | Kann | — |
| `UG` | — | — | Kann | — |
| `UK` | — | — | Kann | — |
| `UM` | — | — | Kann | — |
| `US` | — | — | Kann | — |
| `UY` | — | — | Kann | — |
| `UZ` | — | — | Kann | — |
| `VA` | — | — | Kann | — |
| `VC` | — | — | Kann | — |
| `VE` | — | — | Kann | — |
| `VG` | — | — | Kann | — |
| `VI` | — | — | Kann | — |
| `VN` | — | — | Kann | — |
| `VU` | — | — | Kann | — |
| `WF` | — | — | Kann | — |
| `WS` | — | — | Kann | — |
| `XK` | — | — | Kann | — |
| `YE` | — | — | Kann | — |
| `YT` | — | — | Kann | — |
| `YU` | — | — | Kann | — |
| `ZA` | — | — | Kann | — |
| `ZM` | — | — | Kann | — |
| `ZR` | — | — | Kann | — |
| `ZW` | — | — | Kann | — |
| [ort](/bo4e/202610/com/Adresse#ort)00190 | Ort | string | Kann | — |
| [ortsteil](/bo4e/202610/com/Adresse#ortsteil)00200 | Ortsteil | string | Kann | — |
| [postfach](/bo4e/202610/com/Adresse#postfach)00210 | Postfach | string | Kann | — |
| [postleitzahl](/bo4e/202610/com/Adresse#postleitzahl)00220 | Postleitzahl | string | Kann | — |
| [strasse](/bo4e/202610/com/Adresse#strasse)00230 | Strasse | string | Kann | — |
| **zusatzInformation** | — | object | Kann | — |
| [zusatz1](/bo4e/202610/com/AdresszusatzInformation#zusatz1)00240 | Adresszusatz 1 | string | Kann | — |
| [zusatz2](/bo4e/202610/com/AdresszusatzInformation#zusatz2)00250 | Adresszusatz 2 | string | Kann | — |
| [zusatz3](/bo4e/202610/com/AdresszusatzInformation#zusatz3)00260 | Adresszusatz 3 | string | Kann | — |
| [zusatz4](/bo4e/202610/com/AdresszusatzInformation#zusatz4)00270 | Adresszusatz 4 | string | Kann | — |
| [zusatz5](/bo4e/202610/com/AdresszusatzInformation#zusatz5)00280 | Adresszusatz 5 | string | Kann | — |
| **ZAEHLER** [ ] | — | object[] | Kann | — |
| **geraete** [ ] | — | object[] | Kann | — |
| [geraetenummer](/bo4e/202610/com/Geraet#geraetenummer)00290 | Die auf dem Geräte aufgedruckte Nummer, die vom MSB vergeben wird. | string | Kann | — |
## Kette dieses Auslösers
Das Ereignis löst die Nachricht aus. Der Marktpartner antwortet mit einer der genannten Antworten, und danach schreibt die MACO APP den Vorgang in Ihr Backendsystem.
| Nachricht | Antworten | Schreibaufruf nach der Antwort |
|---|---|---|
| [17101](/schnittstellen/202610/pruefi/ORDERS/PI_17101) | [19101](/schnittstellen/202610/pruefi/ORDRSP/PI_19101), [44035](/schnittstellen/202610/pruefi/UTILMD_GAS/PI_44035) | `POST /updateProcessData` (abgeleitet) |
Dieses Ereignis löst einen Schritt in dieser Rollensicht aus:
| Prozess | Beteiligter | Regelwerk | Sparte |
|---|---|---|---|
| [Geschäftsdatenanfrage vom LF an NB](/prozessdoku/202610/LF/geli-gas-2-0-geschaftsdatenanfrage-vom-lf-an-nb) | LF | GeLi Gas 2.0 | Gas |
## Transaktionsdaten
Der Umschlag der Nachricht. Pflichtfelder müssen beim Trigger-Aufruf gesetzt sein.
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| [kategorie](/bo4e/202610/cdoc/Transaktionsdaten#kategorie) | string | **ja** | Qualifier aus dem Beginn der EDIFact Nachricht / BGM |
| [sparte](/bo4e/202610/cdoc/Transaktionsdaten#sparte) | [Enum Sparte](/bo4e/202610/enum/Sparte) | **ja** | Enthält Informationen über die Sparte Werte: `STROM`, `GAS`, `FERNWAERME`, `NAHWAERME`, `WASSER`, `ABWASSER` |
| `pruefidentifikator` | — | nein | Wird dynamisch im Event-Prozess ermittelt. Ein vom Sender mitgegebener Wert wird ignoriert. Im Topic mögliche Prüfis — 17101. Mögliche Werte: `17101` |
| [absender › rollencodenummer](/bo4e/202610/bo/Marktteilnehmer#rollencodenummer) | string | nein | Gibt die Codenummer der Marktrolle an. |
| [empfaenger › rollencodenummer](/bo4e/202610/bo/Marktteilnehmer#rollencodenummer) | string | nein | Gibt die Codenummer der Marktrolle an. |
## Zusatzdaten
`eventname` ist auf **START_ANFRAGE_STAMMDATEN_MALO** festgelegt. Dieser Wert bleibt auch in der englischen Fassung deutsch, weil Camunda darüber korreliert.
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `prozessId` | string | **ja** | — |
| `eventname` | const `START_ANFRAGE_STAMMDATEN_MALO` | **ja** | — |
## Antwort
**Der Auslöser vergibt einen eigenen `businessKey`.** Die MACO APP übernimmt **weder** den `businessKey` **noch** die `prozessId` des aufrufenden Systems als Kennung der Prozessinstanz. Der `businessKey` der Antwort entsteht beim Start des Prozesses und ist neu. Der Rumpf dieses Aufrufs führt kein Feld `businessKey`; es gibt also keine Stelle, an der ein eigener Schlüssel mitgegeben werden könnte. Die mitgegebene `prozessId` (Pflichtfeld dieses Aufrufs) bleibt die Belegnummer des Backends: sie kommt in `zusatzdaten.prozessId` der Callbacks zurück — dort Pflicht nur bei MaloIdent (03002/03003), sonst optional.
**201 — Erfolg.** Erfolgsmeldung auf Prozessdaten API Aufruf.
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `businessKey` | string (uuid) | **ja** | Einzigartige Kennung des Geschäftsprozesses |
| `message` | string | **ja** | Nachricht mit Details zum ausgelösten Event — Beispiel der Quelle: `received event XXXXXXXXXXXX with id at 2024-08-08T12:58:22Z and started process with businessKey 4c7170ed-3518-41ee-8582-39ab65b00107` |
**400 — Fehler.** Fehlermeldung auf Prozessdaten API Aufruf.
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `errorCode` | string | nein | Error identifier — Beispiel der Quelle: `400` |
| `message` | string | nein | Technische Meldung — Beispiel der Quelle: `Validation Failed` |
Welchen Rumpf die Callbacks `updateProcessData` und `createProcessData` senden, ist am NiFi-Fluss der MACO APP gemessen: `{stammdaten, transaktionsdaten, zusatzdaten}` ohne Umschlag, der `businessKey` innerhalb von `zusatzdaten`. Nicht gemessen ist das an einem mitgeschnittenen Aufruf, und nicht für MaloIdent (03002/03003).
Was `businessKey`, `prozessId` und `targetBusinessKey` unterscheidet, steht auf [Schlüssel und Zuordnung](/schnittstellen/schluessel).