- Ü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)
Netznutzungsvertrag lesen
GET
/getGridUsageContractBasic
LESEN | READ
OperationId:LESEN_NETZNUTZUNGSVERTRAG_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
Default:
74018657187
Example:
74018657187
parameter2
enum<string>
optional
Allowed values:
MALOMELONELOTECHNISCHE_RESSOURCESTEUERBARE_RESOURCETRANCHE
Default:
MALO
Example:
MALO
parameter3
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$
parameter4
string <date-time>
optional
Example:
2024-06-28T12:18:00Z
Match pattern:
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$
Responses
🟢200OK
application/json
Body
boTyp
enum<string>
required
Allowed values:
ANSPRECHPARTNERAVISENERGIEMENGEGESCHAEFTSOBJEKTGESCHAEFTSPARTNERMARKTLOKATIONMARKTTEILNEHMERMESSLOKATIONZAEHLERKOSTENTARIFPREISBLATTPREISBLATTNETZNUTZUNGPREISBLATTMESSUNGPREISBLATTUMLAGENPREISBLATTDIENSTLEISTUNGPREISBLATTKONZESSIONSABGABEZEITREIHELASTGANGHANDELSUNSTIMMIGKEITANFRAGEAUFTRAGSTATUSMITTEILUNGBERECHNUNGSFORMELRECHNUNGBILANZIERUNGNETZNUTZUNGSVERTRAGMESSSTELLENBETRIEBSVERTRAGENERGIELIEFERVERTRAGSPERRAUFTRAGANGEBOTTRANCHEKOMMUNIKATIONSDATENZAEHLZEITDEFINITIONSCHALTZEITDEFINITIONLEISTUNGSKURVENDEFINITIONNETZLOKATIONSTEUERBARE_RESSOURCETECHNISCHE_RESSOURCEAD_HOC_STEUERKANALLOKATIONSBUENDELWERTE_NACH_TYP2REKLAMATIONSTATUSBERICHTVERTRAGBILANZKREISVERWENDUNGSZEITRAUMTARIFINFO
versionStruktur
string
required
Default:
1
sparte
enum<string>
optional
Allowed values:
STROMGASFERNWAERMENAHWAERMEWASSERABWASSER
Example:
STROM
vertragsart
string
optional
Vertragsart
vertragsnummer
string
optional
beschreibung
string
optional
lokationsId
string
optional
lokationsTyp
enum<string>
optional
Allowed values:
MALOMELONELOTECHNISCHE_RESSOURCE
vertragsstatus
enum<string>
optional
Allowed values:
IN_ARBEITUEBERMITTELTANGENOMMENAKTIVABGELEHNTWIDERRUFENSTORNIERTGEKUENDIGTBEENDET
vertragsbeginn
string <date-time>
optional
vertragsende
string <date-time>
optional
gemeinderabatt
integer
optional
vertragskonditionen
object (Vertragskonditionen)
optional
netznutzungszahler
enum<string>
optional
Allowed values:
KUNDELIEFERANT
netznutzungsvertrag
enum<string>
optional
Allowed values:
KUNDEN_NBLIEFERANTEN_NB
netznutzungsabrechnung
object (Zeitraum)
optional
beinhaltetSingulaerGenutzteBetriebsmittel
boolean
optional
Hier wird angegeben, ob in der Netznutzungsabrechnung der verbrauchenden Marktlokation singulär
genutzte Betriebsmittel abgerechnet werden.
netznutzungsabrechnungsgrundlage
enum<string>
optional
Allowed values:
LIEFERSCHEINABWEICHENDE_GRUNDLAGE
netznutzungsabrechnungsvariante
enum<string>
optional
Allowed values:
ARBEITSPREIS_GRUNDPREISARBEITSPREIS_LEISTUNGSPREIS
haushaltskunde
boolean
optional
abrechnungUeberNna
boolean
optional
gemeinderabatt
object (Gemeinderabatt)
optional
startAbrechnungsjahr
string <date-time>
optional
naechstenetznutzungsabrechnung
string
optional
abrechnungsintervall
integer
optional
netznutzungsabrechnungIntervall
integer
optional
geplanteTurnusablesung
object (Zeitraum)
optional
beauftragungMsb
enum<string>
optional
Allowed values:
VERTRAG_AN_MSBVERTRAGSBEENDIGUNG_MSB
kuendigungsfrist
object (Zeitraum)
optional
vertragslaufzeit
object (Zeitraum)
optional
kuendigungstermin
string
optional
abschlagszyklus
object (Zeitraum)
optional
in den Konditionen angeben werden."
anzahl_abschlaege
number <float>
optional
beschreibung
string
optional
vertragsverlaengerung
object (Zeitraum)
optional
Zeitraum
korrespondenzpartner
object (Geschaeftspartner)
optional
Example:
{"$ref":"https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Geschaeftspartner.json"}
boTyp
enum<string>
required
Allowed values:
ANSPRECHPARTNERAVISENERGIEMENGEGESCHAEFTSOBJEKTGESCHAEFTSPARTNERMARKTLOKATIONMARKTTEILNEHMERMESSLOKATIONZAEHLERKOSTENTARIFPREISBLATTPREISBLATTNETZNUTZUNGPREISBLATTMESSUNGPREISBLATTUMLAGENPREISBLATTDIENSTLEISTUNGPREISBLATTKONZESSIONSABGABEZEITREIHELASTGANGHANDELSUNSTIMMIGKEITANFRAGEAUFTRAGSTATUSMITTEILUNGBERECHNUNGSFORMELRECHNUNGBILANZIERUNGNETZNUTZUNGSVERTRAGMESSSTELLENBETRIEBSVERTRAGENERGIELIEFERVERTRAGSPERRAUFTRAGANGEBOTTRANCHEKOMMUNIKATIONSDATENZAEHLZEITDEFINITIONSCHALTZEITDEFINITIONLEISTUNGSKURVENDEFINITIONNETZLOKATIONSTEUERBARE_RESSOURCETECHNISCHE_RESSOURCEAD_HOC_STEUERKANALLOKATIONSBUENDELWERTE_NACH_TYP2REKLAMATIONSTATUSBERICHTVERTRAGBILANZKREISVERWENDUNGSZEITRAUMTARIFINFO
versionStruktur
string
required
Default:
1
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
umsatzsteuerId
string
optional
glaeubigerId
string
optional
emailAdresse
string
optional
website
string
optional
gewerbekennzeichnung
boolean
optional
oder eine Privatperson handelt. (gewerbeKennzeichnung = false)
hrnummer
string
optional
amtsgericht
string
optional
partneradresse
object (Adresse)
optional
externeKundenummerLieferant
string
optional
externeReferenzen
array[object (ExterneReferenz) {2}]
optional
ExterneReferenz)
geschaeftspartnerrolle
array[string]
optional
Allowed values:
KUNDELIEFERANTDIENSTLEISTERINTERESSENTMARKTPARTNEREIGENTUEMERHAUSVERWALTERKORRESPONDENZEMPFAENGERABLESEKARTENEMPFAENGER
kontaktweg
array[string]
optional
Allowed values:
ANSCHREIBENTELEFONATFAXE_MAILSMS
abrechnungUeberNna
boolean
optional
datenqualitaet
enum<string>
optional
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
vertragspartner1
array[object (Geschaeftspartner) {19}]
optional
Vertagspartner 1 ..." Siehe BO Geschaeftspartner
boTyp
enum<string>
required
Allowed values:
ANSPRECHPARTNERAVISENERGIEMENGEGESCHAEFTSOBJEKTGESCHAEFTSPARTNERMARKTLOKATIONMARKTTEILNEHMERMESSLOKATIONZAEHLERKOSTENTARIFPREISBLATTPREISBLATTNETZNUTZUNGPREISBLATTMESSUNGPREISBLATTUMLAGENPREISBLATTDIENSTLEISTUNGPREISBLATTKONZESSIONSABGABEZEITREIHELASTGANGHANDELSUNSTIMMIGKEITANFRAGEAUFTRAGSTATUSMITTEILUNGBERECHNUNGSFORMELRECHNUNGBILANZIERUNGNETZNUTZUNGSVERTRAGMESSSTELLENBETRIEBSVERTRAGENERGIELIEFERVERTRAGSPERRAUFTRAGANGEBOTTRANCHEKOMMUNIKATIONSDATENZAEHLZEITDEFINITIONSCHALTZEITDEFINITIONLEISTUNGSKURVENDEFINITIONNETZLOKATIONSTEUERBARE_RESSOURCETECHNISCHE_RESSOURCEAD_HOC_STEUERKANALLOKATIONSBUENDELWERTE_NACH_TYP2REKLAMATIONSTATUSBERICHTVERTRAGBILANZKREISVERWENDUNGSZEITRAUMTARIFINFO
versionStruktur
string
required
Default:
1
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
umsatzsteuerId
string
optional
glaeubigerId
string
optional
emailAdresse
string
optional
website
string
optional
gewerbekennzeichnung
boolean
optional
oder eine Privatperson handelt. (gewerbeKennzeichnung = false)
hrnummer
string
optional
amtsgericht
string
optional
partneradresse
object (Adresse)
optional
externeKundenummerLieferant
string
optional
externeReferenzen
array[object (ExterneReferenz) {2}]
optional
ExterneReferenz)
geschaeftspartnerrolle
array[string]
optional
Allowed values:
KUNDELIEFERANTDIENSTLEISTERINTERESSENTMARKTPARTNEREIGENTUEMERHAUSVERWALTERKORRESPONDENZEMPFAENGERABLESEKARTENEMPFAENGER
kontaktweg
array[string]
optional
Allowed values:
ANSCHREIBENTELEFONATFAXE_MAILSMS
vertragspartner2
array[object (Geschaeftspartner) {19}]
optional
Vertagspartner 1 und Vertragspartner 2". Siehe BO Geschaeftspartner
boTyp
enum<string>
required
Allowed values:
ANSPRECHPARTNERAVISENERGIEMENGEGESCHAEFTSOBJEKTGESCHAEFTSPARTNERMARKTLOKATIONMARKTTEILNEHMERMESSLOKATIONZAEHLERKOSTENTARIFPREISBLATTPREISBLATTNETZNUTZUNGPREISBLATTMESSUNGPREISBLATTUMLAGENPREISBLATTDIENSTLEISTUNGPREISBLATTKONZESSIONSABGABEZEITREIHELASTGANGHANDELSUNSTIMMIGKEITANFRAGEAUFTRAGSTATUSMITTEILUNGBERECHNUNGSFORMELRECHNUNGBILANZIERUNGNETZNUTZUNGSVERTRAGMESSSTELLENBETRIEBSVERTRAGENERGIELIEFERVERTRAGSPERRAUFTRAGANGEBOTTRANCHEKOMMUNIKATIONSDATENZAEHLZEITDEFINITIONSCHALTZEITDEFINITIONLEISTUNGSKURVENDEFINITIONNETZLOKATIONSTEUERBARE_RESSOURCETECHNISCHE_RESSOURCEAD_HOC_STEUERKANALLOKATIONSBUENDELWERTE_NACH_TYP2REKLAMATIONSTATUSBERICHTVERTRAGBILANZKREISVERWENDUNGSZEITRAUMTARIFINFO
versionStruktur
string
required
Default:
1
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
umsatzsteuerId
string
optional
glaeubigerId
string
optional
emailAdresse
string
optional
website
string
optional
gewerbekennzeichnung
boolean
optional
oder eine Privatperson handelt. (gewerbeKennzeichnung = false)
hrnummer
string
optional
amtsgericht
string
optional
partneradresse
object (Adresse)
optional
externeKundenummerLieferant
string
optional
externeReferenzen
array[object (ExterneReferenz) {2}]
optional
ExterneReferenz)
geschaeftspartnerrolle
array[string]
optional
Allowed values:
KUNDELIEFERANTDIENSTLEISTERINTERESSENTMARKTPARTNEREIGENTUEMERHAUSVERWALTERKORRESPONDENZEMPFAENGERABLESEKARTENEMPFAENGER
kontaktweg
array[string]
optional
Allowed values:
ANSCHREIBENTELEFONATFAXE_MAILSMS
enFG
array[object (EnFG) {2}]
optional
grundlageVerringerungUmlagen
enum<string>
optional
Allowed values:
ERFUELLT_VORAUSSETZUNG_NACH_ENFGERFUELLT_NICHT_VORAUSSETZUNG_NACH_ENFGKEINE_ANGABE
grund
array[string]
optional
Allowed values:
ENFG_STROMSPEICHER_UND_VERLUSTENERGIEENFG_ELEKTRISCH_ANGETRIEBENE_WAERMEPUMPENENFG_UMLAGEERHEBUNG_BEI_ANLAGEN_ZUR_VERSTROMUNG_VON_KUPPELGASENENFG_HERSTELLUNG_VON_GRUENEN_WASSERSTOFFENFG_STROMKOSTENINTENSIVE_UNTERNEHMENENFG_HERSTELLUNG_VON_WASSERSTOFF_IN_STROMKOSTENINTENSIVEN_UNTERNEHMENENFG_SCHIENENBAHNENENFG_ELEKTRISCHE_BETRIEBENE_BUSSEN_IM_LINIENVERKEHRENFG_LANDSTROMANLAGEN
Example
{
"$ref": "https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Vertrag.json"
}
🟠400Bad Request