MACO APP | DOC
FUM 10 / 25
  • FUM 10 / 25
  • FUM 04 / 25
SchnittstellenProzessdokumentationenBO4E Geschäftsobjekte
SchnittstellenProzessdokumentationenBO4E Geschäftsobjekte
FUM 10 / 25
  • FUM 10 / 25
  • FUM 04 / 25
  1. BO4E Lesen (Backend)
  • Übersicht
  • Änderungsprotokoll Schnittstellen
  • Fehlercodes
  • Geschäftsobjekte
  • Trigger (MACO APP)
    • Einzelansicht LF
      • ECS Steuerprozess Lieferbeginn
      • Identifikation einer Marktlokation
      • Kündigungsprozess zwischen Lieferanten
      • Lieferbeginn
      • Lieferende von Lieferant an Netzbetreiber
      • Stammdatenänderung vom Lieferanten (verantwortlich)
    • Einzelansicht NB
      • Anfrage zur Beendigung der Zuordnung des LFA zur Marktlokation bzw. Tranche
      • Aufhebung der Zuordnung des LFZ zur Marklokation bzw. Tranche versenden
      • Beendigung der Zuordnung des LFA zur Marklokation bzw. Tranche
      • Abrechnungsdaten Netznutzungsabrechnung versenden
      • Abrechnungsdaten Bilanzkreisabrechnung versenden
      • Stammdatenänderung vom Netzbetreiber (verantwortlich)
      • Einrichtung der Konfigurationen aufgrund einer Zuordnung eines LF zu einer MaLo oder Tranche
      • Übermittlung der Berechnungsformel
      • Wiederherstellung Anschlussnutzung nach LB
      • Lieferende von Netzbetreiber an Lieferant
      • Ersatz-/Grundversorgung
    • Einzelansicht MSB
      • Stammdatenänderung vom Messstellenbetreiber (verantwortlich)
    • Trigger Events
    • Authentifizierung
  • BO4E Lesen (Backend)
    • Avis lesen
      GET
    • Berechnungsformel lesen
      GET
    • Bilanzierung lesen
      GET
    • Energieliefervertrag lesen
      GET
    • Energiemengen aus Abrechnungskontext lesen
      GET
    • Lastgangs einer Lokation lesen
      GET
    • Zählerstand einer Lokation lesen
      GET
    • Kommunikationsdaten des Serviceanbieters lesen
      GET
    • Lokationsbündel lesen
      GET
    • Marktlokation lesen
      GET
    • Messlokation lesen
      GET
    • Messstellenbetriebsvertrag lesen
      GET
    • Netzlokation lesen
      GET
    • Netznutzungsvertrag lesen
      GET
    • Steuerbare Ressource lesen
      GET
    • Technische Ressource lesen
      GET
    • Tranche lesen
      GET
    • Zähler lesen
      GET
  • Prozessdaten lesen (Backend)
    • Zuordnungsemächtigung lesen
  • Prozessdaten LF (Backend)
    • Prozessdaten aktualiseren
    • Prozessdaten erstellen
  • Prozessdaten NB (Backend)
    • Prozessdaten aktualiseren
    • Prozessdaten erstellen
  • Prozessdaten MSB (Backend)
    • Prozessdaten aktualiseren
    • Prozessdaten erstellen
  • MaloIdent LF (Backend)
    • Prozessdaten aktualisieren
    • Identifikation einer Marktlokation
  • MaloIdent NB (Backend)
    • Identifizierung der MaLo
    • Stammdaten der identifiz. MaLo
  • Obsolet
    • Verwendungszeitraum einer Marktlokation ermitteln
    • Absenderdaten lesen
    • Empfängerdaten lesen
  • MaLo-Ident
    • Übersicht
    • MaloIdent Anfrage auslösen
      POST
    • Identifizierung der MaLo
      POST
    • Stammdaten der identifiz. MaLo
      GET
    • Prozessdaten aktualisieren
      POST
  • MCS Eingang (MACO APP)
    • Empfang einer Marktnachricht
  1. BO4E Lesen (Backend)

Energieliefervertrag lesen

GET
/getEnerySupplyContractBasic
OperationId:LESEN_ENERGIELIEFERVERTRAG_BASIS
Lesen des Energieliefervertrages einer Lokation (Parameter1) vom Typ (Parameter2 - default MALO) zum Stichtag (Parameter3)

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params

Responses

🟢200OK
application/json
Erfolgreiches Lesen des Energieliefervertrages
Body

Example
{
    "stammdaten": {
        "ENERGIELIEFERVERTRAG": [
            {
                "boTyp": "VERTRAG",
                "versionStruktur": "1",
                "gueltigkeitszeitraum": {
                    "zeitraumId": null,
                    "startdatum": null,
                    "enddatum": null
                },
                "datenqualitaet": null,
                "vertragsnummer": "12345",
                "beschreibung": "XYZ",
                "vertragsart": "ENERGIELIEFERVERTRAG",
                "vertragstatus": "GEKUENDIGT",
                "sparte": "STROM",
                "vertragsbeginn": "0001-01-01T00:00:00Z",
                "vertragsende": "9999-12-31T23:59:59Z",
                "vertragspartner2": [
                    {
                        "boTyp": "GESCHAEFTSPARTNER",
                        "versionStruktur": "1",
                        "gewerbekennzeichnung": false,
                        "anrede": "Herr",
                        "name1": "Haiko",
                        "name2": "Fisch",
                        "name3": null,
                        "geschaeftspartnerrolle": [
                            "KUNDE"
                        ],
                        "partneradresse": {
                            "postleitzahl": "65189",
                            "ort": "Wiesbaden",
                            "strasse": "Korallenweg",
                            "hausnummer": "10",
                            "postfach": null,
                            "adresszusatz": null,
                            "coErgaenzung": null,
                            "landescode": "DE",
                            "ortsteil": "Riff"
                        },
                        "externeReferenzen": [
                            {
                                "exRefName": "Kundennummer beim Altlieferanten",
                                "exRefWert": "NummerLFA123456_Z01"
                            }
                        ]
                    }
                ],
                "vertragskonditionen": {
                    "kuendigungsfrist": {
                        "zeitraumText": null
                    },
                    "kuendigungstermin": "2025-07-31T23:00:00Z",
                    "abrechnungsintervall": null
                },
                "korrespondenzpartner": {
                    "boTyp": "GESCHAEFTSPARTNER",
                    "versionStruktur": "1",
                    "anrede": "Herr",
                    "name1": "Hai",
                    "name2": "Fisch",
                    "name3": null,
                    "gewerbekennzeichnung": false,
                    "partneradresse": {
                        "postleitzahl": "65189",
                        "ort": "Wiesbaden",
                        "strasse": "Körallenweg",
                        "hausnummer": "10",
                        "postfach": null,
                        "adresszusatz": null,
                        "coErgaenzung": null,
                        "landescode": "DE",
                        "ortsteil": "Riff"
                    }
                },
                "lokationsId": "50754496000",
                "lokationsTyp": "MALO",
                "enFG": [
                    {
                        "grundlageVerringerungUmlagen": "KEINE_ANGABE",
                        "grund": [
                            null
                        ]
                    }
                ]
            }
        ]
    }
}
🟠400Bad Request
Previous
Bilanzierung lesen
Next
Energiemengen aus Abrechnungskontext lesen