Technische Ressource lesen - MACO APP

Lesen einer technischen Ressource mittels LokationsId (Parameter1) zum Zeitpunkt (Parameter2) | Reading a technical resource 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 | Location ID

Default:

74018657187

Example:

74018657187

parameter2

enum<string>

required

LokationsTyp | Location type

Allowed values:

MALOMELONELOTECHNISCHE_RESSOURCESTEUERBARE_RESOURCETRANCHE

Default:

MALO

Example:

MALO

parameter3

string <date-time>

required

Datum (Gültig ab) | Date (Valid from)

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) | Date (Valid until)

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

Erfolgreiches Lesen der technischen Ressource | Successful reading of the technical resource

Body

boTyp

enum<string>

required

Typ des BO

Allowed values:

ANSPRECHPARTNERAVISENERGIEMENGEGESCHAEFTSOBJEKTGESCHAEFTSPARTNERMARKTLOKATIONMARKTTEILNEHMERMESSLOKATIONZAEHLERKOSTENTARIFPREISBLATTPREISBLATTNETZNUTZUNGPREISBLATTMESSUNGPREISBLATTUMLAGENPREISBLATTDIENSTLEISTUNGPREISBLATTKONZESSIONSABGABEZEITREIHELASTGANGHANDELSUNSTIMMIGKEITANFRAGEAUFTRAGSTATUSMITTEILUNGBERECHNUNGSFORMELRECHNUNGBILANZIERUNGNETZNUTZUNGSVERTRAGMESSSTELLENBETRIEBSVERTRAGENERGIELIEFERVERTRAGSPERRAUFTRAGANGEBOTTRANCHEKOMMUNIKATIONSDATENZAEHLZEITDEFINITIONSCHALTZEITDEFINITIONLEISTUNGSKURVENDEFINITIONNETZLOKATIONSTEUERBARE_RESSOURCETECHNISCHE_RESSOURCEAD_HOC_STEUERKANALLOKATIONSBUENDELWERTE_NACH_TYP2REKLAMATIONSTATUSBERICHTVERTRAGBILANZKREISVERWENDUNGSZEITRAUMTARIFINFO

versionStruktur

string

required

versionStruktur

Default:

ressourcenId

string

optional

ressourcenId

sparte

enum<string>

optional

Sparte

Allowed values:

STROMGASFERNWAERMENAHWAERMEWASSERABWASSER

Example:

STROM

lokationszuordnung

enum<string>

optional

Lokationszuordnung

Allowed values:

UNVERAENDERTBEGINNTENDET

referenzMesslokation

string

optional

referenzMesslokation

referenzMarktlokation

string

optional

referenzMarktlokation

referenzNetzlokation

string

optional

referenzNetzlokation

referenzSteuerbareRessource

string

optional

referenzSteuerbareRessource

nennleistung

object (Nennleistung)

optional

aufnahme

number <float>

optional

Aufnahme der Nennleistung

abgabe

number <float>

optional

Abgabe der Nennleistung

speicherkapazitaet

number <float>

optional

Speicherkapazität
Beispiel: QTY+Z42💯KWH'

verbrauchsart

enum<string>

optional

Verbrauchsart der Technischen Ressource
Beispiel: CAV+Z64'
Z64: Kraft/Licht
Z65: Wärme
ZE5: E-Mobilität
ZA8: Straßenbeleuchtung

Allowed values:

KLWEMOBSBSWWK

waermenutzung

enum<string>

optional

Wärmenutzung
Beispiel: CAV+Z56'
Z56: Speicherheizung
Z57: Wärmepumpe
Z61: Direktheizung

Allowed values:

SPEICHERHEIZUNGWAERMEPUMPEDIREKTHEIZUNGWAERMEPUMPE_WAERME_KAELTEWAERMEPUMPE_KAELTEWAERMEPUMPE_WAERME

artEMobilitaet

enum<string>

optional

ArtEmobilitaet

Allowed values:

WBLSLP

erzeugungsart

enum<string>

optional

Art der Erzeugung der Energie. Details Erzeugungsart
Beispiel: CAV+ZF5'
Erzeugungsart:
ZF5: Solar
ZF6: Wind
ZG0: Gas
ZG1: Wasser
ZG5: Sonstige Erzeugungsart

Allowed values:

EEGKWKEEG_DVKWK_DVWINDSOLARKERNKRAFTWASSERGEOTHERMIEBIOMASSEKOHLEGASSONSTIGESONSTIGE_EEGSONSTIGE_ERZEUGUNGSART

speicherart

enum<string>

optional

Art der speicher. Details Speicherart
Beispiel: CAV+ZF7'
Speicherart:
ZF7: Wasserstoffspeicher
ZF8: Pumpspeicher
ZF9: Batteriespeicher
ZG6: Sonstige Speicherart

Allowed values:

WASSERSTOFFSPEICHERPUMPSPEICHERBATTERIESPEICHERSONSTIGE_SPEICHERART

enwg

boolean

optional

enwg

inbetriebsetzungsdatum

enum<string>

optional

Inbetriebsetzung

Allowed values:

INBETRIEBSETZUNG_NACH_2023INBETRIEBSETZUN_VOR_2024

einordnung

enum<string>

optional

RessourceWechselmoeglichkeit

Allowed values:

WECHSELMOEGLICHKEIT_EINMALIG_NOCH_MOEGLICHWECHSELMOEGLICHKEIT_NICHT_MOEGLICHBEFRISTET_OHNE_WECHSELMOEGLICHKEITWECHSEL_WURDE_DURCHGEFUEHRT

weitereEinrichtung

boolean

optional

weitereEinrichtung

art

enum<string>

optional

TechnischeRessourceArt

Allowed values:

STROMERZEUGUNGSTROMVERBRAUCHSPEICHER

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

erforderlicheProdukte

array[object (Produkt) {3}]

optional

erforderlicheProdukte

produktCode

string

optional

produktCode

codeProdukteigenschaft

string

optional

codeProdukteigenschaft

wertedetails

string

optional

wertedetails

Example

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

🟠400Bad Request