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 Amount

Developing
GET
/getEnergyAmountOracle
Reading the energy quantities from the accounting context for a locationId (parameter1) and locationType (parameter2) within a range (parameter3/parameter4) and optionally by an OBIS code (parameter5).

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 '/getEnergyAmountOracle?parameter1&parameter2&parameter3&parameter4&parameter5&command=LESEN_ENERGIEMENGE_ENERGIEMENGE' \
--header 'Authorization: Bearer <token>'

Responses

🟢200OK
application/json
Erfolgreiches Lesen der Energiemenge | Successful reading of the energy quantity
Body

Example
{
    "boTyp": "ENERGIEMENGE",
    "versionStruktur": "1",
    "lokationsId": "DE36854189874FDVFMOZZNWOTQ2BIGVPP",
    "lokationsTyp": "MELO",
    "energieverbrauch": [
        {
            "startdatum": "2022-10-14T07:52:00Z",
            "enddatum": "2022-10-14T07:52:00Z",
            "wertermittlungsverfahren": " ",
            "messwertstatus": "ABGELESEN",
            "statuszusatzinformationen": [
                {
                    "art": "PLAUSIBILISIERUNGHINWEIS",
                    "status": "PLAUSIBEL_WG_KONTROLLABLESUNG"
                }
            ],
            "obiskennzahl": "1-1:1.8.2",
            "wert": 5,
            "einheit": "KWH",
            "type": "VERANSCHLAGTEJAHRESMENGE",
            "tarifstufe": "TARIFSTUFE_0",
            "nutzungszeitpunkt": "2022-10-14T07:52:00Z",
            "ausfuehrungszeitpunkt": "2022-10-14T07:52:00Z",
            "position": 1,
            "ablesedatum": "2022-10-14T07:52:00Z",
            "leistungsperiode": "202302"
        }
    ],
    "fertigstellungsdatum": "2022-10-14T07:52:00Z",
    "startdatum": "2022-10-14T07:52:00Z",
    "enddatum": "2022-10-14T07:52:00Z",
    "bilanzierungsdatum": "2022-10-14T07:52:00Z",
    "beginndatum": "202406",
    "referenzStammdatenmeldungMsb": "941736BGM",
    "konfiguration": "xyz"
}
🟠400Bad Request
Modified at 2025-10-21 09:13:19
Previous
Get The Load Profile
Next
Get Energy Supply Contract
Built with