# [LF] START_ERHEBUNG_MESSWERTE
<span hidden data-pagefind-meta={"title:Trigger event START_ERHEBUNG_MESSWERTE — Market role LF (FV 202604)"} />

Marktrolle **LF** · Formatversion **202604** · BO4E-Schema **1.7.8**

## Master data

Exactly one of the following 2 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](/schnittstellen/202604/pruefi/MSCONS/PI_13002) | MSCONS | Meter reading (gas) | WiM gas | MSBN → NB |
| [PI_13017](/schnittstellen/202604/pruefi/MSCONS/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 |

The master data of the 2 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.

<Handbuchsatz>

<div className="maco-tabellenrahmen">

| Structure (BO4E) | Description | Format | <span className="hbs-p" title="Zählerstand (Gas)">13002</span> | <span className="hbs-p" title="Zählerstand (Strom)">13017</span> | Condition |
|---|---|---|---|---|---|
| <span className="hbs-g hbs-e0">**stammdaten**</span> | — | object | May | May | — |
| <span className="hbs-g hbs-e1">**ENERGIEMENGE** <span className="hbs-liste">[ ]</span> <span className="hbs-pflicht">\*</span></span> | — | object[] | Must | Must | — |
| <span className="hbs-f hbs-e2">[konfiguration](/en/bo4e/202604/bo/Energiemenge#konfiguration)</span><span className="hbs-nr">00010</span> | konfiguration | string | May | May | — |
| <span className="hbs-f hbs-e2">[lokationsId](/en/bo4e/202604/bo/Energiemenge#lokationsid) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00020</span> | Unique number of the market location or of the metering location to which the energy quantity belongs | string | Must | Must | — |
| <span className="hbs-f hbs-e2">[referenzStammdatenmeldungMsb](/en/bo4e/202604/bo/Energiemenge#referenzstammdatenmeldungmsb)</span><span className="hbs-nr">00030</span> | referenzStammdatenmeldungMsb | string | May | — | — |
| <span className="hbs-g hbs-e2">**energieverbrauch** <span className="hbs-liste">[ ]</span> <span className="hbs-pflicht">\*</span></span> | — | object[] | Must | Must | — |
| <span className="hbs-f hbs-e3">[ablesedatum](/en/bo4e/202604/com/Verbrauch#ablesedatum)</span><span className="hbs-nr">00040</span> | ablesedatum | string (date-time) | May | May | — |
| <span className="hbs-f hbs-e3">[ausfuehrungszeitpunkt](/en/bo4e/202604/com/Verbrauch#ausfuehrungszeitpunkt)</span><span className="hbs-nr">00050</span> | ausfuehrungszeitpunkt | string (date-time) | May | May | — |
| <span className="hbs-f hbs-e3">[enddatum](/en/bo4e/202604/com/Verbrauch#enddatum)</span><span className="hbs-nr">00060</span> | enddatum | string (date-time) | May | — | — |
| <span className="hbs-f hbs-e3">[messwertstatus](/en/bo4e/202604/com/Verbrauch#messwertstatus) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00070</span> | The status of a meter reading | [Enum Messwertstatus](/en/bo4e/202604/enum/Messwertstatus) | Must | Must | — |
| <span className="hbs-w hbs-e4">`ABGELESEN`</span> | — | — | Must | Must | — |
| <span className="hbs-w hbs-e4">`ERSATZWERT`</span> | — | — | Must | Must | — |
| <span className="hbs-w hbs-e4">`VORSCHLAGSWERT`</span> | — | — | Must | Must | — |
| <span className="hbs-w hbs-e4">`NICHT_VERWENDBAR`</span> | — | — | Must | Must | — |
| <span className="hbs-w hbs-e4">`PROGNOSEWERT`</span> | — | — | Must | Must | — |
| <span className="hbs-w hbs-e4">`ENERGIEMENGESUMMIERT`</span> | — | — | Must | Must | — |
| <span className="hbs-w hbs-e4">`VOLAEUFIGERWERT`</span> | — | — | Must | Must | — |
| <span className="hbs-w hbs-e4">`FEHLT`</span> | — | — | Must | Must | — |
| <span className="hbs-w hbs-e4">`ANGABE_FUER_LIEFERSCHEIN`</span> | — | — | Must | Must | — |
| <span className="hbs-w hbs-e4">`GRUNDLAGE_POG_ERMITTLUNG`</span> | — | — | Must | Must | — |
| <span className="hbs-f hbs-e3">[nutzungszeitpunkt](/en/bo4e/202604/com/Verbrauch#nutzungszeitpunkt)</span><span className="hbs-nr">00080</span> | nutzungszeitpunkt | string (date-time) | May | Must | — |
| <span className="hbs-f hbs-e3">[obiskennzahl](/en/bo4e/202604/com/Verbrauch#obiskennzahl) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00090</span> | obiskennzahl | string | Must | Must | — |
| <span className="hbs-f hbs-e3">[position](/en/bo4e/202604/com/Verbrauch#position) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00100</span> | position | integer | Must | Must | — |
| <span className="hbs-f hbs-e3">[startdatum](/en/bo4e/202604/com/Verbrauch#startdatum)</span><span className="hbs-nr">00110</span> | startdatum | string (date-time) | May | — | — |
| <span className="hbs-f hbs-e3">[wert](/en/bo4e/202604/com/Verbrauch#wert) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00120</span> | wert | number (float) | Must | Must | — |
| <span className="hbs-g hbs-e3">**statuszusatzinformationen** <span className="hbs-liste">[ ]</span></span> | — | object[] | May | May | — |
| <span className="hbs-f hbs-e4">[art](/en/bo4e/202604/com/StatusZusatzInformation#art)</span><span className="hbs-nr">00130</span> | Status type | [Enum StatusArt](/en/bo4e/202604/enum/StatusArt) | May | May | — |
| <span className="hbs-w hbs-e5">`PLAUSIBILISIERUNGSHINWEIS`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`ERSATZWERTBILDUNGSVERFAHREN`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`KORREKTURGRUND`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`GRUND_ERSATZWERTBILDUNGSVERFAHREN`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`GASQUALITAET`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`MESSKLASSIFIZIERUNG`</span> | — | — | May | May | — |
| <span className="hbs-f hbs-e4">[status](/en/bo4e/202604/com/StatusZusatzInformation#status)</span><span className="hbs-nr">00140</span> | Status | [Enum Status](/en/bo4e/202604/enum/Status) | May | May | — |
| <span className="hbs-w hbs-e5">`KUNDENSELBSTABLESUNG`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`LEERSTAND`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`REALER_ZAEHLERUEBERLAUF_GEPRUEFT`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`PLAUSIBEL_WG_KONTROLLABLESUNG`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`PLAUSIBEL_WG_KUNDENHINWEIS`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`AUSTAUSCH_DES_ERSATZWERTES`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`RECHENWERT`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`BASIS_MME`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`VERGLEICHSMESSUNG_GEEICHT`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`VERGLEICHSMESSUNG_NICHT_GEEICHT`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`MESSWERTNACHBILDUNG_AUS_GEEICHTEN_WERTEN`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`MESSWERTNACHBILDUNG_AUS_NICHT_GEEICHTEN_WERTEN`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`INTERPOLATION`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`HALTEWERT`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`BILANZIERUNG_NETZABSCHNITT`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`HISTORISCHE_MESSWERTE`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`STATISTISCHE_METHODE`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`AUFTEILUNG`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`VERWENDUNG_VON_WERTEN_DES_STOERMENGENZAEHLWERKS`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`UMGANGS_UND_KORREKTURMENGEN`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`ANGABEN_MESSLOKATION`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`KEIN_ZUGANG`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`KOMMUNIKATIONSSTOERUNG`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`NETZAUSFALL`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`SPANNUNGSAUSFALL`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`STATUS_GERAETEWECHSEL`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`KALIBRIERUNG`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`GERAET_ARBEITET_AUSSERHALB_DER_BETRIEBSBEDINGUNGEN`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`MESSEINRICHTUNG_GESTOERT_DEFEKT`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`UNSICHERHEIT_MESSUNG`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`BERUECKSICHTIGUNG_STOERMENGENZAEHLWERK`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`MENGENUMWERTUNG_VOLLSTAENDIG`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`UHRZEIT_GESTELLT_SYNCHRONISATION`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`MESSWERT_UNPLAUSIBEL`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`FALSCHER_WANDLERFAKTOR`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`FEHLERHAFTE_ABLESUNG`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`AENDERUNG_DER_BERECHNUNG`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`UMBAU_DER_MESSLOKATION`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`DATENBEARBEITUNGSFEHLER`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`BRENNWERTKORREKTUR`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`Z_ZAHL_KORREKTUR`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`STOERUNG_DEFEKT_MESSEINRICHTUNG`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`AENDERUNG_TARIFSCHALTZEITEN`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`TARIFSCHALTGERAET_DEFEKT`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`IMPULSWERTIGKEIT_NICHT_AUSREICHEND`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`ENERGIEMENGE_IN_UNGEMESSENEM_ZEITINTERVALL`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`ENERGIEMENGE_AUS_DEM_UNGEPAIRTEN_ZEITINTERVALL`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`WARTUNGSARBEITEN_AN_GEEICHTEM_MESSGERAET`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`GESTOERTE_WERTE`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`WARTUNGSARBEITEN_AN_EICHRECHTSKONFORMEN_MESSGERAETEN`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`KONSISTENZ_UND_SYNCHRONPRUEFUNG`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`GRUND_ANGABEN_MESSLOKATION`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`ANFORDERUNG_IN_DIE_VERGANGENHEIT_ZUM_ANGEFORDERTEN_ZEITPUNKT_LIEGT_KEIN_WERT_VOR`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`UMSTELLUNG_GASQUALITAET`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`ZAEHLERSTAND_ZUM_BEGINN_DER_ANGEGEBENEN_ENERGIEMENGE_VORHANDEN_UND_KOMMUNIZIERT`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`ZAEHLERSTAND_ZUM_ENDE_DER_ANGEGEBENEN_ENERGIEMENGE_VORHANDEN_UND_KOMMUNIZIERT`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`ZAEHLERSTAND_ZUM_BEGINN_DER_ANGEGEBENEN_ENERGIEMENGE_NICHT_VORHANDEN_DA_MENGENABGRENZUNG`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`ZAEHLERSTAND_ZUM_ENDE_DER_ANGEGEBENEN_ENERGIEMENGE_NICHT_VORHANDEN_DA_MENGENABGRENZUNG`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`GESCHEITERT`</span> | — | — | May | May | — |
| <span className="hbs-w hbs-e5">`AUSGEBAUT`</span> | — | — | May | May | — |
| <span className="hbs-g hbs-e1">**ZAEHLER** <span className="hbs-liste">[ ]</span> <span className="hbs-pflicht">\*</span></span> | — | object[] | Must | May | — |
| <span className="hbs-f hbs-e2">[zaehlernummer](/en/bo4e/202604/bo/Zaehler#zaehlernummer) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00150</span> | Numbering of the meter, assigned by the metering point operator | string | Must | May | — |

</div>

</Handbuchsatz>

## Chain of this trigger

The event triggers the message.

| Message | Responses | Write call after the response |
|---|---|---|
| [13002](/schnittstellen/202604/pruefi/MSCONS/PI_13002) | — | — |
| [13017](/schnittstellen/202604/pruefi/MSCONS/PI_13017) | — | — |

This event triggers steps in these role views:

| Process | Party involved | Rulebook | Division |
|---|---|---|---|
| [Transmission of values from the LF to NB](/en/prozessdoku/202604/LF/awh-wim-gas-2-0-ubermittlung-von-werten-vom-lf-an-nb) | LF | AWH WiM gas 2.0 | Gas |
| [GeLi_Gas 2.0 chap. 4.1.1.1 Collection of measured values](/en/prozessdoku/202604/LF/geli-gas-2-0-geli-gas-2-0-kap-4-1-1-1-erhebung-von-messwerten) | LF | GeLi Gas 2.0 | Gas |
| [Transmission of meter readings from the LF](/en/prozessdoku/202604/LF/WiM-Teil2-uebermittlung-von-zaehlerstaenden-vom-lf) | LF | 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](/en/bo4e/202604/cdoc/Transaktionsdaten#anfragereferenz) | string | **yes** | Application number / RFF+AGI |
| [kategorie](/en/bo4e/202604/cdoc/Transaktionsdaten#kategorie) | string | **yes** | Qualifier from the beginning of the EDIFACT message / BGM |
| [sparte](/en/bo4e/202604/cdoc/Transaktionsdaten#sparte) | [Enum Sparte](/en/bo4e/202604/enum/Sparte) | **yes** | Contains information about the division Values: `STROM`, `GAS`, `FERNWAERME`, `NAHWAERME`, `WASSER`, `ABWASSER` |
| `pruefidentifikator` | — | no | Determined dynamically in the event process (decision basis: sparte). A value supplied by the sender is ignored. Check identifiers possible in the topic — 13002, 13017. Possible values: `13002`, `13017` |
| [absender › rollencodenummer](/en/bo4e/202604/bo/Marktteilnehmer#rollencodenummer) | string | no | Specifies the code value of the market role. |
| [empfaenger › rollencodenummer](/en/bo4e/202604/bo/Marktteilnehmer#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](/en/schnittstellen/schluessel).