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 Communication Data

Developing
GET
/getCommunicationDataBasicOracle
Reading the communication data of the service provider (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

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 '/getCommunicationDataBasicOracle?parameter1&parameter2&command=SAP_LESEN_KOMMUNIKATIONSDATEN_BASIS' \
--header 'Authorization: Bearer <token>'

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
Modified at 2025-10-21 09:13:07
Previous
Read BO4E (Backend)
Next
Get Meter
Built with