# Geschäftsdatenanfrage — Sicht MSB Der Prozess beschreibt die Anfrage von Stammdaten zu einer Markt- oder Messlokation zwischen dem NB und einem weiteren Marktpartner und die Anfrage von Werten (ausgenommen Reklamation von fehlenden oder unplausiblen Werten – siehe unter „weitere Anforderungen“) zu einer Markt- oder Messlokation bzw. Tranche zwischen dem MSB und einem weiteren Marktpartner. Die Geschäftsdatenanfrage erfolgt an den NB bzw. MSB der Marktlokation, der zu dem Zeitraum, für den die Stammdaten bzw. Werte benötigt werden, der Marktlokation zugeordnet war. Es können entweder Stammdaten für den Zeitpunkt der Anfrage oder Werte für einen Zeitpunkt oder einen Zeitraum angefragt werden. Der Anfragende stellt eine Geschäftsdatenanfrage an den NB bzw. MSB. Der NB bzw. MSB prüft die Anfrage. Im Falle einer berechtigten Anfrage und einer erfolgreichen Identifikation der Markt- oder Messlokation übermittelt der NB bzw. MSB dem Anfragenden die angefragten Informationen. Andernfalls übersendet der NB bzw. MSB dem Anfragenden eine Ablehnung der Geschäftsdatenanfrage. Der Datenaustausch im Rahmen des Use-Cases „[Lieferbeginn](/prozessdoku/202610/LF--LFA/GPKE-Teil2-lieferbeginn)“ (GPKE Teil 2) bleibt von der Möglichkeit, diese Daten über den Use-Case „Geschäftsdatenanfrage“ im Vorfeld des Lieferbeginns anzufragen, unberührt. Der Prozess kann auch verwendet werden, wenn der Gas MSB beim Strom NB anfragen möchte, ob an einer Adresse bereits ein SMGW verbaut ist. Wenn ein SMGW verbaut ist, nennt der NB dem Gas-MSB den verantwortlichen MSB für das SMGW. ## Prozessablauf aus Sicht des MSB \nSystembild: Geschäftsdatenanfrage aus Sicht MSB\n\n\nBackend-System des Kunden\n\nMACO APP · MSB\n\nMarktpartner\n\n\n\n3. Geschäftsdatenanfrage\n\nLF\n\nAS4\n17102\n\nDaten für die\nEingangsprüfung laden\n\n\n3 Lese-Schnittstellen\naufgerufen\n\nAPI\nje einzeln am Schritt\n\nAperak prüfen: Z10, Z18\n\n\nVorgang anlegen\n\n\nProzessdaten erstellen\n\nAPI\n\nDaten für die Prüfung laden\n\n\nBilanzierung lesen\n\nAPI\n\nEBD prüfen: E_0442\nGeschäftsdatenanfrage zu\nWerten prüfen\n\n\nFolgeprozess auslösen:\n19102, ANFRAGE_WERTE\n\n\nAusgelöst durch Eingang:\n17102\n\n\nProzessauslöser empfangen\n\n\nSTART_ERHEBUNG_MESSWE\nRTE\n\nAPI\n\nDaten für die Verarbeitung\nladen\n\n\n4 Lese-Schnittstellen\naufgerufen\n\nAPI\nje einzeln am Schritt\n\n4. Antwort\n\n\nLF\n\nAS4\n19102, 13018, 13017…\n\nVorgang fortschreiben\n\n\nProzessdaten aktualisieren\n\nAPI\n"} gesamt={"\nSequenzdiagramm: Geschäftsdatenanfrage aus Sicht MSB\n\n\nBackend (Kunde)\n\n\nMACO APP · MSB\n\n\nLF\n\n\nNB\n\n\n1. Geschäftsdatenanfrage\nAS4 · PI 17132, 17132, 17104\n\n2. Antwort\nAS4 · PI 55035, 55060, 55095… · E_0441, E_0443\nE_0441 — Geschäftsdatenanfrage zu Stammdaten prüfen\nE_0443 — Geschäftsdatenanfrage zu Stammdaten prüfen\n\n3. Geschäftsdatenanfrage\nAS4 · PI 17102\n\nVorgang anlegen\nProzessdaten erstellen\n\nSTART_ERHEBUNG_MESSWERTE\nTrigger-Event\n\n4. Antwort\nAS4 · PI 19102, 13018, 13017… · E_0442\nE_0442 — Geschäftsdatenanfrage zu Werten prüfen\n\nVorgang fortschreiben\nProzessdaten aktualisieren\n"} titel="MSB" /> ## Prozessschritte ### Geschäftsdatenanfrage Dieser Schritt läuft zwischen anderen Marktpartnern und ist für diese Sicht nicht relevant.
**Prüfidentifikatoren** - [17132](/schnittstellen/202610/pruefi/ORDERS/PI_17132) — Anfrage Stammdaten (Strom) · AS4 - [17104](/schnittstellen/202610/pruefi/ORDERS/PI_17104) — Anfrage vom MSB Gas · AS4
### Antwort Dieser Schritt läuft zwischen anderen Marktpartnern und ist für diese Sicht nicht relevant.
**Prüfidentifikatoren** - [55035](/schnittstellen/202610/pruefi/UTILMD/PI_55035) — Antwort auf GDA verb. MaLo · AS4 - [55060](/schnittstellen/202610/pruefi/UTILMD/PI_55060) — Antwort auf GDA · AS4 - [55095](/schnittstellen/202610/pruefi/UTILMD/PI_55095) — Antwort auf GDA erz. MaLo · AS4 - [55194](/schnittstellen/202610/pruefi/UTILMD/PI_55194) — Antowrt auf GDA (Strom an Gas) · AS4 - [19104](/schnittstellen/202610/pruefi/ORDRSP/PI_19104) — Ablehnung der Anfrage vom MSB Gas · AS4 - [19101](/schnittstellen/202610/pruefi/ORDRSP/PI_19101) — Ablehnung der Anfrage Stammdaten · AS4
**Antwort nach Entscheidungsbaum** - `19104`, `19101` → [E_0443](/referenz/202610/ebd/E_0443) · NB · Geschäftsdatenanfrage zu Stammdaten prüfen - `19101` → [E_0441](/referenz/202610/ebd/E_0441) · NB · Geschäftsdatenanfrage zu Stammdaten prüfen
### Geschäftsdatenanfrage
**Prüfidentifikatoren** - [17102](/schnittstellen/202610/pruefi/ORDERS/PI_17102) — Anfrage von Werten · AS4
**Ablauf**
  1. Nachricht von **LF** · AS4
  2. **Daten für die Eingangsprüfung laden** - [Marktlokation lesen](/api/202610/backend-lesen/getmarketlocationbasic#marktlokation-lesen) `GET /getMarketLocationBasic` Ausprobieren - [Messlokation lesen](/api/202610/backend-lesen/getmeterlocationbasic#messlokation-lesen) `GET /getMeterLocationBasic` Ausprobieren - [Tranche lesen](/api/202610/backend-lesen/gettranchebasic#tranche-lesen) `GET /getTrancheBasic` Ausprobieren
  3. **Aperak-Prüfungen** - `17102` → `Z10` - `17102` → `Z18`
  4. **Schreibende Schnittstelle** - Vorgang angelegt — [Prozessdaten erstellen](/api/202610/backend-schreiben-msb/createprocessdata#prozessdaten-erstellen) `POST /createProcessData` Ausprobieren Legt im Backend einen neuen Vorgang mit den Daten der eingegangenen Nachricht an.
  5. **Daten für die Prüfung laden** - [Bilanzierung lesen](/api/202610/backend-lesen/getaccountingbasic#bilanzierung-lesen) `GET /getAccountingBasic` Ausprobieren
  6. **Entscheidungsbaum** - `17102` → [E_0442](/referenz/202610/ebd/E_0442) — Geschäftsdatenanfrage zu Werten prüfen
  7. **Folgeprozess auslösen** - [19102](/schnittstellen/202610/pruefi/ORDRSP/PI_19102) — Ablehnung der Anfrage Werte - `ANFRAGE_WERTE` Nach der Verarbeitung startet die MACO APP den Folgeprozess selbst; welcher davon läuft, hängt vom Ergebnis der Verarbeitung ab.
### Antwort
**Prüfidentifikatoren** - [19102](/schnittstellen/202610/pruefi/ORDRSP/PI_19102) — Ablehnung der Anfrage Werte · AS4 - [13018](/schnittstellen/202610/pruefi/MSCONS/PI_13018) — Lastgang Messlokation, Netzkoppelpunkt, Netzlokation · AS4 - [13017](/schnittstellen/202610/pruefi/MSCONS/PI_13017) — Zählerstand (Strom) · AS4 - [13019](/schnittstellen/202610/pruefi/MSCONS/PI_13019) — Energiemenge (Strom) · AS4 - [13016](/schnittstellen/202610/pruefi/MSCONS/PI_13016) — Energiemenge u. Leistungsmax. (Strom) · AS4 - [13025](/schnittstellen/202610/pruefi/MSCONS/PI_13025) — Lastgang Marktlokation, Tranche · AS4
**Ablauf**
  1. **Ausgelöst durch Eingang** - [17102](/schnittstellen/202610/pruefi/ORDERS/PI_17102) — Anfrage von Werten Die MACO APP sendet diese Nachricht selbst, als Folgeprozess nach diesem Eingang. Daneben kann das Backend diesen Schritt mit einem Ereignis anstoßen — der nächste Punkt.
  2. **Prozessauslöser** [`START_ERHEBUNG_MESSWERTE`](/api/202610/ausloeser-msb/start-erhebung-messwerte) \"\n ],\n \"lokationsId\": \"\"\n }\n ],\n \"ZAEHLER\": [\n {\n \"zaehlernummer\": \"\"\n }\n ]\n },\n \"transaktionsdaten\": {\n \"absender\": {\n \"rollencodenummer\": \"\"\n },\n \"anfrageReferenz\": \"\",\n \"empfaenger\": {\n \"rollencodenummer\": \"\"\n },\n \"kategorie\": \"\",\n \"lokationsTyp\": \"\",\n \"sparte\": \"\",\n \"typ\": \"\"\n },\n \"zusatzdaten\": {\n \"eventname\": \"START_ERHEBUNG_MESSWERTE\",\n \"prozessId\": \"\"\n }\n}"} security={[{"bearer": []}]}>Ausprobieren Das Backend stößt diesen Schritt mit diesem Ereignis an.
  3. **Daten für die Verarbeitung laden** - `LESEN_ENERGIEMENGE_LASTGANG_BASIS` - `LESEN_ENERGIEMENGE_ZAEHLERSTAND_BASIS` - [Zähler lesen](/api/202610/backend-lesen/getcounterbasic#zahler-lesen) `GET /getCounterBasic` Ausprobieren - `LESEN_ENERGIEMENGE_ENERGIEMENGE_BASIS`
  4. Nachricht an **LF** · AS4
    **Antwort nach Entscheidungsbaum** - `19102` → [E_0442](/referenz/202610/ebd/E_0442) · MSB · Geschäftsdatenanfrage zu Werten prüfen
  5. **Schreibende Schnittstelle** - Vorgang fortgeschrieben — [Prozessdaten aktualiseren](/api/202610/backend-schreiben-msb/updateprocessdata#prozessdaten-aktualiseren) `POST /updateProcessData` Ausprobieren Schreibt den bestehenden Vorgang im Backend fort, nachdem die Nachricht erstellt ist.
Entscheidungsbäume dieses Prozesses | EBD | Name | |---|---| | [E_0442](/referenz/202610/ebd/E_0442) | Geschäftsdatenanfrage zu Werten prüfen | | [E_0441](/referenz/202610/ebd/E_0441) | Geschäftsdatenanfrage zu Stammdaten prüfen | | [E_0443](/referenz/202610/ebd/E_0443) | Geschäftsdatenanfrage zu Stammdaten prüfen |
## Prozess-Informationen Wortlaut der Lesefassung, Steckbrief Kap. 3.1, S. 29–30.
  1. ### Vorbedingungen - Der Anfragende ist im gesamten angefragten Zeitraum bzw. zum Zeitpunkt der Anfrage der Markt- oder der Messlokation zugeordnet und somit berechtigt die angefragten Daten zu erhalten oder - Ist der Anfragende der Markt- oder der Messlokation nicht im gesamten angefragten Zeitraum zugeordnet oder gesetzlich berechtigt, muss gegenüber dem angefragten NB bzw. MSB eine Bevollmächtigung zum Erhalt der angefragten Informationen vom Anfragenden dargelegt werden. Das Vorliegen entsprechender vertraglicher Vollmachten (z.B. im Rahmen des Messstellenbetreiber-Rahmenvertrags zwischen MSB und NB bzw. des Netznutzungsvertrags zwischen LF und NB) kann zugesichert werden. - Bei Anfragen auf Ebene der Marktlokation ist die ID der Marktlokation bekannt. - Bei Anfragen auf Ebene der Messlokation ist die ID der Messlokation bekannt.
  2. ### Ergebnisse Der Anfragende hat die Daten erhalten und kann diese für die Folgeprozesse verwenden.
  3. ### Fehlerfall #### Fehlerfälle - Der Anfragende hat keine Berechtigung. - Die Daten liegen dem Angefragten nicht vor.
  4. ### Weitere Anforderungen - Der NB bzw. MSB kann in begründeten Einzelfällen den Nachweis der Berechtigung anfordern. - Unplausible oder fehlende Werte sind abhängig der Vorbedingungen über den Use-Case „Reklamation von Werten“ (WiM Teil 2) oder Use-Case „Reklamation einer Konfiguration“ (GPKE Teil 3) zu reklamieren.
  5. ### Anlass **Vorher läuft:** [Ermittlung der MaLo-ID der Marktlokation](/prozessdoku/202610/LF/GPKE-Teil2-ermittlung-der-malo-id-der-marktlokation) — diese Prozesse nennen den hier gezeigten in ihrem Ergebnis.
  6. ### Erste Nachricht **LF** sendet „Geschäftsdatenanfrage“ (Schritt 3). Ab hier ist der Beteiligte dieser Seite am Zug.
  7. ### Ziel Der Anfragende hat die angefragten Geschäftsdaten erhalten.
## Andere Sichten des Prozesses Derselbe Prozess, aus den Augen der anderen Beteiligten: dieselben Schritte, jeweils aus deren Sicht gelesen. - [Sicht LF](/prozessdoku/202610/LF/GPKE-Teil4-geschaeftsdatenanfrage) — LF - [Sicht NB](/prozessdoku/202610/NB/GPKE-Teil4-geschaeftsdatenanfrage) — NB *Die Schritte sind die **möglichen** Nachrichten dieses Prozesses, keine Abfolge — die Quelle führt weder Bedingungen noch Alternativen. Das Kästchen am Schritt nennt links die eigene Sicht: **←** empfängt sie, **→** sendet sie. Zugeklappte Schritte laufen zwischen anderen Marktpartnern.* Diese Lesezugriffe sind im API-Katalog dieser Formatversion nicht geführt; am Schritt steht deshalb nur ihr Kommando, ohne Adresse und ohne Knopf. Betrifft: [4](#schritt-4) Die Konnektortabelle führt für diese Schritte keinen Schreibaufruf. Abgeleitet aus dem Prozessverlauf: Mit ihrer Nachricht beginnt der Prozess für die eigene Rolle, der Vorgang entsteht also neu. Betrifft: [3](#schritt-3)