Lesende Backend-Schnittstellen
Technische Ressource lesen
Technische Ressource lesen
GET
https://mock.macoapp.de
/getTechnicalResourceBasic
Lesen einer technischen Ressource mittels LokationsId (Parameter1) zum Zeitpunkt (Parameter2) | Reading a technical resource using location ID (Parameter1) at the time (Parameter2)
query Parameters
| Struktur (BO4E) | Beschreibung | Format |
|---|---|---|
parameter1* | LokationsId | Location ID · Beispiel: 74018657187 · Vorgabe: 74018657187 | string |
parameter2* | LokationsTyp | Location type · Beispiel: MALO · Vorgabe: MALO | stringMALO, MELO, NELO TECHNISCHE_RESSOURCE, STEUERBARE_RESOURCE, TRANCHE |
parameter3* | Datum (Gültig ab) | Date (Valid from) · Beispiel: 2024-06-28T12:18:00Z · Muster: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ | string (date-time) |
parameter4* | Datum (Gültig bis) | Date (Valid until) · Beispiel: 2024-06-28T12:18:00Z · Muster: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ | string (date-time) |
Technische Ressource lesen › Responses
Erfolgreiches Lesen der technischen Ressource | Successful reading of the technical resource
Array of: TechnischeRessource — die Antwort ist eine Liste dieser Objekte, nicht ein einzelnes Objekt. Jeder Eintrag hat diesen Aufbau:
| Struktur (BO4E) | Beschreibung | Format |
|---|---|---|
boTyp* | Typ des BO | stringANSPRECHPARTNER, AVIS, ENERGIEMENGE GESCHAEFTSOBJEKT, GESCHAEFTSPARTNER, MARKTLOKATION, MARKTTEILNEHMER, MESSLOKATION, ZAEHLER, KOSTEN, TARIF, PREISBLATT, PREISBLATTNETZNUTZUNG, PREISBLATTMESSUNG, PREISBLATTUMLAGEN, PREISBLATTDIENSTLEISTUNG, PREISBLATTKONZESSIONSABGABE, ZEITREIHE, LASTGANG, HANDELSUNSTIMMIGKEIT, ANFRAGE, AUFTRAG, STATUSMITTEILUNG, BERECHNUNGSFORMEL, RECHNUNG, BILANZIERUNG, NETZNUTZUNGSVERTRAG, MESSSTELLENBETRIEBSVERTRAG, ENERGIELIEFERVERTRAG, SPERRAUFTRAG, ANGEBOT, TRANCHE, KOMMUNIKATIONSDATEN, ZAEHLZEITDEFINITION, SCHALTZEITDEFINITION, LEISTUNGSKURVENDEFINITION, NETZLOKATION, STEUERBARE_RESSOURCE, TECHNISCHE_RESSOURCE, AD_HOC_STEUERKANAL, LOKATIONSBUENDEL, WERTE_NACH_TYP2, REKLAMATION, STATUSBERICHT, VERTRAG, BILANZKREIS, VERWENDUNGSZEITRAUM, TARIFINFO, SUMMENZEITREIHE |
versionStruktur* | versionStruktur | string |
ressourcenId | ID der Technischen Ressource, dient der eindeutigen Identifikation einer Technischen Ressource LOC Z20 PI 55002 55078 55600 55602 55601 55603 55013 55607 55617 55623 55629 55635 55175 55180 55173 55177 55690 55035 55095 55060 55043 RFF Z37 PI 55035 55095 55060 55043 55168 55169 RFF Z37 PI 17003 | string |
sparte | nicht in Benutzung | stringSTROM, GAS, FERNWAERME NAHWAERME, WASSER, ABWASSER |
lokationszuordnung | nicht in Benutzung | stringUNVERAENDERT, BEGINNT, ENDET |
referenzMesslokation | Referenzierung auf eine ID einer vorgelagerten Messlokation, zur Ermittlung von Energiemengen bei mehreren Melos. RFF Z34 PI 55043 55168 55169 | string |
referenzMarktlokation | Referenzierung auf eine ID der zugeordneten Marktlokationen zu einer Technischen Ressource RFF Z16 PI 55175 55180 55173 55177 55690 55035 55095 55060 55043 55168 55169 | string |
referenzNetzlokation | Referenzierung auf eine ID der zugeordneten Netzlokation. RFF Z32 PI 55617 55623 55629 55635 55035 55095 55060 55043 55168 55169 | string |
referenzSteuerbareRessource | Referenzierung auf eine ID der Steuerbaren Ressource, damit wird beschrieben über welche SR die TR gesteuert wird. RFF Z38 PI 55617 55623 55629 55635 55035 55095 55060 55043 55168 55169 | string |
referenzTranche | referenzTranche | string |
| nennleistung | Nennleistung der Technischen Ressource, bei verbrauchenden Anlagen ist es was die TR aufnehmen kann und bei speichernden Anlagen ist es was die TR zum Befüllen des Speichers aufnehmen kann. | object |
aufnahme | Aufnahme der Nennleistung QTY Z43 PI 55617 55623 55629 55635 55035 55095 55060 55043 55168 55169 | number (float) |
abgabe | Abgabe der Nennleistung QTY Z44 PI 55617 55623 55629 55635 55035 55095 55060 55043 55168 55169 | number (float) |
speicherkapazitaet | Speicherkapazität, die von der TR gespeichert werden kann. Angabe in kWh. QTY Z42 PI 55617 55623 55629 55635 55035 55095 55060 55043 55168 55169 | number (float) |
verbrauchsart[ ] | Verbrauchsart | string[]KL, W, EMOB SB, SW, WK |
waermenutzung | im Falle der Wärmenutzung wird hier die genauere Angabe über die Wärmenutzung definiert. CAV Z56 PI 55617 55623 55629 55635 55035 55060 55043 55168 55169 | stringSPEICHERHEIZUNG, WAERMEPUMPE, DIREKTHEIZUNG WAERMEPUMPE_WAERME_KAELTE, WAERMEPUMPE_KAELTE, WAERMEPUMPE_WAERME |
artEMobilitaet | Definiert die genauere Art der E-Mobilität. CAV ZE6 PI 55617 55623 55629 55635 55035 55060 55043 55168 55169 | stringWB, LS, LP |
erzeugungsart | Art der Erzeugung der Energie CAV ZF5 PI 55617 55623 55629 55635 55095 55060 55043 55168 55169 | stringEEG, KWK, EEG_DV KWK_DV, WIND, SOLAR, KERNKRAFT, WASSER, GEOTHERMIE, BIOMASSE, KOHLE, GAS, SONSTIGE, SONSTIGE_EEG, SONSTIGE_ERZEUGUNGSART |
speicherart | Speicherart CAV ZF7 PI 55617 55623 55629 55635 55035 55095 55060 55043 55168 55169 | stringWASSERSTOFFSPEICHER, PUMPSPEICHER, BATTERIESPEICHER SONSTIGE_SPEICHERART |
enwg | Kategorie der verbrauchenden Technischen Ressource ZG8 Technischen Ressource fällt unter § 14a EnWG ZG9 Technischen Ressource fällt nicht unter § 14a EnWG CAV ZG8 PI 55617 55623 55629 55635 55035 55060 55043 55168 55169 | boolean |
inbetriebsetzungsdatum | Inbetriebsetzungsdatum der verbrauchenden Technischen Ressource nach § 14a EnWG CAV ZH0 PI 55617 55623 55035 | stringINBETRIEBSETZUNG_NACH_2023, INBETRIEBSETZUNG_VOR_2024 |
einordnung | Einordnung der verbrauchenden Technischen Ressource nach § 14a EnWG mit Inbetriebsetzung vor 2024 CAV ZH2 PI 55617 55623 55035 | stringWECHSELMOEGLICHKEIT_EINMALIG_NOCH_MOEGLICH, WECHSELMOEGLICHKEIT_NICHT_MOEGLICH, BEFRISTET_OHNE_WECHSELMOEGLICHKEIT WECHSEL_WURDE_DURCHGEFUEHRT |
weitereEinrichtung | Information zu weiteren technischen Einrichtungen. Diese Geräte wurden nicht in der Marktkommunikation ausgetauscht. ZH7 Weitere technische Einrichtungen vorhanden ZH8 Keine weitere technische Einrichtung vorhanden CAV ZH7 PI 55617 55623 55629 55635 55035 55060 55043 55168 55169 | boolean |
art | Art und Nutzung der Technischen Ressource CCI Z17 PI 55617 55623 55629 55635 55035 55095 55060 55043 55168 55169 | stringSTROMERZEUGUNG, STROMVERBRAUCH, SPEICHER |
datenqualitaet | Leitet Segmentengruppe ein SEQ Z52 Daten der Technischen Ressource SEQ ZF0 Informative Daten der Technischen Ressource SEQ ZG4 Erwartete Daten der Technischen Ressource SEQ ZG5 Im System vorhandene Daten der Technischen Ressource | stringERWARTETE_DATEN, IM_SYSTEM_VORHANDENE_DATEN, INFORMATIVE_DATEN GUELTIGE_DATEN, KEINE_DATEN, IM_SYSTEM_KEINE_DATEN_VORHANDEN, KEINE_DATEN_ERWARTET, DIFFERENZ_DATEN, DIFFERENZ_ERWARTETE_DATEN, DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN |
| gueltigkeitszeitraum | Referenz auf Zeitraum-ID | object |
zeiteinheit | nicht in Benutzung | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
dauer | Zeitspanne, Wert | integer |
startdatum | Datum aus DTM Z25 Verwendung der Daten ab DTM 163 Verarbeitung, Beginndatum/-zeit DTM 155 Rechnungsperiode, Beginndatum DTM Z42 vorläufiger Abrechnungszeitraum Beginn | string (date-time) |
enddatum | Datum aus DTM Z26 Verwendung der Daten bis DTM164 Verarbeitung, Endedatum/-zeit DTM 156 Rechnungsperiode, Endedatum DTM Z43 vorläufiger Abrechnungszeitraum Ende | string (date-time) |
einheit | nicht in Benutzung | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
ableseZeitraum | Turnusablesung des NB DTM 752 PI 44113 44140 44142 44043 44168 44169 44060 | string |
abrechnungsZeitraum | Termin, zu dem die Netznutzungsabrechnung des NB erfolgt DTM Z21 PI 44112 44139 44142 44002 44013 44014 44035 | string |
zeitraumText | ZeitraumText | string |
zeitraumId | Referenz auf Zeitraum-ID RFF Z46 PI 25001 | integer |
| erforderlicheProdukte[ ] | erforderliche Produkte | object[] |
produktCode | Produkt-Code Erforderliches Produkt Abrechnungsdaten ORDERS PIA 5 PI 17133 | string |
codeProdukteigenschaft | Code der Produkteigenschaft CAV ZH9 PI 55001 55077 55600 55601 55014 55608 | string |
wertedetails | Wertedetails zum Produkt, Wertedetails zum Produkt sind in der Codeliste der Konfigurationen beschrieben CAV ZV4 PI 55001 55077 55600 55601 55014 55608 | string |
fernsteuerbarkeit | fernsteuerbarkeit | boolean |
verguetungsverpflichtung | verguetungsverpflichtung | boolean |