Read meter

GET

https://mock.macoapp.de

/getCounterBasic

Reading a meter using LocationId (Parameter1) and locationType (Parameter2 - default MELO) at the point in time (Parameter3) | Reading a tranche using location ID (Parameter1) at the time (Parameter2)

query Parameters

Structure (BO4E)	Description	Format
`parameter1`*	Location ID \| Location ID · Example: 74018657187 · Default: 74018657187	string
`parameter2`*	Location type \| Location type · Example: MALO · Default: MALO	string `MALO`, `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 meter › Responses

Successful reading of the meter | Successful reading of the meter

Array of: Meter — 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	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
`zaehlernummer`	Number of the device CAV Z30 PI 55600 55601 55643 55648 55653 55658 55663 55669 55553 55555 55035 55095 55060 55194 55039 55040 55042 55043 55168 55169 55074 55075 55076 RFF MG Device number of the meter PI 55643 55648 55653 55658 55663 55669 55060 55043 55168 55169 55074 55075 55076 QUOTES RFF Z09 Device number PI 15001 MSCONS RFF MG PI 13017 13002	string
`sparte`	Electricity or gas	string `STROM`, `GAS`, `FERNWAERME` `NAHWAERME`, `WASSER`, `ABWASSER`
`zaehlerauspraegung`	Energy direction CAV ERZ PI 55643 55648 55653 55658 55663 55669 55043 55168 55169 55074 55075 55076 QUOTES PI 15001	string `EINRICHTUNGSZAEHLER`, `ZWEIRICHTUNGSZAEHLER`
`zaehlertyp`	Value specification of the meter - metering device CAV AHZ PI 55643 55648 55653 55658 55663 55669 55035 55095 55060 55043 55168 55169 55074 55075 55076 QUOTES PI 15001 UTILMD gas	string `DREHSTROMZAEHLER`, `BALGENGASZAEHLER`, `DREHKOLBENZAEHLER` `SMARTMETER`, `LEISTUNGSZAEHLER`, `MAXIMUMZAEHLER`, `TURBINENRADGASZAEHLER`, `ULTRASCHALLGASZAEHLER`, `WECHSELSTROMZAEHLER`, `WIRBELGASZAEHLER`, `MESSDATENREGISTRIERGERAET`, `ELEKTRONISCHERHAUSHALTSZAEHLER`, `SONDERAUSSTATTUNG`, `WASSERZAEHLER`, `MODERNEMESSEINRICHTUNG`
`tarifart`	Number of tariffs, number of registers - The information of the device actually installed is specified. CAV ETZ PI 55643 55648 55653 55658 55663 55669 55043 55168 55169 55074 55075 55076 QUOTES PI 15001	string `EINTARIF`, `ZWEITARIF`, `MEHRTARIF` `SMART_METER`, `LEISTUNGSGEMESSEN`
`zaehlerkonstante`	Meter constant on the meter.	number (float)
`eichungBis`	Calibration validity - the meter is calibrated up to this date. DTM Z04 PI 15001	string
zaehlerhersteller	The manufacturer of the meter. Details Business partner	object
`boTyp`*	Type of the 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
`anrede`	The form of address for the GePa, e.g. Herr. Z04 Correspondence address of the customer of the supplier PI 55001 55600 55601 55013 55014 55043 55168 55169	string
`name1`	First part of the name. This can hold the company name or, for private individuals, the surname, for example. Examples: Yellow Strom GmbH or Hagen	string
`name2`	Second part of the name. Here an extension to the company name or, for private individuals, the first name for example can be entered. Examples: Bereich Süd or Nina	string
`name3`	Third part of the name. Here further additions to the company name or, for private individuals, additions to the name can be shown. Examples: and Africa or singer	string
`name4`	Name 4	string
`umsatzsteuerId`	The VAT ID of the business partner. Example: DE 813281825	string
`glaeubigerId`	The creditor ID used in payment transactions- e.g. DE 47116789	string
`emailAdresse`	email address	string
`website`	Website of the market partner. Example: www.mp-energie.de	string
`gewerbekennzeichnung`	Indicates whether this is a commercial business/company (gewerbeKennzeichnung = true) or a private individual. (gewerbeKennzeichnung = false) Z01 Structure of personal names Z02 Structure of the company name	boolean
`hrnummer`	Commercial register number of the business partner	string
`amtsgericht`	Local court or commercial register court that issued the commercial register number	string
`externeKundenummerLieferant`	externeKundenummerLieferant	string
`geschaeftspartnerrolle`[ ]	Geschaeftspartnerrolle	string[] `KUNDE`, `LIEFERANT`, `DIENSTLEISTER` `INTERESSENT`, `MARKTPARTNER`, `EIGENTUEMER`, `HAUSVERWALTER`, `KORRESPONDENZEMPFAENGER`, `ABLESEKARTENEMPFAENGER`
`kontaktweg`[ ]	Indicates the way in which the person or the business partner can be contacted	string[] `ANSCHREIBEN`, `TELEFONAT`, `FAX` `E_MAIL`, `SMS`
partneradresse	Address of the business partner at which the head office is located.	object
`postleitzahl`	Postal code	string
`ort`	City	string
`strasse`	Street	string
`hausnummer`	House number and supplement	string
`postfach`	PO box	string
`adresszusatz`	Address supplement	string
`coErgaenzung`	coErgaenzung	string
`landescode`	Country code	string `AC`, `AD`, `AE` `AF`, `AG`, `AI`, `AL`, `AM`, `AN`, `AO`, `AQ`, `AR`, `AS`, `AT`, `AU`, `AW`, `AX`, `AZ`, `BA`, `BB`, `BD`, `BE`, `BF`, `BG`, `BH`, `BI`, `BJ`, `BL`, `BM`, `BN`, `BO`, `BQ`, `BR`, `BS`, `BT`, `BU`, `BV`, `BW`, `BY`, `BZ`, `CA`, `CC`, `CD`, `CF`, `CG`, `CH`, `CI`, `CK`, `CL`, `CM`, `CN`, `CO`, `CP`, `CR`, `CS`, `CU`, `CV`, `CW`, `CX`, `CY`, `CZ`, `DE`, `DG`, `DJ`, `DK`, `DM`, `DO`, `DZ`, `EA`, `EC`, `EE`, `EG`, `EH`, `ER`, `ES`, `ET`, `EU`, `FI`, `FJ`, `FK`, `FM`, `FO`, `FR`, `FX`, `GA`, `GB`, `GD`, `GE`, `GF`, `GG`, `GH`, `GI`, `GL`, `GM`, `GN`, `GP`, `GQ`, `GR`, `GS`, `GT`, `GU`, `GW`, `GY`, `HK`, `HM`, `HN`, `HR`, `HT`, `HU`, `IC`, `ID`, `IE`, `IL`, `IM`, `IN`, `IO`, `IQ`, `IR`, `IS`, `IT`, `JE`, `JM`, `JO`, `JP`, `KE`, `KG`, `KH`, `KI`, `KM`, `KN`, `KP`, `KR`, `KW`, `KY`, `KZ`, `LA`, `LB`, `LC`, `LI`, `LK`, `LR`, `LS`, `LT`, `LU`, `LV`, `LY`, `MA`, `MC`, `MD`, `ME`, `MF`, `MG`, `MH`, `MK`, `ML`, `MM`, `MN`, `MO`, `MP`, `MQ`, `MR`, `MS`, `MT`, `MU`, `MV`, `MW`, `MX`, `MY`, `MZ`, `NA`, `NC`, `NE`, `NF`, `NG`, `NI`, `NL`, `NO`, `NP`, `NR`, `NT`, `NU`, `NZ`, `OM`, `PA`, `PE`, `PF`, `PG`, `PH`, `PK`, `PL`, `PM`, `PN`, `PR`, `PS`, `PT`, `PW`, `PY`, `QA`, `RE`, `RO`, `RS`, `RU`, `RW`, `SA`, `SB`, `SC`, `SD`, `SE`, `SF`, `SG`, `SH`, `SI`, `SJ`, `SK`, `SL`, `SM`, `SN`, `SO`, `SR`, `SS`, `ST`, `SU`, `SV`, `SX`, `SY`, `SZ`, `TA`, `TC`, `TD`, `TF`, `TG`, `TJ`, `TK`, `TL`, `TM`, `TN`, `TO`, `TP`, `TR`, `TT`, `TV`, `TW`, `TZ`, `UA`, `UG`, `UK`, `UM`, `US`, `UY`, `UZ`, `VA`, `VC`, `VE`, `VG`, `VI`, `VN`, `VU`, `WF`, `WS`, `XK`, `YE`, `YT`, `YU`, `ZA`, `ZM`, `ZR`, `ZW`
`ortsteil`	District	string
zusatzInformation	Additional information for identification, line for name and address	object
`zusatz1`	Address supplement 1	string
`zusatz2`	Address supplement 2	string
`zusatz3`	Address supplement 3	string
`zusatz4`	Address supplement 4	string
`zusatz5`	Address supplement 5	string
externeReferenzen[ ]	IDs of other systems can be stored here (e.g. a SAP business partner number) (for details see external reference)	object[]
`exRefName`	Name of the external reference, customer number at the supplier, refers to the preceding NAD segment RFF AVC PI 55109 55137 RFF AVC customer number at the supplier ORDERS PI 17101	string `Kundennummer beim Lieferanten`, `Kundennummer beim Altlieferanten`
`exRefWert`	Customer number at the previous supplier - specification of references for responses and requests PI 55109 55137 ORDERS PI 17101	string
ansprechpartner	Contact person as in EDIFACT CTA+IC' COM+?+3222271020:TE', that includes e.g. the phone number of customer.	object
`boTyp`*	Type of the 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
`nachname`	Surname (family name) of the contact person	string
`eMailAdresse`	Email address	string
rufnummern[ ]	List of the telephone numbers on which the contact person can be reached.	object[]
`nummerntyp`	Type of means of communication COM	string `RUF_ZENTRALE`, `FAX_ZENTRALE`, `SAMMELRUF` `SAMMELFAX`, `ABTEILUNGRUF`, `ABTEILUNGFAX`, `RUF_DURCHWAHL`, `FAX_DURCHWAHL`, `MOBIL_NUMMER`
`rufnummer`	Phone number	string
`gateway`	Assignment of the metering device to the smart meter gateway via which the communication takes place. RFF Z14 PI 55643 55648 55653 55658 55663 55669 55553 55555 55035 55095 55060 55043 55168 55169 55074 55075 55076	string
`fernschaltung`	Remote switching of the metering device, provides the information whether the remote switching function is available. The remote switching offers the possibility of interrupting the energy flow through the metering device or of lifting the interruption. CAV Z58 PI 55643 55648 55653 55658 55663 55669 55043 55168 55169 55074 55075 55076	string `VORHANDEN`, `NICHT_VORHANDEN`
`messwerterfassung`	Technical capability - meter reading capture at the metering device CAV AMR PI 55643 55648 55663 55669 55035 55095 55060 55043 55168 55169 QUOTES PI 15001	string `FERNAUSLESBAR`, `MANUELL_AUSGELESENE`
`zaehlertypspezifikation`	Meter type PI 55643 55648 55653 55658 55663 55669 55035 55095 55060 55043 55168 55169 QUOTES PI 15001	string `EDL40`, `EDL21`, `SONSTIGER_EHZ` `MME_STANDARD`, `MME_MEDA`
`befestigungsart`	Mounting type of the metering device CAV BKE PI 55643 55648 55663 55669 55043 55168 55169 QUOTES PI 15001	string `STECKTECHNIK`, `DREIPUNKT`, `HUTSCHIENE` `EINSTUTZEN`, `ZWEISTUTZEN`
`zaehlergroesse`	Metering device/meter size (gas) PI 15001	string `EINTARIF`, `ZWEITARIF`, `MEHRTARIF` `GAS_G2P5`, `GAS_G4`, `GAS_G6`, `GAS_G10`, `GAS_G16`, `GAS_G25`, `GAS_G40`, `GAS_G65`, `GAS_G100`, `GAS_G160`, `GAS_G250`, `GAS_G350`, `GAS_G400`, `GAS_G4000`, `GAS_G650`, `GAS_G6500`, `GAS_G1000`, `GAS_G10000`, `GAS_G12500`, `GAS_G1600`, `GAS_G16000`, `GAS_G2500`, `IMPULSGEBER_G4_G100`, `IMPULSGEBER_G100`, `MODEM_GSM`, `MODEM_GPRS`, `MODEM_FUNK`, `MODEM_GSM_O_LG`, `MODEM_GSM_M_LG`, `MODEM_FESTNETZ`, `MODEM_GPRS_M_LG`, `PLC_COM`, `ETHERNET_KOM`, `DSL_KOM`, `LTE_KOM`, `RUNDSTEUEREMPFAENGER`, `TARIFSCHALTGERAET`, `ZUSTANDS_MU`, `TEMPERATUR_MU`, `KOMPAKT_MU`, `SYSTEM_MU`, `UNBESTIMMT`, `WASSER_MWZW`, `WASSER_WZWW`, `WASSER_WZ01`, `WASSER_WZ02`, `WASSER_WZ03`, `WASSER_WZ04`, `WASSER_WZ05`, `WASSER_WZ06`, `WASSER_WZ07`, `WASSER_WZ08`, `WASSER_WZ09`, `WASSER_WZ10`, `WASSER_VWZ04`, `WASSER_VWZ05`, `WASSER_VWZ06`, `WASSER_VWZ07`, `WASSER_VWZ10`, `DICHTEMENGENUMWERTER`, `TEMPERATURMENGENUMWERTER`, `ZUSTANDSMENGENUMWERTER`, `BLOCKSTROMWANDLER`, `MESSWANDLERSATZ_IMS_MME`, `KOMBIMESSWANDLER`, `SPANNUNGSWANDLER`
`mengenumwertertyp`	not in use	string `DICHTEMENGENUMWERTER`, `TEMPERATURMENGENUMWERTER`, `ZUSTANDSMENGENUMWERTER`
`volumenerfassung`	Type of volume measurement CAV ZC0 PI 44116 44148 44149 44043 44168 44169 44060	string `HOCHFREQUENZSONDE`, `KENNLINIENKORREKTUR`, `SCHLEICHMENGENUNTERDRUECKUNG`
`serialnummer`	Manufacturer number - serial number GIN BN PI 15001	string
`geraetemerkmal`	Metering device/meter size (gas) PI 15001	string `EINTARIF`, `ZWEITARIF`, `MEHRTARIF` `GAS_G2P5`, `GAS_G4`, `GAS_G6`, `GAS_G10`, `GAS_G16`, `GAS_G25`, `GAS_G40`, `GAS_G65`, `GAS_G100`, `GAS_G160`, `GAS_G250`, `GAS_G350`, `GAS_G400`, `GAS_G4000`, `GAS_G650`, `GAS_G6500`, `GAS_G1000`, `GAS_G10000`, `GAS_G12500`, `GAS_G1600`, `GAS_G16000`, `GAS_G2500`, `IMPULSGEBER_G4_G100`, `IMPULSGEBER_G100`, `MODEM_GSM`, `MODEM_GPRS`, `MODEM_FUNK`, `MODEM_GSM_O_LG`, `MODEM_GSM_M_LG`, `MODEM_FESTNETZ`, `MODEM_GPRS_M_LG`, `PLC_COM`, `ETHERNET_KOM`, `DSL_KOM`, `LTE_KOM`, `RUNDSTEUEREMPFAENGER`, `TARIFSCHALTGERAET`, `ZUSTANDS_MU`, `TEMPERATUR_MU`, `KOMPAKT_MU`, `SYSTEM_MU`, `UNBESTIMMT`, `WASSER_MWZW`, `WASSER_WZWW`, `WASSER_WZ01`, `WASSER_WZ02`, `WASSER_WZ03`, `WASSER_WZ04`, `WASSER_WZ05`, `WASSER_WZ06`, `WASSER_WZ07`, `WASSER_WZ08`, `WASSER_WZ09`, `WASSER_WZ10`, `WASSER_VWZ04`, `WASSER_VWZ05`, `WASSER_VWZ06`, `WASSER_VWZ07`, `WASSER_VWZ10`, `DICHTEMENGENUMWERTER`, `TEMPERATURMENGENUMWERTER`, `ZUSTANDSMENGENUMWERTER`, `BLOCKSTROMWANDLER`, `MESSWANDLERSATZ_IMS_MME`, `KOMBIMESSWANDLER`, `SPANNUNGSWANDLER`
`herstellungsdatum`	Production/manufacturing date DTM 94 PI 15001	string
`baujahr`	Year of construction / year of placing on the market DTM Z03 PI 15001	string
`messlokationsId`	Reference to an ID of a metering location to which the metering device is assigned. RFF Z19 PI 55035 55095 55060 55040 55043 55168 55169 55074 55075 55076	string
`marktlokationsId`	Reference to the ID of a market location per meter of a Melo. RFF Z18 PI 55043 55168 55169 55074 55075 55076	string
geraete[ ]	List of the devices belonging to this meter.	object[]
`geraetetyp`	List of possible billable device types	string `WECHSELSTROMZAEHLER`, `DREHSTROMZAEHLER`, `ZWEIRICHTUNGSZAEHLER` `RLM_ZAEHLER`, `IMS_ZAEHLER`, `BALGENGASZAEHLER`, `MAXIMUMZAEHLER`, `MULTIPLEXANLAGE`, `PAUSCHALANLAGE`, `VERSTAERKERANLAGE`, `SUMMATIONSGERAET`, `IMPULSGEBER`, `EDL_21_ZAEHLERAUFSATZ`, `VIER_QUADRANTEN_LASTGANGZAEHLER`, `MENGENUMWERTER`, `STROMWANDLER`, `SPANNUNGSWANDLER`, `DATENLOGGER`, `KOMMUNIKATIONSANSCHLUSS`, `MODEM`, `TELEKOMMUNIKATIONSEINRICHTUNG`, `KOMMUNIKATIONSEINRICHTUNG`, `DREHKOLBENGASZAEHLER`, `TURBINENRADGASZAEHLER`, `ULTRASCHALLZAEHLER`, `WIRBELGASZAEHLER`, `MODERNE_MESSEINRICHTUNG`, `ELEKTRONISCHER_HAUSHALTSZAEHLER`, `STEUEREINRICHTUNG`, `TECHNISCHESTEUEREINRICHTUNG`, `TARIFSCHALTGERAET`, `RUNDSTEUEREMPFAENGER`, `OPTIONALE_ZUS_ZAEHLEINRICHTUNG`, `MESSWANDLERSATZ_IMS_MME`, `KOMBIMESSWANDLER_IMS_MME`, `TARIFSCHALTGERAET_IMS_MME`, `RUNDSTEUEREMPFAENGER_IMS_MME`, `TEMPERATUR_KOMPENSATION`, `HOECHSTBELASTUNGS_ANZEIGER`, `SONSTIGES_GERAET`, `SMARTMETERGATEWAY`, `STEUERBOX`, `BLOCKSTROMWANDLER`, `KOMBIMESSWANDLER`, `MODEM_GSM`, `ETHERNET_KOM`, `PLC_COM`, `MODEM_FESTNETZ`, `DSL_KOM`, `LTE_KOM`, `DICHTEMENGENUMWERTER`, `TEMPERATURMENGENUMWERTER`, `ZUSTANDSMENGENUMWERTER`, `MESSDATENREGISTRIERGERAET`, `WANDLER`, `BEFESTIGUNGSEINRICHTUNG`
`bezeichnung`	Designation of the device	string
`geraetenummer`	Reference to the device number of the meter / smart meter gateway / instrument transformer RFF Z14 smart meter gateway PI 55643 55648 55653 55658 55663 55669 55043 55168 55169 55074 55075 55076 CAV Z30 device number 55643 55648 55653 55658 55663 55669 55060 55043 55168 55169 55074 55075 55076 ORDERS RFF Z09 PI 17101 17126 17009	string
`geraetereferenz`	Device reference	string
`volumenerfassung`	Type of volume measurement CAV ZC0 PI 44116 44148 44149 44043 44168 44169 44060	string `HOCHFREQUENZSONDE`, `KENNLINIENKORREKTUR`, `SCHLEICHMENGENUNTERDRUECKUNG`
`weitereGeraetenummern`[ ]	further device numbers	string[]
geraeteeigenschaften	Specification of the properties of the device. E.g. transformer MV/LV.	object
`geraetetyp`	List of possible billable device types	string `WECHSELSTROMZAEHLER`, `DREHSTROMZAEHLER`, `ZWEIRICHTUNGSZAEHLER` `RLM_ZAEHLER`, `IMS_ZAEHLER`, `BALGENGASZAEHLER`, `MAXIMUMZAEHLER`, `MULTIPLEXANLAGE`, `PAUSCHALANLAGE`, `VERSTAERKERANLAGE`, `SUMMATIONSGERAET`, `IMPULSGEBER`, `EDL_21_ZAEHLERAUFSATZ`, `VIER_QUADRANTEN_LASTGANGZAEHLER`, `MENGENUMWERTER`, `STROMWANDLER`, `SPANNUNGSWANDLER`, `DATENLOGGER`, `KOMMUNIKATIONSANSCHLUSS`, `MODEM`, `TELEKOMMUNIKATIONSEINRICHTUNG`, `KOMMUNIKATIONSEINRICHTUNG`, `DREHKOLBENGASZAEHLER`, `TURBINENRADGASZAEHLER`, `ULTRASCHALLZAEHLER`, `WIRBELGASZAEHLER`, `MODERNE_MESSEINRICHTUNG`, `ELEKTRONISCHER_HAUSHALTSZAEHLER`, `STEUEREINRICHTUNG`, `TECHNISCHESTEUEREINRICHTUNG`, `TARIFSCHALTGERAET`, `RUNDSTEUEREMPFAENGER`, `OPTIONALE_ZUS_ZAEHLEINRICHTUNG`, `MESSWANDLERSATZ_IMS_MME`, `KOMBIMESSWANDLER_IMS_MME`, `TARIFSCHALTGERAET_IMS_MME`, `RUNDSTEUEREMPFAENGER_IMS_MME`, `TEMPERATUR_KOMPENSATION`, `HOECHSTBELASTUNGS_ANZEIGER`, `SONSTIGES_GERAET`, `SMARTMETERGATEWAY`, `STEUERBOX`, `BLOCKSTROMWANDLER`, `KOMBIMESSWANDLER`, `MODEM_GSM`, `ETHERNET_KOM`, `PLC_COM`, `MODEM_FESTNETZ`, `DSL_KOM`, `LTE_KOM`, `DICHTEMENGENUMWERTER`, `TEMPERATURMENGENUMWERTER`, `ZUSTANDSMENGENUMWERTER`, `MESSDATENREGISTRIERGERAET`, `WANDLER`, `BEFESTIGUNGSEINRICHTUNG`
`geraetemerkmal`	Metering device/meter size (gas) PI 15001	string `EINTARIF`, `ZWEITARIF`, `MEHRTARIF` `GAS_G2P5`, `GAS_G4`, `GAS_G6`, `GAS_G10`, `GAS_G16`, `GAS_G25`, `GAS_G40`, `GAS_G65`, `GAS_G100`, `GAS_G160`, `GAS_G250`, `GAS_G350`, `GAS_G400`, `GAS_G4000`, `GAS_G650`, `GAS_G6500`, `GAS_G1000`, `GAS_G10000`, `GAS_G12500`, `GAS_G1600`, `GAS_G16000`, `GAS_G2500`, `IMPULSGEBER_G4_G100`, `IMPULSGEBER_G100`, `MODEM_GSM`, `MODEM_GPRS`, `MODEM_FUNK`, `MODEM_GSM_O_LG`, `MODEM_GSM_M_LG`, `MODEM_FESTNETZ`, `MODEM_GPRS_M_LG`, `PLC_COM`, `ETHERNET_KOM`, `DSL_KOM`, `LTE_KOM`, `RUNDSTEUEREMPFAENGER`, `TARIFSCHALTGERAET`, `ZUSTANDS_MU`, `TEMPERATUR_MU`, `KOMPAKT_MU`, `SYSTEM_MU`, `UNBESTIMMT`, `WASSER_MWZW`, `WASSER_WZWW`, `WASSER_WZ01`, `WASSER_WZ02`, `WASSER_WZ03`, `WASSER_WZ04`, `WASSER_WZ05`, `WASSER_WZ06`, `WASSER_WZ07`, `WASSER_WZ08`, `WASSER_WZ09`, `WASSER_WZ10`, `WASSER_VWZ04`, `WASSER_VWZ05`, `WASSER_VWZ06`, `WASSER_VWZ07`, `WASSER_VWZ10`, `DICHTEMENGENUMWERTER`, `TEMPERATURMENGENUMWERTER`, `ZUSTANDSMENGENUMWERTER`, `BLOCKSTROMWANDLER`, `MESSWANDLERSATZ_IMS_MME`, `KOMBIMESSWANDLER`, `SPANNUNGSWANDLER`
`volumenerfassung`	Type of volume measurement	string `HOCHFREQUENZSONDE`, `KENNLINIENKORREKTUR`, `SCHLEICHMENGENUNTERDRUECKUNG`
`serialnummer`	serialnummer	string
`herstellungsdatum`	Production/manufacturing date	string
`baujahr`	Year of manufacture / year of placing on the market	string
`eichungBis`	Calibration validity	string
`faktor`	Transformer factor - specification of the transformer constant PI 55643 55648 55653 55658 55663 55669 55060 55043 55168 55169 55074 55075 55076 QUOTES PI 15001	number (float)
`firmwareVersion`	Firmware version	string
`herstellerTypbezeichnung`	Manufacturer type designation	string
`simKartenNummer`	SIM card number	string
`modemKennungIMSI`	Modem identifier (IMSI)	string
`tkProvider`	Telecommunications provider	string
`ipVersion`	IP version	string
zaehlwerke[ ]	The registers of the meter.	object[]
`zaehlwerkId`	Identification of the register within the meter. Often a sequential number after the meter number. E.g. 47110815_1	string
`bezeichnung`	Name of the register on the device; serves to identify and describe the local marking on the device (e.g. HT or NT) CCI Z63 PI 55643 55648 55653 55658 55663 55669 55553 55555 55168 55169	string
`richtung`	The energy direction, feed-in or feed-out. Details energy direction	string `AUSSP`, `EINSP`
`obisKennzahl`	Product identification when exchanging energy quantity data is ensured by OBIS codes. PIA 5 OBIS code of the grid location PI 55639 55644 55649 55654 55659 55664 55060 55043 55168 55169 PIA 5 OBIS code of the market location PI 55684 55685 55640 55645 55650 55655 55660 55665 55553 55555 55035 55095 55060 55043 55168 55169 55239 55074 55075 55076 55195 55196 RFF Z10 Reference to the OBIS code of the market location PI 55616 55622 PIA 5 OBIS data of the market location of the market role involved PI 55196 PIA 5 OBIS code of the tranche PI 55686 55687 55642 55647 55652 55657 55662 55667 55095 55074 55075 55076 55195 55196 PIA 5 OBIS code of the metering device /smart meter gateway PI 55643 55648 55653 55658 55663 55669 55553 55555 55035 55095 55060 55043 55168 55169 55074 55075 55076	string
`wandlerfaktor`	This factor is multiplied by a meter reading difference in order to arrive at the actual consumption in the period.	number (float)
`einheit`	The unit of the measured quantity, e.g. kWh. Details unit of measurement	string `W`, `WH`, `KW` `KWH`, `KVARH`, `MW`, `MWH`, `STUECK`, `KUBIKMETER`, `STUNDE`, `TAG`, `MONAT`, `JAHR`, `PROZENT`, `ANZAHL`, `VAR`, `KVAR`, `VARH`, `KWHK`, `Z16`, `KWT`, `WATT_PRO_QUADRATMETER`, `METER_PRO_SEKUNDE`
`schwachlastfaehig`	Off-peak capability; the description of the off-peak capability is used for the concession levy. CCI Z10 PI 55643 55648 55653 55658 55663 55669	string `SCHWACHLASTFAEHIG`, `NICHT_SCHWACHLASTFAEHIG`
`verbrauchsart`[ ]	Consumption type	string[] `KL`, `W`, `EMOB` `SB`, `SW`, `WK`
`unterbrechbarkeit`	Interruptibility of the market location, indication of whether an interruption of the consumption device by the grid operator is possible. CAV Z62 PI 55616 55622 55035	string `UV`, `NUV`
`waermenutzung`	Heat usage of the market location; in the case of heat usage, a more precise specification of the heat usage is defined. CAV Z56 PI 55616 55622 55617 55623 55629 55635 55035 55060 55043 55168 55169	string `SPEICHERHEIZUNG`, `WAERMEPUMPE`, `DIREKTHEIZUNG` `WAERMEPUMPE_WAERME_KAELTE`, `WAERMEPUMPE_KAELTE`, `WAERMEPUMPE_WAERME`
`steuerbefreit`	Tax-exempt	boolean
`vorkommastelle`	Number of digits before the decimal point of the register CAV Value PI 55643 55648 55653 55658 55663 55669 55553 55555 55043 55168 55169 55074 55075 55076	integer
`nachkommastelle`	Number of digits after the decimal point of the register CAV Value PI 55643 55648 55653 55658 55663 55669 55553 55555 55043 55168 55169 55074 55075 55076	integer
`abrechnungsrelevant`	Relevant for billing	boolean
`anzahlAblesungen`	Number of readings	integer
`konfiguration`	Configuration ID RFF AGK PI 55643 55648 55653 55658 55663 55669 55553 55555 55035 55095 55060 55043 55168 55169 55074 55075 55076	string
`messprodukt`	Required metering product Z11 of the Malo/ Tranche/ Melo PIA 5 PI 55043 55168 55169 Metering product of the tranche PI 55060 55043 55168 55169 Metering product of the metering location PI 55060 55043 55168 55169 Required product of the market location ORDERS PI 17123 17121 17134 Required product of the tranche ORDERS PI 17121 17134 Required product of the metering location ORDERS PI 17121 17118 17003 17134 17135 Required product of the grid location ORDERS PI 17121 17003	string
`wertegranularitaet`	The value granularity indicates the interval at which values of the OBIS code named in PIA+5 are provided in the market. ZD9 Annually ZE8 Semi-annually ZE9 Quarterly ZB7 Monthly CCI ZE4 PI 55640 55645 55650 55655 55660 55665 55643 55648 55653 55658 55663 55669 55553 55555 55035 55095 55060 55043 55168 55169 55074 55075 55076	string `JAEHRLICH`, `HALBJAEHRLICH`, `QUARTALSWEISE` `MONATLICH`
`notwendigkeitZweiteMessung`	Further description of the required metering product, necessity of a second measurement present or not present. The value serves the MSB for determination, plausibility checking or also substitute value formation at the Melo. CAV ZC9 PI 55060 55043 55168 55169 ORDERS PI 17121 17118	string `VORHANDEN`, `NICHT_VORHANDEN`
`werteuebermittlungVerwendungszweck`	Transmission of values to the NB due to a further purpose of use present or not present. This is required because not all calculation formulas for billing purposes can be exchanged yet. CCI Z88 PI 55060 55043 55168 55169 ORDERS PI 17121 17118	string `VORHANDEN`, `NICHT_VORHANDEN`
`artEMobilitaet`	Type of e-mobility; in the case of e-mobility, a more precise specification of the type is defined. CAV Z87 PI 55616 55622 55617 55623 55629 55635 55035 55060 55043 55168 55169	string `WB`, `LS`, `LP`
`konfigurationsprodukt`	Configuration product	string
`keinKonfigurationsprodukt`	No configuration product	boolean
`leistungskurvendefinition`	Power curve definition	string
`verwendungszweckNB`	Codes according to the code list of the purposes of use Purpose of use NB	string
`verwendungszweckLF`	Codes according to the code list of the purposes of use Purpose of use LF	string
`verwendungszweckUENB`	Codes according to the code list of the purposes of use Purpose of use ÜNB	string
`keinProdukt`	CCI+11++ZF6: no product assigned	boolean
konzessionsabgabe	Concession levy data CCI Z08 PI 44112 44139 44142 44001 44002 44013 44014 44035	object
`satz`	Groups of the KAV CAV KAS	string `KAS`, `SA`, `SAS` `TA`, `TAS`, `TK`, `TKS`, `TS`, `TSS`
`kosten`	Concession levy in euro/kWh	number (float)
`kategorie`	Fee category of the concession levy - transmission of additional information	string
zaehlzeiten	Assigned metering time period definition	object
`register`	Code of the metering time period register 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 of the metering time period definition 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 No metering time period required for the metering product PI 55060 55043 55168 55169 Z39 Code of the metering time period definition ORDERS Z41 No metering time period required for the metering product ORDERS CCI Z39 PI 17123 17121 17118 17134 17135 UTILTS RFF Z27 PI 25004	string
`schwachlastfaehig`	Off-peak capability; the description of the off-peak capability is used for the concession levy. CCI Z10 PI 55643 55648 55653 55658 55663 55669	string `SCHWACHLASTFAEHIG`, `NICHT_SCHWACHLASTFAEHIG`
verwendungszwecke[ ]	.	object[]
`marktrolle`	Identification of the market role CCI ZA8 PI 55639 55644 55659 55664 55043 55168 55169 55649 55654 55684 55685 55686 55687 55660 55665 55662 55667 ORDERS PI 17121 17134	string `NB`, `LF`, `MSB` `MSBA`, `GMSB`, `MDL`, `DL`, `BKV`, `UENB`, `KUNDE-SELBST-NN`, `MGV`, `EIV`, `RB`, `KUNDE`, `INTERESSENT`, `KN`, `UBA`, `BIKO`, `ESA`
`zweck`[ ]	Purpose of use value	string[] `NETZNUTZUNGSABRECHNUNG`, `BILANZKREISABRECHNUNG`, `MEHRMINDERMENGENABRECHNUNG` `ENDKUNDENABRECHNUNG`, `UEBERMITTLUNG_AN_DAS_HKNR`, `BLINDARBEITSABRECHNUNG`, `ERMITTLUNG_AUSGEGLICHENHEIT_BILANZKREIS`, `BLINDARBEITABRECHNUNG_BETRIEBSFUEHRUNG`, `ES_LIEGT_KEIN_VERWENDUNGSZWECK_VOR`
`datenqualitaet`	Introduces segment group SEQ Z03 Metering device data SEQ ZA3 Expected metering device data SEQ ZA4 Metering device data present in the system SEQ ZF5 Informational metering device data SEQ Z20 OBIS data of the metering device SEQ ZA5 Expected OBIS data of the metering device SEQ ZA6 OBIS data of the metering device present in the system SEQ ZF6 Informational OBIS data of the metering device SEQ Z04 Transformer data SEQ ZB9 Expected transformer data SEQ ZC0 Transformer data present in the system SEQ ZF7 Informational transformer data SEQ Z05 Communication device data SEQ ZB7 Expected communication device data SEQ ZB8 Communication device data present in the system SEQ ZF8 Informational communication device data SEQ Z06 Data of the technical control device SEQ ZC1 Expected data of the technical control device SEQ ZC2 Data of the technical control device present in the system SEQ ZF9 Informational data of the technical control device SEQ Z13 Smart meter gateway SEQ ZC3 Expected smart meter gateway SEQ ZC4 Smart meter gateway present in the system SEQ ZG0 Informational smart meter gateway SEQ Z14 Control box SEQ ZH3 Expected data of the control box SEQ ZH4 Data of the control box present in the system	string `ERWARTETE_DATEN`, `IM_SYSTEM_VORHANDENE_DATEN`, `INFORMATIVE_DATEN` `GUELTIGE_DATEN`, `KEINE_DATEN`, `IM_SYSTEM_KEINE_DATEN_VORHANDEN`, `KEINE_DATEN_ERWARTET`, `DIFFERENZ_DATEN`, `DIFFERENZ_ERWARTETE_DATEN`, `DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN`
gueltigkeitszeitraum	Reference to time period ID	object
`zeiteinheit`	not in use	string `SEKUNDE`, `MINUTE`, `STUNDE` `VIERTEL_STUNDE`, `TAG`, `WOCHE`, `MONAT`, `QUARTAL`, `HALBJAHR`, `JAHR`
`dauer`	Time span, value	integer
`startdatum`	Date from DTM Z25 Use of the data from DTM 163 Processing, start date/time DTM 155 Invoicing period, start date DTM Z42 Provisional billing period start	string (date-time)
`enddatum`	Date from DTM Z26 Use of the data until DTM164 Processing, end date/time DTM 156 Invoicing period, end date DTM Z43 Provisional billing period end	string (date-time)
`einheit`	not in use	string `SEKUNDE`, `MINUTE`, `STUNDE` `VIERTEL_STUNDE`, `TAG`, `WOCHE`, `MONAT`, `QUARTAL`, `HALBJAHR`, `JAHR`
`ableseZeitraum`	Periodic meter reading of the NB DTM 752 PI 44113 44140 44142 44043 44168 44169 44060	string
`abrechnungsZeitraum`	Date on which the grid usage settlement of the NB takes place DTM Z21 PI 44112 44139 44142 44002 44013 44014 44035	string
`zeitraumText`	Period text	string
`zeitraumId`	Reference to period ID RFF Z46 PI 25001	integer

Example Responses

[
  {
    "boTyp": "ZAEHLER",
    "versionStruktur": "1",
    "zaehlernummer": "12345",
    "messlokationsId": "DE0073395252733953513649640716001",
    "marktlokationsId": "<string>",
    "sparte": "GAS",
    "zaehlerauspraegung": "EINRICHTUNGSZAEHLER",
    "zaehlertyp": "DREHKOLBENZAEHLER",
    "tarifart": "EINTARIF",
    "zaehlerkonstante": 5.4,
    "eichungBis": "2032",
    "zaehlwerke": [
      {
        "zaehlwerkId": "<string>",
        "bezeichnung": "<string>",
        "richtung": "AUSSP",
        "obisKennzahl": "1-1:1.8.0",
        "vorkommastellen": 5,
        "nachkommastellen": 3,
        "wandlerfaktor": 6,
        "einheit": "KUBIKMETER",
        "schwachlastfaehig": "NICHT_SCHWACHLASTFAEHIG",
        "verwendungszwecke": [
          {
            "marktrolle": "NB",
            "zweck": [
              "NETZNUTZUNGSABRECHNUNG"
            ]
          }
        ],
        "verbrauchsart": [
          "KL"
        ],
        "unterbrechbarkeit": "NUV",
        "waermenutzung": "WAERMEPUMPE",
        "konzessionsabgabe": {
          "satz": "TA",
          "kosten": 126.47,
          "kategorie": "<string>"
        },
        "steuerbefreit": true,
        "vorkommastelle": 8,
        "nachkommastelle": 0,
        "abrechnungsrelevant": false,
        "anzahlAblesungen": 15,
        "zaehlzeiten": {
          "zaehlzeitDefinition": "<string>",
          "register": "<string>",
          "schwachlastfaehig": "NICHT_SCHWACHLASTFAEHIG"
        },
        "konfiguration": "34590456ujdfsdghdlktztwqq-053trg",
        "wertegranularitaet": "JAEHRLICH",
        "notwendigkeitZweiteMessung": "NICHT_VORHANDEN",
        "werteuebermittlungVerwendungszweck": "NICHT_VORHANDEN",
        "artEMobilitaet": "WB"
      }
    ],
    "zaehlerhersteller": {
      "boTyp": "GESCHAEFTSPARTNER",
      "versionStruktur": "1",
      "anrede": "Frau",
      "name1": "Musterfrau",
      "name2": "Erika",
      "name3": "",
      "name4": "",
      "gewerbekennzeichnung": true,
      "hrnummer": "<string>",
      "amtsgericht": "<string>",
      "kontaktweg": [
        "TELEFONAT"
      ],
      "umsatzsteuerId": "<string>",
      "glaeubigerId": "<string>",
      "eMailAdresse": "beispiel@example.org",
      "website": "<string>",
      "geschaeftspartnerrolle": [
        "MARKTPARTNER"
      ],
      "partneradresse": {
        "postleitzahl": "10117",
        "ort": "Musterstadt",
        "strasse": "Musterstraße",
        "hausnummer": "1",
        "postfach": "",
        "adresszusatz": "Beispieldaten",
        "coErgaenzung": "",
        "landescode": "DE",
        "ortsteil": ""
      }
    },
    "gateway": "<string>",
    "fernschaltung": "NICHT_VORHANDEN",
    "messwerterfassung": "MANUELL_AUSGELESENE",
    "zaehlertypspezifikation": "SONSTIGER_EHZ",
    "befestigungsart": "DREIPUNKT",
    "zaehlergroesse": "GAS_G4",
    "geraete": [
      {
        "geraetenummer": "<string>",
        "weitereGeraetenummern": [
          "<string>",
          "<string>"
        ],
        "geraeteeigenschaften": {
          "geraetetyp": "BALGENGASZAEHLER",
          "geraetemerkmal": "GAS_G10",
          "faktor": 1,
          "volumenerfassung": "HOCHFREQUENZSONDE",
          "eichungBis": "2032",
          "herstellungsdatum": "2019",
          "baujahr": "<string>",
          "serialnummer": "<string>"
        }
      }
    ],
    "mengenumwertertyp": "DICHTEMENGENUMWERTER",
    "volumenerfassung": "SCHLEICHMENGENUNTERDRUECKUNG",
    "serialnummer": "<string>",
    "geraetemerkmal": "GAS_G10",
    "herstellungsdatum": "2019",
    "baujahr": "<string>"
  }
]

json

application/json

Read controllable resource Read counting time definition

Read meter

GET

https://mock.macoapp.de

/getCounterBasic

query Parameters

Structure (BO4E)	Description	Format
`parameter1`*	Location ID \| Location ID · Example: 74018657187 · Default: 74018657187	string
`parameter2`*	Location type \| Location type · Example: MALO · Default: MALO	string `MALO`, `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 meter › Responses

Successful reading of the meter | Successful reading of the meter

Array of: Meter — 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	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
`zaehlernummer`	Number of the device CAV Z30 PI 55600 55601 55643 55648 55653 55658 55663 55669 55553 55555 55035 55095 55060 55194 55039 55040 55042 55043 55168 55169 55074 55075 55076 RFF MG Device number of the meter PI 55643 55648 55653 55658 55663 55669 55060 55043 55168 55169 55074 55075 55076 QUOTES RFF Z09 Device number PI 15001 MSCONS RFF MG PI 13017 13002	string
`sparte`	Electricity or gas	string `STROM`, `GAS`, `FERNWAERME` `NAHWAERME`, `WASSER`, `ABWASSER`
`zaehlerauspraegung`	Energy direction CAV ERZ PI 55643 55648 55653 55658 55663 55669 55043 55168 55169 55074 55075 55076 QUOTES PI 15001	string `EINRICHTUNGSZAEHLER`, `ZWEIRICHTUNGSZAEHLER`
`zaehlertyp`	Value specification of the meter - metering device CAV AHZ PI 55643 55648 55653 55658 55663 55669 55035 55095 55060 55043 55168 55169 55074 55075 55076 QUOTES PI 15001 UTILMD gas	string `DREHSTROMZAEHLER`, `BALGENGASZAEHLER`, `DREHKOLBENZAEHLER` `SMARTMETER`, `LEISTUNGSZAEHLER`, `MAXIMUMZAEHLER`, `TURBINENRADGASZAEHLER`, `ULTRASCHALLGASZAEHLER`, `WECHSELSTROMZAEHLER`, `WIRBELGASZAEHLER`, `MESSDATENREGISTRIERGERAET`, `ELEKTRONISCHERHAUSHALTSZAEHLER`, `SONDERAUSSTATTUNG`, `WASSERZAEHLER`, `MODERNEMESSEINRICHTUNG`
`tarifart`	Number of tariffs, number of registers - The information of the device actually installed is specified. CAV ETZ PI 55643 55648 55653 55658 55663 55669 55043 55168 55169 55074 55075 55076 QUOTES PI 15001	string `EINTARIF`, `ZWEITARIF`, `MEHRTARIF` `SMART_METER`, `LEISTUNGSGEMESSEN`
`zaehlerkonstante`	Meter constant on the meter.	number (float)
`eichungBis`	Calibration validity - the meter is calibrated up to this date. DTM Z04 PI 15001	string
zaehlerhersteller	The manufacturer of the meter. Details Business partner	object
`boTyp`*	Type of the 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
`anrede`	The form of address for the GePa, e.g. Herr. Z04 Correspondence address of the customer of the supplier PI 55001 55600 55601 55013 55014 55043 55168 55169	string
`name1`	First part of the name. This can hold the company name or, for private individuals, the surname, for example. Examples: Yellow Strom GmbH or Hagen	string
`name2`	Second part of the name. Here an extension to the company name or, for private individuals, the first name for example can be entered. Examples: Bereich Süd or Nina	string
`name3`	Third part of the name. Here further additions to the company name or, for private individuals, additions to the name can be shown. Examples: and Africa or singer	string
`name4`	Name 4	string
`umsatzsteuerId`	The VAT ID of the business partner. Example: DE 813281825	string
`glaeubigerId`	The creditor ID used in payment transactions- e.g. DE 47116789	string
`emailAdresse`	email address	string
`website`	Website of the market partner. Example: www.mp-energie.de	string
`gewerbekennzeichnung`	Indicates whether this is a commercial business/company (gewerbeKennzeichnung = true) or a private individual. (gewerbeKennzeichnung = false) Z01 Structure of personal names Z02 Structure of the company name	boolean
`hrnummer`	Commercial register number of the business partner	string
`amtsgericht`	Local court or commercial register court that issued the commercial register number	string
`externeKundenummerLieferant`	externeKundenummerLieferant	string
`geschaeftspartnerrolle`[ ]	Geschaeftspartnerrolle	string[] `KUNDE`, `LIEFERANT`, `DIENSTLEISTER` `INTERESSENT`, `MARKTPARTNER`, `EIGENTUEMER`, `HAUSVERWALTER`, `KORRESPONDENZEMPFAENGER`, `ABLESEKARTENEMPFAENGER`
`kontaktweg`[ ]	Indicates the way in which the person or the business partner can be contacted	string[] `ANSCHREIBEN`, `TELEFONAT`, `FAX` `E_MAIL`, `SMS`
partneradresse	Address of the business partner at which the head office is located.	object
`postleitzahl`	Postal code	string
`ort`	City	string
`strasse`	Street	string
`hausnummer`	House number and supplement	string
`postfach`	PO box	string
`adresszusatz`	Address supplement	string
`coErgaenzung`	coErgaenzung	string
`landescode`	Country code	string `AC`, `AD`, `AE` `AF`, `AG`, `AI`, `AL`, `AM`, `AN`, `AO`, `AQ`, `AR`, `AS`, `AT`, `AU`, `AW`, `AX`, `AZ`, `BA`, `BB`, `BD`, `BE`, `BF`, `BG`, `BH`, `BI`, `BJ`, `BL`, `BM`, `BN`, `BO`, `BQ`, `BR`, `BS`, `BT`, `BU`, `BV`, `BW`, `BY`, `BZ`, `CA`, `CC`, `CD`, `CF`, `CG`, `CH`, `CI`, `CK`, `CL`, `CM`, `CN`, `CO`, `CP`, `CR`, `CS`, `CU`, `CV`, `CW`, `CX`, `CY`, `CZ`, `DE`, `DG`, `DJ`, `DK`, `DM`, `DO`, `DZ`, `EA`, `EC`, `EE`, `EG`, `EH`, `ER`, `ES`, `ET`, `EU`, `FI`, `FJ`, `FK`, `FM`, `FO`, `FR`, `FX`, `GA`, `GB`, `GD`, `GE`, `GF`, `GG`, `GH`, `GI`, `GL`, `GM`, `GN`, `GP`, `GQ`, `GR`, `GS`, `GT`, `GU`, `GW`, `GY`, `HK`, `HM`, `HN`, `HR`, `HT`, `HU`, `IC`, `ID`, `IE`, `IL`, `IM`, `IN`, `IO`, `IQ`, `IR`, `IS`, `IT`, `JE`, `JM`, `JO`, `JP`, `KE`, `KG`, `KH`, `KI`, `KM`, `KN`, `KP`, `KR`, `KW`, `KY`, `KZ`, `LA`, `LB`, `LC`, `LI`, `LK`, `LR`, `LS`, `LT`, `LU`, `LV`, `LY`, `MA`, `MC`, `MD`, `ME`, `MF`, `MG`, `MH`, `MK`, `ML`, `MM`, `MN`, `MO`, `MP`, `MQ`, `MR`, `MS`, `MT`, `MU`, `MV`, `MW`, `MX`, `MY`, `MZ`, `NA`, `NC`, `NE`, `NF`, `NG`, `NI`, `NL`, `NO`, `NP`, `NR`, `NT`, `NU`, `NZ`, `OM`, `PA`, `PE`, `PF`, `PG`, `PH`, `PK`, `PL`, `PM`, `PN`, `PR`, `PS`, `PT`, `PW`, `PY`, `QA`, `RE`, `RO`, `RS`, `RU`, `RW`, `SA`, `SB`, `SC`, `SD`, `SE`, `SF`, `SG`, `SH`, `SI`, `SJ`, `SK`, `SL`, `SM`, `SN`, `SO`, `SR`, `SS`, `ST`, `SU`, `SV`, `SX`, `SY`, `SZ`, `TA`, `TC`, `TD`, `TF`, `TG`, `TJ`, `TK`, `TL`, `TM`, `TN`, `TO`, `TP`, `TR`, `TT`, `TV`, `TW`, `TZ`, `UA`, `UG`, `UK`, `UM`, `US`, `UY`, `UZ`, `VA`, `VC`, `VE`, `VG`, `VI`, `VN`, `VU`, `WF`, `WS`, `XK`, `YE`, `YT`, `YU`, `ZA`, `ZM`, `ZR`, `ZW`
`ortsteil`	District	string
zusatzInformation	Additional information for identification, line for name and address	object
`zusatz1`	Address supplement 1	string
`zusatz2`	Address supplement 2	string
`zusatz3`	Address supplement 3	string
`zusatz4`	Address supplement 4	string
`zusatz5`	Address supplement 5	string
externeReferenzen[ ]	IDs of other systems can be stored here (e.g. a SAP business partner number) (for details see external reference)	object[]
`exRefName`	Name of the external reference, customer number at the supplier, refers to the preceding NAD segment RFF AVC PI 55109 55137 RFF AVC customer number at the supplier ORDERS PI 17101	string `Kundennummer beim Lieferanten`, `Kundennummer beim Altlieferanten`
`exRefWert`	Customer number at the previous supplier - specification of references for responses and requests PI 55109 55137 ORDERS PI 17101	string
ansprechpartner	Contact person as in EDIFACT CTA+IC' COM+?+3222271020:TE', that includes e.g. the phone number of customer.	object
`boTyp`*	Type of the 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
`nachname`	Surname (family name) of the contact person	string
`eMailAdresse`	Email address	string
rufnummern[ ]	List of the telephone numbers on which the contact person can be reached.	object[]
`nummerntyp`	Type of means of communication COM	string `RUF_ZENTRALE`, `FAX_ZENTRALE`, `SAMMELRUF` `SAMMELFAX`, `ABTEILUNGRUF`, `ABTEILUNGFAX`, `RUF_DURCHWAHL`, `FAX_DURCHWAHL`, `MOBIL_NUMMER`
`rufnummer`	Phone number	string
`gateway`	Assignment of the metering device to the smart meter gateway via which the communication takes place. RFF Z14 PI 55643 55648 55653 55658 55663 55669 55553 55555 55035 55095 55060 55043 55168 55169 55074 55075 55076	string
`fernschaltung`	Remote switching of the metering device, provides the information whether the remote switching function is available. The remote switching offers the possibility of interrupting the energy flow through the metering device or of lifting the interruption. CAV Z58 PI 55643 55648 55653 55658 55663 55669 55043 55168 55169 55074 55075 55076	string `VORHANDEN`, `NICHT_VORHANDEN`
`messwerterfassung`	Technical capability - meter reading capture at the metering device CAV AMR PI 55643 55648 55663 55669 55035 55095 55060 55043 55168 55169 QUOTES PI 15001	string `FERNAUSLESBAR`, `MANUELL_AUSGELESENE`
`zaehlertypspezifikation`	Meter type PI 55643 55648 55653 55658 55663 55669 55035 55095 55060 55043 55168 55169 QUOTES PI 15001	string `EDL40`, `EDL21`, `SONSTIGER_EHZ` `MME_STANDARD`, `MME_MEDA`
`befestigungsart`	Mounting type of the metering device CAV BKE PI 55643 55648 55663 55669 55043 55168 55169 QUOTES PI 15001	string `STECKTECHNIK`, `DREIPUNKT`, `HUTSCHIENE` `EINSTUTZEN`, `ZWEISTUTZEN`
`zaehlergroesse`	Metering device/meter size (gas) PI 15001	string `EINTARIF`, `ZWEITARIF`, `MEHRTARIF` `GAS_G2P5`, `GAS_G4`, `GAS_G6`, `GAS_G10`, `GAS_G16`, `GAS_G25`, `GAS_G40`, `GAS_G65`, `GAS_G100`, `GAS_G160`, `GAS_G250`, `GAS_G350`, `GAS_G400`, `GAS_G4000`, `GAS_G650`, `GAS_G6500`, `GAS_G1000`, `GAS_G10000`, `GAS_G12500`, `GAS_G1600`, `GAS_G16000`, `GAS_G2500`, `IMPULSGEBER_G4_G100`, `IMPULSGEBER_G100`, `MODEM_GSM`, `MODEM_GPRS`, `MODEM_FUNK`, `MODEM_GSM_O_LG`, `MODEM_GSM_M_LG`, `MODEM_FESTNETZ`, `MODEM_GPRS_M_LG`, `PLC_COM`, `ETHERNET_KOM`, `DSL_KOM`, `LTE_KOM`, `RUNDSTEUEREMPFAENGER`, `TARIFSCHALTGERAET`, `ZUSTANDS_MU`, `TEMPERATUR_MU`, `KOMPAKT_MU`, `SYSTEM_MU`, `UNBESTIMMT`, `WASSER_MWZW`, `WASSER_WZWW`, `WASSER_WZ01`, `WASSER_WZ02`, `WASSER_WZ03`, `WASSER_WZ04`, `WASSER_WZ05`, `WASSER_WZ06`, `WASSER_WZ07`, `WASSER_WZ08`, `WASSER_WZ09`, `WASSER_WZ10`, `WASSER_VWZ04`, `WASSER_VWZ05`, `WASSER_VWZ06`, `WASSER_VWZ07`, `WASSER_VWZ10`, `DICHTEMENGENUMWERTER`, `TEMPERATURMENGENUMWERTER`, `ZUSTANDSMENGENUMWERTER`, `BLOCKSTROMWANDLER`, `MESSWANDLERSATZ_IMS_MME`, `KOMBIMESSWANDLER`, `SPANNUNGSWANDLER`
`mengenumwertertyp`	not in use	string `DICHTEMENGENUMWERTER`, `TEMPERATURMENGENUMWERTER`, `ZUSTANDSMENGENUMWERTER`
`volumenerfassung`	Type of volume measurement CAV ZC0 PI 44116 44148 44149 44043 44168 44169 44060	string `HOCHFREQUENZSONDE`, `KENNLINIENKORREKTUR`, `SCHLEICHMENGENUNTERDRUECKUNG`
`serialnummer`	Manufacturer number - serial number GIN BN PI 15001	string
`geraetemerkmal`	Metering device/meter size (gas) PI 15001	string `EINTARIF`, `ZWEITARIF`, `MEHRTARIF` `GAS_G2P5`, `GAS_G4`, `GAS_G6`, `GAS_G10`, `GAS_G16`, `GAS_G25`, `GAS_G40`, `GAS_G65`, `GAS_G100`, `GAS_G160`, `GAS_G250`, `GAS_G350`, `GAS_G400`, `GAS_G4000`, `GAS_G650`, `GAS_G6500`, `GAS_G1000`, `GAS_G10000`, `GAS_G12500`, `GAS_G1600`, `GAS_G16000`, `GAS_G2500`, `IMPULSGEBER_G4_G100`, `IMPULSGEBER_G100`, `MODEM_GSM`, `MODEM_GPRS`, `MODEM_FUNK`, `MODEM_GSM_O_LG`, `MODEM_GSM_M_LG`, `MODEM_FESTNETZ`, `MODEM_GPRS_M_LG`, `PLC_COM`, `ETHERNET_KOM`, `DSL_KOM`, `LTE_KOM`, `RUNDSTEUEREMPFAENGER`, `TARIFSCHALTGERAET`, `ZUSTANDS_MU`, `TEMPERATUR_MU`, `KOMPAKT_MU`, `SYSTEM_MU`, `UNBESTIMMT`, `WASSER_MWZW`, `WASSER_WZWW`, `WASSER_WZ01`, `WASSER_WZ02`, `WASSER_WZ03`, `WASSER_WZ04`, `WASSER_WZ05`, `WASSER_WZ06`, `WASSER_WZ07`, `WASSER_WZ08`, `WASSER_WZ09`, `WASSER_WZ10`, `WASSER_VWZ04`, `WASSER_VWZ05`, `WASSER_VWZ06`, `WASSER_VWZ07`, `WASSER_VWZ10`, `DICHTEMENGENUMWERTER`, `TEMPERATURMENGENUMWERTER`, `ZUSTANDSMENGENUMWERTER`, `BLOCKSTROMWANDLER`, `MESSWANDLERSATZ_IMS_MME`, `KOMBIMESSWANDLER`, `SPANNUNGSWANDLER`
`herstellungsdatum`	Production/manufacturing date DTM 94 PI 15001	string
`baujahr`	Year of construction / year of placing on the market DTM Z03 PI 15001	string
`messlokationsId`	Reference to an ID of a metering location to which the metering device is assigned. RFF Z19 PI 55035 55095 55060 55040 55043 55168 55169 55074 55075 55076	string
`marktlokationsId`	Reference to the ID of a market location per meter of a Melo. RFF Z18 PI 55043 55168 55169 55074 55075 55076	string
geraete[ ]	List of the devices belonging to this meter.	object[]
`geraetetyp`	List of possible billable device types	string `WECHSELSTROMZAEHLER`, `DREHSTROMZAEHLER`, `ZWEIRICHTUNGSZAEHLER` `RLM_ZAEHLER`, `IMS_ZAEHLER`, `BALGENGASZAEHLER`, `MAXIMUMZAEHLER`, `MULTIPLEXANLAGE`, `PAUSCHALANLAGE`, `VERSTAERKERANLAGE`, `SUMMATIONSGERAET`, `IMPULSGEBER`, `EDL_21_ZAEHLERAUFSATZ`, `VIER_QUADRANTEN_LASTGANGZAEHLER`, `MENGENUMWERTER`, `STROMWANDLER`, `SPANNUNGSWANDLER`, `DATENLOGGER`, `KOMMUNIKATIONSANSCHLUSS`, `MODEM`, `TELEKOMMUNIKATIONSEINRICHTUNG`, `KOMMUNIKATIONSEINRICHTUNG`, `DREHKOLBENGASZAEHLER`, `TURBINENRADGASZAEHLER`, `ULTRASCHALLZAEHLER`, `WIRBELGASZAEHLER`, `MODERNE_MESSEINRICHTUNG`, `ELEKTRONISCHER_HAUSHALTSZAEHLER`, `STEUEREINRICHTUNG`, `TECHNISCHESTEUEREINRICHTUNG`, `TARIFSCHALTGERAET`, `RUNDSTEUEREMPFAENGER`, `OPTIONALE_ZUS_ZAEHLEINRICHTUNG`, `MESSWANDLERSATZ_IMS_MME`, `KOMBIMESSWANDLER_IMS_MME`, `TARIFSCHALTGERAET_IMS_MME`, `RUNDSTEUEREMPFAENGER_IMS_MME`, `TEMPERATUR_KOMPENSATION`, `HOECHSTBELASTUNGS_ANZEIGER`, `SONSTIGES_GERAET`, `SMARTMETERGATEWAY`, `STEUERBOX`, `BLOCKSTROMWANDLER`, `KOMBIMESSWANDLER`, `MODEM_GSM`, `ETHERNET_KOM`, `PLC_COM`, `MODEM_FESTNETZ`, `DSL_KOM`, `LTE_KOM`, `DICHTEMENGENUMWERTER`, `TEMPERATURMENGENUMWERTER`, `ZUSTANDSMENGENUMWERTER`, `MESSDATENREGISTRIERGERAET`, `WANDLER`, `BEFESTIGUNGSEINRICHTUNG`
`bezeichnung`	Designation of the device	string
`geraetenummer`	Reference to the device number of the meter / smart meter gateway / instrument transformer RFF Z14 smart meter gateway PI 55643 55648 55653 55658 55663 55669 55043 55168 55169 55074 55075 55076 CAV Z30 device number 55643 55648 55653 55658 55663 55669 55060 55043 55168 55169 55074 55075 55076 ORDERS RFF Z09 PI 17101 17126 17009	string
`geraetereferenz`	Device reference	string
`volumenerfassung`	Type of volume measurement CAV ZC0 PI 44116 44148 44149 44043 44168 44169 44060	string `HOCHFREQUENZSONDE`, `KENNLINIENKORREKTUR`, `SCHLEICHMENGENUNTERDRUECKUNG`
`weitereGeraetenummern`[ ]	further device numbers	string[]
geraeteeigenschaften	Specification of the properties of the device. E.g. transformer MV/LV.	object
`geraetetyp`	List of possible billable device types	string `WECHSELSTROMZAEHLER`, `DREHSTROMZAEHLER`, `ZWEIRICHTUNGSZAEHLER` `RLM_ZAEHLER`, `IMS_ZAEHLER`, `BALGENGASZAEHLER`, `MAXIMUMZAEHLER`, `MULTIPLEXANLAGE`, `PAUSCHALANLAGE`, `VERSTAERKERANLAGE`, `SUMMATIONSGERAET`, `IMPULSGEBER`, `EDL_21_ZAEHLERAUFSATZ`, `VIER_QUADRANTEN_LASTGANGZAEHLER`, `MENGENUMWERTER`, `STROMWANDLER`, `SPANNUNGSWANDLER`, `DATENLOGGER`, `KOMMUNIKATIONSANSCHLUSS`, `MODEM`, `TELEKOMMUNIKATIONSEINRICHTUNG`, `KOMMUNIKATIONSEINRICHTUNG`, `DREHKOLBENGASZAEHLER`, `TURBINENRADGASZAEHLER`, `ULTRASCHALLZAEHLER`, `WIRBELGASZAEHLER`, `MODERNE_MESSEINRICHTUNG`, `ELEKTRONISCHER_HAUSHALTSZAEHLER`, `STEUEREINRICHTUNG`, `TECHNISCHESTEUEREINRICHTUNG`, `TARIFSCHALTGERAET`, `RUNDSTEUEREMPFAENGER`, `OPTIONALE_ZUS_ZAEHLEINRICHTUNG`, `MESSWANDLERSATZ_IMS_MME`, `KOMBIMESSWANDLER_IMS_MME`, `TARIFSCHALTGERAET_IMS_MME`, `RUNDSTEUEREMPFAENGER_IMS_MME`, `TEMPERATUR_KOMPENSATION`, `HOECHSTBELASTUNGS_ANZEIGER`, `SONSTIGES_GERAET`, `SMARTMETERGATEWAY`, `STEUERBOX`, `BLOCKSTROMWANDLER`, `KOMBIMESSWANDLER`, `MODEM_GSM`, `ETHERNET_KOM`, `PLC_COM`, `MODEM_FESTNETZ`, `DSL_KOM`, `LTE_KOM`, `DICHTEMENGENUMWERTER`, `TEMPERATURMENGENUMWERTER`, `ZUSTANDSMENGENUMWERTER`, `MESSDATENREGISTRIERGERAET`, `WANDLER`, `BEFESTIGUNGSEINRICHTUNG`
`geraetemerkmal`	Metering device/meter size (gas) PI 15001	string `EINTARIF`, `ZWEITARIF`, `MEHRTARIF` `GAS_G2P5`, `GAS_G4`, `GAS_G6`, `GAS_G10`, `GAS_G16`, `GAS_G25`, `GAS_G40`, `GAS_G65`, `GAS_G100`, `GAS_G160`, `GAS_G250`, `GAS_G350`, `GAS_G400`, `GAS_G4000`, `GAS_G650`, `GAS_G6500`, `GAS_G1000`, `GAS_G10000`, `GAS_G12500`, `GAS_G1600`, `GAS_G16000`, `GAS_G2500`, `IMPULSGEBER_G4_G100`, `IMPULSGEBER_G100`, `MODEM_GSM`, `MODEM_GPRS`, `MODEM_FUNK`, `MODEM_GSM_O_LG`, `MODEM_GSM_M_LG`, `MODEM_FESTNETZ`, `MODEM_GPRS_M_LG`, `PLC_COM`, `ETHERNET_KOM`, `DSL_KOM`, `LTE_KOM`, `RUNDSTEUEREMPFAENGER`, `TARIFSCHALTGERAET`, `ZUSTANDS_MU`, `TEMPERATUR_MU`, `KOMPAKT_MU`, `SYSTEM_MU`, `UNBESTIMMT`, `WASSER_MWZW`, `WASSER_WZWW`, `WASSER_WZ01`, `WASSER_WZ02`, `WASSER_WZ03`, `WASSER_WZ04`, `WASSER_WZ05`, `WASSER_WZ06`, `WASSER_WZ07`, `WASSER_WZ08`, `WASSER_WZ09`, `WASSER_WZ10`, `WASSER_VWZ04`, `WASSER_VWZ05`, `WASSER_VWZ06`, `WASSER_VWZ07`, `WASSER_VWZ10`, `DICHTEMENGENUMWERTER`, `TEMPERATURMENGENUMWERTER`, `ZUSTANDSMENGENUMWERTER`, `BLOCKSTROMWANDLER`, `MESSWANDLERSATZ_IMS_MME`, `KOMBIMESSWANDLER`, `SPANNUNGSWANDLER`
`volumenerfassung`	Type of volume measurement	string `HOCHFREQUENZSONDE`, `KENNLINIENKORREKTUR`, `SCHLEICHMENGENUNTERDRUECKUNG`
`serialnummer`	serialnummer	string
`herstellungsdatum`	Production/manufacturing date	string
`baujahr`	Year of manufacture / year of placing on the market	string
`eichungBis`	Calibration validity	string
`faktor`	Transformer factor - specification of the transformer constant PI 55643 55648 55653 55658 55663 55669 55060 55043 55168 55169 55074 55075 55076 QUOTES PI 15001	number (float)
`firmwareVersion`	Firmware version	string
`herstellerTypbezeichnung`	Manufacturer type designation	string
`simKartenNummer`	SIM card number	string
`modemKennungIMSI`	Modem identifier (IMSI)	string
`tkProvider`	Telecommunications provider	string
`ipVersion`	IP version	string
zaehlwerke[ ]	The registers of the meter.	object[]
`zaehlwerkId`	Identification of the register within the meter. Often a sequential number after the meter number. E.g. 47110815_1	string
`bezeichnung`	Name of the register on the device; serves to identify and describe the local marking on the device (e.g. HT or NT) CCI Z63 PI 55643 55648 55653 55658 55663 55669 55553 55555 55168 55169	string
`richtung`	The energy direction, feed-in or feed-out. Details energy direction	string `AUSSP`, `EINSP`
`obisKennzahl`	Product identification when exchanging energy quantity data is ensured by OBIS codes. PIA 5 OBIS code of the grid location PI 55639 55644 55649 55654 55659 55664 55060 55043 55168 55169 PIA 5 OBIS code of the market location PI 55684 55685 55640 55645 55650 55655 55660 55665 55553 55555 55035 55095 55060 55043 55168 55169 55239 55074 55075 55076 55195 55196 RFF Z10 Reference to the OBIS code of the market location PI 55616 55622 PIA 5 OBIS data of the market location of the market role involved PI 55196 PIA 5 OBIS code of the tranche PI 55686 55687 55642 55647 55652 55657 55662 55667 55095 55074 55075 55076 55195 55196 PIA 5 OBIS code of the metering device /smart meter gateway PI 55643 55648 55653 55658 55663 55669 55553 55555 55035 55095 55060 55043 55168 55169 55074 55075 55076	string
`wandlerfaktor`	This factor is multiplied by a meter reading difference in order to arrive at the actual consumption in the period.	number (float)
`einheit`	The unit of the measured quantity, e.g. kWh. Details unit of measurement	string `W`, `WH`, `KW` `KWH`, `KVARH`, `MW`, `MWH`, `STUECK`, `KUBIKMETER`, `STUNDE`, `TAG`, `MONAT`, `JAHR`, `PROZENT`, `ANZAHL`, `VAR`, `KVAR`, `VARH`, `KWHK`, `Z16`, `KWT`, `WATT_PRO_QUADRATMETER`, `METER_PRO_SEKUNDE`
`schwachlastfaehig`	Off-peak capability; the description of the off-peak capability is used for the concession levy. CCI Z10 PI 55643 55648 55653 55658 55663 55669	string `SCHWACHLASTFAEHIG`, `NICHT_SCHWACHLASTFAEHIG`
`verbrauchsart`[ ]	Consumption type	string[] `KL`, `W`, `EMOB` `SB`, `SW`, `WK`
`unterbrechbarkeit`	Interruptibility of the market location, indication of whether an interruption of the consumption device by the grid operator is possible. CAV Z62 PI 55616 55622 55035	string `UV`, `NUV`
`waermenutzung`	Heat usage of the market location; in the case of heat usage, a more precise specification of the heat usage is defined. CAV Z56 PI 55616 55622 55617 55623 55629 55635 55035 55060 55043 55168 55169	string `SPEICHERHEIZUNG`, `WAERMEPUMPE`, `DIREKTHEIZUNG` `WAERMEPUMPE_WAERME_KAELTE`, `WAERMEPUMPE_KAELTE`, `WAERMEPUMPE_WAERME`
`steuerbefreit`	Tax-exempt	boolean
`vorkommastelle`	Number of digits before the decimal point of the register CAV Value PI 55643 55648 55653 55658 55663 55669 55553 55555 55043 55168 55169 55074 55075 55076	integer
`nachkommastelle`	Number of digits after the decimal point of the register CAV Value PI 55643 55648 55653 55658 55663 55669 55553 55555 55043 55168 55169 55074 55075 55076	integer
`abrechnungsrelevant`	Relevant for billing	boolean
`anzahlAblesungen`	Number of readings	integer
`konfiguration`	Configuration ID RFF AGK PI 55643 55648 55653 55658 55663 55669 55553 55555 55035 55095 55060 55043 55168 55169 55074 55075 55076	string
`messprodukt`	Required metering product Z11 of the Malo/ Tranche/ Melo PIA 5 PI 55043 55168 55169 Metering product of the tranche PI 55060 55043 55168 55169 Metering product of the metering location PI 55060 55043 55168 55169 Required product of the market location ORDERS PI 17123 17121 17134 Required product of the tranche ORDERS PI 17121 17134 Required product of the metering location ORDERS PI 17121 17118 17003 17134 17135 Required product of the grid location ORDERS PI 17121 17003	string
`wertegranularitaet`	The value granularity indicates the interval at which values of the OBIS code named in PIA+5 are provided in the market. ZD9 Annually ZE8 Semi-annually ZE9 Quarterly ZB7 Monthly CCI ZE4 PI 55640 55645 55650 55655 55660 55665 55643 55648 55653 55658 55663 55669 55553 55555 55035 55095 55060 55043 55168 55169 55074 55075 55076	string `JAEHRLICH`, `HALBJAEHRLICH`, `QUARTALSWEISE` `MONATLICH`
`notwendigkeitZweiteMessung`	Further description of the required metering product, necessity of a second measurement present or not present. The value serves the MSB for determination, plausibility checking or also substitute value formation at the Melo. CAV ZC9 PI 55060 55043 55168 55169 ORDERS PI 17121 17118	string `VORHANDEN`, `NICHT_VORHANDEN`
`werteuebermittlungVerwendungszweck`	Transmission of values to the NB due to a further purpose of use present or not present. This is required because not all calculation formulas for billing purposes can be exchanged yet. CCI Z88 PI 55060 55043 55168 55169 ORDERS PI 17121 17118	string `VORHANDEN`, `NICHT_VORHANDEN`
`artEMobilitaet`	Type of e-mobility; in the case of e-mobility, a more precise specification of the type is defined. CAV Z87 PI 55616 55622 55617 55623 55629 55635 55035 55060 55043 55168 55169	string `WB`, `LS`, `LP`
`konfigurationsprodukt`	Configuration product	string
`keinKonfigurationsprodukt`	No configuration product	boolean
`leistungskurvendefinition`	Power curve definition	string
`verwendungszweckNB`	Codes according to the code list of the purposes of use Purpose of use NB	string
`verwendungszweckLF`	Codes according to the code list of the purposes of use Purpose of use LF	string
`verwendungszweckUENB`	Codes according to the code list of the purposes of use Purpose of use ÜNB	string
`keinProdukt`	CCI+11++ZF6: no product assigned	boolean
konzessionsabgabe	Concession levy data CCI Z08 PI 44112 44139 44142 44001 44002 44013 44014 44035	object
`satz`	Groups of the KAV CAV KAS	string `KAS`, `SA`, `SAS` `TA`, `TAS`, `TK`, `TKS`, `TS`, `TSS`
`kosten`	Concession levy in euro/kWh	number (float)
`kategorie`	Fee category of the concession levy - transmission of additional information	string
zaehlzeiten	Assigned metering time period definition	object
`register`	Code of the metering time period register 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 of the metering time period definition 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 No metering time period required for the metering product PI 55060 55043 55168 55169 Z39 Code of the metering time period definition ORDERS Z41 No metering time period required for the metering product ORDERS CCI Z39 PI 17123 17121 17118 17134 17135 UTILTS RFF Z27 PI 25004	string
`schwachlastfaehig`	Off-peak capability; the description of the off-peak capability is used for the concession levy. CCI Z10 PI 55643 55648 55653 55658 55663 55669	string `SCHWACHLASTFAEHIG`, `NICHT_SCHWACHLASTFAEHIG`
verwendungszwecke[ ]	.	object[]
`marktrolle`	Identification of the market role CCI ZA8 PI 55639 55644 55659 55664 55043 55168 55169 55649 55654 55684 55685 55686 55687 55660 55665 55662 55667 ORDERS PI 17121 17134	string `NB`, `LF`, `MSB` `MSBA`, `GMSB`, `MDL`, `DL`, `BKV`, `UENB`, `KUNDE-SELBST-NN`, `MGV`, `EIV`, `RB`, `KUNDE`, `INTERESSENT`, `KN`, `UBA`, `BIKO`, `ESA`
`zweck`[ ]	Purpose of use value	string[] `NETZNUTZUNGSABRECHNUNG`, `BILANZKREISABRECHNUNG`, `MEHRMINDERMENGENABRECHNUNG` `ENDKUNDENABRECHNUNG`, `UEBERMITTLUNG_AN_DAS_HKNR`, `BLINDARBEITSABRECHNUNG`, `ERMITTLUNG_AUSGEGLICHENHEIT_BILANZKREIS`, `BLINDARBEITABRECHNUNG_BETRIEBSFUEHRUNG`, `ES_LIEGT_KEIN_VERWENDUNGSZWECK_VOR`
`datenqualitaet`	Introduces segment group SEQ Z03 Metering device data SEQ ZA3 Expected metering device data SEQ ZA4 Metering device data present in the system SEQ ZF5 Informational metering device data SEQ Z20 OBIS data of the metering device SEQ ZA5 Expected OBIS data of the metering device SEQ ZA6 OBIS data of the metering device present in the system SEQ ZF6 Informational OBIS data of the metering device SEQ Z04 Transformer data SEQ ZB9 Expected transformer data SEQ ZC0 Transformer data present in the system SEQ ZF7 Informational transformer data SEQ Z05 Communication device data SEQ ZB7 Expected communication device data SEQ ZB8 Communication device data present in the system SEQ ZF8 Informational communication device data SEQ Z06 Data of the technical control device SEQ ZC1 Expected data of the technical control device SEQ ZC2 Data of the technical control device present in the system SEQ ZF9 Informational data of the technical control device SEQ Z13 Smart meter gateway SEQ ZC3 Expected smart meter gateway SEQ ZC4 Smart meter gateway present in the system SEQ ZG0 Informational smart meter gateway SEQ Z14 Control box SEQ ZH3 Expected data of the control box SEQ ZH4 Data of the control box present in the system	string `ERWARTETE_DATEN`, `IM_SYSTEM_VORHANDENE_DATEN`, `INFORMATIVE_DATEN` `GUELTIGE_DATEN`, `KEINE_DATEN`, `IM_SYSTEM_KEINE_DATEN_VORHANDEN`, `KEINE_DATEN_ERWARTET`, `DIFFERENZ_DATEN`, `DIFFERENZ_ERWARTETE_DATEN`, `DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN`
gueltigkeitszeitraum	Reference to time period ID	object
`zeiteinheit`	not in use	string `SEKUNDE`, `MINUTE`, `STUNDE` `VIERTEL_STUNDE`, `TAG`, `WOCHE`, `MONAT`, `QUARTAL`, `HALBJAHR`, `JAHR`
`dauer`	Time span, value	integer
`startdatum`	Date from DTM Z25 Use of the data from DTM 163 Processing, start date/time DTM 155 Invoicing period, start date DTM Z42 Provisional billing period start	string (date-time)
`enddatum`	Date from DTM Z26 Use of the data until DTM164 Processing, end date/time DTM 156 Invoicing period, end date DTM Z43 Provisional billing period end	string (date-time)
`einheit`	not in use	string `SEKUNDE`, `MINUTE`, `STUNDE` `VIERTEL_STUNDE`, `TAG`, `WOCHE`, `MONAT`, `QUARTAL`, `HALBJAHR`, `JAHR`
`ableseZeitraum`	Periodic meter reading of the NB DTM 752 PI 44113 44140 44142 44043 44168 44169 44060	string
`abrechnungsZeitraum`	Date on which the grid usage settlement of the NB takes place DTM Z21 PI 44112 44139 44142 44002 44013 44014 44035	string
`zeitraumText`	Period text	string
`zeitraumId`	Reference to period ID RFF Z46 PI 25001	integer

Example Responses

[
  {
    "boTyp": "ZAEHLER",
    "versionStruktur": "1",
    "zaehlernummer": "12345",
    "messlokationsId": "DE0073395252733953513649640716001",
    "marktlokationsId": "<string>",
    "sparte": "GAS",
    "zaehlerauspraegung": "EINRICHTUNGSZAEHLER",
    "zaehlertyp": "DREHKOLBENZAEHLER",
    "tarifart": "EINTARIF",
    "zaehlerkonstante": 5.4,
    "eichungBis": "2032",
    "zaehlwerke": [
      {
        "zaehlwerkId": "<string>",
        "bezeichnung": "<string>",
        "richtung": "AUSSP",
        "obisKennzahl": "1-1:1.8.0",
        "vorkommastellen": 5,
        "nachkommastellen": 3,
        "wandlerfaktor": 6,
        "einheit": "KUBIKMETER",
        "schwachlastfaehig": "NICHT_SCHWACHLASTFAEHIG",
        "verwendungszwecke": [
          {
            "marktrolle": "NB",
            "zweck": [
              "NETZNUTZUNGSABRECHNUNG"
            ]
          }
        ],
        "verbrauchsart": [
          "KL"
        ],
        "unterbrechbarkeit": "NUV",
        "waermenutzung": "WAERMEPUMPE",
        "konzessionsabgabe": {
          "satz": "TA",
          "kosten": 126.47,
          "kategorie": "<string>"
        },
        "steuerbefreit": true,
        "vorkommastelle": 8,
        "nachkommastelle": 0,
        "abrechnungsrelevant": false,
        "anzahlAblesungen": 15,
        "zaehlzeiten": {
          "zaehlzeitDefinition": "<string>",
          "register": "<string>",
          "schwachlastfaehig": "NICHT_SCHWACHLASTFAEHIG"
        },
        "konfiguration": "34590456ujdfsdghdlktztwqq-053trg",
        "wertegranularitaet": "JAEHRLICH",
        "notwendigkeitZweiteMessung": "NICHT_VORHANDEN",
        "werteuebermittlungVerwendungszweck": "NICHT_VORHANDEN",
        "artEMobilitaet": "WB"
      }
    ],
    "zaehlerhersteller": {
      "boTyp": "GESCHAEFTSPARTNER",
      "versionStruktur": "1",
      "anrede": "Frau",
      "name1": "Musterfrau",
      "name2": "Erika",
      "name3": "",
      "name4": "",
      "gewerbekennzeichnung": true,
      "hrnummer": "<string>",
      "amtsgericht": "<string>",
      "kontaktweg": [
        "TELEFONAT"
      ],
      "umsatzsteuerId": "<string>",
      "glaeubigerId": "<string>",
      "eMailAdresse": "beispiel@example.org",
      "website": "<string>",
      "geschaeftspartnerrolle": [
        "MARKTPARTNER"
      ],
      "partneradresse": {
        "postleitzahl": "10117",
        "ort": "Musterstadt",
        "strasse": "Musterstraße",
        "hausnummer": "1",
        "postfach": "",
        "adresszusatz": "Beispieldaten",
        "coErgaenzung": "",
        "landescode": "DE",
        "ortsteil": ""
      }
    },
    "gateway": "<string>",
    "fernschaltung": "NICHT_VORHANDEN",
    "messwerterfassung": "MANUELL_AUSGELESENE",
    "zaehlertypspezifikation": "SONSTIGER_EHZ",
    "befestigungsart": "DREIPUNKT",
    "zaehlergroesse": "GAS_G4",
    "geraete": [
      {
        "geraetenummer": "<string>",
        "weitereGeraetenummern": [
          "<string>",
          "<string>"
        ],
        "geraeteeigenschaften": {
          "geraetetyp": "BALGENGASZAEHLER",
          "geraetemerkmal": "GAS_G10",
          "faktor": 1,
          "volumenerfassung": "HOCHFREQUENZSONDE",
          "eichungBis": "2032",
          "herstellungsdatum": "2019",
          "baujahr": "<string>",
          "serialnummer": "<string>"
        }
      }
    ],
    "mengenumwertertyp": "DICHTEMENGENUMWERTER",
    "volumenerfassung": "SCHLEICHMENGENUNTERDRUECKUNG",
    "serialnummer": "<string>",
    "geraetemerkmal": "GAS_G10",
    "herstellungsdatum": "2019",
    "baujahr": "<string>"
  }
]

json

application/json

Feedback on the documentation

Feedback on the documentation

Read meter

Read meter

query Parameters

Read meter › Responses

Read meter

Read meter

query Parameters

Read meter › Responses