Event schemas
[NB] START_ERHEBUNG_MESSWERTE
Marktrolle NB · Formatversion 202604 · BO4E-Schema 1.7.8
Master data
Exactly one of the following 9 check identifiers is permitted under this topic — which one is decided by the event process.
| Prüfi | Scope | Use case | Regulatory determination | Communication |
|---|---|---|---|---|
| PI_13002 | MSCONS | Meter reading (gas) | WiM gas | MSBN → NB |
| PI_13008 | MSCONS | Load curve (gas) | KoV Leitfaden Marktprozesse Bilanzkreismanagement Gas | NB → NB |
| PI_13009 | MSCONS | Energy quantity (gas) | WiM gas | MSBN → NB |
| PI_13016 | MSCONS | Energy quantity and max. demand (electricity) | GPKE part 2 | NB → LF |
| PI_13017 | MSCONS | Meter reading (electricity) | Processes for the exchange of information between grid operator and the guarantee of origin register (HKN-R) of the Federal Environment Agency (UBA) | NB → RB HKN-R |
| PI_13018 | MSCONS | Load curve metering location, grid coupling point, grid location | MaBiS BK6-19-218 balancing group integrity | NB (responsible NB) → NB (neighbouring NB) |
| PI_13019 | MSCONS | Energy quantity (electricity) | Processes for the exchange of information between grid operator and the guarantee of origin register (HKN-R) of the Federal Environment Agency (UBA) | NB → RB HKN-R |
| PI_13025 | MSCONS | Load curve market location, tranche | Processes for the exchange of information between grid operator and the guarantee of origin register (HKN-R) of the Federal Environment Agency (UBA) | NB → RB HKN-R |
| PI_13027 | MSCONS | Values according to type 2 | WiM electricity part 2 | MSB → NB |
The master data of the 9 check identifiers 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 | 13002 | 13008 | 13009 | 13016 | 13017 | 13018 | 13019 | 13025 | 13027 | Condition |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| stammdaten | — | object | May | May | May | May | May | May | May | May | May | — |
| ENERGIEMENGE [ ] * | — | object[] | Must | Must | Must | Must | Must | Must | Must | Must | Must | — |
| konfiguration00010 | konfiguration | string | May | May | May | May | May | May | May | May | May | — |
| lokationsId *00020 | Unique number of the market location or of the metering location to which the energy quantity belongs | string | Must | Must | Must | Must | Must | Must | Must | Must | Must | — |
| referenzStammdatenmeldungMsb00030 | referenzStammdatenmeldungMsb | string | May | — | — | — | — | — | — | — | — | — |
| energieverbrauch [ ] * | — | object[] | Must | Must | Must | Must | Must | Must | Must | Must | Must | — |
| ablesedatum00040 | ablesedatum | string (date-time) | May | — | — | — | May | — | — | — | — | — |
| ausfuehrungszeitpunkt00050 | ausfuehrungszeitpunkt | string (date-time) | May | — | — | — | May | — | — | — | — | — |
| enddatum00060 | enddatum | string (date-time) | May | Must | May | May | — | Must | Must | Must | May | — |
| messwertstatus *00070 | The status of a meter reading | Enum Messwertstatus | Must | Must | Must | Must | Must | Must | Must | Must | Must | — |
ABGELESEN | — | — | Must | Must | Must | Must | Must | Must | Must | Must | Must | — |
ERSATZWERT | — | — | Must | Must | Must | Must | Must | Must | Must | Must | Must | — |
VORSCHLAGSWERT | — | — | Must | Must | Must | Must | Must | Must | Must | Must | Must | — |
NICHT_VERWENDBAR | — | — | Must | Must | Must | Must | Must | Must | Must | Must | Must | — |
PROGNOSEWERT | — | — | Must | Must | Must | Must | Must | Must | Must | Must | Must | — |
ENERGIEMENGESUMMIERT | — | — | Must | Must | Must | Must | Must | Must | Must | Must | Must | — |
VOLAEUFIGERWERT | — | — | Must | Must | Must | Must | Must | Must | Must | Must | Must | — |
FEHLT | — | — | Must | Must | Must | Must | Must | Must | Must | Must | Must | — |
ANGABE_FUER_LIEFERSCHEIN | — | — | Must | Must | Must | Must | Must | Must | Must | Must | Must | — |
GRUNDLAGE_POG_ERMITTLUNG | — | — | Must | Must | Must | Must | Must | Must | Must | Must | Must | — |
| nutzungszeitpunkt00080 | nutzungszeitpunkt | string (date-time) | May | — | — | — | Must | — | — | — | May | — |
| obiskennzahl *00090 | obiskennzahl | string | Must | Must | Must | Must | Must | Must | Must | Must | Must | — |
| position *00100 | position | integer | Must | Must | Must | Must | Must | Must | Must | Must | Must | — |
| startdatum00110 | startdatum | string (date-time) | May | Must | May | May | — | Must | Must | Must | May | — |
| wert *00120 | wert | number (float) | Must | Must | Must | Must | Must | Must | Must | Must | Must | — |
| statuszusatzinformationen [ ] | — | object[] | May | May | May | May | May | May | May | May | — | — |
| art00130 | Status type | Enum StatusArt | May | May | May | May | May | May | May | May | — | — |
PLAUSIBILISIERUNGSHINWEIS | — | — | May | May | May | May | May | May | May | May | — | — |
ERSATZWERTBILDUNGSVERFAHREN | — | — | May | May | May | May | May | May | May | May | — | — |
KORREKTURGRUND | — | — | May | May | May | May | May | May | May | May | — | — |
GRUND_ERSATZWERTBILDUNGSVERFAHREN | — | — | May | May | May | May | May | May | May | May | — | — |
GASQUALITAET | — | — | May | May | May | May | May | May | May | May | — | — |
MESSKLASSIFIZIERUNG | — | — | May | May | May | May | May | May | May | May | — | — |
| status00140 | Status | Enum Status | May | May | May | May | May | May | May | May | — | — |
KUNDENSELBSTABLESUNG | — | — | May | May | May | May | May | May | May | May | — | — |
LEERSTAND | — | — | May | May | May | May | May | May | May | May | — | — |
REALER_ZAEHLERUEBERLAUF_GEPRUEFT | — | — | May | May | May | May | May | May | May | May | — | — |
PLAUSIBEL_WG_KONTROLLABLESUNG | — | — | May | May | May | May | May | May | May | May | — | — |
PLAUSIBEL_WG_KUNDENHINWEIS | — | — | May | May | May | May | May | May | May | May | — | — |
AUSTAUSCH_DES_ERSATZWERTES | — | — | May | May | May | May | May | May | May | May | — | — |
RECHENWERT | — | — | May | May | May | May | May | May | May | May | — | — |
BASIS_MME | — | — | May | May | May | May | May | May | May | May | — | — |
VERGLEICHSMESSUNG_GEEICHT | — | — | May | May | May | May | May | May | May | May | — | — |
VERGLEICHSMESSUNG_NICHT_GEEICHT | — | — | May | May | May | May | May | May | May | May | — | — |
MESSWERTNACHBILDUNG_AUS_GEEICHTEN_WERTEN | — | — | May | May | May | May | May | May | May | May | — | — |
MESSWERTNACHBILDUNG_AUS_NICHT_GEEICHTEN_WERTEN | — | — | May | May | May | May | May | May | May | May | — | — |
INTERPOLATION | — | — | May | May | May | May | May | May | May | May | — | — |
HALTEWERT | — | — | May | May | May | May | May | May | May | May | — | — |
BILANZIERUNG_NETZABSCHNITT | — | — | May | May | May | May | May | May | May | May | — | — |
HISTORISCHE_MESSWERTE | — | — | May | May | May | May | May | May | May | May | — | — |
STATISTISCHE_METHODE | — | — | May | May | May | May | May | May | May | May | — | — |
AUFTEILUNG | — | — | May | May | May | May | May | May | May | May | — | — |
VERWENDUNG_VON_WERTEN_DES_STOERMENGENZAEHLWERKS | — | — | May | May | May | May | May | May | May | May | — | — |
UMGANGS_UND_KORREKTURMENGEN | — | — | May | May | May | May | May | May | May | May | — | — |
ANGABEN_MESSLOKATION | — | — | May | May | May | May | May | May | May | May | — | — |
KEIN_ZUGANG | — | — | May | May | May | May | May | May | May | May | — | — |
KOMMUNIKATIONSSTOERUNG | — | — | May | May | May | May | May | May | May | May | — | — |
NETZAUSFALL | — | — | May | May | May | May | May | May | May | May | — | — |
SPANNUNGSAUSFALL | — | — | May | May | May | May | May | May | May | May | — | — |
STATUS_GERAETEWECHSEL | — | — | May | May | May | May | May | May | May | May | — | — |
KALIBRIERUNG | — | — | May | May | May | May | May | May | May | May | — | — |
GERAET_ARBEITET_AUSSERHALB_DER_BETRIEBSBEDINGUNGEN | — | — | May | May | May | May | May | May | May | May | — | — |
MESSEINRICHTUNG_GESTOERT_DEFEKT | — | — | May | May | May | May | May | May | May | May | — | — |
UNSICHERHEIT_MESSUNG | — | — | May | May | May | May | May | May | May | May | — | — |
BERUECKSICHTIGUNG_STOERMENGENZAEHLWERK | — | — | May | May | May | May | May | May | May | May | — | — |
MENGENUMWERTUNG_VOLLSTAENDIG | — | — | May | May | May | May | May | May | May | May | — | — |
UHRZEIT_GESTELLT_SYNCHRONISATION | — | — | May | May | May | May | May | May | May | May | — | — |
MESSWERT_UNPLAUSIBEL | — | — | May | May | May | May | May | May | May | May | — | — |
FALSCHER_WANDLERFAKTOR | — | — | May | May | May | May | May | May | May | May | — | — |
FEHLERHAFTE_ABLESUNG | — | — | May | May | May | May | May | May | May | May | — | — |
AENDERUNG_DER_BERECHNUNG | — | — | May | May | May | May | May | May | May | May | — | — |
UMBAU_DER_MESSLOKATION | — | — | May | May | May | May | May | May | May | May | — | — |
DATENBEARBEITUNGSFEHLER | — | — | May | May | May | May | May | May | May | May | — | — |
BRENNWERTKORREKTUR | — | — | May | May | May | May | May | May | May | May | — | — |
Z_ZAHL_KORREKTUR | — | — | May | May | May | May | May | May | May | May | — | — |
STOERUNG_DEFEKT_MESSEINRICHTUNG | — | — | May | May | May | May | May | May | May | May | — | — |
AENDERUNG_TARIFSCHALTZEITEN | — | — | May | May | May | May | May | May | May | May | — | — |
TARIFSCHALTGERAET_DEFEKT | — | — | May | May | May | May | May | May | May | May | — | — |
IMPULSWERTIGKEIT_NICHT_AUSREICHEND | — | — | May | May | May | May | May | May | May | May | — | — |
ENERGIEMENGE_IN_UNGEMESSENEM_ZEITINTERVALL | — | — | May | May | May | May | May | May | May | May | — | — |
ENERGIEMENGE_AUS_DEM_UNGEPAIRTEN_ZEITINTERVALL | — | — | May | May | May | May | May | May | May | May | — | — |
WARTUNGSARBEITEN_AN_GEEICHTEM_MESSGERAET | — | — | May | May | May | May | May | May | May | May | — | — |
GESTOERTE_WERTE | — | — | May | May | May | May | May | May | May | May | — | — |
WARTUNGSARBEITEN_AN_EICHRECHTSKONFORMEN_MESSGERAETEN | — | — | May | May | May | May | May | May | May | May | — | — |
KONSISTENZ_UND_SYNCHRONPRUEFUNG | — | — | May | May | May | May | May | May | May | May | — | — |
GRUND_ANGABEN_MESSLOKATION | — | — | May | May | May | May | May | May | May | May | — | — |
ANFORDERUNG_IN_DIE_VERGANGENHEIT_ZUM_ANGEFORDERTEN_ZEITPUNKT_LIEGT_KEIN_WERT_VOR | — | — | May | May | May | May | May | May | May | May | — | — |
UMSTELLUNG_GASQUALITAET | — | — | May | May | May | May | May | May | May | May | — | — |
ZAEHLERSTAND_ZUM_BEGINN_DER_ANGEGEBENEN_ENERGIEMENGE_VORHANDEN_UND_KOMMUNIZIERT | — | — | May | May | May | May | May | May | May | May | — | — |
ZAEHLERSTAND_ZUM_ENDE_DER_ANGEGEBENEN_ENERGIEMENGE_VORHANDEN_UND_KOMMUNIZIERT | — | — | May | May | May | May | May | May | May | May | — | — |
ZAEHLERSTAND_ZUM_BEGINN_DER_ANGEGEBENEN_ENERGIEMENGE_NICHT_VORHANDEN_DA_MENGENABGRENZUNG | — | — | May | May | May | May | May | May | May | May | — | — |
ZAEHLERSTAND_ZUM_ENDE_DER_ANGEGEBENEN_ENERGIEMENGE_NICHT_VORHANDEN_DA_MENGENABGRENZUNG | — | — | May | May | May | May | May | May | May | May | — | — |
GESCHEITERT | — | — | May | May | May | May | May | May | May | May | — | — |
AUSGEBAUT | — | — | May | May | May | May | May | May | May | May | — | — |
| leistungsperiode00150 | leistungsperiode | string | — | — | May | May | — | — | — | — | — | — |
| enddatum *00160 | Specifies the day and time (if available) when the time period ends. | string (date-time) | — | Must | — | — | — | Must | — | Must | — | — |
| startdatum *00170 | Specifies the day and time (if available) when the time period starts. | string (date-time) | — | Must | — | — | — | Must | — | Must | — | — |
| ZAEHLER [ ] * | — | object[] | Must | — | — | — | May | — | — | — | — | — |
| zaehlernummer *00180 | Numbering of the meter, assigned by the metering point operator | string | Must | — | — | — | May | — | — | — | — | — |
Chain of this trigger
The event triggers the message.
| Message | Responses | Write call after the response |
|---|---|---|
| 13002 | — | — |
| 13008 | — | — |
| 13009 | — | — |
| 13016 | — | — |
| 13017 | — | — |
| 13018 | — | — |
| 13019 | — | — |
| 13025 | — | — |
| 13027 | — | — |
This event triggers steps in these role views:
| Process | Party involved | Rulebook | Division |
|---|---|---|---|
| Transmission of values from the NB to LF | NB | AWH WiM gas 2.0 | Gas |
| Transmission of values from the NB to MSB | NB | AWH WiM gas 2.0 | Gas |
| Transmission of the delivery note for grid usage settlement | NB | GPKE part 2 | Electricity |
| Billing of grid usage | NB | GeLi Gas 2.0 | Gas |
| Request and provision of measured values | NB | GeLi Gas 2.0 | Gas |
| Request for calorific value and conversion factor | NB | GeLi Gas 2.0 | Gas |
| Business data request from the LF to NB | NB | GeLi Gas 2.0 | Gas |
| Transmission of the energy and demand values measured so far | NB | GeLi Gas 2.0 | Gas |
| Transmission of gas values to NB | NBA | Guideline on market processes for grid operator change | Gas |
| UF MaBiS_006 Transmission of grid load time series | NBV | MaBiS | Electricity |
| Transmission of grid load time series | NBV | MaBiS | Electricity |
| Transmission of values (load curve) from the NB to the MGV | NB | Market communication with the gas security platform | Gas |
| Transmission of meter readings from the NB | NB | WiM electricity part 2 | Electricity |
Transaction data
The interchange envelope of the message. Mandatory fields must be set on the trigger call.
| Field | Type | Mandatory | Description |
|---|---|---|---|
| anfrageReferenz | string | yes | Application number / RFF+AGI |
| kategorie | string | yes | Qualifier from the beginning of the EDIFACT message / BGM |
| lokationsTyp | Enum Lokationstyp | yes | Typ der Lokation Werte: MALO, MELO, NELO, TECHNISCHE_RESSOURCE, STEUERBARE_RESSOURCE, TRANCHE, MABIS_ZAEHLPUNKT |
| sparte | Enum Sparte | yes | Contains information about the division Values: STROM, GAS, FERNWAERME, NAHWAERME, WASSER, ABWASSER |
| typ | string | yes | Old FW - OBSOLET |
pruefidentifikator | — | no | Determined dynamically in the event process (decision basis: kategorie, sparte, typ). A value supplied by the sender is ignored. Check identifiers possible in the topic — 13002, 13008, 13009, 13016, 13017, 13018, 13019, 13025, 13027. Possible values: 13002, 13008, 13009, 13016, 13017, 13018, 13019, 13025, 13027 |
| absender › rollencodenummer | string | no | Specifies the code value of the market role. |
| empfaenger › rollencodenummer | string | no | Specifies the code value of the market role. |
Additional data
eventname is fixed to START_ERHEBUNG_MESSWERTE. 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_ERHEBUNG_MESSWERTE | 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.