MACO APP DOCS
  1. Read BO4E (Backend)
MACO APP DOCS
  • Kundendokumentation
    • Oracle
      • API Docs
        • Overview
        • Error codes
        • Changelog Interfaces
        • Business Objects
        • Integration Layer
        • Trigger Events (MACO APP)
          • Role Supplier (LF)
            • Start of delivery
        • Read BO4E (Backend)
          • Get Communication Data
            GET
          • Get Meter
            GET
          • Get Tranche
            GET
          • Get Technical Resource
            GET
          • Get Controllable Resource
            GET
          • Get Grid Usage Contract
            GET
          • Get Grid Location
            GET
          • Get Metering Point Operation Contract
            GET
          • Get Meter Location
            GET
          • Get Market Location
            GET
          • Get Location Bundle
            GET
          • Get Meter Readings
            GET
          • Get The Load Profile
            GET
          • Get Energy Amount
            GET
          • Get Energy Supply Contract
            GET
          • Get Balance Sheet
            GET
          • Get CalculationFormula
            GET
          • Get Avis
            GET
        • Read Process Data (Backend)
          • Get Allocation Authorization
        • Write Process Data LF (Backend)
          • Create Process Data
          • Update Process Data
      • Process Docs
        • Supplier
          • Start of delivery (Role supplier new)
            • Process overview
  1. Read BO4E (Backend)

Get Energy Supply Contract

GET
/getEnergySupplyContractBasicOracle
Reading the energy supply contract of a location (parameter1) of type (parameter2 – default MaLo) as of the key date (parameter3)

Request

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

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/getEnergySupplyContractBasicOracle?parameter1&parameter2&parameter3&parameter4&command=LESEN_ENERGIELIEFERVERTRAG_BASIS' \
--header 'Authorization: Bearer <token>'

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
Modified at 2025-10-21 09:13:23
Previous
Get Energy Amount
Next
Get Balance Sheet
Built with