Aufbau der Regionalstruktur
Wie ist die Regionalstruktur aufgebaut?
Diese Anleitung beschreibt den Verwendungszweck sowie den technischen Aufbau der Regionalstruktur. Diese Datei wird zur fachlichen Validierung des Anschlussortes in diversen Applikationen genutzt. Ergänzend dazu können Sie auf Anfrage eine Beispiel-Importdatei erhalten. Wichtig ist, dass Sie sich bei der Erstellung an die Vorgaben der Dokumentation sowie die Beispieldatei halten. Ansonsten ist ein Import nicht möglich.
Validierung der Regionalstruktur zwecks Abbildung spartengerechter Anträge
Bei der Antragstellung über den Kundenmarktplatz erfolgt in den Antragsstrecken in der Regel eine Validierung des Anschlussortes. (Hierzu muss in den Antragsstrecken das Feld „verfuegbarkeit_pruefen“ konfiguriert werden.)
Dies bedeutet: Auf Basis der Adresseingaben des Kunden (PLZ, Ort, Straße, Hausnummer), validiert das System, ob und welche Sparten zu dieser Adresse zur Verfügung stehen. Dies verhindert, dass der Antragsteller Anträge für Leistungen stellt, die zu dieser Adresse nicht angeboten werden. Mit der Regionalstruktur wird somit das Versorgungsgebiet eines Netzdienstleisters oder Energieversorgers spartenscharf abgebildet. Die fachlichen Inhalte dieser Datei sind daher immer kundenspezifisch
Anträge Technischer Hintergrund und Bereitstellung
Die technische Validierung erfolgt anhand der Prüfung der Parameter: Straße, Hausnummer, Ort und PLZ. Die dahinterstehenden Daten werden über eine Datei im CSV-Format gesteuert.
Diese Daten müssen durch den jeweiligen Kunden bereitgestellt werden. Die CSV-Datei muss ein spezifisches Format beinhalten, damit die Informationen automatisiert durch eine Schnittstelle des BTC Netzportals eingelesen werden können.
Bereitstellung Handling und Ablage bei On-Premise-Instanzen
Sofern Sie als Kunde über eine On-Premise Installation verfügen, obliegt es Ihnen (oder Ihrem ggf. vorhandenen IT-Dienstleister) diese Datei in regelmäßigen Abständen oder bei Bedarf zu aktualisieren. Die CSV-Datei muss dafür unter dem Pfad /home/simplifier/data/addresses abgelegt werden. Über eine separate Applikation können Sie die Datei manuell importieren. Alternativ können wir diese Dienstleistung für Sie über den Support kostenpflichtig übernehmen. Stellen Sie hierzu einfach eine Anfrage über das Supportportal.
Handling und Ablage bei Cloud- Instanzen
Sofern Sie als Kunde über eine Cloud-Installation verfügen, sprich Ihre Instanzen durch die BTC verantwortet werden, obliegt Ihnen als Kunde die Bereitstellung der CSV-Datei. Die Ablage auf dem Server übernimmt BTC gemäß den Vereinbarungen des Wartungsvertrages (wie beauftragt) oder im Projekt. Die Aktualisierung der Datei können Sie im Projekt über Ihren Projektmanager oder im Regelbetrieb über das Support-Portal via Ticket anfragen.
Instanzen Automatische Erstellung der Regionalstruktur
Die Mehrheit der Kunden führt die Daten des Versorgungsgebietes in GIS-Systemen oder in SAP. Inwiefern es möglich ist eine direkte Schnittstelle zwischen diesen Systemen und der Schnittstelle zur Regionalstruktur aufzubauen, erfragen Sie bitte bei BTC direkt. Alternativ stellen Sie bitte aus den o.g. Systemen einen Export im nachstehend vorgestellten Dateiformat und inhaltlichen Aufbau bereit. Bitte erfragen Sie hierzu auch unsere Beispieldatei. Wenn das Format und die Vorgaben nicht erfüllt werden, ist ein Import nicht möglich.
Erläuterungen zum Format und Struktur Import-Datei (CSV- Format)
- Die Spalten der Datei dürfen nicht verändert, ergänzt oder umbenannt werden.
- Das Format muss immer .csv sein.
- Die Datei muss UTF8 codiert sein.
- Erläuterungen und Hinweise zum Befüllen der Spalten:
|
Feldname |
Systemische Bedeutung |
Anmerkungen zur Befüllung |
|
CITY_CODE |
Systembedingtes Feld |
Information aus SAP Regionalstruktur. Bitte leer lassen, falls nicht vorhanden |
|
CITY_NAME |
Systembedingtes Feld, speichert den Namen der Stadt |
Pflichtfeld, bitte ausfüllen |
|
CITY_PCODE
|
Systembedingtes Feld |
Information aus SAP Regionalstruktur. Bitte leer lassen, falls nicht vorhanden |
|
CITY_PART |
Systembedingtes Feld, speichert den Stadtteil |
Bitte füllen sofern bekannt, sonst bitte „-„ eintragen |
|
STRT_CODE |
Systembedingtes Feld |
Information aus SAP Regionalstruktur. Bitte leer lassen, falls nicht vorhanden |
|
STREET |
Systembedingtes Feld, speichert die Straße |
Pflichtfeld, bitte ausfüllen |
|
SPARTE |
Systembedingtes Feld, codiert, welche Sparte an dieser Adresse bezogen werden kann |
Pflichtfeld, Codierungen: 01 = Strom 02 = Gas 03 = Wasser 04 = Abwasser 05 = Fernwärme 06 = Glasfaser 99 = alle Sparten |
|
WERK |
Systembedingtes Feld |
Information aus SAP Regionalstruktur. Bitte leer lassen, falls nicht vorhanden |
|
HOUSENUM_H |
Systembedingtes Feld, speichert die höchste Hausnummer unter der die Sparte der Zeile verfügbar ist |
Pflichtfeld
|
|
HSN_SUPP_H |
Systembedingtes Feld |
Bitte leer lassen |
|
HOUSENUM_L |
Systembedingtes Feld, speichert die niedrigste Hausnummer unter der die Sparte der Zeile verfügbar ist |
Pflichtfeld
|
|
HSN_SUPP_L |
Systembedingtes Feld |
Bitte leer lassen. |
|
HSN_IND |
Systembedingtes Feld |
Information aus SAP Regionalstruktur. Bitte leer lassen, falls nicht vorhanden |
|
POST_CODE |
Systembedingtes Feld, speichert die Postleitzahl |
Pflichtfeld, bitte ausfüllen |
|
ZZNETCENT |
Systembedingtes Feld |
Information aus SAP Regionalstruktur. |
|
SWERK |
Systembedingtes Feld |
Information aus SAP Regionalstruktur. Bitte leer lassen, falls nicht vorhanden |
|
ZZBEBER |
Systembedingtes Feld |
Information aus SAP Regionalstruktur. Bitte leer lassen, falls nicht vorhanden |
|
BUKRS |
Systembedingtes Feld |
Information aus SAP Regionalstruktur. Bitte leer lassen, falls nicht vorhanden |
|
ABLEINH |
Systembedingtes Feld |
Information aus SAP Regionalstruktur. Bitte leer lassen, falls nicht vorhanden |
|
KONZVER |
Systembedingtes Feld |
Information aus SAP Regionalstruktur. Bittel leer lassen, falls nicht vorhanden |
Hinweise und Beispiele:
- Ist an einer Straße und jeder dort ansässigen Hausnummer jede Sparte vorhanden muss die Straße nur einmalig in der Datei geführt werden, Angabe Sparte = 99
- Ist an einer Straße und jeder dort ansässigen Hausnummer nur die Sparte Strom und Gas vorhanden muss die Straße zwei Mal in der Datei geführt werden. Eine Zeile mit der Angabe Sparte = 01, eine Zeile mit der Angabe Sparte = 02