# Business data request — NB view The process describes the request for master data on a market or metering location between the NB and a further market partner and the request for values (excluding complaints about missing or implausible values – see under “further requirements”) on a market or metering location or tranche between the MSB and a further market partner. The business data request is addressed to the NB or MSB of the market location that was assigned to the market location for the time period for which the master data or values are required. Either master data for the point in time of the request or values for a point in time or a time period can be requested. The requesting party submits a business data request to the NB or MSB. The NB or MSB checks the request. In the case of an authorised request and a successful identification of the market or metering location, the NB or MSB transmits the requested information to the requesting party. Otherwise the NB or MSB sends the requesting party a rejection of the business data request. The data exchange within the use case “[start of supply](/en/prozessdoku/202604/NB/GPKE-Teil2-lieferbeginn)” (GPKE part 2) remains unaffected by the option of requesting this data via the use case “business data request” ahead of the start of supply. The process can also be used when the gas MSB wants to ask the electricity NB whether a SMGW is already installed at an address. If a SMGW is installed, the NB names to the gas-MSB the responsible MSB for the SMGW. ## Process flow from the perspective of the NB \nSystem diagram: Geschäftsdatenanfrage — view of NB\n\n\nCustomer backend system\n\nMACO APP · NB\n\nMarket partner\n\n\n\n1. Geschäftsdatenanfrage\n\nLF\n\nAS4\n17132, 17132, 17104\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: E_0441, E_0443\nE_0441 —\nGeschäftsdatenanfrage zu\nStammdaten prüfen\nE_0443 —\nGeschäftsdatenanfrage zu\nStammdaten prüfen\n\n\nTrigger follow-up process:\n19101, 19104, 55035,\n55060, 55095, 5…\n\n\nTriggered by incoming\nmessage: 17104, 17132\n\n\nLoad data for processing\n\n\n10 read APIs called\n\nAPI\nlisted at the step\n\n2. Antwort\n\n\nLF\n\nAS4\n55035, 55060, 55095…\n\nUpdate transaction\n\n\nUpdate process data\n\nAPI\n"} gesamt={"\nSequence diagram: Geschäftsdatenanfrage — view of NB\n\n\nBackend (customer)\n\n\nMACO APP · NB\n\n\nLF\n\n\nMSB\n\n\n1. Geschäftsdatenanfrage\nAS4 · PI 17132, 17132, 17104\n\nCreate transaction\nCreate process data\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\nUpdate transaction\nUpdate process data\n\n3. Geschäftsdatenanfrage\nAS4 · PI 17102\n\n4. Antwort\nAS4 · PI 19102, 13018, 13017… · E_0442\nE_0442 — Geschäftsdatenanfrage zu Werten prüfen\n"} titel="NB" /> ## Process steps ### Business data request
**Check identifiers** - [17132](/en/schnittstellen/202604/pruefi/ORDERS/PI_17132) — Request master data (electricity) · AS4 - [17104](/en/schnittstellen/202604/pruefi/ORDERS/PI_17104) — Request from MSB gas · AS4
**Flow**
  1. Message from **LF** · 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** - `17132`, `17104` → `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** - `17132` → [E_0441](/en/referenz/202604/ebd/E_0441) — Check business data request for master data - `17132` → [E_0443](/en/referenz/202604/ebd/E_0443) — Check business data request for master data
  6. **Trigger follow-up process** - [19101](/en/schnittstellen/202604/pruefi/ORDRSP/PI_19101) — Rejection of the request master data - [19104](/en/schnittstellen/202604/pruefi/ORDRSP/PI_19104) — Rejection of the request from MSB gas - [55035](/en/schnittstellen/202604/pruefi/UTILMD/PI_55035) — Response to GDA cons. MaLo - [55060](/en/schnittstellen/202604/pruefi/UTILMD/PI_55060) — Response to GDA - [55095](/en/schnittstellen/202604/pruefi/UTILMD/PI_55095) — Response to GDA gen. MaLo - [55194](/en/schnittstellen/202604/pruefi/UTILMD/PI_55194) — Response to GDA (electricity to gas) After processing, the MACO APP starts the follow-up process itself; which of them runs depends on the result of the processing.
### Response
**Check identifiers** - [55035](/en/schnittstellen/202604/pruefi/UTILMD/PI_55035) — Response to GDA cons. MaLo · AS4 - [55060](/en/schnittstellen/202604/pruefi/UTILMD/PI_55060) — Response to GDA · AS4 - [55095](/en/schnittstellen/202604/pruefi/UTILMD/PI_55095) — Response to GDA gen. MaLo · AS4 - [55194](/en/schnittstellen/202604/pruefi/UTILMD/PI_55194) — Response to GDA (electricity to gas) · AS4 - [19104](/en/schnittstellen/202604/pruefi/ORDRSP/PI_19104) — Rejection of the request from MSB gas · AS4 - [19101](/en/schnittstellen/202604/pruefi/ORDRSP/PI_19101) — Rejection of the request master data · AS4
**Flow**
  1. **Triggered by incoming message** - [17104](/en/schnittstellen/202604/pruefi/ORDERS/PI_17104) — Request from MSB gas - [17132](/en/schnittstellen/202604/pruefi/ORDERS/PI_17132) — Request master data (electricity) The MACO APP sends this message itself, as a follow-up process after one of these incoming messages.
  2. **Load data for processing** - [Read balancing](/en/api/202604/backend-lesen/getaccountingbasic#bilanzierung-lesen) `GET /getAccountingBasic` Try it - [Read location bundle](/en/api/202604/backend-lesen/getlocationbundlebasic#lokationsbundel-lesen) `GET /getLocationBundleBasic` Try it - [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 location](/en/api/202604/backend-lesen/getgridlocationbasic#netzlokation-lesen) `GET /getGridLocationBasic` Try it - [Read grid usage contract](/en/api/202604/backend-lesen/getgridusagecontractbasic#netznutzungsvertrag-lesen) `GET /getGridUsageContractBasic` Try it - [Read controllable resource](/en/api/202604/backend-lesen/getcontrollableresourcebasic#steuerbare-ressource-lesen) `GET /getControllableResourceBasic` Try it - [Read technical resource](/en/api/202604/backend-lesen/gettechnicalresourcebasic#technische-ressource-lesen) `GET /getTechnicalResourceBasic` Try it - [Read meter](/en/api/202604/backend-lesen/getcounterbasic#zahler-lesen) `GET /getCounterBasic` Try it - [Read tranche](/en/api/202604/backend-lesen/gettranchebasic#tranche-lesen) `GET /getTrancheBasic` Try it
  3. Message to **LF** · AS4
    **Response per decision tree** - `19104`, `19101` → [E_0443](/en/referenz/202604/ebd/E_0443) · NB · Check business data request for master data - `19101` → [E_0441](/en/referenz/202604/ebd/E_0441) · NB · Check business data request for master data
  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.
### Business data request This step runs between other market partners and is not relevant for this view.
**Check identifiers** - [17102](/en/schnittstellen/202604/pruefi/ORDERS/PI_17102) — Request for values · AS4
### Response This step runs between other market partners and is not relevant for this view.
**Check identifiers** - [19102](/en/schnittstellen/202604/pruefi/ORDRSP/PI_19102) — Rejection of the request values · AS4 - [13018](/en/schnittstellen/202604/pruefi/MSCONS/PI_13018) — Load curve metering location, grid coupling point, grid location · AS4 - [13017](/en/schnittstellen/202604/pruefi/MSCONS/PI_13017) — Meter reading (electricity) · AS4 - [13019](/en/schnittstellen/202604/pruefi/MSCONS/PI_13019) — Energy quantity (electricity) · AS4 - [13016](/en/schnittstellen/202604/pruefi/MSCONS/PI_13016) — Energy quantity and max. power (electricity) · AS4 - [13025](/en/schnittstellen/202604/pruefi/MSCONS/PI_13025) — Load curve market location, tranche · AS4
**Response per decision tree** - `19102` → [E_0442](/en/referenz/202604/ebd/E_0442) · MSB · Check business data request for values
Decision trees of this process | EBD | Name | |---|---| | [E_0441](/referenz/202604/ebd/E_0441) | Check business data request for master data | | [E_0443](/referenz/202604/ebd/E_0443) | Check business data request for master data | | [E_0442](/referenz/202604/ebd/E_0442) | Check business data request for values |
## Process information Wording of the consolidated version, profile ch. 3.1, pp. 29–30.
  1. ### Preconditions - The requesting party is assigned to the market or metering location throughout the requested time period or at the point in time of the request and is therefore authorised to receive the requested data, or - If the requesting party is not assigned to the market or the metering location for the entire requested time period or is not legally entitled, an authorisation to receive the requested information must be demonstrated by the requesting party to the requested NB or MSB. The existence of corresponding contractual powers of attorney (e.g. within the metering point operator framework contract between MSB and NB or the grid usage contract between LF and NB) can be assured. - For requests at market location level, the ID of the market location is known. - For requests at metering location level, the ID of the metering location is known.
  2. ### Results The requesting party has received the data and can use it for the subsequent processes.
  3. ### Error case #### Error cases - The requesting party is not authorised. - The requested party does not have the data.
  4. ### Further requirements - In justified individual cases, the NB or MSB may request proof of authorization. - Implausible or missing values are to be complained about, depending on the preconditions, via the use case “Complaint about values” (WiM Part 2) or the use case “Complaint about a configuration” (GPKE Part 3).
  5. ### Trigger **Runs beforehand:** [Determination of the MaLo ID of the market location](/en/prozessdoku/202604/NB/GPKE-Teil2-ermittlung-der-malo-id-der-marktlokation) — these processes name the one shown here in their result.
  6. ### First message **LF** sends “Business data request” (step 1). From here on, it is the turn of the party involved on this page.
  7. ### Objective The requesting party has received the requested business data.
## 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 LF](/en/prozessdoku/202604/LF/GPKE-Teil4-geschaeftsdatenanfrage) — LF - [View MSB](/en/prozessdoku/202604/MSB/GPKE-Teil4-geschaeftsdatenanfrage) — MSB *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.*