MACO APP | DOC
SchnittstellenProzessdokumentationen
SchnittstellenProzessdokumentationen
  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)
  • 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
  1. BO4E Lesen (Backend)

Messlokation lesen

GET
/getMeterLocationBasic
LESEN | READ
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
parameter1
string 
required
LokationsId
Default:
74018657187
Example:
74018657187
parameter2
enum<string> 
required
LokationsTyp
Allowed values:
MALOMELONELOTECHNISCHE_RESSOURCESTEUERBARE_RESOURCETRANCHE
Default:
MALO
Example:
MALO
parameter3
string <date-time>
required
Datum (Gültig ab) oder Stichtag, wenn parameter4 nicht gesetzt
Example:
2024-06-28T12:18:00Z
Match pattern:
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$
parameter4
string <date-time>
required
Datum (Gültig bis)
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
Entspricht der operationId dieser Schnittstelle. Diese Operation Id entspricht dem Command im Camunda Konnektor Prozess. Wenn das Backend einen generischen Endpunkt bereitstellt, kann dieses Command gentutzt werden um zu definieren welche Operation ausgeführt werden soll.
Example:
SAP_LESEN_MESSLOKATION_BASIS

Responses

🟢200OK
application/json
Erfolgreiches Lesen der Messlokation | Successful reading of the metering location
Body
boTyp
enum<string> 
required
Typ des BO
Allowed values:
ANSPRECHPARTNERAVISENERGIEMENGEGESCHAEFTSOBJEKTGESCHAEFTSPARTNERMARKTLOKATIONMARKTTEILNEHMERMESSLOKATIONZAEHLERKOSTENTARIFPREISBLATTPREISBLATTNETZNUTZUNGPREISBLATTMESSUNGPREISBLATTUMLAGENPREISBLATTDIENSTLEISTUNGPREISBLATTKONZESSIONSABGABEZEITREIHELASTGANGHANDELSUNSTIMMIGKEITANFRAGEAUFTRAGSTATUSMITTEILUNGBERECHNUNGSFORMELRECHNUNGBILANZIERUNGNETZNUTZUNGSVERTRAGMESSSTELLENBETRIEBSVERTRAGENERGIELIEFERVERTRAGSPERRAUFTRAGANGEBOTTRANCHEKOMMUNIKATIONSDATENZAEHLZEITDEFINITIONSCHALTZEITDEFINITIONLEISTUNGSKURVENDEFINITIONNETZLOKATIONSTEUERBARE_RESSOURCETECHNISCHE_RESSOURCEAD_HOC_STEUERKANALLOKATIONSBUENDELWERTE_NACH_TYP2REKLAMATIONSTATUSBERICHTVERTRAGBILANZKREISVERWENDUNGSZEITRAUMTARIFINFO
versionStruktur
string 
required
versionStruktur
Default:
1
messlokationsId
string 
optional
Die Messlokations-Identifikation. Das ist die frühere Zählpunktbezeichnung,
z.B. DE 47108151234567
sparte
enum<string> 
optional
Strom oder Gas.
Allowed values:
STROMGASFERNWAERMENAHWAERMEWASSERABWASSER
Example:
STROM
energierichtung
enum<string> 
optional
Spezifiziert die Energierichtung einer Markt- und/oder Messlokation
Allowed values:
AUSSPEINSP
netzebenemessung
enum<string> 
optional
Netzebene
Allowed values:
NSPMSPHSPHSSMSP_NSP_UMSPHSP_MSP_UMSPHSS_HSP_UMSPHDMDND
messgebietNr
string 
optional
Die Nummer des Messgebietes in der ene't-Datenbank.
grundzustaendigerMSBCodeNr
string 
optional
Codenummer des grundzuständigen Messstellenbetreibers, der für diese
Messlokation zuständig ist.( Dieser ist immer dann Messstellenbetreiber, wenn
kein anderer MSB die Einrichtungen an der Messlokation betreibt.)
messadresse
object (Adresse) 
optional
Die Adresse, an der die Messeinrichtungen zu finden sind.( Nur angeben, wenn
diese von der Adresse der Marktlokation abweicht.)
Achtung: Es darf immer nur eine Art der Ortsangabe vorhanden sein (entweder
eine Adresse oder eine GeoKoordinate oder eine Katasteradresse.
postleitzahl
string 
optional
Postleitzahl
ort
string 
optional
Ort
strasse
string 
optional
Strasse
hausnummer
string 
optional
Hausnummer und Ergänzung
postfach
string 
optional
Postfach
adresszusatz
string 
optional
Adresszusatz
coErgaenzung
string 
optional
coErgaenzung
landescode
enum<string> 
optional
Landescode
Allowed values:
ACADAEAFAGAIALAMANAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBUBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCPCRCSCUCVCWCXCYCZDEDGDJDKDMDODZEAECEEEGEHERESETEUFIFJFKFMFOFRFXGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUICIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNTNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESFSGSHSISJSKSLSMSNSOSRSSSTSUSVSXSYSZTATCTDTFTGTJTKTLTMTNTOTPTRTTTVTWTZUAUGUKUMUSUYUZVAVCVEVGVIVNVUWFWSXKYEYTYUZAZMZRZW
ortsteil
string 
optional
Ortsteil
zusatzInformation
object (AdresszusatzInformation) 
optional
bilanzierungsmethode
enum<string> 
optional
Bilanzierungsmethode
Allowed values:
RLMSLPTLP_GEMEINSAMTLP_GETRENNTPAUSCHALIMS
abrechnungmessstellenbetriebnna
boolean 
optional
Dieser Wert ist true, falls die Abrechnungs des Messstellenbetriebs die Netznutzungsabrechnung enthält. false
andernfalls
gasqualitaet
enum<string> 
optional
gasqualitaet für EDIFACT mapping
Allowed values:
H_GASL_GAS
verlustfaktor
number <float>
optional
verlustfaktor für EDIFACT mapping
betriebszustand
enum<string> 
optional
Betriebszustand
Allowed values:
GESPERRT_NICHT_ENTSPERRENGESPERRTREGELBETRIEB
ablesekartenempfaenger
object (Geschaeftspartner) 
optional
Example:
{"$ref":"https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Geschaeftspartner.json"}
boTyp
enum<string> 
required
Typ des BO
Allowed values:
ANSPRECHPARTNERAVISENERGIEMENGEGESCHAEFTSOBJEKTGESCHAEFTSPARTNERMARKTLOKATIONMARKTTEILNEHMERMESSLOKATIONZAEHLERKOSTENTARIFPREISBLATTPREISBLATTNETZNUTZUNGPREISBLATTMESSUNGPREISBLATTUMLAGENPREISBLATTDIENSTLEISTUNGPREISBLATTKONZESSIONSABGABEZEITREIHELASTGANGHANDELSUNSTIMMIGKEITANFRAGEAUFTRAGSTATUSMITTEILUNGBERECHNUNGSFORMELRECHNUNGBILANZIERUNGNETZNUTZUNGSVERTRAGMESSSTELLENBETRIEBSVERTRAGENERGIELIEFERVERTRAGSPERRAUFTRAGANGEBOTTRANCHEKOMMUNIKATIONSDATENZAEHLZEITDEFINITIONSCHALTZEITDEFINITIONLEISTUNGSKURVENDEFINITIONNETZLOKATIONSTEUERBARE_RESSOURCETECHNISCHE_RESSOURCEAD_HOC_STEUERKANALLOKATIONSBUENDELWERTE_NACH_TYP2REKLAMATIONSTATUSBERICHTVERTRAGBILANZKREISVERWENDUNGSZEITRAUMTARIFINFO
versionStruktur
string 
required
versionStruktur
Default:
1
anrede
string 
optional
Die Anrede für den GePa, Z.B. Herr.
name1
string 
optional
Erster Teil des Namens. Hier kann der Firmenname oder bei Privatpersonen
beispielsweise der Nachname dargestellt werden. Beispiele: Yellow Strom GmbH
oder Hagen
name2
string 
optional
Zweiter Teil des Namens. Hier kann der eine Erweiterung zum Firmennamen oder
bei Privatpersonen beispielsweise der Vorname dargestellt werden. Beispiele:
Bereich Süd oder Nina
name3
string 
optional
Dritter Teil des Namens. Hier können weitere Ergänzungen zum Firmennamen oder
bei Privatpersonen Zusätze zum Namen dargestellt werden. Beispiele: und Afrika
oder Sängerin
name4
string 
optional
name4
umsatzsteuerId
string 
optional
Die Umsatzsteuer-ID des Geschäftspartners. Beispiel: DE 813281825
glaeubigerId
string 
optional
Die Gläubiger-ID welche im Zahlungsverkehr verwendet wird- Z.B. DE 47116789
emailAdresse
string 
optional
emailAdresse
website
string 
optional
Internetseite des Marktpartners. Beispiel: www.mp-energie.de
gewerbekennzeichnung
boolean 
optional
Kennzeichnung ob es sich um einen Gewerbe/Unternehmen (gewerbeKennzeichnung = true)
oder eine Privatperson handelt. (gewerbeKennzeichnung = false)
hrnummer
string 
optional
Handelsregisternummer des Geschäftspartners
amtsgericht
string 
optional
Amtsgericht bzw Handelsregistergericht, das die Handelsregisternummer herausgegeben hat
partneradresse
object (Adresse) 
optional
Adresse des Geschäftspartners, an der sich der Hauptsitz befindet. Details
externeKundenummerLieferant
string 
optional
externeKundenummerLieferant
externeReferenzen
array[object (ExterneReferenz) {2}] 
optional
Hier können IDs anderer Systeme hinterlegt werden (z.B. eine SAP-GP-Nummer) (Details siehe
ExterneReferenz)
geschaeftspartnerrolle
array[string]
optional
Rolle, die der Geschäftspartner hat (z.B. Interessent, Kunde).
Allowed values:
KUNDELIEFERANTDIENSTLEISTERINTERESSENTMARKTPARTNEREIGENTUEMERHAUSVERWALTERKORRESPONDENZEMPFAENGERABLESEKARTENEMPFAENGER
kontaktweg
array[string]
optional
Bevorzugter Kontaktweg des Geschäftspartners.
Allowed values:
ANSCHREIBENTELEFONATFAXE_MAILSMS
referenzMarktlokationsId
string 
optional
referenzMarktlokationsId
verwendungsumfang
enum<string> 
optional
Verwendungsumfang
Allowed values:
MESSLOKATION_PROZESSUAL_BEHANDELTMESSLOKATION_LOKATIONSBUENDEL
zukuenftigerMeldepunkt
boolean 
optional
zukuenftigerMeldepunkt
lokationszuordnung
enum<string> 
optional
Lokationszuordnung
Allowed values:
UNVERAENDERTBEGINNTENDET
beteiligterMarktpartner
object (Marktteilnehmer) 
optional
Example:
{"$ref":"https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Marktteilnehmer.json"}
boTyp
enum<string> 
required
Typ des BO
Allowed values:
ANSPRECHPARTNERAVISENERGIEMENGEGESCHAEFTSOBJEKTGESCHAEFTSPARTNERMARKTLOKATIONMARKTTEILNEHMERMESSLOKATIONZAEHLERKOSTENTARIFPREISBLATTPREISBLATTNETZNUTZUNGPREISBLATTMESSUNGPREISBLATTUMLAGENPREISBLATTDIENSTLEISTUNGPREISBLATTKONZESSIONSABGABEZEITREIHELASTGANGHANDELSUNSTIMMIGKEITANFRAGEAUFTRAGSTATUSMITTEILUNGBERECHNUNGSFORMELRECHNUNGBILANZIERUNGNETZNUTZUNGSVERTRAGMESSSTELLENBETRIEBSVERTRAGENERGIELIEFERVERTRAGSPERRAUFTRAGANGEBOTTRANCHEKOMMUNIKATIONSDATENZAEHLZEITDEFINITIONSCHALTZEITDEFINITIONLEISTUNGSKURVENDEFINITIONNETZLOKATIONSTEUERBARE_RESSOURCETECHNISCHE_RESSOURCEAD_HOC_STEUERKANALLOKATIONSBUENDELWERTE_NACH_TYP2REKLAMATIONSTATUSBERICHTVERTRAGBILANZKREISVERWENDUNGSZEITRAUMTARIFINFO
versionStruktur
string 
required
versionStruktur
Default:
1
geschaeftspartnerrolle
enum<string> 
optional
Rolle, die der Geschäftspartner hat (z.B. Interessent, Kunde).
Allowed values:
KUNDELIEFERANTDIENSTLEISTERINTERESSENTMARKTPARTNEREIGENTUEMERHAUSVERWALTERKORRESPONDENZEMPFAENGERABLESEKARTENEMPFAENGER
anrede
string 
optional
Die Anrede für den GePa, Z.B. Herr.
name1
string 
optional
Erster Teil des Namens. Hier kann der Firmenname oder bei Privatpersonen
beispielsweise der Nachname dargestellt werden. Beispiele: Yellow Strom GmbH
oder Hagen
name2
string 
optional
Zweiter Teil des Namens. Hier kann der eine Erweiterung zum Firmennamen oder
bei Privatpersonen beispielsweise der Vorname dargestellt werden. Beispiele:
Bereich Süd oder Nina
name3
string 
optional
Dritter Teil des Namens. Hier können weitere Ergänzungen zum Firmennamen oder
bei Privatpersonen Zusätze zum Namen dargestellt werden. Beispiele: und Afrika
oder Sängerin
name4
string 
optional
name4
partneradresse
object (Adresse) 
optional
Adresse des Geschäftspartners, an der sich der Hauptsitz befindet. Details
gewerbekennzeichnung
boolean 
optional
Kennzeichnung ob es sich um einen Gewerbe/Unternehmen (gewerbeKennzeichnung = true)
oder eine Privatperson handelt. (gewerbeKennzeichnung = false)
externeKundenummerLieferant
string 
optional
externeKundenummerLieferant
marktrolle
enum<string> 
optional
Gibt im Klartext die Bezeichnung der Marktrolle an.
Allowed values:
NBLFMSBMSBAGMSBMDLDLBKVBKOUENBKUNDE-SELBST-NNMGVEIVRBKUNDEINTERESSENTKNUBABIKOESA
rollencodenummer
string 
optional
Gibt die Codenummer der Marktrolle an.
rollencodetyp
enum<string> 
optional
Gibt den Typ des Codes an.
Allowed values:
BDEWGS1GLNDVGW
umsatzsteuerId
string 
optional
Die Umsatzsteuer-ID des Geschäftspartners. Beispiel: DE 813281825
steuernummer
string 
optional
Die Steuernummer-ID des Geschäftspartners. Beispiel: 30120345678
ansprechpartner
object (Ansprechpartner) 
optional
Ansprechpartner as in EDIFACT NAD+MS, that includes e.g. the email address of a natural person.
Example:
{"$ref":"https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Ansprechpartner.json"}
makoadresse
string 
optional
Die 1:1-Kommunikationsadresse des Marktteilnehmers. Diese wird in der
Marktkommunikation verwendet.
downloadlinkZertifikat
string 
optional
downloadlinkZertifikat
amtsgericht
string 
optional
Amtsgericht bzw Handelsregistergericht, das die Handelsregisternummer herausgegeben hat
hrnummer
string 
optional
Handelsregisternummer des Geschäftspartners
website
string 
optional
Internetseite des Marktpartners. Beispiel: www.mp-energie.de
faxnummer
string 
optional
faxnummer
kommunikationsrolle
enum<string> 
optional
Kommunikationsrolle
Allowed values:
DATENAUSTAUSCHRAHMENVERTRAEGEKUENDIGUNGSPROZESSEWECHSELPROZESSESTAMMDATENPROZESSEEINSPEISEPROZESSEABRECHNUNGSPROZESSEMMMA_PROZESSEBEWEGUNGSDATENENT_SPERR_PROZESSEBILANZIERUNGSPROZESSENETZANSCHLUSS_ANLAGEN
weiterverpflichtet
boolean 
optional
weiterverpflichtet
kommunikationsparameter
object (Kommunikationsparameter) 
optional
messstellenbetreiberEigenschaft
enum<string> 
optional
MSBEigenschaft
Allowed values:
GRUNDZUSTAENDIGER_MESSSTELLENBETREIBERWETTBEWERBLICHER_MESSSTELLENBETREIBERAUFFANGMESSSTELLENBETREIBER
bankverbindung
array[object (Bankverbindung) {5}] 
optional
Bankverbindung
erreichbarkeit
array[object (Erreichbarkeit) {2}] 
optional
Die Erreichbarkeit eines Unternehmens an Werktagen.
ipAdresse
string 
optional
ipAdresse
ipRange
object (IpRange) 
optional
zuordnungVon
string <date-time>
optional
Startdatum der Zuordnung des Marktteilnehmers
zuordnungBis
string <date-time>
optional
Enddatum der Zuordnung des Marktteilnehmers
geraete
array[object (Geraet) {7}] 
optional
Liste der Geräte, die zu diesem Zähler gehören.
geraetetyp
enum<string> 
optional
Auflistung möglicher abzurechnender Gerätetypen
Allowed values:
WECHSELSTROMZAEHLERDREHSTROMZAEHLERZWEIRICHTUNGSZAEHLERRLM_ZAEHLERIMS_ZAEHLERBALGENGASZAEHLERMAXIMUMZAEHLERMULTIPLEXANLAGEPAUSCHALANLAGEVERSTAERKERANLAGESUMMATIONSGERAETIMPULSGEBEREDL_21_ZAEHLERAUFSATZVIER_QUADRANTEN_LASTGANGZAEHLERMENGENUMWERTERSTROMWANDLERSPANNUNGSWANDLERDATENLOGGERKOMMUNIKATIONSANSCHLUSSMODEMTELEKOMMUNIKATIONSEINRICHTUNGKOMMUNIKATIONSEINRICHTUNGDREHKOLBENGASZAEHLERTURBINENRADGASZAEHLERULTRASCHALLZAEHLERWIRBELGASZAEHLERMODERNE_MESSEINRICHTUNGELEKTRONISCHER_HAUSHALTSZAEHLERSTEUEREINRICHTUNGTECHNISCHESTEUEREINRICHTUNGTARIFSCHALTGERAETRUNDSTEUEREMPFAENGEROPTIONALE_ZUS_ZAEHLEINRICHTUNGMESSWANDLERSATZ_IMS_MMEKOMBIMESSWANDLER_IMS_MMETARIFSCHALTGERAET_IMS_MMERUNDSTEUEREMPFAENGER_IMS_MMETEMPERATUR_KOMPENSATIONHOECHSTBELASTUNGS_ANZEIGERSONSTIGES_GERAETSMARTMETERGATEWAYSTEUERBOXBLOCKSTROMWANDLERKOMBIMESSWANDLERMODEM_GSMETHERNET_KOMPLC_COMMODEM_FESTNETZDSL_KOMLTE_KOMDICHTEMENGENUMWERTERTEMPERATURMENGENUMWERTERZUSTANDSMENGENUMWERTERMESSDATENREGISTRIERGERAETWANDLER
bezeichnung
string 
optional
Bezeichnung des Gerätes
geraetenummer
string 
optional
Die auf dem Geräte aufgedruckte Nummer, die vom MSB vergeben wird.
geraetereferenz
string 
optional
geraetereferenz
geraeteeigenschaften
object (Geraeteeigenschaften) 
optional
Festlegung der Eigenschaften des Gerätes. Z.B. Wandler MS/NS.
volumenerfassung
enum<string> 
optional
Volumenerfassung
Allowed values:
HOCHFREQUENZSONDEKENNLINIENKORREKTURSCHLEICHMENGENUNTERDRUECKUNG
weitereGeraetenummern
array[string]
optional
weitereGeraetenummern
messdienstleistung
array[object (Dienstleistung) {2}] 
optional
Liste der Messdienstleistungen, die zu dieser Messstelle gehört.
dienstleistungstyp
enum<string> 
optional
Eindeutige Nummer der Dienstleistung. Details Dienstleistungstyp
Allowed values:
DATENBEREITSTELLUNG_TAEGLICHDATENBEREITSTELLUNG_WOECHENTLICHDATENBEREITSTELLUNG_MONATLICHDATENBEREITSTELLUNG_JAEHRLICHDATENBEREITSTELLUNG_HISTORISCHE_LGDATENBEREITSTELLUNG_STUENDLICHDATENBEREITSTELLUNG_VIERTELJAEHRLICHDATENBEREITSTELLUNG_HALBJAEHRLICHDATENBEREITSTELLUNG_MONATLICH_ZUSAETZLICHDATENBEREITSTELLUNG_EINMALIGAUSLESUNG_2X_TAEGLICH_FERNAUSLESUNGAUSLESUNG_TAEGLICH_FERNAUSLESUNGAUSLESUNG_LGK_MANUELL_MSBAUSLESUNG_MONATLICH_SLP_FERNAUSLESUNGAUSLESUNG_JAEHRLICH_SLP_FERNAUSLESUNGAUSLESUNG_MDE_SLPABLESUNG_MONATLICH_SLPABLESUNG_VIERTELJAEHRLICH_SLPABLESUNG_HALBJAEHRLICH_SLPABLESUNG_JAEHRLICH_SLPAUSLESUNG_SLP_FERNAUSLESUNGABLESUNG_SLP_ZUSAETZLICH_MSBABLESUNG_SLP_ZUSAETZLICH_KUNDEAUSLESUNG_LGK_FERNAUSLESUNG_ZUSAETZLICH_MSBAUSLESUNG_MOATLICH_FERNAUSLESUNGAUSLESUNG_STUENDLICH_FERNAUSLESUNGABLESUNG_MONATLICH_LGKAUSLESUNG_TEMERATURMENGENUMWERTERAUSLESUNG_ZUSTANDSMENGENUMWERTERAUSLESUNG_SYSTEMMENGENUMWERTERAUSLESUNG_VORGANG_SLPAUSLESUUNG_KOMPAKTMENGENUMWERTERAUSLESUNG_MDE_LGKSPERRUNG_SLPENTSPERRUNG_SLPSPERRUNG_RLMENTSPERRUNG_RLMMAHNKOSTENINKASSOKOSTEN
bezeichnung
string 
optional
Bezeichnung der Dienstleistung.
messlokationszaehler
array[string]
optional
Zähler, die zu dieser Messlokation gehören. Details
zaehlwerke
array[object (Zaehlwerk) {27}] 
optional
Die Zählwerke des Zählers.
zaehlwerkId
string 
optional
Identifikation des Zählwerks (Registers) innerhalb des Zählers. Oftmals eine laufende Nummer hinter der
Zählernummer. Z.B. 47110815_1
bezeichnung
string 
optional
Zusätzliche Bezeichnung, z.B. Zählwerk_Wirkarbeit.
richtung
enum<string> 
optional
Die Energierichtung, Einspeisung oder Ausspeisung. Details Energierichtung
Allowed values:
AUSSPEINSP
obisKennzahl
string 
optional
Die OBIS-Kennzahl für das Zählwerk, die festlegt, welche auf die gemessene Größe mit dem Stand gemeldet wird.
Nur Zählwerkstände mit dieser OBIS-Kennzahl werden an diesem Zählwerk registriert. Beispiel:1-0:1.8.1 für
elektrische Wirkarbeit.
wandlerfaktor
number <float>
optional
Mit diesem Faktor wird eine Zählerstandsdifferenz multipliziert, um zum eigentlichen Verbrauch im Zeitraum zu
kommen.
einheit
enum<string> 
optional
Die Einheit der gemessenen Größe, z.B. kWh. Details Mengeneinheit
Allowed values:
WWHKWKWHKVARHMWMWHSTUECKKUBIKMETERSTUNDETAGMONATJAHRPROZENTANZAHLVARKVARVARHKWHKZ16KWT
schwachlastfaehig
enum<string> 
optional
schwachlastfaehig
Allowed values:
SCHWACHLASTFAEHIGNICHT_SCHWACHLASTFAEHIG
verbrauchsart
enum<string> 
optional
Stromverbrauchsart/Verbrauchsart Marktlokation
Allowed values:
KLWEMOBSBSWWK
unterbrechbarkeit
enum<string> 
optional
Stromverbrauchsart/Unterbrechbarkeit Marktlokation
Allowed values:
UVNUV
waermenutzung
enum<string> 
optional
Stromverbrauchsart/Wärmenutzung Marktlokation
Allowed values:
SPEICHERHEIZUNGWAERMEPUMPEDIREKTHEIZUNGWAERMEPUMPE_WAERME_KAELTEWAERMEPUMPE_KAELTEWAERMEPUMPE_WAERME
konzessionsabgabe
object (Konzessionsabgabe) 
optional
steuerbefreit
boolean 
optional
steuerbefreit
vorkommastelle
integer 
optional
vorkommastelle
nachkommastelle
integer 
optional
nachkommastelle
abrechnungsrelevant
boolean 
optional
abrechnungsrelevant
anzahlAblesungen
integer 
optional
anzahlAblesungen
zaehlzeiten
object (Zaehlzeitregister) 
optional
konfiguration
string 
optional
Konfiguration (iMSys) des Zählwerks
messprodukt
string 
optional
messprodukt
wertegranularitaet
enum<string> 
optional
Wertegranularitaet
Allowed values:
JAEHRLICHHALBJAEHRLICHQUARTALSWEISEMONATLICH
notwendigkeitZweiteMessung
enum<string> 
optional
NotwendigkeitZweiteMessung
Allowed values:
VORHANDENNICHT_VORHANDEN
werteuebermittlungVerwendungszweck
enum<string> 
optional
WerteuebermittlungVerwendungszweck
Allowed values:
VORHANDENNICHT_VORHANDEN
artEMobilitaet
enum<string> 
optional
ArtEmobilitaet
Allowed values:
WBLSLP
konfigurationsprodukt
string 
optional
konfigurationsprodukt
keinKonfigurationsprodukt
boolean 
optional
keinKonfigurationsprodukt
leistungskurvendefinition
string 
optional
leistungskurvendefinition
verwendungszwecke
array[object (Verwendungszweck) {2}] 
optional
Verwendungungszweck der Werte Marktlokation
marktrollen
array[object (Marktteilnehmer) {33}] 
optional
marktrollen für EDIFACT mapping
boTyp
enum<string> 
required
Typ des BO
Allowed values:
ANSPRECHPARTNERAVISENERGIEMENGEGESCHAEFTSOBJEKTGESCHAEFTSPARTNERMARKTLOKATIONMARKTTEILNEHMERMESSLOKATIONZAEHLERKOSTENTARIFPREISBLATTPREISBLATTNETZNUTZUNGPREISBLATTMESSUNGPREISBLATTUMLAGENPREISBLATTDIENSTLEISTUNGPREISBLATTKONZESSIONSABGABEZEITREIHELASTGANGHANDELSUNSTIMMIGKEITANFRAGEAUFTRAGSTATUSMITTEILUNGBERECHNUNGSFORMELRECHNUNGBILANZIERUNGNETZNUTZUNGSVERTRAGMESSSTELLENBETRIEBSVERTRAGENERGIELIEFERVERTRAGSPERRAUFTRAGANGEBOTTRANCHEKOMMUNIKATIONSDATENZAEHLZEITDEFINITIONSCHALTZEITDEFINITIONLEISTUNGSKURVENDEFINITIONNETZLOKATIONSTEUERBARE_RESSOURCETECHNISCHE_RESSOURCEAD_HOC_STEUERKANALLOKATIONSBUENDELWERTE_NACH_TYP2REKLAMATIONSTATUSBERICHTVERTRAGBILANZKREISVERWENDUNGSZEITRAUMTARIFINFO
versionStruktur
string 
required
versionStruktur
Default:
1
geschaeftspartnerrolle
enum<string> 
optional
Rolle, die der Geschäftspartner hat (z.B. Interessent, Kunde).
Allowed values:
KUNDELIEFERANTDIENSTLEISTERINTERESSENTMARKTPARTNEREIGENTUEMERHAUSVERWALTERKORRESPONDENZEMPFAENGERABLESEKARTENEMPFAENGER
anrede
string 
optional
Die Anrede für den GePa, Z.B. Herr.
name1
string 
optional
Erster Teil des Namens. Hier kann der Firmenname oder bei Privatpersonen
beispielsweise der Nachname dargestellt werden. Beispiele: Yellow Strom GmbH
oder Hagen
name2
string 
optional
Zweiter Teil des Namens. Hier kann der eine Erweiterung zum Firmennamen oder
bei Privatpersonen beispielsweise der Vorname dargestellt werden. Beispiele:
Bereich Süd oder Nina
name3
string 
optional
Dritter Teil des Namens. Hier können weitere Ergänzungen zum Firmennamen oder
bei Privatpersonen Zusätze zum Namen dargestellt werden. Beispiele: und Afrika
oder Sängerin
name4
string 
optional
name4
partneradresse
object (Adresse) 
optional
Adresse des Geschäftspartners, an der sich der Hauptsitz befindet. Details
gewerbekennzeichnung
boolean 
optional
Kennzeichnung ob es sich um einen Gewerbe/Unternehmen (gewerbeKennzeichnung = true)
oder eine Privatperson handelt. (gewerbeKennzeichnung = false)
externeKundenummerLieferant
string 
optional
externeKundenummerLieferant
marktrolle
enum<string> 
optional
Gibt im Klartext die Bezeichnung der Marktrolle an.
Allowed values:
NBLFMSBMSBAGMSBMDLDLBKVBKOUENBKUNDE-SELBST-NNMGVEIVRBKUNDEINTERESSENTKNUBABIKOESA
rollencodenummer
string 
optional
Gibt die Codenummer der Marktrolle an.
rollencodetyp
enum<string> 
optional
Gibt den Typ des Codes an.
Allowed values:
BDEWGS1GLNDVGW
umsatzsteuerId
string 
optional
Die Umsatzsteuer-ID des Geschäftspartners. Beispiel: DE 813281825
steuernummer
string 
optional
Die Steuernummer-ID des Geschäftspartners. Beispiel: 30120345678
ansprechpartner
object (Ansprechpartner) 
optional
Ansprechpartner as in EDIFACT NAD+MS, that includes e.g. the email address of a natural person.
Example:
{"$ref":"https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Ansprechpartner.json"}
makoadresse
string 
optional
Die 1:1-Kommunikationsadresse des Marktteilnehmers. Diese wird in der
Marktkommunikation verwendet.
downloadlinkZertifikat
string 
optional
downloadlinkZertifikat
amtsgericht
string 
optional
Amtsgericht bzw Handelsregistergericht, das die Handelsregisternummer herausgegeben hat
hrnummer
string 
optional
Handelsregisternummer des Geschäftspartners
website
string 
optional
Internetseite des Marktpartners. Beispiel: www.mp-energie.de
faxnummer
string 
optional
faxnummer
kommunikationsrolle
enum<string> 
optional
Kommunikationsrolle
Allowed values:
DATENAUSTAUSCHRAHMENVERTRAEGEKUENDIGUNGSPROZESSEWECHSELPROZESSESTAMMDATENPROZESSEEINSPEISEPROZESSEABRECHNUNGSPROZESSEMMMA_PROZESSEBEWEGUNGSDATENENT_SPERR_PROZESSEBILANZIERUNGSPROZESSENETZANSCHLUSS_ANLAGEN
weiterverpflichtet
boolean 
optional
weiterverpflichtet
kommunikationsparameter
object (Kommunikationsparameter) 
optional
messstellenbetreiberEigenschaft
enum<string> 
optional
MSBEigenschaft
Allowed values:
GRUNDZUSTAENDIGER_MESSSTELLENBETREIBERWETTBEWERBLICHER_MESSSTELLENBETREIBERAUFFANGMESSSTELLENBETREIBER
bankverbindung
array[object (Bankverbindung) {5}] 
optional
Bankverbindung
erreichbarkeit
array[object (Erreichbarkeit) {2}] 
optional
Die Erreichbarkeit eines Unternehmens an Werktagen.
ipAdresse
string 
optional
ipAdresse
ipRange
object (IpRange) 
optional
zuordnungVon
string <date-time>
optional
Startdatum der Zuordnung des Marktteilnehmers
zuordnungBis
string <date-time>
optional
Enddatum der Zuordnung des Marktteilnehmers
datenqualitaet
enum<string> 
optional
Datenqualitaet
Allowed values:
ERWARTETE_DATENIM_SYSTEM_VORHANDENE_DATENINFORMATIVE_DATENGUELTIGE_DATENKEINE_DATENIM_SYSTEM_KEINE_DATEN_VORHANDENKEINE_DATEN_ERWARTETDIFFERENZ_DATENDIFFERENZ_ERWARTETE_DATENDIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN
gueltigkeitszeitraum
object (Zeitraum) 
optional
zeiteinheit
enum<string> 
optional
Zeiteinheit
Allowed values:
SEKUNDEMINUTESTUNDEVIERTEL_STUNDETAGWOCHEMONATQUARTALHALBJAHRJAHR
dauer
integer 
optional
dauer
startdatum
string <date-time>
optional
startdatum
enddatum
string <date-time>
optional
enddatum
einheit
enum<string> 
optional
Zeiteinheit
Allowed values:
SEKUNDEMINUTESTUNDEVIERTEL_STUNDETAGWOCHEMONATQUARTALHALBJAHRJAHR
ableseZeitraum
string 
optional
ableseZeitraum
abrechnungsZeitraum
string 
optional
abrechnungsZeitraum
zeitraumText
string 
optional
zeitraumText
zeitraumId
integer 
optional
zeitraumId
Example
{
  "$ref": "https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Messlokation.json"
}
🟠400Bad Request
Previous
Marktlokation lesen
Next
Messstellenbetriebsvertrag lesen