Abrechnungsdaten Netznutzungsabrechnung versenden - MACO APP

Triggert den Versand von Abrechnungsdaten Netznutzungsabrechnung Nachrichten an Marktpartner durch die MACO APP. Die Anfrage wird identifiziert durch den Eventnamen START_ABR_NN. Zusätzlich ist eine eindeutige ID prozessId aus dem Backend mit zu übergeben, mit der die spätere Antwort vom Marktpartner wieder an das Backend übergeben werden kann.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

stammdaten

object

required

BILANZIERUNG

array [object {1}]

optional

MARKTLOKATION

array [object {5}]

required

NETZNUTZUNGSVERTRAG

array [object {2}]

required

VERWENDUNGSZEITRAUM

array [object {6}]

required

transaktionsdaten

object

required

kategorie

enum<string>

Anfragekategorie

required

Anfragekategorie | EDIFACT: BGM+E03

Allowed values:

PROZESSDATENBERICHTGERAETEUEBERNAHMEWEITERVERPFLICHTUNG_BETRIEB_MELOAENDERUNG_MELOSTAMMDATEN_MALO_ODER_MELOBILANZIERTE_MENGE_MEHR_MINDER_MENGENALLOKATIONSLISTE_MEHR_MINDER_MENGENENERGIEMENGE_UND_LEISTUNGSMAXIMUMABRECHNUNG_MESSSTELLENBETRIEB_MSB_AN_LFAENDERUNG_PROGNOSEGRUNDLAGE_GERAETEKONFIGURATIONAENDERUNG_GERAETEKONFIGURATIONREKLAMATION_VON_WERTENLASTGANG_MALO_TRANCHESPERRUNGENTSPERRUNGREKLAMATION_ZAEHLZEITDEFINITIONZEITREIHEN_IM_RAHMEN_BILANZKREISABRECHNUNGGERAETEWECHSELABSICHTAENDERUNG_KONZESSIONSABGABEAENDERUNG_ZAEHLZEITDEFINITIONUEBERMITTLUNG_WERTE_AN_ESAAENDERUNGBILANZKREISZUORDNUNGSLISTECLEARINGLISTENORMIERTES_PROFIL_PROFILSCHARREDISPATCH_EINZELZEITREIHE_AUSFALLARBEITREKLAMATION_PROFIL_PROFILSCHARSTAMMDATEN_MALOSTAMMDATEN_MELOSTAMMDATEN_TRANCHEBEENDIGUNG_EINER_KONFIGURATIONBESTELLUNG_EINER_KONFIGURATIONBESTELLUNG_EINES_ANGEBOTS_EINER_KONFIGURATIONREKLAMATION_EINER_KONFIGURATIONBESTELLUNG_AENDERUNG_NETZENTGELTE_NETZORIENTIERTER_STEUERUNGSMOEGLICHKEITAENDERUNG_DER_TECHNIK_DER_LOKATIONAENDERUNG_INDIVIDUELLER_KONFIGURATIONBESTELLUNG_AENDERUNG_ABRECHNUNGSDATENEINRICHTUNG_KONFIGURATION_AUFGRUND_ZUORDNUNG_LFREKLAMATION_DEFINITION

absender

object

required

nachrichtendatum

string <date-time>

optional

Erstellungdatum der EDIFact / DTM+137 | EDIFACT: DTM+137

empfaenger

object

required

transaktionsgrund

string

optional

Der Transaktionsgrund beschreibt den Geschäftsvorfall zur Kategorie genauer / UTILMD STS+7++###+ZW4+E03 | EDIFACT: SG4.IDE+24.STS+7

zusatzdaten

object

required

prozessId

string

required

Id des Dokuments / Beleges im Backend. Wird genutzt um die Antwort zuzuordnen.

Example:

00505688-E4A2-1EDF-A0C2-C81842E2515E

eventname

enum<string>

required

Name des Events

Allowed value:

START_ABR_NN

Default:

START_ABR_NN

Example

{
  "stammdaten": {
    "MARKTLOKATION": [
      {
        "boTyp": "MARKTLOKATION",
        "versionStruktur": "1",
        "marktlokationsId": "50754496000",
        "sparte": "STROM",
        "erforderlichesProduktpaket": [
          {
            "produktpaketId": 1,
            "produkt": [
              {
                "produktCode": "9991000002082",
                "wertedetails": "11Y0-0000-0077-K"
              },
              {
                "produktCode": "9991000002008",
                "codeProdukteigenschaft": "9991000002115"
              }
            ],
            "umsetzungsgradvorgabe": "ZUORDNUNG_NUR_WENN_PRODUKTPAKET_UMSETZBAR"
          }
        ]
      }
    ],
    "NETZNUTZUNGSVERTRAG": [
      {
        "boTyp": "VERTRAG",
        "versionStruktur": "1",
        "vertragsart": "NETZNUTZUNGSVERTRAG",
        "sparte": "STROM",
        "vertragsbeginn": "2025-10-31T23:00:00Z",
        "vertragskonditionen": {
          "haushaltskunde": true
        }
      }
    ],
    "ENERGIELIEFERVERTRAG": [
      {
        "boTyp": "VERTRAG",
        "versionStruktur": "1",
        "vertragsart": "ENERGIELIEFERVERTRAG",
        "sparte": "STROM",
        "vertragspartner2": [
          {
            "boTyp": "GESCHAEFTSPARTNER",
            "versionStruktur": "1",
            "anrede": "Herr",
            "name1": "Glöppel",
            "name2": "Walter",
            "gewerbekennzeichnung": false,
            "geschaeftspartnerrolle": [
              "KUNDE"
            ]
          }
        ],
        "korrespondenzpartner": {
          "boTyp": "GESCHAEFTSPARTNER",
          "versionStruktur": "1",
          "name1": "Glöppel",
          "gewerbekennzeichnung": false,
          "partneradresse": {
            "postleitzahl": "41515",
            "ort": "Grevenbroich",
            "strasse": "Bahnstraße",
            "hausnummer": "49",
            "landescode": "DE"
          }
        },
        "enFG": [
          {
            "grundlageVerringerungUmlagen": "ERFUELLT_VORAUSSETZUNG_NACH_ENFG",
            "grund": [
              "ENFG_ELEKTRISCH_ANGETRIEBENE_WAERMEPUMPEN"
            ]
          }
        ]
      }
    ]
  },
  "transaktionsdaten": {
    "sparte": "STROM",
    "transaktionsgrund": "E01",
    "transaktionsgrundergaenzung": "ZW4",
    "absender": {
      "boTyp": "MARKTTEILNEHMER",
      "versionStruktur": "1",
      "rollencodenummer": "9903526000002",
      "rollencodetyp": "BDEW"
    },
    "empfaenger": {
      "boTyp": "MARKTTEILNEHMER",
      "versionStruktur": "1",
      "rollencodenummer": "9900683000008",
      "rollencodetyp": "BDEW"
    },
    "kategorie": "E01"
  },
  "zusatzdaten": {
    "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E",
    "eventname": "START_ABR_NN"
  }
}

Responses

🟢201Created

application/json

Erfolg | Success

Body

Erfolgsmeldung auf Prozessdaten API Aufruf

businessKey

string <uuid>

required

Einzigartige Kennung des Geschäftsprozesses

message

string

required

Nachricht mit Details zum ausgelösten Even

Example:

received event XXXXXXXXXXXX with id at 2024-08-08T12:58:22Z and started process with businessKey 4c7170ed-3518-41ee-8582-39ab65b00107

Example

{
  "businessKey": "2318a5eb-43aa-4608-9ea1-3dcf2eacc794",
  "message": "received event XXXXXXXXXXXX with id at 2024-08-08T12:58:22Z and started process with businessKey 4c7170ed-3518-41ee-8582-39ab65b00107"
}

🟠400Bad Request