Leistungskurvendefinition lesen

GET

https://mock.macoapp.de

/getDefinitionPerformance

Lesen einer Leistungskurvendefinition anhand des Konfigurationsprodukt-Code (Parameter1) zum Zeitpunkt (Parameter3) | Reading a perfomance definition using konfigurationproduct-code (Parameter1) at the time (Parameter2)

query Parameters

Struktur (BO4E)	Beschreibung	Format
`parameter1`*	Leistungskurvendefinition · Beispiel: 74018657187 · Vorgabe: 74018657187	string
`parameter2`	LokationsTyp \| Location type · Beispiel: MALO · Vorgabe: MALO	string `MALO`, `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)

Leistungskurvendefinition lesen › Responses

Erfolgreiches Lesen der Leistungskurvendefinition| Successful reading of the performance definition

Array of: Leistungskurvendefinition — die Antwort ist eine Liste dieser Objekte, nicht ein einzelnes Objekt. Jeder Eintrag hat diesen Aufbau:

Struktur (BO4E)	Beschreibung	Format
`boTyp`*	Typ des BO	string `ANSPRECHPARTNER`, `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 25007 DTM Z34 PI 25009	string (date-time)
`endedatum`	Gültigkeitsende der ausgerollten Definition DTM Z35 PI 25009	string (date-time)
`version`	neue Versionsangabe bei inhaltlichen Änderungen mit Fertigstellungsdatum/-zeit DTM 293 PI 25007 25009	string (date-time)
`code`	Leistungskurvendefinition LOC Z09 PI 25009	string
`notwendigkeit`	Status der Nutzung von Definitionen, wird vom Marktpartner angegeben, ob er Definitionen verwendet STS Z36 PI 25007	string `ZAEHLZEITDEFINITIONEN_WERDEN_VERWENDET`, `ZAEHLZEITDEFINITIONEN_WERDEN_NICHT_VERWENDET`, `DEFINITIONEN_WERDEN_VERWENDET` `DEFINITIONEN_WERDEN_NICHT_VERWENDET`
leistungskurven[ ]	Zugeordnete Leistungskurvendefinition	object[]
`code`	Code der Leistungskurvendefinition CCI Z53 PI 17130 17122 17128 UTILTS PI 25007 REQOTE PI 35004 QUOTES PI 15004	string
`aenderungszeitpunkt`	Leistungskurvenänderungszeitpunkt DTM Z45 PI 25009	string (date-time)
`haeufigkeit`	Häufigkeit der Übermittlung, Angabe ob die Leistungskurvendefinition jahrlich oder einmalig übermittelt wird CAV ZE0 PI 25007	string `EINMALIG`, `JAEHRLICH`
`uebermittelbarkeit`	Übermittelbarkeit der ausgerollten Definition CAV ZD5 PI 25007	string `ELEKTRONISCH`, `NICHT_ELEKTRONISCH`
`konfigurationsprodukt`	Konfigurationsprodukt - Produkt-Code Erforderliches Produkt Leistungskurvendefinitionen PIA 5 PI 17130 17128 REQOTE PI 35004 QUOTES PI 15004	string
schwellwert	Schwellwert der Leistungskurvendefinition	object
`obererSchwellwert`	oberer Schwellwert QTY Z40 , Mengenangabe in Prozent PI 25009 REQOTE Wertbereitstellung PI 35003 35004 QUOTES PI 15004	number (float)
`untererSchwellwert`	unterer Schwellwert REQOTE Wertbereitstellung PI 35003 35004 QUOTES PI 15004	number (float)
`konfigurationsprodukt`	Messprodukt-Position-Code CCI Z60 PI 35003 35004	string

Example Responses

[
  {
    "boTyp": "ZAEHLER",
    "versionStruktur": "1",
    "zaehlernummer": "1EMH0015009292",
    "messlokationsId": "DE0073395252733953513649640711234",
    "marktlokationsId": "<string>",
    "sparte": "STROM",
    "gueltigkeitszeitraum": {
      "zeitraumId": 1,
      "startdatum": "2024-12-31T23:00:00Z",
      "enddatum": "2025-12-31T23:00:00Z"
    },
    "datenqualitaet": "ERWARTETE_DATEN",
    "zaehlerauspraegung": "EINRICHTUNGSZAEHLER",
    "zaehlertyp": "WECHSELSTROMZAEHLER",
    "tarifart": "EINTARIF",
    "zaehlerkonstante": 5.4,
    "eichungBis": "2032",
    "zaehlwerke": [
      {
        "zaehlwerkId": "<string>",
        "bezeichnung": "<string>",
        "richtung": "AUSSP",
        "obisKennzahl": "1-0:1.8.1",
        "vorkommastellen": 5,
        "nachkommastellen": 3,
        "wandlerfaktor": 6,
        "einheit": "KUBIKMETER",
        "schwachlastfaehig": "SCHWACHLASTFAEHIG",
        "verwendungszwecke": [
          {
            "marktrolle": "NB",
            "zweck": []
          }
        ],
        "verbrauchsart": [
          "KL"
        ],
        "unterbrechbarkeit": "UV",
        "waermenutzung": "SPEICHERHEIZUNG",
        "konzessionsabgabe": {
          "satz": null,
          "kosten": 126.47,
          "kategorie": "<string>"
        },
        "steuerbefreit": true,
        "vorkommastelle": 8,
        "nachkommastelle": 0,
        "abrechnungsrelevant": false,
        "anzahlAblesungen": 15,
        "zaehlzeiten": {
          "zaehlzeitDefinition": "<string>",
          "register": "<string>",
          "schwachlastfaehig": null
        },
        "konfiguration": "34590456ujdfsdghdlktztwqq-053trg",
        "wertegranularitaet": null,
        "notwendigkeitZweiteMessung": null,
        "werteuebermittlungVerwendungszweck": null,
        "artEMobilitaet": null
      }
    ],
    "zaehlerhersteller": {
      "boTyp": "GESCHAEFTSPARTNER",
      "versionStruktur": "1",
      "anrede": "Frau",
      "name1": "Musterfrau",
      "name2": "Erika",
      "name3": "",
      "name4": "",
      "gewerbekennzeichnung": true,
      "hrnummer": "<string>",
      "amtsgericht": "<string>",
      "kontaktweg": [],
      "umsatzsteuerId": "<string>",
      "glaeubigerId": "<string>",
      "eMailAdresse": "beispiel@example.org",
      "website": "<string>",
      "geschaeftspartnerrolle": [
        "KUNDE"
      ],
      "partneradresse": {
        "postleitzahl": "10117",
        "ort": "Musterstadt",
        "strasse": "Musterstraße",
        "hausnummer": "1",
        "postfach": "",
        "adresszusatz": "Beispieldaten",
        "coErgaenzung": "",
        "landescode": "DE",
        "ortsteil": ""
      }
    },
    "gateway": "<string>",
    "fernschaltung": null,
    "messwerterfassung": "MANUELL_AUSGELESENE",
    "zaehlertypspezifikation": null,
    "befestigungsart": "STECKTECHNIK",
    "zaehlergroesse": "GAS_G4",
    "geraete": [
      {
        "geraetenummer": "1EMH0015009292",
        "weitereGeraetenummern": [
          "<string>",
          "<string>"
        ],
        "geraeteeigenschaften": {
          "geraetetyp": null,
          "geraetemerkmal": "GAS_G4",
          "faktor": 1,
          "volumenerfassung": null,
          "eichungBis": "2032",
          "herstellungsdatum": "2019",
          "baujahr": "<string>",
          "serialnummer": "<string>"
        }
      }
    ],
    "mengenumwertertyp": null,
    "volumenerfassung": null,
    "serialnummer": "<string>",
    "geraetemerkmal": "GAS_G4",
    "herstellungsdatum": "2019",
    "baujahr": "<string>"
  }
]

json

application/json

Zaehlzeitdefinition lesen Schaltzeitdefinition lesen

Leistungskurvendefinition lesen

GET

https://mock.macoapp.de

/getDefinitionPerformance

query Parameters

Struktur (BO4E)	Beschreibung	Format
`parameter1`*	Leistungskurvendefinition · Beispiel: 74018657187 · Vorgabe: 74018657187	string
`parameter2`	LokationsTyp \| Location type · Beispiel: MALO · Vorgabe: MALO	string `MALO`, `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)

Leistungskurvendefinition lesen › Responses

Erfolgreiches Lesen der Leistungskurvendefinition| Successful reading of the performance definition

Array of: Leistungskurvendefinition — die Antwort ist eine Liste dieser Objekte, nicht ein einzelnes Objekt. Jeder Eintrag hat diesen Aufbau:

Struktur (BO4E)	Beschreibung	Format
`boTyp`*	Typ des BO	string `ANSPRECHPARTNER`, `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 25007 DTM Z34 PI 25009	string (date-time)
`endedatum`	Gültigkeitsende der ausgerollten Definition DTM Z35 PI 25009	string (date-time)
`version`	neue Versionsangabe bei inhaltlichen Änderungen mit Fertigstellungsdatum/-zeit DTM 293 PI 25007 25009	string (date-time)
`code`	Leistungskurvendefinition LOC Z09 PI 25009	string
`notwendigkeit`	Status der Nutzung von Definitionen, wird vom Marktpartner angegeben, ob er Definitionen verwendet STS Z36 PI 25007	string `ZAEHLZEITDEFINITIONEN_WERDEN_VERWENDET`, `ZAEHLZEITDEFINITIONEN_WERDEN_NICHT_VERWENDET`, `DEFINITIONEN_WERDEN_VERWENDET` `DEFINITIONEN_WERDEN_NICHT_VERWENDET`
leistungskurven[ ]	Zugeordnete Leistungskurvendefinition	object[]
`code`	Code der Leistungskurvendefinition CCI Z53 PI 17130 17122 17128 UTILTS PI 25007 REQOTE PI 35004 QUOTES PI 15004	string
`aenderungszeitpunkt`	Leistungskurvenänderungszeitpunkt DTM Z45 PI 25009	string (date-time)
`haeufigkeit`	Häufigkeit der Übermittlung, Angabe ob die Leistungskurvendefinition jahrlich oder einmalig übermittelt wird CAV ZE0 PI 25007	string `EINMALIG`, `JAEHRLICH`
`uebermittelbarkeit`	Übermittelbarkeit der ausgerollten Definition CAV ZD5 PI 25007	string `ELEKTRONISCH`, `NICHT_ELEKTRONISCH`
`konfigurationsprodukt`	Konfigurationsprodukt - Produkt-Code Erforderliches Produkt Leistungskurvendefinitionen PIA 5 PI 17130 17128 REQOTE PI 35004 QUOTES PI 15004	string
schwellwert	Schwellwert der Leistungskurvendefinition	object
`obererSchwellwert`	oberer Schwellwert QTY Z40 , Mengenangabe in Prozent PI 25009 REQOTE Wertbereitstellung PI 35003 35004 QUOTES PI 15004	number (float)
`untererSchwellwert`	unterer Schwellwert REQOTE Wertbereitstellung PI 35003 35004 QUOTES PI 15004	number (float)
`konfigurationsprodukt`	Messprodukt-Position-Code CCI Z60 PI 35003 35004	string

Example Responses

[
  {
    "boTyp": "ZAEHLER",
    "versionStruktur": "1",
    "zaehlernummer": "1EMH0015009292",
    "messlokationsId": "DE0073395252733953513649640711234",
    "marktlokationsId": "<string>",
    "sparte": "STROM",
    "gueltigkeitszeitraum": {
      "zeitraumId": 1,
      "startdatum": "2024-12-31T23:00:00Z",
      "enddatum": "2025-12-31T23:00:00Z"
    },
    "datenqualitaet": "ERWARTETE_DATEN",
    "zaehlerauspraegung": "EINRICHTUNGSZAEHLER",
    "zaehlertyp": "WECHSELSTROMZAEHLER",
    "tarifart": "EINTARIF",
    "zaehlerkonstante": 5.4,
    "eichungBis": "2032",
    "zaehlwerke": [
      {
        "zaehlwerkId": "<string>",
        "bezeichnung": "<string>",
        "richtung": "AUSSP",
        "obisKennzahl": "1-0:1.8.1",
        "vorkommastellen": 5,
        "nachkommastellen": 3,
        "wandlerfaktor": 6,
        "einheit": "KUBIKMETER",
        "schwachlastfaehig": "SCHWACHLASTFAEHIG",
        "verwendungszwecke": [
          {
            "marktrolle": "NB",
            "zweck": []
          }
        ],
        "verbrauchsart": [
          "KL"
        ],
        "unterbrechbarkeit": "UV",
        "waermenutzung": "SPEICHERHEIZUNG",
        "konzessionsabgabe": {
          "satz": null,
          "kosten": 126.47,
          "kategorie": "<string>"
        },
        "steuerbefreit": true,
        "vorkommastelle": 8,
        "nachkommastelle": 0,
        "abrechnungsrelevant": false,
        "anzahlAblesungen": 15,
        "zaehlzeiten": {
          "zaehlzeitDefinition": "<string>",
          "register": "<string>",
          "schwachlastfaehig": null
        },
        "konfiguration": "34590456ujdfsdghdlktztwqq-053trg",
        "wertegranularitaet": null,
        "notwendigkeitZweiteMessung": null,
        "werteuebermittlungVerwendungszweck": null,
        "artEMobilitaet": null
      }
    ],
    "zaehlerhersteller": {
      "boTyp": "GESCHAEFTSPARTNER",
      "versionStruktur": "1",
      "anrede": "Frau",
      "name1": "Musterfrau",
      "name2": "Erika",
      "name3": "",
      "name4": "",
      "gewerbekennzeichnung": true,
      "hrnummer": "<string>",
      "amtsgericht": "<string>",
      "kontaktweg": [],
      "umsatzsteuerId": "<string>",
      "glaeubigerId": "<string>",
      "eMailAdresse": "beispiel@example.org",
      "website": "<string>",
      "geschaeftspartnerrolle": [
        "KUNDE"
      ],
      "partneradresse": {
        "postleitzahl": "10117",
        "ort": "Musterstadt",
        "strasse": "Musterstraße",
        "hausnummer": "1",
        "postfach": "",
        "adresszusatz": "Beispieldaten",
        "coErgaenzung": "",
        "landescode": "DE",
        "ortsteil": ""
      }
    },
    "gateway": "<string>",
    "fernschaltung": null,
    "messwerterfassung": "MANUELL_AUSGELESENE",
    "zaehlertypspezifikation": null,
    "befestigungsart": "STECKTECHNIK",
    "zaehlergroesse": "GAS_G4",
    "geraete": [
      {
        "geraetenummer": "1EMH0015009292",
        "weitereGeraetenummern": [
          "<string>",
          "<string>"
        ],
        "geraeteeigenschaften": {
          "geraetetyp": null,
          "geraetemerkmal": "GAS_G4",
          "faktor": 1,
          "volumenerfassung": null,
          "eichungBis": "2032",
          "herstellungsdatum": "2019",
          "baujahr": "<string>",
          "serialnummer": "<string>"
        }
      }
    ],
    "mengenumwertertyp": null,
    "volumenerfassung": null,
    "serialnummer": "<string>",
    "geraetemerkmal": "GAS_G4",
    "herstellungsdatum": "2019",
    "baujahr": "<string>"
  }
]

json

application/json

Feedback zur Dokumentation

Feedback zur Dokumentation

Leistungskurvendefinition lesen

Leistungskurvendefinition lesen

query Parameters

Leistungskurvendefinition lesen › Responses

Leistungskurvendefinition lesen

Leistungskurvendefinition lesen

query Parameters

Leistungskurvendefinition lesen › Responses