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

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

## Master data

Exactly one of the following 3 check identifiers is permitted under this topic — which one is decided by the event process.

| Prüfi | Scope | Use case | Regulatory determination | Communication |
|---|---|---|---|---|
| [PI_25005](/schnittstellen/202604/pruefi/UTILTS/PI_25005) | UTILTS | Transmission of a rolled-out metering time period definition | GPKE part 3 | NB → LF |
| [PI_25008](/schnittstellen/202604/pruefi/UTILTS/PI_25008) | UTILTS | Transmission of a rolled-out switching time definition | GPKE part 3 | NB → LF |
| [PI_25009](/schnittstellen/202604/pruefi/UTILTS/PI_25009) | UTILTS | Transmission of a rolled-out power curve definition | GPKE part 3 | NB → LF |

The master data of the 3 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="Übermittlung einer ausgerollten Zählzeitdefinition">25005</span> | <span className="hbs-p" title="Übermittlung einer ausgerollten Schaltzeitdefinition">25008</span> | <span className="hbs-p" title="Übermittlung einer ausgerollten Leistungskurvendefinition">25009</span> | Condition |
|---|---|---|---|---|---|---|
| <span className="hbs-g hbs-e0">**stammdaten**</span> | — | object | May | May | May | — |
| <span className="hbs-g hbs-e1">**ZAEHLZEITDEFINITION** <span className="hbs-liste">[ ]</span> <span className="hbs-pflicht">\*</span></span> | — | object[] | Must | — | — | — |
| <span className="hbs-f hbs-e2">[beginndatum](/en/bo4e/202604/bo/Zaehlzeitdefinition#beginndatum) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00010</span> | The inclusive point in time from which the metering time period definitions are rolled out | string (date-time) | Must | — | — | — |
| <span className="hbs-f hbs-e2">[code](/en/bo4e/202604/bo/Zaehlzeitdefinition#code) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00020</span> | Metering time period definition | string | Must | — | — | — |
| <span className="hbs-f hbs-e2">[endedatum](/en/bo4e/202604/bo/Zaehlzeitdefinition#endedatum)</span><span className="hbs-nr">00030</span> | The exclusive point in time up to which the metering time period definitions are rolled out | string (date-time) | May | — | — | — |
| <span className="hbs-f hbs-e2">[version](/en/bo4e/202604/bo/Zaehlzeitdefinition#version) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00040</span> | Version of the metering time period definition as a date | string (date-time) | Must | — | — | — |
| <span className="hbs-g hbs-e2">**zaehlzeiten** <span className="hbs-liste">[ ]</span> <span className="hbs-pflicht">\*</span></span> | — | object[] | Must | — | — | — |
| <span className="hbs-f hbs-e3">[aenderungszeitpunkt](/en/bo4e/202604/com/Zaehlzeit#aenderungszeitpunkt) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00050</span> | aenderungszeitpunkt | string (date-time) | Must | — | — | — |
| <span className="hbs-f hbs-e3">[haeufigkeit](/en/bo4e/202604/com/Zaehlzeit#haeufigkeit)</span><span className="hbs-nr">00060</span> | Frequency of transmission | [Enum HaeufigkeitZaehlzeit](/en/bo4e/202604/enum/HaeufigkeitZaehlzeit) | May | — | — | — |
| <span className="hbs-w hbs-e4">`EINMALIG`</span> | — | — | May | — | — | — |
| <span className="hbs-w hbs-e4">`JAEHRLICH`</span> | — | — | May | — | — | — |
| <span className="hbs-f hbs-e3">[register](/en/bo4e/202604/com/Zaehlzeit#register) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00070</span> | register | string | Must | — | — | — |
| <span className="hbs-g hbs-e1">**SCHALTZEITDEFINITION** <span className="hbs-liste">[ ]</span> <span className="hbs-pflicht">\*</span></span> | — | object[] | — | Must | — | — |
| <span className="hbs-f hbs-e2">[beginndatum](/en/bo4e/202604/bo/Schaltzeitdefinition#beginndatum) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00080</span> | beginndatum | string (date-time) | — | Must | — | — |
| <span className="hbs-f hbs-e2">[code](/en/bo4e/202604/bo/Schaltzeitdefinition#code) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00090</span> | code | string | — | Must | — | — |
| <span className="hbs-f hbs-e2">[endedatum](/en/bo4e/202604/bo/Schaltzeitdefinition#endedatum)</span><span className="hbs-nr">00100</span> | endedatum | string (date-time) | — | May | — | — |
| <span className="hbs-f hbs-e2">[version](/en/bo4e/202604/bo/Schaltzeitdefinition#version) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00110</span> | version | string (date-time) | — | Must | — | — |
| <span className="hbs-g hbs-e2">**schaltzeiten** <span className="hbs-liste">[ ]</span> <span className="hbs-pflicht">\*</span></span> | — | object[] | — | Must | — | — |
| <span className="hbs-f hbs-e3">[aenderungszeitpunkt](/en/bo4e/202604/com/Schaltzeit#aenderungszeitpunkt) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00120</span> | aenderungszeitpunkt | string (date-time) | — | Must | — | — |
| <span className="hbs-f hbs-e3">[haeufigkeit](/en/bo4e/202604/com/Schaltzeit#haeufigkeit)</span><span className="hbs-nr">00130</span> | HaeufigkeitSchaltzeit | [Enum HaeufigkeitSchaltzeit](/en/bo4e/202604/enum/HaeufigkeitSchaltzeit) | — | May | — | — |
| <span className="hbs-w hbs-e4">`EINMALIG`</span> | — | — | — | May | — | — |
| <span className="hbs-w hbs-e4">`JAEHRLICH`</span> | — | — | — | May | — | — |
| <span className="hbs-f hbs-e3">[schalthandlung](/en/bo4e/202604/com/Schaltzeit#schalthandlung) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00140</span> | Switching operation | [Enum Schalthandlung](/en/bo4e/202604/enum/Schalthandlung) | — | Must | — | — |
| <span className="hbs-w hbs-e4">`LEISTUNG_AN`</span> | — | — | — | Must | — | — |
| <span className="hbs-w hbs-e4">`LEISTUNG_AUS`</span> | — | — | — | Must | — | — |
| <span className="hbs-g hbs-e1">**LEISTUNGSKURVENDEFINITION** <span className="hbs-liste">[ ]</span> <span className="hbs-pflicht">\*</span></span> | — | object[] | — | — | Must | — |
| <span className="hbs-f hbs-e2">[beginndatum](/en/bo4e/202604/bo/Leistungskurvendefinition#beginndatum) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00150</span> | beginndatum | string (date-time) | — | — | Must | — |
| <span className="hbs-f hbs-e2">[code](/en/bo4e/202604/bo/Leistungskurvendefinition#code) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00160</span> | code | string | — | — | Must | — |
| <span className="hbs-f hbs-e2">[endedatum](/en/bo4e/202604/bo/Leistungskurvendefinition#endedatum)</span><span className="hbs-nr">00170</span> | endedatum | string (date-time) | — | — | May | — |
| <span className="hbs-f hbs-e2">[version](/en/bo4e/202604/bo/Leistungskurvendefinition#version) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00180</span> | version | string (date-time) | — | — | Must | — |
| <span className="hbs-g hbs-e2">**leistungskurven** <span className="hbs-liste">[ ]</span> <span className="hbs-pflicht">\*</span></span> | — | object[] | — | — | Must | — |
| <span className="hbs-f hbs-e3">[aenderungszeitpunkt](/en/bo4e/202604/com/Leistungskurve#aenderungszeitpunkt) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00190</span> | Time of change | string (date-time) | — | — | Must | — |
| <span className="hbs-f hbs-e3">[haeufigkeit](/en/bo4e/202604/com/Leistungskurve#haeufigkeit)</span><span className="hbs-nr">00200</span> | HaeufigkeitLeistungskurve | [Enum HaeufigkeitLeistungskurve](/en/bo4e/202604/enum/HaeufigkeitLeistungskurve) | — | — | May | — |
| <span className="hbs-w hbs-e4">`EINMALIG`</span> | — | — | — | — | May | — |
| <span className="hbs-w hbs-e4">`JAEHRLICH`</span> | — | — | — | — | May | — |
| <span className="hbs-g hbs-e3">**schwellwert** <span className="hbs-pflicht">\*</span></span> | — | object | — | — | Must | — |
| <span className="hbs-f hbs-e4">[obererSchwellwert](/en/bo4e/202604/com/Schwellwert#obererschwellwert) <span className="hbs-pflicht">\*</span></span><span className="hbs-nr">00210</span> | obererSchwellwert | number (float) | — | — | Must | — |

</div>

</Handbuchsatz>

## Chain of this trigger

The event triggers the message.

| Message | Responses | Write call after the response |
|---|---|---|
| [25005](/schnittstellen/202604/pruefi/UTILTS/PI_25005) | — | — |
| [25008](/schnittstellen/202604/pruefi/UTILTS/PI_25008) | — | — |
| [25009](/schnittstellen/202604/pruefi/UTILTS/PI_25009) | — | — |

This event triggers a step in this role view:

| Process | Party involved | Rulebook | Division |
|---|---|---|---|
| [Transmission of a definition of the LF by the LF](/en/prozessdoku/202604/LF/GPKE-Teil3-uebermittlung-einer-definition-des-lf-durch-den-lf) | LF | GPKE part 3 | 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: kategorie). A value supplied by the sender is ignored. Check identifiers possible in the topic — 25005, 25008, 25009. Possible values: `25005`, `25008`, `25009` |
| [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_UEBERM_DEFINITION**. 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_UEBERM_DEFINITION` | **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).