Case 1: LF assignment for…

START_ZUORDNUNG_ERZ_MALO_TRANCHE (NB)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (4):

Fall 1: LF-Zuordnung bei EEG-Marktlokation ohne DV-Pflicht bzw. KWKG-Marktlokation ohne DV-Pflicht — NB
Fall 2: LF-Zuordnung bei EEG-Marktlokation mit DV-Pflicht — NB
Fall 3: LF-Zuordnung bei KWKG-Marktlokation mit DV-Pflicht bzw. Nicht-EEG-/Nicht-KWKG-Marktlokation und Marktlokation wird nicht-tranchiert abgebildet — NB
Fall 4: LF-Zuordnung bei KWKG-Marktlokation mit DV-Pflicht bzw. Nicht-EEG-/Nicht-KWKG-Marktlokation und Marktlokation wird tranchiert abgebildet — NB

POST/inbound

curl https://api.macoapp.de/inbound \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "stammdaten": {
    "MARKTLOKATION": [
      {
        "energieherkunft": [
          {
            "erzeugungsart": "EEG"
          }
        ],
        "marktlokationsId": "marktlokationsId",
        "marktrollen": [
          {
            "marktrolle": "NB",
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "rollencodenummer": "rollencodenummer",
            "weiterverpflichtet": true
          }
        ],
        "statusErzeugendeMalo": "EINSPEISEVERGUETUNG_PARAGRAPH_37"
      }
    ],
    "MESSLOKATION": [
      {
        "marktrollen": [
          {
            "marktrolle": "NB",
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "rollencodenummer": "rollencodenummer",
            "weiterverpflichtet": true
          }
        ],
        "messlokationsId": "messlokationsId"
      }
    ],
    "NETZLOKATION": [
      {
        "marktrollen": [
          {
            "marktrolle": "NB",
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "rollencodenummer": "rollencodenummer"
          }
        ],
        "netzlokationsId": "netzlokationsId"
      }
    ],
    "NETZNUTZUNGSVERTRAG": [
      {
        "vertragsbeginn": "2024-08-25T15:00:00Z",
        "vertragsende": "2024-08-25T15:00:00Z"
      }
    ],
    "STEUERBARE_RESSOURCE": [
      {
        "marktrollen": [
          {
            "marktrolle": "NB",
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "rollencodenummer": "rollencodenummer"
          }
        ],
        "ressourcenId": "ressourcenId"
      }
    ],
    "TECHNISCHE_RESSOURCE": [
      {
        "ressourcenId": "ressourcenId"
      }
    ],
    "TRANCHE": [
      {
        "aufteilungsmenge": {
          "einheit": "W",
          "wert": 0
        },
        "bildungTranchengroesse": "PROZENTUAL",
        "tranchenId": "tranchenId"
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "rollencodenummer": "rollencodenummer"
    },
    "kategorie": "kategorie",
    "pruefidentifikator": "55607",
    "sparte": "STROM",
    "transaktionsgrund": "transaktionsgrund",
    "transaktionsgrundergaenzung": "transaktionsgrundergaenzung",
    "transaktionsgrundergaenzungBefristeteAnmeldung": "transaktionsgrundergaenzungBefristeteAnmeldung"
  },
  "zusatzdaten": {
    "eventname": "START_ZUORDNUNG_ERZ_MALO_TRANCHE",
    "prozessId": "prozessId"
  }
}'

START_ZUORDNUNG_ERZ_MALO_TRANCHE (NB) › Request Body

The body of this call — one column per admissible Prüfidentifikator. A value in the column means the field belongs to that Prüfidentifikator: Must where the schema requires it, otherwise May.

Structure (BO4E)	Description	Format	55607
stammdaten*	—	object	Muss
MARKTLOKATION[ ]*	—	object[]	Muss
`marktlokationsId`*00010	Identification number of a market location at which energy is either consumed or generated	string	Muss
`statusErzeugendeMalo`*00020	Status of the generating market location	string	Muss
`EINSPEISEVERGUETUNG_PARAGRAPH_37`			Muss
`GEFOERDERTE_DIREKTVERMARKTUNG`			Muss
`SONSTIGE_DIREKTVERMARKTUNG`			Muss
`VERMARKTUNG_OHNE_GESETZL_VERGUETUNG`			Muss
`KWKG_VERGUETUNG`			Muss
`EINSPEISEVERGUETUNG_PARAGRAPH_38_AUSFALLVERGUETUNG`			Muss
energieherkunft[ ]*	—	object[]	Muss
`erzeugungsart`*00030	Type of generation	string	Muss
`EEG`			Muss
`KWK`			Muss
`EEG_DV`			Muss
`KWK_DV`			Muss
`WIND`			Muss
`SOLAR`			Muss
`KERNKRAFT`			Muss
`WASSER`			Muss
`GEOTHERMIE`			Muss
`BIOMASSE`			Muss
`KOHLE`			Muss
`GAS`			Muss
`SONSTIGE`			Muss
`SONSTIGE_EEG`			Muss
`SONSTIGE_ERZEUGUNGSART`			Muss
marktrollen[ ]*	—	object[]	Muss
`marktrolle`00040	Indicates the designation of the market role in free text.	string	Kann
`NB`			Kann
`LF`			Kann
`MSB`			Kann
`MSBA`			Kann
`GMSB`			Kann
`MDL`			Kann
`DL`			Kann
`BKV`			Kann
`BKO`			Kann
`UENB`			Kann
`KUNDE-SELBST-NN`			Kann
`MGV`			Kann
`EIV`			Kann
`RB`			Kann
`KUNDE`			Kann
`INTERESSENT`			Kann
`KN`			Kann
`UBA`			Kann
`BIKO`			Kann
`ESA`			Kann
`messstellenbetreiberEigenschaft`*00050	MSB property	string	Muss
`GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER`			Muss
`WETTBEWERBLICHER_MESSSTELLENBETREIBER`			Muss
`AUFFANGMESSSTELLENBETREIBER`			Muss
`rollencodenummer`*00060	Specifies the code value of the market role.	string	Muss
`weiterverpflichtet`*00070	weiterverpflichtet	boolean	Muss
MESSLOKATION[ ]*	—	object[]	Muss
`messlokationsId`*00080	The metering location identification. This is the former metering point identifier, e.g. DE 47108151234567	string	Muss
marktrollen[ ]	—	object[]	Kann
`marktrolle`00090	Indicates the designation of the market role in free text.	string	Kann
`NB`			Kann
`LF`			Kann
`MSB`			Kann
`MSBA`			Kann
`GMSB`			Kann
`MDL`			Kann
`DL`			Kann
`BKV`			Kann
`BKO`			Kann
`UENB`			Kann
`KUNDE-SELBST-NN`			Kann
`MGV`			Kann
`EIV`			Kann
`RB`			Kann
`KUNDE`			Kann
`INTERESSENT`			Kann
`KN`			Kann
`UBA`			Kann
`BIKO`			Kann
`ESA`			Kann
`messstellenbetreiberEigenschaft`00100	MSB property	string	Kann
`GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER`			Kann
`WETTBEWERBLICHER_MESSSTELLENBETREIBER`			Kann
`AUFFANGMESSSTELLENBETREIBER`			Kann
`rollencodenummer`00110	Specifies the code value of the market role.	string	Kann
`weiterverpflichtet`00120	weiterverpflichtet	boolean	Kann
NETZLOKATION[ ]	—	object[]	Kann
`netzlokationsId`00130	Identification number of a grid location at which energy is either consumed or generated (Like MarktlokationsId Marktlokation)	string	Kann
marktrollen[ ]	—	object[]	Kann
`marktrolle`00140	Indicates the designation of the market role in free text.	string	Kann
`NB`			Kann
`LF`			Kann
`MSB`			Kann
`MSBA`			Kann
`GMSB`			Kann
`MDL`			Kann
`DL`			Kann
`BKV`			Kann
`BKO`			Kann
`UENB`			Kann
`KUNDE-SELBST-NN`			Kann
`MGV`			Kann
`EIV`			Kann
`RB`			Kann
`KUNDE`			Kann
`INTERESSENT`			Kann
`KN`			Kann
`UBA`			Kann
`BIKO`			Kann
`ESA`			Kann
`messstellenbetreiberEigenschaft`00150	MSB property	string	Kann
`GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER`			Kann
`WETTBEWERBLICHER_MESSSTELLENBETREIBER`			Kann
`AUFFANGMESSSTELLENBETREIBER`			Kann
`rollencodenummer`00160	Specifies the code value of the market role.	string	Kann
NETZNUTZUNGSVERTRAG[ ]	—	object[]	Kann
`vertragsbeginn`00170	Specifies when the contract begins.	string (date-time)	Kann
`vertragsende`00180	Contract end date / DTM+93	string (date-time)	Kann
STEUERBARE_RESSOURCE[ ]	—	object[]	Kann
`ressourcenId`00190	ressourcenId	string	Kann
marktrollen[ ]	—	object[]	Kann
`marktrolle`00200	Indicates the designation of the market role in free text.	string	Kann
`NB`			Kann
`LF`			Kann
`MSB`			Kann
`MSBA`			Kann
`GMSB`			Kann
`MDL`			Kann
`DL`			Kann
`BKV`			Kann
`BKO`			Kann
`UENB`			Kann
`KUNDE-SELBST-NN`			Kann
`MGV`			Kann
`EIV`			Kann
`RB`			Kann
`KUNDE`			Kann
`INTERESSENT`			Kann
`KN`			Kann
`UBA`			Kann
`BIKO`			Kann
`ESA`			Kann
`messstellenbetreiberEigenschaft`00210	MSB property	string	Kann
`GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER`			Kann
`WETTBEWERBLICHER_MESSSTELLENBETREIBER`			Kann
`AUFFANGMESSSTELLENBETREIBER`			Kann
`rollencodenummer`00220	Specifies the code value of the market role.	string	Kann
TECHNISCHE_RESSOURCE[ ]	—	object[]	Kann
`ressourcenId`00230	ressourcenId	string	Kann
TRANCHE[ ]	—	object[]	Kann
`bildungTranchengroesse`00240	BildungTranchengroesse	string	Kann
`PROZENTUAL`			Kann
`AUFTEILUNGSFAKTOR`			Kann
`AUFTEILUNG_TECHNISCHE_RESSOURCEN`			Kann
`BERECHNUNGSFORMEL`			Kann
`tranchenId`00250	tranchenId	string	Kann
aufteilungsmenge	—	object	Kann
`einheit`00260	Unit: measurands that can be determined by measurement or by specification	string	Kann
`W`			Kann
`WH`			Kann
`KW`			Kann
`KWH`			Kann
`KVARH`			Kann
`MW`			Kann
`MWH`			Kann
`STUECK`			Kann
`KUBIKMETER`			Kann
`STUNDE`			Kann
`TAG`			Kann
`MONAT`			Kann
`JAHR`			Kann
`PROZENT`			Kann
`ANZAHL`			Kann
`VAR`			Kann
`KVAR`			Kann
`VARH`			Kann
`KWHK`			Kann
`Z16`			Kann
`KWT`			Kann
`wert`00270	Value	number (float)	Kann
transaktionsdaten*	—	object	Muss
`kategorie`*00280	Qualifier from the beginning of the EDIFACT message / BGM	string	Muss
`pruefidentifikator`00290	Determined dynamically in the event process. A value supplied by the sender is ignored. Check identifiers possible in the topic — 55607.	—	Kann
`sparte`*00300	Contains information about the division	string	Muss
`STROM`			Muss
`GAS`			Muss
`FERNWAERME`			Muss
`NAHWAERME`			Muss
`WASSER`			Muss
`ABWASSER`			Muss
`transaktionsgrund`*00310	The transaction reason describes the business transaction for the category in more detail / UTILMD STS+7++###+ZW4+E03	string	Muss
`transaktionsgrundergaenzung`*00320	Supplement to the transaction reason / UTILMD STS+7++E01+###+E03	string	Muss
`transaktionsgrundergaenzungBefristeteAnmeldung`*00330	Supplement to the transaction reason for temporary registrations/deregistrations / UTILMD STS+7++E01+ZW4+###	string	Muss
absender*	—	object	Muss
`rollencodenummer`00340	Specifies the code value of the market role.	string	Kann
empfaenger*	—	object	Muss
`rollencodenummer`00350	Specifies the code value of the market role.	string	Kann
zusatzdaten*	—	object	Muss
`eventname`*00360	—	string	Muss
`prozessId`*00370	—	string	Muss

Example Request Body

{
  "stammdaten": {
    "MARKTLOKATION": [
      {
        "energieherkunft": [
          {
            "erzeugungsart": "EEG"
          }
        ],
        "marktlokationsId": "marktlokationsId",
        "marktrollen": [
          {
            "marktrolle": "NB",
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "rollencodenummer": "rollencodenummer",
            "weiterverpflichtet": true
          }
        ],
        "statusErzeugendeMalo": "EINSPEISEVERGUETUNG_PARAGRAPH_37"
      }
    ],
    "MESSLOKATION": [
      {
        "marktrollen": [
          {
            "marktrolle": "NB",
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "rollencodenummer": "rollencodenummer",
            "weiterverpflichtet": true
          }
        ],
        "messlokationsId": "messlokationsId"
      }
    ],
    "NETZLOKATION": [
      {
        "marktrollen": [
          {
            "marktrolle": "NB",
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "rollencodenummer": "rollencodenummer"
          }
        ],
        "netzlokationsId": "netzlokationsId"
      }
    ],
    "NETZNUTZUNGSVERTRAG": [
      {
        "vertragsbeginn": "2024-08-25T15:00:00Z",
        "vertragsende": "2024-08-25T15:00:00Z"
      }
    ],
    "STEUERBARE_RESSOURCE": [
      {
        "marktrollen": [
          {
            "marktrolle": "NB",
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "rollencodenummer": "rollencodenummer"
          }
        ],
        "ressourcenId": "ressourcenId"
      }
    ],
    "TECHNISCHE_RESSOURCE": [
      {
        "ressourcenId": "ressourcenId"
      }
    ],
    "TRANCHE": [
      {
        "aufteilungsmenge": {
          "einheit": "W",
          "wert": 0
        },
        "bildungTranchengroesse": "PROZENTUAL",
        "tranchenId": "tranchenId"
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "rollencodenummer": "rollencodenummer"
    },
    "kategorie": "kategorie",
    "pruefidentifikator": "55607",
    "sparte": "STROM",
    "transaktionsgrund": "transaktionsgrund",
    "transaktionsgrundergaenzung": "transaktionsgrundergaenzung",
    "transaktionsgrundergaenzungBefristeteAnmeldung": "transaktionsgrundergaenzungBefristeteAnmeldung"
  },
  "zusatzdaten": {
    "eventname": "START_ZUORDNUNG_ERZ_MALO_TRANCHE",
    "prozessId": "prozessId"
  }
}

json

START_ZUORDNUNG_ERZ_MALO_TRANCHE (NB) › Responses

Success | Success

Structure (BO4E)	Description	Format
`businessKey`*	Unique identifier of the business process \| Unique identifier of the business process	string (uuid)
`message`*	Message with details about the triggered event \| Message with details about the triggered event	string

Trigger-Event START_ZUORDNUNG_ERZ_MALO_TRANCHE der Marktrolle NB.

Schema nur dieses Ereignisses herunterladen (OpenAPI, JSON).

Notes on this page

Der Aufruf geht tatsächlich an POST /inbound; das Event ergibt sich aus zusatzdaten.eventname im Rumpf. Diese Seite trennt eine von 104 Rumpfvarianten heraus, damit sie einzeln lesbar und ausprobierbar sind.

Transmission of the delivery note for…

START_ZUORDNUNG_ERZ_MALO_TRANCHE (NB)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (4):

POST/inbound

curl https://api.macoapp.de/inbound \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "stammdaten": {
    "MARKTLOKATION": [
      {
        "energieherkunft": [
          {
            "erzeugungsart": "EEG"
          }
        ],
        "marktlokationsId": "marktlokationsId",
        "marktrollen": [
          {
            "marktrolle": "NB",
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "rollencodenummer": "rollencodenummer",
            "weiterverpflichtet": true
          }
        ],
        "statusErzeugendeMalo": "EINSPEISEVERGUETUNG_PARAGRAPH_37"
      }
    ],
    "MESSLOKATION": [
      {
        "marktrollen": [
          {
            "marktrolle": "NB",
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "rollencodenummer": "rollencodenummer",
            "weiterverpflichtet": true
          }
        ],
        "messlokationsId": "messlokationsId"
      }
    ],
    "NETZLOKATION": [
      {
        "marktrollen": [
          {
            "marktrolle": "NB",
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "rollencodenummer": "rollencodenummer"
          }
        ],
        "netzlokationsId": "netzlokationsId"
      }
    ],
    "NETZNUTZUNGSVERTRAG": [
      {
        "vertragsbeginn": "2024-08-25T15:00:00Z",
        "vertragsende": "2024-08-25T15:00:00Z"
      }
    ],
    "STEUERBARE_RESSOURCE": [
      {
        "marktrollen": [
          {
            "marktrolle": "NB",
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "rollencodenummer": "rollencodenummer"
          }
        ],
        "ressourcenId": "ressourcenId"
      }
    ],
    "TECHNISCHE_RESSOURCE": [
      {
        "ressourcenId": "ressourcenId"
      }
    ],
    "TRANCHE": [
      {
        "aufteilungsmenge": {
          "einheit": "W",
          "wert": 0
        },
        "bildungTranchengroesse": "PROZENTUAL",
        "tranchenId": "tranchenId"
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "rollencodenummer": "rollencodenummer"
    },
    "kategorie": "kategorie",
    "pruefidentifikator": "55607",
    "sparte": "STROM",
    "transaktionsgrund": "transaktionsgrund",
    "transaktionsgrundergaenzung": "transaktionsgrundergaenzung",
    "transaktionsgrundergaenzungBefristeteAnmeldung": "transaktionsgrundergaenzungBefristeteAnmeldung"
  },
  "zusatzdaten": {
    "eventname": "START_ZUORDNUNG_ERZ_MALO_TRANCHE",
    "prozessId": "prozessId"
  }
}'

START_ZUORDNUNG_ERZ_MALO_TRANCHE (NB) › Request Body

Structure (BO4E)	Description	Format	55607
stammdaten*	—	object	Muss
MARKTLOKATION[ ]*	—	object[]	Muss
`marktlokationsId`*00010	Identification number of a market location at which energy is either consumed or generated	string	Muss
`statusErzeugendeMalo`*00020	Status of the generating market location	string	Muss
`EINSPEISEVERGUETUNG_PARAGRAPH_37`			Muss
`GEFOERDERTE_DIREKTVERMARKTUNG`			Muss
`SONSTIGE_DIREKTVERMARKTUNG`			Muss
`VERMARKTUNG_OHNE_GESETZL_VERGUETUNG`			Muss
`KWKG_VERGUETUNG`			Muss
`EINSPEISEVERGUETUNG_PARAGRAPH_38_AUSFALLVERGUETUNG`			Muss
energieherkunft[ ]*	—	object[]	Muss
`erzeugungsart`*00030	Type of generation	string	Muss
`EEG`			Muss
`KWK`			Muss
`EEG_DV`			Muss
`KWK_DV`			Muss
`WIND`			Muss
`SOLAR`			Muss
`KERNKRAFT`			Muss
`WASSER`			Muss
`GEOTHERMIE`			Muss
`BIOMASSE`			Muss
`KOHLE`			Muss
`GAS`			Muss
`SONSTIGE`			Muss
`SONSTIGE_EEG`			Muss
`SONSTIGE_ERZEUGUNGSART`			Muss
marktrollen[ ]*	—	object[]	Muss
`marktrolle`00040	Indicates the designation of the market role in free text.	string	Kann
`NB`			Kann
`LF`			Kann
`MSB`			Kann
`MSBA`			Kann
`GMSB`			Kann
`MDL`			Kann
`DL`			Kann
`BKV`			Kann
`BKO`			Kann
`UENB`			Kann
`KUNDE-SELBST-NN`			Kann
`MGV`			Kann
`EIV`			Kann
`RB`			Kann
`KUNDE`			Kann
`INTERESSENT`			Kann
`KN`			Kann
`UBA`			Kann
`BIKO`			Kann
`ESA`			Kann
`messstellenbetreiberEigenschaft`*00050	MSB property	string	Muss
`GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER`			Muss
`WETTBEWERBLICHER_MESSSTELLENBETREIBER`			Muss
`AUFFANGMESSSTELLENBETREIBER`			Muss
`rollencodenummer`*00060	Specifies the code value of the market role.	string	Muss
`weiterverpflichtet`*00070	weiterverpflichtet	boolean	Muss
MESSLOKATION[ ]*	—	object[]	Muss
`messlokationsId`*00080	The metering location identification. This is the former metering point identifier, e.g. DE 47108151234567	string	Muss
marktrollen[ ]	—	object[]	Kann
`marktrolle`00090	Indicates the designation of the market role in free text.	string	Kann
`NB`			Kann
`LF`			Kann
`MSB`			Kann
`MSBA`			Kann
`GMSB`			Kann
`MDL`			Kann
`DL`			Kann
`BKV`			Kann
`BKO`			Kann
`UENB`			Kann
`KUNDE-SELBST-NN`			Kann
`MGV`			Kann
`EIV`			Kann
`RB`			Kann
`KUNDE`			Kann
`INTERESSENT`			Kann
`KN`			Kann
`UBA`			Kann
`BIKO`			Kann
`ESA`			Kann
`messstellenbetreiberEigenschaft`00100	MSB property	string	Kann
`GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER`			Kann
`WETTBEWERBLICHER_MESSSTELLENBETREIBER`			Kann
`AUFFANGMESSSTELLENBETREIBER`			Kann
`rollencodenummer`00110	Specifies the code value of the market role.	string	Kann
`weiterverpflichtet`00120	weiterverpflichtet	boolean	Kann
NETZLOKATION[ ]	—	object[]	Kann
`netzlokationsId`00130	Identification number of a grid location at which energy is either consumed or generated (Like MarktlokationsId Marktlokation)	string	Kann
marktrollen[ ]	—	object[]	Kann
`marktrolle`00140	Indicates the designation of the market role in free text.	string	Kann
`NB`			Kann
`LF`			Kann
`MSB`			Kann
`MSBA`			Kann
`GMSB`			Kann
`MDL`			Kann
`DL`			Kann
`BKV`			Kann
`BKO`			Kann
`UENB`			Kann
`KUNDE-SELBST-NN`			Kann
`MGV`			Kann
`EIV`			Kann
`RB`			Kann
`KUNDE`			Kann
`INTERESSENT`			Kann
`KN`			Kann
`UBA`			Kann
`BIKO`			Kann
`ESA`			Kann
`messstellenbetreiberEigenschaft`00150	MSB property	string	Kann
`GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER`			Kann
`WETTBEWERBLICHER_MESSSTELLENBETREIBER`			Kann
`AUFFANGMESSSTELLENBETREIBER`			Kann
`rollencodenummer`00160	Specifies the code value of the market role.	string	Kann
NETZNUTZUNGSVERTRAG[ ]	—	object[]	Kann
`vertragsbeginn`00170	Specifies when the contract begins.	string (date-time)	Kann
`vertragsende`00180	Contract end date / DTM+93	string (date-time)	Kann
STEUERBARE_RESSOURCE[ ]	—	object[]	Kann
`ressourcenId`00190	ressourcenId	string	Kann
marktrollen[ ]	—	object[]	Kann
`marktrolle`00200	Indicates the designation of the market role in free text.	string	Kann
`NB`			Kann
`LF`			Kann
`MSB`			Kann
`MSBA`			Kann
`GMSB`			Kann
`MDL`			Kann
`DL`			Kann
`BKV`			Kann
`BKO`			Kann
`UENB`			Kann
`KUNDE-SELBST-NN`			Kann
`MGV`			Kann
`EIV`			Kann
`RB`			Kann
`KUNDE`			Kann
`INTERESSENT`			Kann
`KN`			Kann
`UBA`			Kann
`BIKO`			Kann
`ESA`			Kann
`messstellenbetreiberEigenschaft`00210	MSB property	string	Kann
`GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER`			Kann
`WETTBEWERBLICHER_MESSSTELLENBETREIBER`			Kann
`AUFFANGMESSSTELLENBETREIBER`			Kann
`rollencodenummer`00220	Specifies the code value of the market role.	string	Kann
TECHNISCHE_RESSOURCE[ ]	—	object[]	Kann
`ressourcenId`00230	ressourcenId	string	Kann
TRANCHE[ ]	—	object[]	Kann
`bildungTranchengroesse`00240	BildungTranchengroesse	string	Kann
`PROZENTUAL`			Kann
`AUFTEILUNGSFAKTOR`			Kann
`AUFTEILUNG_TECHNISCHE_RESSOURCEN`			Kann
`BERECHNUNGSFORMEL`			Kann
`tranchenId`00250	tranchenId	string	Kann
aufteilungsmenge	—	object	Kann
`einheit`00260	Unit: measurands that can be determined by measurement or by specification	string	Kann
`W`			Kann
`WH`			Kann
`KW`			Kann
`KWH`			Kann
`KVARH`			Kann
`MW`			Kann
`MWH`			Kann
`STUECK`			Kann
`KUBIKMETER`			Kann
`STUNDE`			Kann
`TAG`			Kann
`MONAT`			Kann
`JAHR`			Kann
`PROZENT`			Kann
`ANZAHL`			Kann
`VAR`			Kann
`KVAR`			Kann
`VARH`			Kann
`KWHK`			Kann
`Z16`			Kann
`KWT`			Kann
`wert`00270	Value	number (float)	Kann
transaktionsdaten*	—	object	Muss
`kategorie`*00280	Qualifier from the beginning of the EDIFACT message / BGM	string	Muss
`pruefidentifikator`00290	Determined dynamically in the event process. A value supplied by the sender is ignored. Check identifiers possible in the topic — 55607.	—	Kann
`sparte`*00300	Contains information about the division	string	Muss
`STROM`			Muss
`GAS`			Muss
`FERNWAERME`			Muss
`NAHWAERME`			Muss
`WASSER`			Muss
`ABWASSER`			Muss
`transaktionsgrund`*00310	The transaction reason describes the business transaction for the category in more detail / UTILMD STS+7++###+ZW4+E03	string	Muss
`transaktionsgrundergaenzung`*00320	Supplement to the transaction reason / UTILMD STS+7++E01+###+E03	string	Muss
`transaktionsgrundergaenzungBefristeteAnmeldung`*00330	Supplement to the transaction reason for temporary registrations/deregistrations / UTILMD STS+7++E01+ZW4+###	string	Muss
absender*	—	object	Muss
`rollencodenummer`00340	Specifies the code value of the market role.	string	Kann
empfaenger*	—	object	Muss
`rollencodenummer`00350	Specifies the code value of the market role.	string	Kann
zusatzdaten*	—	object	Muss
`eventname`*00360	—	string	Muss
`prozessId`*00370	—	string	Muss

Example Request Body

{
  "stammdaten": {
    "MARKTLOKATION": [
      {
        "energieherkunft": [
          {
            "erzeugungsart": "EEG"
          }
        ],
        "marktlokationsId": "marktlokationsId",
        "marktrollen": [
          {
            "marktrolle": "NB",
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "rollencodenummer": "rollencodenummer",
            "weiterverpflichtet": true
          }
        ],
        "statusErzeugendeMalo": "EINSPEISEVERGUETUNG_PARAGRAPH_37"
      }
    ],
    "MESSLOKATION": [
      {
        "marktrollen": [
          {
            "marktrolle": "NB",
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "rollencodenummer": "rollencodenummer",
            "weiterverpflichtet": true
          }
        ],
        "messlokationsId": "messlokationsId"
      }
    ],
    "NETZLOKATION": [
      {
        "marktrollen": [
          {
            "marktrolle": "NB",
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "rollencodenummer": "rollencodenummer"
          }
        ],
        "netzlokationsId": "netzlokationsId"
      }
    ],
    "NETZNUTZUNGSVERTRAG": [
      {
        "vertragsbeginn": "2024-08-25T15:00:00Z",
        "vertragsende": "2024-08-25T15:00:00Z"
      }
    ],
    "STEUERBARE_RESSOURCE": [
      {
        "marktrollen": [
          {
            "marktrolle": "NB",
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "rollencodenummer": "rollencodenummer"
          }
        ],
        "ressourcenId": "ressourcenId"
      }
    ],
    "TECHNISCHE_RESSOURCE": [
      {
        "ressourcenId": "ressourcenId"
      }
    ],
    "TRANCHE": [
      {
        "aufteilungsmenge": {
          "einheit": "W",
          "wert": 0
        },
        "bildungTranchengroesse": "PROZENTUAL",
        "tranchenId": "tranchenId"
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "rollencodenummer": "rollencodenummer"
    },
    "kategorie": "kategorie",
    "pruefidentifikator": "55607",
    "sparte": "STROM",
    "transaktionsgrund": "transaktionsgrund",
    "transaktionsgrundergaenzung": "transaktionsgrundergaenzung",
    "transaktionsgrundergaenzungBefristeteAnmeldung": "transaktionsgrundergaenzungBefristeteAnmeldung"
  },
  "zusatzdaten": {
    "eventname": "START_ZUORDNUNG_ERZ_MALO_TRANCHE",
    "prozessId": "prozessId"
  }
}

json

START_ZUORDNUNG_ERZ_MALO_TRANCHE (NB) › Responses

Success | Success

Structure (BO4E)	Description	Format
`businessKey`*	Unique identifier of the business process \| Unique identifier of the business process	string (uuid)
`message`*	Message with details about the triggered event \| Message with details about the triggered event	string

Trigger-Event START_ZUORDNUNG_ERZ_MALO_TRANCHE der Marktrolle NB.

Schema nur dieses Ereignisses herunterladen (OpenAPI, JSON).

Notes on this page

Feedback on the documentation

Feedback on the documentation

Case 1: LF assignment for…

START_ZUORDNUNG_ERZ_MALO_TRANCHE (NB)

START_ZUORDNUNG_ERZ_MALO_TRANCHE (NB) › Request Body

START_ZUORDNUNG_ERZ_MALO_TRANCHE (NB) › Responses

Case 1: LF assignment for…

START_ZUORDNUNG_ERZ_MALO_TRANCHE (NB)

START_ZUORDNUNG_ERZ_MALO_TRANCHE (NB) › Request Body

START_ZUORDNUNG_ERZ_MALO_TRANCHE (NB) › Responses