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)

Kommunikationsdaten des Serviceanbieters lesen

Developing
GET
/getCommunicationDataBasic
OperationId:LESEN_KOMMUNIKATIONSDATEN_BASIS
Lesen der Kommunikationsdaten des Serviceanbieters (Parameter1) zum Zeitpunkt (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 Kommunikationsdaten
Body

Example
{
    "boTyp": "KOMMUNIKATIONSDATEN",
    "versionStruktur": "1",
    "gueltigkeit": "2024-06-30T22:00:00Z",
    "marktteilnehmer": {
        "boTyp": "MARKTTEILNEHMER",
        "versionStruktur": "1",
        "marktrolle": "LF",
        "bankverbindung": [
            {
                "iban": "DE00000000000000000000",
                "kontoinhaber": "Unternehmens GmbH",
                "bic": "BICXXXXXXXX",
                "kreditinstitut": "Bankname"
            }
        ],
        "erreichbarkeit": [
            {
                "verfuegbarkeit": "MONTAG",
                "zeit": "08:00-17:00"
            },
            {
                "verfuegbarkeit": "DIENSTAG",
                "zeit": "08:00-17:00"
            },
            {
                "verfuegbarkeit": "MITTWOCH",
                "zeit": "08:00-17:00"
            },
            {
                "verfuegbarkeit": "DONNERSTAG",
                "zeit": "08:00-17:00"
            },
            {
                "verfuegbarkeit": "FREITAG",
                "zeit": "08:00-17:00"
            },
            {
                "verfuegbarkeit": "PAUSE",
                "zeit": "12:00-13:00"
            }
        ],
        "name1": "Lieferant",
        "gewerbekennzeichnung": true,
        "hrnummer": "331079",
        "amtsgericht": "Amtsgericht Mannheim:",
        "umsatzsteuerId": "DE814905955",
        "website": "www.lieferant.de",
        "faxnummer": "+012345678910",
        "partneradresse": {
            "postleitzahl": "56789",
            "ort": "Lieferantenort",
            "strasse": "Lieferantenstr",
            "hausnummer": "1",
            "landescode": "DE"
        }
    },
    "kommunikationsangaben": [
        {
            "boTyp": "MARKTTEILNEHMER",
            "versionStruktur": "1",
            "name1": "Lieferant",
            "gewerbekennzeichnung": true,
            "partneradresse": {
                "postleitzahl": "56789",
                "ort": "Lieferantenort",
                "strasse": "Lieferantenstr",
                "hausnummer": "1",
                "landescode": "DE"
            },
            "kommunikationsrolle": "DATENAUSTAUSCH",
            "ansprechpartner": {
                "boTyp": "ANSPRECHPARTNER",
                "versionStruktur": "1",
                "nachname": "Mustermann",
                "eMailAdresse": "mustermann@max.de",
                "rufnummern": [
                    {
                        "nummerntyp": "RUF_DURCHWAHL",
                        "rufnummer": "+01234567890"
                    }
                ]
            }
        },
        {
            "boTyp": "MARKTTEILNEHMER",
            "versionStruktur": "1",
            "name1": "Lieferant",
            "gewerbekennzeichnung": true,
            "partneradresse": {
                "postleitzahl": "12345",
                "ort": "Lieferantenort",
                "strasse": "Lieferantenstr",
                "landescode": "DE"
            },
            "kommunikationsrolle": "RAHMENVERTRAEGE",
            "ansprechpartner": {
                "boTyp": "ANSPRECHPARTNER",
                "versionStruktur": "1",
                "nachname": "Mustermann",
                "eMailAdresse": "mustermann@max.de",
                "rufnummern": [
                    {
                        "nummerntyp": "RUF_DURCHWAHL",
                        "rufnummer": "+012345678910"
                    }
                ]
            }
        },
        {
            "boTyp": "MARKTTEILNEHMER",
            "versionStruktur": "1",
            "name1": "Lieferant",
            "gewerbekennzeichnung": true,
            "partneradresse": {
                "postleitzahl": "12345",
                "ort": "Lieferantenort",
                "strasse": "Lieferantenstr",
                "hausnummer": "1",
                "landescode": "DE"
            },
            "kommunikationsrolle": "WECHSELPROZESSE",
            "ansprechpartner": {
                "boTyp": "ANSPRECHPARTNER",
                "versionStruktur": "1",
                "nachname": "Mustermann",
                "eMailAdresse": "mustermann@max.de",
                "rufnummern": [
                    {
                        "nummerntyp": "RUF_DURCHWAHL",
                        "rufnummer": "+012345678910"
                    }
                ]
            }
        },
        {
            "boTyp": "MARKTTEILNEHMER",
            "versionStruktur": "1",
            "name1": "Lieferant",
            "gewerbekennzeichnung": true,
            "partneradresse": {
                "postleitzahl": "12345",
                "ort": "Lieferantenort",
                "strasse": "Lieferantenstr",
                "hausnummer": "1",
                "landescode": "DE"
            },
            "kommunikationsrolle": "STAMMDATENPROZESSE",
            "ansprechpartner": {
                "boTyp": "ANSPRECHPARTNER",
                "versionStruktur": "1",
                "nachname": "Mustermann",
                "eMailAdresse": "mustermann@max.de",
                "rufnummern": [
                    {
                        "nummerntyp": "RUF_DURCHWAHL",
                        "rufnummer": "+012345678910"
                    }
                ]
            }
        },
        {
            "boTyp": "MARKTTEILNEHMER",
            "versionStruktur": "1",
            "name1": "Lieferant",
            "gewerbekennzeichnung": true,
            "partneradresse": {
                "postleitzahl": "12345",
                "ort": "Lieferantenort",
                "strasse": "Lieferantenstr",
                "hausnummer": "1",
                "landescode": "DE"
            },
            "kommunikationsrolle": "EINSPEISEPROZESSE",
            "ansprechpartner": {
                "boTyp": "ANSPRECHPARTNER",
                "versionStruktur": "1",
                "nachname": "Mustermann",
                "eMailAdresse": "mustermann@max.de",
                "rufnummern": [
                    {
                        "nummerntyp": "RUF_DURCHWAHL",
                        "rufnummer": "+012345678910"
                    }
                ]
            }
        },
        {
            "boTyp": "MARKTTEILNEHMER",
            "versionStruktur": "1",
            "name1": "Lieferant",
            "gewerbekennzeichnung": true,
            "partneradresse": {
                "postleitzahl": "12345",
                "ort": "Lieferantenort",
                "strasse": "Lieferantenstr",
                "hausnummer": "1",
                "landescode": "DE"
            },
            "kommunikationsrolle": "ABRECHNUNGSPROZESSE",
            "ansprechpartner": {
                "boTyp": "ANSPRECHPARTNER",
                "versionStruktur": "1",
                "nachname": "Mustermann",
                "eMailAdresse": "mustermann@max.de",
                "rufnummern": [
                    {
                        "nummerntyp": "RUF_DURCHWAHL",
                        "rufnummer": "+012345678910"
                    }
                ]
            }
        },
        {
            "boTyp": "MARKTTEILNEHMER",
            "versionStruktur": "1",
            "name1": "Lieferant",
            "gewerbekennzeichnung": true,
            "partneradresse": {
                "postleitzahl": "12345",
                "ort": "Lieferantenort",
                "strasse": "Lieferantenstr",
                "hausnummer": "1",
                "landescode": "DE"
            },
            "kommunikationsrolle": "MMMA_PROZESSE",
            "ansprechpartner": {
                "boTyp": "ANSPRECHPARTNER",
                "versionStruktur": "1",
                "nachname": "Mustermann",
                "eMailAdresse": "mustermann@max.de",
                "rufnummern": [
                    {
                        "nummerntyp": "RUF_DURCHWAHL",
                        "rufnummer": "+012345678910"
                    }
                ]
            }
        },
        {
            "boTyp": "MARKTTEILNEHMER",
            "versionStruktur": "1",
            "name1": "Lieferant",
            "gewerbekennzeichnung": true,
            "partneradresse": {
                "postleitzahl": "12345",
                "ort": "Lieferantenort",
                "strasse": "Lieferantenstr",
                "hausnummer": "1",
                "landescode": "DE"
            },
            "kommunikationsrolle": "BEWEGUNGSDATEN",
            "ansprechpartner": {
                "boTyp": "ANSPRECHPARTNER",
                "versionStruktur": "1",
                "nachname": "Mustermann",
                "eMailAdresse": "mustermann@max.de",
                "rufnummern": [
                    {
                        "nummerntyp": "RUF_DURCHWAHL",
                        "rufnummer": "+012345678910"
                    }
                ]
            }
        },
        {
            "boTyp": "MARKTTEILNEHMER",
            "versionStruktur": "1",
            "name1": "Lieferant",
            "gewerbekennzeichnung": true,
            "partneradresse": {
                "postleitzahl": "12345",
                "ort": "Lieferantenort",
                "strasse": "Lieferantenstr",
                "hausnummer": "1",
                "landescode": "DE"
            },
            "kommunikationsrolle": "ENT_SPERR_PROZESSE",
            "ansprechpartner": {
                "boTyp": "ANSPRECHPARTNER",
                "versionStruktur": "1",
                "nachname": "Mustermann",
                "eMailAdresse": "mustermann@max.de",
                "rufnummern": [
                    {
                        "nummerntyp": "RUF_DURCHWAHL",
                        "rufnummer": "+012345678910"
                    }
                ]
            }
        },
        {
            "boTyp": "MARKTTEILNEHMER",
            "versionStruktur": "1",
            "name1": "Lieferant",
            "gewerbekennzeichnung": true,
            "partneradresse": {
                "postleitzahl": "12345",
                "ort": "Lieferantenort",
                "strasse": "Lieferantenstr",
                "landescode": "DE"
            },
            "kommunikationsrolle": "BILANZIERUNGSPROZESSE",
            "ansprechpartner": {
                "boTyp": "ANSPRECHPARTNER",
                "versionStruktur": "1",
                "nachname": "Mustermann",
                "eMailAdresse": "mustermann@max.de",
                "rufnummern": [
                    {
                        "nummerntyp": "RUF_DURCHWAHL",
                        "rufnummer": "+012345678910"
                    }
                ]
            }
        },
        {
            "boTyp": "MARKTTEILNEHMER",
            "versionStruktur": "1",
            "name1": "Lieferant",
            "gewerbekennzeichnung": true,
            "partneradresse": {
                "postleitzahl": "12345",
                "ort": "Lieferantenort",
                "strasse": "Lieferantenstr",
                "landescode": "DE"
            },
            "kommunikationsrolle": "KUENDIGUNGSPROZESSE",
            "ansprechpartner": {
                "boTyp": "ANSPRECHPARTNER",
                "versionStruktur": "1",
                "nachname": "Mustermann",
                "eMailAdresse": "mustermann@max.de",
                "rufnummern": [
                    {
                        "nummerntyp": "RUF_DURCHWAHL",
                        "rufnummer": "+012345678910"
                    }
                ]
            }
        }
    ]
}
🟠400Bad Request
Previous
Zählerstand einer Lokation lesen
Next
Lokationsbündel lesen