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)

Energiemengen aus Abrechnungskontext lesen

Developing
GET
/getEnergyAmount
OperationId:LESEN_ENERGIEMENGE_ENERGIEMENGE
Lesen der Energiemengen aus Abrechnungskontext über eine LokationId (Parameter1) und LokationsTyp (Parameter2) in einer Range (Parameter3/Parameter4) und einer OBIS Kennzahl (Parameter5 optional)

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 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
Previous
Energieliefervertrag lesen
Next
Lastgangs einer Lokation lesen