Reading backend interfaces
Read power curve definition
Read power curve definition
GET
https://mock.macoapp.de
/getDefinitionPerformance
Reading a power curve definition based on the configuration product code (Parameter1) at the point in time (Parameter3) | Reading a perfomance definition using konfigurationproduct-code (Parameter1) at the time (Parameter2)
query Parameters
| Structure (BO4E) | Description | Format |
|---|---|---|
parameter1* | Power curve definition · Example: 74018657187 · Default: 74018657187 | string |
parameter2 | Location type | Location type · Example: MALO · Default: MALO | stringMALO, MELO, NELO TECHNISCHE_RESSOURCE, STEUERBARE_RESOURCE, TRANCHE |
parameter3* | Date (Valid from) | Date (Valid from) · Example: 2024-06-28T12:18:00Z · Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ | string (date-time) |
parameter4 | Date (Valid until) | Date (Valid until) · Example: 2024-06-28T12:18:00Z · Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ | string (date-time) |
Read power curve definition › Responses
Successful reading of the power curve definition| Successful reading of the performance definition
Array of: Power curve definition — the response is a list of these objects, not a single object. Every entry has this structure:
| Structure (BO4E) | Description | Format |
|---|---|---|
boTyp* | Type of the 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 | Validity, start date - indication of the point in time at which the definition becomes valid DTM 157 PI 25007 DTM Z34 PI 25009 | string (date-time) |
endedatum | End of validity of the rolled-out definition DTM Z35 PI 25009 | string (date-time) |
version | new version specification for changes in content with completion date/time DTM 293 PI 25007 25009 | string (date-time) |
code | Power curve definition LOC Z09 PI 25009 | string |
notwendigkeit | Status of the use of definitions; the market partner states whether it uses definitions STS Z36 PI 25007 | stringZAEHLZEITDEFINITIONEN_WERDEN_VERWENDET, ZAEHLZEITDEFINITIONEN_WERDEN_NICHT_VERWENDET, DEFINITIONEN_WERDEN_VERWENDET DEFINITIONEN_WERDEN_NICHT_VERWENDET |
| leistungskurven[ ] | Assigned power curve definition | object[] |
code | Code of the power curve definition CCI Z53 PI 17130 17122 17128 UTILTS PI 25007 REQOTE PI 35004 QUOTES PI 15004 | string |
aenderungszeitpunkt | Power curve change point in time DTM Z45 PI 25009 | string (date-time) |
haeufigkeit | Frequency of transmission, indication of whether the power curve definition is transmitted annually or once CAV ZE0 PI 25007 | stringEINMALIG, JAEHRLICH |
uebermittelbarkeit | Transmissibility of the rolled-out definition CAV ZD5 PI 25007 | stringELEKTRONISCH, NICHT_ELEKTRONISCH |
konfigurationsprodukt | Configuration product - product code Required product power curve definitions PIA 5 PI 17130 17128 REQOTE PI 35004 QUOTES PI 15004 | string |
| schwellwert | Threshold value of the power curve definition | object |
obererSchwellwert | upper threshold value QTY Z40 , quantity specification in percent PI 25009 REQOTE value provision PI 35003 35004 QUOTES PI 15004 | number (float) |
untererSchwellwert | lower threshold value REQOTE value provision PI 35003 35004 QUOTES PI 15004 | number (float) |
konfigurationsprodukt | Metering product item code CCI Z60 PI 35003 35004 | string |