MACO APP | DOC
FUM 04 / 26
  • FUM 10 / 25
  • FUM 04 / 25
  • FUM 04 / 26
Schnittstellen
ProzessdokumentationenBO4E Geschäftsobjekte
Schnittstellen
ProzessdokumentationenBO4E Geschäftsobjekte
FUM 04 / 26
  • FUM 10 / 25
  • FUM 04 / 25
  • FUM 04 / 26
FUM 04 / 26
  • FUM 10 / 25
  • FUM 04 / 25
  • FUM 04 / 26
  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)
      • Anfrage nach Stornierung
      • Übermittlung von Zählerständen vom LF
      • Bestellung zur Stammdatenänderung an NB / MSB (Lieferant)
      • Reklamation von Werten
      • Bestellung Abrechnungsdaten
      • Kommunikationsdatenblatt PARTIN
    • 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
      • Anfrage nach Stornierung
      • Überprüfung einner EEG-Marklokation mit DV-Pflicht auf 100% LF-Zuordnung (Rolle NB)
      • Übermittlung des Lieferscheins zur Netznutzungsabrechnung
      • Übermittlung von Zählerständen vom NB
      • Widerspruch gegen Ablehnung
      • Stornierung Lieferschein
    • Einzelansicht MSB
      • Stammdatenänderung vom Messstellenbetreiber (verantwortlich)
    • Anfrage nach Stornierung
    • 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
    • Preisblatt lesen
      GET
    • Steuerbare Ressource lesen
      GET
    • Technische Ressource lesen
      GET
    • Tranche lesen
      GET
    • Zähler lesen
      GET
    • Schaltzeitdefinition lesen
      GET
    • Leistungskurvendefinition lesen
      GET
    • Zaehlzeitdefinition lesen
      GET
    • Lokation identifizieren
      POST
  • 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
  • LOKATIONIDENT
    • Übersicht
    • Identifizierung der Lokation
    • Stammdaten der identifiz. MaLo
    • Prozessdaten aktualisieren
  • 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
Bodyapplication/json

Example
[
    {
        "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": {
            "netznutzungszahler": "LIEFERANT",
            "netznutzungsvertrag": "LIEFERANTEN_NB",
            "netznutzungsabrechnung": {
                "dauer": 366,
                "startdatum": "2027-03-27T23:00:00Z",
                "enddatum": "2028-03-28T21:59:59Z",
                "abrechnungsZeitraum": "0328"
            },
            "beinhaltetSingulaerGenutzteBetriebsmittel": false,
            "netznutzungsabrechnungsgrundlage": "LIEFERSCHEIN",
            "haushaltskunde": true,
            "abrechnungUeberNna": true,
            "startAbrechnungsjahr": "20260523",
            "abrechnungsintervall": 12,
            "netznutzungsabrechnungIntervall": 12,
            "kuendigungsfrist": {
                "startdatum": "2026-05-22T22:00:00Z",
                "enddatum": "9999-12-31T23:59:59Z",
                "zeitraumText": "01MT"
            },
            "vertragslaufzeit": {
                "startdatum": "2026-05-22T22:00:00Z",
                "enddatum": "2027-05-22T22:00:00Z"
            },
            "kuendigungstermin": "2027-04-22T22:00:00Z",
            "abschlagszyklus": {
                "zeiteinheit": "MONAT",
                "dauer": 1
            },
            "anzahlAbschlaege": 12,
            "vertragsverlaengerung": {
                "startdatum": "2026-05-22T22:00:00Z",
                "enddatum": "9999-12-31T23:59:59Z"
            }
        },
        "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