# [MSB] START_ANTWORT_GERAETEWECHSEL
Marktrolle **MSB** · Formatversion **202610** · BO4E-Schema **1.7.8**
:::caution{title="Noch nicht abgebildete Prüfidentifikatoren"}
Für dieses Topic sind die folgenden Prüfidentifikatoren fachlich vorgesehen, aber in der aktuellen Formatversion noch nicht als Spezifikation vorhanden: `19016`.
Die Angabe stammt aus der Generator-Pipeline und wird hier bewusst sichtbar gemacht, statt sie zu verschweigen.
:::
## 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_19015](/schnittstellen/202610/pruefi/ORDRSP/PI_19015) | ORDRSP | Bestätigung Gerätewechselabsicht | WiM Strom Teil 1 | MSB (entspricht MSBA am Objekt Messlokation) → MSB (entspricht MSBN am Objekt Messlokation) |
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 | 19015 | Bedingung |
|---|---|---|---|---|
| **stammdaten** | — | object | Kann | — |
| **AUFTRAG** [ ] | — | object[] | Kann | — |
| **lieferadresseAltgeraete** | — | object | Kann | — |
| [anrede](/bo4e/202610/bo/Geschaeftspartner#anrede)00010 | Die Anrede für den GePa, Z.B. Herr. | string | Kann | — |
| [gewerbekennzeichnung](/bo4e/202610/bo/Geschaeftspartner#gewerbekennzeichnung)00020 | Kennzeichnung ob es sich um einen Gewerbe/Unternehmen (gewerbeKennzeichnung = true)
oder eine Privatperson handelt. (gewerbeKennzeichnung = false) | boolean | Kann | — |
| [name1](/bo4e/202610/bo/Geschaeftspartner#name1)00030 | 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)00040 | 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)00050 | 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)00060 | name4 | string | Kann | — |
| **partneradresse** | — | object | Kann | — |
| [hausnummer](/bo4e/202610/com/Adresse#hausnummer)00070 | Hausnummer und Ergänzung | string | Kann | — |
| [landescode](/bo4e/202610/com/Adresse#landescode)00080 | 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)00090 | Ort | string | Kann | — |
| [ortsteil](/bo4e/202610/com/Adresse#ortsteil)00100 | Ortsteil | string | Kann | — |
| [postfach](/bo4e/202610/com/Adresse#postfach)00110 | Postfach | string | Kann | — |
| [postleitzahl](/bo4e/202610/com/Adresse#postleitzahl)00120 | Postleitzahl | string | Kann | — |
| [strasse](/bo4e/202610/com/Adresse#strasse)00130 | Strasse | string | Kann | — |
## Kette dieses Auslösers
Das Ereignis löst die Nachricht aus.
| Nachricht | Antworten | Schreibaufruf nach der Antwort |
|---|---|---|
| [19015](/schnittstellen/202610/pruefi/ORDRSP/PI_19015) | — | — |
| [19016](/schnittstellen/202610/pruefi/ORDRSP/PI_19016) | — | — |
Dieses Ereignis löst Schritte in diesen Rollensichten aus:
| Prozess | Beteiligter | Regelwerk | Sparte |
|---|---|---|---|
| [Gerätewechsel](/prozessdoku/202610/MSB--MSBA/awh-wim-gas-2-0-geratewechsel) | MSBA | AWH WiM Gas 2.0 | Gas |
| [Gerätewechsel](/prozessdoku/202610/MSB--MSBA/WiM-Teil1-geraetewechsel) | MSBA | WiM Strom Teil 1 | Strom |
## Transaktionsdaten
Der Umschlag der Nachricht. Pflichtfelder müssen beim Trigger-Aufruf gesetzt sein.
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| [antwortstatus](/bo4e/202610/cdoc/Transaktionsdaten#antwortstatus) | string | **ja** | Antwortstatus / STS+E01 |
| [antwortstatusCodeliste](/bo4e/202610/cdoc/Transaktionsdaten#antwortstatuscodeliste) | string | **ja** | Antwortstatus Codeliste / STS+E01 |
| [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 (Entscheidungsgrundlage: antwortstatus). Ein vom Sender mitgegebener Wert wird ignoriert. Im Topic mögliche Prüfis — 19015, 19016. Mögliche Werte: `19015`, `19016` |
| [absender › marktrolle](/bo4e/202610/bo/Marktteilnehmer#marktrolle) | [Enum Marktrolle](/bo4e/202610/enum/Marktrolle) | nein | Gibt im Klartext die Bezeichnung der Marktrolle an. Werte: `NB`, `LF`, `MSB`, `MSBA`, `GMSB`, `MDL`, `DL`, `BKV`, `UENB`, `KUNDE-SELBST-NN` … (+9) |
| [absender › rollencodenummer](/bo4e/202610/bo/Marktteilnehmer#rollencodenummer) | string | nein | Gibt die Codenummer der Marktrolle an. |
| [empfaenger › marktrolle](/bo4e/202610/bo/Marktteilnehmer#marktrolle) | [Enum Marktrolle](/bo4e/202610/enum/Marktrolle) | nein | Gibt im Klartext die Bezeichnung der Marktrolle an. Werte: `NB`, `LF`, `MSB`, `MSBA`, `GMSB`, `MDL`, `DL`, `BKV`, `UENB`, `KUNDE-SELBST-NN` … (+9) |
| [empfaenger › rollencodenummer](/bo4e/202610/bo/Marktteilnehmer#rollencodenummer) | string | nein | Gibt die Codenummer der Marktrolle an. |
## Zusatzdaten
`eventname` ist auf **START_ANTWORT_GERAETEWECHSEL** 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_ANTWORT_GERAETEWECHSEL` | **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).