Marktlokation lesen - MACO APP

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 der Marklokation

Default:

74018657187

Example:

parameter2

enum<string>

optional

LokationsTyp, wenn nicht gesetzt, immer MALO

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:

Match pattern:

^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$

parameter4

string <date-time>

optional

Datum (Gültig bis)

Example:

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_MARKTLOKATION_BASIS

Responses

🟢200OK

application/json

Erfolgreiches Lesen der Marktlokation | Successful reading of the market location

Body

Liste der Marklokationen

array of:

boTyp

enum<string>

required

Typ des BO

Allowed values:

ANSPRECHPARTNERAVISENERGIEMENGEGESCHAEFTSOBJEKTGESCHAEFTSPARTNERMARKTLOKATIONMARKTTEILNEHMERMESSLOKATIONZAEHLERKOSTENTARIFPREISBLATTPREISBLATTNETZNUTZUNGPREISBLATTMESSUNGPREISBLATTUMLAGENPREISBLATTDIENSTLEISTUNGPREISBLATTKONZESSIONSABGABEZEITREIHELASTGANGHANDELSUNSTIMMIGKEITANFRAGEAUFTRAGSTATUSMITTEILUNGBERECHNUNGSFORMELRECHNUNGBILANZIERUNGNETZNUTZUNGSVERTRAGMESSSTELLENBETRIEBSVERTRAGENERGIELIEFERVERTRAGSPERRAUFTRAGANGEBOTTRANCHEKOMMUNIKATIONSDATENZAEHLZEITDEFINITIONSCHALTZEITDEFINITIONLEISTUNGSKURVENDEFINITIONNETZLOKATIONSTEUERBARE_RESSOURCETECHNISCHE_RESSOURCEAD_HOC_STEUERKANALLOKATIONSBUENDELWERTE_NACH_TYP2REKLAMATIONSTATUSBERICHTVERTRAGBILANZKREISVERWENDUNGSZEITRAUMTARIFINFO

versionStruktur

string

required

versionStruktur

Default:

marktlokationsId

string

optional

Identifikationsnummer einer Marktlokation, an der Energie entweder
verbraucht, oder erzeugt wird

sparte

enum<string>

optional

Strom oder Gas.

Allowed values:

STROMGASFERNWAERMENAHWAERMEWASSERABWASSER

Example:

STROM

energierichtung

enum<string>

optional

Kennzeichnung, ob Energie eingespeist oder entnommen (ausgespeist) wird.

Allowed values:

AUSSPEINSP

bilanzierungsmethode

enum<string>

optional

Bilanzierungsmethode

Allowed values:

RLMSLPTLP_GEMEINSAMTLP_GETRENNTPAUSCHALIMS

verbrauchsart

enum<string>

optional

Stromverbrauchsart/Verbrauchsart Marktlokation

Allowed values:

KLWEMOBSBSWWK

unterbrechbar

boolean

optional

Gibt an, ob es sich um eine unterbrechbare Belieferung handelt.

netzebene

enum<string>

optional

Netzebene, in der der Bezug der Energie erfolgt. Bei Strom Spannungsebene der
Lieferung, bei Gas Druckstufe. Beispiel Strom: Niederspannung Beispiel Gas:
Niederdruck.

Allowed values:

NSPMSPHSPHSSMSP_NSP_UMSPHSP_MSP_UMSPHSS_HSP_UMSPHDMDND

umspannung

enum<string>

optional

Umspannung der Marktlokation

Allowed values:

NSPMSPHSPHSSMSP_NSP_UMSPHSP_MSP_UMSPHSS_HSP_UMSPHDMDND

netzbetreiberCodeNr

string

optional

Codenummer des Netzbetreibers, an dessen Netz diese Marktlokation
angeschlossen ist.

gebietTyp

enum<string>

optional

Typ des Netzgebietes,z.B.Verteilnetz.

Allowed values:

REGELZONEMARKTGEBIETBILANZIERUNGSGEBIETVERTEILNETZTRANSPORTNETZREGIONALNETZAREALNETZGRUNDVERSORGUNGSGEBIETVERSORGUNGSGEBIET

netzgebietNr

string

optional

Die Nummer des Netzgebietes in der ene't-Datenbank.

bilanzierungsgebiet

string

optional

Bilanzierungsgebiet, dem das Netzgebiet zugeordnet ist - im Falle eines Strom Netzes.

grundversorgerCodeNr

string

optional

CodeNummer des Grundversorgers, der für diese Marktlokation zuständig ist.

gasqualitaet

enum<string>

optional

Gasqualitaet für EDIFACT mapping

Allowed values:

H_GASL_GAS

endkunde

object (Geschaeftspartner)

optional

Link zum Geschäftspartner, dem diese Marktlokation gehört.

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:

versionStruktur

string

required

versionStruktur

Default:

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

lokationsadresse

object (Adresse)

optional

Die Adresse, an der die Energie-Lieferung oder -Einspeisung erfolgt.

katasterinformation

object (Katasteradresse)

optional

Alternativ zu einer postalischen Adresse und Geokoordinaten kann hier eine
Ortsangabe mittels Gemarkung und Flurstück erfolgen.
Achtung: Es darf immer nur eine Art der Ortsangabe vorhanden sein (entweder
eine Adresse oder eine GeoKoordinate oder eine Katasteradresse.

gemarkung_flur

string

optional

Gemarkung Flur

flurstueck

string

optional

Flurstück Name

flurstueckNummer

string

optional

Flurstück Nummer

regelzone

string

optional

Regelzone für EDIFACT mapping

marktgebiet

string

optional

Marktgebiet für EDIFACT mapping

zeitreihentyp

enum<string>

optional

Zeitreihentyp für EDIFACT mapping

Allowed values:

EGSLGSNZRSESSLSTESTLSSLS_TLSSES_TES

messtechnischeEinordnung

enum<string>

optional

Messtechnische Einordnung aus der UTILMD (IMS, KME_MME, KEINE_MESSUNG)

Allowed values:

IMSKME_MMEKEINE_MESSUNG

sperrstatus

enum<string>

optional

Sperrstatus

Allowed values:

ENTSPERRTGESPERRT

referenzMarktlokationsId

string

optional

Referenz auf Marktlokation

versorgungsart

enum<string>

optional

Versorgungsart der Marktlokation

Allowed values:

ERSATZVERSORGUNGGRUNDVERSORGUNGERSATZBELIEFERUNG

eigentuemer

object (Geschaeftspartner)

optional

Anschlussnehmer

Example:

{"$ref":"https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Geschaeftspartner.json"}

hausverwalter

object (Geschaeftspartner)

optional

Hausverwalter

Example:

{"$ref":"https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Geschaeftspartner.json"}

verguetungEmpfaenger

enum<string>

optional

Empfänger der Vergütung zur Einspeisung

Allowed values:

KUNDELIEFERANT

statusErzeugendeMalo

enum<string>

optional

Veräußerungsform der erzeugenden Marktlokation

Allowed values:

EINSPEISEVERGUETUNG_PARAGRAPH_37GEFOERDERTE_DIREKTVERMARKTUNGSONSTIGE_DIREKTVERMARKTUNGVERMARKTUNG_OHNE_GESETZL_VERGUETUNGKWKG_VERGUETUNGEINSPEISEVERGUETUNG_PARAGRAPH_38_AUSFALLVERGUETUNG

fernsteuerbarkeit

enum<string>

optional

Status der Fernsteuerbarkeit

Allowed values:

TECHNISCH_NICHT_FERNSTEUERBARTECHNISCH_FERNSTEUERBARDURCH_LF_FERNSTEUERBAR

foerderungsLand

string

optional

Ländercode vom Land der Förderung

redispatch

boolean

optional

Ausfallarbeit Medium aus Produktidentifikation der Marktlokation

zukuenftigerMeldepunkt

boolean

optional

zukuenftigerMeldepunkt

lokationszuordnung

enum<string>

optional

Lokationszuordnung

Allowed values:

UNVERAENDERTBEGINNTENDET

konfigurationsprodukt

string

optional

Konfigurationsprodukt aus Produkt-Daten der Marktlokation

leistungskurvendefinition

string

optional

Code der Zugeordnete Leistungskurvendefinition für das Objekt

produktdatenRelevanteRolle

enum<string>

optional

Produkt-Daten für Marktrolle relevant

Allowed values:

NBLFMSBMSBAGMSBMDLDLBKVBKOUENBKUNDE-SELBST-NNMGVEIVRBKUNDEINTERESSENTKNUBABIKOESA

beteiligterMarktpartner

object (Marktteilnehmer)

optional

Beteiligter Marktpartner MP-ID

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:

versionStruktur

string

required

versionStruktur

Default:

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

modulNetzentgelte

enum<string>

optional

ModulNetzentgelte

Allowed values:

PAUSCHALE_NETZGELDREDUZIERUNG_MODUL_1PROZENTUALE_REDUZIERUNG_ARBEITSPREIS_MODUL_2ANREIZMODUL_ZEITVARIABLES_NETZENTGELT_MODUL_3

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

marktrollen

array[object (Marktteilnehmer) {33}]

optional

Zugeordnete Marktrollen des Malo mit Zuordnungszeiträumen

boTyp

enum<string>

required

Typ des BO

Allowed values:

versionStruktur

string

required

versionStruktur

Default:

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:

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

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

zaehlwerkeBeteiligteMarktrolle

array[string]

optional

Liste der Zählwerke der beteiligten Martrolle

Allowed values:

NBLFMSBMSBAGMSBMDLDLBKVBKOUENBKUNDE-SELBST-NNMGVEIVRBKUNDEINTERESSENTKNUBABIKOESA

verbrauchsmenge

array[object (Verbrauch) {15}]

optional

für EDIFACT mapping

startdatum

string <date-time>

optional

startdatum

enddatum

string <date-time>

optional

enddatum

wertermittlungsverfahren

enum<string>

optional

Wertermittlungsverfahren

Allowed values:

PROGNOSEMESSUNG

messwertstatus

enum<string>

optional

Der Status eines Zählerstandes

Allowed values:

ABGELESENERSATZWERTVORSCHLAGSWERTNICHT_VERWENDBARPROGNOSEWERTENERGIEMENGESUMMIERTVOLAEUFIGERWERTFEHLTANGABE_FUER_LIEFERSCHEINGRUNDLAGE_POG_ERMITTLUNG

obiskennzahl

string

optional

obiskennzahl

wert

number <float>

optional

wert

einheit

enum<string>

optional

Einheit: Messgrößen, die per Messung oder Vorgabe ermittelt werden können

Allowed values:

WWHKWKWHKVARHMWMWHSTUECKKUBIKMETERSTUNDETAGMONATJAHRPROZENTANZAHLVARKVARVARHKWHKZ16KWT

type

enum<string>

optional

Verbrauchsmengetyp

Allowed values:

ARBEITLEISTUNGTAGESPARAMETERABHMALOVERANSCHLAGTEJAHRESMENGETUMKUNDENWERT

tarifstufe

enum<string>

optional

Tarifstufe

Allowed values:

TARIFSTUFE_0TARIFSTUFE_1TARIFSTUFE_2TARIFSTUFE_3TARIFSTUFE_4TARIFSTUFE_5TARIFSTUFE_6TARIFSTUFE_7TARIFSTUFE_8TARIFSTUFE_9

nutzungszeitpunkt

string <date-time>

optional

nutzungszeitpunkt

ausfuehrungszeitpunkt

string <date-time>

optional

ausfuehrungszeitpunkt

position

integer

optional

position

ablesedatum

string <date-time>

optional

ablesedatum

leistungsperiode

string

optional

leistungsperiode

statuszusatzinformationen

array[object (StatusZusatzInformation) {2}]

optional

statuszusatzinformationen

zugehoerigeMesslokationen

array[object (Messlokationszuordnung) {4}]

optional

Aufzählung der Messlokationen, die zu dieser Marktlokation gehören. Es können 3 verschiedene Konstrukte auftreten:

Beziehung 1 : 0 : Hier handelt es sich um Pauschalanlagen ohne Messung. D.h. die Verbrauchsdaten sind direkt über die Marktlokation abgreifbar. Beziehung 1 : 1 : Das ist die Standard-Beziehung für die meisten Fälle. In diesem Fall gibt es zu einer Marktlokation genau eine Messlokation. Beziehung 1 : N : Hier liegt beispielsweise eine Untermessung vor. Der Verbrauch einer Marklokation berechnet sich hier aus mehreren Messungen.

Es gibt praktisch auch noch die Beziehung N : 1, beispielsweise bei einer Zweirichtungsmessung bei der durch eine Messeinrichtung die Messung sowohl für die Einspreiseseite als auch für die Aussspeiseseite erfolgt. Da Abrechnung und Bilanzierung jedoch für beide Marktlokationen getrennt erfolgt, werden nie beide Marktlokationen gemeinsam betrachtet. Daher lässt sich dieses Konstrukt auf zwei 1:1-Beziehung zurückführen, wobei die Messlokation in beiden Fällen die gleiche ist.

In den Zuordnungen sind ist die arithmetische Operation mit der der Verbrauch einer Messlokation zum Verbrauch einer Marktlokation beitrögt mit aufgeführt. Der Standard ist hier die Addition.

messlokationsId

string

optional

MesslokationsId

arithmetik

enum<string>

optional

Mit dieser Aufzählung können arithmetische Operationen festgelegt werden

Allowed values:

ADDITIONSUBTRAKTIONDIVISIONDIVIDENDMULTIPLIKATIONPOSITIVWERT

gueltigSeit

string <date-time>

optional

Zuordnung gültig ab

gueltigBis

string <date-time>

optional

Zuordnung gültig bis

netznutzungsabrechnungsdaten

array[object (Netznutzungsabrechnungsdaten) {13}]

optional

Daten für die Prüfung der Netznutzungsabrechnung

artikelId

string

optional

artikelId

artikelIdTyp

enum<string>

optional

Liste von Artikel-IDs, z.B. für standardisierte vom BDEW herausgegebene Artikel, die im Strommarkt die BDEW-Artikelnummer ablösen

Allowed values:

ARTIKELIDGRUPPENARTIKELID

anzahl

integer

optional

Anzahl

gemeinderabatt

number <float>

optional

Gemeinderabatt

zuschlag

number <float>

optional

Zuschlag

abschlag

number <float>

optional

Abschlag

singulaereBetriebsmittel

object (Menge)

optional

preisSingulaereBetriebsmittel

object (Preis)

optional

abrechnungBlindarbeit

boolean

optional

abrechnungBlindarbeit

zahlerBlindarbeit

enum<string>

optional

ZahlerBlindarbeit

Allowed values:

ANSCHLUSSNUTZERLIEFERANTNICHT_FESTGELEGT

zahlerBlindarbeitLf

boolean

optional

Zahlung der Blindarbeit durch den Lieferanten

differenzDaten

boolean

optional

differenzDaten

zaehlzeiten

object (Zaehlzeitregister)

optional

messstellenbetriebsabrechnungsdaten

array[object (Messstellenbetriebsabrechnungsdaten) {6}]

optional

Messstellenbetriebsabrechnungsdaten der Marktlokation

messstellenbetriebsabrechnung

boolean

optional

messstellenbetriebsabrechnung

artikelId

string

optional

BDEWArtikelId

artikelIdTyp

enum<string>

optional

Liste von Artikel-IDs, z.B. für standardisierte vom BDEW herausgegebene Artikel, die im Strommarkt die BDEW-Artikelnummer ablösen

Allowed values:

ARTIKELIDGRUPPENARTIKELID

anzahl

integer

optional

anzahl

zuschlag

number <float>

optional

Zuschlag

abschlag

number <float>

optional

Abschlag

energieherkunft

array[object (Energieherkunft) {2}]

optional

Art der erzeugenden Marktlokation

erzeugungsart

enum<string>

optional

Art der Erzeugung

Allowed values:

EEGKWKEEG_DVKWK_DVWINDSOLARKERNKRAFTWASSERGEOTHERMIEBIOMASSEKOHLEGASSONSTIGESONSTIGE_EEGSONSTIGE_ERZEUGUNGSART

anteilProzent

number <float>

optional

Prozentualer Anteil der Erzeugung

erforderlichesProduktpaket

array[object (Produktpaket) {4}]

optional

Bestandteil eines Produktpakets (SEQ+Z79)

produktpaketId

integer

optional

produktpaketId

produkt

array[object (Produkt) {3}]

optional

produkt

umsetzungsgradvorgabe

enum<string>

optional

Umsetzungsgradvorgabe

Allowed values:

ZUORDNUNG_NUR_WENN_PRODUKTPAKET_UMSETZBARZUORDNUNG_AUCH_WENN_PRODUKTPAKET_NICHT_UMSETZBAR

priorisierung

enum<string>

optional

Priorisierung

Allowed values:

PRIORITAET1PRIORITAET2PRIORITAET3PRIORITAET4PRIORITAET5

geokoordinaten

object (Geokoordinaten)

optional

breitengrad

string

optional

Gibt den Breitengrad eines entsprechenden Ortes an.

laengengrad

string

optional

Gibt den Längengrad eines entsprechenden Ortes an.

ostwert

string

optional

Gibt den Ostwert eines entsprechenden Ortes an.

nordwert

string

optional

Gibt den Nordwert eines entsprechenden Ortes an.

zone

enum<string>

optional

Zone

Allowed values:

UTMZone31UTMZone32UTMZone33

hochwert

string

optional

Gibt den Hochwert eines entsprechenden Ortes an.

rechtswert

string

optional

Gibt den Rechtswert eines entsprechenden Ortes an.

paketId

string

optional

Paket-ID (CCI+Z6)

Example:

P9705070235

marktlokationsTyp

array[object (MarktlokationsTypisierung) {3}]

optional

Angabe der Typisierung der Marktlokation mit möglicher Angabe zeitlicher Gültigkeit

typ

enum<string>

optional

Typisierung der Marktlokation als standard Marktlokation, ruhende Marktlokation oder Kundenanlage

Allowed values:

STANDARD_MARKTLOKATIONRUHENDE_MARKTLOKATIONKUNDENANLAGE

gueltigAb

string <date-time>

optional

Startdatum der Typisierung der Marktlokation

gueltigBis

string <date-time>

optional

Enddatum der Typisierung der Marktlokation

Example

[
  {
    "boTyp": "MARKTLOKATION",
    "versionStruktur": "1",
    "marktlokationsId": "50754496000",
    "marktlokationsTyp": [
      {
        "typ": "STANDARD_MARKTLOKATION",
        "gueltigAb": "2023-08-01T22:00:00Z",
        "gueltigBis": "2023-08-01T22:00:00Z"
      }
    ],
    "zukuenftigerMeldepunkt": null,
    "sparte": "STROM",
    "gueltigkeitszeitraum": {
      "zeitraumId": null,
      "startdatum": null,
      "enddatum": null
    },
    "inbetriebnahmedatum": "2023-08-01T22:00:00Z",
    "datenqualitaet": null,
    "energierichtung": "AUSSP",
    "bilanzierungsmethode": "SLP",
    "verbrauchsart": "KL",
    "unterbrechbar": false,
    "netzebene": "NSP",
    "umspannung": null,
    "netzbetreiberCodeNr": "9900702000004",
    "gebietTyp": "VERSORGUNGSGEBIET",
    "netzgebietNr": "12345",
    "bilanzierungsgebiet": "11YR00000004025V",
    "grundversorgerCodeNr": "9900683000008",
    "endkunde": {
      "boTyp": "GESCHAEFTSPARTNER",
      "versionStruktur": "1",
      "anrede": "Herr",
      "name1": "Haiko",
      "name2": "Fisch",
      "name3": null,
      "gewerbekennzeichnung": false,
      "hrnummer": null,
      "amtsgericht": null,
      "kontaktweg": [
        "TELEFONAT",
        "E_MAIL"
      ],
      "umsatzsteuerId": null,
      "glaeubigerId": null,
      "eMailAdresse": "hai.fisch@web.de",
      "website": null,
      "partneradresse": {
        "postleitzahl": "65189",
        "ort": "Wiesbaden",
        "strasse": "Korallenweg",
        "hausnummer": "10",
        "postfach": null,
        "adresszusatz": null,
        "coErgaenzung": null,
        "landescode": "DE",
        "ortsteil": "Riff"
      }
    },
    "lokationsadresse": {
      "postleitzahl": "65189",
      "ort": "Wiesbaden",
      "strasse": "Korallenweg",
      "hausnummer": "10",
      "postfach": null,
      "adresszusatz": null,
      "coErgaenzung": null,
      "landescode": "DE",
      "ortsteil": "Riff",
      "zusatzInformation": {
        "zusatz1": null,
        "zusatz2": null,
        "zusatz3": null,
        "zusatz4": null,
        "zusatz5": null
      }
    },
    "katasteradresse": {
      "gemarkung_flur": "1",
      "flurstueck": "1",
      "flurstueckNummer": "1"
    },
    "geokoordinaten": {
      "breitengrad": "1",
      "laengengrad": "1",
      "ostwert": "1",
      "nordwert": "1",
      "zone": "1",
      "hochwert": "1",
      "rechtswert": "1"
    },
    "marktrollen": [
      {
        "boTyp": "MARKTTEILNEHMER",
        "versionStruktur": "1",
        "gueltigkeitszeitraum": {
          "zeitraumId": 1,
          "startdatum": "2022-12-31T23:00:00Z",
          "enddatum": "2025-12-31T23:00:00Z"
        },
        "marktrolle": "MSB",
        "gewerbekennzeichnung": true,
        "rollencodenummer": "9906464000001",
        "rollencodetyp": "BDEW",
        "weiterverpflichtet": false,
        "messstellenbetreiberEigenschaft": "GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER"
      },
      {
        "boTyp": "MARKTTEILNEHMER",
        "versionStruktur": "1",
        "gueltigkeitszeitraum": {
          "zeitraumId": 1,
          "startdatum": "2022-12-31T23:00:00Z",
          "enddatum": "2025-12-31T23:00:00Z"
        },
        "marktrolle": "NB",
        "gewerbekennzeichnung": true,
        "rollencodenummer": "9900683000008",
        "rollencodetyp": "BDEW"
      },
      {
        "boTyp": "MARKTTEILNEHMER",
        "versionStruktur": "1",
        "gueltigkeitszeitraum": {
          "zeitraumId": 1,
          "startdatum": "2022-12-31T23:00:00Z",
          "enddatum": "2025-12-31T23:00:00Z"
        },
        "marktrolle": "LF",
        "gewerbekennzeichnung": true,
        "rollencodenummer": "9979052000006",
        "rollencodetyp": "BDEW"
      },
      {
        "boTyp": "MARKTTEILNEHMER",
        "versionStruktur": "1",
        "gueltigkeitszeitraum": {
          "zeitraumId": 1,
          "startdatum": "2022-12-31T23:00:00Z",
          "enddatum": "2025-12-31T23:00:00Z"
        },
        "marktrolle": "UENB",
        "gewerbekennzeichnung": true,
        "rollencodenummer": "4033872000058",
        "rollencodetyp": "BDEW"
      },
      {
        "boTyp": "MARKTTEILNEHMER",
        "versionStruktur": "1",
        "gueltigkeitszeitraum": {
          "zeitraumId": 1,
          "startdatum": "2022-12-31T23:00:00Z",
          "enddatum": "2025-12-31T23:00:00Z"
        },
        "marktrolle": "BIKO",
        "gewerbekennzeichnung": true,
        "rollencodenummer": "4033872000027",
        "rollencodetyp": "BDEW"
      },
      {
        "boTyp": "MARKTTEILNEHMER",
        "versionStruktur": "1",
        "gueltigkeitszeitraum": {
          "zeitraumId": 1,
          "startdatum": "2022-12-31T23:00:00Z",
          "enddatum": "2025-12-31T23:00:00Z"
        },
        "marktrolle": "BKV",
        "gewerbekennzeichnung": true,
        "rollencodenummer": "4033872000034",
        "rollencodetyp": "BDEW"
      }
    ],
    "regelzone": "1",
    "marktgebiet": null,
    "zeitreihentyp": "SLS",
    "zaehlwerke": [
      {
        "zaehlwerkId": "1",
        "bezeichnung": "HT",
        "richtung": "AUSSP",
        "obisKennzahl": "1-1:1.9.0",
        "wandlerfaktor": 1,
        "einheit": "KWH",
        "schwachlastfaehig": "NICHT_SCHWACHLASTFAEHIG",
        "verwendungszwecke": [
          {
            "marktrolle": "NB",
            "zweck": [
              "NETZNUTZUNGSABRECHNUNG"
            ]
          }
        ],
        "verbrauchsart": "KL",
        "unterbrechbarkeit": "NUV",
        "waermenutzung": null,
        "konzessionsabgabe": {
          "satz": "TA",
          "kosten": 0,
          "kategorie": "1"
        },
        "steuerbefreit": false,
        "vorkommastelle": 7,
        "nachkommastelle": 3,
        "abrechnungsrelevant": true,
        "anzahlAblesungen": 1,
        "zaehlzeiten": {
          "zaehlzeitDefinition": null,
          "register": null,
          "schwachlastfaehig": null
        },
        "leistungskurvendefinition": null,
        "konfiguration": null,
        "messprodukt": "9991000000044",
        "wertegranularitaet": "JAEHRLICH",
        "notwendigkeitZweiteMessung": "NICHT_VORHANDEN",
        "werteuebermittlungVerwendungszweck": "NICHT_VORHANDEN",
        "artEMobilitaet": null
      }
    ],
    "zaehlwerkeBeteiligteMarktrolle": [
      null
    ],
    "verbrauchsmenge": [
      {
        "startdatum": "2023-10-14T07:52:00Z",
        "enddatum": "2024-10-14T07:52:00Z",
        "wertermittlungsverfahren": "PROGNOSE",
        "messwertstatus": "PROGNOSEWERT",
        "statuszusatzinformationen": [
          {
            "art": "PLAUSIBILISIERUNGSHINWEIS",
            "status": "KUNDENSELBSTABLESUNG"
          }
        ],
        "obiskennzahl": "1-1:1.9.0",
        "wert": 2500,
        "einheit": "KWH"
      }
    ],
    "zugehoerigeMesslokationen": [
      {
        "messlokationsId": "DE0009697056900614312080040415111",
        "arithmetik": "ADDITION",
        "gueltigSeit": "2022-10-14T07:52:00Z",
        "gueltigBis": "2025-10-14T07:52:00Z"
      }
    ],
    "messtechnischeEinordnung": "KME_MME",
    "netznutzungsabrechnungsdaten": [
      {
        "artikelId": "1",
        "artikelIdTyp": "ARTIKELID",
        "anzahl": 5,
        "gemeinderabatt": 5.45,
        "zuschlag": 5.78,
        "abschlag": 5.87,
        "singulaereBetriebsmittel": {
          "wert": null,
          "einheit": null
        },
        "preisSingulaereBetriebsmittel": {
          "wert": null,
          "einheit": null,
          "bezugswert": null,
          "status": null
        },
        "abrechnungBlindarbeit": null,
        "zahlerBlindarbeit": null,
        "zahlerBlindarbeitLf": null,
        "zaehlzeiten": {
          "zaehlzeitDefinition": null,
          "register": null
        }
      }
    ],
    "messstellenbetriebsabrechnungsdaten": [
      {
        "messstellenbetriebsabrechnung": true,
        "artikelId": "1",
        "artikelIdTyp": "ARTIKELID",
        "anzahl": 5,
        "zuschlag": 5.78,
        "abschlag": 5.87
      }
    ],
    "sperrstatus": "ENTSPERRT",
    "referenzMarktlokationsId": "50754496000",
    "energieherkunft": [
      {
        "erzeugungsart": null,
        "anteilProzent": null
      }
    ],
    "versorgungsart": null,
    "eigentuemer": {
      "boTyp": "GESCHAEFTSPARTNER",
      "versionStruktur": "1",
      "anrede": "Herr",
      "name1": "Haiko",
      "name2": "Fisch>",
      "name3": null,
      "gewerbekennzeichnung": false,
      "geschaeftspartnerrolle": [
        "EIGENTUEMER"
      ],
      "hrnummer": null,
      "amtsgericht": null,
      "kontaktweg": [
        "TELEFON"
      ],
      "umsatzsteuerId": null,
      "glaeubigerId": null,
      "eMailAdresse": "hai.fisch@web.de",
      "website": null,
      "partneradresse": {
        "postleitzahl": "65189",
        "ort": "Wiesbaden",
        "strasse": "Körallenweg",
        "hausnummer": "10",
        "postfach": null,
        "adresszusatz": null,
        "coErgaenzung": null,
        "landescode": "DE",
        "ortsteil": "Riff"
      }
    },
    "hausverwalter": {
      "boTyp": "GESCHAEFTSPARTNER",
      "versionStruktur": "1",
      "anrede": "Herr",
      "name1": "Haiko",
      "name2": "Fisch>",
      "name3": null,
      "gewerbekennzeichnung": false,
      "geschaeftspartnerrolle": [
        "HAUSVERWALTER"
      ],
      "hrnummer": null,
      "amtsgericht": null,
      "kontaktweg": [
        "TELEFON"
      ],
      "umsatzsteuerId": null,
      "glaeubigerId": null,
      "eMailAdresse": "hai.fisch@web.de",
      "website": null,
      "partneradresse": {
        "postleitzahl": "65189",
        "ort": "Wiesbaden",
        "strasse": "Körallenweg",
        "hausnummer": "10",
        "postfach": null,
        "adresszusatz": null,
        "coErgaenzung": null,
        "landescode": "DE",
        "ortsteil": "Riff"
      }
    },
    "verguetungEmpfaenger": null,
    "statusErzeugendeMalo": null,
    "fernsteuerbarkeit": "TECHNISCH_NICHT_FERNSTEUERBAR",
    "foerderungsLand": null,
    "redispatch": false,
    "lokationszuordnung": null,
    "modulNetzentgelte": null,
    "produktdatenRelevanteRolle": "LF",
    "konfigurationsprodukt": null,
    "leistungskurvendefinition": null,
    "beteiligterMarktpartner": {
      "boTyp": "MARKTTEILNEHMER",
      "versionStruktur": "1",
      "marktrolle": "NB",
      "gewerbekennzeichnung": true,
      "rollencodenummer": "9900683000008",
      "rollencodetyp": "BDEW"
    },
    "erforderlichesProduktpaket": [
      {
        "produktpaketId": 1,
        "produkt": [
          {
            "produktCode": "9991000002008",
            "codeProdukteigenschaft": "9991000002115",
            "wertedetails": null
          }
        ],
        "umsetzungsgradvorgabe": "ZUORDNUNG_NUR_WENN_PRODUKTPAKET_UMSETZBAR",
        "priorisierung": "PRIORITAET1"
      }
    ],
    "datenDerBeteiligtenMarktrolle": [
      {
        "marktlokationsId": null,
        "regelzone": null,
        "bilanzierungsgebiet": null,
        "netzebene": null,
        "zaehlwerke": [
          {
            "obisKennzahl": null,
            "verwendungszwecke": [
              {
                "zweck": [
                  null
                ]
              }
            ]
          }
        ]
      }
    ],
    "paketId": null
  }
]

🟠400Bad Request