Zaehlzeitdefinition lesen

GET

https://mock.macoapp.de

/getDefinitionCounting

Lesen einer Zaehlzeitdefinition anhand des Codes (Parameter1) zum Zeitpunkt (Parameter3) | Reading a perfomance definition using code (Parameter1) at the time (Parameter2)

query Parameters

Struktur (BO4E)	Beschreibung	Format
`parameter1`*	Zaehlzeitdefinition · 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)

Zaehlzeitdefinition lesen › Responses

Erfolgreiches Lesen der Zaehlzeitdefinition | Successful reading of the counting definition

Array of: Zaehlzeitdefinition — 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 25004 DTM Z34 PI 25005 PI	string (date-time)
`endedatum`	Gültigkeitsende der ausgerollten Definition DTM Z35 PI 25005	string (date-time)
`version`	Version der Zählzeitdefinition als Datum	string (date-time)
`notwendigkeit`	Status der Nutzung von Definitionen, wird vom Marktpartner angegeben, ob er Definitionen verwendet STS Z36 PI 25004	string `ZAEHLZEITDEFINITIONEN_WERDEN_VERWENDET`, `ZAEHLZEITDEFINITIONEN_WERDEN_NICHT_VERWENDET`, `DEFINITIONEN_WERDEN_VERWENDET` `DEFINITIONEN_WERDEN_NICHT_VERWENDET`
`versionsangabe`	neue Versionsangabe bei inhaltlichen Änderungen mit Fertigstellungsdatum/-zeit DTM 293 PI 25004 25005	string
`code`	Zählzeitdefinition LOC Z09 PI 25005	string
zaehlzeiten[ ]	.	object[]
`code`	Code der Zählzeitdefinition CCI Z39 PI 17122 UTILTS PI 25004	string
`haeufigkeit`	Häufigkeit der Übermittlung, ob die Zählzeitdefinition jährlich oder nur einmalig zu übermitteln ist CAV ZE0 PI 25004	string `EINMALIG`, `JAEHRLICH`
`uebermittelbarkeit`	Übermittelbarkeit der ausgerollten Definition CAV ZD5 PI 25004	string `ELEKTRONISCH`, `NICHT_ELEKTRONISCH`
`ermittlungLeistungsmaximum`	Ermittlung des Leistungsmaximums bei atypischer Netznutzung, ob Netzbetreiber bei Ermittlung Hochlastzeitfenster nutzt CAV ZD4 PI 25004	string `VERWENDUNG_HOCHLASTFENSTER`, `KEINE_VERWENDUNG_HOCHLASTFENSTER`
`istBestellbar`	Bestellbarkeit der Zählzeitdefinition Z27 Zählzeitdefinition ist bestellbar Z28 Zählzeitdefinition ist nicht bestellbar CAV ZD7 PI 25004	boolean
`typ`	Zählzeitdefinitionstyp CAV ZD3 PI 25004	string `WAERMEPUMPE`, `NACHTSPEICHERHEIZUNG`, `SCHWACHLASTZEITFENSTER` `SONSTIGE`, `HOCHLASTZEITFENSTER`
`beschreibungTyp`	Beschreibung Zählzeitdefinitionstyp im Textform	string
`aenderungszeitpunkt`	Zählzeitänderungszeitpunkt, Wechsel auf ein neues aktives Zählzeitregister DTM Z33 PI 25005	string (date-time)
`register`	Zählendes Register RFF Z28 PI 25005	string
zaehlzeitregister[ ]	Liste der Zählzeitregister	object[]
`register`	Code des Zählzeitregisters CCI Z38 PI 55218 55220 55640 55645 55650 55655 55660 55665 55643 55648 55653 55658 55663 55669 55553 55555 55035 55060 55043 55168 55169 UTILTS CCI Z38 PI 25004	string
`zaehlzeitDefinition`	Code der Zählzeitdefinition CCI Z39 PI 55218 55220 55035 55640 55645 55650 55655 55660 55665 55643 55648 55653 55658 55663 55669 55553 55555 55060 55043 55168 55169 CCI Z41 Keine Zählzeit für Messprodukt erforderlich PI 55060 55043 55168 55169 Z39 Code der Zählzeitdefinition ORDERS Z41 Keine Zählzeit für Messprodukt erforderlich ORDERS CCI Z39 PI 17123 17121 17118 17134 17135 UTILTS RFF Z27 PI 25004	string
`schwachlastfaehig`	Schwachlastfähigkeit des Registers, hier wird übermittelt ob eine Schwachlast-Fähigkeit für die Konzessionsabgabe benötigt wird. Z59 Nicht-Schwachlast fähig Z60 Schwachlast fähig CCI Z10 PI 25004	string `SCHWACHLASTFAEHIG`, `NICHT_SCHWACHLASTFAEHIG`

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

Zähler lesen Leistungskurvendefinition lesen

Zaehlzeitdefinition lesen

GET

https://mock.macoapp.de

/getDefinitionCounting

Lesen einer Zaehlzeitdefinition anhand des Codes (Parameter1) zum Zeitpunkt (Parameter3) | Reading a perfomance definition using code (Parameter1) at the time (Parameter2)

query Parameters

Struktur (BO4E)	Beschreibung	Format
`parameter1`*	Zaehlzeitdefinition · 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)

Zaehlzeitdefinition lesen › Responses

Erfolgreiches Lesen der Zaehlzeitdefinition | Successful reading of the counting definition

Array of: Zaehlzeitdefinition — 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 25004 DTM Z34 PI 25005 PI	string (date-time)
`endedatum`	Gültigkeitsende der ausgerollten Definition DTM Z35 PI 25005	string (date-time)
`version`	Version der Zählzeitdefinition als Datum	string (date-time)
`notwendigkeit`	Status der Nutzung von Definitionen, wird vom Marktpartner angegeben, ob er Definitionen verwendet STS Z36 PI 25004	string `ZAEHLZEITDEFINITIONEN_WERDEN_VERWENDET`, `ZAEHLZEITDEFINITIONEN_WERDEN_NICHT_VERWENDET`, `DEFINITIONEN_WERDEN_VERWENDET` `DEFINITIONEN_WERDEN_NICHT_VERWENDET`
`versionsangabe`	neue Versionsangabe bei inhaltlichen Änderungen mit Fertigstellungsdatum/-zeit DTM 293 PI 25004 25005	string
`code`	Zählzeitdefinition LOC Z09 PI 25005	string
zaehlzeiten[ ]	.	object[]
`code`	Code der Zählzeitdefinition CCI Z39 PI 17122 UTILTS PI 25004	string
`haeufigkeit`	Häufigkeit der Übermittlung, ob die Zählzeitdefinition jährlich oder nur einmalig zu übermitteln ist CAV ZE0 PI 25004	string `EINMALIG`, `JAEHRLICH`
`uebermittelbarkeit`	Übermittelbarkeit der ausgerollten Definition CAV ZD5 PI 25004	string `ELEKTRONISCH`, `NICHT_ELEKTRONISCH`
`ermittlungLeistungsmaximum`	Ermittlung des Leistungsmaximums bei atypischer Netznutzung, ob Netzbetreiber bei Ermittlung Hochlastzeitfenster nutzt CAV ZD4 PI 25004	string `VERWENDUNG_HOCHLASTFENSTER`, `KEINE_VERWENDUNG_HOCHLASTFENSTER`
`istBestellbar`	Bestellbarkeit der Zählzeitdefinition Z27 Zählzeitdefinition ist bestellbar Z28 Zählzeitdefinition ist nicht bestellbar CAV ZD7 PI 25004	boolean
`typ`	Zählzeitdefinitionstyp CAV ZD3 PI 25004	string `WAERMEPUMPE`, `NACHTSPEICHERHEIZUNG`, `SCHWACHLASTZEITFENSTER` `SONSTIGE`, `HOCHLASTZEITFENSTER`
`beschreibungTyp`	Beschreibung Zählzeitdefinitionstyp im Textform	string
`aenderungszeitpunkt`	Zählzeitänderungszeitpunkt, Wechsel auf ein neues aktives Zählzeitregister DTM Z33 PI 25005	string (date-time)
`register`	Zählendes Register RFF Z28 PI 25005	string
zaehlzeitregister[ ]	Liste der Zählzeitregister	object[]
`register`	Code des Zählzeitregisters CCI Z38 PI 55218 55220 55640 55645 55650 55655 55660 55665 55643 55648 55653 55658 55663 55669 55553 55555 55035 55060 55043 55168 55169 UTILTS CCI Z38 PI 25004	string
`zaehlzeitDefinition`	Code der Zählzeitdefinition CCI Z39 PI 55218 55220 55035 55640 55645 55650 55655 55660 55665 55643 55648 55653 55658 55663 55669 55553 55555 55060 55043 55168 55169 CCI Z41 Keine Zählzeit für Messprodukt erforderlich PI 55060 55043 55168 55169 Z39 Code der Zählzeitdefinition ORDERS Z41 Keine Zählzeit für Messprodukt erforderlich ORDERS CCI Z39 PI 17123 17121 17118 17134 17135 UTILTS RFF Z27 PI 25004	string
`schwachlastfaehig`	Schwachlastfähigkeit des Registers, hier wird übermittelt ob eine Schwachlast-Fähigkeit für die Konzessionsabgabe benötigt wird. Z59 Nicht-Schwachlast fähig Z60 Schwachlast fähig CCI Z10 PI 25004	string `SCHWACHLASTFAEHIG`, `NICHT_SCHWACHLASTFAEHIG`

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

Zaehlzeitdefinition lesen

Zaehlzeitdefinition lesen

query Parameters

Zaehlzeitdefinition lesen › Responses

Zaehlzeitdefinition lesen

Zaehlzeitdefinition lesen

query Parameters

Zaehlzeitdefinition lesen › Responses