Reading backend interfaces
Read grid location
Read grid location
GET
https://mock.macoapp.de
/getGridLocationBasic
Reading a NeLo using the location ID (Parameter1) of type (Parameter2 - default MALO) as of the key date (Parameter3)
query Parameters
| Structure (BO4E) | Description | Format |
|---|---|---|
parameter1* | Location ID · Example: 74018657187 · Default: 74018657187 | string |
parameter2* | Location type · Example: MALO · Default: MALO | stringMALO, MELO, NELO TECHNISCHE_RESSOURCE, STEUERBARE_RESOURCE, TRANCHE |
parameter3* | Date (valid from) or key date if parameter4 is not set · 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) · 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) |
command | Corresponds to the operationId of this interface. This operation ID corresponds to the command in the Camunda connector process. If the backend provides a generic endpoint, this command can be used to define which operation is to be executed. | string |
Read grid location › Responses
Successful reading of the grid location | Successful reading of the network location
Array of: Grid location — 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 | stringANSPRECHPARTNER, 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 |
netzlokationsId | ID of the grid location; uniquely identifies a grid location. LOC Z18 RFF Z32 Reference to an ID of a grid location LOC+Z18 PI 55002 55078 55602 55603 55013 55607 55615 55621 55627 55633 55225 55227 55175 55180 55173 55177 55690 55230 55232 55639 55644 55649 55654 55659 55664 55035 55095 55060 55043 55168 55169 55052 IFTSTA LOC 172 PI 21025 21027 21033 QOUTES LOC 172 PI 15003 15004 INVOIC LOC 172 PI 31009 31004 31011 | string |
sparte | Gas or electricity | stringSTROM, GAS, FERNWAERME NAHWAERME, WASSER, ABWASSER |
netzanschlussleistung | Grid connection capacity quantity of the grid location | string |
grundzustaendigerMSBCodeNr | Code value of the default metering point operator responsible for this grid location. | string |
steuerkanal | Indicates whether or not a control channel is assigned to the grid location and the grid location can therefore be controlled. CCI Z49 PI 55639 55644 55649 55654 55659 55664 55035 55095 55060 55043 55168 55169 | boolean |
lokationszuordnung | not in use | stringUNVERAENDERT, BEGINNT, ENDET |
produktdatenRelevanteRolle | Product data relevant for market role CCI ZA7 | stringNB, LF, MSB MSBA, GMSB, MDL, DL, BKV, UENB, KUNDE-SELBST-NN, MGV, EIV, RB, KUNDE, INTERESSENT, KN, UBA, BIKO, ESA |
| auftraggebenderMarktpartner | Ordering market partner, assigned market partner | object |
boTyp* | Type of the BO | stringANSPRECHPARTNER, 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 |
geschaeftspartnerrolle | Role held by the business partner (e.g. prospect, customer). | stringKUNDE, LIEFERANT, DIENSTLEISTER INTERESSENT, MARKTPARTNER, EIGENTUEMER, HAUSVERWALTER, KORRESPONDENZEMPFAENGER, ABLESEKARTENEMPFAENGER |
anrede | Form of address | string |
name1 | First part of the name - name of the company | string |
name2 | Second part of the name | string |
name3 | Third part of the name | string |
name4 | Fourth part of the name | string |
gewerbekennzeichnung | Indicates whether this is a business/company (gewerbeKennzeichnung = true) or a private individual. (gewerbeKennzeichnung = false) | boolean |
externeKundenummerLieferant | external customer number supplier | string |
marktrolle | Product data relevant for market role CCI ZA7 | stringNB, LF, MSB MSBA, GMSB, MDL, DL, BKV, UENB, KUNDE-SELBST-NN, MGV, EIV, RB, KUNDE, INTERESSENT, KN, UBA, BIKO, ESA |
rollencodenummer | Indicates the code value of the market role - MP ID ORDERS NAD Z31 transmission system operator (TSO) PI 17134 ORDERS NAD DEB metering point operator PI 17003 17134 17135 IFTSTA NAD DEB metering point operator PI 21007 21015 21018 | string |
rollencodetyp | Indicates the type of the code - body responsible for code maintenance 9 GS1 293 DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) 332 DE, DVGW Service & Consult GmbH | stringBDEW, GS1, GLN DVGW |
umsatzsteuerId | VAT number RFF VA PI 37000 37001 37002 37005 37004 37003 37006 | string |
steuernummer | Tax number RFF FC PI 37000 37001 37002 37005 37004 37003 37006 | string |
makoadresse | The 1:1 communication address of the market participant. It is used in market communication. | string |
downloadlinkZertifikat | Certificate download link | string |
amtsgericht | Local court - specification of the court FTX Z15 PI 37000 37001 37002 37005 37004 37003 37006 | string |
hrnummer | Commercial register number | string |
website | Website (URL) FTX Z13 PI 37000 37001 37002 37005 37004 37003 37006 | string |
faxnummer | Fax number of the company RFF Z25 PI 37000 37001 37002 37005 37004 37003 37006 | string |
kommunikationsrolle | Contact person for the subject area | stringDATENAUSTAUSCH, RAHMENVERTRAEGE, KUENDIGUNGSPROZESSE WECHSELPROZESSE, STAMMDATENPROZESSE, EINSPEISEPROZESSE, ABRECHNUNGSPROZESSE, MMMA_PROZESSE, BEWEGUNGSDATEN, ENT_SPERR_PROZESSE, BILANZIERUNGSPROZESSE, NETZANSCHLUSS_ANLAGEN |
weiterverpflichtet | Type of service provision Z19 On a contractual basis towards the connection user / connection holder Z20 In the exercise of the continued commitment by the gMSB PI 55002 55078 55602 55603 55013 55616 55622 55628 55634 55690 55035 55095 55060 55043 55168 55169 | boolean |
messstellenbetreiberEigenschaft | Property of the metering point operator at the location CAV Z39 PI 55002 55078 55602 55603 55013 55616 55622 55628 55634 55690 55035 55095 55060 55043 55168 55169 | stringGRUNDZUSTAENDIGER_MESSSTELLENBETREIBER, WETTBEWERBLICHER_MESSSTELLENBETREIBER, AUFFANGMESSSTELLENBETREIBER |
ipAdresse | IP address of the sender FTX Z27 | string |
zuordnungVon | Start date of the assignment of the market participant | string (date-time) |
zuordnungBis | End date of the assignment of the market participant | string (date-time) |
bilanzkreis | Balancing group | string |
verwendungszweckBilanzkreis | Purpose of use of the balancing group | stringVERBRAUCHENDE_MARKTLOKATION, ERZEUGENDE_MARKTLOKATION_EEG, ERZEUGENDE_MARKTLOKATION_KWKG SONSTIGE_ERZEUGENDE_MARKTLOKATION |
| partneradresse | Address of the company | 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 | stringAC, 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 |
| ansprechpartner | Contact person within the preceding NAD segment CTA IC | object |
boTyp* | Type of the BO | stringANSPRECHPARTNER, 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 | stringRUF_ZENTRALE, FAX_ZENTRALE, SAMMELRUF SAMMELFAX, ABTEILUNGRUF, ABTEILUNGFAX, RUF_DURCHWAHL, FAX_DURCHWAHL, MOBIL_NUMMER |
rufnummer | Phone number | string |
| kommunikationsparameter | not in use | object |
| zieladresse | not in use | object |
zieladresse1 | Destination address URI IPv4 for the provision of the values | string |
zieladresse2 | Destination address URI IPv6 for the provision of the values | string |
zieladresse3 | Target address 3 | string |
zieladresse4 | Target address 4 | string |
zieladresse5 | Target address 5 | string |
| zertifikatsAussteller | not in use | object |
zertifikatsAussteller1 | Certificate issuer 1 | string |
zertifikatsAussteller2 | Certificate issuer 2 | string |
zertifikatsAussteller3 | Certificate issuer 3 | string |
zertifikatsAussteller4 | Certificate issuer 4 | string |
zertifikatsAussteller5 | Certificate issuer 5 | string |
| zertifikatsNutzer | not in use | object |
zertifikatsNutzer1 | Certificate user 1 | string |
zertifikatsNutzer2 | Certificate user 2 | string |
zertifikatsNutzer3 | Certificate user 3 | string |
zertifikatsNutzer4 | Certificate user 4 | string |
zertifikatsNutzer5 | Certificate user 5 | string |
| bankverbindung[ ] | Bank details FII BK PI 37000 37001 37002 37005 37004 37003 37006 | object[] |
verwendungszweck | not in use | stringBV_ZAHLUNG_NNA, BV_ZAHLUNG_MMMA, BV_ZAHLUNG_MSB_ABRECHNNUNG BV_ZAHLUNG_ENT_SPERREN_ABRECHNUNG, BV_SONSTIGE |
iban | IBAN | string |
kontoinhaber | The account holder | string |
bic | BIC code | string |
kreditinstitut | Name of the credit institution | string |
| erreichbarkeit[ ] | Availability of the company on working days CCI Z40 PI 37000 37001 37002 37005 37004 37003 37006 | object[] |
verfuegbarkeit | Availability of the company on the working days DTM Z36 PI 37000 37001 37002 37005 37004 37003 37006 | stringMONTAG, DIENSTAG, MITTWOCH DONNERSTAG, FREITAG, PAUSE |
zeit | Time of availability 501 HHMMHHMM | string |
| ipRange | IP range of the sender FTX Z28 | object |
untereGrenze | lower limit of the sender's IP range | string |
obereGrenze | upper limit of the sender's IP range | string |
konfigurationsprodukt | Configuration product 9991000000721 power curve definition Z12 PIA 5 PI 55639 55644 55649 55654 55659 55664 55043 55168 55169 | string |
keinKonfigurationsprodukt | No product assigned ZF6 CCI 11 PI 55639 55644 55649 55654 55659 55664 55043 55168 55169 | boolean |
leistungskurvendefinition | Code "ABC" of the assigned power curve definition for the object CCI Z53 PI 55639 55644 55649 55654 55659 55664 55043 55168 55169 | string |
| marktrollen[ ] | Ordering market partner, assigned market partner | object[] |
boTyp* | Type of the BO | stringANSPRECHPARTNER, 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 |
geschaeftspartnerrolle | Role held by the business partner (e.g. prospect, customer). | stringKUNDE, LIEFERANT, DIENSTLEISTER INTERESSENT, MARKTPARTNER, EIGENTUEMER, HAUSVERWALTER, KORRESPONDENZEMPFAENGER, ABLESEKARTENEMPFAENGER |
anrede | Form of address | string |
name1 | First part of the name - name of the company | string |
name2 | Second part of the name | string |
name3 | Third part of the name | string |
name4 | Fourth part of the name | string |
gewerbekennzeichnung | Indicates whether this is a business/company (gewerbeKennzeichnung = true) or a private individual. (gewerbeKennzeichnung = false) | boolean |
externeKundenummerLieferant | external customer number supplier | string |
marktrolle | Product data relevant for market role CCI ZA7 | stringNB, LF, MSB MSBA, GMSB, MDL, DL, BKV, UENB, KUNDE-SELBST-NN, MGV, EIV, RB, KUNDE, INTERESSENT, KN, UBA, BIKO, ESA |
rollencodenummer | Indicates the code value of the market role - MP ID ORDERS NAD Z31 transmission system operator (TSO) PI 17134 ORDERS NAD DEB metering point operator PI 17003 17134 17135 IFTSTA NAD DEB metering point operator PI 21007 21015 21018 | string |
rollencodetyp | Indicates the type of the code - body responsible for code maintenance 9 GS1 293 DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) 332 DE, DVGW Service & Consult GmbH | stringBDEW, GS1, GLN DVGW |
umsatzsteuerId | VAT number RFF VA PI 37000 37001 37002 37005 37004 37003 37006 | string |
steuernummer | Tax number RFF FC PI 37000 37001 37002 37005 37004 37003 37006 | string |
makoadresse | The 1:1 communication address of the market participant. It is used in market communication. | string |
downloadlinkZertifikat | Certificate download link | string |
amtsgericht | Local court - specification of the court FTX Z15 PI 37000 37001 37002 37005 37004 37003 37006 | string |
hrnummer | Commercial register number | string |
website | Website (URL) FTX Z13 PI 37000 37001 37002 37005 37004 37003 37006 | string |
faxnummer | Fax number of the company RFF Z25 PI 37000 37001 37002 37005 37004 37003 37006 | string |
kommunikationsrolle | Contact person for the subject area | stringDATENAUSTAUSCH, RAHMENVERTRAEGE, KUENDIGUNGSPROZESSE WECHSELPROZESSE, STAMMDATENPROZESSE, EINSPEISEPROZESSE, ABRECHNUNGSPROZESSE, MMMA_PROZESSE, BEWEGUNGSDATEN, ENT_SPERR_PROZESSE, BILANZIERUNGSPROZESSE, NETZANSCHLUSS_ANLAGEN |
weiterverpflichtet | Type of service provision Z19 On a contractual basis towards the connection user / connection holder Z20 In the exercise of the continued commitment by the gMSB PI 55002 55078 55602 55603 55013 55616 55622 55628 55634 55690 55035 55095 55060 55043 55168 55169 | boolean |
messstellenbetreiberEigenschaft | Property of the metering point operator at the location CAV Z39 PI 55002 55078 55602 55603 55013 55616 55622 55628 55634 55690 55035 55095 55060 55043 55168 55169 | stringGRUNDZUSTAENDIGER_MESSSTELLENBETREIBER, WETTBEWERBLICHER_MESSSTELLENBETREIBER, AUFFANGMESSSTELLENBETREIBER |
ipAdresse | IP address of the sender FTX Z27 | string |
zuordnungVon | Start date of the assignment of the market participant | string (date-time) |
zuordnungBis | End date of the assignment of the market participant | string (date-time) |
bilanzkreis | Balancing group | string |
verwendungszweckBilanzkreis | Purpose of use of the balancing group | stringVERBRAUCHENDE_MARKTLOKATION, ERZEUGENDE_MARKTLOKATION_EEG, ERZEUGENDE_MARKTLOKATION_KWKG SONSTIGE_ERZEUGENDE_MARKTLOKATION |
| partneradresse | Address of the company | 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 | stringAC, 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 |
| ansprechpartner | Contact person within the preceding NAD segment CTA IC | object |
boTyp* | Type of the BO | stringANSPRECHPARTNER, 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 | stringRUF_ZENTRALE, FAX_ZENTRALE, SAMMELRUF SAMMELFAX, ABTEILUNGRUF, ABTEILUNGFAX, RUF_DURCHWAHL, FAX_DURCHWAHL, MOBIL_NUMMER |
rufnummer | Phone number | string |
| kommunikationsparameter | not in use | object |
| zieladresse | not in use | object |
zieladresse1 | Destination address URI IPv4 for the provision of the values | string |
zieladresse2 | Destination address URI IPv6 for the provision of the values | string |
zieladresse3 | Target address 3 | string |
zieladresse4 | Target address 4 | string |
zieladresse5 | Target address 5 | string |
| zertifikatsAussteller | not in use | object |
zertifikatsAussteller1 | Certificate issuer 1 | string |
zertifikatsAussteller2 | Certificate issuer 2 | string |
zertifikatsAussteller3 | Certificate issuer 3 | string |
zertifikatsAussteller4 | Certificate issuer 4 | string |
zertifikatsAussteller5 | Certificate issuer 5 | string |
| zertifikatsNutzer | not in use | object |
zertifikatsNutzer1 | Certificate user 1 | string |
zertifikatsNutzer2 | Certificate user 2 | string |
zertifikatsNutzer3 | Certificate user 3 | string |
zertifikatsNutzer4 | Certificate user 4 | string |
zertifikatsNutzer5 | Certificate user 5 | string |
| bankverbindung[ ] | Bank details FII BK PI 37000 37001 37002 37005 37004 37003 37006 | object[] |
verwendungszweck | not in use | stringBV_ZAHLUNG_NNA, BV_ZAHLUNG_MMMA, BV_ZAHLUNG_MSB_ABRECHNNUNG BV_ZAHLUNG_ENT_SPERREN_ABRECHNUNG, BV_SONSTIGE |
iban | IBAN | string |
kontoinhaber | The account holder | string |
bic | BIC code | string |
kreditinstitut | Name of the credit institution | string |
| erreichbarkeit[ ] | Availability of the company on working days CCI Z40 PI 37000 37001 37002 37005 37004 37003 37006 | object[] |
verfuegbarkeit | Availability of the company on the working days DTM Z36 PI 37000 37001 37002 37005 37004 37003 37006 | stringMONTAG, DIENSTAG, MITTWOCH DONNERSTAG, FREITAG, PAUSE |
zeit | Time of availability 501 HHMMHHMM | string |
| ipRange | IP range of the sender FTX Z28 | object |
untereGrenze | lower limit of the sender's IP range | string |
obereGrenze | upper limit of the sender's IP range | string |
| zaehlwerke[ ] | OBIS code of the grid location, product identifier when exchanging data on energy quantities | 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 | stringAUSSP, 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 | Unit of measurement QUOTES PI 15001 15002 15003 INVOIC | stringW, 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 of the register; this states whether an off-peak capability is required for the concession levy. Z59 Not off-peak capable Z60 Off-peak capable CCI Z10 PI 25004 | stringSCHWACHLASTFAEHIG, 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 | stringUV, 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 | stringSPEICHERHEIZUNG, 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 | stringJAEHRLICH, 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 | stringVORHANDEN, 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 | stringVORHANDEN, 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 | stringWB, 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 | stringKAS, 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 register CCI Z38 | 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 of the register; this states whether an off-peak capability is required for the concession levy. Z59 Not off-peak capable Z60 Off-peak capable CCI Z10 PI 25004 | stringSCHWACHLASTFAEHIG, NICHT_SCHWACHLASTFAEHIG |
| verwendungszwecke[ ] | . | object[] |
marktrolle | Product data relevant for market role CCI ZA7 | stringNB, 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 |
| abrechnungsdaten[ ] | Billing data of the grid location | object[] |
artikelId | Article ID product/service number PIA Z02 55218 55220 55225 55227 55557 55559 55035 | string |
artikelIdTyp | Group article ID / article ID PI 55218 55220 55225 55227 55557 55559 55035 | stringARTIKELID, GRUPPENARTIKELID |
anzahl | Number of items of the group article ID / article ID to be billed in the NNA. E.g. when several meters or instrument transformer sets have to be billed in the NNA. QTY Z38 PI 55218 55220 55557 55559 55035 | integer |
gemeinderabatt | Municipal discount, details on the discount on grid usage charges for own consumption in percent. No discount is transmitted as 0 percent. QTY Z16 PI 55218 55220 55035 | number (float) |
zuschlag | Surcharge, markup on the price QTY Z34 PI 55218 55220 55035 | number (float) |
abschlag | Instalment payment, discount on a price QTY Z35 PI 55218 55220 55035 | number (float) |
abrechnungBlindarbeit | NB only states whether billing of reactive energy takes place at the grid location ZD9 or no billing ZE0 takes place. CCI Z45 PI 55225 55227 | boolean |
zahlerBlindarbeit | NB states who pays for the reactive energy. CAV ZE4 PI 55225 55227 | stringANSCHLUSSNUTZER, LIEFERANT, NICHT_FESTGELEGT |
zahlerBlindarbeitLf | Payment of the reactive energy by the supplier ZE1, or the payment is not made by the supplier ZE2 CCI Z46 PI 55230 55232 | boolean |
differenzDaten | Difference data | boolean |
| singulaereBetriebsmittel | Singularly used equipment QTY Z33 PI 55218 55220 55035 | object |
wert | Value quantity specification | number (float) |
einheit | Unit of measurement QUOTES PI 15001 15002 15003 INVOIC | stringW, 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 |
startdatum | startdatum | string (date-time) |
enddatum | enddatum | string (date-time) |
| preisSingulaereBetriebsmittel | Price statement for individually used equipment, per quantity per day. CCI Z44 PI 55218 55220 55035 | object |
wert | Value monetary amount QUOTES CAL calculation price PI 15001 15002 15003 | number (float) |
menge | menge | integer |
minimaleMenge | minimum quantity | integer |
maximaleMenge | maximum quantity | integer |
einheit | Reference currency EUR CUX 2 PI 19116 | stringEUR, CT |
bezugswert | Unit of measurement QUOTES PI 15001 15002 15003 INVOIC | stringW, 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 |
status | not in use | stringVORLAEUFIG, ENDGUELTIG |
preisart | Price type code | stringEINRICHTUNGSPREIS, TRANSAKTIONSPREIS, BETRIEBSPREIS |
| zaehlzeiten | Assigned metering time register CCI Z38 | 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 of the register; this states whether an off-peak capability is required for the concession levy. Z59 Not off-peak capable Z60 Off-peak capable CCI Z10 PI 25004 | stringSCHWACHLASTFAEHIG, NICHT_SCHWACHLASTFAEHIG |
datenqualitaet | Data of the grid location, all properties of the grid location are transmitted SEQ Z51 Properties of the grid location PI 55615 55627 55639 55649 55659 55043 55168 55169 SEQ ZA9 Expected data of the grid location PI 55621 55633 55644 55654 55664 SEQ ZB0 Data of the grid location held in the system PI 55621 55633 55644 55654 55664 SEQ ZD7 Informative data of the grid location PI 55002 55078 55602 55603 55013 55607 55690 55035 55095 55060 SEQ Z71 Exchange of the billing information PI 55225 55230 SEQ ZD8 Informative billing data of the grid location SEQ ZH1 Expected billing data of the grid location PI 55227 55232 SEQ ZH2 Billing data of the grid location held in the system PI 55227 55232 SEQ Z57 OBIS data of the grid location PI 55639 55649 55659 55043 55168 55169 SEQ ZA7 Expected OBIS data of the grid location PI 55644 55654 55664 SEQ ZA8 OBIS data of the grid location held in the system PI 55644 55654 55664 SEQ ZD9 Informative OBIS data of the grid location PI 55060 SEQ Z60 Product data of the grid location PI 55639 55649 55659 55043 55168 55169 SEQ ZE0 Informative product data of the grid location PI 55035 55095 55060 SEQ ZG8 Expected product data of the NeLo PI 55644 55654 55664 SEQ ZG9 Product data of the NeLo held in the system PI 55644 55654 55664 | stringERWARTETE_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 | stringSEKUNDE, 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 | stringSEKUNDE, 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 |