Lesende Backend-Schnittstellen
Schaltzeitdefinition lesen
Schaltzeitdefinition lesen
GET
https://mock.macoapp.de
/getDefinitionSwitch
Lesen einer Schaltzeitdefinition anhand des Konfigurationsprodukt-Code (Parameter1) zum Zeitpunkt (Parameter3) | Reading a switchtime definition using konfigurationproduct-code (Parameter1) at the time (Parameter2)
query Parameters
| Struktur (BO4E) | Beschreibung | Format |
|---|---|---|
parameter1* | Schaltzeitdefinition · 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) |
Schaltzeitdefinition lesen › Responses
Erfolgreiches Lesen der Schaltzeitdefinition | Successful reading of the switchtime definition
Array of: Schaltzeitdefinition — 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 |
beginndatum | Gültigkeit, Beginndatum - Angabe, zu welchem Zeitpunkt die Definition ihre Gültigkeit erlangt DTM 157 PI 25006 DTM Z34 PI 25008 | string (date-time) |
endedatum | Gültigkeitsende der ausgerollten Definition DTM Z35 PI 25008 | string (date-time) |
version | neue Versionsangabe bei inhaltlichen Änderungen mit Fertigstellungsdatum/-zeit DTM 293 PI 25006 25008 | string (date-time) |
code | Schaltzeitdefinition LOC Z09 PI 25008 | string |
notwendigkeit | Status der Nutzung von Definitionen, wird vom Marktpartner angegeben, ob er Definitionen verwendet STS Z36 PI 25006 | stringZAEHLZEITDEFINITIONEN_WERDEN_VERWENDET, ZAEHLZEITDEFINITIONEN_WERDEN_NICHT_VERWENDET, DEFINITIONEN_WERDEN_VERWENDET DEFINITIONEN_WERDEN_NICHT_VERWENDET |
| schaltzeiten[ ] | . | object[] |
code | Code der Schaltzeitdefinition CCI Z52 PI 17130 17122 17128 UTILTS PI 25006 REQOTE PI 35004 QUOTES PI 15004 | string |
aenderungszeitpunkt | Schaltzeitänderungszeitpunkt DTM Z44 PI 25008 | string (date-time) |
haeufigkeit | Häufigkeit der Übermittlung, Angabe ob die Schaltzeitdefinition jahrlich oder einmalig übermittelt wird CAV ZE0 PI 25006 | stringEINMALIG, JAEHRLICH |
uebermittelbarkeit | Übermittelbarkeit der ausgerollten Definition CAV ZD5 PI 25004 | stringELEKTRONISCH, NICHT_ELEKTRONISCH |
schalthandlung | Schalthandlung an der Lokation CCI Z58 PI 25008 | stringLEISTUNG_AN, LEISTUNG_AUS |
konfigurationsprodukt | Produktidentifikation - Codeliste der Konfigurationen Erforderliches Produkt Schaltzeitdefinitionen PIA 5 PI 17130 17128 REQOTE PI 35004 QUOTES PI 15004 | string |