Ersatz-/Grundversorgung - MACO APP

Prozess zur Anmeldung von Ersatz-/Grundversorgung starten.

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

ENERGIELIEFERVERTRAG

array [object {4}]

required

NETZNUTZUNGSVERTRAG

array [object {4}]

required

MARKTLOKATION

array [object {8}]

required

NETZLOKATION

array [object {3}]

optional

STEUERBARE_RESSOURCE

array [object {3}]

optional

BILANZIERUNG

array [object {5}]

required

MESSLOKATION

array [object {3}]

optional

TECHNISCHE_RESSOURCE

array [object {1}]

optional

transaktionsdaten

object

required

vertragsende

string <date-time>

optional

Datum Vertragsende / DTM+93 | EDIFACT: SG4.IDE+24.DTM+93

transaktionsgrundergaenzungBefristeteAnmeldung

string

optional

Ergänzung zum Transaktionsgrund bei befristeten An-/Abmeldungen / UTILMD STS+7++E01+ZW4+### | EDIFACT: SG4.IDE+24.STS+7

empfaenger

object

required

anfragereferenznummer

string

optional

Referenz Vorgangsnummer 'aus Anfragenachricht' / ORDERS RFF+TN / IFTSTA RFF+AAV / INSRPT RFF+TN RFF+AAV | EDIFACT: SG4.IDE+24.SG6.RFF+TN

absender

object

required

transaktionsgrund

string

required

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

transaktionsgrundergaenzung

string

required

Ergänzung zum Transaktionsgrund / UTILMD STS+7++E01+###+E03 | EDIFACT: SG4.IDE+24.STS+7

vertragsbeginn

string <date-time>

required

Datum Vertragsbeginn / DTM+92 | EDIFACT: SG4.IDE+24.DTM+92

sparte

string

required

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_EOG

Default:

START_EOG

Example

{
  "stammdaten": {
    "ENERGIELIEFERVERTRAG": [
      {
        "vertragspartner2": [
          {
            "name1": "string",
            "name3": "string",
            "name4": "string",
            "geschaeftspartnerrolle": "KUNDE",
            "name2": "string",
            "anrede": "string"
          }
        ],
        "korrespondenzpartner": {
          "name3": "string",
          "name4": "string",
          "partneradresse": {
            "landescode": "AC",
            "ortsteil": "string",
            "hausnummer": "string",
            "ort": "string",
            "postleitzahl": "string",
            "strasse": "string",
            "postfach": "string"
          },
          "name1": "string",
          "anrede": "string",
          "name2": "string"
        },
        "enFG": [
          {
            "grundlageVerringerungUmlagen": "string",
            "grund": "string"
          }
        ],
        "vertragsart": "ENERGIELIEFERVERTRAG"
      }
    ],
    "NETZNUTZUNGSVERTRAG": [
      {
        "vertragspartner2": [
          {
            "name1": "string",
            "anrede": "string",
            "geschaeftspartnerrolle": "KUNDE",
            "name3": "string",
            "name4": "string",
            "name2": "string"
          }
        ],
        "korrespondenzpartner": {
          "partneradresse": {
            "postfach": "string",
            "ortsteil": "string",
            "postleitzahl": "string",
            "ort": "string",
            "landescode": "AC",
            "strasse": "string",
            "hausnummer": "string"
          },
          "name2": "string",
          "anrede": "string",
          "name4": "string",
          "name3": "string",
          "name1": "string"
        },
        "vertragskonditionen": {
          "haushaltskunde": true
        },
        "vertragsart": "NETZNUTZUNGSVERTRAG"
      }
    ],
    "MARKTLOKATION": [
      {
        "marktlokationsId": "string",
        "datenqualitaet": "ERWARTETE_DATEN",
        "hausverwalter": {
          "partneradresse": {
            "ortsteil": "string",
            "landescode": "AC",
            "strasse": "string",
            "postfach": "string",
            "postleitzahl": "string",
            "hausnummer": "string",
            "ort": "string"
          },
          "name1": "string",
          "name4": "string",
          "anrede": "string",
          "gewerbekennzeichnung": true,
          "name2": "string",
          "name3": "string"
        },
        "lokationsadresse": {
          "landescode": "AC",
          "zusatzInformation": {
            "zusatz4": "string",
            "zusatz1": "string",
            "zusatz2": "string",
            "zusatz5": "string",
            "zusatz3": "string"
          },
          "ortsteil": "string",
          "postleitzahl": "string",
          "strasse": "string",
          "hausnummer": "string",
          "ort": "string",
          "postfach": "string"
        },
        "eigentuemer": {
          "name3": "string",
          "name4": "string",
          "name2": "string",
          "name1": "string",
          "partneradresse": {
            "strasse": "string",
            "postfach": "string",
            "ort": "string",
            "postleitzahl": "string",
            "hausnummer": "string",
            "landescode": "AC",
            "ortsteil": "string"
          },
          "gewerbekennzeichnung": true,
          "anrede": "string",
          "boTyp": "string",
          "versionStruktur": "string"
        },
        "marktrollen": [
          {
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "weiterverpflichtet": true,
            "marktrolle": "NB",
            "rollencodenummer": "string",
            "boTyp": "string",
            "versionStruktur": "string"
          }
        ],
        "sperrstatus": "ENTSPERRT",
        "netzebene": "NSP"
      }
    ],
    "NETZLOKATION": [
      {
        "marktrollen": [
          {
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "rollencodenummer": "string",
            "marktrolle": "NB",
            "boTyp": "string",
            "versionStruktur": "string"
          }
        ],
        "netzlokationsId": "string",
        "datenqualitaet": "string"
      }
    ],
    "STEUERBARE_RESSOURCE": [
      {
        "ressourcenId": "string",
        "marktrollen": [
          {
            "marktrolle": "NB",
            "rollencodenummer": "string",
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "boTyp": "string",
            "versionStruktur": "string"
          }
        ],
        "datenqualitaet": "string"
      }
    ],
    "BILANZIERUNG": [
      {
        "prognosegrundlage": "WERTE",
        "temperaturarbeit": {
          "wert": {},
          "einheit": "W"
        },
        "jahresverbrauchsprognose": {
          "einheit": "W",
          "wert": {}
        },
        "detailsPrognosegrundlage": [
          [
            "SLP_SEP"
          ]
        ],
        "datenqualitaet": "string"
      }
    ],
    "MESSLOKATION": [
      {
        "marktrollen": [
          {
            "weiterverpflichtet": true,
            "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
            "rollencodenummer": "string",
            "marktrolle": "NB",
            "boTyp": "string",
            "versionStruktur": "string"
          }
        ],
        "messlokationsId": "string",
        "datenqualitaet": "string"
      }
    ],
    "TECHNISCHE_RESSOURCE": [
      {
        "ressourcenId": "string"
      }
    ]
  },
  "transaktionsdaten": {
    "vertragsende": "2019-08-24T14:15:22Z",
    "transaktionsgrundergaenzungBefristeteAnmeldung": "string",
    "empfaenger": {
      "rollencodetyp": "BDEW",
      "rollencodenummer": "string",
      "marktrolle": "string",
      "boTyp": "string",
      "versionStruktur": "string"
    },
    "anfragereferenznummer": "string",
    "absender": {
      "rufnummern": [
        {
          "nummerntyp": "RUF_ZENTRALE",
          "rufnummer": {}
        }
      ],
      "rollencodenummer": "string",
      "ansprechpartner": {
        "eMailAdresse": "string",
        "nachname": "string"
      },
      "rollencodetyp": "BDEW",
      "marktrolle": "string",
      "boTyp": "string",
      "versionStruktur": "string"
    },
    "transaktionsgrund": "string",
    "transaktionsgrundergaenzung": "string",
    "vertragsbeginn": "2019-08-24T14:15:22Z",
    "sparte": "string"
  },
  "zusatzdaten": {
    "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E",
    "eventname": "START_EOG"
  }
}

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