- Übersicht
- Änderungsprotokoll Schnittstellen
- Fehlercodes
- Geschäftsobjekte
- Trigger (MACO APP)
- Einzelansicht LF
- 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
- BO4E Lesen (Backend)
- Avis lesenGET
- Berechnungsformel lesenGET
- Bilanzierung lesenGET
- Energieliefervertrag lesenGET
- Energiemengen aus Abrechnungskontext lesenGET
- Lastgangs einer Lokation lesenGET
- Zählerstand einer Lokation lesenGET
- Kommunikationsdaten des Serviceanbieters lesenGET
- Lokationsbündel lesenGET
- Marktlokation lesenGET
- Messlokation lesenGET
- Messstellenbetriebsvertrag lesenGET
- Netzlokation lesenGET
- Netznutzungsvertrag lesenGET
- Steuerbare Ressource lesenGET
- Technische Ressource lesenGET
- Tranche lesenGET
- Zähler lesenGET
- Prozessdaten lesen (Backend)
- Prozessdaten LF (Backend)
- Prozessdaten NB (Backend)
- Prozessdaten MSB (Backend)
- MaloIdent LF (Backend)
- MaloIdent NB (Backend)
Kommunikationsdaten des Serviceanbieters lesen
Developing
GET
/getCommunicationDataBasic
LESEN | READ
OperationId:LESEN_KOMMUNIKATIONSDATEN_BASIS
Request
Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.Example:
Authorization: Bearer ********************
Query Params
parameter1
string
required
Example:
9903790000002
parameter2
string <date-time>
required
Example:
2024-06-28T12:18:00Z
Match pattern:
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$
command
string
optional
Example:
SAP_LESEN_KOMMUNIKATIONSDATEN_BASIS
Responses
🟢200OK
application/json
Body
boTyp
enum<string>
required
Allowed values:
ANSPRECHPARTNERAVISENERGIEMENGEGESCHAEFTSOBJEKTGESCHAEFTSPARTNERMARKTLOKATIONMARKTTEILNEHMERMESSLOKATIONZAEHLERKOSTENTARIFPREISBLATTPREISBLATTNETZNUTZUNGPREISBLATTMESSUNGPREISBLATTUMLAGENPREISBLATTDIENSTLEISTUNGPREISBLATTKONZESSIONSABGABEZEITREIHELASTGANGHANDELSUNSTIMMIGKEITANFRAGEAUFTRAGSTATUSMITTEILUNGBERECHNUNGSFORMELRECHNUNGBILANZIERUNGNETZNUTZUNGSVERTRAGMESSSTELLENBETRIEBSVERTRAGENERGIELIEFERVERTRAGSPERRAUFTRAGANGEBOTTRANCHEKOMMUNIKATIONSDATENZAEHLZEITDEFINITIONSCHALTZEITDEFINITIONLEISTUNGSKURVENDEFINITIONNETZLOKATIONSTEUERBARE_RESSOURCETECHNISCHE_RESSOURCEAD_HOC_STEUERKANALLOKATIONSBUENDELWERTE_NACH_TYP2REKLAMATIONSTATUSBERICHTVERTRAGBILANZKREISVERWENDUNGSZEITRAUMTARIFINFO
versionStruktur
string
required
Default:
1
gueltigkeit
string <date-time>
optional
kommunikationsDatenBlattInaktiv
boolean
optional
marktteilnehmer
object (Marktteilnehmer)
optional
Example:
{"$ref":"https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Marktteilnehmer.json"}
boTyp
enum<string>
required
Allowed values:
ANSPRECHPARTNERAVISENERGIEMENGEGESCHAEFTSOBJEKTGESCHAEFTSPARTNERMARKTLOKATIONMARKTTEILNEHMERMESSLOKATIONZAEHLERKOSTENTARIFPREISBLATTPREISBLATTNETZNUTZUNGPREISBLATTMESSUNGPREISBLATTUMLAGENPREISBLATTDIENSTLEISTUNGPREISBLATTKONZESSIONSABGABEZEITREIHELASTGANGHANDELSUNSTIMMIGKEITANFRAGEAUFTRAGSTATUSMITTEILUNGBERECHNUNGSFORMELRECHNUNGBILANZIERUNGNETZNUTZUNGSVERTRAGMESSSTELLENBETRIEBSVERTRAGENERGIELIEFERVERTRAGSPERRAUFTRAGANGEBOTTRANCHEKOMMUNIKATIONSDATENZAEHLZEITDEFINITIONSCHALTZEITDEFINITIONLEISTUNGSKURVENDEFINITIONNETZLOKATIONSTEUERBARE_RESSOURCETECHNISCHE_RESSOURCEAD_HOC_STEUERKANALLOKATIONSBUENDELWERTE_NACH_TYP2REKLAMATIONSTATUSBERICHTVERTRAGBILANZKREISVERWENDUNGSZEITRAUMTARIFINFO
versionStruktur
string
required
Default:
1
geschaeftspartnerrolle
enum<string>
optional
Allowed values:
KUNDELIEFERANTDIENSTLEISTERINTERESSENTMARKTPARTNEREIGENTUEMERHAUSVERWALTERKORRESPONDENZEMPFAENGERABLESEKARTENEMPFAENGER
anrede
string
optional
name1
string
optional
beispielsweise der Nachname dargestellt werden. Beispiele: Yellow Strom GmbH
oder Hagen
name2
string
optional
bei Privatpersonen beispielsweise der Vorname dargestellt werden. Beispiele:
Bereich Süd oder Nina
name3
string
optional
bei Privatpersonen Zusätze zum Namen dargestellt werden. Beispiele: und Afrika
oder Sängerin
name4
string
optional
partneradresse
object (Adresse)
optional
gewerbekennzeichnung
boolean
optional
oder eine Privatperson handelt. (gewerbeKennzeichnung = false)
externeKundenummerLieferant
string
optional
marktrolle
enum<string>
optional
Allowed values:
NBLFMSBMSBAGMSBMDLDLBKVBKOUENBKUNDE-SELBST-NNMGVEIVRBKUNDEINTERESSENTKNUBABIKOESA
rollencodenummer
string
optional
rollencodetyp
enum<string>
optional
Allowed values:
BDEWGS1GLNDVGW
umsatzsteuerId
string
optional
steuernummer
string
optional
ansprechpartner
object (Ansprechpartner)
optional
Example:
{"$ref":"https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Ansprechpartner.json"}
makoadresse
string
optional
Marktkommunikation verwendet.
downloadlinkZertifikat
string
optional
amtsgericht
string
optional
hrnummer
string
optional
website
string
optional
faxnummer
string
optional
kommunikationsrolle
enum<string>
optional
Allowed values:
DATENAUSTAUSCHRAHMENVERTRAEGEKUENDIGUNGSPROZESSEWECHSELPROZESSESTAMMDATENPROZESSEEINSPEISEPROZESSEABRECHNUNGSPROZESSEMMMA_PROZESSEBEWEGUNGSDATENENT_SPERR_PROZESSEBILANZIERUNGSPROZESSENETZANSCHLUSS_ANLAGEN
weiterverpflichtet
boolean
optional
kommunikationsparameter
object (Kommunikationsparameter)
optional
messstellenbetreiberEigenschaft
enum<string>
optional
Allowed values:
GRUNDZUSTAENDIGER_MESSSTELLENBETREIBERWETTBEWERBLICHER_MESSSTELLENBETREIBERAUFFANGMESSSTELLENBETREIBER
bankverbindung
array[object (Bankverbindung) {5}]
optional
erreichbarkeit
array[object (Erreichbarkeit) {2}]
optional
ipAdresse
string
optional
ipRange
object (IpRange)
optional
zuordnungVon
string <date-time>
optional
zuordnungBis
string <date-time>
optional
kommunikationsangaben
array[object (Marktteilnehmer) {33}]
optional
boTyp
enum<string>
required
Allowed values:
ANSPRECHPARTNERAVISENERGIEMENGEGESCHAEFTSOBJEKTGESCHAEFTSPARTNERMARKTLOKATIONMARKTTEILNEHMERMESSLOKATIONZAEHLERKOSTENTARIFPREISBLATTPREISBLATTNETZNUTZUNGPREISBLATTMESSUNGPREISBLATTUMLAGENPREISBLATTDIENSTLEISTUNGPREISBLATTKONZESSIONSABGABEZEITREIHELASTGANGHANDELSUNSTIMMIGKEITANFRAGEAUFTRAGSTATUSMITTEILUNGBERECHNUNGSFORMELRECHNUNGBILANZIERUNGNETZNUTZUNGSVERTRAGMESSSTELLENBETRIEBSVERTRAGENERGIELIEFERVERTRAGSPERRAUFTRAGANGEBOTTRANCHEKOMMUNIKATIONSDATENZAEHLZEITDEFINITIONSCHALTZEITDEFINITIONLEISTUNGSKURVENDEFINITIONNETZLOKATIONSTEUERBARE_RESSOURCETECHNISCHE_RESSOURCEAD_HOC_STEUERKANALLOKATIONSBUENDELWERTE_NACH_TYP2REKLAMATIONSTATUSBERICHTVERTRAGBILANZKREISVERWENDUNGSZEITRAUMTARIFINFO
versionStruktur
string
required
Default:
1
geschaeftspartnerrolle
enum<string>
optional
Allowed values:
KUNDELIEFERANTDIENSTLEISTERINTERESSENTMARKTPARTNEREIGENTUEMERHAUSVERWALTERKORRESPONDENZEMPFAENGERABLESEKARTENEMPFAENGER
anrede
string
optional
name1
string
optional
beispielsweise der Nachname dargestellt werden. Beispiele: Yellow Strom GmbH
oder Hagen
name2
string
optional
bei Privatpersonen beispielsweise der Vorname dargestellt werden. Beispiele:
Bereich Süd oder Nina
name3
string
optional
bei Privatpersonen Zusätze zum Namen dargestellt werden. Beispiele: und Afrika
oder Sängerin
name4
string
optional
partneradresse
object (Adresse)
optional
gewerbekennzeichnung
boolean
optional
oder eine Privatperson handelt. (gewerbeKennzeichnung = false)
externeKundenummerLieferant
string
optional
marktrolle
enum<string>
optional
Allowed values:
NBLFMSBMSBAGMSBMDLDLBKVBKOUENBKUNDE-SELBST-NNMGVEIVRBKUNDEINTERESSENTKNUBABIKOESA
rollencodenummer
string
optional
rollencodetyp
enum<string>
optional
Allowed values:
BDEWGS1GLNDVGW
umsatzsteuerId
string
optional
steuernummer
string
optional
ansprechpartner
object (Ansprechpartner)
optional
Example:
{"$ref":"https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Ansprechpartner.json"}
makoadresse
string
optional
Marktkommunikation verwendet.
downloadlinkZertifikat
string
optional
amtsgericht
string
optional
hrnummer
string
optional
website
string
optional
faxnummer
string
optional
kommunikationsrolle
enum<string>
optional
Allowed values:
DATENAUSTAUSCHRAHMENVERTRAEGEKUENDIGUNGSPROZESSEWECHSELPROZESSESTAMMDATENPROZESSEEINSPEISEPROZESSEABRECHNUNGSPROZESSEMMMA_PROZESSEBEWEGUNGSDATENENT_SPERR_PROZESSEBILANZIERUNGSPROZESSENETZANSCHLUSS_ANLAGEN
weiterverpflichtet
boolean
optional
kommunikationsparameter
object (Kommunikationsparameter)
optional
messstellenbetreiberEigenschaft
enum<string>
optional
Allowed values:
GRUNDZUSTAENDIGER_MESSSTELLENBETREIBERWETTBEWERBLICHER_MESSSTELLENBETREIBERAUFFANGMESSSTELLENBETREIBER
bankverbindung
array[object (Bankverbindung) {5}]
optional
erreichbarkeit
array[object (Erreichbarkeit) {2}]
optional
ipAdresse
string
optional
ipRange
object (IpRange)
optional
zuordnungVon
string <date-time>
optional
zuordnungBis
string <date-time>
optional
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