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)

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
Bodyapplication/json

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