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)

Messlokation lesen

GET
/getMeterLocationBasic
OperationId:LESEN_MESSLOKATION_BASIS
Lesen einer MeLo mittels LokationsId (Parameter1) zum Zeitpunkt (Parameter2) \ \ Reading a MeLo using location ID (Parameter1) at the time (Parameter2)

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 Messlokation | Successful reading of the metering location
Body

Example
{
  "boTyp": "MESSLOKATION",
  "versionStruktur": "1",
  "messlokationsId": "963751583864571444542241001807710",
  "sparte": "STROM",
  "energierichtung": "AUSSP",
  "netzebenemessung": "ND",
  "messgebietNr": "5252540425",
  "grundzustaendigerMSBCodeNr": "0584087935",
  "messadresse": {
    "postleitzahl": "96930",
    "ort": "Siemonburg",
    "strasse": "Müritzstr.",
    "hausnummer": "2",
    "postfach": "consectetur do",
    "adresszusatz": "ex ullamco nulla consectetur ea",
    "coErgaenzung": "ut esse",
    "landescode": "TO",
    "ortsteil": "Neu Laila",
    "zusatzInformation": {
      "zusatz1": "ullamco ut enim commodo",
      "zusatz2": "ex",
      "zusatz3": "Lorem sit tempor",
      "zusatz4": "consequat non officia aliqua",
      "zusatz5": "enim esse mollit minim"
    }
  },
  "bilanzierungsmethode": "TLP_GEMEINSAM",
  "abrechnungmessstellenbetriebnna": true,
  "gasqualitaet": "L_GAS",
  "verlustfaktor": 1.25,
  "betriebszustand": "REGELBETRIEB",
  "ablesekartenempfaenger": {
    "boTyp": "GESCHAEFTSPARTNER",
    "versionStruktur": "1",
    "anrede": "Frau",
    "name1": "Jess",
    "name2": "Rahel",
    "name3": "laborum esse",
    "name4": "id culpa consequat",
    "umsatzsteuerId": "DE111000001",
    "glaeubigerId": "922217",
    "emailAdresse": "Ashley39@gmail.com",
    "website": "https://sagenhaft-meteorologie.net/",
    "gewerbekennzeichnung": false,
    "hrnummer": "148223",
    "amtsgericht": "Aignerburg",
    "partneradresse": {
      "postleitzahl": "75930",
      "ort": "Alt Arved",
      "strasse": "Steinbücheler Str.",
      "hausnummer": "26c",
      "postfach": "veniam",
      "adresszusatz": "ut",
      "coErgaenzung": "ad qui ex",
      "landescode": "DM",
      "ortsteil": "Osnabrück",
      "zusatzInformation": {
        "zusatz1": "voluptate",
        "zusatz2": "commodo nulla",
        "zusatz3": "minim in",
        "zusatz4": "commodo et sed ipsum reprehenderit",
        "zusatz5": "reprehenderit occaecat sint commodo deserunt"
      }
    },
    "externeKundenummerLieferant": "651247",
    "externeReferenzen": [
      {
        "exRefName": "Kundennummer beim Lieferanten",
        "exRefWert": "0785635775"
      }
    ],
    "geschaeftspartnerrolle": [
      "LIEFERANT"
    ],
    "kontaktweg": [
      "SMS"
    ]
  },
  "referenzMarktlokationsId": "68887262736",
  "verwendungsumfang": "MESSLOKATION_PROZESSUAL_BEHANDELT",
  "zukuenftigerMeldepunkt": false,
  "lokationszuordnung": "BEGINNT",
  "beteiligterMarktpartner": {
    "boTyp": "MARKTTEILNEHMER",
    "versionStruktur": "1",
    "geschaeftspartnerrolle": "MARKTPARTNER",
    "anrede": "Dr.",
    "name1": "Schmidtchen",
    "name2": "Enie",
    "name3": "dolor enim dolor anim",
    "name4": "veniam non incididunt consectetur esse",
    "partneradresse": {
      "postleitzahl": "75004",
      "ort": "Schäfferburg",
      "strasse": "Löfflerstr.",
      "hausnummer": "1",
      "postfach": "laborum",
      "adresszusatz": "consequat",
      "coErgaenzung": "Excepteur occaecat aliquip veniam nostrud",
      "landescode": "TZ",
      "ortsteil": "Gollerstadt",
      "zusatzInformation": {
        "zusatz1": "proident dolor in ea",
        "zusatz2": "enim",
        "zusatz3": "ex minim consequat mollit",
        "zusatz4": "nulla Lorem",
        "zusatz5": "et eiusmod"
      }
    },
    "gewerbekennzeichnung": true,
    "externeKundenummerLieferant": "Duis sed ullamco ut",
    "marktrolle": "KN",
    "rollencodenummer": "103962598",
    "rollencodetyp": "GLN",
    "umsatzsteuerId": "DE110000001",
    "steuernummer": "868805519",
    "ansprechpartner": {
      "boTyp": "ANSPRECHPARTNER",
      "versionStruktur": "1",
      "nachname": "Schulte",
      "eMailAdresse": "Delia_Zuber@yahoo.com",
      "rufnummern": [
        {
          "nummerntyp": "RUF_DURCHWAHL",
          "rufnummer": "(02074) 0192292"
        }
      ]
    },
    "makoadresse": "in ut ex nulla",
    "downloadlinkZertifikat": "https://unfassbar-fuball.org/",
    "amtsgericht": "Rheine",
    "hrnummer": "501520",
    "website": "https://leger-stunde.ch/",
    "faxnummer": "+49-946-7543171",
    "kommunikationsrolle": "RAHMENVERTRAEGE",
    "weiterverpflichtet": true,
    "kommunikationsparameter": {
      "zieladresse": {
        "zieladresse1": "consequat sit dolor labore",
        "zieladresse2": "consectetur culpa fugiat",
        "zieladresse3": "Excepteur",
        "zieladresse4": "irure magna veniam dolor in",
        "zieladresse5": "mollit eiusmod sunt ut dolore"
      },
      "zertifikatsAussteller": {
        "zertifikatsAussteller1": "veniam laboris nisi",
        "zertifikatsAussteller2": "amet non",
        "zertifikatsAussteller3": "magna elit",
        "zertifikatsAussteller4": "id",
        "zertifikatsAussteller5": "in sit Excepteur"
      },
      "zertifikatsNutzer": {
        "zertifikatsNutzer1": "ut do ex",
        "zertifikatsNutzer2": "incididunt labore tempor",
        "zertifikatsNutzer3": "commodo cillum id fugiat",
        "zertifikatsNutzer4": "occaecat",
        "zertifikatsNutzer5": "dolore velit anim"
      }
    },
    "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
    "bankverbindung": [
      {
        "verwendungszweck": "BV_ZAHLUNG_MSB_ABRECHNNUNG",
        "iban": "TN1374930545328100360885",
        "kontoinhaber": "Vitus Knoll",
        "bic": "MBMUMZ3Z6IX",
        "kreditinstitut": "Schwarz, Koester und Agostini"
      }
    ],
    "erreichbarkeit": [
      {
        "verfuegbarkeit": "MITTWOCH",
        "zeit": "sint"
      }
    ],
    "ipAdresse": "dc69:ec6e:4ce2:9efc:c5b3:cad2:4a8c:e4de",
    "ipRange": {
      "untereGrenze": "229.5.34.30",
      "obereGrenze": "b6e8:badf:dca6:9aab:f05d:aadb:ee8e:b409"
    },
    "zuordnungVon": "1918-06-14T07:29:55.0Z",
    "zuordnungBis": "1965-06-25T08:23:10.0Z",
    "bilanzkreis": "est non velit nostrud id",
    "verwendungszweckBilanzkreis": "SONSTIGE_ERZEUGENDE_MARKTLOKATION"
  },
  "geraete": [
    {
      "geraetetyp": "DREHKOLBENGASZAEHLER",
      "bezeichnung": "eu Ut pariatur eiusmod sint",
      "geraetenummer": "56011",
      "geraetereferenz": "REF_100000",
      "geraeteeigenschaften": {
        "geraetetyp": "ETHERNET_KOM",
        "geraetemerkmal": "WASSER_VWZ07",
        "faktor": 8.25
      },
      "volumenerfassung": "SCHLEICHMENGENUNTERDRUECKUNG",
      "weitereGeraetenummern": [
        "65290"
      ]
    }
  ],
  "messdienstleistung": [
    {
      "dienstleistungstyp": "DATENBEREITSTELLUNG_TAEGLICH",
      "bezeichnung": "aute non"
    }
  ],
  "messlokationszaehler": [
    "ZAEHLER_110"
  ],
  "zaehlwerke": [
    {
      "zaehlwerkId": "727708960",
      "bezeichnung": "labore sed occaecat",
      "richtung": "EINSP",
      "obisKennzahl": "anim velit mollit ea",
      "wandlerfaktor": 4.5,
      "einheit": "ANZAHL",
      "schwachlastfaehig": "NICHT_SCHWACHLASTFAEHIG",
      "verbrauchsart": [
        "WK"
      ],
      "unterbrechbarkeit": "NUV",
      "waermenutzung": "WAERMEPUMPE_KAELTE",
      "konzessionsabgabe": {
        "satz": "KAS",
        "kosten": -39688147.66035265,
        "kategorie": "labore sed"
      },
      "steuerbefreit": true,
      "vorkommastelle": 3,
      "nachkommastelle": 5,
      "abrechnungsrelevant": true,
      "anzahlAblesungen": 4,
      "zaehlzeiten": {
        "register": "Excepteur Ut ullamco",
        "zaehlzeitDefinition": "nisi proident",
        "schwachlastfaehig": "SCHWACHLASTFAEHIG"
      },
      "konfiguration": "ad ex in elit reprehenderit",
      "messprodukt": "do culpa aute",
      "wertegranularitaet": "QUARTALSWEISE",
      "notwendigkeitZweiteMessung": "VORHANDEN",
      "werteuebermittlungVerwendungszweck": "VORHANDEN",
      "artEMobilitaet": "LS",
      "konfigurationsprodukt": "velit laborum commodo",
      "keinKonfigurationsprodukt": false,
      "leistungskurvendefinition": "sit amet sunt fugiat",
      "verwendungszwecke": [
        {
          "marktrolle": "EIV",
          "zweck": [
            "ES_LIEGT_KEIN_VERWENDUNGSZWECK_VOR"
          ]
        }
      ]
    }
  ],
  "marktrollen": [
    {
      "boTyp": "MARKTTEILNEHMER",
      "versionStruktur": "1",
      "geschaeftspartnerrolle": "INTERESSENT",
      "anrede": "Herr",
      "name1": "Cotthardt",
      "name2": "Kimberley",
      "name3": "sunt aliqua",
      "name4": "ut sint",
      "partneradresse": {
        "postleitzahl": "27247",
        "ort": "Bad Johanna",
        "strasse": "Langenfelder Str.",
        "hausnummer": "77c",
        "postfach": "cupidatat irure",
        "adresszusatz": "laborum cillum ea",
        "coErgaenzung": "Excepteur proident fugiat",
        "landescode": "MO",
        "ortsteil": "Ahlen",
        "zusatzInformation": {
          "zusatz1": "velit tempor eiusmod quis",
          "zusatz2": "cupidatat laborum in velit",
          "zusatz3": "esse aliquip deserunt labore",
          "zusatz4": "Excepteur et tempor reprehenderit",
          "zusatz5": "adipisicing non Excepteur"
        }
      },
      "gewerbekennzeichnung": false,
      "externeKundenummerLieferant": "irure",
      "marktrolle": "KUNDE-SELBST-NN",
      "rollencodenummer": "013547588",
      "rollencodetyp": "GLN",
      "umsatzsteuerId": "DE101001010",
      "steuernummer": "275301647",
      "ansprechpartner": {
        "boTyp": "ANSPRECHPARTNER",
        "versionStruktur": "1",
        "nachname": "Slotta",
        "eMailAdresse": "Emil_Kowalinski@hotmail.com",
        "rufnummern": [
          {
            "nummerntyp": "RUF_DURCHWAHL",
            "rufnummer": "(0102) 163956160"
          }
        ]
      },
      "makoadresse": "eiusmod",
      "downloadlinkZertifikat": "https://lebendig-nationalismus.ch",
      "amtsgericht": "Dennerdorf",
      "hrnummer": "067636",
      "website": "https://verwegen-tempel.com/",
      "faxnummer": "(0010) 085330043",
      "kommunikationsrolle": "ABRECHNUNGSPROZESSE",
      "weiterverpflichtet": true,
      "kommunikationsparameter": {
        "zieladresse": {
          "zieladresse1": "sunt laboris eu Excepteur voluptate",
          "zieladresse2": "dolore ullamco nulla",
          "zieladresse3": "esse",
          "zieladresse4": "culpa elit reprehenderit cupidatat",
          "zieladresse5": "dolor voluptate velit reprehenderit"
        },
        "zertifikatsAussteller": {
          "zertifikatsAussteller1": "consequat nostrud veniam ut",
          "zertifikatsAussteller2": "ipsum irure anim et ad",
          "zertifikatsAussteller3": "ad in",
          "zertifikatsAussteller4": "ut",
          "zertifikatsAussteller5": "minim"
        },
        "zertifikatsNutzer": {
          "zertifikatsNutzer1": "dolor fugiat",
          "zertifikatsNutzer2": "in occaecat ea",
          "zertifikatsNutzer3": "fugiat velit Excepteur do incididunt",
          "zertifikatsNutzer4": "Ut",
          "zertifikatsNutzer5": "laborum aute in"
        }
      },
      "messstellenbetreiberEigenschaft": "WETTBEWERBLICHER_MESSSTELLENBETREIBER",
      "bankverbindung": [
        {
          "verwendungszweck": "BV_ZAHLUNG_NNA",
          "iban": "EE345254820641810203",
          "kontoinhaber": "Korinna Kastner",
          "bic": "QPQCTD29AF8",
          "kreditinstitut": "Rossler, Bürklein und Apitz"
        }
      ],
      "erreichbarkeit": [
        {
          "verfuegbarkeit": "MITTWOCH",
          "zeit": "nisi"
        }
      ],
      "ipAdresse": "2eeb:0e4d:bb89:8e8e:97da:63ce:18a0:daab",
      "ipRange": {
        "untereGrenze": "202.39.151.155",
        "obereGrenze": "197.170.132.17"
      },
      "zuordnungVon": "1919-12-04T03:53:17.0Z",
      "zuordnungBis": "1899-08-01T15:05:08.0Z",
      "bilanzkreis": "non et sed",
      "verwendungszweckBilanzkreis": "ERZEUGENDE_MARKTLOKATION_KWKG"
    }
  ],
  "datenqualitaet": "DIFFERENZ_DATEN",
  "gueltigkeitszeitraum": {
    "zeiteinheit": "SEKUNDE",
    "dauer": 9,
    "startdatum": "1914-04-25T08:03:11.0Z",
    "enddatum": "1928-12-20T11:22:22.0Z",
    "einheit": "MONAT",
    "ableseZeitraum": "092526",
    "abrechnungsZeitraum": "803693",
    "zeitraumText": "reprehenderit Lorem officia ea",
    "zeitraumId": 7
  }
}
🟠400Bad Request
Previous
Marktlokation lesen
Next
Messstellenbetriebsvertrag lesen