Event schemas
[MSB] START_ANGEBOT_GERAETEUEBERNAHME
Marktrolle MSB · Formatversion 202610 · BO4E-Schema 1.7.8
Master data
Exactly one of the following 1 check identifiers is permitted under this topic — which one is decided by the event process.
| Prüfi | Scope | Use case | Regulatory determination | Communication |
|---|---|---|---|---|
| PI_15001 | QUOTES | Quotation for device takeover | WiM electricity part 1 | MSB (corresponds to MSBA on the object metering location) → MSB (corresponds to MSBN on the object metering location) |
The master data of the 1 check identifier in one structure — one column per check identifier, as in the application handbook. A value in the column means that the field belongs to this check identifier: Must where its specification requires it, otherwise May. An empty cell means »not part of it«, not »unknown«. The first one is preselected; the bar above the table adds the others.
| Structure (BO4E) | Description | Format | 15001 | Condition |
|---|---|---|---|---|
| stammdaten | — | object | May | — |
| ANFRAGE [ ] * | — | object[] | Must | — |
| anfragetyp *00010 | Type/kind of the request (ORDERS ORDRSP IMD 7081) | Enum Anfragetyp | Must | — |
KAUF | — | — | Must | — |
NUTZUNGSUEBERLASSUNG | — | — | Must | — |
ABRECHNUNGSBRENNWERT_UND_ZUSTANDSZAHL | — | — | Must | — |
LASTGANGDATEN | — | — | Must | — |
ZAEHLERSTAENDE | — | — | Must | — |
WERTEERMITTLUNG | — | — | Must | — |
ENERGIEMENGE_EINZELWERT | — | — | Must | — |
INNERHALB_DER_ARBEITSZEIT | — | — | Must | — |
AUCH_AUSSERHALB_DER_ARBEITSZEIT | — | — | Must | — |
WECHSEL_SAEMTLICHER_EINRICHTUNGEN | — | — | Must | — |
TEILWEISER_WECHSEL | — | — | Must | — |
AENDERUNG_ZAEHLZEITDEFINITION | — | — | Must | — |
ABBESTELLUNG_ZAEHLZEITEN | — | — | Must | — |
ABBESTELLUNG_MESSPRODUKT | — | — | Must | — |
ANGEBOT_AUF_BASIS_PREISBLATT | — | — | Must | — |
INDIVIDUELLES_ANGEBOT | — | — | Must | — |
AENDERUNG_KONFIGURATION | — | — | Must | — |
KANN_NICHT_ANGEBOTEN_WERDEN | — | — | Must | — |
NEUKONFIGURATION | — | — | Must | — |
BEENDIGUNG_KONFIGURATION | — | — | Must | — |
AKTIVIERUNG_KONFIGURATION | — | — | Must | — |
| ANGEBOT [ ] * | — | object[] | Must | — |
| anfragereferenz *00020 | Reference to a request or tender. Can help the recipient of the quotation to assign the quotation to the request or tender. | string | Must | — |
| angebotsdatum *00030 | Creation date of the quotation | string (date-time) | Must | — |
| positionsdaten [ ] * | — | object[] | Must | — |
| anbietbar00040 | — | boolean | May | — |
| artikelnummer *00050 | BDEW article number | Enum BDEWArtikelnummer | Must | — |
LEISTUNG | — | — | Must | — |
LEISTUNG_PAUSCHAL | — | — | Must | — |
GRUNDPREIS | — | — | Must | — |
REGELENERGIE_ARBEIT | — | — | Must | — |
REGELENERGIE_LEISTUNG | — | — | Must | — |
NOTSTROMLIEFERUNG_ARBEIT | — | — | Must | — |
NOTSTROMLIEFERUNG_LEISTUNG | — | — | Must | — |
RESERVENETZKAPAZITAET | — | — | Must | — |
RESERVELEISTUNG | — | — | Must | — |
ZUSAETZLICHE_ABLESUNG | — | — | Must | — |
PRUEFGEBUEHREN_AUSSERPLANMAESSIG | — | — | Must | — |
WIRKARBEIT | — | — | Must | — |
SINGULAER_GENUTZTE_BETRIEBSMITTEL | — | — | Must | — |
ABGABE_KWKG | — | — | Must | — |
ABSCHLAG | — | — | Must | — |
KONZESSIONSABGABE | — | — | Must | — |
ENTGELT_FERNAUSLESUNG | — | — | Must | — |
UNTERMESSUNG | — | — | Must | — |
BLINDMEHRARBEIT | — | — | Must | — |
ENTGELT_ABRECHNUNG | — | — | Must | — |
SPERRKOSTEN | — | — | Must | — |
ENTSPERRKOSTEN | — | — | Must | — |
MAHNKOSTEN | — | — | Must | — |
MEHR_MINDERMENGEN | — | — | Must | — |
INKASSOKOSTEN | — | — | Must | — |
BLINDMEHRLEISTUNG | — | — | Must | — |
ENTGELT_MESSUNG_ABLESUNG | — | — | Must | — |
ENTGELT_EINBAU_BETRIEB_WARTUNG_MESSTECHNIK | — | — | Must | — |
AUSGLEICHSENERGIE | — | — | Must | — |
AUSGLEICHSENERGIE_UNTERDECKUNG | — | — | Must | — |
ZAEHLEINRICHTUNG | — | — | Must | — |
WANDLER_MENGENUMWERTER | — | — | Must | — |
KOMMUNIKATIONSEINRICHTUNG | — | — | Must | — |
TECHNISCHE_STEUEREINRICHTUNG | — | — | Must | — |
PARAGRAF_19_STROM_NEV_UMLAGE | — | — | Must | — |
BEFESTIGUNGSEINRICHTUNG | — | — | Must | — |
OFFSHORE_HAFTUNGSUMLAGE | — | — | Must | — |
FIXE_ARBEITSENTGELTKOMPONENTE | — | — | Must | — |
FIXE_LEISTUNGSENTGELTKOMPONENTE | — | — | Must | — |
UMLAGE_ABSCHALTBARE_LASTEN | — | — | Must | — |
MEHRMENGE | — | — | Must | — |
MINDERMENGE | — | — | Must | — |
ENERGIESTEUER | — | — | Must | — |
SMARTMETER_GATEWAY | — | — | Must | — |
STEUERBOX | — | — | Must | — |
MSB_INKL_MESSUNG | — | — | Must | — |
ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_1_MSBG | — | — | Must | — |
ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_2_MSBG | — | — | Must | — |
ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_3_MSBG | — | — | Must | — |
ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_4_MSBG | — | — | Must | — |
ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_5_MSBG | — | — | Must | — |
ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_3_MSBG | — | — | Must | — |
ENTGELT_KAPAZITAETEN | — | — | Must | — |
| freitext00060 | Additional information (for general notes) | string | May | — |
| positionsbezeichnung *00070 | Designation of the line item | string | Must | — |
| beteiligterMarktpartner | — | object | May | — |
| rollencodenummer00080 | Specifies the code value of the market role. | string | May | — |
| rollencodetyp00090 | Indicates the type of the code. | Enum Rollencodetyp | May | — |
BDEW | — | — | May | — |
GS1 | — | — | May | — |
GLN | — | — | May | — |
DVGW | — | — | May | — |
| positionspreis [ ] | — | object[] | May | — |
| bezugswert00100 | Unit: measurands that can be determined by measurement or by specification | Enum Mengeneinheit | May | — |
W | — | — | May | — |
WH | — | — | May | — |
KW | — | — | May | — |
KWH | — | — | May | — |
KVARH | — | — | May | — |
MW | — | — | May | — |
MWH | — | — | May | — |
STUECK | — | — | May | — |
KUBIKMETER | — | — | May | — |
STUNDE | — | — | May | — |
TAG | — | — | May | — |
MONAT | — | — | May | — |
JAHR | — | — | May | — |
PROZENT | — | — | May | — |
ANZAHL | — | — | May | — |
VAR | — | — | May | — |
KVAR | — | — | May | — |
VARH | — | — | May | — |
KWHK | — | — | May | — |
Z16 | — | — | May | — |
KWT | — | — | May | — |
WATT_PRO_QUADRATMETER | — | — | May | — |
METER_PRO_SEKUNDE | — | — | May | — |
| menge00110 | menge | integer | May | — |
| wert00120 | wert | number (float) | May | — |
| verweisKatalognummer | — | object | May | — |
| katalognummer00130 | Catalog number | string | May | — |
| versionsnummer00140 | Version number | string | May | — |
| zeilennummer00150 | Line number | string | May | — |
| MESSLOKATION [ ] * | — | object[] | Must | — |
| messlokationsId *00160 | The metering location identification. This is the former metering point identifier, e.g. DE 47108151234567 | string | Must | — |
| ZAEHLER [ ] | — | object[] | May | — |
| befestigungsart00170 | Mounting type | Enum Befestigungsart | May | — |
STECKTECHNIK | — | — | May | — |
DREIPUNKT | — | — | May | — |
HUTSCHIENE | — | — | May | — |
EINSTUTZEN | — | — | May | — |
ZWEISTUTZEN | — | — | May | — |
| eichungBis00180 | The meter is calibrated up to this date. | string | May | — |
| messwerterfassung00190 | Meter reading capture at the metering point | Enum Messwerterfassung | May | — |
FERNAUSLESBAR | — | — | May | — |
MANUELL_AUSGELESENE | — | — | May | — |
| tarifart00200 | Specification regarding supported tariff types. | Enum Tarifart | May | — |
EINTARIF | — | — | May | — |
ZWEITARIF | — | — | May | — |
MEHRTARIF | — | — | May | — |
SMART_METER | — | — | May | — |
LEISTUNGSGEMESSEN | — | — | May | — |
| zaehlerauspraegung00210 | Specification regarding the direction of the meter. | Enum Zaehlerauspraegung | May | — |
EINRICHTUNGSZAEHLER | — | — | May | — |
ZWEIRICHTUNGSZAEHLER | — | — | May | — |
| zaehlergroesse00220 | Meter size | Enum Geraetemerkmal | May | — |
EINTARIF | — | — | May | — |
ZWEITARIF | — | — | May | — |
MEHRTARIF | — | — | May | — |
GAS_G2P5 | — | — | May | — |
GAS_G4 | — | — | May | — |
GAS_G6 | — | — | May | — |
GAS_G10 | — | — | May | — |
GAS_G16 | — | — | May | — |
GAS_G25 | — | — | May | — |
GAS_G40 | — | — | May | — |
GAS_G65 | — | — | May | — |
GAS_G100 | — | — | May | — |
GAS_G160 | — | — | May | — |
GAS_G250 | — | — | May | — |
GAS_G350 | — | — | May | — |
GAS_G400 | — | — | May | — |
GAS_G4000 | — | — | May | — |
GAS_G650 | — | — | May | — |
GAS_G6500 | — | — | May | — |
GAS_G1000 | — | — | May | — |
GAS_G10000 | — | — | May | — |
GAS_G12500 | — | — | May | — |
GAS_G1600 | — | — | May | — |
GAS_G16000 | — | — | May | — |
GAS_G2500 | — | — | May | — |
IMPULSGEBER_G4_G100 | — | — | May | — |
IMPULSGEBER_G100 | — | — | May | — |
MODEM_GSM | — | — | May | — |
MODEM_GPRS | — | — | May | — |
MODEM_FUNK | — | — | May | — |
MODEM_GSM_O_LG | — | — | May | — |
MODEM_GSM_M_LG | — | — | May | — |
MODEM_FESTNETZ | — | — | May | — |
MODEM_GPRS_M_LG | — | — | May | — |
PLC_COM | — | — | May | — |
ETHERNET_KOM | — | — | May | — |
DSL_KOM | — | — | May | — |
LTE_KOM | — | — | May | — |
RUNDSTEUEREMPFAENGER | — | — | May | — |
TARIFSCHALTGERAET | — | — | May | — |
ZUSTANDS_MU | — | — | May | — |
TEMPERATUR_MU | — | — | May | — |
KOMPAKT_MU | — | — | May | — |
SYSTEM_MU | — | — | May | — |
UNBESTIMMT | — | — | May | — |
WASSER_MWZW | — | — | May | — |
WASSER_WZWW | — | — | May | — |
WASSER_WZ01 | — | — | May | — |
WASSER_WZ02 | — | — | May | — |
WASSER_WZ03 | — | — | May | — |
WASSER_WZ04 | — | — | May | — |
WASSER_WZ05 | — | — | May | — |
WASSER_WZ06 | — | — | May | — |
WASSER_WZ07 | — | — | May | — |
WASSER_WZ08 | — | — | May | — |
WASSER_WZ09 | — | — | May | — |
WASSER_WZ10 | — | — | May | — |
WASSER_VWZ04 | — | — | May | — |
WASSER_VWZ05 | — | — | May | — |
WASSER_VWZ06 | — | — | May | — |
WASSER_VWZ07 | — | — | May | — |
WASSER_VWZ10 | — | — | May | — |
DICHTEMENGENUMWERTER | — | — | May | — |
TEMPERATURMENGENUMWERTER | — | — | May | — |
ZUSTANDSMENGENUMWERTER | — | — | May | — |
BLOCKSTROMWANDLER | — | — | May | — |
MESSWANDLERSATZ_IMS_MME | — | — | May | — |
KOMBIMESSWANDLER | — | — | May | — |
SPANNUNGSWANDLER | — | — | May | — |
| zaehlertyp00230 | Typing of the meter | Enum Zaehlertyp | May | — |
DREHSTROMZAEHLER | — | — | May | — |
BALGENGASZAEHLER | — | — | May | — |
DREHKOLBENZAEHLER | — | — | May | — |
SMARTMETER | — | — | May | — |
LEISTUNGSZAEHLER | — | — | May | — |
MAXIMUMZAEHLER | — | — | May | — |
TURBINENRADGASZAEHLER | — | — | May | — |
ULTRASCHALLGASZAEHLER | — | — | May | — |
WECHSELSTROMZAEHLER | — | — | May | — |
WIRBELGASZAEHLER | — | — | May | — |
MESSDATENREGISTRIERGERAET | — | — | May | — |
ELEKTRONISCHERHAUSHALTSZAEHLER | — | — | May | — |
SONDERAUSSTATTUNG | — | — | May | — |
WASSERZAEHLER | — | — | May | — |
MODERNEMESSEINRICHTUNG | — | — | May | — |
| zaehlertypspezifikation00240 | Typing of the meter (specification for EHZ and MME) | Enum ZaehlertypSpezifikation | May | — |
EDL40 | — | — | May | — |
EDL21 | — | — | May | — |
SONSTIGER_EHZ | — | — | May | — |
MME_STANDARD | — | — | May | — |
MME_MEDA | — | — | May | — |
| geraete [ ] | — | object[] | May | — |
| geraeteeigenschaften | — | object | May | — |
| faktor00250 | faktor | number (float) | May | — |
| firmwareVersion00260 | Firmware version | string | May | — |
| geraetemerkmal00270 | Geraetemerkmal | Enum Geraetemerkmal | May | — |
EINTARIF | — | — | May | — |
ZWEITARIF | — | — | May | — |
MEHRTARIF | — | — | May | — |
GAS_G2P5 | — | — | May | — |
GAS_G4 | — | — | May | — |
GAS_G6 | — | — | May | — |
GAS_G10 | — | — | May | — |
GAS_G16 | — | — | May | — |
GAS_G25 | — | — | May | — |
GAS_G40 | — | — | May | — |
GAS_G65 | — | — | May | — |
GAS_G100 | — | — | May | — |
GAS_G160 | — | — | May | — |
GAS_G250 | — | — | May | — |
GAS_G350 | — | — | May | — |
GAS_G400 | — | — | May | — |
GAS_G4000 | — | — | May | — |
GAS_G650 | — | — | May | — |
GAS_G6500 | — | — | May | — |
GAS_G1000 | — | — | May | — |
GAS_G10000 | — | — | May | — |
GAS_G12500 | — | — | May | — |
GAS_G1600 | — | — | May | — |
GAS_G16000 | — | — | May | — |
GAS_G2500 | — | — | May | — |
IMPULSGEBER_G4_G100 | — | — | May | — |
IMPULSGEBER_G100 | — | — | May | — |
MODEM_GSM | — | — | May | — |
MODEM_GPRS | — | — | May | — |
MODEM_FUNK | — | — | May | — |
MODEM_GSM_O_LG | — | — | May | — |
MODEM_GSM_M_LG | — | — | May | — |
MODEM_FESTNETZ | — | — | May | — |
MODEM_GPRS_M_LG | — | — | May | — |
PLC_COM | — | — | May | — |
ETHERNET_KOM | — | — | May | — |
DSL_KOM | — | — | May | — |
LTE_KOM | — | — | May | — |
RUNDSTEUEREMPFAENGER | — | — | May | — |
TARIFSCHALTGERAET | — | — | May | — |
ZUSTANDS_MU | — | — | May | — |
TEMPERATUR_MU | — | — | May | — |
KOMPAKT_MU | — | — | May | — |
SYSTEM_MU | — | — | May | — |
UNBESTIMMT | — | — | May | — |
WASSER_MWZW | — | — | May | — |
WASSER_WZWW | — | — | May | — |
WASSER_WZ01 | — | — | May | — |
WASSER_WZ02 | — | — | May | — |
WASSER_WZ03 | — | — | May | — |
WASSER_WZ04 | — | — | May | — |
WASSER_WZ05 | — | — | May | — |
WASSER_WZ06 | — | — | May | — |
WASSER_WZ07 | — | — | May | — |
WASSER_WZ08 | — | — | May | — |
WASSER_WZ09 | — | — | May | — |
WASSER_WZ10 | — | — | May | — |
WASSER_VWZ04 | — | — | May | — |
WASSER_VWZ05 | — | — | May | — |
WASSER_VWZ06 | — | — | May | — |
WASSER_VWZ07 | — | — | May | — |
WASSER_VWZ10 | — | — | May | — |
DICHTEMENGENUMWERTER | — | — | May | — |
TEMPERATURMENGENUMWERTER | — | — | May | — |
ZUSTANDSMENGENUMWERTER | — | — | May | — |
BLOCKSTROMWANDLER | — | — | May | — |
MESSWANDLERSATZ_IMS_MME | — | — | May | — |
KOMBIMESSWANDLER | — | — | May | — |
SPANNUNGSWANDLER | — | — | May | — |
| herstellerTypbezeichnung00280 | Manufacturer type designation | string | May | — |
| ipVersion00290 | IP version | string | May | — |
| modemKennungIMSI00300 | Modem identifier (IMSI) | string | May | — |
| simKartenNummer00310 | SIM card number | string | May | — |
| tkProvider00320 | Telecommunications provider | string | May | — |
Chain of this trigger
The event triggers the message.
| Message | Responses | Write call after the response |
|---|---|---|
| 15001 | — | — |
This event triggers steps in these role views:
| Process | Party involved | Rulebook | Division |
|---|---|---|---|
| Device takeover | MSBA | AWH WiM gas 2.0 | Gas |
| Device takeover | MSBA | WiM electricity part 1 | Electricity |
Transaction data
The interchange envelope of the message. Mandatory fields must be set on the trigger call.
| Field | Type | Mandatory | Description |
|---|---|---|---|
| kategorie | string | yes | Qualifier from the beginning of the EDIFACT message / BGM |
| sparte | Enum Sparte | yes | Contains information about the division Values: STROM, GAS, FERNWAERME, NAHWAERME, WASSER, ABWASSER |
pruefidentifikator | — | no | Determined dynamically in the event process. A value supplied by the sender is ignored. Check identifiers possible in the topic — 15001. Possible values: 15001 |
| absender › marktrolle | 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 | string | no | Specifies the code value of the market role. |
| empfaenger › marktrolle | 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 | string | no | Specifies the code value of the market role. |
Additional data
eventname is fixed to START_ANGEBOT_GERAETEUEBERNAHME. 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_ANGEBOT_GERAETEUEBERNAHME | 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.