[MSB] START_GESCHAEFTSDATENANFRAGE
Marktrolle MSB · Formatversion 202604 · BO4E-Schema 1.7.8
Stammdaten
Unter diesem Topic ist genau einer der folgenden 3 Prüfidentifikatoren zulässig — welcher, entscheidet der Event-Prozess.
| Prüfi | Scope | Anwendungsfall | Festlegung | Kommunikation |
|---|---|---|---|---|
| PI_17104 | ORDERS | Anfrage vom MSB Gas | GPKE Teil 4 | MSB (Gas) → NB (Strom) |
| PI_17126 | ORDERS | Anfrage Stammdaten Messlokation (Gas) | GeLi Gas 2.0 | MSB (Strom / Gas) → NB |
| PI_17132 | ORDERS | Anfrage Stammdaten (Strom) | GPKE Teil 4 | LF → NB |
Die Stammdaten der 3 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 | 17104 | 17126 | 17132 | Bedingung |
|---|---|---|---|---|---|---|
| stammdaten | — | object | Kann | Kann | Kann | — |
| ANFRAGE [ ] | — | object[] | Kann | Kann | Muss | — |
| lokationsId00010 | Für welche Markt- oder Messlokation gilt diese Anfrage. | string | Kann | Kann | Muss | — |
| MESSLOKATION [ ] | — | object[] | Kann | Kann | — | — |
| messadresse | — | object | Kann | Kann | — | — |
| hausnummer00020 | Hausnummer und Ergänzung | string | Kann | Kann | — | — |
| landescode00030 | Landescode | Enum Landescode | Kann | Kann | — | — |
AC | — | — | Kann | Kann | — | — |
AD | — | — | Kann | Kann | — | — |
AE | — | — | Kann | Kann | — | — |
AF | — | — | Kann | Kann | — | — |
AG | — | — | Kann | Kann | — | — |
AI | — | — | Kann | Kann | — | — |
AL | — | — | Kann | Kann | — | — |
AM | — | — | Kann | Kann | — | — |
AN | — | — | Kann | Kann | — | — |
AO | — | — | Kann | Kann | — | — |
AQ | — | — | Kann | Kann | — | — |
AR | — | — | Kann | Kann | — | — |
AS | — | — | Kann | Kann | — | — |
AT | — | — | Kann | Kann | — | — |
AU | — | — | Kann | Kann | — | — |
AW | — | — | Kann | Kann | — | — |
AX | — | — | Kann | Kann | — | — |
AZ | — | — | Kann | Kann | — | — |
BA | — | — | Kann | Kann | — | — |
BB | — | — | Kann | Kann | — | — |
BD | — | — | Kann | Kann | — | — |
BE | — | — | Kann | Kann | — | — |
BF | — | — | Kann | Kann | — | — |
BG | — | — | Kann | Kann | — | — |
BH | — | — | Kann | Kann | — | — |
BI | — | — | Kann | Kann | — | — |
BJ | — | — | Kann | Kann | — | — |
BL | — | — | Kann | Kann | — | — |
BM | — | — | Kann | Kann | — | — |
BN | — | — | Kann | Kann | — | — |
BO | — | — | Kann | Kann | — | — |
BQ | — | — | Kann | Kann | — | — |
BR | — | — | Kann | Kann | — | — |
BS | — | — | Kann | Kann | — | — |
BT | — | — | Kann | Kann | — | — |
BU | — | — | Kann | Kann | — | — |
BV | — | — | Kann | Kann | — | — |
BW | — | — | Kann | Kann | — | — |
BY | — | — | Kann | Kann | — | — |
BZ | — | — | Kann | Kann | — | — |
CA | — | — | Kann | Kann | — | — |
CC | — | — | Kann | Kann | — | — |
CD | — | — | Kann | Kann | — | — |
CF | — | — | Kann | Kann | — | — |
CG | — | — | Kann | Kann | — | — |
CH | — | — | Kann | Kann | — | — |
CI | — | — | Kann | Kann | — | — |
CK | — | — | Kann | Kann | — | — |
CL | — | — | Kann | Kann | — | — |
CM | — | — | Kann | Kann | — | — |
CN | — | — | Kann | Kann | — | — |
CO | — | — | Kann | Kann | — | — |
CP | — | — | Kann | Kann | — | — |
CR | — | — | Kann | Kann | — | — |
CS | — | — | Kann | Kann | — | — |
CU | — | — | Kann | Kann | — | — |
CV | — | — | Kann | Kann | — | — |
CW | — | — | Kann | Kann | — | — |
CX | — | — | Kann | Kann | — | — |
CY | — | — | Kann | Kann | — | — |
CZ | — | — | Kann | Kann | — | — |
DE | — | — | Kann | Kann | — | — |
DG | — | — | Kann | Kann | — | — |
DJ | — | — | Kann | Kann | — | — |
DK | — | — | Kann | Kann | — | — |
DM | — | — | Kann | Kann | — | — |
DO | — | — | Kann | Kann | — | — |
DZ | — | — | Kann | Kann | — | — |
EA | — | — | Kann | Kann | — | — |
EC | — | — | Kann | Kann | — | — |
EE | — | — | Kann | Kann | — | — |
EG | — | — | Kann | Kann | — | — |
EH | — | — | Kann | Kann | — | — |
ER | — | — | Kann | Kann | — | — |
ES | — | — | Kann | Kann | — | — |
ET | — | — | Kann | Kann | — | — |
EU | — | — | Kann | Kann | — | — |
FI | — | — | Kann | Kann | — | — |
FJ | — | — | Kann | Kann | — | — |
FK | — | — | Kann | Kann | — | — |
FM | — | — | Kann | Kann | — | — |
FO | — | — | Kann | Kann | — | — |
FR | — | — | Kann | Kann | — | — |
FX | — | — | Kann | Kann | — | — |
GA | — | — | Kann | Kann | — | — |
GB | — | — | Kann | Kann | — | — |
GD | — | — | Kann | Kann | — | — |
GE | — | — | Kann | Kann | — | — |
GF | — | — | Kann | Kann | — | — |
GG | — | — | Kann | Kann | — | — |
GH | — | — | Kann | Kann | — | — |
GI | — | — | Kann | Kann | — | — |
GL | — | — | Kann | Kann | — | — |
GM | — | — | Kann | Kann | — | — |
GN | — | — | Kann | Kann | — | — |
GP | — | — | Kann | Kann | — | — |
GQ | — | — | Kann | Kann | — | — |
GR | — | — | Kann | Kann | — | — |
GS | — | — | Kann | Kann | — | — |
GT | — | — | Kann | Kann | — | — |
GU | — | — | Kann | Kann | — | — |
GW | — | — | Kann | Kann | — | — |
GY | — | — | Kann | Kann | — | — |
HK | — | — | Kann | Kann | — | — |
HM | — | — | Kann | Kann | — | — |
HN | — | — | Kann | Kann | — | — |
HR | — | — | Kann | Kann | — | — |
HT | — | — | Kann | Kann | — | — |
HU | — | — | Kann | Kann | — | — |
IC | — | — | Kann | Kann | — | — |
ID | — | — | Kann | Kann | — | — |
IE | — | — | Kann | Kann | — | — |
IL | — | — | Kann | Kann | — | — |
IM | — | — | Kann | Kann | — | — |
IN | — | — | Kann | Kann | — | — |
IO | — | — | Kann | Kann | — | — |
IQ | — | — | Kann | Kann | — | — |
IR | — | — | Kann | Kann | — | — |
IS | — | — | Kann | Kann | — | — |
IT | — | — | Kann | Kann | — | — |
JE | — | — | Kann | Kann | — | — |
JM | — | — | Kann | Kann | — | — |
JO | — | — | Kann | Kann | — | — |
JP | — | — | Kann | Kann | — | — |
KE | — | — | Kann | Kann | — | — |
KG | — | — | Kann | Kann | — | — |
KH | — | — | Kann | Kann | — | — |
KI | — | — | Kann | Kann | — | — |
KM | — | — | Kann | Kann | — | — |
KN | — | — | Kann | Kann | — | — |
KP | — | — | Kann | Kann | — | — |
KR | — | — | Kann | Kann | — | — |
KW | — | — | Kann | Kann | — | — |
KY | — | — | Kann | Kann | — | — |
KZ | — | — | Kann | Kann | — | — |
LA | — | — | Kann | Kann | — | — |
LB | — | — | Kann | Kann | — | — |
LC | — | — | Kann | Kann | — | — |
LI | — | — | Kann | Kann | — | — |
LK | — | — | Kann | Kann | — | — |
LR | — | — | Kann | Kann | — | — |
LS | — | — | Kann | Kann | — | — |
LT | — | — | Kann | Kann | — | — |
LU | — | — | Kann | Kann | — | — |
LV | — | — | Kann | Kann | — | — |
LY | — | — | Kann | Kann | — | — |
MA | — | — | Kann | Kann | — | — |
MC | — | — | Kann | Kann | — | — |
MD | — | — | Kann | Kann | — | — |
ME | — | — | Kann | Kann | — | — |
MF | — | — | Kann | Kann | — | — |
MG | — | — | Kann | Kann | — | — |
MH | — | — | Kann | Kann | — | — |
MK | — | — | Kann | Kann | — | — |
ML | — | — | Kann | Kann | — | — |
MM | — | — | Kann | Kann | — | — |
MN | — | — | Kann | Kann | — | — |
MO | — | — | Kann | Kann | — | — |
MP | — | — | Kann | Kann | — | — |
MQ | — | — | Kann | Kann | — | — |
MR | — | — | Kann | Kann | — | — |
MS | — | — | Kann | Kann | — | — |
MT | — | — | Kann | Kann | — | — |
MU | — | — | Kann | Kann | — | — |
MV | — | — | Kann | Kann | — | — |
MW | — | — | Kann | Kann | — | — |
MX | — | — | Kann | Kann | — | — |
MY | — | — | Kann | Kann | — | — |
MZ | — | — | Kann | Kann | — | — |
NA | — | — | Kann | Kann | — | — |
NC | — | — | Kann | Kann | — | — |
NE | — | — | Kann | Kann | — | — |
NF | — | — | Kann | Kann | — | — |
NG | — | — | Kann | Kann | — | — |
NI | — | — | Kann | Kann | — | — |
NL | — | — | Kann | Kann | — | — |
NO | — | — | Kann | Kann | — | — |
NP | — | — | Kann | Kann | — | — |
NR | — | — | Kann | Kann | — | — |
NT | — | — | Kann | Kann | — | — |
NU | — | — | Kann | Kann | — | — |
NZ | — | — | Kann | Kann | — | — |
OM | — | — | Kann | Kann | — | — |
PA | — | — | Kann | Kann | — | — |
PE | — | — | Kann | Kann | — | — |
PF | — | — | Kann | Kann | — | — |
PG | — | — | Kann | Kann | — | — |
PH | — | — | Kann | Kann | — | — |
PK | — | — | Kann | Kann | — | — |
PL | — | — | Kann | Kann | — | — |
PM | — | — | Kann | Kann | — | — |
PN | — | — | Kann | Kann | — | — |
PR | — | — | Kann | Kann | — | — |
PS | — | — | Kann | Kann | — | — |
PT | — | — | Kann | Kann | — | — |
PW | — | — | Kann | Kann | — | — |
PY | — | — | Kann | Kann | — | — |
QA | — | — | Kann | Kann | — | — |
RE | — | — | Kann | Kann | — | — |
RO | — | — | Kann | Kann | — | — |
RS | — | — | Kann | Kann | — | — |
RU | — | — | Kann | Kann | — | — |
RW | — | — | Kann | Kann | — | — |
SA | — | — | Kann | Kann | — | — |
SB | — | — | Kann | Kann | — | — |
SC | — | — | Kann | Kann | — | — |
SD | — | — | Kann | Kann | — | — |
SE | — | — | Kann | Kann | — | — |
SF | — | — | Kann | Kann | — | — |
SG | — | — | Kann | Kann | — | — |
SH | — | — | Kann | Kann | — | — |
SI | — | — | Kann | Kann | — | — |
SJ | — | — | Kann | Kann | — | — |
SK | — | — | Kann | Kann | — | — |
SL | — | — | Kann | Kann | — | — |
SM | — | — | Kann | Kann | — | — |
SN | — | — | Kann | Kann | — | — |
SO | — | — | Kann | Kann | — | — |
SR | — | — | Kann | Kann | — | — |
SS | — | — | Kann | Kann | — | — |
ST | — | — | Kann | Kann | — | — |
SU | — | — | Kann | Kann | — | — |
SV | — | — | Kann | Kann | — | — |
SX | — | — | Kann | Kann | — | — |
SY | — | — | Kann | Kann | — | — |
SZ | — | — | Kann | Kann | — | — |
TA | — | — | Kann | Kann | — | — |
TC | — | — | Kann | Kann | — | — |
TD | — | — | Kann | Kann | — | — |
TF | — | — | Kann | Kann | — | — |
TG | — | — | Kann | Kann | — | — |
TJ | — | — | Kann | Kann | — | — |
TK | — | — | Kann | Kann | — | — |
TL | — | — | Kann | Kann | — | — |
TM | — | — | Kann | Kann | — | — |
TN | — | — | Kann | Kann | — | — |
TO | — | — | Kann | Kann | — | — |
TP | — | — | Kann | Kann | — | — |
TR | — | — | Kann | Kann | — | — |
TT | — | — | Kann | Kann | — | — |
TV | — | — | Kann | Kann | — | — |
TW | — | — | Kann | Kann | — | — |
TZ | — | — | Kann | Kann | — | — |
UA | — | — | Kann | Kann | — | — |
UG | — | — | Kann | Kann | — | — |
UK | — | — | Kann | Kann | — | — |
UM | — | — | Kann | Kann | — | — |
US | — | — | Kann | Kann | — | — |
UY | — | — | Kann | Kann | — | — |
UZ | — | — | Kann | Kann | — | — |
VA | — | — | Kann | Kann | — | — |
VC | — | — | Kann | Kann | — | — |
VE | — | — | Kann | Kann | — | — |
VG | — | — | Kann | Kann | — | — |
VI | — | — | Kann | Kann | — | — |
VN | — | — | Kann | Kann | — | — |
VU | — | — | Kann | Kann | — | — |
WF | — | — | Kann | Kann | — | — |
WS | — | — | Kann | Kann | — | — |
XK | — | — | Kann | Kann | — | — |
YE | — | — | Kann | Kann | — | — |
YT | — | — | Kann | Kann | — | — |
YU | — | — | Kann | Kann | — | — |
ZA | — | — | Kann | Kann | — | — |
ZM | — | — | Kann | Kann | — | — |
ZR | — | — | Kann | Kann | — | — |
ZW | — | — | Kann | Kann | — | — |
| ort00040 | Ort | string | Kann | Kann | — | — |
| ortsteil00050 | Ortsteil | string | Kann | Kann | — | — |
| postfach00060 | Postfach | string | Kann | Kann | — | — |
| postleitzahl00070 | Postleitzahl | string | Kann | Kann | — | — |
| strasse00080 | Strasse | string | Kann | Kann | — | — |
| zusatzInformation | — | object | Kann | Kann | — | — |
| zusatz100090 | Adresszusatz 1 | string | Kann | Kann | — | — |
| zusatz200100 | Adresszusatz 2 | string | Kann | Kann | — | — |
| zusatz300110 | Adresszusatz 3 | string | Kann | Kann | — | — |
| zusatz400120 | Adresszusatz 4 | string | Kann | Kann | — | — |
| zusatz500130 | Adresszusatz 5 | string | Kann | Kann | — | — |
| AUFTRAG [ ] | — | object[] | — | Kann | — | — |
| positionsdaten [ ] | — | object[] | — | Kann | — | — |
| allgemeineInformationen | — | object | — | Kann | — | — |
| info100140 | Allgemeine Info 1 | string | — | Kann | — | — |
| info200150 | Allgemeine Info 2 | string | — | Kann | — | — |
| info300160 | Allgemeine Info 3 | string | — | Kann | — | — |
| info400170 | Allgemeine Info 4 | string | — | Kann | — | — |
| info500180 | Allgemeine Info 5 | string | — | Kann | — | — |
| MESSSTELLENBETRIEBSVERTRAG [ ] | — | object[] | — | Kann | — | — |
| vertragspartner2 [ ] | — | object[] | — | Kann | — | — |
| anrede00190 | Die Anrede für den GePa, Z.B. Herr. | string | — | Kann | — | — |
| geschaeftspartnerrolle00200 | Rolle, die der Geschäftspartner hat (z.B. Interessent, Kunde). | array | — | Kann | — | — |
| gewerbekennzeichnung00210 | Kennzeichnung ob es sich um einen Gewerbe/Unternehmen (gewerbeKennzeichnung = true) oder eine Privatperson handelt. (gewerbeKennzeichnung = false) | boolean | — | Kann | — | — |
| name100220 | Erster Teil des Namens. Hier kann der Firmenname oder bei Privatpersonen beispielsweise der Nachname dargestellt werden. Beispiele: Yellow Strom GmbH oder Hagen | string | — | Kann | — | — |
| name200230 | 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 | — | — |
| name300240 | 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 | — | — |
| name400250 | name4 | string | — | Kann | — | — |
| ZAEHLER [ ] | — | object[] | — | Kann | — | — |
| geraete [ ] | — | object[] | — | Kann | — | — |
| geraetenummer00260 | 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 |
|---|---|---|
| 17104 | — | — |
| 17126 | 44060 | POST /updateProcessData |
| 17132 | — | — |
Dieses Ereignis löst einen Schritt in dieser Rollensicht aus:
| Prozess | Beteiligter | Regelwerk | Sparte |
|---|---|---|---|
| Geschäftsdatenanfrage vom MSB an NB | MSB | GeLi Gas 2.0 | Gas |
Transaktionsdaten
Der Umschlag der Nachricht. Pflichtfelder müssen beim Trigger-Aufruf gesetzt sein.
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| kategorie | string | ja | Qualifier aus dem Beginn der EDIFact Nachricht / BGM |
| sparte | Enum Sparte | ja | Enthält Informationen über die Sparte Werte: STROM, GAS, FERNWAERME, NAHWAERME, WASSER, ABWASSER |
pruefidentifikator | — | nein | Wird dynamisch im Event-Prozess ermittelt (Entscheidungsgrundlage: kategorie, sparte). Ein vom Sender mitgegebener Wert wird ignoriert. Im Topic mögliche Prüfis — 17104, 17126, 17132. Mögliche Werte: 17104, 17126, 17132 |
| absender › rollencodenummer | string | nein | Gibt die Codenummer der Marktrolle an. |
| empfaenger › rollencodenummer | string | nein | Gibt die Codenummer der Marktrolle an. |
Zusatzdaten
eventname ist auf START_GESCHAEFTSDATENANFRAGE 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_GESCHAEFTSDATENANFRAGE | 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.