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)

 

  1. Die Spalten der Datei dürfen nicht verändert, ergänzt oder umbenannt werden.
  2. Das Format muss immer .csv sein.
  3. Die Datei muss UTF8 codiert sein.
  4. 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

  • Sofern die ganze Straße validiert werden soll, bitte höchste Hausnummer eintragen
  • sofern diese nicht bekannt ist 999 oder Ähnliches eintragen als Dummy

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

  • Sofern die ganze Straße validiert werden soll, bitte niedrigste Hausnummer eintragen
  • sofern diese nicht bekannt ist 1 eintragen

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