Reading backend interfaces
Master data of the identified MaLo
Master data of the identified MaLo
GET
https://mock.macoapp.de
/getMaloidentMarketlocation
LESEN_MALOIDENT_MARKTLOKATION
Reading the master data of the identified market location for the positive response by means of the LokationsId (Parameter1) at the point in time (Parameter2)
query Parameters
| Structure (BO4E) | Description | Format |
|---|---|---|
parameter1* | Location ID of the market location · Example: 74018657187 · Default: 74018657187 | string |
parameter3* | Date (key date) · 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) |
Master data of the identified MaLo › Responses
Successful reading of the market location data
| Structure (BO4E) | Description | Format |
|---|---|---|
| stammdaten* | Information container for master data describing the identified market location | object |
| MARKTLOKATION[ ]* | — | object[] |
boTyp* | — | stringMARKTLOKATION |
versionStruktur* | — | string1 |
marktlokationsId* | Identifies the market location by means of a unique ID | Mapping to dataMarketLocation.maloId | string |
| energierichtung* | — | object |
| messtechnischeEinordnung | — | object |
| marktlokationsTyp[ ] | — | object[] |
gueltigAb | Start point in time, point in time at which the assigned market partners or locations are assigned. This point in time must be the start of a day at 00:00 German legal time. | string |
gueltigBis | End point in time, point in time up to which the assigned market partners or locations are assigned. This point in time must be the start of a day at 00:00 German legal time. | string |
| typ | — | object |
| lokationsadresse | — | object |
| marktrollen[ ] | Identifies the market partners of the market location. | Mapping to dataMarketLocation.dataMarketLocationSuppliers/dataMarketLocationTransmissionSystemOperators/dataMarketLocationMeasuringPointOperators/dataMarketLocationNetworkOperators/dataMarketLocationSuppliers | object[] |
boTyp* | — | stringMARKTTEILNEHMER |
versionStruktur* | — | string1 |
rollencodenummer* | Identifies the market partner (market partner ID). | string |
zuordnungVon* | Start point in time, point in time at which the assigned market partners or locations are assigned, in time zone UTC. (converted, this point in time must be the start of a day at 00:00 German legal time) | string |
zuordnungBis* | End point in time, point in time up to which the assigned market partners or locations are assigned, in time zone UTC. (converted, this point in time must be the start of a day at 00:00 German legal time) | string |
| marktrolle* | — | object |
| katasterinformation | — | object |
| geokoordinaten | — | object |
| BILANZIERUNG[ ] | — | object[] |
boTyp* | — | stringBILANZIERUNG |
versionStruktur* | — | string1 |
| wahlrechtPrognosegrundlage | — | object |
| TRANCHE[ ] | — | object[] |
boTyp* | — | stringTRANCHE |
versionStruktur* | — | string1 |
tranchenId* | Identifies the tranche by means of a unique ID | Mapping to identificationParameterId.tranchenIds | string |
| bildungTranchengroesse | — | object |
| aufteilungsmenge | — | object |
| marktrollen[ ] | Identifies the suppliers of the tranche | Mapping to dataTranches.dataTrancheSuppliers | object[] |
boTyp* | — | stringMARKTTEILNEHMER |
versionStruktur* | — | string1 |
marktrolle* | — | stringLF |
rollencodenummer* | Identifies the market partner (market partner ID). | string |
zuordnungVon* | Start point in time, point in time at which the assigned market partners or locations are assigned, in time zone UTC. (converted, this point in time must be the start of a day at 00:00 German legal time) | string |
zuordnungBis* | End point in time, point in time up to which the assigned market partners or locations are assigned, in time zone UTC. (converted, this point in time must be the start of a day at 00:00 German legal time) | string |
| MESSLOKATION[ ] | — | object[] |
boTyp* | — | stringMESSLOKATION |
versionStruktur* | — | string1 |
messlokationsId* | Identifies the metering location by means of a unique ID | Mapping to identificationParameterId.meloIds | string |
messlokationszaehler[ ] | Identifies the device of the metering location by means of the device number. | string[] |
| marktrollen[ ] | Identifies the MSB of the metering location | Mapping to dataMeterLocations.dataMeterLocationMeasuringPointOperators | object[] |
boTyp* | — | stringMARKTTEILNEHMER |
versionStruktur* | — | string1 |
marktrolle* | — | stringMSB |
rollencodenummer* | Identifies the market partner (market partner ID). | string |
zuordnungVon* | Start point in time, point in time at which the assigned market partners or locations are assigned, in time zone UTC. (converted, this point in time must be the start of a day at 00:00 German legal time) | string |
zuordnungBis* | End point in time, point in time up to which the assigned market partners or locations are assigned, in time zone UTC. (converted, this point in time must be the start of a day at 00:00 German legal time) | string |
| ENERGIELIEFERVERTRAG[ ] | — | object[] |
boTyp* | — | stringVERTRAG |
versionStruktur* | — | string1 |
vertragsart | — | stringENERGIELIEFERVERTRAG |
| vertragspartner2[ ] | — | object[] |
boTyp | — | stringGESCHAEFTSPARTNER |
versionStruktur | — | string1 |
anrede | Title of the natural person | Mapping to dataMarketLocationAddress.title | string |
name1 | Name of the customer | Mapping to dataMarketLocationAddress.surnames or dataMarketLocationAddress.company if gewerbekennzeichnung = true | string |
name2 | First name of the customer | Mapping to dataMarketLocationAddress.firstnames | string |
gewerbekennzeichnung | Indicates whether commercial or private customer | boolean |
geschaeftspartnerrolle[ ] | — | string[]KUNDE |
| TECHNISCHE_RESSOURCE[ ] | — | object[] |
boTyp* | — | stringTECHNISCHE_RESSOURCE |
versionStruktur* | — | string1 |
ressourcenId* | Identifies the technical resource by means of a unique ID | Mapping to dataTechnicalResources.trId | string |
| STEUERBARE_RESSOURCE[ ] | — | object[] |
boTyp* | — | stringSTEUERBARE_RESSOURCE |
versionStruktur* | — | string1 |
ressourcenId* | Identifies the controllable resource by means of a unique ID | Mapping to dataControllableResources.srId | string |
| marktrollen[ ] | Identifies the MSB of the controllable resource | Mapping to dataControllableResources.dataControllableResourceMeasuringPointOperators | object[] |
boTyp* | — | stringMARKTTEILNEHMER |
versionStruktur* | — | string1 |
marktrolle* | — | stringMSB |
rollencodenummer* | Identifies the market partner (market partner ID). | string |
zuordnungVon* | Start point in time, point in time at which the assigned market partners or locations are assigned, in time zone UTC. (converted, this point in time must be the start of a day at 00:00 German legal time) | string |
zuordnungBis* | End point in time, point in time up to which the assigned market partners or locations are assigned, in time zone UTC. (converted, this point in time must be the start of a day at 00:00 German legal time) | string |
| NETZLOKATION[ ] | — | object[] |
boTyp* | — | stringNETZLOKATION |
versionStruktur* | — | string1 |
netzlokationsId | Identifies the grid location by means of a unique ID. | Mapping to dataNetworkLocations.neloId | string |
| marktrollen[ ] | Identifies the MSB of the grid location | Mapping to dataNetworkLocations.dataNetworkLocationMeasuringPointOperators | object[] |
boTyp* | — | stringMARKTTEILNEHMER |
versionStruktur* | — | string1 |
marktrolle* | — | stringMSB |
rollencodenummer* | Identifies the market partner (market partner ID). | string |
zuordnungVon* | Start point in time, point in time at which the assigned market partners or locations are assigned, in time zone UTC. (converted, this point in time must be the start of a day at 00:00 German legal time) | string |
zuordnungBis* | End point in time, point in time up to which the assigned market partners or locations are assigned, in time zone UTC. (converted, this point in time must be the start of a day at 00:00 German legal time) | string |