Event schemas
[LF] START_VERSAND_SDAE
Marktrolle LF · Formatversion 202604 · BO4E-Schema 1.7.8
Check identifiers not yet covered
The following check identifiers are intended for this topic in business terms, but are not yet available as a specification in the current format version: 55693.
The information comes from the generator pipeline and is deliberately made visible here instead of being withheld.
Master data
Exactly one of the following 5 check identifiers is permitted under this topic — which one is decided by the event process.
| Prüfi | Scope | Use case | Regulatory determination | Communication |
|---|---|---|---|---|
| PI_44109 | UTILMD_GAS | Non-bal.rel change from LF | GeLi Gas 2.0 | LF → NB |
| PI_44120 | UTILMD_GAS | Bal.rel. change dated LF | Market area conversion | LF → NB |
| PI_55109 | UTILMD | Change data of the MaLo | GPKE part 4 | LF → NB |
| PI_55110 | UTILMD | Change data of the MaLo | GPKE part 4 | LF → MSB |
| PI_55230 | UTILMD | Change react. billing data of the NeLo | GPKE part 4 | LF → NB |
The master data of the 5 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 | 44109 | 44120 | 55109 | 55110 | 55230 | Condition |
|---|---|---|---|---|---|---|---|---|
| stammdaten | — | object | May | May | May | May | May | — |
| ENERGIELIEFERVERTRAG [ ] | — | object[] | May | — | May | May | — | — |
| korrespondenzpartner | — | object | May | — | May | May | — | — |
| anrede00010 | The form of address for the GePa, e.g. Mr. | string | May | — | May | May | — | — |
| gewerbekennzeichnung00020 | Indicates whether this is a business/company (gewerbeKennzeichnung = true) or a private individual. (gewerbeKennzeichnung = false) | boolean | May | — | — | — | — | — |
| name100030 | First part of the name. This can hold the company name or, for private individuals, the surname, for example. Examples: Yellow Strom GmbH or Hagen | string | May | — | May | May | — | — |
| name200040 | Second part of the name. Here an extension to the company name or for private individuals, for example, the first name can be entered. Examples: Bereich Süd or Nina | string | May | — | May | May | — | — |
| name300050 | Third part of the name. Further additions to the company name or , for private individuals, additions to the name can be represented here. Examples: and Africa or singer | string | May | — | May | May | — | — |
| name400060 | name4 | string | May | — | May | May | — | — |
| partneradresse | — | object | May | — | May | May | — | — |
| hausnummer00070 | House number and supplement | string | May | — | May | May | — | — |
| landescode00080 | Country code | Enum Landescode | May | — | May | May | — | — |
AC | — | — | May | — | May | May | — | — |
AD | — | — | May | — | May | May | — | — |
AE | — | — | May | — | May | May | — | — |
AF | — | — | May | — | May | May | — | — |
AG | — | — | May | — | May | May | — | — |
AI | — | — | May | — | May | May | — | — |
AL | — | — | May | — | May | May | — | — |
AM | — | — | May | — | May | May | — | — |
AN | — | — | May | — | May | May | — | — |
AO | — | — | May | — | May | May | — | — |
AQ | — | — | May | — | May | May | — | — |
AR | — | — | May | — | May | May | — | — |
AS | — | — | May | — | May | May | — | — |
AT | — | — | May | — | May | May | — | — |
AU | — | — | May | — | May | May | — | — |
AW | — | — | May | — | May | May | — | — |
AX | — | — | May | — | May | May | — | — |
AZ | — | — | May | — | May | May | — | — |
BA | — | — | May | — | May | May | — | — |
BB | — | — | May | — | May | May | — | — |
BD | — | — | May | — | May | May | — | — |
BE | — | — | May | — | May | May | — | — |
BF | — | — | May | — | May | May | — | — |
BG | — | — | May | — | May | May | — | — |
BH | — | — | May | — | May | May | — | — |
BI | — | — | May | — | May | May | — | — |
BJ | — | — | May | — | May | May | — | — |
BL | — | — | May | — | May | May | — | — |
BM | — | — | May | — | May | May | — | — |
BN | — | — | May | — | May | May | — | — |
BO | — | — | May | — | May | May | — | — |
BQ | — | — | May | — | May | May | — | — |
BR | — | — | May | — | May | May | — | — |
BS | — | — | May | — | May | May | — | — |
BT | — | — | May | — | May | May | — | — |
BU | — | — | May | — | May | May | — | — |
BV | — | — | May | — | May | May | — | — |
BW | — | — | May | — | May | May | — | — |
BY | — | — | May | — | May | May | — | — |
BZ | — | — | May | — | May | May | — | — |
CA | — | — | May | — | May | May | — | — |
CC | — | — | May | — | May | May | — | — |
CD | — | — | May | — | May | May | — | — |
CF | — | — | May | — | May | May | — | — |
CG | — | — | May | — | May | May | — | — |
CH | — | — | May | — | May | May | — | — |
CI | — | — | May | — | May | May | — | — |
CK | — | — | May | — | May | May | — | — |
CL | — | — | May | — | May | May | — | — |
CM | — | — | May | — | May | May | — | — |
CN | — | — | May | — | May | May | — | — |
CO | — | — | May | — | May | May | — | — |
CP | — | — | May | — | May | May | — | — |
CR | — | — | May | — | May | May | — | — |
CS | — | — | May | — | May | May | — | — |
CU | — | — | May | — | May | May | — | — |
CV | — | — | May | — | May | May | — | — |
CW | — | — | May | — | May | May | — | — |
CX | — | — | May | — | May | May | — | — |
CY | — | — | May | — | May | May | — | — |
CZ | — | — | May | — | May | May | — | — |
DE | — | — | May | — | May | May | — | — |
DG | — | — | May | — | May | May | — | — |
DJ | — | — | May | — | May | May | — | — |
DK | — | — | May | — | May | May | — | — |
DM | — | — | May | — | May | May | — | — |
DO | — | — | May | — | May | May | — | — |
DZ | — | — | May | — | May | May | — | — |
EA | — | — | May | — | May | May | — | — |
EC | — | — | May | — | May | May | — | — |
EE | — | — | May | — | May | May | — | — |
EG | — | — | May | — | May | May | — | — |
EH | — | — | May | — | May | May | — | — |
ER | — | — | May | — | May | May | — | — |
ES | — | — | May | — | May | May | — | — |
ET | — | — | May | — | May | May | — | — |
EU | — | — | May | — | May | May | — | — |
FI | — | — | May | — | May | May | — | — |
FJ | — | — | May | — | May | May | — | — |
FK | — | — | May | — | May | May | — | — |
FM | — | — | May | — | May | May | — | — |
FO | — | — | May | — | May | May | — | — |
FR | — | — | May | — | May | May | — | — |
FX | — | — | May | — | May | May | — | — |
GA | — | — | May | — | May | May | — | — |
GB | — | — | May | — | May | May | — | — |
GD | — | — | May | — | May | May | — | — |
GE | — | — | May | — | May | May | — | — |
GF | — | — | May | — | May | May | — | — |
GG | — | — | May | — | May | May | — | — |
GH | — | — | May | — | May | May | — | — |
GI | — | — | May | — | May | May | — | — |
GL | — | — | May | — | May | May | — | — |
GM | — | — | May | — | May | May | — | — |
GN | — | — | May | — | May | May | — | — |
GP | — | — | May | — | May | May | — | — |
GQ | — | — | May | — | May | May | — | — |
GR | — | — | May | — | May | May | — | — |
GS | — | — | May | — | May | May | — | — |
GT | — | — | May | — | May | May | — | — |
GU | — | — | May | — | May | May | — | — |
GW | — | — | May | — | May | May | — | — |
GY | — | — | May | — | May | May | — | — |
HK | — | — | May | — | May | May | — | — |
HM | — | — | May | — | May | May | — | — |
HN | — | — | May | — | May | May | — | — |
HR | — | — | May | — | May | May | — | — |
HT | — | — | May | — | May | May | — | — |
HU | — | — | May | — | May | May | — | — |
IC | — | — | May | — | May | May | — | — |
ID | — | — | May | — | May | May | — | — |
IE | — | — | May | — | May | May | — | — |
IL | — | — | May | — | May | May | — | — |
IM | — | — | May | — | May | May | — | — |
IN | — | — | May | — | May | May | — | — |
IO | — | — | May | — | May | May | — | — |
IQ | — | — | May | — | May | May | — | — |
IR | — | — | May | — | May | May | — | — |
IS | — | — | May | — | May | May | — | — |
IT | — | — | May | — | May | May | — | — |
JE | — | — | May | — | May | May | — | — |
JM | — | — | May | — | May | May | — | — |
JO | — | — | May | — | May | May | — | — |
JP | — | — | May | — | May | May | — | — |
KE | — | — | May | — | May | May | — | — |
KG | — | — | May | — | May | May | — | — |
KH | — | — | May | — | May | May | — | — |
KI | — | — | May | — | May | May | — | — |
KM | — | — | May | — | May | May | — | — |
KN | — | — | May | — | May | May | — | — |
KP | — | — | May | — | May | May | — | — |
KR | — | — | May | — | May | May | — | — |
KW | — | — | May | — | May | May | — | — |
KY | — | — | May | — | May | May | — | — |
KZ | — | — | May | — | May | May | — | — |
LA | — | — | May | — | May | May | — | — |
LB | — | — | May | — | May | May | — | — |
LC | — | — | May | — | May | May | — | — |
LI | — | — | May | — | May | May | — | — |
LK | — | — | May | — | May | May | — | — |
LR | — | — | May | — | May | May | — | — |
LS | — | — | May | — | May | May | — | — |
LT | — | — | May | — | May | May | — | — |
LU | — | — | May | — | May | May | — | — |
LV | — | — | May | — | May | May | — | — |
LY | — | — | May | — | May | May | — | — |
MA | — | — | May | — | May | May | — | — |
MC | — | — | May | — | May | May | — | — |
MD | — | — | May | — | May | May | — | — |
ME | — | — | May | — | May | May | — | — |
MF | — | — | May | — | May | May | — | — |
MG | — | — | May | — | May | May | — | — |
MH | — | — | May | — | May | May | — | — |
MK | — | — | May | — | May | May | — | — |
ML | — | — | May | — | May | May | — | — |
MM | — | — | May | — | May | May | — | — |
MN | — | — | May | — | May | May | — | — |
MO | — | — | May | — | May | May | — | — |
MP | — | — | May | — | May | May | — | — |
MQ | — | — | May | — | May | May | — | — |
MR | — | — | May | — | May | May | — | — |
MS | — | — | May | — | May | May | — | — |
MT | — | — | May | — | May | May | — | — |
MU | — | — | May | — | May | May | — | — |
MV | — | — | May | — | May | May | — | — |
MW | — | — | May | — | May | May | — | — |
MX | — | — | May | — | May | May | — | — |
MY | — | — | May | — | May | May | — | — |
MZ | — | — | May | — | May | May | — | — |
NA | — | — | May | — | May | May | — | — |
NC | — | — | May | — | May | May | — | — |
NE | — | — | May | — | May | May | — | — |
NF | — | — | May | — | May | May | — | — |
NG | — | — | May | — | May | May | — | — |
NI | — | — | May | — | May | May | — | — |
NL | — | — | May | — | May | May | — | — |
NO | — | — | May | — | May | May | — | — |
NP | — | — | May | — | May | May | — | — |
NR | — | — | May | — | May | May | — | — |
NT | — | — | May | — | May | May | — | — |
NU | — | — | May | — | May | May | — | — |
NZ | — | — | May | — | May | May | — | — |
OM | — | — | May | — | May | May | — | — |
PA | — | — | May | — | May | May | — | — |
PE | — | — | May | — | May | May | — | — |
PF | — | — | May | — | May | May | — | — |
PG | — | — | May | — | May | May | — | — |
PH | — | — | May | — | May | May | — | — |
PK | — | — | May | — | May | May | — | — |
PL | — | — | May | — | May | May | — | — |
PM | — | — | May | — | May | May | — | — |
PN | — | — | May | — | May | May | — | — |
PR | — | — | May | — | May | May | — | — |
PS | — | — | May | — | May | May | — | — |
PT | — | — | May | — | May | May | — | — |
PW | — | — | May | — | May | May | — | — |
PY | — | — | May | — | May | May | — | — |
QA | — | — | May | — | May | May | — | — |
RE | — | — | May | — | May | May | — | — |
RO | — | — | May | — | May | May | — | — |
RS | — | — | May | — | May | May | — | — |
RU | — | — | May | — | May | May | — | — |
RW | — | — | May | — | May | May | — | — |
SA | — | — | May | — | May | May | — | — |
SB | — | — | May | — | May | May | — | — |
SC | — | — | May | — | May | May | — | — |
SD | — | — | May | — | May | May | — | — |
SE | — | — | May | — | May | May | — | — |
SF | — | — | May | — | May | May | — | — |
SG | — | — | May | — | May | May | — | — |
SH | — | — | May | — | May | May | — | — |
SI | — | — | May | — | May | May | — | — |
SJ | — | — | May | — | May | May | — | — |
SK | — | — | May | — | May | May | — | — |
SL | — | — | May | — | May | May | — | — |
SM | — | — | May | — | May | May | — | — |
SN | — | — | May | — | May | May | — | — |
SO | — | — | May | — | May | May | — | — |
SR | — | — | May | — | May | May | — | — |
SS | — | — | May | — | May | May | — | — |
ST | — | — | May | — | May | May | — | — |
SU | — | — | May | — | May | May | — | — |
SV | — | — | May | — | May | May | — | — |
SX | — | — | May | — | May | May | — | — |
SY | — | — | May | — | May | May | — | — |
SZ | — | — | May | — | May | May | — | — |
TA | — | — | May | — | May | May | — | — |
TC | — | — | May | — | May | May | — | — |
TD | — | — | May | — | May | May | — | — |
TF | — | — | May | — | May | May | — | — |
TG | — | — | May | — | May | May | — | — |
TJ | — | — | May | — | May | May | — | — |
TK | — | — | May | — | May | May | — | — |
TL | — | — | May | — | May | May | — | — |
TM | — | — | May | — | May | May | — | — |
TN | — | — | May | — | May | May | — | — |
TO | — | — | May | — | May | May | — | — |
TP | — | — | May | — | May | May | — | — |
TR | — | — | May | — | May | May | — | — |
TT | — | — | May | — | May | May | — | — |
TV | — | — | May | — | May | May | — | — |
TW | — | — | May | — | May | May | — | — |
TZ | — | — | May | — | May | May | — | — |
UA | — | — | May | — | May | May | — | — |
UG | — | — | May | — | May | May | — | — |
UK | — | — | May | — | May | May | — | — |
UM | — | — | May | — | May | May | — | — |
US | — | — | May | — | May | May | — | — |
UY | — | — | May | — | May | May | — | — |
UZ | — | — | May | — | May | May | — | — |
VA | — | — | May | — | May | May | — | — |
VC | — | — | May | — | May | May | — | — |
VE | — | — | May | — | May | May | — | — |
VG | — | — | May | — | May | May | — | — |
VI | — | — | May | — | May | May | — | — |
VN | — | — | May | — | May | May | — | — |
VU | — | — | May | — | May | May | — | — |
WF | — | — | May | — | May | May | — | — |
WS | — | — | May | — | May | May | — | — |
XK | — | — | May | — | May | May | — | — |
YE | — | — | May | — | May | May | — | — |
YT | — | — | May | — | May | May | — | — |
YU | — | — | May | — | May | May | — | — |
ZA | — | — | May | — | May | May | — | — |
ZM | — | — | May | — | May | May | — | — |
ZR | — | — | May | — | May | May | — | — |
ZW | — | — | May | — | May | May | — | — |
| ort00090 | City | string | May | — | May | May | — | — |
| ortsteil00100 | District | string | May | — | May | May | — | — |
| postfach00110 | PO box | string | May | — | May | May | — | — |
| postleitzahl00120 | Postal code | string | May | — | May | May | — | — |
| strasse00130 | Street | string | May | — | May | May | — | — |
| vertragskonditionen | — | object | May | — | — | — | — | — |
| abrechnungsintervall00140 | abrechnungsintervall | integer | May | — | — | — | — | — |
| vertragspartner2 [ ] | — | object[] | May | — | May | May | — | — |
| anrede00150 | The form of address for the GePa, e.g. Mr. | string | May | — | May | May | — | — |
| gewerbekennzeichnung00160 | Indicates whether this is a business/company (gewerbeKennzeichnung = true) or a private individual. (gewerbeKennzeichnung = false) | boolean | May | — | — | — | — | — |
| name100170 | First part of the name. This can hold the company name or, for private individuals, the surname, for example. Examples: Yellow Strom GmbH or Hagen | string | May | — | May | May | — | — |
| name200180 | Second part of the name. Here an extension to the company name or for private individuals, for example, the first name can be entered. Examples: Bereich Süd or Nina | string | May | — | May | May | — | — |
| name300190 | Third part of the name. Further additions to the company name or , for private individuals, additions to the name can be represented here. Examples: and Africa or singer | string | May | — | May | May | — | — |
| name400200 | name4 | string | May | — | May | May | — | — |
| externeReferenzen [ ] | — | object[] | May | — | May | — | — | — |
| exRefName00210 | Name of the external reference (e.g. "hochfrequenz integration services") | string | May | — | May | — | — | — |
Kundennummer beim Lieferanten | — | — | May | — | May | — | — | — |
Kundennummer beim Altlieferanten | — | — | May | — | May | — | — | — |
| exRefWert00220 | Value of the external reference (e.g. "123456"; "4711") | string | May | — | May | — | — | — |
| geschaeftspartnerrolle00230 | Role held by the business partner (e.g. prospect, customer). | array | — | — | May | May | — | — |
| datenqualitaet00240 | Data quality | Enum Datenqualitaet | — | — | May | May | — | — |
ERWARTETE_DATEN | — | — | — | — | May | May | — | — |
IM_SYSTEM_VORHANDENE_DATEN | — | — | — | — | May | May | — | — |
INFORMATIVE_DATEN | — | — | — | — | May | May | — | — |
GUELTIGE_DATEN | — | — | — | — | May | May | — | — |
KEINE_DATEN | — | — | — | — | May | May | — | — |
IM_SYSTEM_KEINE_DATEN_VORHANDEN | — | — | — | — | May | May | — | — |
KEINE_DATEN_ERWARTET | — | — | — | — | May | May | — | — |
DIFFERENZ_DATEN | — | — | — | — | May | May | — | — |
DIFFERENZ_ERWARTETE_DATEN | — | — | — | — | May | May | — | — |
DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN | — | — | — | — | May | May | — | — |
| enFG [ ] | — | object[] | — | — | May | — | — | — |
| grund00250 | Reason for the levy reduction | array | — | — | May | — | — | — |
| grundlageVerringerungUmlagen00260 | GrundlageVerringerungUmlagen | Enum GrundlageVerringerungUmlagen | — | — | May | — | — | — |
ERFUELLT_VORAUSSETZUNG_NACH_ENFG | — | — | — | — | May | — | — | — |
ERFUELLT_NICHT_VORAUSSETZUNG_NACH_ENFG | — | — | — | — | May | — | — | — |
KEINE_ANGABE | — | — | — | — | May | — | — | — |
| gueltigkeitszeitraum | — | object | — | — | May | May | — | — |
| zeitraumId00270 | zeitraumId | integer | — | — | May | May | — | — |
| MARKTLOKATION [ ] * | — | object[] | Must | Must | May | May | — | — |
| marktlokationsId *00280 | Identification number of a market location at which energy is either consumed or generated | string | Must | Must | May | May | — | — |
| datenqualitaet00290 | Data quality | Enum Datenqualitaet | — | — | May | — | — | — |
ERWARTETE_DATEN | — | — | — | — | May | — | — | — |
IM_SYSTEM_VORHANDENE_DATEN | — | — | — | — | May | — | — | — |
INFORMATIVE_DATEN | — | — | — | — | May | — | — | — |
GUELTIGE_DATEN | — | — | — | — | May | — | — | — |
KEINE_DATEN | — | — | — | — | May | — | — | — |
IM_SYSTEM_KEINE_DATEN_VORHANDEN | — | — | — | — | May | — | — | — |
KEINE_DATEN_ERWARTET | — | — | — | — | May | — | — | — |
DIFFERENZ_DATEN | — | — | — | — | May | — | — | — |
DIFFERENZ_ERWARTETE_DATEN | — | — | — | — | May | — | — | — |
DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN | — | — | — | — | May | — | — | — |
| foerderungsLand00300 | foerderungsLand | string | — | — | May | — | — | — |
| gueltigkeitszeitraum | — | object | — | — | May | — | — | — |
| zeitraumId00310 | zeitraumId | integer | — | — | May | — | — | — |
| NETZNUTZUNGSVERTRAG [ ] | — | object[] | May | May | May | — | — | — |
| vertragsbeginn00320 | Specifies when the contract begins. | string (date-time) | May | May | — | — | — | — |
| vertragskonditionen | — | object | May | — | May | — | — | — |
| haushaltskunde00330 | haushaltskunde | boolean | May | — | May | — | — | — |
| BILANZIERUNG [ ] * | — | object[] | — | Must | — | — | — | — |
| bilanzkreise [ ] * | — | object[] | — | Must | — | — | — | — |
| bezeichnung *00340 | External designation | string | — | Must | — | — | — | — |
| VERWENDUNGSZEITRAUM [ ] * | — | object[] | — | — | Must | Must | Must | — |
| datenqualitaet *00350 | Data quality | Enum Datenqualitaet | — | — | Must | Must | Must | — |
ERWARTETE_DATEN | — | — | — | — | Must | Must | Must | — |
IM_SYSTEM_VORHANDENE_DATEN | — | — | — | — | Must | Must | Must | — |
INFORMATIVE_DATEN | — | — | — | — | Must | Must | Must | — |
GUELTIGE_DATEN | — | — | — | — | Must | Must | Must | — |
KEINE_DATEN | — | — | — | — | Must | Must | Must | — |
IM_SYSTEM_KEINE_DATEN_VORHANDEN | — | — | — | — | Must | Must | Must | — |
KEINE_DATEN_ERWARTET | — | — | — | — | Must | Must | Must | — |
DIFFERENZ_DATEN | — | — | — | — | Must | Must | Must | — |
DIFFERENZ_ERWARTETE_DATEN | — | — | — | — | Must | Must | Must | — |
DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN | — | — | — | — | Must | Must | Must | — |
| verwendungAb *00360 | verwendungAb | string (date-time) | — | — | Must | Must | Must | — |
| verwendungBis00370 | verwendungBis | string (date-time) | — | — | May | May | May | — |
| zeitraumId *00380 | zeitraumId | integer | — | — | Must | Must | Must | — |
| NETZLOKATION [ ] * | — | object[] | — | — | — | — | Must | — |
| datenqualitaet00390 | Data quality | Enum Datenqualitaet | — | — | — | — | May | — |
ERWARTETE_DATEN | — | — | — | — | — | — | May | — |
IM_SYSTEM_VORHANDENE_DATEN | — | — | — | — | — | — | May | — |
INFORMATIVE_DATEN | — | — | — | — | — | — | May | — |
GUELTIGE_DATEN | — | — | — | — | — | — | May | — |
KEINE_DATEN | — | — | — | — | — | — | May | — |
IM_SYSTEM_KEINE_DATEN_VORHANDEN | — | — | — | — | — | — | May | — |
KEINE_DATEN_ERWARTET | — | — | — | — | — | — | May | — |
DIFFERENZ_DATEN | — | — | — | — | — | — | May | — |
DIFFERENZ_ERWARTETE_DATEN | — | — | — | — | — | — | May | — |
DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN | — | — | — | — | — | — | May | — |
| netzlokationsId *00400 | Identification number of a grid location at which energy is either consumed or generated (like MarktlokationsId market location) | string | — | — | — | — | Must | — |
| abrechnungsdaten [ ] | — | object[] | — | — | — | — | May | — |
| zahlerBlindarbeitLf00410 | Payment of reactive energy by the supplier | boolean | — | — | — | — | May | — |
| gueltigkeitszeitraum | — | object | — | — | — | — | May | — |
| zeitraumId00420 | zeitraumId | integer | — | — | — | — | May | — |
Chain of this trigger
The event triggers the message. The market partner responds with one of the responses listed, and after that the MACO APP writes the transaction to your backend system.
| Message | Responses | Write call after the response |
|---|---|---|
| 44109 | 44111 | POST /updateProcessData |
| 44120 | 44121 | POST /updateProcessData |
| 55109 | — | — |
| 55110 | — | — |
| 55230 | — | — |
55693 | — | — |
This event triggers steps in these role views:
| Process | Party involved | Rulebook | Division |
|---|---|---|---|
| Master data change initiated by the LF (responsible) | LF | GPKE part 4 | Electricity |
| Master data change initiated by the LF (responsible) | LF | GeLi Gas 2.0 | Gas |
Transaction data
The interchange envelope of the message. Mandatory fields must be set on the trigger call.
| Field | Type | Mandatory | Description |
|---|---|---|---|
| gueltigAb | string (date-time) | yes | Effective date/time / DTM+7 |
| 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 |
| transaktionsgrund | string | yes | The transaction reason describes the business transaction for the category in more detail / UTILMD STS+7++###+ZW4+E03 |
| transaktionsgrundergaenzung | string | yes | Supplement to the transaction reason / UTILMD STS+7++E01+###+E03 |
| vertragsbeginn | string (date-time) | yes | Contract start date / DTM+92 |
pruefidentifikator | — | no | Determined dynamically in the event process (decision basis: marktrolle, sparte, transaktionsgrund). A value supplied by the sender is ignored. Check identifiers possible in the topic — 44109, 44120, 55109, 55110, 55230, 55693. Possible values: 44109, 44120, 55109, 55110, 55230, 55693 |
| 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_VERSAND_SDAE. 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_VERSAND_SDAE | 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.