Zählerstand einer Lokation lesen - MACO APP

Lesen eines oder mehrerer Zählerstände über eine Lokation (Parameter1) in einer Range (Parameter2/Parameter3) und einer OBIS Kennzahl (Parameter4 optional)

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

Default:

74018657187

Example:

74018657187

parameter2

enum<string>

required

LokationsTyp

Allowed values:

MALOMELONELOTECHNISCHE_RESSOURCESTEUERBARE_RESOURCETRANCHE

Default:

MALO

Example:

MALO

parameter3

string <date-time>

required

Datum (Gültig ab) oder Stichtag, wenn parameter4 nicht gesetzt

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)

Example:

2024-06-28T12:18:00Z

Match pattern:

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

parameter5

string

required

OBIS Kennzah

Example:

123456789

command

string

optional

Entspricht der operationId dieser Schnittstelle. Diese Operation Id entspricht dem Command im Camunda Konnektor Prozess. Wenn das Backend einen generischen Endpunkt bereitstellt, kann dieses Command gentutzt werden um zu definieren welche Operation ausgeführt werden soll.

Example:

SAP_LESEN_ENERGIEMENGE_ZAEHLERSTAND

Responses

🟢200OK

application/json

Erfolgreiches Lesen der Zählerstände | Successful reading of the meter readings

Body

boTyp

enum<string>

required

Typ des BO

Allowed values:

ANSPRECHPARTNERAVISENERGIEMENGEGESCHAEFTSOBJEKTGESCHAEFTSPARTNERMARKTLOKATIONMARKTTEILNEHMERMESSLOKATIONZAEHLERKOSTENTARIFPREISBLATTPREISBLATTNETZNUTZUNGPREISBLATTMESSUNGPREISBLATTUMLAGENPREISBLATTDIENSTLEISTUNGPREISBLATTKONZESSIONSABGABEZEITREIHELASTGANGHANDELSUNSTIMMIGKEITANFRAGEAUFTRAGSTATUSMITTEILUNGBERECHNUNGSFORMELRECHNUNGBILANZIERUNGNETZNUTZUNGSVERTRAGMESSSTELLENBETRIEBSVERTRAGENERGIELIEFERVERTRAGSPERRAUFTRAGANGEBOTTRANCHEKOMMUNIKATIONSDATENZAEHLZEITDEFINITIONSCHALTZEITDEFINITIONLEISTUNGSKURVENDEFINITIONNETZLOKATIONSTEUERBARE_RESSOURCETECHNISCHE_RESSOURCEAD_HOC_STEUERKANALLOKATIONSBUENDELWERTE_NACH_TYP2REKLAMATIONSTATUSBERICHTVERTRAGBILANZKREISVERWENDUNGSZEITRAUMTARIFINFO

versionStruktur

string

required

versionStruktur

Default:

lokationsId

string

optional

Eindeutige Nummer der Marktlokation bzw. der Messlokation, zu der die Energiemenge gehört

lokationsTyp

enum<string>

optional

Gibt an, ob es sich um eine Markt- oder Messlokation handelt.

Allowed values:

MALOMELONELOTECHNISCHE_RESSOURCE

fertigstellungsdatum

string <date-time>

optional

fertigstellungsdatum

startdatum

string <date-time>

optional

Gibt Tag und Uhrzeit (falls vorhanden) an, wann der Zeitraum startet.

enddatum

string <date-time>

optional

Gibt Tag und Uhrzeit (falls vorhanden) an, wann der Zeitraum endet.

bilanzierungsdatum

string <date-time>

optional

bilanzierungsdatum

beginndatum

string <date-time>

optional

beginndatum

referenzStammdatenmeldungMsb

string

optional

referenzStammdatenmeldungMsb

konfiguration

string

optional

konfiguration

energieverbrauch

array[object (Verbrauch) {15}]

optional

Gibt den Verbrauch in einer Zeiteinheit an.

startdatum

string <date-time>

optional

startdatum

enddatum

string <date-time>

optional

enddatum

wertermittlungsverfahren

enum<string>

optional

Wertermittlungsverfahren

Allowed values:

PROGNOSEMESSUNG

messwertstatus

enum<string>

optional

Der Status eines Zählerstandes

Allowed values:

ABGELESENERSATZWERTVORSCHLAGSWERTNICHT_VERWENDBARPROGNOSEWERTENERGIEMENGESUMMIERTVOLAEUFIGERWERTFEHLTANGABE_FUER_LIEFERSCHEINGRUNDLAGE_POG_ERMITTLUNG

obiskennzahl

string

optional

obiskennzahl

wert

number <float>

optional

wert

einheit

enum<string>

optional

Einheit: Messgrößen, die per Messung oder Vorgabe ermittelt werden können

Allowed values:

WWHKWKWHKVARHMWMWHSTUECKKUBIKMETERSTUNDETAGMONATJAHRPROZENTANZAHLVARKVARVARHKWHKZ16KWT

type

enum<string>

optional

Verbrauchsmengetyp

Allowed values:

ARBEITLEISTUNGTAGESPARAMETERABHMALOVERANSCHLAGTEJAHRESMENGETUMKUNDENWERT

tarifstufe

enum<string>

optional

Tarifstufe

Allowed values:

TARIFSTUFE_0TARIFSTUFE_1TARIFSTUFE_2TARIFSTUFE_3TARIFSTUFE_4TARIFSTUFE_5TARIFSTUFE_6TARIFSTUFE_7TARIFSTUFE_8TARIFSTUFE_9

nutzungszeitpunkt

string <date-time>

optional

nutzungszeitpunkt

ausfuehrungszeitpunkt

string <date-time>

optional

ausfuehrungszeitpunkt

position

integer

optional

position

ablesedatum

string <date-time>

optional

ablesedatum

leistungsperiode

string

optional

leistungsperiode

statuszusatzinformationen

array[object (StatusZusatzInformation) {2}]

optional

statuszusatzinformationen

Example

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

🟠400Bad Request