# Request for master data change from the LF to NB (responsible) — NBV view ## Process flow from the perspective of the NB (NBV) \nSystem diagram: Anfrage zur Stammdatenänderung vom LF an NB (verantwortlich) — view of NB\n\n\nCustomer backend system\n\nMACO APP · NB (Verantwort…\n\nMarket partner\n\n\n\n1. Anfrage an NB von LF\n\nLF (Berechtigter)\n\nAS4\n44139, 44156, 44180\n\nLoad data for the incoming\ncheck\n\n\n2 read APIs called\n\nAPI\nlisted at the step\n\nAPERAK check: Z10\n\n\nCreate transaction\n\n\nCreate process data\n\nAPI\n\nEBD check: G_0031, G_0034,\nG_0035_G_0036\nG_0031 — Antwort auf\nAnfrage\nG_0034 — Antwort auf\nAnfrage\nG_0035_G_0036 —\nAntwort/Ablehnng auf\nAnfrage der\nMarktlokationsstruktur\n\n\nTrigger follow-up process:\n44142, 44157, 44181,\n44182\n\n\nTriggered by incoming\nmessage: 44139, 44156,\n44180\n\n\nLoad data for processing\n\n\n4 read APIs called\n\nAPI\nlisted at the step\n\n2. Antwort auf Anfrage an NB\nvon LF\n\n\nLF (Berechtigter)\n\nAS4\n44142, 44157, 44181…\n\nUpdate transaction\n\n\nUpdate process data\n\nAPI\n\nProcess trigger received\n\n\n2 alternative events\n\nAPI\n\n3. Ggf. Änderung vom NB an\nMSB\n\n\nMSB (Berechtigter)\n\nAS4\n44113\n\nUpdate transaction\n\n\nUpdate process data\n\nAPI\nmarktlokationsId != null\n\nUpdate transaction\n\n\nUpdate process data\n\nAPI\nmesslokationsId != null\n\n4. Antwort auf Änderung vom\nNB an MSB\n\n\nMSB (Berechtigter)\n\nAS4\n44115\n\nAPERAK check: Z33\n\n\nUpdate transaction\n\n\nUpdate process data\n\nAPI\nmarktlokationsId != null\n\nUpdate transaction\n\n\nUpdate process data\n\nAPI\nmesslokationsId != null\n\nTriggered by incoming\nmessage: 21010\n\n\nProcess trigger received\n\n\nSTART_VERSAND_SDAE\n\nAPI\n\nLoad data for processing\n\n\n4 read APIs called\n\nAPI\nlisted at the step\n\n5. Ggf. Änderung vom NB an\nweitere LF\n\n\nLF (weiterer LF als B…\n\nAS4\n44123, 44112\n\nUpdate transaction\n\n\nUpdate process data\n\nAPI\nPI 44123\n\nUpdate transaction\n\n\nUpdate process data\n\nAPI\nmarktlokationsId != null\n\nUpdate transaction\n\n\nUpdate process data\n\nAPI\nmesslokationsId != null\n\n6. Antwort auf Änderung vom\nNB an weitere LF\n\n\nLF (weiterer LF als B…\n\nAS4\n44124, 44115\n\nAPERAK check: Z33\n\n\nUpdate transaction\n\n\nUpdate process data\n\nAPI\nPI 44124\n\nUpdate transaction\n\n\nUpdate process data\n\nAPI\nmarktlokationsId != null\n\nUpdate transaction\n\n\nUpdate process data\n\nAPI\nmesslokationsId != null\n"} gesamt={"\nSequence diagram: Anfrage zur Stammdatenänderung vom LF an NB (verantwortlich) — view of NB\n\n\nBackend (customer)\n\n\nMACO APP · NB (Verantwort…\n\n\nLF (Berechtigter)\n\n\nMSB (Berechtigter)\n\n\nLF (weiterer LF als Berec…\n\n\n1. Anfrage an NB von LF\nAS4 · PI 44139, 44156, 44180\n\nCreate transaction\nCreate process data\n\n2. Antwort auf Anfrage an NB von LF\nAS4 · PI 44142, 44157, 44181… · E_3013\nE_3013 — Anfrage zur Stammdatenänderung prüfen\n\nUpdate transaction\nUpdate process data\n\n2 alternative events\nTrigger event\n\n3. Ggf. Änderung vom NB an MSB\nAS4 · PI 44113\n\nUpdate transaction\nUpdate process data · marktlokationsId != null\n\nUpdate transaction\nUpdate process data · messlokationsId != null\n\n4. Antwort auf Änderung vom NB an MSB\nAS4 · PI 44115 · E_3024\nE_3024 — Änderung vom NB prüfen\n\nUpdate transaction\nUpdate process data · marktlokationsId != null\n\nUpdate transaction\nUpdate process data · messlokationsId != null\n\nSTART_VERSAND_SDAE\nTrigger event\n\n5. Ggf. Änderung vom NB an weitere LF\nAS4 · PI 44123, 44112\n\nUpdate transaction\nUpdate process data · PI 44123\n\nUpdate transaction\nUpdate process data · marktlokationsId != null\n\nUpdate transaction\nUpdate process data · messlokationsId != null\n\n6. Antwort auf Änderung vom NB an weitere LF\nAS4 · PI 44124, 44115 · E_3025\nE_3025 — Änderung vom NB prüfen\n\nUpdate transaction\nUpdate process data · PI 44124\n\nUpdate transaction\nUpdate process data · marktlokationsId != null\n\nUpdate transaction\nUpdate process data · messlokationsId != null\n"} titel="NBV" /> ## Process steps ### Request to NB from LF
**Check identifiers** - [44139](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44139) — Not bal.-rel. request to NB · AS4 - [44156](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44156) — Bal.-rel. request to NB with dependencies · AS4 - [44180](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44180) — Request for the market location structure · AS4
**Flow**
  1. Message from **LF (authorised party)** · AS4
  2. **Load data for the incoming check** - [Read market location](/en/api/202604/backend-lesen/getmarketlocationbasic#marktlokation-lesen) `GET /getMarketLocationBasic` Try it - [Read metering location](/en/api/202604/backend-lesen/getmeterlocationbasic#messlokation-lesen) `GET /getMeterLocationBasic` Try it
  3. **APERAK checks** - `44139`, `44156`, `44180` → `Z10`
  4. **Write endpoint** - Transaction created — [Create process data](/en/api/202604/backend-schreiben-nb/createprocessdata#prozessdaten-erstellen) `POST /createProcessData` Try it out Creates a new transaction in the backend with the data of the incoming message.
  5. **Decision tree** - `44139` → `G_0031` — Response to request - `44156` → `G_0034` — Response to request - `44180` → `G_0035_G_0036` — Response/rejection to the request for the market location structure
  6. **Trigger follow-up process** - [44142](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44142) — Response to request - [44157](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44157) — Response to request - [44181](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44181) — Response to request for the market location structure - [44182](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44182) — Rejection of the request for the market location structure After processing, the MACO APP starts the follow-up process itself; which of them runs depends on the result of the processing.
### Response to request to NB from LF
**Check identifiers** - [44142](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44142) — Response to request · AS4 - [44157](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44157) — Response to request · AS4 - [44181](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44181) — Response to request for the market location structure · AS4 - [44182](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44182) — Rejection of the request for the market location structure · AS4
**Flow**
  1. **Triggered by incoming message** - [44139](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44139) — Not bal.-rel. request to NB - [44156](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44156) — Bal.-rel. request to NB with dependencies - [44180](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44180) — Request for the market location structure The MACO APP sends this message itself, as a follow-up process after one of these incoming messages.
  2. **Load data for processing** - [Read market location](/en/api/202604/backend-lesen/getmarketlocationbasic#marktlokation-lesen) `GET /getMarketLocationBasic` Try it - [Read metering location](/en/api/202604/backend-lesen/getmeterlocationbasic#messlokation-lesen) `GET /getMeterLocationBasic` Try it - [Read grid usage contract](/en/api/202604/backend-lesen/getgridusagecontractbasic#netznutzungsvertrag-lesen) `GET /getGridUsageContractBasic` Try it - [Read balancing](/en/api/202604/backend-lesen/getaccountingbasic#bilanzierung-lesen) `GET /getAccountingBasic` Try it
  3. Message to **LF (authorised party)** · AS4
    **Response per decision tree** - `44142`, `44157`, `44181`, `44182` → [E_3013](/en/referenz/202604/ebd/E_3013) · Check request for master data change
  4. **Write endpoint** - Transaction updated — [Update process data](/en/api/202604/backend-schreiben-nb/updateprocessdata#prozessdaten-aktualiseren) `POST /updateProcessData` Try it out Updates the existing transaction in the backend once the message has been created.
### Change from NB to MSB, if applicable
**Check identifiers** - [44113](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44113) — Non-bal.rel. change from NB · AS4
**Flow**
  1. **Process trigger** - [`START_ANFRAGE_STAMMDATENAENDERUNG_GAS`](/en/api/202604/ausloeser-nb/start-anfrage-stammdatenaenderung-gas) \",\n \"gewerbekennzeichnung\": \"\",\n \"name1\": \"\",\n \"name2\": \"\",\n \"name3\": \"\",\n \"name4\": \"\",\n \"partneradresse\": \"\"\n },\n \"hausverwalter\": {\n \"anrede\": \"\",\n \"gewerbekennzeichnung\": \"\",\n \"name1\": \"\",\n \"name2\": \"\",\n \"name3\": \"\",\n \"name4\": \"\",\n \"partneradresse\": \"\"\n },\n \"marktlokationsId\": \"\"\n }\n ],\n \"MESSLOKATION\": [\n {\n \"gasqualitaet\": \"\",\n \"marktrollen\": [\n \"\"\n ],\n \"messlokationsId\": \"\"\n }\n ],\n \"MESSSTELLENBETRIEBSVERTRAG\": [\n {\n \"lokationsId\": \"\",\n \"lokationsTyp\": \"\",\n \"vertragskonditionen\": {\n \"geplanteTurnusablesung\": \"\"\n }\n }\n ],\n \"NETZNUTZUNGSVERTRAG\": [\n {\n \"korrespondenzpartner\": {\n \"anrede\": \"\",\n \"gewerbekennzeichnung\": \"\",\n \"name1\": \"\",\n \"name2\": \"\",\n \"name3\": \"\",\n \"name4\": \"\",\n \"partneradresse\": \"\"\n },\n \"vertragsbeginn\": \"\",\n \"vertragspartner2\": [\n \"\"\n ]\n }\n ]\n },\n \"transaktionsdaten\": {\n \"absender\": {\n \"rollencodenummer\": \"\"\n },\n \"empfaenger\": {\n \"rollencodenummer\": \"\"\n },\n \"gueltigAb\": \"\",\n \"kategorie\": \"\",\n \"sparte\": \"\",\n \"transaktionsgrund\": \"\"\n },\n \"zusatzdaten\": {\n \"eventname\": \"START_ANFRAGE_STAMMDATENAENDERUNG\",\n \"prozessId\": \"\"\n }\n}"} security={[{"bearer": []}]}>Ausprobieren - [`START_VERSAND_SDAE`](/en/api/202604/ausloeser-nb/start-versand-sdae) \",\n \"gewerbekennzeichnung\": \"\",\n \"name1\": \"\",\n \"name2\": \"\",\n \"name3\": \"\",\n \"name4\": \"\",\n \"partneradresse\": \"\"\n },\n \"hausverwalter\": {\n \"anrede\": \"\",\n \"gewerbekennzeichnung\": \"\",\n \"name1\": \"\",\n \"name2\": \"\",\n \"name3\": \"\",\n \"name4\": \"\",\n \"partneradresse\": \"\"\n },\n \"lokationsadresse\": {\n \"hausnummer\": \"\",\n \"landescode\": \"\",\n \"ort\": \"\",\n \"ortsteil\": \"\",\n \"postfach\": \"\",\n \"postleitzahl\": \"\",\n \"strasse\": \"\",\n \"zusatzInformation\": \"\"\n },\n \"marktgebiet\": \"\",\n \"marktlokationsId\": \"\",\n \"netzebene\": \"\",\n \"zaehlwerke\": [\n \"\"\n ]\n }\n ],\n \"MESSLOKATION\": [\n {\n \"gasqualitaet\": \"\",\n \"marktrollen\": [\n \"\"\n ],\n \"messlokationsId\": \"\"\n }\n ],\n \"NETZNUTZUNGSVERTRAG\": [\n {\n \"gemeinderabatt\": null,\n \"korrespondenzpartner\": {\n \"anrede\": \"\",\n \"gewerbekennzeichnung\": \"\",\n \"name1\": \"\",\n \"name2\": \"\",\n \"name3\": \"\",\n \"name4\": \"\",\n \"partneradresse\": \"\"\n },\n \"vertragsbeginn\": \"\",\n \"vertragskonditionen\": {\n \"naechstenetznutzungsabrechnung\": \"\",\n \"netznutzungsabrechnung\": \"\",\n \"netznutzungsabrechnungIntervall\": \"\",\n \"netznutzungsabrechnungsvariante\": \"\",\n \"netznutzungsvertrag\": \"\",\n \"netznutzungszahler\": \"\",\n \"startAbrechnungsjahr\": \"\"\n },\n \"vertragspartner2\": [\n \"\"\n ]\n }\n ]\n },\n \"transaktionsdaten\": {\n \"absender\": {\n \"rollencodenummer\": \"\"\n },\n \"empfaenger\": {\n \"marktrolle\": \"\",\n \"rollencodenummer\": \"\"\n },\n \"gueltigAb\": \"\",\n \"kategorie\": \"\",\n \"sparte\": \"\",\n \"transaktionsgrund\": \"\",\n \"transaktionsgrundergaenzung\": \"\"\n },\n \"zusatzdaten\": {\n \"eventname\": \"START_VERSAND_SDAE\",\n \"prozessId\": \"\"\n }\n}"} security={[{"bearer": []}]}>Ausprobieren The backend triggers this step with one of these events.
  2. Message to **MSB (authorised party)** · AS4
  3. **Write endpoint** - `marktlokationsId != null` → Transaction updated — [Update process data](/en/api/202604/backend-schreiben-nb/updateprocessdata#prozessdaten-aktualiseren) `POST /updateProcessData` Try it out Updates the existing transaction in the backend once the message has been created.
  4. **Write endpoint** - `messlokationsId != null` → Transaction updated — [Update process data](/en/api/202604/backend-schreiben-nb/updateprocessdata#prozessdaten-aktualiseren) `POST /updateProcessData` Try it out Updates the existing transaction in the backend once the message has been created.
### Response to change from the NB to MSB
**Check identifiers** - [44115](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44115) — Response to change from NB · AS4
**Flow**
  1. Message from **MSB (authorised party)** · AS4
    **Response per decision tree** - `44115` → [E_3024](/en/referenz/202604/ebd/E_3024) · Check change from the NB
  2. **APERAK checks** - `44115` → `Z33`
  3. **Write endpoint** - `marktlokationsId != null` → Transaction updated — [Update process data](/en/api/202604/backend-schreiben-nb/updateprocessdata#prozessdaten-aktualiseren) `POST /updateProcessData` Try it out Updates the existing transaction in the backend with the data of the incoming message.
  4. **Write endpoint** - `messlokationsId != null` → Transaction updated — [Update process data](/en/api/202604/backend-schreiben-nb/updateprocessdata#prozessdaten-aktualiseren) `POST /updateProcessData` Try it out Updates the existing transaction in the backend with the data of the incoming message.
### Change from NB to further LF, if applicable
**Check identifiers** - [44123](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44123) — Bal.-rel. change from NB with dependencies · AS4 - [44112](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44112) — Non-bal.rel. change from NB · AS4
**Flow**
  1. **Triggered by incoming message** - [21010](/schnittstellen/202604/pruefi/IFTSTA/PI_21010) The MACO APP sends this message itself, as a follow-up process after this incoming message. In addition, the backend can trigger this step with an event — the next item.
  2. **Prozessauslöser** [`START_VERSAND_SDAE`](/en/api/202604/ausloeser-nb/start-versand-sdae) \",\n \"gewerbekennzeichnung\": \"\",\n \"name1\": \"\",\n \"name2\": \"\",\n \"name3\": \"\",\n \"name4\": \"\",\n \"partneradresse\": \"\"\n },\n \"hausverwalter\": {\n \"anrede\": \"\",\n \"gewerbekennzeichnung\": \"\",\n \"name1\": \"\",\n \"name2\": \"\",\n \"name3\": \"\",\n \"name4\": \"\",\n \"partneradresse\": \"\"\n },\n \"lokationsadresse\": {\n \"hausnummer\": \"\",\n \"landescode\": \"\",\n \"ort\": \"\",\n \"ortsteil\": \"\",\n \"postfach\": \"\",\n \"postleitzahl\": \"\",\n \"strasse\": \"\",\n \"zusatzInformation\": \"\"\n },\n \"marktgebiet\": \"\",\n \"marktlokationsId\": \"\",\n \"netzebene\": \"\",\n \"zaehlwerke\": [\n \"\"\n ]\n }\n ],\n \"MESSLOKATION\": [\n {\n \"gasqualitaet\": \"\",\n \"marktrollen\": [\n \"\"\n ],\n \"messlokationsId\": \"\"\n }\n ],\n \"NETZNUTZUNGSVERTRAG\": [\n {\n \"gemeinderabatt\": null,\n \"korrespondenzpartner\": {\n \"anrede\": \"\",\n \"gewerbekennzeichnung\": \"\",\n \"name1\": \"\",\n \"name2\": \"\",\n \"name3\": \"\",\n \"name4\": \"\",\n \"partneradresse\": \"\"\n },\n \"vertragsbeginn\": \"\",\n \"vertragskonditionen\": {\n \"naechstenetznutzungsabrechnung\": \"\",\n \"netznutzungsabrechnung\": \"\",\n \"netznutzungsabrechnungIntervall\": \"\",\n \"netznutzungsabrechnungsvariante\": \"\",\n \"netznutzungsvertrag\": \"\",\n \"netznutzungszahler\": \"\",\n \"startAbrechnungsjahr\": \"\"\n },\n \"vertragspartner2\": [\n \"\"\n ]\n }\n ]\n },\n \"transaktionsdaten\": {\n \"absender\": {\n \"rollencodenummer\": \"\"\n },\n \"empfaenger\": {\n \"marktrolle\": \"\",\n \"rollencodenummer\": \"\"\n },\n \"gueltigAb\": \"\",\n \"kategorie\": \"\",\n \"sparte\": \"\",\n \"transaktionsgrund\": \"\",\n \"transaktionsgrundergaenzung\": \"\"\n },\n \"zusatzdaten\": {\n \"eventname\": \"START_VERSAND_SDAE\",\n \"prozessId\": \"\"\n }\n}"} security={[{"bearer": []}]}>Ausprobieren The backend triggers this step with this event.
  3. **Load data for processing** - [Read market location](/en/api/202604/backend-lesen/getmarketlocationbasic#marktlokation-lesen) `GET /getMarketLocationBasic` Try it - [Read metering location](/en/api/202604/backend-lesen/getmeterlocationbasic#messlokation-lesen) `GET /getMeterLocationBasic` Try it - [Read grid usage contract](/en/api/202604/backend-lesen/getgridusagecontractbasic#netznutzungsvertrag-lesen) `GET /getGridUsageContractBasic` Try it - [Read meter](/en/api/202604/backend-lesen/getcounterbasic#zahler-lesen) `GET /getCounterBasic` Try it
  4. Message to **LF (further LF as authorised party)** · AS4
  5. **Write endpoint** - `44123` → Transaction updated — [Update process data](/en/api/202604/backend-schreiben-nb/updateprocessdata#prozessdaten-aktualiseren) `POST /updateProcessData` Try it out Updates the existing transaction in the backend once the message has been created.
  6. **Write endpoint** - `44112` · `marktlokationsId != null` → Transaction updated — [Update process data](/en/api/202604/backend-schreiben-nb/updateprocessdata#prozessdaten-aktualiseren) `POST /updateProcessData` Try it out Updates the existing transaction in the backend once the message has been created.
  7. **Write endpoint** - `44112` · `messlokationsId != null` → Transaction updated — [Update process data](/en/api/202604/backend-schreiben-nb/updateprocessdata#prozessdaten-aktualiseren) `POST /updateProcessData` Try it out Updates the existing transaction in the backend once the message has been created.
### Response to change from the NB to further LF
**Check identifiers** - [44124](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44124) — Response to change from NB · AS4 - [44115](/en/schnittstellen/202604/pruefi/UTILMD_GAS/PI_44115) — Response to change from NB · AS4
**Flow**
  1. Message from **LF (further LF as authorised party)** · AS4
    **Response per decision tree** - `44124`, `44115` → [E_3025](/en/referenz/202604/ebd/E_3025) · Check change from the NB
  2. **APERAK checks** - `44124`, `44115` → `Z33`
  3. **Write endpoint** - `44124` → Transaction updated — [Update process data](/en/api/202604/backend-schreiben-nb/updateprocessdata#prozessdaten-aktualiseren) `POST /updateProcessData` Try it out Updates the existing transaction in the backend with the data of the incoming message.
  4. **Write endpoint** - `44115` · `marktlokationsId != null` → Transaction updated — [Update process data](/en/api/202604/backend-schreiben-nb/updateprocessdata#prozessdaten-aktualiseren) `POST /updateProcessData` Try it out Updates the existing transaction in the backend with the data of the incoming message.
  5. **Write endpoint** - `44115` · `messlokationsId != null` → Transaction updated — [Update process data](/en/api/202604/backend-schreiben-nb/updateprocessdata#prozessdaten-aktualiseren) `POST /updateProcessData` Try it out Updates the existing transaction in the backend with the data of the incoming message.
Decision trees of this process | EBD | Name | |---|---| | [E_3013](/referenz/202604/ebd/E_3013) | Check request for master data change | | [E_3024](/referenz/202604/ebd/E_3024) | Check change from the NB | | [E_3025](/referenz/202604/ebd/E_3025) | Check change from the NB |
## Process information
  1. ### First message **LF (authorised party)** sends “Request to NB from LF” (step 1). From this point on, the party on this page is next to act.
## Other views of the process The same process through the eyes of the other parties involved: the same steps, each read from their point of view. - [View BER](/en/prozessdoku/202604/LF--BER/geli-gas-2-0-anfrage-zur-stammdatenanderung-vom-lf-an-nb-verantwortlich) — the authorised party in this process step · market role LF - [View WLF](/en/prozessdoku/202604/LF--WLF/geli-gas-2-0-anfrage-zur-stammdatenanderung-vom-lf-an-nb-verantwortlich) — a further supplier as authorised party · market role LF - [View BER](/en/prozessdoku/202604/MSB/geli-gas-2-0-anfrage-zur-stammdatenanderung-vom-lf-an-nb-verantwortlich) — the authorised party in this process step · market role MSB *The source provides no use case profile for this process — objective, precondition and result are not recorded there.* *The steps are the **possible** messages of this process, not a sequence — the source lists neither conditions nor alternatives. The small box on the step names the own view on the left: with **←** it receives, with **→** it sends. Collapsed steps run between other market partners.* :::caution{title="Step sequence reconstructed"} For this process, the BNetzA consolidated version carries no sequence diagram. The steps are reconstructed from the BDEW check identifier table: grouped by the designation, ordered by the process step. The method agrees with the consolidated version in 200 of 200 cases that can be cross-checked — the individual line is nevertheless not editorially reviewed. Check it against the rulebook before adopting it into an implementation specification. :::