Zähler lesen - MACO APP

Lesen einer Zaehlers mittels LokationsId (Parameter1) und lokationsTyp (Parameter2 - default MELO) zum Zeitpunkt (Parameter3) | Reading a tranche using location ID (Parameter1) at the time (Parameter2)

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

parameter1

string

required

LokationsId | Location ID

Default:

74018657187

Example:

74018657187

parameter2

enum<string>

required

LokationsTyp | Location type

Allowed values:

MALOMELONELOTECHNISCHE_RESSOURCESTEUERBARE_RESOURCETRANCHE

Default:

MALO

Example:

MALO

parameter3

string <date-time>

required

Datum (Gültig ab) | Date (Valid from)

Example:

2024-06-28T12:18:00Z

Match pattern:

^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$

parameter4

string <date-time>

required

Datum (Gültig bis) | Date (Valid until)

Example:

2024-06-28T12:18:00Z

Match pattern:

^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$

Responses

🟢200OK

application/json

Erfolgreiches Lesen des Zaehlers | Successful reading of the meter

Body

boTyp

enum<string>

required

Typ des BO

Allowed values:

ANSPRECHPARTNERAVISENERGIEMENGEGESCHAEFTSOBJEKTGESCHAEFTSPARTNERMARKTLOKATIONMARKTTEILNEHMERMESSLOKATIONZAEHLERKOSTENTARIFPREISBLATTPREISBLATTNETZNUTZUNGPREISBLATTMESSUNGPREISBLATTUMLAGENPREISBLATTDIENSTLEISTUNGPREISBLATTKONZESSIONSABGABEZEITREIHELASTGANGHANDELSUNSTIMMIGKEITANFRAGEAUFTRAGSTATUSMITTEILUNGBERECHNUNGSFORMELRECHNUNGBILANZIERUNGNETZNUTZUNGSVERTRAGMESSSTELLENBETRIEBSVERTRAGENERGIELIEFERVERTRAGSPERRAUFTRAGANGEBOTTRANCHEKOMMUNIKATIONSDATENZAEHLZEITDEFINITIONSCHALTZEITDEFINITIONLEISTUNGSKURVENDEFINITIONNETZLOKATIONSTEUERBARE_RESSOURCETECHNISCHE_RESSOURCEAD_HOC_STEUERKANALLOKATIONSBUENDELWERTE_NACH_TYP2REKLAMATIONSTATUSBERICHTVERTRAGBILANZKREISVERWENDUNGSZEITRAUMTARIFINFO

versionStruktur

string

required

versionStruktur

Default:

zaehlernummer

string

optional

Nummerierung des Zählers, vergeben durch den Messstellenbetreiber

sparte

enum<string>

optional

Strom oder Gas.

Allowed values:

STROMGASFERNWAERMENAHWAERMEWASSERABWASSER

Example:

STROM

zaehlerauspraegung

enum<string>

optional

Spezifikation die Richtung des Zählers betreffend.

Allowed values:

EINRICHTUNGSZAEHLERZWEIRICHTUNGSZAEHLER

zaehlertyp

enum<string>

optional

Typisierung des Zählers

Allowed values:

DREHSTROMZAEHLERBALGENGASZAEHLERDREHKOLBENZAEHLERSMARTMETERLEISTUNGSZAEHLERMAXIMUMZAEHLERTURBINENRADGASZAEHLERULTRASCHALLGASZAEHLERWECHSELSTROMZAEHLERWIRBELGASZAEHLERMESSDATENREGISTRIERGERAETELEKTRONISCHERHAUSHALTSZAEHLERSONDERAUSSTATTUNGWASSERZAEHLERMODERNEMESSEINRICHTUNG

tarifart

enum<string>

optional

Spezifikation bezüglich unterstützter Tarifarten.

Allowed values:

EINTARIFZWEITARIFMEHRTARIFSMART_METERLEISTUNGSGEMESSEN

zaehlerkonstante

number <float>

optional

Zählerkonstante auf dem Zähler.

eichungBis

string <date-time>

optional

Bis zu diesem Datum ist der Zähler geeicht.

zaehlerhersteller

object (Geschaeftspartner)

optional

Der Hersteller des Zählers. Details Geschaeftspartner

Example:

{"$ref":"https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Geschaeftspartner.json"}

boTyp

enum<string>

required

Typ des BO

Allowed values:

versionStruktur

string

required

versionStruktur

Default:

anrede

string

optional

Die Anrede für den GePa, Z.B. Herr.

name1

string

optional

Erster Teil des Namens. Hier kann der Firmenname oder bei Privatpersonen
beispielsweise der Nachname dargestellt werden. Beispiele: Yellow Strom GmbH
oder Hagen

name2

string

optional

Zweiter Teil des Namens. Hier kann der eine Erweiterung zum Firmennamen oder
bei Privatpersonen beispielsweise der Vorname dargestellt werden. Beispiele:
Bereich Süd oder Nina

name3

string

optional

Dritter Teil des Namens. Hier können weitere Ergänzungen zum Firmennamen oder
bei Privatpersonen Zusätze zum Namen dargestellt werden. Beispiele: und Afrika
oder Sängerin

name4

string

optional

name4

umsatzsteuerId

string

optional

Die Umsatzsteuer-ID des Geschäftspartners. Beispiel: DE 813281825

glaeubigerId

string

optional

Die Gläubiger-ID welche im Zahlungsverkehr verwendet wird- Z.B. DE 47116789

emailAdresse

string

optional

emailAdresse

website

string

optional

Internetseite des Marktpartners. Beispiel: www.mp-energie.de

gewerbekennzeichnung

boolean

optional

Kennzeichnung ob es sich um einen Gewerbe/Unternehmen (gewerbeKennzeichnung = true)
oder eine Privatperson handelt. (gewerbeKennzeichnung = false)

hrnummer

string

optional

Handelsregisternummer des Geschäftspartners

amtsgericht

string

optional

Amtsgericht bzw Handelsregistergericht, das die Handelsregisternummer herausgegeben hat

partneradresse

object (Adresse)

optional

Adresse des Geschäftspartners, an der sich der Hauptsitz befindet. Details

externeKundenummerLieferant

string

optional

externeKundenummerLieferant

externeReferenzen

array[object (ExterneReferenz) {2}]

optional

Hier können IDs anderer Systeme hinterlegt werden (z.B. eine SAP-GP-Nummer) (Details siehe
ExterneReferenz)

geschaeftspartnerrolle

array[string]

optional

Rolle, die der Geschäftspartner hat (z.B. Interessent, Kunde).

Allowed values:

KUNDELIEFERANTDIENSTLEISTERINTERESSENTMARKTPARTNEREIGENTUEMERHAUSVERWALTERKORRESPONDENZEMPFAENGERABLESEKARTENEMPFAENGER

kontaktweg

array[string]

optional

Bevorzugter Kontaktweg des Geschäftspartners.

Allowed values:

ANSCHREIBENTELEFONATFAXE_MAILSMS

gateway

string

optional

Angabe eines SMGW, mit dem der Zaehler parametrisiert ist

fernschaltung

enum<string>

optional

Fernschaltung

Allowed values:

VORHANDENNICHT_VORHANDEN

messwerterfassung

enum<string>

optional

Messwerterfassung am Zählpunkt

Allowed values:

FERNAUSLESBARMANUELL_AUSGELESENE

zaehlertypspezifikation

enum<string>

optional

Typisierung des Zählers (spezifikation für EHZ und MME)

Allowed values:

EDL40EDL21SONSTIGER_EHZMME_STANDARDMME_MEDA

befestigungsart

enum<string>

optional

Befestigungsart

Allowed values:

STECKTECHNIKDREIPUNKTHUTSCHIENEEINSTUTZENZWEISTUTZEN

zaehlergroesse

enum<string>

optional

Zaehlergroesse

Allowed values:

EINTARIFZWEITARIFMEHRTARIFGAS_G2P5GAS_G4GAS_G6GAS_G10GAS_G16GAS_G25GAS_G40GAS_G65GAS_G100GAS_G160GAS_G250GAS_G350GAS_G400GAS_G4000GAS_G650GAS_G6500GAS_G1000GAS_G10000GAS_G12500GAS_G1600GAS_G16000GAS_G2500IMPULSGEBER_G4_G100IMPULSGEBER_G100MODEM_GSMMODEM_GPRSMODEM_FUNKMODEM_GSM_O_LGMODEM_GSM_M_LGMODEM_FESTNETZMODEM_GPRS_M_LGPLC_COMETHERNET_KOMDSL_KOMLTE_KOMRUNDSTEUEREMPFAENGERTARIFSCHALTGERAETZUSTANDS_MUTEMPERATUR_MUKOMPAKT_MUSYSTEM_MUUNBESTIMMTWASSER_MWZWWASSER_WZWWWASSER_WZ01WASSER_WZ02WASSER_WZ03WASSER_WZ04WASSER_WZ05WASSER_WZ06WASSER_WZ07WASSER_WZ08WASSER_WZ09WASSER_WZ10WASSER_VWZ04WASSER_VWZ05WASSER_VWZ06WASSER_VWZ07WASSER_VWZ10DICHTEMENGENUMWERTERTEMPERATURMENGENUMWERTERZUSTANDSMENGENUMWERTERBLOCKSTROMWANDLERMESSWANDLERSATZ_IMS_MMEKOMBIMESSWANDLERSPANNUNGSWANDLER

mengenumwertertyp

enum<string>

optional

Mengenumwertertyp

Allowed values:

DICHTEMENGENUMWERTERTEMPERATURMENGENUMWERTERZUSTANDSMENGENUMWERTER

volumenerfassung

enum<string>

optional

Volumenerfassung

Allowed values:

HOCHFREQUENZSONDEKENNLINIENKORREKTURSCHLEICHMENGENUNTERDRUECKUNG

serialnummer

string

optional

serialnummer

geraetemerkmal

enum<string>

optional

Weitere Merkmale des Geräts, zum Beispiel Mehrtarif, Eintarif etc.. Details Geraetemerkmal

Allowed values:

herstellungsdatum

string <date-time>

optional

herstellungsdatum

baujahr

string

optional

baujahr

messlokationsId

string

optional

messlokationsId

marktlokationsId

string

optional

marktlokationsId

geraete

array[object (Geraet) {7}]

optional

Liste der Geräte, die zu diesem Zähler gehören.

geraetetyp

enum<string>

optional

Auflistung möglicher abzurechnender Gerätetypen

Allowed values:

WECHSELSTROMZAEHLERDREHSTROMZAEHLERZWEIRICHTUNGSZAEHLERRLM_ZAEHLERIMS_ZAEHLERBALGENGASZAEHLERMAXIMUMZAEHLERMULTIPLEXANLAGEPAUSCHALANLAGEVERSTAERKERANLAGESUMMATIONSGERAETIMPULSGEBEREDL_21_ZAEHLERAUFSATZVIER_QUADRANTEN_LASTGANGZAEHLERMENGENUMWERTERSTROMWANDLERSPANNUNGSWANDLERDATENLOGGERKOMMUNIKATIONSANSCHLUSSMODEMTELEKOMMUNIKATIONSEINRICHTUNGKOMMUNIKATIONSEINRICHTUNGDREHKOLBENGASZAEHLERTURBINENRADGASZAEHLERULTRASCHALLZAEHLERWIRBELGASZAEHLERMODERNE_MESSEINRICHTUNGELEKTRONISCHER_HAUSHALTSZAEHLERSTEUEREINRICHTUNGTECHNISCHESTEUEREINRICHTUNGTARIFSCHALTGERAETRUNDSTEUEREMPFAENGEROPTIONALE_ZUS_ZAEHLEINRICHTUNGMESSWANDLERSATZ_IMS_MMEKOMBIMESSWANDLER_IMS_MMETARIFSCHALTGERAET_IMS_MMERUNDSTEUEREMPFAENGER_IMS_MMETEMPERATUR_KOMPENSATIONHOECHSTBELASTUNGS_ANZEIGERSONSTIGES_GERAETSMARTMETERGATEWAYSTEUERBOXBLOCKSTROMWANDLERKOMBIMESSWANDLERMODEM_GSMETHERNET_KOMPLC_COMMODEM_FESTNETZDSL_KOMLTE_KOMDICHTEMENGENUMWERTERTEMPERATURMENGENUMWERTERZUSTANDSMENGENUMWERTERMESSDATENREGISTRIERGERAETWANDLER

bezeichnung

string

optional

Bezeichnung des Gerätes

geraetenummer

string

optional

Die auf dem Geräte aufgedruckte Nummer, die vom MSB vergeben wird.

geraetereferenz

string

optional

geraetereferenz

geraeteeigenschaften

object (Geraeteeigenschaften)

optional

Festlegung der Eigenschaften des Gerätes. Z.B. Wandler MS/NS.

volumenerfassung

enum<string>

optional

Volumenerfassung

Allowed values:

HOCHFREQUENZSONDEKENNLINIENKORREKTURSCHLEICHMENGENUNTERDRUECKUNG

weitereGeraetenummern

array[string]

optional

weitereGeraetenummern

zaehlwerke

array[object (Zaehlwerk) {27}]

optional

Die Zählwerke des Zählers.

zaehlwerkId

string

optional

Identifikation des Zählwerks (Registers) innerhalb des Zählers. Oftmals eine laufende Nummer hinter der
Zählernummer. Z.B. 47110815_1

bezeichnung

string

optional

Zusätzliche Bezeichnung, z.B. Zählwerk_Wirkarbeit.

richtung

enum<string>

optional

Die Energierichtung, Einspeisung oder Ausspeisung. Details Energierichtung

Allowed values:

AUSSPEINSP

obisKennzahl

string

optional

Die OBIS-Kennzahl für das Zählwerk, die festlegt, welche auf die gemessene Größe mit dem Stand gemeldet wird.
Nur Zählwerkstände mit dieser OBIS-Kennzahl werden an diesem Zählwerk registriert. Beispiel:1-0:1.8.1 für
elektrische Wirkarbeit.

wandlerfaktor

number <float>

optional

Mit diesem Faktor wird eine Zählerstandsdifferenz multipliziert, um zum eigentlichen Verbrauch im Zeitraum zu
kommen.

einheit

enum<string>

optional

Die Einheit der gemessenen Größe, z.B. kWh. Details Mengeneinheit

Allowed values:

WWHKWKWHKVARHMWMWHSTUECKKUBIKMETERSTUNDETAGMONATJAHRPROZENTANZAHLVARKVARVARHKWHKZ16KWT

schwachlastfaehig

enum<string>

optional

schwachlastfaehig

Allowed values:

SCHWACHLASTFAEHIGNICHT_SCHWACHLASTFAEHIG

verbrauchsart

enum<string>

optional

Stromverbrauchsart/Verbrauchsart Marktlokation

Allowed values:

KLWEMOBSBSWWK

unterbrechbarkeit

enum<string>

optional

Stromverbrauchsart/Unterbrechbarkeit Marktlokation

Allowed values:

UVNUV

waermenutzung

enum<string>

optional

Stromverbrauchsart/Wärmenutzung Marktlokation

Allowed values:

SPEICHERHEIZUNGWAERMEPUMPEDIREKTHEIZUNGWAERMEPUMPE_WAERME_KAELTEWAERMEPUMPE_KAELTEWAERMEPUMPE_WAERME

konzessionsabgabe

object (Konzessionsabgabe)

optional

steuerbefreit

boolean

optional

steuerbefreit

vorkommastelle

integer

optional

vorkommastelle

nachkommastelle

integer

optional

nachkommastelle

abrechnungsrelevant

boolean

optional

abrechnungsrelevant

anzahlAblesungen

integer

optional

anzahlAblesungen

zaehlzeiten

object (Zaehlzeitregister)

optional

konfiguration

string

optional

Konfiguration (iMSys) des Zählwerks

messprodukt

string

optional

messprodukt

wertegranularitaet

enum<string>

optional

Wertegranularitaet

Allowed values:

JAEHRLICHHALBJAEHRLICHQUARTALSWEISEMONATLICH

notwendigkeitZweiteMessung

enum<string>

optional

NotwendigkeitZweiteMessung

Allowed values:

VORHANDENNICHT_VORHANDEN

werteuebermittlungVerwendungszweck

enum<string>

optional

WerteuebermittlungVerwendungszweck

Allowed values:

VORHANDENNICHT_VORHANDEN

artEMobilitaet

enum<string>

optional

ArtEmobilitaet

Allowed values:

WBLSLP

konfigurationsprodukt

string

optional

konfigurationsprodukt

keinKonfigurationsprodukt

boolean

optional

keinKonfigurationsprodukt

leistungskurvendefinition

string

optional

leistungskurvendefinition

verwendungszwecke

array[object (Verwendungszweck) {2}]

optional

Verwendungungszweck der Werte Marktlokation

datenqualitaet

enum<string>

optional

Datenqualitaet

Allowed values:

ERWARTETE_DATENIM_SYSTEM_VORHANDENE_DATENINFORMATIVE_DATENGUELTIGE_DATENKEINE_DATENIM_SYSTEM_KEINE_DATEN_VORHANDENKEINE_DATEN_ERWARTETDIFFERENZ_DATENDIFFERENZ_ERWARTETE_DATENDIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN

gueltigkeitszeitraum

object (Zeitraum)

optional

zeiteinheit

enum<string>

optional

Zeiteinheit

Allowed values:

SEKUNDEMINUTESTUNDEVIERTEL_STUNDETAGWOCHEMONATQUARTALHALBJAHRJAHR

dauer

integer

optional

dauer

startdatum

string <date-time>

optional

startdatum

enddatum

string <date-time>

optional

enddatum

einheit

enum<string>

optional

Zeiteinheit

Allowed values:

SEKUNDEMINUTESTUNDEVIERTEL_STUNDETAGWOCHEMONATQUARTALHALBJAHRJAHR

ableseZeitraum

string

optional

ableseZeitraum

abrechnungsZeitraum

string

optional

abrechnungsZeitraum

zeitraumText

string

optional

zeitraumText

zeitraumId

integer

optional

zeitraumId

Example

{
  "$ref": "https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Zaehler.json"
}

🟠400Bad Request